Orientações e respostas da equipe da Direct Data

/api/CadastroImoveisRurais

💡 O endpoint /api/CadastroImoveisRurais permite consultar informações detalhadas sobre imóveis rurais registrados no Cadastro de Imóveis Rurais (CAFIR), administrado pela Receita Federal do Brasil. Este serviço oferece dados sobre o imóvel, seus titulares, condôminos ou compossuidores, além de informações cadastrais detalhadas.

Introdução

A API CAFIR - Cadastros de Imóveis Rurais oferece informações completas sobre imóveis rurais no Brasil, incluindo:

• Dados cadastrais do imóvel e titular;
• Localização e área do imóvel;
• Situação cadastral e histórico de registros.

Essa API é ideal para prevenção de autuações fiscais, análise de risco/crédito e compliance/ESG.

URL Base

A API está hospedada no seguinte endereço:

https://apiv3.directd.com.br

Endpoint

GET /api/CadastroImoveisRurais

Esse endpoint retorna informações detalhadas sobre imóveis rurais registrados no CAFIR.

Regras

1. Apenas um número de Cadastro Imobiliário Brasileiro (CIB) deve ser enviado por requisição.
2. É possível incluir a geração de um comprovante PDF por um custo adicional.

Autenticação

A autenticação é feita utilizando um TOKEN. Sem um token válido, o acesso será negado (401).

Regras de Autenticação

1. O TOKEN deve ser incluído como parâmetro obrigatório.
2. Caso o token seja inválido ou expirado, entre em contato pelo e-mail: suporte@directd.com.br.

Campos da API

Dados Retornados

• CIB: Cadastro Imobiliário Brasileiro.
• Nome do Imóvel: Nome registrado do imóvel.
• Área: Tamanho total do imóvel.
• Localização: Endereço ou descrição da localização.
• CEP: Código de Endereçamento Postal.
• Município: Localidade do imóvel.
• UF: Unidade Federativa onde o imóvel está localizado.
• Data de Emissão: Data de emissão do registro.
• Situação: Status cadastral do imóvel.
• Cadeia de CIB: Histórico de registros associados ao imóvel.
• Código do INCRA: Código do imóvel no INCRA.
• Data da Consulta: Data em que a consulta foi realizada.

Parâmetros

Exemplo de Requisição

Usando cURL

curl -X 'GET' \
  'https://apiv3.directd.com.br/api/CadastroImoveisRurais?CIB=123456789&TOKEN=68ADA2C3-8016-47DA-ADE6-13AE239308FE&GERARCOMPROVANTE=habilitar' \
  -H 'accept: application/json'

Respostas

Sucesso (200)

A consulta foi realizada com sucesso e retorna os dados do imóvel cadastrado.

Exemplo de Resposta

{
  "metaDados": {
    "consultaNome": "CAFIR - Cadastros de Imóveis Rurais",
    "consultaUid": "direct-123456",
    "mensagem": "Consulta realizada com sucesso.",
    "resultado": "Sucesso",
    "apiVersao": "v3",
    "tempoExecucaoMs": 150,
    "gerarComprovante": true,
    "urlComprovante": "https://apiv3.directd.com.br/comprovantes/123456.pdf"
  },
  "retorno": {
    "cib": "123456789",
    "nomeImovel": "Fazenda Primavera",
    "area": "1000 hectares",
    "localizacao": "Rodovia BR-163, Km 58",
    "cep": "01000-000",
    "municipio": "Cuiabá",
    "uf": "MT",
    "dataEmissao": "01/01/2024",
    "situacao": "Ativo",
    "cadeiaCIB": "123456789 > 987654321",
    "codigoINCRA": "123456",
    "dataConsulta": "01/01/2024"
  }
}

Erros Comuns

Notas Importantes

• Apenas um documento (CPF ou CNPJ) deve ser enviado por consulta.
• O parâmetro GERARCOMPROVANTE é opcional e, se ativado, gera um PDF do comprovante.
• Para dúvidas ou suporte, entre em contato pelo e-mail: suporte@directd.com.br.