Die API ist das Produkt.
Fünf Aufrufe von der leeren Organisation bis zur ersten konformen Rechnung. Ein Datenmodell für Finance, Engineering und Ops – dokumentiert, versioniert, replay-sicher.
Fünf Aufrufe bis zur ersten Rechnung.
Kein Einrichtungsassistent, keine Klickstrecken. Alles, was Kontorion kann, ist ein API-Aufruf – das hier ist der kürzeste Weg.
- 01
customer.createdKunde anlegen
Mit USt-ID – die VIES-Prüfung läuft automatisch.
terminalcurl -X POST https://api.kontorion.eu/v1/customers \ -d name="Acme GmbH" -d country="DE" \ -d vat_id="DE123456789"→ 201 · customer.created · vies: valid
- 02
product.createdProdukt definieren
Einmal definiert, überall abrechenbar – mit Verbrauchsmetrik.
terminalcurl -X POST https://api.kontorion.eu/v1/products \ -d name="API Platform" -d metric="api_calls"→ 201 · product.created
- 03
plan.createdPlan mit Staffelpreis
VOLUME, STAIRCASE oder PACKAGE – versioniert ab Tag eins.
terminalcurl -X POST https://api.kontorion.eu/v1/plans \ -d product="prod_x1" -d model="STAIRCASE" \ -d tiers[0][up_to]=50000 -d tiers[0][rate]="0.008"→ 201 · plan.created · pinned @v1
- 04
subscription.activatedSubscription starten
Trial, Proration und SEPA-Mandat inklusive.
terminalcurl -X POST https://api.kontorion.eu/v1/subscriptions \ -d customer="cus_8f2k" -d plan="plan_pro@v1" \ -d trial_days=14→ 201 · subscription.activated
- 05
invoice.createdErste Rechnung
Mit der Test-Clock in die Zukunft springen – die Rechnung entsteht wie in Produktion.
terminalcurl -X POST https://api.kontorion.eu/v1/test_clocks/tc_1/advance \ -d to="2026-05-01"→ invoice.created · XRechnung valid · € 412,80
Was die API garantiert.
Zusagen statt Feature-Liste – das hält jede Antwort, jeder Fehler und jeder Webhook verbindlich ein.
Signiert, at-least-once, replay-fähig.
Jedes Event trägt eine HMAC-Signatur und eine eindeutige ID. Zustellung wird wiederholt, bis Ihr Endpunkt bestätigt – Duplikate erkennen Sie an der Event-ID.
RFC 9457 Problem Details.
Jeder Fehler ist maschinenlesbar: type, title, status, detail. Kein Raten, kein Regex auf Fehlertexte.
Jeder POST, sicher wiederholbar.
Der Idempotency-Key-Header dedupliziert Wiederholungen – Netzwerkfehler erzeugen keine Doppelbuchungen.
Cursor statt Offset.
Stabil unter Last, konsistent bei parallelen Inserts – für Exports und Syncs gebaut.
Die Zeit in der Sandbox vorspulen.
Trials, Verlängerungen, Mahnläufe – deterministisch testbar, bevor echtes Geld fließt.
plan@v3 – für immer.
Subscriptions pinnen ihre Plan-Version. Katalogänderungen verändern niemals laufende Rechnungen.
Die Spezifikation ist der Vertrag.
Jeder Endpunkt, jedes Schema, jeder Fehlercode steht in der maschinenlesbaren Spec – Client-Generierung inklusive.
Ein Index, den Maschinen lesen.
Unter /llms.txt liegt die gesamte Doku als flache Liste – jeder Eintrag ein Link mit einer Zeile Kontext. Aus der echten Docs-Sitemap generiert, also stehen nur Seiten drin, die es auch gibt.
Vollständiger Doku-Index: https://docs.kontorion.eu/llms.txt Pro Seite eine .md-Variante
Jede Doku-Seite zusätzlich als reines Markdown unter derselben URL mit .md – token-sparsam für Agents. In Vorbereitung, noch nicht überall live.
# Kontorion
> EU-native Abrechnungs-Infrastruktur. Maschinenlesbarer Index der Doku.
## Docs
- [Kunden anlegen](https://docs.kontorion.eu/customers.md): Kunde mit USt-ID und automatischer VIES-Prüfung.- [Produkte definieren](https://docs.kontorion.eu/products.md): Abrechenbare Einheit mit Usage-Metrik.- [Pläne & Staffelpreise](https://docs.kontorion.eu/plans.md): VOLUME, STAIRCASE oder PACKAGE – versioniert ab Tag eins.- [Subscriptions](https://docs.kontorion.eu/subscriptions.md): Trial, Proration und SEPA-Mandat inklusive.- [Rechnungen](https://docs.kontorion.eu/invoices.md): XRechnung und ZUGFeRD, validiert vor dem Versand.- [Webhooks](https://docs.kontorion.eu/webhooks.md): HMAC-signiert, at-least-once, replay-fähig.- [Test-Clocks](https://docs.kontorion.eu/test-clocks.md): Die Zeit in der Sandbox deterministisch vorspulen. ## OpenAPI
- [OpenAPI 3.0](https://docs.kontorion.eu/v1/openapi.json): Die Spezifikation ist der Vertrag – Client-Generierung inklusive. # Stand: 2026-07-04 · generiert aus der Docs-SitemapDer Rest steht in der Referenz.
Vollständige Endpunkte, Schemas, Webhook-Kataloge und Beispiele – ohne Anmeldung lesbar, mit Sandbox-Keys sofort ausprobierbar. Und überall auf der Website zeigt die Taste i zu jedem Artefakt den API-Pfad – auch hier.