Tabela de erros
As tabelas abaixo apresentam os possíveis erros que podem ser retornados nas APIs do fluxo de DDA.
Tabela de erros da API de Subscrição: registro e exclusão
Tentativa de registrar ou excluir um usuário no DDA.
<th style={{ textAlign: "left" }}>
Código de erro
</th>
<th style={{ textAlign: "left" }}>
Mensagem de erro
</th>
<th style={{ textAlign: "left" }}>
Resolução
</th>
</tr>
<td style={{ textAlign: "left" }}>
CDDA301
</td>
<td style={{ textAlign: "left" }}>
Requisição não autorizada
</td>
<td style={{ textAlign: "left" }}>
Produto não está ativo na conta ou as chaves de autenticação estão incorretas. Verifique a autenticação ou entre em contato com o suporte.
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
403
</td>
<td style={{ textAlign: "left" }}>
CDDA302
</td>
<td style={{ textAlign: "left" }}>
Cliente não autorizado para o produto
</td>
<td style={{ textAlign: "left" }}>
Produto não ativo na conta. Entre em contato com o comercial ou com o suporte.
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
400
</td>
<td style={{ textAlign: "left" }}>
CDDA001
</td>
<td style={{ textAlign: "left" }}>
Algum campo obrigatório não foi enviado
</td>
<td style={{ textAlign: "left" }}>
Para registrar usuários é obrigatório o envio do document (CPF ou CNPJ) e o clienteName (nome do cliente).\
Para a exclusão, o document (CPF ou CNPJ) é campo obrigatório.\
Se retornar esse erro, confira se esses dados estão sendo enviados.
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
400
</td>
<td style={{ textAlign: "left" }}>
CDDA100
</td>
<td style={{ textAlign: "left" }}>
Campos [clientName] e [document] inválidos
</td>
<td style={{ textAlign: "left" }}>
Nome e documento inválidos, significa que o campo está sendo enviado vazio (ex: clientName: " "), ou está enviando tipos incorretos (ex: document: "abcd"), ou número de dígitos incorretos (ex: document: "123") e etc. Verifique o dado que está sendo enviado em ambos os campos.
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
400
</td>
<td style={{ textAlign: "left" }}>
CDDA100
</td>
<td style={{ textAlign: "left" }}>
Campo [clientName] inválido
</td>
<td style={{ textAlign: "left" }}>
Esse erro mostra que o nome do usuário está sendo enviado como vazio (ex: clientName: " "). Verifique o campo clientName que está sendo enviado.
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
400
</td>
<td style={{ textAlign: "left" }}>
CDDA100
</td>
<td style={{ textAlign: "left" }}>
Campo [document] inválido
</td>
<td style={{ textAlign: "left" }}>
Esse erro mostra que o documento do usuário está sendo enviado como vazio, ou possui letras e outros caracteres especiais, ou com dígitos a mais ou a menos. Verifique o dado que está sendo enviado no campo de document.
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
400
</td>
<td style={{ textAlign: "left" }}>
CDDA100
</td>
<td style={{ textAlign: "left" }}>
Campo [document] inválido
</td>
<td style={{ textAlign: "left" }}>
Documento com algum problema para ser registrado, tente novamente mais tarde. Se o erro persistir deverá contatar o suporte para verificar a anomalia.
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
400
</td>
<td style={{ textAlign: "left" }}>
CDDA101
</td>
<td style={{ textAlign: "left" }}>
Já existe uma solicitação de cadastro pendente para esse documento
</td>
<td style={{ textAlign: "left" }}>
O documento enviado na solicitação de registro já foi enviado antes e a solicitação anterior está sendo processada, ou seja, está com status PROCESSING. Altere o documento ou aguarde o webhook de retorno da primeira solicitação.
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
400
</td>
<td style={{ textAlign: "left" }}>
CDDA102
</td>
<td style={{ textAlign: "left" }}>
Usuário já cadastrado
</td>
<td style={{ textAlign: "left" }}>
O documento informado já foi cadastrado no DDA, ou seja, o status desse registro é CREATED. Informe um novo documento.
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
400
</td>
<td style={{ textAlign: "left" }}>
CDDA200
</td>
<td style={{ textAlign: "left" }}>
Não é possível realizar o cadastro desse documento neste momento. Tente novamente mais tarde
</td>
<td style={{ textAlign: "left" }}>
Ocorreu uma falha na comunicação. Entre em contato com o suporte.
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
400
</td>
<td style={{ textAlign: "left" }}>
CDDA103
</td>
<td style={{ textAlign: "left" }}>
Não é possível realizar cancelamento de cadastro em processamento
</td>
<td style={{ textAlign: "left" }}>
O documento informado na solicitação de exclusão ainda não finalizou o processo de registro, ou seja, esse documento está com status PROCESSING e para exclusão é necessário que ele possua status CREATED. Informe um novo documento ou aguarde retorno do registro de sucesso para excluir o usuário.
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
400
</td>
<td style={{ textAlign: "left" }}>
CDDA104
</td>
<td style={{ textAlign: "left" }}>
Não é possível realizar o cancelamento deste documento
</td>
<td style={{ textAlign: "left" }}>
O documento informado não existe, ou seja, não foi cadastrado. Informe um novo documento ou verifique o dado que está sendo enviado.
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
500
</td>
<td style={{ textAlign: "left" }}>
CDDA999
</td>
<td style={{ textAlign: "left" }}>
Ocorreu um erro inesperado
</td>
<td style={{ textAlign: "left" }}>
Erro inesperado. Entre em contato com o suporte para verificar a anomalia.
</td>
</tr>
| HTTP code |
|---|
| 401 |
Tabela de erros da API de Boletos
Tentativa de geração de boletos.
| HTTP code | Código de erro | Mensagem de erro | Resolução |
|---|---|---|---|
| 401 | CDDA301 | Requisição não autorizada | Produto não está ativo na conta ou as chaves de autenticação estão incorretas. Verifique a autenticação ou entre em contato com o suporte. |
| 403 | CDDA302 | Cliente não autorizado para o produto | Produto não ativo na conta. Entre em contato com o comercial ou com o suporte. |
| 400 | CDDA004 | O campo [document] não foi enviado | Esse erro é retornado se o campo não for enviado na requisição (ex: { }). É obrigatório o envio do campo document. |
| 400 | CDDA115 | A requisição possui um limite de até 20 documentos | Esse erro é retornado caso seja enviado mais de 20 documentos na requisição. Retire o excesso de documentos enviados e realizado uma requisição para cada 20 documentos. |
| 400 | CDDA116 | A requisição precisa possuir ao menos um documento | O campo é obrigatório e deve ser enviado pelo menos 1 documento válido. Esse erro é retornado caso seja enviado o campo assim: { "document": [ ] }. Verifique o dado enviado. |
| 400 | CDDA117 | Cada documento deve conter somente números | Esse erro é retornado quando o dado enviado possui letras ou símbolos, ou quando não é enviado (ex: {"document": ["121312asfdf"]} ou {"document": [" "]}). Verifique o campo document e envie dígitos numéricos. |
| 400 | CDDA118 | O CPF deve conter 11 caracteres numéricos e o CNPJ deve conter 14 caracteres numéricos | Retornado quando é enviado mais de 11 dígitos para CPF ou 14 dígitos para CNPJ. Ou quando é enviado dígitos aleatórios que não são um CPF/CNPJ (ex: {"document": ["12345678911"]}). Verifique os dados enviados no campo document e tente novamente. |
| 500 | CDDA999 | Ocorreu um erro inesperado | Erro inesperado. Entre em contato com o suporte para verificar a anomalia. |
Tabela de erros da API de Webhooks
Tentativa de configurar webhooks para receber notificações do DDA.
<th>
Código de erro
</th>
<th>
Mensagem de erro
</th>
<th>
Resolução
</th>
</tr>
<td>
CDDA301
</td>
<td>
Requisição não autorizada
</td>
<td>
Produto não está ativo na conta ou as chaves de autenticação estão incorretas. Verifique a autenticação ou entre em contato com o suporte.
</td>
</tr>
<tr>
<td>
403
</td>
<td>
CDDA302
</td>
<td>
Cliente não autorizado para o produto
</td>
<td>
Produto não ativo na conta. Entre em contato com o comercial ou com o suporte.
</td>
</tr>
<tr>
<td>
400
</td>
<td>
CDDA002
</td>
<td>
Algum campo necessário para o envio do webhook não foi fornecido
</td>
<td>
Erro retornado caso os campos typeEventWebhook e url não sejam enviados. Verifique esses campos e tente novamente.
</td>
</tr>
<tr>
<td>
400
</td>
<td>
CDDA003
</td>
<td>
Algum campo necessário para autenticação não foi fornecido
</td>
<td>
Para a autenticação basicAuthentication é obrigatório o envio dos campos: identification e password. Para a autenticação oAuthTwo é obrigatório o envio dos campos: endpoint, grantType, clientId e clientSecret. Esse erro é retornado caso algum dos campos mencionados não esteja sendo enviado, verifique a requisição e tente novamente.
</td>
</tr>
<tr>
<td>
400
</td>
<td>
CDDA105
</td>
<td>
Selecione um tipo de evento [Subscription, Deletion, Invoice]
</td>
<td>
Esse erro retorna quando não é informado nenhum evento no campo typeEventWebhook. (Ex: typeEventWebhook: " ")\
Verifique o dado enviado e tente novamente.
</td>
</tr>
<tr>
<td>
400
</td>
<td>
CDDA115
</td>
<td>
Só é possível cadastrar um evento por vez
</td>
<td>
Retornado quando mais de um evento é informado no campo (Ex: typeEventWebhook: "Deletion, Invoice "). Use uma requisição para cada configuração de evento.
</td>
</tr>
<tr>
<td>
400
</td>
<td>
CDDA106
</td>
<td>
Escolha apenas um tipo de autenticação
</td>
<td>
Só é possível utilizar uma autenticação por vez, basicAuthentication **ou** oAuthTwo. Verifique se ambas as autenticações estão sendo enviadas na mesma requisição.
</td>
</tr>
<tr>
<td>
400
</td>
<td>
CDDA100
</td>
<td>
Campo [{campo}] inválido
</td>
<td>
Retornado quando o valor informado no campo não é correspondente. (Ex: typeEventWebhook: "Delete" ou typeEventWebhook: "1"). Só é possível cadastrar: Deletion, Subscription ou Invoice.
</td>
</tr>
<tr>
<td>
400
</td>
<td>
CDDA100
</td>
<td>
Campo [Url] inválido
</td>
<td>
Retornado quando o valor informado no campo não é correspondente. (Ex: url: " " ou url: "aa"). Verifique o dado enviado e tente novamente.
</td>
</tr>
<tr>
<td>
400
</td>
<td>
CDDA100
</td>
<td>
Campo [identification] inválido
</td>
<td>
Retornado quando nenhum dado é informado nesse campo (Ex: identification: " "). Verifique o campo e tente novamente.
</td>
</tr>
<tr>
<td>
400
</td>
<td>
CDDA100
</td>
<td>
Campo [password] inválido
</td>
<td>
Retornado quando nenhum dado é informado nesse campo (Ex: password: " "). Verifique o campo e tente novamente.
</td>
</tr>
<tr>
<td>
400
</td>
<td>
CDDA100
</td>
<td>
Campo [endpoint] inválido
</td>
<td>
Retornado quando nenhum dado é informado nesse campo (Ex: endpoint: " "). Verifique o campo e tente novamente.
</td>
</tr>
<tr>
<td>
400
</td>
<td>
CDDA100
</td>
<td>
Campo [grantType] inválido
</td>
<td>
Retornado quando nenhum dado é informado nesse campo (Ex: grandType: " "). Verifique o campo e tente novamente.
</td>
</tr>
<tr>
<td>
400
</td>
<td>
CDDA100
</td>
<td>
Campo [clientId] inválido
</td>
<td>
Retornado quando nenhum dado é informado nesse campo (Ex: clientId: " "). Verifique o campo e tente novamente.
</td>
</tr>
<tr>
<td>
400
</td>
<td>
CDDA100
</td>
<td>
Campo [clientSecret] inválido
</td>
<td>
Retornado quando nenhum dado é informado nesse campo (Ex: clientSecret: " "). Verifique o campo e tente novamente.
</td>
</tr>
<tr>
<td>
500
</td>
<td>
CDDA999
</td>
<td>
Ocorreu um erro inesperado
</td>
<td>
Erro inesperado. Entre em contato com o suporte para verificar a anomalia.
</td>
</tr>
| HTTP code |
|---|
| 401 |
Updated 6 days ago