Criar insumo

POST
Markdown (LLM)

Cria um insumo para o restaurante.

Escopo:stock:write

Limite:300 chamadas / 180s

Parâmetros do body

namestring

Nome do insumo, de 1 a 100 caracteres.

Farinha
categoryIdinteger

Categoria do restaurante.

12
unitstring

Unidade de medida (padrão UN).

Enum

  • UNUnidade
  • KGQuilograma
  • GGrama
  • LLitro
KG
costnumber

Custo maior ou igual a 0, ou null para limpar.

3.5
stockAllowNegativeboolean

Permite estoque negativo (padrão false).

false

Parâmetros da resposta

supplyIdnumber

Identificador do insumo.

31
namestring

Nome do insumo.

"Farinha"
unitstring

Unidade; omitida quando vazia.

Enum

  • UNUnidade
  • KGQuilograma
  • GGrama
  • LLitro
"KG"
costnumber

Custo; omitido quando vazio.

3.5
stockAllowNegativeboolean

Permite estoque negativo.

false
stockControlboolean

Controle de estoque ligado.

false
stockMinimumQuantitynumber

Estoque mínimo; omitido quando vazio.

200
categoryIdnumber

Categoria; omitida quando ausente.

12
categoryNamestring

Nome da categoria; omitido quando vazio.

"Massas"

Como usar

Crie o insumo informando nome e categoria. unit, cost e stockAllowNegative são opcionais.

Regras

  • stockAllowNegative: true só grava com acesso ao plano de estoque avançado. Sem esse acesso, a resposta é 403 com a mensagem The plan does not include access to enable negative stock e o insumo não é criado.
  • false ou campo omitido não consulta o plano e grava normalmente.