Errors
Errors use RFC 9457 problem details (application/problem+json). Branch on the stable code, show detail to people.
{
"type": "about:blank",
"title": "Bad Request",
"status": 400,
"detail": "Summary invoices need the invoicing period start and end (ibr-138-ae)",
"code": "VALIDATION"
}
Field errors add an errors array: [{"field":"lines[0].unitCode","message":"must not be blank"}]. Unexpected errors return
500 INTERNAL_ERROR with a reference to quote to support.
| Status | code | Meaning |
|---|---|---|
| 400 | VALIDATION | Invalid request or business rule (message names the PINT AE rule where relevant) |
| 400 | XML_NOT_WELL_FORMED | The UBL is not well-formed XML |
| 401 | INVALID_API_KEY, UNAUTHENTICATED, ACCOUNT_INACTIVE | Missing, wrong, revoked or expired credentials; inactive company |
| 402 | SUBSCRIPTION_REQUIRED, QUOTA_EXCEEDED | No active plan, or the plan's documents are used up |
| 403 | INSUFFICIENT_SCOPE, API_KEY_FORBIDDEN, SANDBOX_NOT_ALLOWED | API key not allowed here |
| 403 | SENDER_NOT_ALLOWED | The seller endpoint is not a participant of your company |
| 403 | FORBIDDEN, PERMISSION_DENIED, VERIFICATION_PENDING | Not allowed; company not verified yet |
| 404 | NOT_FOUND | Unknown id, or not visible to your company |
| 409 | CONFLICT | State conflict (e.g. changing an issued invoice) |
| 422 | UNSUPPORTED_DOCUMENT | Not a PINT AE invoice or credit note |
| 429 | RATE_LIMITED | Too many requests, see rate limits |
| 503 | PEPPOL_DISABLED, MAIL_UNAVAILABLE | A dependency is temporarily unavailable; retry later |
Retry 429, 503 and network errors with backoff; with an Idempotency-Key retrying a submission is always safe.
Do not retry other 4xx without changing the request.