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
compliance	Object	Informações de compliance do produtor
layer	Array [Object]	Lista de informações de negócio do cliente (silos, pivôs, outorgas, bovinocultura, suínocultura, avicultura).
other_activities	Array [Object]	Lista de informações de outras atividades do produtor
owner	Object	Informações gerais do produtor
productivity	Array [Object]	Lista de informações de produtividade do produtor
realty	Array [Object]	Lista de informações de propriedades do produtor

Tabela de Impedimento Socioambiental

A chave “data -> compliance” retorna informações de impedimentos sociambientais do produtor.

Chave	Formato	Descrição
criteria	Array [Object]	Lista de impedimentos Socioambientais
owner_status	string	Identifica o status socioambiental do produtor

A chave “data -> compliance -> criteria ” retorna uma lista de informações de impedimentos sociambientais do produtor.

Chave	Formato	Descrição
compliance	string	identifica o Critério Socioambiental
last_registy	string	Identifica se possui registro
status_compliance	string	Identifica o status critério

Tabela de Camadas

A chave “data -> layer ” retorna uma lista de informações de negócio do cliente (silos, pivôs, outorgas, bovinocultura, suínocultura, avicultura)

Chave	Formato	Descrição
avicultura_numaves	Integer	Número de aves na propriedade.
bovinos_quantity	Integer	Quantidade de bovinos na propriedade.
pivos_area	Float	Área irrigada por pivôs (m²).
pivos_mean_operational_cost	Float	Custo operacional médio dos pivôs.
realty_id	String	Identificador da propriedade (CAR).
silos_capacity	Integer	Capacidade processada dos silos.
deforestation_alerts_intersected_area	Float	Área de alertas de desmatamento interceptados.
irrigation_permit_annual_volume	Float	Volume anual permitido para irrigação (m³).
suinocultura_quantidadeanimais	Integer	Quantidade de suínos na propriedade.

Tabela de Outras Atividades

A chave “data -> other_activities ” retorna uma lista de informações de outras atividades do produtor.

Chave	Formato	Descrição
cost	Float	Custo da atividade agropecuaria.
group	String	Identifica o grupo da atividade.
income	Float	Receita total gerada.
product	String	Cultura ou animais relacionados ao produtor.
quantity	Float	Quantidade de animais ou area plantada(com base na atividade).
result	Float	Resultado total da atividade.
year	Float	Ano da atividade.

Tabela de Produtor

A chave “data -> owner” retorna informações sobre o produtor:

Chave	Formato	Descrição
avm	Float	Estimativa do valor das propriedades do produtor
cad_pro	Array [Object]	Lista dos registros vinculados ao produtor.
caf	Array [Object]	Lista dos registros vinculados ao produtor.
document	String	Documento do produtor.
document_type	String	Tipo de documento (CPF ou CNPJ).
email	Array [String]	Emails do produtor.
financial_summary	Object	Resumo Financeiro do proprietário.
is_customer	Boolean	Indica se o produtor é cliente.
owner	String	Nome do produtor.
owner_count	Integer	Soma das propriedades que o produtor está como proprietário.
phone	Array [String]	Números de telefone do proprietário.
realty_count	Integer	Quantidade de propriedades vinculadas ao produtor.
rural_insurance	Boolean	Indica se o produtor possui seguro agrícola ativo.
sharecropper_count	Integer	Soma das propriedades que o produtor está como mutuário.
state_registration	String	Número da inscrição estadual do proprietário.
technified_indicator	String	Indicador de tecnificação do produtor (bronze, prata ou ouro)

A chave “data -> owner -> cad_pro ” retorna informações sobre registros CAD PRO do produtor:

Chave	Formato	Descrição
activation_date	String	Data de ativação do CAD PRO
city_name	String	Nome do município
name	String	Nome do produtor
situation	String	Situação cadastral
state_registration	String	Inscrição estadual
status	String	Status do CAD PRO
uf	String	Estado

A chave “data -> owner -> caf ” retorna informações sobre registros de CAF do produtor:

Chave	Formato	Descrição
activation_date	String	Data de ativação do CAF
city_name	String	Nome do município
name	String	Nome do produtor
situation	String	Situação cadastral
state_registration	String	Inscrição estadual
status	String	Status do CAF
uf	String	Estado

A chave “data -> owner -> financial_summary ” retorna informações sobre o produtor:

Chave	Formato	Descrição
active	Boolean	Indica se o contrato está ativo ou inativo.
borrowers_quantity	Integer	Quantidade de tomadores do empréstimo.
debtor_amount	Float	Valor do débito.
due_date	String	Data de vencimento.
emission_date	String	Data de emissão.
institution_name	String	Nome da instituição.
interest	Float	Valor da taxa.
product	String	Para qual produto foi realizado o crédito.
purpose	String	Propósito do crédito.

Tabela de Produtividade

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

Chave	Formato	Descrição
culture	String	Cultura cultivada na propriedade.
financial	Object	Informações financeiras de produtividade.
production	Decimal	Produção estimada em toneladas.
productivity	Decimal	Produtividade estimada kg/ha.
realty_id	Integer	Identificador único da propriedade (CAR).
year	Integer	Ano da produtividade registrada.

A chave “data -> productivity -> financial” retorna informações financeiras sobre a produtividade

Chave	Formato	Descrição
cost	Decimal	Custo da produtividade.
income	Decimal	Receita da produtividade.
result	Decimal	Resultado operacional da produtividade.

Tabela de Propriedades

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

Chave	Formato	Descrição
agricultural_aptitude	Array [Object]	Aptidão agrícola da propriedade.
altitude	Object	Altitude da propriedade.
arable_area	Decimal	Área agricultável da propriedade (m²).
avm	Decimal	Estimativa do valor da propriedade.
biome	Array [String]	Bioma da propriedade.
city_name	String	Nome da cidade onde está localizada a propriedade.
climate	Array [Object]	Clima da propriedade.
compliance	Object	Impedimentos socioambientais da propriedade (Se tiver).
declivity	Object	Declividade da propriedade.
harvest	Array [Object]	Informações de safra e culturas da propriedade.
deforestation_polygons	Object	Impedimentos socioambientais da propriedade (Se tiver).
kml	String (XML)	URL do arquivo KML da propriedade.
lat	Float	Latitude da propriedade.
legal_reserve_area	Decimal	Área de reserva legal da propriedade (m²).
long	Float	Longitude da propriedade.
main_culture	Object	Indica a principal cultura e sua area plantada.
owner	String	Nome do produtor.
perennial_arable_area	Decimal	Área de cultivo perene (m²).
realty_id	String	Identificador único da propriedade (CAR).
realty_name	String	Nome da propriedade.
registry	Object	Matrícula da propriedade.
sharecropper	Boolean	Indica se a propriedade possui mutuário.
temporary_arable_area	Float	Área de cultivo temporário (m²).
total_area	Decimal	Área total da propriedade (m²).
uf	String	Unidade da Federação (estado) da propriedade.

A chave “data -> realty -> agricultural_aptitude” retorna uma lista de informações de aptidão agrícola da propriedade:

Chave	Formato	Descrição
legend_ap	String	Descrição da aptidão agrícola
simb_apt	String	Símbolo/código da aptidão agrícola

A chave “data -> realty -> altitude” retorna informações de altitude da propriedade:

Chave	Formato	Descrição
max	Float	Altitude máxima (m)
mean	Float	Altitude média (m)
min	Float	Altitude mínima (m)

A chave “data -> realty -> climate” retorna informações de clima da propriedade

Chave	Formato	Descrição
class	String	Código da classificação climática
description	String	Descrição do tipo de clima

A chave “data -> realty -> declivity” retorna informações sobre a declividade da propreidade:

Chave	Formato	Descrição
flat	Float	Percentual de área plana.
mountainous	Float	Percentual de área montanhosa
soft_wavy	Float	Percentual de área suavemente ondulada
steep	Float	Percentual de área íngreme
strong_wavy	Float	Percentual de área fortemente ondulada
wavy	Float	Percentual de área ondulada

A chave “data -> realty -> harvest” retorna informações de culturas da propriedade:

Chave	Formato	Descrição
area	Decimal	Área agricultável da cultura da propriedade (m²).
culture	String	Nome da cultura plantada.
harvest	String	Safra da cultura plantada.

A chave “data -> realty -> main_culture” retorna informações da principal cultura da propriedade:

Chave	Formato	Descrição
area	Decimal	Área agricultável da cultura da propriedade (m²).
culture	String	Nome da cultura plantada.

A chave “data -> realty -> registry” retorna informações de matrícula da propriedade:

Chave	Formato	Descrição
book	String	Número do livro de registro.
city	String	Cidade onde foi registrado.
number	String	Número do registro.
page	String	Página do livro de registro.
uf	String	Estado onde foi registrado.

Exemplo de retorno para a solicitação acima:

{
    "data": {
        "compliance": {
            "criteria": [
                {
                    "compliance": "ibama",
                    "last_registry": null,
                    "status_compliance": null
                },
                {
                    "compliance": "trabalho_escravo",
                    "last_registry": null,
                    "status_compliance": null
                }
            ],
            "owner_status": false
        },
        "layer": [
            {
                "deforestation_alerts_intersected_area": 0,
                "pivos_area": 0,
                "pivos_mean_operational_cost": 0,
                "realty_id": "PR-41XXXXX-3XXXXXXXXXXXXXXXXXXXXXXXXXXX",
                "silos_capacity": 0
            }
        ],
        "other_activities": [
            {
                "cost": 325280.1984,
                "group": "Grãos",
                "income": 642845.714,
                "product": "Soja",
                "quantity": 621200.0,
                "result": 317565.5156,
                "year": 2022
            }
        ],
        "owner": {
            "document": "003000000000",
            "document_type": "CPF",
            "email": [
                "teste@eemovelagro.com.br",
            ],
            "financial_summary": {
                "commitments": [
                    {
                        "active": false,
                        "borrowers_quantity": 1,
                        "debtor_amount": 419546.56,
                        "due_date": "2025-03-17",
                        "emission_date": "2017-03-13",
                        "institution_name": "Banco",
                        "interest": 8.5,
                        "product": "MÁQUINAS E IMPLEMENTOS",
                        "purpose": "Investimento"
                    }
                ],
                "final_result": 714246.51925,
                "total_commitments": 3197673.2,
                "total_cost": 9741667.02222,
                "total_income": 13653586.74147,
                "total_result": 3911919.71925
            },
            "is_customer": true,
            "owner": "Nome Teste",
            "phone": [
                "45999999999",
            ],
            "realty_count": 1,
            "rural_insurance": true,
            "state_registration": "9519999999"
        },
        "productivity": [
            {
                "culture": "soja",
                "financial": {
                    "cost": 687077.0963439571,
                    "income": 1561539.2677271757,
                    "result": 874462.1713832186
                },
                "production": 497.1894406348334,
                "productivity": 3288,
                "realty_id": "PR-41XXXXX-3XXXXXXXXXXXXXXXXXXXXXXXXXXX",
                "year": "2023"
            },
        ],
        "realty": [
            {
                "arable_area": 1565044.86824,
                "city_name": "Cidade",
                "kml": "<kml xmlns=\"http://www.opengis.net/kml/2.2\"><Document><Placemark><name>Realty PR-4104808-3614572217624AB68933EE5BD9012016</name><MultiGeometry><Polygon><outerBoundaryIs><LinearRing><coordinates>-53.45460084999999,-24.85315261 -53.45460084999999,-24.85315261 -53.4532325,-24.86988804999999 -53.45793781999999,-24.870731479999996 -53.4579388,-24.870612730000005 -53.45795988,-24.870336370000008 -53.457993099999996,-24.870093020000013 -24.848417359999992 -53.45437654,-24.849400090000007 -53.45342236999999,-24.850104770000012 -53.45460084999999,-24.85315261</coordinates></LinearRing></outerBoundaryIs></Polygon></MultiGeometry></Placemark></Document></kml>",
                "lat": -24.00000,
                "legal_reserve_area": 3549.5529992318347,
                "long": -53.00000,
                "main_culture": {
                    "area": 1338135.7562858225,
                    "culture": "trigo"
                },
                "owner": "Nome Teste",
                "perennial_arable_area": 0,
                "realty_id": "PR-41XXXXX-3XXXXXXXXXXXXXXXXXXXXXXXXXXX",
                "realty_name": "FAZENDA",
                "registry": {
                    "book": "2",
                    "city": "Cidade",
                    "number": "2.400",
                    "page": "1",
                    "uf": "PR"
                },
                "sharecropper": false,
                "temporary_arable_area": 1565044.86824,
                "total_area": 1594069.8256708356,
                "uf": "PR"
            },
        ]
    },
    "error": false,
    "message_id": "delivery_get_owner_successfull",
    "metadata": {}
}
}

Tabelas de Campos da Resposta#

Tabela de Impedimento Socioambiental#

Tabela de Camadas#

Tabela de Outras Atividades#

Tabela de Produtor#

Tabela de Produtividade#