Webhook-Integration
Konfigurieren Sie TaprNext so, dass freigegebene Rechnungen per Webhook an Ihren Endpunkt gesendet werden.
So funktionieren Webhooks
Abschnitt betitelt „So funktionieren Webhooks“Nach der Rechnungsfreigabe in TaprNext löst der Webhook-Service einen POST-Request an Ihren konfigurierten Endpunkt aus — zur Weiterverarbeitung in Ihrem ERP.
Konfigurationsschritte
Abschnitt betitelt „Konfigurationsschritte“- Navigieren zu Tapr Settings > Integrations > Webhooks
- Auf Add Webhook klicken
- Folgende Felder ausfüllen:
- Name: Beschreibende Bezeichnung (z. B. „ERP Invoice Sync“)
- URL: Ihr Empfangs-Endpunkt (z. B. https://api.yourcompany.com/invoices)
- Events: Trigger auswählen, z. B.
invoice.approved - Secret: Automatisch erzeugter HMAC-Signaturschlüssel
- Active: Webhook aktivieren
Event-Typen
Abschnitt betitelt „Event-Typen“| Event | Auslöser | Zweck |
|---|---|---|
invoice.approved | Rechnungsfreigabe | An ERP senden |
invoice.rejected | Rechnungsablehnung | Lieferantenbenachrichtigung |
invoice.posted | ERP-Buchung abgeschlossen | Empfangsbestätigung |
invoice.created | Neue Rechnung eingegangen | Alerts |
vendor.created | Neuer Lieferant angelegt | ERP-Synchronisation |
Payload-Struktur
Abschnitt betitelt „Payload-Struktur“Webhooks liefern JSON mit Rechnungsdetails: Lieferanteninformationen, Beträge, Positionen, Daten, PO-Referenzen, Freigabe-Metadaten und eine kryptografische Signatur zur Verifizierung.
Sicherheitsoptionen
Abschnitt betitelt „Sicherheitsoptionen“HMAC-Signatur (empfohlen): TaprNext signiert Anfragen mit dem Header X-Tapr-Signature: sha256=<hash> zur Verifizierung.
API-Key-Header: X-API-Key in Anfragen mitführen.
Basic Auth: Zugangsdaten in der URL einbetten.
Wiederholungsstrategie
Abschnitt betitelt „Wiederholungsstrategie“Fehlgeschlagene Zustellungen werden in steigenden Intervallen wiederholt: sofort, 1 Minute, 5 Minuten, 30 Minuten und 2 Stunden. Das System wiederholt bei 5xx-Fehlern, Timeouts und Verbindungsfehlern — nicht bei 4xx-Fehlern oder ungültigen Antworten.
Testen & Monitoring
Abschnitt betitelt „Testen & Monitoring“Mit dem Button Test Beispiel-Payloads senden. Zustellhistorie unter Settings > Integrations > Webhook Logs mit Filteroptionen überwachen.
Beispielimplementierungen
Abschnitt betitelt „Beispielimplementierungen“Python-(Flask-) und Node.js-(Express-)Beispiele zeigen Signaturverifizierung und Rechnungsverarbeitungs-Workflows.