Hilfe › Anbindungen
API und Webhooks
Kolibill aus eigenen Programmen steuern und bei Ereignissen benachrichtigt werden.
API
Kolibill hat eine REST-API für jedes Feld jeder Ressource: Rechnungen, Angebote, Kunden, Artikel, Zahlungen, Belege, Kontoumsätze und mehr. Die vollständige Beschreibung finden Sie in der API-Dokumentation.
- Einstellungen → Anbindungen → API & Webhooks → API-Tokens → Neues Token. Rechte (lesen oder schreiben) und Ablaufdatum wählen. Das Token wird nur einmal angezeigt.
- Jede Anfrage schickt es im Header:
Authorization: Bearer <token>. - Adresse:
https://ihre-firma.kolibill.de/api/v1/…(bzw. Ihre eigene Domain).
curl -H "Authorization: Bearer $TOKEN" https://ihre-firma.kolibill.de/api/v1/invoices?filter[status]=open
- Filter, Sortierung, Suche und Seiten:
filter[...],sort=-invoice_date,q=,page,per_page. - PDF und XML einer Rechnung direkt abrufen.
- Idempotency-Key im Header macht POST-Anfragen sicher wiederholbar.
- Fehler kommen als
{"error":{"code","message","details"}}, Validierungsfehler mit HTTP 422 je Feld.
Im Programm selbst gibt es dieselbe Dokumentation zum Ausprobieren (Swagger UI).
Webhooks
Kolibill ruft Ihre Adresse auf, sobald etwas passiert – z. B. invoice.paid, invoice.finalized, customer.created, quote.accepted oder expense.created.
- Anfrage:
POSTmit JSON{id, event, created_at, data}. - Signatur im Header
X-Webhook-Signature: t=<Zeit>,v1=<HMAC-SHA256 von "<Zeit>.<Body>">mit Ihrem Secret. X-Webhook-Idbleibt bei Wiederholungen gleich – nutzen Sie sie, um Doppelte zu erkennen.- Fehlgeschlagene Zustellungen werden nach 1, 5 und 30 Minuten, 2, 6 und 24 Stunden wiederholt. Nach 50 Fehlern in Folge pausiert der Webhook.
- Zustellprotokoll, erneute Zustellung per Klick und Test-Ereignis im Programm.
API und Webhooks gehören zum Tarif All-inkl.
Frage nicht beantwortet? Schreiben Sie uns über das Kontaktformular.