Feilkoder og feilkonvolutten

1. Alle 4xx- og 5xx-feil returnerer { "error": { type, code, message, param?, doc_url, request_id, errors? } }.
2. Forgren på type for å avgjøre om et nytt forsøk gir mening, og map code inn i ditt eget system.
3. param peker på det feilaktige feltet, f.eks. lines.0.vat_rate; errors[] vises når det er flere.
4. Logg request_id ved hver feil — den gjør at vi kan finne nøyaktig forespørselen i loggene våre.

json
{
  "error": {
    "type": "invalid_request_error",
    "code": "validation_failed",
    "message": "Datele trimise nu sunt valide.",
    "param": "lines.0.vat_rate",
    "doc_url": "https://4invoices.net/ro/api-dezvoltatori#errors",
    "request_id": "req_8a893f2f33d4472da8d6e144",
    "errors": [
      { "param": "lines.0.vat_rate", "message": "VAT rate must be a percent (21), not a fraction", "type": "value_error" }
    ]
  }
}

https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json

• rate_limit_error og de to upstream-typene kan prøves igjen. authentication_error, permission_error og invalid_request_error løses ikke ved å prøve igjen.
• En 404 returneres også for en id som tilhører en annen tenant: vi bekrefter aldri at andres data finnes.
• 409 idempotency_key_reuse betyr at du har brukt en nøkkel på nytt med annet innhold. Ikke tving det: sjekk hva som allerede er utstedt.
• doc_url i hver feil peker direkte til feilseksjonen i denne dokumentasjonen.
• Meldingene er på rumensk fordi API-et betjener en rumensk fiskal flyt; ikke tolk message, forgren på code.