WebHooks - Beispiele
Dokument
document.create = teilt zunächst nur die Erstellung eines Entwurfes mit
document.completed= teilt mit, wenn ein Dokument fertig gestellt wurde
document.update = informiert dich, falls ein Dokument aktualisiert
document.deleted = teilt mit, wenn ein Dokument gelöscht wird
document.payment_add = teilt mit, wenn ein neuer Zahlungseingang für ein Dokument hinterlegt wird
document.payment_delete = teilt mit, wenn ein Zahlungseingang gelöscht wird
Beispiel: Darf dein Lager die Ware erst versenden sobald eine Rechnung bezahlt wurde, kannst du über die WebHooks eine Benachrichtigung an das Lager in deiner Programmierung einrichten.
Kunde
Kontakt
contact.create = teilt mit, wenn einem Kunden ein neuer Ansprechpartner hinzugefügt wird
contact.update = informiert dich, falls dieser Ansprechpartner aktualisiert wird
contact.deleted = teilt mit, wenn ein Ansprechpartner gelöscht wird
Beispiel: Über die WebHooks kannst du die Ansprechpartner der Kunden mit deiner eigenen Programmierung synchronisieren. Arbeitest du neben easybill mit einem zweiten System, könnt du und deine Mitarbeiter immer die aktuellen Kundendaten einsehen.
Position
position.create = teilt mit, wenn einer neuer Rechnungsposten in easybill angelegt wird
position.update = informiert dich, falls ein Rechnungsposten aktualisiert wird
position.deleted = teilt mit, wenn ein Rechnungsposten gelöscht wird
Beispiel: Über die WebHooks kannst du die Rechnungsposten, also Artikel, Dienstleistungen oder Textzeilen, mit deiner eigenen Programmierung synchronisieren. In deiner Programmierung hast du somit immer Zugriff auf die aktuellen Posten und Preise. Nutzt du die Programmierung um Dokumente über easybill erstellen zu lassen, kannst du die ID des entsprechenden Rechnungsposten direkt übergeben.
Postausgang
postbox.create = teilt mit, wenn ein Dokument für den E-Mail-, Post- oder Fax-Versand übergeben wird
postbox.sent = teilt mit, wenn das Dokument erfolgreich versendet wurde
postbox.fail = informiert dich, wenn der Versand eines Dokumentes fehlgeschlagen ist
postbox.update = informiert dich, falls ein Versandvorgang aktualisiert wird
postbox.deleted = teilt mit, wenn ein Versandvorgang gelöscht wird
Beispiel: Über die WebHooks kannst du dich über den Versandstatus der Dokumente informieren lassen. Wichtig kann dies sein, wenn der Versand eines Dokumentes fehlschlägt.
SEPA Lastschrift
sepa-payment.create = teilt mit, wenn eine neue SEPA-XML in easybill erstellt wird
sepa-payment.update = informiert dich, falls die SEPA-XML aktualisiert wird
sepa-payment.deleted = teilt mit, wenn die SEPA-XML gelöscht wird
sepa-payment.exported = teilt mit, wenn die SEPA-XML exportiert wurde
Beispiel: Nutzt du die automatische Erstellung der SEPA-XML über die Wiederholungsrechnungen oder lassen deine Mitarbeiter die SEPA-XML erstellen, erhältst du über die WebHooks den Hinweis und kannst den Lastschrifteinzug über die SEPA-XML bei deiner Bank anstoßen.
Aufgabe
task.create = teilt mit, wenn eine neue Aufgabe in easybill angelegt wird
task.update = informiert dich, falls eine Aufgabe aktualisiert
task.delete = informiert dich, wenn eine Aufgabe gelöscht wird
Beispiel: Das Erstellen einer Aufgabe in easybill, kann ebenfalls eine Aufgabe in deiner Programmierung auslösen. Über die WebHooks kannst du so systemübergreifende Aufgaben erstellten.
Generelle Informationen, wie du einen WebHook anlegst, findest du hier: WebHooks anlegen