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.