Foutcodes en de foutenvelop

1. Elke 4xx en 5xx geeft { "error": { type, code, message, param?, doc_url, request_id, errors? } } terug.
2. Vertak op type om te bepalen of opnieuw proberen zin heeft, en map code in uw eigen systeem.
3. param wijst naar het foutieve veld, bijv. lines.0.vat_rate; errors[] verschijnt wanneer er meerdere zijn.
4. Registreer request_id bij elke fout — daarmee vinden we het exacte verzoek in onze logboeken.

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 en de twee upstream-typen mogen opnieuw worden geprobeerd. authentication_error, permission_error en invalid_request_error worden niet opgelost door opnieuw te proberen.
• Ook voor een id die bij een andere tenant hoort, wordt een 404 teruggegeven: we bevestigen nooit dat gegevens van iemand anders bestaan.
• 409 idempotency_key_reuse betekent dat u een sleutel hebt hergebruikt met een andere body. Forceer het niet: controleer wat al is uitgegeven.
• De doc_url in elke fout verwijst rechtstreeks naar het foutenhoofdstuk van deze documentatie.
• Berichten zijn in het Roemeens omdat de API een Roemeense fiscale flow bedient; parse message niet, maar vertak op code.