Erori și catalogul

Problem JSONCopiați linkul către această secțiune

Fiecare răspuns de eroare este problem JSON (RFC 9457): type, title și status, cu detail când mai este ceva de spus. Un 422 adaugă errors, o listă de constatări. Fiecare are un code din catalog, cine o corectează (who_fixes), un fix_hint și un message, plus un field când constatarea privește un singur câmp (consultați pagina 3.2). Linia evidențiată este codul.

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
}

O cale pe care serviciul nu o are primește 404 cu {"detail": "Not Found"}, JSON simplu.

Ce înseamnă fiecare codCopiați linkul către această secțiune

Fiecare 409 are propriul type de problemă, sub https://eurinvoice.com/problems/: idempotency-conflict, request-in-progress, already-submitted, send-in-progress, dead-letter, credential-exists și credential-revoked. Citiți type, nu title, pentru a le deosebi. Un 413 nu este stocat pentru Idempotency-Key, așa că aceeași cheie poate fi folosită din nou cu un corp mai mic.

Un 429 vine pentru fiecare client și domeniu, cu Retry-After (consultați limitele). După un 202 nu retrimiteți niciodată. Erorile din partea rețelei care pot trece la o nouă încercare sunt reîncercate după programul nostru, iar o respingere definitivă ajunge pe lista de gestionare.

Cine acționeazăCopiați linkul către această secțiune

Fiecare cod din catalog are un singur responsabil.

Partenerul corectează 400, 401, 403, 409, 413 și 415. Un 422 conține constatări și fiecare indică cine o corectează: erp este partenerul, us este eurinvoice.

CatalogulCopiați linkul către această secțiune

Catalogul conține un cod pentru fiecare constatare. Această pagină arată un eșantion de douăsprezece, unul sau două pentru fiecare familie de reguli. Tastați un cod și apăsați Enter pentru a sări la el. Cu o cheie, GET /catalogue/{code} explică orice cod (consultați căutarea în catalog). Catalogul complet este destinat partenerilor: solicitați-l prin accesul la sandbox.