Grupos

Grupos organizam os insumos em categorias. Cada insumo pertence a um grupo. Corresponde à tela Grupos, do módulo Almoxarifado.

Endpoints

Método	Caminho	Descrição
GET	/warehouse/groups	Lista os grupos
POST	/warehouse/groups	Cadastra um grupo
PUT	/warehouse/groups/{id}	Altera um grupo
DELETE	/warehouse/groups/{id}	Apaga um grupo

GET /warehouse/groups

Lista os grupos da empresa cliente, ordenados pelo nome.

Parâmetros de URL

Parâmetro	Descrição
search	Texto para buscar 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 grupos com id, group, type, updated_at e os nomes de quem criou e de quem alterou por último.

POST /warehouse/groups

Cadastra um grupo.

Corpo

Campo	Obrigatório	Tipo	Descrição
group	Sim	Texto	Nome do grupo

Resposta (201): o grupo criado, com id e group.

curl -X POST https://api.pedagogo.app/warehouse/groups \
  -H "Authorization: Bearer <token-de-sessao>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"group": "Materiais de limpeza"}'

PUT /warehouse/groups/{id}

Altera o nome do grupo.

Corpo

Campo	Obrigatório	Tipo	Descrição
group	Sim	Texto	Nome do grupo

Resposta (200): o grupo alterado.

DELETE /warehouse/groups/{id}

Apaga o grupo (exclusão lógica). Resposta (200): lista de grupos da empresa cliente.