Nova API V1.0 · Referência
Registrar contagem de inputs
Altera o saldo real e registra o ajuste no histórico. Requer access token de integração com inputs:stock:write; sessões humanas e chaves tk_ diretas não são aceitas. Consulte stock_version antes da contagem. HTTP 409 exige nova leitura e revisão humana da contagem; não reenvie automaticamente. Mesmo pedido e Idempotency-Key retornam o resultado original, inclusive entre HTTP e MCP. counted_at é auditoria, sem reconstrução retroativa. Cadastros master e multiloja são recusados. Lotes são atômicos, com 1 a 100 IDs distintos. Disponibilidade depende da implantação da migration e API ESTR-1112.
Altera o saldo real e registra o ajuste no histórico. Requer access token de integração com inputs:stock:write; sessões humanas e chaves tk_ diretas não são aceitas. Consulte stock_version antes da contagem. HTTP 409 exige nova leitura e revisão humana da contagem; não reenvie automaticamente. Mesmo pedido e Idempotency-Key retornam o resultado original, inclusive entre HTTP e MCP. counted_at é auditoria, sem reconstrução retroativa. Cadastros master e multiloja são recusados. Lotes são atômicos, com 1 a 100 IDs distintos. Disponibilidade depende da implantação da migration e API ESTR-1112.
Authorization
inventoryIntegration Access token de integração com inputs:stock:write ou intermediaries:stock:write conforme a operação. Sessões humanas não são aceitas.
In: header
Path Parameters
Query Parameters
Omitido para sessões de restaurante ou credenciais com uma única loja.
Obrigatório quando uma chave ou autorização OAuth multilojas, ou um
parceiro, cobre várias lojas. É validado contra as lojas atualmente
autorizadas pela credencial. Em uma sessão, um valor diferente do
restaurant_id assinado responde 403.
Header Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
Listar produtos intermediários (V2 paginada) GET
Registros não cancelados do restaurante, ordenados por nome e por ID em empates. Com OAuth exige `intermediaries:read`; aceita também a sessão do restaurante. Página fixa de 100 registros; não permite escrita. Quantidades mantêm o texto e os valores monetários têm duas casas decimais. Valores inválidos já armazenados preservam a string NaN do PostgreSQL. Retorna data e pagination; siga pagination.next mantendo os filtros. A V1 permanece disponível com seu contrato anterior.
Registrar contagem de inputs em lote POST
Altera o saldo real e registra o ajuste no histórico. Requer access token de integração com inputs:stock:write; sessões humanas e chaves tk_ diretas não são aceitas. Consulte stock_version antes da contagem. HTTP 409 exige nova leitura e revisão humana da contagem; não reenvie automaticamente. Mesmo pedido e Idempotency-Key retornam o resultado original, inclusive entre HTTP e MCP. counted_at é auditoria, sem reconstrução retroativa. Cadastros master e multiloja são recusados. Lotes são atômicos, com 1 a 100 IDs distintos. Disponibilidade depende da implantação da migration e API ESTR-1112.