Mit Webhooks können Sie bei vorher definierten Aktionen eine Benachrichtigung (Event) an einen HTTP-Server (z.B. Ihre Webanwendung) verschicken.
Die Benachrichtigungen enthalten jeweils die zur Aktion relevanten Daten im JSON-Format.
Die enthaltenen Datenstrukturen können Sie unserer API-Dokumentation, Abschnitt Schemas, entnehmen.
Schema documentation: https://api.fakturia.de/documentation/
Section Schemas
Event Type | Beschreibung DE | Description EN | Schema (data object) |
---|---|---|---|
Kunde / Customer | |||
CUSTOMER_CREATED | Kunde angelegt | Customer created | Attribute: customer Type: Customer |
CUSTOMER_CHANGED | Kunde geändert | Customer changed | Attribute: customer Type: Customer |
CUSTOMER_DELETED | Kunde gelöscht | Customer deleted | Attribute: customer Type: Customer |
CUSTOMER_CHANGEREQUEST_CREATED | Änderung der Kundendaten im Kundencenter beantragt | Change of customer data requested in customer center | Attribute: changeCustomer |
Artikel / Item | |||
ITEM_CREATED | Artikel angelegt | Item created | Attribute: item Type: Item |
ITEM_CHANGED | Artikel geändert | Item changed | Attribute: item Type: Item |
ITEM_DELETED | Artikel gelöscht | Item deleted | Attribute: item Type: Item |
Vertrag / Contract | |||
CONTRACT_CREATED | Vertrag angelegt | Contract created | Attribute: contract Type: Contract |
CONTRACT_ACTIVATED | Vertrag aktiviert | Contract activated | Attribute: contract Type: Contract |
CONTRACT_CHANGED | Vertrag geändert | Contract changed | Attribute: contract Type: Contract |
CONTRACT_TERMINATED | Vertrag gekündigt | Contract terminated | Attribute: contract Type: Contract |
CONTRACT_ENDED | Vertrag beendet (Vertragsende erreicht) | Contract ended (date of termination reached) | Attribute: contract Type: Contract |
Rechnung / Invoice | |||
INVOICE_CREATED | Rechnung erstellt | Invoice created | Attribute: invoice Type: Invoice |
INVOICE_PAYMENT_RECEIVED | Rechnung: Zahlungseingang erhalten | Invoice: payment received | Attribute: invoice Attribute: payDate Attribute: payAmount |
INVOICECORRECTION_CREATED | Rechnungskorrektur erstellt | Invoice correction created | Attribute: invoicecorrection Type: InvoiceCorrection |
Mahnwesen / Dunning | |||
DUNNING_CREATED | Mahnung verschickt | Dunning sent | Attribute: invoice Attribute: dunningLevel |
Bestellung / Order | |||
ORDER_RECEIVED | Bestellung erhalten | Order received | Attribute: orderCustomer Type: OrderCustomer |
Test | |||
TESTHOOK | Test-Aufruf | Test call | Attribute: dummyData Type: Dummy |