Catálogo de códigos de erro

Referência consolidada. O campo code é estável — use-o para lógica condicional.

9.1. Pré-análise de perfil

HTTPcode
400PRE_PROFILE_ANALYSIS_INVALID_REQUEST
403PRE_PROFILE_ANALYSIS_PARTNER_NOT_AUTHORIZED
404PRE_PROFILE_ANALYSIS_NOT_FOUND
422PRE_PROFILE_ANALYSIS_REQUEST_REJECTED
500PRE_PROFILE_ANALYSIS_INTEGRATION_FAILURE

9.2. Lead

HTTPcode
400LEAD_QUERY_INVALID
422PRE_PROFILE_ANALYSIS_NOT_READY
500LEAD_DECISION_UNMAPPABLE
500LEAD_INTEGRATION_FAILURE

9.3. Planos

HTTPcode
422PLAN_NOT_AVAILABLE
500PLAN_INTEGRATION_FAILURE

9.4. Antifraude

HTTPcode
409ANTI_FRAUD_NOT_STARTABLE
422PLAN_NOT_SELECTED
500ANTI_FRAUD_INTEGRATION_FAILURE
500BIOMETRY_STATUS_UNMAPPABLE
500COMPLIANCE_ANALYSIS_STATUS_UNMAPPABLE

9.5. Contrato

HTTPcode
404CONTRACT_RESPONSIBLE_NOT_FOUND
409CONTRACT_RESPONSIBLE_REACTIVATION_CONFLICT
409CONTRACT_TERMS_ALREADY_SET
422CONTRACT_RESPONSIBLE_INVALID
422CONTRACT_TERMS_INVALID
500CONTRACT_INTEGRATION_FAILURE
500CONTRACT_RESPONSIBLE_INTEGRATION_FAILURE
500CONTRACT_TERMS_INTEGRATION_FAILURE

CONTRACT_RESPONSIBLE_INVALID e CONTRACT_RESPONSIBLE_INTEGRATION_FAILURE vêm do cadastro
cnpj-scoped (6.10/6.11). CONTRACT_RESPONSIBLE_NOT_FOUND, CONTRACT_TERMS_ALREADY_SET (ver gap
em 6.13), CONTRACT_TERMS_INVALID e CONTRACT_INTEGRATION_FAILURE vêm do endpoint combinado
(6.13) — este último cobre falha em qualquer uma das duas metades, o message diz qual.
CONTRACT_TERMS_INTEGRATION_FAILURE vem só da consulta (6.14).
CONTRACT_RESPONSIBLE_REACTIVATION_CONFLICT vem da inativação (6.12).

9.6. Assinatura do contrato

HTTPcode
404SIGNATURE_FORM_NOT_FOUND
409SIGNATURE_FORM_ALREADY_STARTED
422SIGNATURE_FORM_PRECONDITION_NOT_MET
500SIGNATURE_FORM_INTEGRATION_FAILURE

9.7. Webhooks

HTTPcode
400WEBHOOK_INVALID_DELIVERY_CURSOR
400WEBHOOK_INVALID_DELIVERY_FILTER
404WEBHOOK_NOT_FOUND
404WEBHOOK_CREDENTIAL_NOT_FOUND
409WEBHOOK_URL_CONFLICT
409WEBHOOK_CREDENTIAL_NAME_CONFLICT
409WEBHOOK_CREDENTIAL_IN_USE
422WEBHOOK_INVALID_EVENT_TYPE
422WEBHOOK_CREDENTIAL_INVALID_AUTH
500WEBHOOK_INTEGRATION_FAILURE

9.8. Transversal

HTTPcodeQuando ocorre
500AUTH_INTEGRATION_FAILUREFalha na autenticação entre serviços internos da Creditas

9.9. Erros de protocolo (sem code de negócio)

HTTPCorpoQuando ocorre
401vazioAuthorization ausente, malformado ou token expirado
403—Caller autenticado sem permissão para o recurso
404—Recurso inexistente ou pertencente a outro parceiro
406—Header Accept ausente ou diferente de application/vnd.creditas.v1+json
415—Content-Type diferente de application/json em requisição com body
400{ code, message, details[] }Validação de payload (Bean Validation) — details lista os campos