Vínculos do Imóvel Rural

Parâmetros

O que você recebe

34 campos no retorno, como o seu sistema recebe.

• imovel

  Dados do imóvel

  Bloco com área, módulos fiscais, município, UF, coordenadas e datas de inscrição e retificação. Número do CAR, nome, localização, área, situação e tipo do imóvel consultado.

• imovel.numeroCar

  Código CAR

  Número de inscrição do imóvel no Cadastro Ambiental Rural.

• imovel.nomeImovel

  Nome do imóvel

  Denominação do imóvel rural. Só aparece quando a base tem um nome confiável para o imóvel.

• imovel.uf

  UF

  Sigla do estado.

• imovel.municipio

  Município

  Nome do município.

• imovel.codigoMunicipioIbge

  Código IBGE do município

  Código do município na tabela do IBGE.

• imovel.centroide

  Centro do imóvel

  Ponto central do perímetro, como [longitude, latitude].

• imovel.areaHa

  Área do imóvel

  Área total do imóvel, em hectares.

• imovel.areaSuspeita

  Área suspeita

  Verdadeiro quando a área declarada no CAR passa de 200 mil hectares ou quando o polígono do próprio CAR desmente a área declarada. A área continua vindo como declarada: confira o imóvel antes de somá-la ao patrimônio. Não aparece quando o imóvel só é conhecido pelos vínculos (cadastradoNaBase falso).

• imovel.situacaoCar

  Situação do CAR

  Situação do cadastro no SICAR (ex.: Ativo, Pendente, Suspenso, Cancelado).

• imovel.condicao

  Condição da análise

  Etapa da análise do cadastro pelo órgão ambiental estadual.

• imovel.tipo

  Tipo do imóvel

  Tipo do cadastro no SICAR (imóvel rural, assentamento, território tradicional).

• imovel.modulosFiscais

  Módulos fiscais

  Tamanho do imóvel em módulos fiscais do município.

• imovel.cadastradoNaBase

  Cadastrado na base

  Verdadeiro quando o CAR consta na base cadastral; falso quando só a consulta pública o conhece. Falso quando o imóvel só é conhecido pelos vínculos: vêm apenas o número do CAR, a UF e o código do município.

• resumo

  Resumo dos vínculos

  Totais da consulta: quantos itens existem na base, quantos vieram, quantos são propriedade atual e quantos há em cada papel.

• resumo.totalPessoas

  Total de pessoas

  Quantidade de pessoas e empresas ligadas ao imóvel, inclusive as que passaram do limite da resposta.

• resumo.pessoasRetornadas

  Pessoas retornadas

  Quantidade de pessoas e empresas que vieram na resposta (até 200, das mais relevantes para as menos). Menor que totalPessoas só quando a lista passa de 200 pessoas.

• resumo.proprietariosAtuais

  Proprietários atuais

  Quantas das pessoas retornadas são proprietárias atuais do imóvel.

• resumo.porPapel

  Quantidade por papel

  Quantos itens há em cada papel de vínculo (titular, condomino, tomadorCredito, operadorLavoura, detentor, usoSigef, declaranteArea). Um item com dois papéis conta nos dois. Conta pessoas: uma pessoa com dois papéis no imóvel conta nos dois.

• pessoasDado pessoal

  Pessoas vinculadas

  Lista das pessoas e empresas ligadas ao imóvel, das mais relevantes para as menos: primeiro os proprietários atuais.

• pessoas[].documentoDado pessoal

  Documento

  CPF ou CNPJ da pessoa ou empresa ligada ao imóvel, formatado.

• pessoas[].tipoDocumento

  Tipo de documento

  Indica se o documento é CPF ou CNPJ.

• pessoas[].nomeDado pessoal

  Nome ou razão social

  Nome da pessoa ou razão social da empresa pesquisada. Não aparece quando a base só tem o nome com asteriscos; aí vem nomeParcial.

• pessoas[].nomeParcialDado pessoal

  Nome parcial

  Nome publicado com asteriscos pela origem, quando não há o nome completo. Vem no lugar do nome.

• pessoas[].proprietarioAtual

  Proprietário atual

  Verdadeiro quando a pessoa consta como titular do imóvel em registro ou cadastro oficial (SIGEF, SINTER, CCIR, SNCR ou CAFIR), inclusive como condômino com CPF confirmado. Órgão público titular não conta. Não é uma data de vínculo, e um imóvel pode ter mais de um.

• pessoas[].vinculos

  Vínculos

  Formas pelas quais a pessoa se liga ao imóvel, cada uma com papel, prova, força, fonte e score.

• pessoas[].vinculos[].papel

  Papel do vínculo

  Como a pessoa se liga ao imóvel: titular, condomino (condômino no SNCR, com a fração), tomadorCredito (crédito rural), operadorLavoura (seguro de lavoura), detentor, usoSigef (usufruto ou concessão) ou declaranteArea (declarou sobre a área sem ser o titular).

• pessoas[].vinculos[].prova

  Prova do vínculo

  Tipo de registro que sustenta o vínculo: registral, cadastral, publico (o titular é órgão público), declarado ou inferido; nos papéis que não são de propriedade, tomador, operador, detencao ou uso.

• pessoas[].vinculos[].forca

  Força do vínculo

  Solidez da ligação: forte, medio ou fraco; na quando não se aplica.

• pessoas[].vinculos[].fonte

  Fonte do vínculo

  Órgão ou sistema de origem da informação (ex.: CAFIR/RFB, SNCR/INCRA, SIGEF/INCRA, SICOR/BACEN).

• pessoas[].vinculos[].score

  Score do vínculo

  Nota de 0 a 1 da confiança na titularidade, quando a origem oferece; ausente nos demais papéis.

• pessoas[].vinculos[].percentual

  Fração do condômino

  Parte do imóvel que o condômino detém no quadro de titulares do SNCR/INCRA, em %. Só aparece no papel condomino.

• observacoes

  Avisos de leitura

  Textos fixos que explicam como ler o resultado, como o significado de propriedade atual. Não indicam erro.

• ressalvas

  Ressalvas

  Avisos sobre limites do resultado (ex.: camada indisponível nesta execução). Só aparece quando a lista é limitada a 200 pessoas.

Opções da chamada

• assincrono=trueProcessa em segundo plano e devolve 202 com o consultaId.
• comprovante=trueEsta API não emite comprovante em PDF.

Códigos de resposta

• 200Sucesso — Consulta concluída; o retorno traz os dados da fonte.
• 202Em processamento — Recupere em GET /api/Marketplace/Consulta/Resultado/{consultaId}. Recuperar não é cobrado.
• 422Requisição inválida — Parâmetros validados antes de qualquer cobrança.
• 429Limite simultâneo — Até 5 consultas simultâneas por cliente.
• 503Em manutenção — A consulta está temporariamente indisponível; nada é cobrado.