Alterar Status de Agendamento

Descrição

Altera o status de um agendamento existente (sessão de atividade) para um cliente (membro, prospect ou colaborador).

Este endpoint deve ser utilizado em conjunto com o endpoint GET /api/v1/appointment/schedule/detail, que retorna os dados atuais do agendamento.

📨 Corpo da Requisição (Request Body)

Campo	Tipo	Obrigatório	Descrição
`idBranch`	int32	Sim	Identificador da unidade em que o agendamento foi realizado.
`idActivitySession`	int32	Sim	Identificador da sessão de atividade (agendamento) cujo status será alterado.
`idMember`	int32	Condicional	Identificador do membro. Pelo menos um entre `idMember`, `idProspect` ou `idEmployee` deve ser informado.
`idProspect`	int32	Condicional	Identificador do prospect. Pelo menos um entre `idMember`, `idProspect` ou `idEmployee` deve ser informado.
`idEmployee`	int32	Condicional	Identificador do colaborador. Pelo menos um entre `idMember`, `idProspect` ou `idEmployee` deve ser informado.
`subStatus`	int32	Sim	Novo substatus do agendamento, conforme enum SubStatus abaixo.

Regra de obrigatoriedade combinada:
Obrigatórios: idBranch, idActivitySession, subStatus
E pelo menos um entre: idMember, idProspect ou idEmployee.

🔷 Enum `subStatus`

Substatus que representa a situação do agendamento na agenda (retornado por appointments/schedule/detail).

Valor	Nome	Descrição
0	Agendado	Agendamento criado, ainda não confirmado.
1	Confirmado	Agendamento confirmado.
2	Presente	Cliente marcado como presente.
3	Falta	Cliente ausente (falta).
7	FaltaJustificada	Cliente ausente com justificativa.

OBS. incluir a opção de alteração para subStatus correspondente aos valores acima.

🔁 Regra de Atualização na Tabela de Status (Enum `Enrollments`)

Ao alterar o subStatus do agendamento, o sistema deve também atualizar o status do cliente na atividade (Enum Enrollments, utilizado no objeto Enrollment / presença).

A regra de mapeamento é:

SubStatus (Agendamento)	Valor SubStatus	Status (Enrollments)	Valor Status	Descrição Status (Enrollments)
Agendado	0	Presente	0	Código do status do cliente relacionado à atividade.
Confirmado	1	Presente	0
Presente	2	Presente	0
Falta	3	Falta	1
FaltaJustificada	7	Falta Justificada	2

Para Agendado / Confirmado / Presente → gravar Status = 0 (Presente) no enum Enrollments.
Para Falta → gravar Status = 1 (Falta).
Para FaltaJustificada → gravar Status = 2 (Falta Justificada).

📤 Estrutura da Resposta — Sucesso

Ao alterar o status com sucesso, o endpoint pode retornar um resumo do agendamento atualizado.

Campo	Tipo	Descrição
`idActivitySession`	int32	Identificador da sessão de atividade.
`subStatus`	int32	Substatus atualizado do agendamento.
`status`	int32	Status do cliente na atividade (Enum `Enrollments`).
`message`	string	Mensagem de confirmação da alteração.

Basic Auth

Envie suas requisições HTTP com um cabeçalho

Authorization

que contenha a palavra Basic seguida por um espaço e uma string codificada em base64 username:password

Exemplo:

Authorization: Basic *****************

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Change status of a member in a appointment

Alterar Status de Agendamento

Descrição

📨 Corpo da Requisição (Request Body)

🔷 Enum `subStatus`

🔁 Regra de Atualização na Tabela de Status (Enum `Enrollments`)

📤 Estrutura da Resposta — Sucesso

Requisição

Exemplos de Requisição

Respostas

Change status of a member in a appointment

Alterar Status de Agendamento#

Descrição#

📨 Corpo da Requisição (Request Body)#

🔷 Enum subStatus#

🔁 Regra de Atualização na Tabela de Status (Enum Enrollments)#

📤 Estrutura da Resposta — Sucesso#

Requisição

Exemplos de Requisição

Respostas

Alterar Status de Agendamento

Descrição

📨 Corpo da Requisição (Request Body)

🔷 Enum `subStatus`

🔁 Regra de Atualização na Tabela de Status (Enum `Enrollments`)

📤 Estrutura da Resposta — Sucesso