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 codeCódigo de erroMensagem de erroResolução
401CDDA301Requisição não autorizadaProduto 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.
403CDDA302Cliente não autorizado para o produtoProduto não ativo na conta. Entre em contato com o comercial ou com o suporte.
400CDDA004O campo [document] não foi enviadoEsse erro é retornado se o campo não for enviado na requisição (ex: { }). É obrigatório o envio do campo document.
400CDDA115A requisição possui um limite de até 20 documentosEsse 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.
400CDDA116A requisição precisa possuir ao menos um documentoO 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.
400CDDA117Cada documento deve conter somente númerosEsse 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.
400CDDA118O CPF deve conter 11 caracteres numéricos e o CNPJ deve conter 14 caracteres numéricosRetornado 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.
500CDDA999Ocorreu um erro inesperadoErro 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