Patrimônios

Bens da empresa. Cada bem pertence a um grupo e pode ser atribuído a um colaborador. Enquanto o bem está atribuído, a listagem mostra as atribuições dele. Corresponde à tela Patrimônios, do módulo Controle patrimonial. Os arquivos ficam em Arquivos do bem.

Endpoints

Método	Caminho	Descrição
GET	/equity-controls/assets	Lista os bens
POST	/equity-controls/assets	Cadastra um bem
GET	/equity-controls/assets/{uuid}	Consulta um bem
PUT	/equity-controls/assets/{uuid}	Altera um bem
DELETE	/equity-controls/assets/{uuid}	Apaga um bem
POST	/equity-controls/assets/employees/{equipment_id}	Atribui o bem a um colaborador
GET	/equity-controls/assets/groups	Lista os grupos, para o campo Grupo
GET	/equity-controls/assets/employees	Lista os colaboradores, para o campo Nome da atribuição

GET /equity-controls/assets

Lista os bens da empresa cliente, ordenados pelo grupo e pela descrição.

Parâmetros de URL

Parâmetro	Descrição
search	Texto para buscar pela descrição, pelo número de série, pelo fabricante, pela localização, pelo ano de fabricação, pelo nome do grupo ou pelo nome do colaborador atribuído
group_id	Lista somente os bens do grupo de id informado
not_equipment_id	Exclui o bem de id informado
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 bens com os campos do cadastro, group_name (grupo), type, status (status do cadastro), employeeEquipments (atribuições do bem, com os dados do colaborador em employee) e os nomes de quem criou e de quem alterou por último.

POST /equity-controls/assets

Cadastra um bem. Se já existir um cadastro do mesmo tipo com o mesmo número de série, esse cadastro é atualizado com os dados enviados (e reativado, se estiver excluído), em vez de criar outro.

Corpo

Campo	Obrigatório	Tipo	Descrição
group_id	Sim	Número inteiro	id do grupo, obtido em GET /equity-controls/assets/groups
details	Sim	Texto	Descrição do bem
serial_number	Sim	Texto	Número de série
manufacturer	Não	Texto	Nome do fabricante
year_of_manufacture	Não	Número inteiro	Ano de fabricação
dimensions	Não	Texto	Dimensões do bem
weight	Não	Número	Peso do bem
cost_price	Não	Número	Valor de custo
observation	Não	Texto	Observações livres sobre o bem

Resposta (201): o bem criado, com uuid.

curl -X POST https://api.pedagogo.app/equity-controls/assets \
  -H "Authorization: Bearer <token-de-sessao>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"group_id": 1, "details": "Notebook 14 polegadas", "serial_number": "NB-2026-0042"}'

GET /equity-controls/assets/{uuid}

Devolve o bem, com os dados do grupo. Resposta (200).

PUT /equity-controls/assets/{uuid}

Altera o bem. Os campos são os mesmos do cadastro, todos com Não, e só os informados são alterados. Resposta (200): o bem alterado.

DELETE /equity-controls/assets/{uuid}

Apaga o bem (exclusão lógica). Na tela, só é possível apagar um bem sem colaborador atribuído. Resposta (200), com corpo null.

POST /equity-controls/assets/employees/{equipment_id}

Atribui o bem a um colaborador. Na tela, a atribuição só é feita quando o bem não está atribuído, e cada bem tem um só colaborador por vez.

Parâmetros de URL

Parâmetro	Descrição
equipment_id	id numérico do bem, obtido em GET /equity-controls/assets

Corpo

Campo	Obrigatório	Tipo	Descrição
equipment_id	Sim	Número inteiro	id do bem. Use o mesmo valor do caminho
employee_id	Sim	Número inteiro	id do colaborador, obtido em GET /equity-controls/assets/employees
delivery_date	Sim	Data (AAAA-MM-DD)	Data da entrega
observations	Não	Texto	Observações internas sobre a entrega

Resposta (201): a atribuição criada, com id, employee_id, equipment_id, delivery_date, observations e return_date (vazio, enquanto o bem não for devolvido).

curl -X POST https://api.pedagogo.app/equity-controls/assets/employees/<id-do-bem> \
  -H "Authorization: Bearer <token-de-sessao>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"equipment_id": <id-do-bem>, "employee_id": 9, "delivery_date": "2026-11-10"}'

Auxiliares

Caminho	Parâmetros	Resposta
GET /equity-controls/assets/groups	search	Grupos de bens. A resposta é a de Grupos
GET /equity-controls/assets/employees	Nenhum	Colaboradores cadastrados, com id (usado em employee_id), name, document e dados de contato do cadastro