Introdução
Autenticação
Resposta e erros
SDKs e plugins
Países
Isenções IVA
Changelog
Vendas
Recibos
Clientes
Clientes - Contas em aberto
Artigos
Artigos - Stock
Artigos - Movimentos stock
Agenda - Marcações
Agenda - Indisponibilidades
Administração
Administração - Armazéns
Administração - Categorias
Administração - Colaboradores
Administração - Condições de pagamento
Administração - Formas de pagamento
Administração - Modos de expedição
Administração - Moedas
Administração - Preços
Administração - Séries
Administração - Taxas de IVA
Administração - Tipos de documento
Administração - Veículos
Administração - Unidades
Subscrição - Locais
Artigos - Stock - Actual
—Obtém o stock actual para determinado artigo. O endpoint devolve a soma (total) bem como as estatísticas do ano mencionado.
warehouse
mixed
Armazém. Pode ser enviado o ID ou o descritivo. No caso de não preenchimento será devolvido o stock de todos os armazéns.
year
integer
Ano do stock. No caso de não preenchimento será assumido o ano actual.
O valor do campo devolvido stats_year
é um array multidimensional onde consta o total de entradas, total de saídas e balanço, por esta ordem.
Request POST /items/:id/stock/actual
{
"warehouse": ..
"year": ..
}
Response 200
{
"status": true,
"data":
[
{
"quantity_in": ..
"quantity_out": ..
"balance": ..
"average_cost_price": ..
"stats_year": ..
"warehouse": ..
}
]
}
Sugerimos que teste e valide a resposta completa numa plataforma de testes de API como por exemplo Postman ou Insomnia.
Possíveis erros
- O valor do campo id é inválido
- Não tem permissões para executar esta operação
- O armazém não existe