/api/CertidaoNegativaDebitosImovelRural
💡 O endpoint
/api/CertidaoNegativaDebitosImovelRuralpermite consultar Certidões Negativas de Débitos e Dívida Ativa da União (CNDIR) para imóveis rurais, comprovando a regularidade fiscal junto à Receita Federal e à Procuradoria Geral da Fazenda Nacional.
Introdução
A API CNDIR possibilita a emissão de certidões negativas de débito e dívida ativa da União relacionadas a imóveis rurais. É amplamente utilizada para regularização fiscal, compliance ambiental e tributário e análise de risco/crédito.
URL Base
A API está hospedada no seguinte endereço:
https://api.directd.com.br
Endpoint
GET /api/CertidaoNegativaDebitosImovelRural
Descrição: Endpoint para realizar consultas de Certidões Negativas de Débitos e Dívida Ativa da União para imóveis rurais.
Nota: É possível gerar comprovantes em PDF utilizando o parâmetro GERARCOMPROVANTE.
Autenticação
A autenticação é feita utilizando um TOKEN.
Regras de Autenticação
- O
TOKENdeve ser enviado como parâmetro na URL da requisição. - O
TOKENé obrigatório para realizar consultas.
Campos da API
Informações Gerais
- CIB: Código de Identificação do Imóvel (obrigatório).
- UF: Unidade federativa onde está localizado o imóvel.
- Nome do Imóvel: Nome registrado do imóvel rural.
- Contribuinte: Nome do contribuinte responsável pelo imóvel.
- CPF: Cadastro de Pessoa Física do contribuinte (opcional).
- Área Total: Área total do imóvel em hectares.
Detalhes da Certidão
- Data de Emissão: Data em que a certidão foi emitida.
- Data de Validade: Data de validade da certidão.
- Flag Débito: Indica se há débitos pendentes relacionados ao imóvel.
- Flag Efeito de Negativa: Indica se a certidão possui efeito de negativa.
- Lista de Débitos: Detalhamento de possíveis débitos associados.
- Código de Controle da Certidão: Código único que valida a certidão emitida.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| CIB | string | Sim | Código de Identificação do Imóvel (CIB). Pode ser enviado com ou sem formatação. |
| TOKEN | string | Sim | Token de autenticação necessário para a consulta. |
| GERARCOMPROVANTE | string | Não | Indica se a consulta deve gerar um comprovante em PDF. |
Exemplo de Requisição
Usando cURL
curl 'https://api.directd.com.br/api/CertidaoNegativaDebitosImovelRural?CIB=12345678&TOKEN=seu_token_aqui&GERARCOMPROVANTE=true'
Respostas
Sucesso (200)
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "CNDIR - Certidão Negativa de Débitos e Dívida Ativa da União de Imóvel Rural",
"consultaUid": "cndir-123456",
"usuario": "Joana",
"mensagem": "Sucesso",
"apiVersao": "v3",
"tempoExecucaoMs": 1300,
"gerarComprovante": true,
"urlComprovante": "https://api.directd.com.br/comprovantes/certidao456.pdf"
},
"retorno": {
"nomeImovel": "Sítio Exemplo",
"cib": "12345678",
"municipio": "Cidade Exemplo",
"uf": "SP",
"contribuinte": "João da Silva",
"cpf": "123.456.789-09",
"areaTotal": "100 hectares",
"dataEmissao": "01/12/2024",
"dataValidade": "31/12/2024",
"possuiDebito": false,
"efeitoNegativa": true,
"debitos": [],
"status": "Regular",
"codigoControleCertidao": "CNDIR-2024-98765"
}
}
Erros Comuns
| Código | Descrição |
|---|---|
| 400 | Requisição Inválida: Parâmetros incorretos. |
| 401 | Não Autenticado: Credenciais incorretas. |
| 403 | Não Autorizado: Saldo insuficiente. |
| 404 | Não Encontrado: Recurso solicitado não existe. |
| 408 | Tempo Esgotado: O servidor não conseguiu processar a requisição no prazo estabelecido. |
| 500 | Erro Interno: Falha ao processar a requisição. Entre em contato com o suporte. |
| 503 | Consulta em Manutenção: O recurso solicitado está temporariamente indisponível. |
Notas Importantes
- Certifique-se de fornecer o código de identificação do imóvel (CIB) para realizar a consulta.
- O token de autenticação é obrigatório para todas as consultas.
- Para dúvidas ou suporte, entre em contato pelo e-mail: suporte@directd.com.br.