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.

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

CDDA001

Algum campo obrigatório não foi enviado

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.

400

CDDA100

Campos [clientName] e [document] inválidos

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.

400

CDDA100

Campo [clientName] inválido

Esse erro mostra que o nome do usuário está sendo enviado como vazio (ex: clientName: " "). Verifique o campo clientName que está sendo enviado.

400

CDDA100

Campo [document] inválido

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.

400

CDDA100

Campo [document] inválido

Documento com algum problema para ser registrado, tente novamente mais tarde. Se o erro persistir deverá contatar o suporte para verificar a anomalia.

400

CDDA101

Já existe uma solicitação de cadastro pendente para esse documento

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.

400

CDDA102

Usuário já cadastrado

O documento informado já foi cadastrado no DDA, ou seja, o status desse registro é CREATED. Informe um novo documento.

400

CDDA200

Não é possível realizar o cadastro desse documento neste momento. Tente novamente mais tarde

Ocorreu uma falha na comunicação. Entre em contato com o suporte.

400

CDDA103

Não é possível realizar cancelamento de cadastro em processamento

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.

400

CDDA104

Não é possível realizar o cancelamento deste documento

O documento informado não existe, ou seja, não foi cadastrado. Informe um novo documento ou verifique o dado que está sendo enviado.

500

CDDA999

Ocorreu um erro inesperado

Erro inesperado. Entre em contato com o suporte para verificar a anomalia.

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.

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

CDDA002

Algum campo necessário para o envio do webhook não foi fornecido

Erro retornado caso os campos typeEventWebhook e url não sejam enviados. Verifique esses campos e tente novamente.

400

CDDA003

Algum campo necessário para autenticação não foi fornecido

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.

400

CDDA105

Selecione um tipo de evento [Subscription, Deletion, Invoice]

Esse erro retorna quando não é informado nenhum evento no campo typeEventWebhook. (Ex: typeEventWebhook: " ")
Verifique o dado enviado e tente novamente.

400

CDDA115

Só é possível cadastrar um evento por vez

Retornado quando mais de um evento é informado no campo (Ex: typeEventWebhook: "Deletion, Invoice "). Use uma requisição para cada configuração de evento.

400

CDDA106

Escolha apenas um tipo de autenticação

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.

400

CDDA100

Campo [{campo}] inválido

Retornado quando o valor informado no campo não é correspondente. (Ex: typeEventWebhook: "Delete" ou typeEventWebhook: "1"). Só é possível cadastrar: Deletion, Subscription ou Invoice.

400

CDDA100

Campo [Url] inválido

Retornado quando o valor informado no campo não é correspondente. (Ex: url: " " ou url: "aa"). Verifique o dado enviado e tente novamente.

400

CDDA100

Campo [identification] inválido

Retornado quando nenhum dado é informado nesse campo (Ex: identification: " "). Verifique o campo e tente novamente.

400

CDDA100

Campo [password] inválido

Retornado quando nenhum dado é informado nesse campo (Ex: password: " "). Verifique o campo e tente novamente.

400

CDDA100

Campo [endpoint] inválido

Retornado quando nenhum dado é informado nesse campo (Ex: endpoint: " "). Verifique o campo e tente novamente.

400

CDDA100

Campo [grantType] inválido

Retornado quando nenhum dado é informado nesse campo (Ex: grandType: " "). Verifique o campo e tente novamente.

400

CDDA100

Campo [clientId] inválido

Retornado quando nenhum dado é informado nesse campo (Ex: clientId: " "). Verifique o campo e tente novamente.

400

CDDA100

Campo [clientSecret] inválido

Retornado quando nenhum dado é informado nesse campo (Ex: clientSecret: " "). Verifique o campo e tente novamente.

500

CDDA999

Ocorreu um erro inesperado

Erro inesperado. Entre em contato com o suporte para verificar a anomalia.