Rechnungen

ZUGFeRD-Rechnung erzeugen (Abo, Credits oder Freikontingent)

Bettet die EN-16931-Daten als CII-XML in die übergebene PDF ein und liefert die fertige ZUGFeRD-PDF (PDF/A-3). Ohne PDF setzt finisma die Rechnung aus den Daten, optional mit Logo (Part 'logo' bzw. logo_base64; PNG, JPEG oder SVG, max. 500 KB) und Sprache (lang: de oder en); die fertige Datei durchläuft dann vor der Auslieferung die autoritative Prüfung (PDF/A-3, EN 16931). Die Anfrage kommt als multipart/form-data oder als application/json im Format des MCP-Tools create_zugferd. Standardantwort ist die binäre PDF; mit 'Accept: application/json' kommt stattdessen { pdf_base64, bytes }. Ohne Abo zahlt zuerst das Guthaben (1 Credit je Rechnung, ohne Wasserzeichen und ohne Tageslimit; Saldo über GET /me). Ohne Guthaben kostenlos mit Konto: die PDF trägt dann das finisma-Prüfsiegel als Wasserzeichen, standardmäßig bis zu 5 Rechnungen pro Tag (danach 429 free_quota_exhausted). Mit 'format=xml' (oder 'Accept: application/xml') kommt nur das CII-XML: kein Träger-PDF nötig, kein Einbettungsschritt, deutlich schneller. Dieser Weg erfordert ein aktives Abo oder Guthaben, weil das kostenlose Tageskontingent mit dem Prüfsiegel als Wasserzeichen arbeitet und ein XML keines tragen kann.

post/invoices

Request

  • Base URL: https://finisma.de/api/v1
  • URL: https://finisma.de/api/v1/invoices
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://finisma.de/api/oauth/authorize, token URL https://finisma.de/api/oauth/token, scopes: invoice:verify, invoice:create)

Query parameters

format'pdf' | 'xml'

Ausgabeform. 'pdf' (Standard) liefert die ZUGFeRD-PDF, 'xml' nur das CII-XML. Bei 'xml' ist der pdf-Part nicht nötig und wird ignoriert; Anhänge landen weiterhin als BT-125 im XML, die PDF/A-3-Ebene entfällt.

Request body

pdf_base64string byte

Optional: die visuelle Rechnungs-PDF (max. 25 MB). Fehlt sie, wird die Rechnung aus den Daten gesetzt.

logo_base64string byte

Optionales Logo (PNG, JPEG oder SVG, max. 500 KB), Base64 oder data:-URI. Nur ohne pdf_base64.

logo_mime'image/png' | 'image/jpeg' | 'image/svg+xml'

Optional; der Typ wird sonst aus dem Inhalt erkannt.

lang'de' | 'en'
filenamestring

Ausgabedateiname (Standard: invoice.pdf).

Response

Erzeugte ZUGFeRD-PDF, bei format=xml das CII-XML. Die Größe der Antwort steht zusätzlich im Header X-Invoice-Bytes.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.