API and agents
E-Rechnung API fuer Agenten, Backends und MCP-Clients
Agenten sollen keine Buchhaltungssysteme bedienen muessen, nur um eine deutsche B2B-Rechnung auszustellen. Sie brauchen ein kleines Werkzeug: strukturierte Rechnungsdaten hinein, technisch validiertes ZUGFeRD / Factur-X PDF heraus.
Die richtige Werkzeuggrenze
facturai macht keine Buchhaltung, kein Mahnwesen und keine Steuerberatung. Die API erzeugt und validiert das Rechnungsformat. Damit passt sie zu Agenten, MCP-Clients und Backends, die bereits wissen, wer verkauft, wer kauft und welche Leistungen berechnet werden.
Minimaler API-Fluss
POST /api/v1/invoices
seller profile: attached to API key
buyer: name, address, VAT ID, email
lines: quantity, unit, unit price, VAT rate
dates: invoice date, due date
Response:
application/pdf
ZUGFeRD / Factur-X hybrid invoiceWarum Validierung in die API gehoert
Ein Agent kann Zahlen und Texte vorbereiten. Er sollte aber nicht raten, ob das Ergebnis EN 16931-konform ist oder ob das XML im PDF richtig eingebettet wurde. facturai prueft das Format vor der Auslieferung und gibt keine Rechnung aus, wenn die Validierung scheitert.
Typische Einsaetze
- Claude oder Cursor erstellt eine Rechnung aus Projekt- und Kundendaten.
- Ein internes Agentensystem erzeugt Rechnungen nach erledigten Auftraegen.
- Ein SaaS-Backend bietet deutschen Kunden ZUGFeRD / Factur-X Export an.
- n8n, Make oder Zapier nutzen dieselbe API fuer no-code Workflows.
Naechste Schritte
Teste den Validator, lies die API-Doku oder erstelle einen API-Key fuer Agenten-Workflows.