REST API · Fato
SalesPerformancePeriods
Desempenho de vendas por período — Receita mensal por fazenda e safra, com população deduplicada e receita por planta.
- Endereço
/v1/openagros/sales-performance-periods- Chave
id- Escopo
finance.read- Campos
- 10
Indisponível em REST
Esta coleção exige filtro em periodStart, e a superfície REST não recebe filtro — só paginação. Toda chamada REST aqui responde 400 FilterRequired. Use a versão OData.
Campos
| Campo | O que é | Tipo | Nulo |
|---|---|---|---|
idchave | Identificador da linha. | Edm.Stringtexto | — |
periodStart | Primeiro dia do mês do modelo agregado. Os modelos derivados exigem filtro por este campo. | Edm.Datedata | sim |
farm | Nome da fazenda. | Edm.Stringtexto | sim |
farmKey | Chave de relacionamento com a fazenda. | Edm.Stringtexto | sim |
season | Ano-safra. | Edm.Stringtexto | sim |
grossAmount | Faturamento bruto. | Edm.Doublenúmero | — |
stockAmount | Valor de custo ou estoque da linha. | Edm.Doublenúmero | — |
saleLines | Quantidade de linhas comerciais agregadas no mês. | Edm.Int64inteiro | — |
plantCount | Total de plantas do talhão. É atributo: a mesma subárea aparece em várias ordens de produção, então somar entre elas conta a mesma planta de novo. | Edm.Doublenúmero | sim |
revenuePerPlant | Receita bruta mensal dividida pela população de plantas da fazenda/safra. É razão: não some entre linhas. | Edm.Doublenúmero | sim |
Exemplos
curl
curl -H "Authorization: Bearer oag_SEU_TOKEN" \
"https://service.agrosti.com.br/v1/openagros/sales-performance-periods?pageSize=200&page=1"Sintaxe completa em REST API.