# Einführung (https://developer.bimetrics.de/)

Mit der bimetrics API liest deine Anwendung Belege, Kontakte, Bankkonten, Umsätze und Buchungen einer Firma und lädt Belege hoch.

Die bimetrics API verbindet eigene Anwendungen mit einer Firma in bimetrics. Typische Einsätze sind ein Belegimport aus einem anderen System, ein Abgleich mit einem Warenwirtschafts- oder Kassensystem oder ein Export von Buchungen in ein eigenes Reporting.

## Was die API kann

* **Lesen:** Belege mit erkannten Werten und Originaldatei, Kontakte, Bankkonten, Umsätze, Sachkonten und Buchungen sowie Tarif und Kontingent.
* **Hochladen:** Belege einreichen, die bimetrics wie einen Upload in der App verarbeitet.

Bestehende Belege, Einstellungen, Team und Abrechnung lassen sich über die API nicht ändern. Webhooks gibt es nicht; Änderungen holst du per Abfrage (Polling).

## Wer die API nutzen kann

* Firmen mit einem gültigen bezahlten Tarif oder einer Freischaltung durch bimetrics. In der Testphase ist die API nicht verfügbar.
* API-Schlüssel legt der Inhaber einer Firma in der App an. Jeder Schlüssel gilt für genau eine Firma.

## Grundlagen

| Thema                         | Wert                                                        |
| ----------------------------- | ----------------------------------------------------------- |
| Basis-URL                     | `https://app.bimetrics.de`, alle Pfade beginnen mit `/api/` |
| Format                        | JSON, Upload als `multipart/form-data`                      |
| Authentifizierung             | `Authorization: Bearer bm_…`                                |
| Maschinenlesbare Beschreibung | [OpenAPI 3.0](https://app.bimetrics.de/api/openapi.json)    |

## Nächste Schritte

<Cards>
<Card title="Schnellstart" href="/schnellstart" description="Schlüssel anlegen und den ersten Aufruf senden." />

<Card title="API-Referenz" href="/referenz" description="Alle Endpunkte mit Parametern, Antworten und Playground." />

<Card title="Filtern und Paginieren" href="/filtern" description="Suchanfragen für Belege, Umsätze und Buchungen." />

<Card title="Beleg-Upload" href="/beleg-upload" description="Belege sicher und ohne Doppelungen hochladen." />
</Cards>

## Für KI-Agenten

Jede Seite gibt es auch als Markdown: Hänge `.md` an die Adresse an, zum Beispiel [/schnellstart.md](/schnellstart.md). Eine Übersicht aller Seiten steht in [/llms.txt](/llms.txt), der gesamte Inhalt in einer Datei in [/llms-full.txt](/llms-full.txt).