get https://evo-integracao-api.w12app.com.br/api/v1/service
Listar Serviços
Descrição
Retorna a lista de serviços cadastrados no sistema, permitindo filtragem por ID, nome, filial e status (ativo/inativo). Os resultados podem ser paginados por meio dos parâmetros take e skip.
Parâmetros de Consulta
Parâmetro | Tipo | Obrigatoriedade | Descrição |
---|---|---|---|
idService | int32 | Não | Filtrar pelo ID específico do serviço. |
name | string | Não | Filtrar pelo nome do serviço. |
idBranch | int32 | Recomendável | Filtrar pelo número da filial (somente aplicável para chaves multilocal; ignorado caso contrário). |
take | int32 | Não | Quantidade de registros a serem retornados (máximo 50). Padrão: 25. |
skip | int32 | Não | Quantidade de registros a serem ignorados na listagem (paginação). Padrão: 0. |
active | boolean | Não | Filtrar para retornar apenas serviços ativos (true ) ou inativos (false ). |
Estrutura da Resposta
A resposta retorna a lista de serviços encontrados com base nos filtros informados. Cada objeto de serviço inclui informações como nome, valor, disponibilidade para entradas, venda online e observações comerciais.
Campo | Tipo | Descrição |
---|---|---|
idService | int32 | ID único do serviço. |
idBranch | int32 | ID da filial associada ao serviço. |
nameService | string | Nome do serviço. |
value | number | Valor do serviço. |
allowEntries | boolean | Indica se o serviço permite lançamentos de entrada. |
experimentalClass | boolean | Indica se o serviço permite aula experimental. |
maxAmountInstallments | int32 | Quantidade máxima de parcelas permitidas para a venda do serviço. |
urlSale | string | URL para venda do serviço online. |
inactive | boolean | Indica se o serviço está inativo (true ) ou ativo (false ). |
onlineSalesObservations | string | Observações adicionais sobre a venda online do serviço. |
Exemplo de Resposta
[
{
"idService": 101,
"idBranch": 1,
"nameService": "Aula de Yoga",
"value": 120.00,
"allowEntries": true,
"experimentalClass": true,
"maxAmountInstallments": 3,
"urlSale": "https://academia.com/servicos/yoga",
"inactive": false,
"onlineSalesObservations": "Disponível apenas para alunos ativos."
}
]