Suprimentos da movimentação

Itens lançados em uma movimentação. Cada item é um insumo, com quantidade e preço de custo. Corresponde à aba Suprimentos da página da movimentação, na tela Inventário. A conclusão da movimentação é feita em PATCH /warehouse/inventory/{id}/conclude, descrito em Inventário.

Endpoints

Método	Caminho	Descrição
GET	/warehouse/inventory/{inventory_id}/supplies	Lista os itens da movimentação
POST	/warehouse/inventory/{inventory_id}/supplies	Lança um item na movimentação
PUT	/warehouse/inventory/{inventory_id}/supplies/{id}	Altera um item
DELETE	/warehouse/inventory/{inventory_id}/supplies/{id}	Remove um item

GET /warehouse/inventory/{inventory_id}/supplies

Lista os itens da movimentação.

Parâmetros de URL

Parâmetro	Descrição
search	Texto para buscar pelo nome ou pelo código do insumo, ou pelo nome do grupo
per_page	Quantidade de registros por página. Com ele, a resposta é paginada
page	Número da página, quando per_page é informado

Resposta (200): lista de itens com id, inventory_id, supply_id, group_name, supply (dados do insumo), quantity, cost_price, total_value (quantidade multiplicada pelo preço de custo) e os nomes de quem criou e de quem alterou por último.

POST /warehouse/inventory/{inventory_id}/supplies

Lança um item na movimentação. Se o insumo já estiver na movimentação, as quantidades são somadas ao item existente, e o preço de custo passa a ser o informado. Não é possível lançar itens em movimentação concluída.

Corpo

Campo	Obrigatório	Tipo	Descrição
supply_id	Sim	Número inteiro	id do insumo, obtido em Insumos
quantity	Sim	Número	Quantidade movimentada
cost_price	Não	Número	Preço de custo unitário do item

Resposta (201): o item criado, ou o item existente com a quantidade somada.

curl -X POST https://api.pedagogo.app/warehouse/inventory/<id-da-movimentacao>/supplies \
  -H "Authorization: Bearer <token-de-sessao>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"supply_id": 14, "quantity": 20, "cost_price": 3.5}'

PUT /warehouse/inventory/{inventory_id}/supplies/{id}

Altera a quantidade e o preço de custo de um item. Na tela, o item só é alterado enquanto a movimentação não estiver concluída. Corpo:

Campo	Obrigatório	Tipo	Descrição
supply_id	Sim	Número inteiro	id do insumo
quantity	Sim	Número	Quantidade movimentada
cost_price	Não	Número	Preço de custo unitário do item

Resposta (200): o item alterado.

DELETE /warehouse/inventory/{inventory_id}/supplies/{id}

Remove o item (exclusão lógica). Na tela, só é feito enquanto a movimentação não estiver concluída. Resposta (200), com corpo null.