Converter API

Du musst nicht auf die Converter API warten: Die Parser API liefert für jede unterstützte Rechnung ein kanonisches invoice-JSON, das die Creator API direkt als Eingabe akzeptiert. Zwei API-Calls ergeben damit heute schon eine vollständige Konvertierung – im Beispiel: XRechnung zu ZUGFeRD.

1. 1Quellrechnung parsen – POST /api/v1/invoice/parse akzeptiert XML oder ZUGFeRD/Factur-X-PDF (Base64) und erkennt Format und Land automatisch.
2. 2Optional validieren – der Validate-Endpunkt prüft das invoice-JSON gegen die Länderregeln, ohne dein Kontingent zu belasten.
3. 3Zielformat generieren – das invoice-JSON unverändert an den Generate-Endpunkt des Zielformats übergeben; ZUGFeRD-Profil per formatOptions.profile.

1# Funktioniert heute – Parser + Creator API kombiniert
2 
3# 1) Quelle parsen (Auto-Detect: Format & Land)
4INVOICE=$(curl -s -X POST https://service.invoice-api.xhub.io/api/v1/invoice/parse \
5  -H "Authorization: Bearer sk_live_abc123..." \
6  -H "Content-Type: application/json" \
7  -d '{"data": "'$(base64 -i xrechnung.xml)'", "filename": "xrechnung.xml"}' \
8  | jq '.invoice')
9 
10# 2) invoice-JSON unverändert ins Zielformat generieren
11jq -n --argjson inv "$INVOICE" '{invoice: $inv, formatOptions: {profile: "EN16931"}}' \
12  | curl -s -X POST https://service.invoice-api.xhub.io/api/v1/invoice/de/zugferd/generate \
13      -H "Authorization: Bearer sk_live_abc123..." \
14      -H "Content-Type: application/json" \
15      -d @- \
16  | jq -r '.data' | base64 -d > rechnung-zugferd.pdf

Grenzen: Als Eingabe werden Rechnungen aus 28 Ländern erkannt, als Ausgabe stehen 11 Formate in 14 Ländern bereit. Die Konvertierung läuft über das kanonische Rechnungsmodell – formatspezifische Sonderfelder, die es nicht abbildet, gehen verloren; die Parse-Response weist darauf in warnings hin.