Webhooks: dein System erfährt sofort, was hier passiert ist
Wer ein zweites System betreibt, will nicht alle zehn Minuten nachfragen, ob etwas passiert ist. Ein Webhook meldet sich von selbst, in dem Moment, in dem es passiert.
- Sieben Ereignisse
- Mit Signatur abgesichert
- Ab Business enthalten
- Rechnung erstellt
- Angebot angenommen
- Neue Ausgabe
- Zahlung fehlgeschlagen
- Rechnung bezahlt
- Neuer Kunde
- Zahlung empfangen
- 7Ereignisse, die eine Benachrichtigung auslösen
- 1Adresse, die du selbst hinterlegst
- SignaturAn jeder Nachricht, zum Prüfen der Herkunft
- BusinessAb diesem Tarif enthalten
- SofortKeine Abfrage im Minutentakt nötig
Welche Ereignisse einen Webhook auslösen
Volk Accountant benachrichtigt andere Programme über Webhooks, sobald in deinem Konto etwas passiert. Sieben Ereignisse lösen aus: Rechnung erstellt, Rechnung bezahlt, Angebot angenommen, neue Ausgabe, neuer Kunde, Zahlung empfangen und Zahlung fehlgeschlagen. Die Benachrichtigung geht an eine Adresse, die du selbst hinterlegst, und sie trägt eine Signatur, mit der dein System prüfen kann, dass sie wirklich von uns stammt und unterwegs nicht verändert wurde. Webhooks sind ab dem Business-Tarif enthalten. Sie ersetzen keine Abfrage von Daten: Was geschehen ist, meldet der Webhook; was danach damit passiert, entscheidet dein System.
Was ein Webhook überhaupt ist
Der Begriff klingt technischer, als die Sache ist. Wer ihn einmal gehört hat, erkennt ihn danach überall wieder.
Ein Webhook ist eine Nachricht, die ein Programm von sich aus verschickt, sobald bei ihm etwas passiert ist. Du hinterlegst einmal eine Internetadresse, und von da an schickt Volk Accountant eine kurze Nachricht dorthin, sobald in deiner Buchhaltung eines der sieben Ereignisse eintritt.
Ausgelöst wird durch das Ereignis, nicht durch eine Frage. Dein System muss nichts tun außer zuhören.
Der Unterschied zum üblichen Weg liegt in der Richtung. Ohne Webhook müsste dein System regelmäßig nachfragen: Ist eine neue Rechnung da? Und jetzt? Und jetzt? Das kostet Abfragen, und zwischen zwei Abfragen liegt immer eine Lücke. Mit Webhook erfährt dein System es in dem Moment, in dem es passiert, ohne gefragt zu haben.
Wenn du einen Vergleich brauchst: Ein Webhook ist der Anruf, den du bekommst. Eine Schnittstelle ist die Nummer, die du wählst, wenn du etwas wissen willst.
Welche sieben Ereignisse auslösen
Ein Webhook ist nur so nützlich wie die Liste dessen, worüber er berichtet. Deshalb steht sie hier vollständig.
Die beiden letzten kommen aus der Stripe-Anbindung. Gerade Zahlung fehlgeschlagen ist das Ereignis, auf das sich ein zweites System einhängen sollte, denn eine fehlgeschlagene Zahlung merkt sonst niemand, bis jemand die offenen Posten durchsieht.
Eigene Auslöser lassen sich nicht definieren. Es sind diese sieben, und was dein System damit anstellt, ist deine Entscheidung.
- Rechnung erstelltbeim Finalisieren
- Rechnung bezahltnach Zuordnung der Zahlung
- Angebot angenommenwenn der Kunde zustimmt
- Neue Ausgabewenn ein Beleg gebucht wird
- Neuer Kundebeim Anlegen
- Zahlung empfangenaus der Zahlungsanbindung
- Zahlung fehlgeschlagendamit du nachfassen kannst
Wie dein System prüft, dass die Nachricht von uns kommt
Eine Adresse, die Nachrichten von außen annimmt, nimmt sie von jedem an. Deshalb trägt jede Benachrichtigung eine Signatur.
- 1
Etwas passiert
Eine Rechnung wird finalisiert, ein Angebot angenommen, eine Zahlung kommt an.
- 2
Wir schicken
Die Benachrichtigung geht an die Adresse, die du hinterlegt hast, zusammen mit einer Signatur.
- 3
Du prüfst
Dein System rechnet die Signatur nach. Stimmt sie nicht, war die Nachricht nicht von uns oder wurde unterwegs verändert.
Dieser dritte Schritt ist kein Vorschlag. Eine offene Adresse ohne Prüfung ist eine Einladung an jeden, der sie kennt, und sie wird früher bekannt, als einem lieb ist.
Wann du welches der beiden brauchst
Beide verbinden dein System mit deiner Buchhaltung, aber sie beantworten verschiedene Fragen. Die Verwechslung kostet meistens einen halben Tag.
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 sagt, dass eine Rechnung bezahlt wurde, und die Schnittstelle liefert auf Nachfrage die Rechnung dazu. Beide sind ab dem Business-Tarif enthalten.
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.
- Ab dem Business-Tarif. Im Starter gibt es keine Webhooks.
- Sieben festgelegte Ereignisse. Eigene Auslöser lassen sich nicht definieren.
- Ein Webhook meldet, er liefert keine Auswertung. Wer Daten braucht, holt sie über die Schnittstelle.
Fragen, die vor dem Start kommen
Welche Ereignisse lösen einen Webhook aus?
Sieben: Rechnung erstellt, Rechnung bezahlt, Angebot angenommen, neue Ausgabe, neuer Kunde, Zahlung empfangen und Zahlung fehlgeschlagen. Eigene Auslöser lassen sich nicht definieren, es sind genau diese sieben.
Wie prüfe ich, dass eine Meldung wirklich von euch kommt?
Jede Benachrichtigung trägt eine Signatur. Dein System rechnet sie nach; stimmt sie nicht, war die Nachricht nicht von uns oder wurde unterwegs verändert. Dieser Schritt ist kein Vorschlag: Eine offene Adresse ohne Prüfung nimmt Nachrichten von jedem an.
Brauche ich für Webhooks einen eigenen Server?
Du brauchst eine Internetadresse, die Nachrichten annehmen kann. Das kann ein eigener Server sein, genauso gut aber ein Dienst, der aus einer eingehenden Meldung eine Aktion macht. Volk Accountant schickt dorthin, mehr setzt es nicht voraus.
Ab welchem Tarif gibt es Webhooks?
Ab Business, zusammen mit der öffentlichen Schnittstelle. Im Starter gibt es weder das eine noch das andere. Ein Webhook meldet, dass etwas passiert ist; die Daten dazu holt man über die Schnittstelle.
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.
Trag eine Testadresse ein und schreib eine Rechnung
14 Tage kostenlos startenGeprüft am 5. Oktober 2026