Öffentliche Schnittstelle (API): Kunden und Rechnungen aus deinem System
Wenn deine Rechnungen in einem anderen System entstehen, sollen sie nicht zweimal getippt werden. Dafür gibt es die Schnittstelle, und sie kann im Moment genau zwei Dinge.
- Kunden und Rechnungen
- Schlüssel je Firma
- Erste Ausbaustufe
- GET/clients
- POST/clients
- GET/invoices
- POST/invoices
- 2Ressourcen: Kunden und Rechnungen
- 1Schlüssel je Firma, nie darüber hinaus
- BusinessAb diesem Tarif enthalten
- Anlegen und auslesenBeide Richtungen, für beide Ressourcen
Was die Schnittstelle kann und was nicht
Volk Accountant hat eine öffentliche Programmierschnittstelle, mit der sich Kunden und Rechnungen anlegen und auslesen lassen. Der Zugriff läuft über einen Schlüssel, der je Firma vergeben wird; wer mehrere Firmen führt, hat also mehrere Schlüssel, und ein Schlüssel reicht nie über seine Firma hinaus. Die Schnittstelle ist ab dem Business-Tarif enthalten und befindet sich in der ersten Ausbaustufe: Es gibt noch keine öffentliche Dokumentation, und andere Bereiche wie Belege, Bankumsätze oder die zyprischen Meldungen sind über sie nicht erreichbar. Für Benachrichtigungen über Ereignisse gibt es stattdessen Webhooks.
Was eine Schnittstelle überhaupt ist
API steht für Application Programming Interface. Auf Deutsch heißt das Programmierschnittstelle, und gemeint ist etwas sehr Einfaches.
Eine Schnittstelle ist ein Zugang für Programme statt für Menschen. Was du in der Oberfläche anklickst, kann ein anderes Programm über die Schnittstelle direkt tun: einen Kunden anlegen, eine Rechnung auslesen. Es gibt dabei kein Fenster und keine Maus, sondern festgelegte Befehle und festgelegte Antworten.
Angefangen wird bei dir. Wann gefragt wird, bestimmt dein System, und zurück kommen Daten.
Die beiden Befehle, um die es hier geht, heißen GET und POST. GET heißt abfragen, POST heißt anlegen. GET /invoices holt also Rechnungen, POST /invoices legt eine an. Mehr Vokabeln braucht man für den Anfang nicht.
Gebraucht wird eine Schnittstelle, wenn Daten schon woanders entstehen. Wenn dein Shop oder dein Projektwerkzeug ohnehin weiß, was abgerechnet werden soll, dann soll es die Rechnung auch anlegen können, statt dass jemand sie abtippt.
Was die Schnittstelle heute kann
Eine Schnittstelle, die mehr verspricht als sie liefert, kostet mehr Zeit als keine. Deshalb steht hier der Umfang, bevor der Nutzen kommt.
Das ist die erste Ausbaustufe, und das Wort steht hier, weil es die Lage beschreibt. Belege, Bankumsätze, Vorlagen und die zyprischen Meldungen sind über die Schnittstelle nicht erreichbar.
Wer eine Rechnung über die Schnittstelle anlegt, bekommt dieselbe Logik wie beim Schreiben in der App: Die Steuerregelung wird aus Firmenland und Kundenland vorgeschlagen, die Nummer entsteht beim Finalisieren. Wie das im Einzelnen funktioniert, steht auf der Seite zu Rechnungen.
- Kunden ausleseneinzeln oder als Liste
- Kunden anlegenmit Land und VAT-Nummer
- Rechnungen ausleseneinzeln oder als Liste
- Rechnungen anlegenmit Positionen und Regelung
Ein Schlüssel gilt für genau eine Firma
Wer mehrere Firmen führt, führt auch mehrere Buchhaltungen. Ein Schlüssel, der über alle reicht, wäre bequem und falsch.
- 1
Schlüssel erzeugen
In den Einstellungen der Firma, für die er gelten soll. Er wird einmal angezeigt.
- 2
Im eigenen System hinterlegen
Dein System schickt ihn bei jedem Zugriff mit. Mehrere Firmen bedeuten mehrere Schlüssel.
- 3
Zurückziehen
Ein Schlüssel lässt sich jederzeit ungültig machen, ohne dass die anderen davon betroffen sind.
Dass ein Schlüssel nie über seine Firma hinausreicht, ist dieselbe Trennung wie in der Oberfläche. Was dort getrennt bleibt, steht bei Mehrere Firmen.
Der Unterschied zwischen beiden
Beide verbinden dein System mit deiner Buchhaltung, und sie werden regelmäßig verwechselt. Der Unterschied steckt in einer einzigen Frage: Wer fängt an?
Ein Ereignis tritt ein, und wir schicken eine kurze Meldung. Dein System erfährt, DASS etwas passiert ist.
Du fragst, wann du willst, und bekommst Daten zurück. Dein System erfährt, WAS genau passiert ist.
Die ganze Unterscheidung steckt in der Richtung des ersten Pfeils. Beim Webhook zeigt er zu dir, bei der Schnittstelle von dir weg.
In der Praxis arbeiten beide zusammen. Der Webhook meldet, dass eine Rechnung bezahlt wurde, und die Schnittstelle liefert auf Nachfrage die Rechnung dazu. Beide sind ab dem Business-Tarif enthalten.
Programmierschnittstellen bei anderen Anbietern
Eine Schnittstelle haben mehrere, aber selten im Einstiegstarif. Alle Angaben stammen von den öffentlichen Anbieterseiten.
| Volk Accountant | Cybooks | Sumly | Balabook | Accountly | TidyBooks | BTMS | QuickBooks | Xero | Billino | |
|---|---|---|---|---|---|---|---|---|---|---|
| Schnittstelle für eigene Anbindungen | API-Zugang ab Business, 49 €/Monat | nicht veröffentlicht | nicht veröffentlicht | öffentliche API und MCP-Server | nur im Enterprise-Tarif, Preis auf Anfrage | ab Pro, 39 €/Monat | nicht veröffentlicht | nicht veröffentlicht | nicht veröffentlicht | API im Plus-Tarif, 1.000 Aufrufe |
| Fertige IntegrationenAnbindungen, die ohne Programmierung funktionieren – im Unterschied zu einer Schnittstelle, für die jemand etwas bauen muss. | Stripe, Google Drive, Webhooks, API, Claude, ChatGPT | nicht veröffentlicht | nicht veröffentlicht | keine einzelne benannt, stattdessen offene API | nicht veröffentlicht | ab Pro, keine einzelne benannt | nicht veröffentlicht | Hunderte Apps, keine zyprische genannt | nicht veröffentlicht | nicht veröffentlicht |
Balabook nennt als einziger Anbieter eine öffentliche Schnittstelle samt MCP-Server, Accountly bietet sie nur im Enterprise-Tarif mit Preis auf Anfrage. Bei uns gehört sie zum Business-Tarif, allerdings in der genannten ersten Ausbaustufe und ohne öffentliche Dokumentation. Das ist der ehrliche Stand, und er steht hier, bevor du ihn nach dem Kauf feststellst.
Steht ein Strich, veröffentlicht der Anbieter dazu nichts. Die vollständigen Gegenüberstellungen stehen in den Vergleichen.
Was diese Funktion nicht tut
Wir schreiben das hin, weil es die Entscheidung beeinflusst. Wer es erst nach dem Kauf merkt, hat das falsche Werkzeug gekauft.
- Noch keine öffentliche Dokumentation. Wer die Schnittstelle nutzen will, fragt uns nach der Beschreibung.
- Erste Ausbaustufe. Belege, Bankumsätze und die zyprischen Meldungen sind über die Schnittstelle nicht erreichbar.
- Ab dem Business-Tarif. Im Starter gibt es keinen Zugriff.
- Keine Benachrichtigungen. Was passiert ist, meldet ein Webhook, nicht die Schnittstelle.
Fragen, die vor dem Start kommen
Was kann ich über die Schnittstelle anlegen und auslesen?
Kunden und Rechnungen, jeweils in beide Richtungen. Belege, Bankumsätze, Vorlagen und die zyprischen Meldungen sind über die Schnittstelle nicht erreichbar. Das ist die erste Ausbaustufe, und das Wort steht hier, weil es die Lage beschreibt.
Gibt es eine öffentliche Dokumentation?
Noch nicht. Wer die Schnittstelle nutzen will, fragt uns nach der Beschreibung und bekommt sie vor dem Kauf. So siehst du vorher, ob sie für deinen Fall reicht, statt es danach festzustellen.
Gilt ein Schlüssel für alle meine Firmen?
Nein, ein Schlüssel gilt für genau eine Firma. Wer mehrere Firmen führt, hat mehrere Schlüssel, und ein Schlüssel reicht nie über seine Firma hinaus. Zurückziehen lässt sich jeder einzeln, ohne die anderen zu berühren.
Bekommt eine Rechnung aus der Schnittstelle dieselbe Steuerlogik?
Ja. Die Steuerregelung wird aus Firmenland und Kundenland vorgeschlagen und die Nummer beim Finalisieren vergeben, genau wie beim Schreiben in der App. Eine Rechnung über die Schnittstelle ist keine Rechnung zweiter Klasse.
Was dazu passt
Zum Nachlesen
VergleichWelche Buchhaltungssoftware ist die beste für Zypern?
Es gibt nicht die eine beste. Es gibt eine, die zu deinem Fall passt, und die Frage, die das entscheidet, ist nicht der Preis.
RechnungenWas auf eine zyprische Rechnung muss
Die Pflichtangaben stehen nicht im VAT-Gesetz, sondern in einer Verordnung von 2001. Liest man sie genau, sind zwei Dinge, die jeder Ratgeber behauptet, überhaupt nicht vorgeschrieben.
VATVAT-Erklärung in Zypern: Perioden, der 10., und was Verspätung kostet
Deine Quartalsenden werden bei der Registrierung festgelegt, Erklärung und Zahlung haben eine gemeinsame Frist, und Verspätung kostet einen festen Betrag noch vor jedem Zins. Hier ist der ganze Ablauf.
Frag uns nach der Beschreibung der Schnittstelle
14 Tage kostenlos startenGeprüft am 5. Oktober 2026