Codis d'error i el sobre d'error

1. Cada 4xx i 5xx retorna { "error": { type, code, message, param?, doc_url, request_id, errors? } }.
2. Decideix segons type si té sentit reintentar, i mapeja code al teu propi sistema.
3. param apunta al camp que falla, p. ex. lines.0.vat_rate; errors[] apareix quan n'hi ha diversos.
4. Registra request_id a cada error — ens permet trobar la petició exacta als nostres registres.

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 i els dos tipus upstream es poden reintentar. authentication_error, permission_error i invalid_request_error no es corregeixen reintentant.
• També es retorna un 404 per a un id que pertany a un altre client: mai no confirmem que existeixen dades d'un altre.
• 409 idempotency_key_reuse vol dir que has reutilitzat una clau amb un cos diferent. No ho forcis: revisa què s'ha emès ja.
• El doc_url de cada error apunta directament a la secció d'errors d'aquesta documentació.
• Els missatges són en romanès perquè l'API serveix un flux fiscal romanès; no analitzis message, decideix segons code.