Inventário

Movimentações do almoxarifado. Cada movimentação tem uma empresa (opcional), um tipo de movimentação, uma data e uma lista de itens, lançados em Suprimentos da movimentação. A movimentação só altera o estoque depois de concluída. Corresponde à tela Inventário, do módulo Almoxarifado.

Endpoints

Método	Caminho	Descrição
GET	/warehouse/inventory	Lista as movimentações
POST	/warehouse/inventory	Cria uma movimentação
GET	/warehouse/inventory/{id}	Consulta uma movimentação
PUT	/warehouse/inventory/{id}	Altera uma movimentação
DELETE	/warehouse/inventory/{id}	Apaga uma movimentação
PATCH	/warehouse/inventory/{id}/conclude	Conclui a movimentação
GET	/warehouse/inventory/companies	Lista as empresas, para o campo Empresa
GET	/warehouse/inventory/types	Lista os tipos de inventário, para o campo Tipo de inventário

GET /warehouse/inventory

Lista as movimentações da empresa cliente, da mais recente para a mais antiga. Se o usuário estiver vinculado a uma empresa, a lista traz só as movimentações dela.

Parâmetros de URL

Parâmetro	Descrição
search	Texto para buscar pelo nome do tipo de inventário
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 movimentações com id, company_id, company_name, inventory_type_id, inventoryType (tipo, com in_out), date, concluded e os nomes de quem criou e de quem alterou por último.

POST /warehouse/inventory

Cria uma movimentação.

Corpo

Campo	Obrigatório	Tipo	Descrição
inventory_type_id	Sim	Número inteiro	id do tipo de inventário, obtido em GET /warehouse/inventory/types. Define se a movimentação é de entrada ou de saída
date	Sim	Data (AAAA-MM-DD)	Data da movimentação
company_id	Não	Número inteiro	id da empresa, obtido em GET /warehouse/inventory/companies

Resposta (201): a movimentação criada, com id.

curl -X POST https://api.pedagogo.app/warehouse/inventory \
  -H "Authorization: Bearer <token-de-sessao>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"inventory_type_id": 1, "date": "2026-11-10"}'

PUT /warehouse/inventory/{id}

Altera a movimentação. Os campos são os mesmos do cadastro, todos com Não, e só os informados são alterados. Na tela, a movimentação só é alterada enquanto não estiver concluída. Resposta (200): a movimentação alterada.

GET /warehouse/inventory/{id}

Devolve a movimentação, com o tipo de inventário. Resposta (200).

DELETE /warehouse/inventory/{id}

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

PATCH /warehouse/inventory/{id}/conclude

Conclui a movimentação. Ao concluir, a movimentação passa a contar no estoque, e o preço de custo de cada insumo da movimentação é atualizado com o preço do item lançado. Concluir exige pelo menos um item lançado.

Sem corpo.

Resposta

• 200: {"success": true, "message": "Inventory successfully completed."}.
• 500: {"success": false, "message": "Unable to complete an inventory out of supplies."}, quando a movimentação não tem itens.

Auxiliares

Caminho	Parâmetros	Resposta
GET /warehouse/inventory/companies	search (nome, razão social, documento ou nome da empresa cliente)	Empresas da empresa cliente, com id, name, company_name e document
GET /warehouse/inventory/types	search	Tipos de inventário. A resposta é a de Tipos de inventário