Skip to main content
POST
Criar insumo

Autorizações

Authorization
string
header
obrigatório

Access token OAuth 2.0 de app instalado na CW App Store. Escopo: catalog.

Corpo

application/json
name
string
obrigatório

Nome do insumo.

Required string length: 1 - 200
supply_category_id
integer
obrigatório

ID da categoria de insumos à qual o insumo pertence.

external_code
string | null

Código externo do insumo.

Maximum string length: 50
unit_type
enum<string>
padrão:UN

Unidade de medida do insumo.

  • UN: unidade (padrão).
  • KG: quilograma.
  • L: litro.
Opções disponíveis:
UN,
KG,
L
allow_negative_stock
boolean
padrão:true

Indica se o estoque pode ficar negativo. Se omitido, o valor padrão é true.

cost_price
number | null

Preço de custo do insumo. Deve ser um número positivo com no máximo 2 casas decimais.

Intervalo obrigatório: x >= 0

Resposta

Insumo criado com sucesso.

Insumo do estabelecimento.

id
integer

Identificador único do insumo.

external_code
string | null

Código externo do insumo.

name
string

Nome do insumo.

unit_type
enum<string>
padrão:UN

Unidade de medida do insumo.

  • UN: unidade (padrão).
  • KG: quilograma.
  • L: litro.
Opções disponíveis:
UN,
KG,
L
allow_negative_stock
boolean

Indica se o estoque pode ficar negativo.

cost_price
number | null

Preço de custo do insumo. Deve ser um número positivo com no máximo 2 casas decimais.

Intervalo obrigatório: x >= 0
active_stock_control
boolean

Indica se o controle de estoque está ativo. Somente leitura.

stock
number

Quantidade disponível em estoque. Somente leitura.

minimum_stock
number | null

Estoque mínimo. Somente leitura.

created_at
string<date-time>

Data e hora de criação do insumo.

supply_category
object

Categoria à qual o insumo pertence.

Última modificação em 27 de agosto de 2026