openthorDocumentação

get_stock_position

Posição de estoque atual · domínio Estoque · escopo mcp:inventory

O que faz

Estoque atual por produto: quantidade disponível, custo e valor parado (R$). Filtre por produto (product_code) ou veja os maiores estoques. Use para 'qual o estoque do produto X?' ou 'onde tenho mais estoque?'.

Exemplo de pergunta

qual o estoque do produto X?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.

Parâmetros

ParâmetroTipoObrigatórioPadrãoSignificado
product_codeintegernãoCódigo do produto (opcional)
topinteger (1–1000)não50

O que você recebe

  • product_code — Produto (cód.)
  • qty_on_hand — Em estoque
  • qty_available — Disponível
  • unit_cost — Custo unitário (R$)
  • stock_value — Valor em estoque (R$)
  • qty_sold_90d — Vendido em 90d (qtde)
  • days_since_sale — Dias sem vender

Cuidados ao ler o resultado

Leia antes de interpretar
  • Estoque da filial 01.
  • qty_available = disponível − reservado − bloqueado.

Por trás da ferramenta

Esta ferramenta consulta o endpoint /v1/stock da API REST — as mesmas permissões e o mesmo recorte da sua credencial valem nos dois caminhos.