BeeFoodDevelopers
Entrar ou criar acesso

Atualizar em lote

PATCH
Markdown (LLM)

Atualiza campos de estoque e saldo. O retorno vem na ordem do body; cada linha é independente e falhas não desfazem as demais.

Escopo:stock:write

Limite:300 chamadas / 180s

Parâmetros do body

typestring

Tipo do item; deve combinar com o ID da linha.

Enum

  • supplyInsumo
  • productProduto
  • complementComplemento
product
supplyIdinteger

Identificador do insumo; informe exatamente um ID por linha.

30
productIdinteger

Identificador do produto; informe exatamente um ID por linha.

10
complementIdinteger

Identificador do complemento; informe exatamente um ID por linha.

8
stockControlboolean

Liga ou desliga o controle de estoque.

true
stockAllowNegativeboolean

Permite estoque negativo.

false
stockMinimumQuantitynumber

Estoque mínimo maior ou igual a 0; null para limpar.

2
operationstring

Operação do ajuste de saldo;

Enum

  • addSoma a quantidade ao saldo
  • subtractSubtrai a quantidade do saldo
  • newDefine o novo saldo
add
stockQuantitynumber

Vai junto com operation. Maior que 0 em add e subtract; maior ou igual a 0 em new.

1.5

Parâmetros da resposta

Como usar

Essa rota liga o controle de estoque e mexe no saldo. Cada linha leva type (supply, product ou complement) e o ID daquele recurso (supplyId, productId ou complementId).

add soma ao saldo e subtract tira do saldo. new grava o saldo informado no lugar do atual: serve para o saldo inicial e para a conferência.

Os exemplos usam produto. Insumo troca type e o ID para supply / supplyId; complemento usa complement / complementId.

Regras

  • stockControl: true liga o controle e stockControl: false desliga. Campo omitido não altera a configuração.
  • operation e stockQuantity vão juntos. Sem os dois, a linha só mexe na configuração.
  • add e subtract exigem stockQuantity maior que 0. new exige stockQuantity maior ou igual a 0; new com 0 zera o saldo.
  • Ativar e gravar saldo na mesma linha: a configuração grava primeiro. Se o saldo falhar, a configuração permanece e a linha volta success: false.
  • stockAllowNegative: true sem acesso ao plano de estoque avançado falha só aquela linha, com success: false e message The plan does not include access to enable negative stock. O restante da linha não grava, inclusive o saldo (operation e stockQuantity); as demais linhas seguem.
  • false ou campo omitido não consulta o plano e grava normalmente.
  • new com o saldo já igual ao informado não grava movimentação. A resposta continua success: true com esse stockQuantity.
  • remove e set não existem. Para tirar quantidade, use subtract; para definir o saldo, use new.

200 devolve uma linha por item, na mesma ordem. stockQuantity na resposta é o saldo depois da operação e só aparece quando o saldo gravou.