34. Categorias e Serviços Prestado
O módulo Categorias e Serviços Prestados permite consultar as categorias de serviços disponíveis no sistema e pesquisar os serviços prestados pelas oficinas. Essas informações são utilizadas para organizar os serviços, facilitar pesquisas por filtros e auxiliar na seleção dos serviços disponíveis durante os processos de atendimento e manutenção.
Funcionalidades Principais
Abaixo estão os atalhos para as operações mais utilizadas neste módulo:
Listar Categorias de Serviços
Retorna todas as categorias de serviços cadastradas no sistema. Essas categorias representam os diferentes tipos de serviços que podem ser oferecidos pelas oficinas.
Endpoint: /api/service-categories
Método: GET
Parâmetros:
- Este endpoint não recebe parâmetros.
Códigos de resposta:
- 200 — Categorias de serviços retornadas com sucesso.
- 400 — Requisição inválida.
- 401 — Não autorizado.
- 403 — Acesso proibido.
- 500 — Erro interno do servidor.
Response body (exemplo):
[ { "id": 0, "code": "string" }]Pesquisar Serviços Prestados
Retorna uma lista de serviços prestados pelas oficinas com base nos filtros informados. Cada serviço é associado a uma categoria, permitindo identificar sua classificação dentro do sistema.
Endpoint: /api/services-provided/filters
Método: GET
Parâmetros:
- serviceProvidedFilterDTO (query, obrigatório) — Objeto contendo os filtros utilizados para pesquisar os serviços prestados.
Códigos de resposta:
- 200 — Serviços prestados retornados com sucesso.
- 400 — Requisição inválida.
- 401 — Não autorizado.
- 403 — Acesso proibido.
- 500 — Erro interno do servidor.
Response body (exemplo):
[ { "id": 0, "code": "string", "serviceCategory": { "id": 0, "code": "string" } }]