Alterar Status de Agendamento

Descrição

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

🛂 A permissão no EVO que libera o acesso a este endpoint é o Atividade - Edição.

📨 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

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

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

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

curl --location --request PATCH 'https://evo-integracao-api.w12app.com.br/api/v1/appointment/enroll/change-status?idActivitySession=undefined&subStatus=undefined&idMember=undefined&idProspect=undefined&idEmployee=undefined&idBranch=undefined' \ --header 'Authorization: Basic <encoded-value>'

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

Request

Responses

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#

Request

Responses

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