Einführung
Mit der bimetrics API liest deine Anwendung Belege, Kontakte, Bankkonten, Umsätze und Buchungen eines Unternehmens, lädt Belege hoch und ändert mit Schreibrechten Kontakte, Rechnungen, Zuordnungen, Belege, Layouts und Firmendaten.
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 und der Stand ihrer Bankzugänge, Umsätze, Sachkonten, Kategorien und Buchungen, Zuordnungen und Vorschläge, Buchungsvorlagen und Dauerbuchungen, Ausgangsdokumente, Forderungen und Mahnungen, eingelesene Kontoauszüge, „Zu erledigen“, die Firma mit Versteuerung und Nummernkreisen, Layouts und Logo sowie Tarif und Kontingent. Mails im Belegpostfach liest ein Schlüssel nur mit eigener Berechtigung.
-
Hochladen: Belege einreichen, die bimetrics wie einen Upload in der App verarbeitet, und Kontoauszüge nach einer Vorschau einlesen.
-
Schreiben: mit gesondert vergebenen Schreibrechten des API-Schlüssels
- Kontakte anlegen und ändern,
- Rechnungs- und Angebotsentwürfe anlegen, prüfen, abschließen und löschen, Rechnungen als ZUGFeRD oder XRechnung, aus Angeboten Auftragsbestätigungen und Rechnungen ableiten, Rechnungen stornieren und korrigieren, per E-Mail senden, Mahnungen ausstellen und wiederkehrende Rechnungen einrichten,
- Belege und Umsätze zuordnen, Zuordnungen erweitern, Skonto und Mahnkosten ausgleichen, Zahlungen, Erstattungen und Verrechnungen erfassen,
- Belegdaten berichtigen, Belege löschen, bis zu 50 Belege auf einmal ändern, Buchungsvorlagen und Dauerbuchungen pflegen und Anhänge aus dem Belegpostfach übernehmen,
- Firmendaten, Mahnstufen, Rechnungslayouts und Logo ändern.
Mehr unter Schreiboperationen.
Kontenrahmen, Versteuerung, Bankverbindung der Firma, Team und Abrechnung bleiben in der App. 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, außerdem Firmen in der Testphase, dort mit Tagesgrenzen.
- 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 |
Nächste Schritte
Schnellstart
Schlüssel anlegen und den ersten Aufruf senden.
API-Referenz
Alle Endpunkte, nach Bereichen von Belegen bis Layouts, mit Playground.
Filtern und Paginieren
Suchanfragen für Belege, Kontakte, Bankkonten, Umsätze, Buchungen, Entwürfe, Vorlagen und das Postfach.
Beleg-Upload
Belege sicher und ohne Doppelungen hochladen.
MCP-Server
Claude, ChatGPT, Codex oder Cursor mit einem oder mehreren Unternehmen verbinden.
Rezepte
Vollständige Beispiele in curl, JavaScript und Python für typische Integrationen:
Delta-Sync
Geänderte Belege, Kontakte, Bankkonten und Umsätze regelmäßig abgleichen.
Beleg hochladen und auslesen
Hochladen, den Stand der Erkennung abfragen und das Ergebnis lesen.
Monatsexport
Belege mit Originaldateien und Buchungen eines Monats abrufen.
Fachbegriffe erklärt das Glossar, die Formate von Datum, Beträgen und IDs die Seite Datentypen.
Für KI-Agenten
Jede Seite gibt es auch als Markdown: Hänge .md an die Adresse an, zum Beispiel /quickstart.md. Eine Übersicht aller Seiten steht in /llms.txt, der gesamte Inhalt in einer Datei in /llms-full.txt.
Werkzeuge und Support
- OpenAPI-Beschreibung: openapi.json herunterladen (OpenAPI 3.0). Die Datei lässt sich direkt in Postman, Bruno oder Insomnia importieren.
- Support und Feedback: Fragen zur API, Fehlermeldungen und Wünsche schickst du an support@bimetrics.de. Nenne dabei den Endpunkt, den HTTP-Status und den Fehlercode, aber nie deinen API-Schlüssel.