Erros
O DVS usa um envelope de erro padrão:
{
"error_code": "071-403-document-type-not-allowed",
"message": "Provider does not have access to the requested document type",
"additional_information": {
"document_type": "OPME",
"country_code": "BR",
"agreement_code": "BRADESCO_xxx"
}
}
Catálogo
4xx — Erros do client
| Status | error_code | Significado |
|---|---|---|
| 400 | 071-400 | Bad request genérico |
| 401 | 071-401 | Bearer token ausente ou inválido |
| 403 | 071-403 | Falta a authority necessária |
| 403 | 071-403-document-type-not-allowed | Sem acesso ao (document_type, country, agreement) solicitado |
| 403 | 071-403-tenant-mismatch | Tentativa de acesso cross-tenant |
| 403 | 071-403-classifier-not-allowed | classifier_slug solicitado não disponível para o tenant |
| 404 | 071-404 | Recurso não encontrado |
| 404 | 071-404-no-rules-configured | Não existe rule set para o tipo de documento |
| 409 | 071-409 | Conflito (genérico) |
| 409 | 071-409-idempotency-mismatch | Mesmo Idempotency-Key com body diferente |
| 413 | 071-413-file-too-large | Arquivo inline excede o limite de tamanho |
| 422 | 071-422 | Erro de validation (Pydantic) |
| 422 | 071-422-unknown-document-type | document_type não consta no catálogo |
| 422 | 071-422-agreement-required | Múltiplos agreements disponíveis; especifique um |
| 422 | 071-422-ssrf-blocked | URL externa bloqueada pela política de segurança |
| 422 | 071-422-mime-not-allowed | MIME type não está na allowlist |
| 422 | 071-422-s3-url-not-allowed | URL S3 não está em bucket da allowlist |
| 429 | 071-429 | Limite de taxa ou quota excedido |
5xx — Erros do server
| Status | error_code | Significado |
|---|---|---|
| 500 | 071-500 | Erro interno inesperado |
| 500 | 071-500-no-default-classifier | Configuração inválida para o tenant — contate a OSIGU |
| 502 | 071-502-classifier-upstream | Motor de classification upstream falhou após retries |
| 502 | 071-502-extraction-failed | Extração de documento falhou após retries upstream |
| 503 | 071-503-globally-paused | Circuit breaker global ativo |
| 503 | 071-503-extraction-paused | Limite horário de extração atingido |
| 504 | 071-504-sync-timeout | Request sync excedeu o orçamento de processamento; faça polling do resultado |
Estratégia de retry
Veja Tratar Erros para a política completa de retry.