Ficha completa do produtor

Endpoint principal da XAPI: devolve a ficha completa do produtor rural por CPF/CNPJ em uma unica chamada — cadastro, propriedades (com geometria, solo, clima, declividade, altitude, biomas e matricula), produtividade estimada dos ultimos 3 anos, sintese financeira com operacoes de credito, camadas de negocio, situacao socioambiental, outras atividades e potencial de insumos.

O payload e contratual por provider. A query e montada dinamicamente a partir de provider.api_config.owner, entao praticamente todo campo aqui e opcional: aparece so se o provider contratou. Trate ausencia de chave como normal.

Fluxo de credito — antes da query pesada, valida existencia do produtor e cota. Cada sucesso registra consumo no pool XAPI (api_owner_credit), separado do pool HAPI. Consultas repetidas do mesmo produtor no contrato nao debitam de novo.

Dados externos — telefone e e-mail vem da Localize API v3; falha ali nao derruba a resposta. KML e deforestation_polygons sao gravados no S3 e retornados como URL pre-assinada valida por 3600s.

LGPD — produtores marcados retornam ocultado por LGPD em nome e documento (exceto CNPJ).

{ "data": { "owner": { "owner": "ANA PAULA BONOTTO ORSO", "document": "04286982980", "document_type": "CPF", "is_customer": true, "realty_count": 3, "rural_insurance": true, "state_registration": "9012345678", "technified_indicator": "Alta", "owner_count": 2, "sharecropper_count": 1, "avm": 18450000, "cad_pro": [ { "state_registration": "9012345678", "situation": "Ativo", "city_name": "Cascavel", "uf": "PR", "name": "ANA PAULA BONOTTO ORSO", "status": "Habilitado", "activation_date": "2019-04-02" } ], "caf": [], "financial_summary": { "total_cost": 4820000, "total_income": 7310000, "total_result": 2490000, "total_commitment": 1200000, "final_result": 1290000, "commitments": [ { "institution_name": "BANCO DO BRASIL", "emission_date": "2025-09-15", "due_date": "2026-08-31", "interest": 84000, "debtor_amount": 1200000, "purpose": "Custeio", "product": "CPR", "borrowers_quantity": 1, "active": true } ], "realty_financial": [ { "realty_id": "PR-4104808-AC0D7F60B8FC46FBBB22A79B4DF2DF1A", "realty_name": "Fazenda Primavera", "owner_participation_rate": 1, "year": 2025, "total_cost": 2610000, "total_income": 4120000, "total_result": 1510000 } ] }, "potencial": { "owner_defensive": [ { "culture": "Soja", "type": "Herbicida", "total": 10860, "unit": "l" } ], "owner_fertilizer": [ { "culture": "Soja", "type": "NPK", "total": 724020, "unit": "kg" } ], "owner_seeds": [ { "culture": "Soja", "total": 217206, "unit": "kg" } ], "owner_potencial": [ { "culture": "Soja", "defensivo": [ { "type": "Herbicida", "total": 10860, "unit": "l" } ], "fertilizante": [ { "type": "NPK", "total": 724020, "unit": "kg" } ], "sementes": [ { "total": 217206, "unit": "kg" } ] } ] }, "phone": [ "45999887766", "4532221100" ], "email": [ "ana.orso@fazendaprimavera.com.br" ] }, "productivity": [ { "realty_id": "PR-4104808-AC0D7F60B8FC46FBBB22A79B4DF2DF1A", "year": "2025", "culture": "Soja", "productivity": 3900, "production": 1411.8, "financial": { "cost": 2610000, "income": 4120000, "result": 1510000 } } ], "realty": [ { "realty_id": "PR-4104808-AC0D7F60B8FC46FBBB22A79B4DF2DF1A", "rural_settlement": false, "sharecropper": false, "realty_name": "Fazenda Primavera", "total_area": 4185300, "arable_area": 3620100, "temporary_arable_area": 3620100, "perennial_arable_area": 0, "legal_reserve_area": 480200, "city_name": "Cascavel", "uf": "PR", "lat": -24.955201, "long": -53.455202, "owner": "ANA PAULA BONOTTO ORSO", "registry": { "book": "2-RG", "page": "144", "number": "12.345", "city": "Cascavel", "uf": "PR" }, "compliance": null, "main_culture": { "culture": "soja", "area": 3620100 }, "harvest": [ { "area": 3620100, "culture": "Soja", "harvest": "Soja|03/2025" } ], "altitude": { "min": 640, "mean": 712.4, "max": 786 }, "declivity": { "flat": 1820400, "soft_wavy": 1502300, "wavy": 610900, "strong_wavy": 189200, "mountainous": 62500, "steep": 0 }, "biome": [ "Mata Atlântica" ], "soil_type": [ "LATOSSOLO VERMELHO", "NITOSSOLO VERMELHO" ], "climate": [ { "class": "Cfa", "description": "Subtropical úmido" } ], "agricultural_aptitude": [ { "legend_ap": "Boa", "simb_apt": "1abc" } ], "avm": 9820000, "kml": "https://agro-hub-realty-kml.s3.amazonaws.com/PR-4104808-AC0D7F60B8FC46FBBB22A79B4DF2DF1A.kml?X-Amz-Expires=3600&X-Amz-Signature=...", "realty_defensive": [ { "culture": "Soja", "type": "Herbicida", "total": 10860, "unit": "l" } ], "realty_fertilizer": [ { "culture": "Soja", "type": "NPK", "total": 724020, "unit": "kg" } ], "realty_seeds": [ { "culture": "Soja", "total": 217206, "unit": "kg" } ] } ], "compliance": { "owner_status": false, "criteria": [ { "compliance": "Trabalho escravo", "last_registry": null, "status_compliance": null }, { "compliance": "Embargo IBAMA", "last_registry": null, "status_compliance": null } ] }, "layer": [ { "realty_id": "PR-4104808-AC0D7F60B8FC46FBBB22A79B4DF2DF1A", "silos_capacity": 24000, "pivos_area": 155100, "bovinos_quantity": 320 } ], "other_activities": [ { "group": "Bovinocultura", "product": "Bovinos de corte", "year": 2025, "quantity": 320, "cost": 410000, "income": 640000, "result": 230000 } ] }, "metadata": {}, "message_id": "delivery_get_owner_successfull", "error": false }

Requisição

Respostas