Produtor

Permite a consulta de produtores rurais a partir de um CPF ou CNPJ, retornando informações relevantes sobre sua atividade agrícola.

Limitação de Dados: Para todos os endpoints que envolvem listas de safra e produtividade, apenas os dados dos últimos 3 anos serão retornados.

Endpoint: GET /v2/owner/{document}

Path parameters

document	string	OBRIGATÓRIO	CPF/CNPJ para busca

Tabelas de Campos da Resposta

A chave “data” retorna um objeto com informações detalhadas do proprietário:

Chave	Formato	Descrição
document	String	Número do documento do proprietário (CPF/CNPJ).
document_type	String	Tipo de documento (CPF ou CNPJ).
is_customer	Boolean	Indica se o proprietário é cliente.
owner	String	Nome do proprietário.
realty_count	Integer	Quantidade de propriedades vinculadas ao proprietário.
renda_presumida	Decimal	Renda presumida do proprietário.
seguro	Boolean	Indica se o proprietário possui seguro agrícola ativo.
inscricao_estadual	String	Número da inscrição estadual do proprietário.

A chave “data -> productivity” retorna uma lista com informações sobre a produtividade do proprietário:

Chave	Formato	Descrição
year	Integer	Ano da produtividade registrada.
culture	String	Cultura cultivada na propriedade.
produtividade_estimada	Decimal	Produtividade estimada para o ano e cultura informados.
producao_total_estimada	Decimal	Produção total estimada para o ano e cultura informados.
valor_commodity	Decimal	Valor da commodity correspondente à cultura.

A chave “data -> realty” retorna uma lista com as propriedades do proprietário:

Chave	Formato	Descrição
realty_id	String	Identificador único da propriedade (CAR).
sharecropper	Boolean	Indica se a propriedade possui mutuário.
realty_name	String	Nome da propriedade.
total_area	Decimal	Área total da propriedade (m²).
arable_area	Decimal	Área agricultável da propriedade (m²).
legal_reserve_area	Decimal	Área de reserva legal da propriedade (m²).
perennial_arable_area	Float	Área de cultivo perene (m²).
temporary_arable_area	Float	Área de cultivo temporário (m²).
lat	Float	Latitude da propriedade.
long	Float	Longitude da propriedade.
city_name	String	Nome da cidade onde está localizada a propriedade.
uf	String	Unidade da Federação (estado) da propriedade.

Tabela de Camadas - layer (Indicadores da propriedade)**

Chave	Formato	Descrição
avicultura_pr_numaves	Integer	Número de aves na propriedade.
bovinos_pr_quantity	Integer	Quantidade de bovinos na propriedade.
conab_silos_processed_capacity	Integer	Capacidade processada dos silos (CONAB).
deforestation_alerts_intersected_area	Float	Área de alertas de desmatamento interceptados.
irrigation_permit_annual_volume	Float	Volume anual permitido para irrigação (m³).
pivos_area	Float	Área irrigada por pivôs (m²).
pivos_mean_operational_cost	Float	Custo operacional médio dos pivôs.
suinocultura_pr_quantidadeanimais	Integer	Quantidade de suínos na propriedade.

Exemplo de retorno para a solicitação acima:

{
    "data": {
        "owner": {
            "document": "15633381904",
            "document_type": "CPF",
            "is_customer": true,
            "owner": "LUIZ CERVI",
            "realty_count": 2
        },
        "productivity": [
            {
                "culture": "milho",
                "year": "2022"
            },
            {
                "culture": "soja",
                "year": "2022"
            },
            {
                "culture": "agricultavel",
                "year": "2023"
            },
            {
                "culture": "feijao",
                "year": "2023"
            },
            {
                "culture": "milho",
                "year": "2023"
            },
            {
                "culture": "soja",
                "year": "2023"
            },
            {
                "culture": "trigo",
                "year": "2023"
            },
            {
                "culture": "soja",
                "year": "2024"
            }
        ],
        "realty": [
            {
                "arable_area": 11404.19748,
                "city_name": "Cascavel",
                "legal_reserve_area": 0,
                "lat": -25.00517,
		"lng": -53.562187,
                "perennial_arable_area": 0,
		"temporary_arable_area": 11404.19748,
                "realty_id": "PR-4104808-AC0D7F60B8FC46FBBB22A79B4DF2DF1A",
                "realty_name": "Área  de terras rural constituindo parte destacada do lote n 128-A-1, da Gleba Cascavel 2.",
                "sharecropper": false,
                "total_area": 22700.152950566477,
                "uf": "PR"
            },
            {
                "arable_area": 1455461.95595,
                "city_name": "Santa Tereza Do Oeste",
                "legal_reserve_area": 6902.880818771819,
                "realty_id": "PR-4124020-BAA33181E9DD4414A860818936CACD42",
                "realty_name": "Lotes de terras rurais n 122 da Gleba Central - 1 parte e Lote n 24-C-1, do Imóvel Fazenda Andrade.",
                "sharecropper": false,
                "total_area": 1796211.8143100243,
                "uf": "PR"
            },
            {
                "layer": {
                "avicultura_pr": {
		                "numaves": 0
                },
                "bovinos_pr_quantity": 2,
                "conab_silos_processed_capacity": 0,
                "deforestation_alerts_intersected_area": 0,
                "irrigation_permit_annual_volume": 0,
                "pivos_area": 0,
                "pivos_mean_operational_cost": 0,
                "suinocultura_pr_quantidadeanimais": 0,
				"outras atividades":
						"group": hortaliças,
							"product": tomate,
								"area": 30,
								"num_animals": null,
         }
        ]
    },
    "error": false,
    "message_id": "delivery_get_owner_successfull",
    "metadata": {}
}

Tabelas de Campos da Resposta#

Tabela de Camadas - layer (Indicadores da propriedade)**#

Tabelas de Campos da Resposta

Tabela de Camadas - layer (Indicadores da propriedade)**