REST API · Fato
Sales
Vendas — As linhas comerciais: cliente, produto, quantidade e faturamento.
grossAmount é o faturamento; stockAmount é o valor de custo ou estoque da linha. São medidas distintas. No tenant validado, subaccount vem de Subconta; a coluna SubcontaProd citada no levantamento do PBIX não existe no schema real.
Antes de somar
quantity só faz sentido somado dentro de uma mesma unit. Para um total que atravessa unidades, use grossAmount.
- Endereço
/v1/openagros/sales- Chave
id- Escopo
finance.read- Campos
- 25
REST não filtra
A superfície REST aceita apenas page e pageSize. Para filtrar ou ordenar no servidor, use OData; em REST, o recorte é do lado do cliente.
Campos
| Campo | O que é | Tipo | Nulo |
|---|---|---|---|
idchave | Identificador da linha. | Edm.Int64inteiro | — |
saleNumber | Número da venda. | Edm.Doublenúmero | sim |
date | Data do registro. | Edm.Datedata | sim |
document | Documento. | Edm.Stringtexto | sim |
documentNumber | Número do documento. | Edm.Stringtexto | sim |
counterparty | Contraparte (cliente ou fornecedor). | Edm.Stringtexto | sim |
product | Produto. | Edm.Stringtexto | sim |
group | Grupo. | Edm.Stringtexto | sim |
account | Conta. | Edm.Stringtexto | sim |
subaccount | Subconta. | Edm.Stringtexto | sim |
revenueGroup | Grupo da receita (canal ou rateio). Classifica a receita contra o plano de contas financeiro, não o produto vendido. | Edm.Stringtexto | sim |
revenueAccount | Conta da receita (canal ou rateio). | Edm.Stringtexto | sim |
revenueSubaccount | Subconta da receita (canal ou rateio). | Edm.Stringtexto | sim |
farm | Nome da fazenda. | Edm.Stringtexto | sim |
area | Nome da área. | Edm.Stringtexto | sim |
subarea | Nome da subárea (talhão). | Edm.Stringtexto | sim |
farmKey | Chave de relacionamento com a fazenda. | Edm.Stringtexto | sim |
areaKey | Chave de relacionamento com a área. | Edm.Stringtexto | sim |
subareaKey | Chave de relacionamento com a subárea. | Edm.Stringtexto | sim |
crop | Cultura. | Edm.Stringtexto | sim |
season | Ano-safra. | Edm.Stringtexto | sim |
quantity | Quantidade. | Edm.Doublenúmero | sim |
unit | Unidade de medida. | Edm.Stringtexto | sim |
grossAmount | Faturamento bruto. | Edm.Doublenúmero | — |
stockAmount | Valor de custo ou estoque da linha. | Edm.Doublenúmero | — |
Exemplos
curl
curl -H "Authorization: Bearer oag_SEU_TOKEN" \
"https://service.agrosti.com.br/v1/openagros/sales?pageSize=200&page=1"Sintaxe completa em REST API.