Pogreške i katalog

Problem JSONKopiraj poveznicu na ovaj odjeljak

Svaki odgovor s pogreškom je problem JSON (RFC 9457): type, title i status, uz detail kad postoji dodatno objašnjenje. Odgovor 422 dodaje errors, popis nalaza. Svaki nalaz ima code iz kataloga, tko ga ispravlja (who_fixes), fix_hint i message te field kad se nalaz odnosi na jedno polje (pogledajte stranicu 3.2). Istaknuti redak je šifra.

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
}

Putanja koju usluga nema daje odgovor 404 s {"detail": "Not Found"}, u običnom JSON-u.

Što znači pojedini statusKopiraj poveznicu na ovaj odjeljak

Svaki 409 ima vlastiti type problema, pod https://eurinvoice.com/problems/: idempotency-conflict, request-in-progress, already-submitted, send-in-progress, dead-letter, credential-exists i credential-revoked. Da biste ih razlikovali, čitajte type, a ne title. Odgovor 413 ne sprema se uz Idempotency-Key, pa se isti ključ može ponovno upotrijebiti s manjim tijelom.

Odgovor 429 dolazi po klijentu i opsegu, uz Retry-After (pogledajte ograničenja). Nakon odgovora 202 račun nikad ne šaljete ponovno. Pogreške na strani prijenosnog sustava koje mogu proći ponavljamo prema vlastitom rasporedu, a trajno odbijanje ide na popis za obradu.

Tko postupaKopiraj poveznicu na ovaj odjeljak

Svaka šifra iz kataloga ima jednu odgovornu stranu.

Partner ispravlja 400, 401, 403, 409, 413 i 415. Odgovor 422 sadrži nalaze i svaki kaže tko ga ispravlja: erp je partner, us je eurinvoice.

KatalogKopiraj poveznicu na ovaj odjeljak

Katalog sadrži šifru za svaki nalaz. Ova stranica prikazuje uzorak od dvanaest šifri, jednu ili dvije za svaku skupinu pravila. Upišite šifru i pritisnite Enter da biste skočili na nju. S ključem GET /catalogue/{code} objašnjava bilo koju šifru (pogledajte pretraživanje kataloga). Cijeli katalog namijenjen je partnerima: zatražite ga uz pristup sandboxu.