REST-API · POST /check/batch · kostenpflichtig
Diese Route prüft bis zu 1.000 Kennungen in einem einzigen Aufruf. Sie eignet sich, um den ganzen Lieferanten- oder Kundenstamm regelmäßig zu prüfen, etwa einmal im Monat.
Jede Kennung wird so geprüft wie bei POST /check. Die Ergebnisse kommen in derselben Reihenfolge zurück, in der Sie die Kennungen geschickt haben.
Anfrage
Adresse: POST https://invoicepress.de/wp-json/einvoice-api/v1/check/batch
Schlüssel: Senden Sie Ihren API-Schlüssel in der Kopfzeile Authorization: Bearer <Schlüssel>. Ohne gültigen Schlüssel antwortet die Route mit dem Status 401.
Inhalt: Der Inhalt der Anfrage ist JSON mit dem Feld items: eine Liste mit bis zu 1.000 Einträgen, jeder wie bei POST /check mit scheme, value und wahlweise context.
Antwort
results – Ein Ergebnis je Kennung, in derselben Reihenfolge, jedes mit denselben Feldern wie bei POST /check.
status – valid, invalid oder unknown, wenn das Register gerade keine Auskunft gibt.
Status 400 – Die Liste ist leer oder hat mehr als 1.000 Einträge.
Status 401 – Der Schlüssel fehlt, ist unbekannt oder gesperrt.
Status 429 – Der Stapel würde das restliche Kontingent überschreiten. Dann wird nichts geprüft und nichts gezählt.
Beispiel
curl -X POST "https://invoicepress.de/wp-json/einvoice-api/v1/check/batch" \
-H "Authorization: Bearer <Schlüssel>" \
-H "Content-Type: application/json" \
-d '{"items":[{"scheme":"vat","value":"DE136695976"},{"scheme":"lei","value":"529900T8BM49AURSDO55"}]}'
Kosten
Die Route ist kostenpflichtig. Jede geprüfte Kennung zählt als eine Kennungsprüfung gegen das Monatskontingent Ihres Tarifs. Zum Ausprobieren gibt es den kostenlosen Tarif „Frei“ mit eigenem Schlüssel; er reicht für etwa zwei Kennungsprüfungen am Tag. Antworten mit einem Fehlerstatus zählen nicht.
Ein Stapel wird als Ganzes angenommen oder abgewiesen. Gezählt wird jede Kennung einzeln: Ein Stapel mit 100 Kennungen zählt 100 Kennungsprüfungen.