REST-API · POST /validate/multi · kostenpflichtig
Anfrage
So rufen Sie die Route auf
Adresse: POST https://einvoicetools.de/wp-json/einvoice-api/v1/validate/multi
Schlüssel: Senden Sie Ihren API-Schlüssel in der Kopfzeile Authorization: Bearer <Schlüssel>. Ohne diese Kopfzeile gilt das freie Kontingent von zwei Aufrufen je Route und Tag. Wird ein Schlüssel gesendet, der nicht gültig ist, antwortet die Route mit dem Status 401.
Inhalt: Der Inhalt der Anfrage ist die Rechnung selbst: als XML (XRechnung, Peppol BIS, CII oder UBL) mit Content-Type: application/xml oder als ZUGFeRD- beziehungsweise Factur-X-PDF mit Content-Type: application/pdf. Aus einer PDF holt der Dienst zuerst die eingebettete Rechnung.
Parameter
matrix=1 (wahlweise) – Prüft jede Fassung, statt bei der ersten aufzuhören, die die Rechnung annimmt. So sehen Sie auf einen Blick, wie jede Fassung entscheidet. Auch das kostet nur eine Prüfung.
Die Rechnung wird nur im Arbeitsspeicher verarbeitet und nicht gespeichert. Im Nutzungsprotokoll steht nur ein Fingerabdruck der Anfrage, nie ihr Inhalt.
Antwort
Was zurückkommt
accepted – Das Ergebnis der gewählten Fassung.
chosen – Die gewählte Fassung und der Grund, warum es diese ist.
steps – Eine Zeile je geprüfter Fassung, mit Ergebnis, Zahl der Befunde und den Regeln, in denen sich diese Fassung von den anderen unterscheidet.
Wenn etwas nicht geht
Status 400 – Die Anfrage war leer.
Status 401 – Ein Schlüssel wurde gesendet, ist aber unbekannt oder gesperrt.
Status 415 – Der Inhalt ist weder XML noch PDF.
Status 422 – Die XML-Datei ließ sich nicht lesen, oder die PDF enthält keine Rechnung.
Status 429 – Das Kontingent ist verbraucht.
Beispiel
Ein Aufruf mit curl
curl -X POST "https://einvoicetools.de/wp-json/einvoice-api/v1/validate/multi?matrix=1" \
-H "Authorization: Bearer <Schlüssel>" \
-H "Content-Type: application/pdf" \
--data-binary @rechnung.pdf
Kosten
Kontingent und Tarif
Die Route ist kostenpflichtig. Mit Schlüssel zählt jeder erfolgreiche Aufruf als eine Prüfung gegen das Monatskontingent Ihres Tarifs; Antworten mit einem Fehlerstatus zählen nicht. Zum Ausprobieren können Sie die Route ohne Schlüssel zweimal am Tag aufrufen. Diese Grenze gilt je Netzadresse und je Route: Zwei Aufrufe dieser Route lassen die übrigen Routen unberührt. Jede Antwort ohne Schlüssel sagt Ihnen in den Kopfzeilen X-RateLimit-Remaining und X-RateLimit-Reset, wie viele Aufrufe heute noch gehen und wann der Zähler zurückgesetzt wird.