multi – gegen alle Fassungen prüfen

REST-API · POST /validate/multi · kostenpflichtig

Gegen jede Fassung prüfen: wenn unklar ist, nach welcher eine Rechnung erstellt wurde.

Diese Route prüft eine Rechnung gegen jede Fassung des Regelwerks, die in Frage kommt. Bei XRechnung bestimmt das Rechnungsdatum genau eine Fassung. Bei ZUGFeRD und Factur-X beginnt die Prüfung mit der neuesten Fassung und geht zu den älteren, bis eine Fassung die Rechnung annimmt. Nimmt keine sie an, gilt der Bericht der neuesten.

Das hilft, wenn Sie Rechnungen von vielen Lieferanten bekommen und nicht wissen, mit welcher Software und nach welcher Fassung sie erstellt wurden. Ein Aufruf kostet eine Prüfung, auch wenn mehrere Fassungen geprüft werden.

Zur API-Übersicht

Im Browser ausprobieren

Anfrage

So rufen Sie die Route auf

Adresse: POST https://invoicepress.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://invoicepress.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.

Tarife und Schlüssel