/api/CertidaoNegativaDebitosImovelRural

💡 O endpoint /api/CertidaoNegativaDebitosImovelRural permite 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

  1. O TOKEN deve ser enviado como parâmetro na URL da requisição.
  2. 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

NomeTipoObrigatórioDescrição
CIBstringSimCódigo de Identificação do Imóvel (CIB). Pode ser enviado com ou sem formatação.
TOKENstringSimToken de autenticação necessário para a consulta.
GERARCOMPROVANTEstringNãoIndica 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ódigoDescrição
400Requisição Inválida: Parâmetros incorretos.
401Não Autenticado: Credenciais incorretas.
403Não Autorizado: Saldo insuficiente.
404Não Encontrado: Recurso solicitado não existe.
408Tempo Esgotado: O servidor não conseguiu processar a requisição no prazo estabelecido.
500Erro Interno: Falha ao processar a requisição. Entre em contato com o suporte.
503Consulta 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.