Was ist die Billomat API? – aifinyo | Billomat

Die Billomat API ermöglicht es dir, Billomat-Daten automatisiert aus eigenen Anwendungen heraus zu lesen und zu schreiben.

Was ist eine API?

Eine API (Application Programming Interface) ist eine Schnittstelle, über die zwei Softwaresysteme miteinander kommunizieren können. Stell dir vor, du hast ein eigenes Shop-System oder eine interne Datenbank – die Billomat API ist die Verbindung, über die dein System Daten an Billomat schicken oder von dort abholen kann, ohne dass du manuell eingreifen musst.

Kurz gesagt: Was du in Billomat per Klick erledigst, kannst du über die API automatisiert und programmgesteuert durchführen.

Was ist die Billomat API konkret?

Die Billomat API ist eine offene REST-Schnittstelle. Das bedeutet: Die Kommunikation läuft über ganz normale HTTP-Anfragen – dieselbe Technologie, die dein Browser verwendet, wenn du eine Website aufruft. Als Datenformate werden XML und JSON unterstützt.

Jede Ressource in Billomat – also zum Beispiel eine Rechnung, ein Kunde oder ein Artikel – hat eine eindeutige URL, über die sie angesprochen werden kann.

Beispiel:

Die URL für alle Rechnungen in deinem Account sieht so aus:
https://{deineBillomatID}.billomat.net/api/invoices

Die URL für eine einzelne Rechnung mit der ID 123:
https://{deineBillomatID}.billomat.net/api/invoices/123

Aufbau der API-URL

Jede Anfrage an die Billomat API folgt diesem Schema:

https://{billomatID}.billomat.net/api/{ressource}/{id}/{methode}

Parameter	Bedeutung	Beispiel
`{billomatID}`	Deine persönliche Billomat-ID	`meinefirma`
`{ressource}`	Der Datenbereich, auf den du zugreifen möchtest	`invoices`, `clients`, `articles`
`{id}`	Die ID eines konkreten Datensatzes (optional)	`123`
`{methode}`	Eine spezielle Aktion auf dem Datensatz (optional)	`pdf`, `complete`, `email`

Wofür kannst du die API nutzen?

Die Einsatzmöglichkeiten sind vielfältig – hier einige typische Beispiele:

Shop-Anbindung: Bestellungen aus deinem Online-Shop werden automatisch als Rechnungen in Billomat angelegt.
ERP-/CRM-Integration: Kundenstammdaten werden zwischen Billomat und deiner internen Software synchron gehalten.
DATEV-Export: Buchhaltungsdaten werden automatisiert aufbereitet und an deinen Steuerberater übergeben.
Dashboards & Auswertungen: Eigene Berichte und Analysen auf Basis deiner Billomat-Daten erstellen.
Automatische Rechnungserstellung: Wiederkehrende Transaktionen vollständig ohne manuellen Eingriff abwickeln.

Was brauchst du für die Nutzung?

Um die Billomat API zu nutzen, benötigst du:

Einen aktiven Billomat-Account – deine Billomat-ID findest du unter Einstellungen > Mein Konto > Firma.
Einen API-Schlüssel – wie du diesen aktivierst und generierst, erfährst du im Artikel Authentifizierung.
Grundkenntnisse in HTTP-Anfragen oder ein Tool wie curl, Postman oder eine Programmiersprache deiner Wahl.

Tipp: Für erste Tests steht dir auf Anfrage ein kostenloser Entwickler-Account zur Verfügung – so kannst du die API risikofrei testen, ohne deine Produktivdaten zu berühren. Schreib uns dazu einfach an api@billomat.com.

Wie geht es weiter?

In den folgenden Artikeln dieses Abschnitts erfährst du alles, was du für den Einstieg brauchst:

Sicherheit & HTTPS – warum du immer verschlüsselt arbeiten solltest
Authentifizierung – wie du deinen API-Schlüssel einrichtest und verwendest
Datenformate: XML & JSON – in welchem Format die API kommuniziert
Daten lesen – wie du Daten abfragst, filterst und sortierst
Daten schreiben – wie du Datensätze anlegst, bearbeitest und löschst

Verknüpfung mit