Fehler und Katalog

Problem-JSONLink zu diesem Abschnitt kopieren

Jede Fehlerantwort ist Problem-JSON (RFC 9457): type, title und status, dazu detail, wenn es mehr zu sagen gibt. Ein 422 enthält zusätzlich errors, eine Liste von Befunden. Jeder enthält einen code aus dem Katalog, die Angabe, wer ihn behebt (who_fixes), einen fix_hint und eine message sowie ein field, wenn der Befund ein einzelnes Feld betrifft (siehe Seite 3.2). Die hervorgehobene Zeile ist der Code.

curl -X POST "https://api-sandbox-eu.eurinvoice.com/invoices/xml?route=PEPPOL&invoice_ref=INV-2026-0051" \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/xml" \
  -H "Idempotency-Key: order-2026-0051" \
  --data-binary @not-an-invoice.xml

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.file.Path;

public class Example {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api-sandbox-eu.eurinvoice.com/invoices/xml?route=PEPPOL&invoice_ref=INV-2026-0051"))
            .header("Authorization", "Bearer <your-api-key>")
            .header("Content-Type", "application/xml")
            .header("Idempotency-Key", "order-2026-0051")
            .POST(HttpRequest.BodyPublishers.ofFile(Path.of("not-an-invoice.xml")))
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

import { readFile } from 'node:fs/promises';

const response = await fetch('https://api-sandbox-eu.eurinvoice.com/invoices/xml?route=PEPPOL&invoice_ref=INV-2026-0051', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <your-api-key>',
    'Content-Type': 'application/xml',
    'Idempotency-Key': 'order-2026-0051',
  },
  body: await readFile('not-an-invoice.xml'),
});
console.log(response.status);
console.log(await response.text());

{
  "type": "https://eurinvoice.com/problems/validation-failed",
  "title": "The invoice did not pass the checks",
  "errors": [
    {
      "code": "EI-XML-TYPE",
      "fix_hint": "Send the invoice itself, in the format agreed for the route.",
      "who_fixes": "erp",
      "source": "XML-safety",
      "message": "The file is not an invoice in a format this route accepts. Please send the invoice in the agreed format."
    }
  ],
  "status": 422
}

Für einen Pfad, den der Service nicht kennt, lautet die Antwort 404 mit {"detail": "Not Found"}, als einfaches JSON.

Was jeder Status bedeutetLink zu diesem Abschnitt kopieren

Jedes 409 hat einen eigenen Problem-type unter https://eurinvoice.com/problems/: idempotency-conflict, request-in-progress, already-submitted, send-in-progress, dead-letter, credential-exists und credential-revoked. Lesen Sie den type, nicht den title, um sie zu unterscheiden. Ein 413 wird nicht unter dem Idempotency-Key gespeichert, derselbe Schlüssel kann also mit einem kleineren Body erneut verwendet werden.

Ein 429 kommt je Kunde und Scope, mit Retry-After (siehe Limits). Nach einem 202 senden Sie nie erneut. Bei Fehlern auf Seiten des Netzes, die vorübergehend sein können, versuchen wir es nach unserem Zeitplan erneut, und eine endgültige Ablehnung kommt auf die Betreuungsliste.

Wer handeltLink zu diesem Abschnitt kopieren

Jeder Katalogcode hat genau eine zuständige Stelle.

Der Partner behebt 400, 401, 403, 409, 413 und 415. Ein 422 enthält Befunde, und jeder sagt, wer ihn behebt: erp ist der Partner, us ist eurinvoice.

Der KatalogLink zu diesem Abschnitt kopieren

Der Katalog enthält für jeden Befund einen Code. Diese Seite zeigt eine Auswahl von zwölf, einen oder zwei je Regelfamilie. Geben Sie einen Code ein und drücken Sie Enter, um zu ihm zu springen. Mit einem Schlüssel erklärt GET /catalogue/{code} jeden Code (siehe Katalogabfrage). Der vollständige Katalog ist für Partner: Fordern Sie ihn mit dem Zugang zur Sandbox an.