Operações e Atividades

Perguntas frequentes

1. É possível criar a grade de atividades pela API?

✅ Parcialmente.

1º passo - Consultar a grade existente:
O endpoint GET /api/v1/activities/schedule permite consultar a agenda de atividades com detalhes como data, hora, capacidade, instrutor, área, status e vagas.

2º passo - Criar aula experimental pontual:
O endpoint POST /api/v1/activities/schedule/experimental-class permite criar uma aula experimental individual e matricular um prospect nela.

A criação de uma grade fixa/recorrente completa (ex: toda segunda-feira às 18h) ainda não é possível via API pública.

2. É possível matricular alunos em uma turma (fixa) pela API?

✅ Sim.

Endpoint: POST /api/v1/activities/schedule/enroll
Campos necessários: idConfiguration, activityDate, slotNumber, idMember.

3. Troca de contrato pela API é possível?

✅ Sim, com duas etapas:

1ª etapa - Cancelar o contrato atual:

Use o endpoint:POST /api/v1/membermembership/cancellation
Parâmetro obrigatório: idMemberMembership (ID do contrato do aluno).
Também é possível definir data de cancelamento, motivo, multa, créditos restantes, sessões futuras, entre outros.

2ª etapa - Criar um novo contrato:

Use o endpoint:
POST /api/v2/sales
Informando idMembership, dados do membro, pagamento, filial e demais parâmetros da venda.

Situações frequentes

Erro "Activity out of booking hours"

O erro "Activity out of booking hours" está relacionado à configuração da atividade no EVO. Nele, pode estar definido um tempo mínimo de antecedência para que a reserva seja permitida.

Para resolver, é necessário acessar o sistema EVO, ir até Administrativo > Atividades na agenda, editar a atividade desejada e habilitar a opção "Permitir que o cliente reserve", marcando também o canal "Aplicativo/Site". Nessa mesma tela, é possível configurar o tempo mínimo de antecedência que o cliente precisa respeitar para conseguir realizar a reserva.