O endpoint /api/CertidaoNegativaDebitos permite obter Certidões Negativas de Débitos estaduais, comprovando a inexistência de pendências fiscais associadas à entidade consultada.
CND - Certidão Negativa de Débitos
Emite Certidão Negativa de Débitos Estaduais na SEFAZ ou na Receita do Brasil, a depender do estado consultado, retornando, quando não existem débitos estaduais associados à entidade sendo consultada, uma certidão que comprova a não existência de débitos.
Casos de Uso
- Integração com CND - Certidão Negativa de Débitos
- Análise de crédito com histórico de protestos e pendências
- Compliance em licitações e contratações públicas
- Qualificação e monitoramento de fornecedores
Aplicações
- Prevenção de Autuações Fiscais
- Onboarding de Clientes e Fornecedores
- Análise de Risco/Crédito
- Compliance/ESG
Benefícios
- Documentação de CND - Certidão Negativa de Débitos acessível e atualizada
- Reduz inadimplência e penalidades
- Dados oficiais centralizados
- Facilita comprovação de conformidade
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/CertidaoNegativaDebitosEndpoint
GET https://apiv3.directd.com.br/api/CertidaoNegativaDebitos?Cpf={0}&Cnpj={1}&ie={2}&Uf={3}&Token=Seu_TokenDescrição: Endpoint para realizar consultas CND - Certidão Negativa de Débitos.
Nota: Esta consulta gera comprovantes em PDF.
Esta API suporta geração de comprovantes em PDF
Campos Retornados
- Código de Validação: Código de validação da certidão
- Data de Emissão: Data da emissão do certificado
- Documento Consultado: Documento consultado referente ao CPF/CNPJ
- Flag Débito: Informa se possui ou não débitos. True(verdadeiro) ou false(falso)
- Flag Efeito de Negativa: Informa se a certidão possui efeito de negativa. True(verdadeiro) ou false(falso)
- Inscrição Estadual: Inscrição estadual da entidade consultada
- Lista de Débito: Lista de débitos da entidade, caso possua
- Nome Entidade: Nome da entidade ou Razão Social consultada
- Número da Certidão: Número da certidão
- Razão Social: Razão social da empresa
- Status: Retorna detalhes sobre o status do registro em questão
- UF: Unidade Federativa (estado) referente ao registro
- Valida Até: Data de validade da certidão
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
UF | string | Sim | O(s) parâmetro(s) UF é(são) obrigatório(s) para esta consulta (AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS, MT, PA, PB, PE, PI, PR, RJ, RN, RO, RR, RS, SC, SE, SP, TO). |
IE | string | Sim | O parâmetro IE pode ser enviado com ou sem formatação. |
CNPJ | string | Sim | O parâmetro CNPJ pode ser enviado com ou sem formatação. |
CPF | string | Sim | O parâmetro CPF pode ser enviado com ou sem formatação. |
TOKEN | string | Sim | O parâmetro TOKEN é essencial para efetuar esta consulta. Em caso de dúvidas, por favor, entre em contato com: suporte@directd.com.br |
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"enviarCallback": false,
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"nomeEntidade": "string",
"documentoConsultado": "string",
"uf": "string",
"inscricaoEstadual": "string",
"dataEmissao": "string",
"dataValidade": "string",
"possuiDebito": true,
"debitos": [
"string"
],
"efeitoNegativa": true,
"numeroCertidao": "string",
"status": "string",
"codigoValidacao": "string",
"observacao": "string"
}
}Erros Comuns
| Código | Descrição |
|---|---|
400 | Requisição Inválida: a requisição está incorreta ou os parâmetros são inválidos. |
401 | Não Autenticado: o usuário não forneceu as credenciais corretas para acessar o recurso. |
403 | Não Autorizado: o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
404 | Não Encontrado: o servidor não encontrou uma representação atual do recurso solicitado. |
408 | Tempo Esgotado: o servidor não conseguiu retornar a requisição no prazo estabelecido. |
500 | Falha ao Realizar Consulta: o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
503 | Consulta em Manutenção: a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |
Notas Importantes
- Informe apenas um único documento por requisição
- Para obter o comprovante desta consulta, utiliza-se: '&GerarComprovante=habilitar' na URL
- Para utilizar a consulta de forma assíncrona, utiliza-se: '&async=habilitar' na URL
- Em caso de dúvidas/suporte, entre em contato pelo e-mail: suporte@directd.com.br ou pelo nosso WhatsApp: (11) 93906-9228