REST API · Fato
InventoryMovements
Movimentação de estoque — Entradas e saídas de insumo. É fluxo do período, não posição de estoque.
location e type entregam o mesmo dado — o local de estoque do movimento. type é o nome antigo, mantido para não quebrar relatórios já publicados; em modelo novo, use location.
Antes de somar
É fluxo do período, não posição de estoque. Some inQuantity e outQuantity; o saldo acumulado não é exposto porque se repete a cada movimento e somá-lo não significa nada. Para posição, agregue o fluxo até a data.
- Endereço
/v1/openagros/inventory-movements- Chave
id- Escopo
finance.read- Campos
- 14
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 | — |
date | Data do registro. | Edm.Datedata | sim |
input | Insumo aplicado. | Edm.Stringtexto | sim |
inputId | Identificador do insumo. | Edm.Doublenúmero | sim |
type | Local de estoque do movimento. Nome herdado: prefira `location`, que lê o mesmo dado. | Edm.Stringtexto | sim |
location | Local de estoque do movimento — o tanque, no combustível. | Edm.Stringtexto | sim |
document | Documento. | Edm.Stringtexto | sim |
documentNumber | Número do documento. | Edm.Stringtexto | sim |
supplier | Fornecedor. | Edm.Stringtexto | sim |
inQuantity | Quantidade que entrou. | Edm.Doublenúmero | sim |
outQuantity | Quantidade que saiu. | Edm.Doublenúmero | sim |
unitPrice | Preço unitário. | Edm.Doublenúmero | sim |
totalCost | Custo total. | Edm.Doublenúmero | — |
averageCost | Custo médio. | Edm.Doublenúmero | sim |
Exemplos
curl
curl -H "Authorization: Bearer oag_SEU_TOKEN" \
"https://service.agrosti.com.br/v1/openagros/inventory-movements?pageSize=200&page=1"Sintaxe completa em REST API.