1. Segmentation
Developers EEmovel AGRO
  • Introdução
  • Primeiros passos
  • Owner
    • Ficha completa do produtor
      GET
    • Socios/co-proprietarios do produtor
      GET
    • Filiais do CNPJ (mesma raiz)
      GET
    • Classe de segmentacao financeira do produtor
      GET
  • Realty
    • Ficha completa da propriedade por CAR
      GET
  • Segmentation
    • Consumir uma segmentacao (produtores + propriedades + resumo)
      GET
    • Listar segmentacoes do provider
      GET
  • Esquemas
    • HAPI - Hub Integration API
    • ApiEnvelope
    • InputTotalItem
    • OwnerEnrichRequest
    • SeedTotalItem
    • PotencialByCultureItem
    • OwnerPotencial
    • OwnerCadProItem
    • OwnerCommitmentItem
    • OwnerRealtyFinancialItem
    • OwnerFinancialSummary
    • OwnerResponseData
    • OwnerObject
    • OwnerProductivityFinancial
    • OwnerProductivityItem
    • OwnerRegistry
    • RegistryObject
    • OwnerRealtyAltitude
    • AltitudeObject
    • DeclivityObject
    • OwnerRealtyDeclivity
    • ClimateItem
    • OwnerClimateItem
    • AgriculturalAptitudeItem
    • OwnerAgriculturalAptitudeItem
    • MainCultureObject
    • OwnerHarvestItem
    • OwnerRealtyHarvestItem
    • OwnerComplianceCriteriaItem
    • OwnerRealtyItem
    • ComplianceCriteriaItem
    • OwnerComplianceObject
    • OwnerCompliance
    • OwnerOtherActivitiesItem
    • OwnerLayerItem
    • OtherActivityItem
    • OwnerPartnerItem
    • OwnerDetailData
    • OwnerPartnersResponseData
    • PartnerItem
    • OwnerBranchesResponseData
    • OwnerPartnersData
    • PotentialBucket
    • OwnerBranchItem
    • OwnerSegmentationClassData
    • PotentialObject
    • OwnerSearchRequest
    • OwnerSegmentionClassResponseData
    • OwnerSearchResultItem
    • OwnerSearchData
    • OwnerDocumentRequest
    • OwnerFarmItem
    • OwnerFarmsData
    • OwnerEnrichData
    • RealtyObject
    • RealtyHarvestItem
    • RealtyProductivityItem
    • RealtyOwnerItem
    • RealtyCompliance
    • RealtyDetailData
    • CreditPool
    • CreditData
    • SegmentationListItem
    • SegmentationRealtyItem
    • SegmentationOwnerItem
    • SegmentationDetailData
  1. Segmentation

Consumir uma segmentacao (produtores + propriedades + resumo)

GET
/v2/segmentation/{segmentation_id}
Aplica o filtro salvo na segmentacao e devolve o resultado enriquecido:
Resumo no nivel raiz: total_owners, total_realty, total_area, perennial_arable_area, temporary_arable_area e uma chave por cultura ativa no filtro (ex.: soja) com o somatorio da area.
owners: por produtor, nome, documento, areas, count_realty, as mesmas chaves de cultura ativa e realtys com o detalhe de cada propriedade (car_id, nome, municipio, UF, area total, lavoura temporaria e reserva legal).
A busca replica a logica do modulo de owners da plataforma, entao os numeros batem com o que o usuario ve na tela. Filtros gravados em formato legado (ex.: total_area como [min, max], flags como "true") sao normalizados automaticamente — segmentacoes antigas e novas produzem consultas equivalentes.
Credito — esta e a chamada que debita: valida a cota para todos os produtores do resultado e registra o consumo em lote. Se a cota nao cobrir o conjunto, responde 400 delivery_get_segmentation_quota_hit sem debitar. Produtores LGPD/PEP ou sem credito consumido aparecem com nome e documento mascarados.
Exige a feature segmentation no api_config e configuracao de camadas/negocio do provider. Areas em m2.

Requisição

Parâmetros de Caminho

Respostas

🟢200
application/json
Sucesso
Bodyapplication/json

🟠400
🟠403
🟠404
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.master.agronavis.com.br/agro/hub/delivery/internal/v2/segmentation/'
Response Response Example
200 - Sucesso
{
    "data": {
        "name": "Soja > 500ha - Oeste PR",
        "total_owners": 2,
        "total_realty": 4,
        "total_area": 12480900,
        "perennial_arable_area": 0,
        "temporary_arable_area": 9820400,
        "soja": 9120300,
        "owners": [
            {
                "name": "ANA PAULA BONOTTO ORSO",
                "document": "04286982980",
                "total_area": 8295600,
                "perennial_arable_area": 0,
                "temporary_arable_area": 6540200,
                "irrigated_area": 155100,
                "count_realty": 3,
                "soja": 6120300,
                "realtys": [
                    {
                        "car_id": "PR-4104808-AC0D7F60B8FC46FBBB22A79B4DF2DF1A",
                        "realty_name": "Fazenda Primavera",
                        "city_name": "Cascavel",
                        "uf": "PR",
                        "total_area": 4185300,
                        "temporary_arable_area": 3620100,
                        "legal_reserve_area": 480200
                    },
                    {
                        "car_id": "PR-4104808-BD1E8071C9AD57GCCC33B80C5EF3EG2B",
                        "realty_name": "Fazenda Boa Vista",
                        "city_name": "Cascavel",
                        "uf": "PR",
                        "total_area": 2140800,
                        "temporary_arable_area": 1920100,
                        "legal_reserve_area": 210400
                    }
                ]
            },
            {
                "name": "AGR************",
                "document": "073*************",
                "total_area": 4185300,
                "perennial_arable_area": 0,
                "temporary_arable_area": 3280200,
                "irrigated_area": 0,
                "count_realty": 1,
                "soja": 3000000,
                "realtys": [
                    {
                        "car_id": "PR-4104808-CE2F9182DABE68HDDD44C91D6FG4FH3C",
                        "realty_name": "Fazenda Vale Verde",
                        "city_name": "Toledo",
                        "uf": "PR",
                        "total_area": 4185300,
                        "temporary_arable_area": 3280200,
                        "legal_reserve_area": 512700
                    }
                ]
            }
        ]
    },
    "metadata": {},
    "message_id": "delivery_get_segmentation_owners_success",
    "error": false
}
Modificado em 2026-08-28 19:28:22
Página anterior
Ficha completa da propriedade por CAR
Próxima página
Listar segmentacoes do provider
Built with