Kolibill startet bald. Wir legen gerade letzte Hand an. Zum Start benachrichtigen
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.

  1. Einstellungen → Anbindungen → API & Webhooks → API-Tokens → Neues Token. Rechte (lesen oder schreiben) und Ablaufdatum wählen. Das Token wird nur einmal angezeigt.
  2. Jede Anfrage schickt es im Header: Authorization: Bearer <token>.
  3. 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: POST mit 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-Id bleibt 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.