Confirmar agendamento no Tasy

🌐 URLs dos Ambientes

🔹 Homologação

https://integracao.hml.cloud.medsenior.com.br/api/v1/agendamentos/confirmar

🔹 Produção

https://integracao.medsenior.com.br/api/v1/agendamentos/confirmar

O endpoint executa a procedure TASY.API_MS_JORNADA_DIG_PCK.MS_CONFIRMACAO_AGENDAS sempre com a opção CN (confirmar). Para cancelamentos utilize /api/v1/agendamentos/cancelamento.

📌 Endpoint

POST /api/v1/agendamentos/confirmar

🔐 Autenticação

Token Bearer obrigatório (mesmo fluxo usado pelos demais serviços da Jornada Digital).

Authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO

🔽 Cabeçalhos

Nome	Valor
accept	application/json
content-type	application/json

🧾 Corpo da Requisição (JSON)

Campo	Tipo	Obrigatório	Descrição
nrSeqAgenda	long	Sim	Sequência do slot que será confirmado (NR_SEQ_AGENDA_P). Deve ser maior que zero.
ieTipoAgenda	int	Sim	Tipo da agenda (IE_TIPO_AGENDA_P): 1 para exames ou 2 para consulta médica.
nmUsuario	string	Sim	Usuário responsável (NM_USUARIO_P). É aparado, não pode ficar vazio e aceita até 30 caracteres.

Campos com valores nulos, vazios ou fora das faixas acima resultam em 400 Bad Request antes de chamar o Tasy.

🔄 Exemplo de Requisição

curl -X 'POST' \
  'https://integracao.hml.cloud.medsenior.com.br/api/v1/agendamentos/confirmacao' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO' \
  -H 'content-type: application/json' \
  -d '{
        "nrSeqAgenda": 123456,
        "ieTipoAgenda": 1,
        "nmUsuario": "portal.jornada"
      }'

✅ Exemplo de Resposta (sucesso)

{
  "IE_CONFIRMADO_P": "S",
  "IE_CANCELADO_P": "N",
  "CODIGO_P": "0",
  "MENSAGEM_P": "Agenda confirmada!"
}

ℹ️ Observações de negócio

• A procedure confirma o slot original e replica o status para a Agenda Integrada e guias de autorização vinculadas.
• O serviço sempre envia IE_OPCAO_P = "CN" e CD_MOTIVO_CANCEL_P = null; para cancelar utilize o endpoint dedicado.
• Tipos de agenda aceitos são apenas 1 (exames) e 2 (consultas). Outros valores são rejeitados ainda na camada de aplicação.
• nmUsuario é aparado e validado para, no máximo, 30 caracteres. Utilize o identificador do serviço responsável pela confirmação.
• CODIGO_P devolvido pela procedure indica o resultado funcional: 0 sucesso, 1 já confirmado, 2 slot inexistente, 9 erro interno.

❌ Códigos HTTP

Status Code	Significado	Descrição
200	OK	Chamada executada. Utilize CODIGO_P/MENSAGEM_P para interpretar o retorno da procedure.
400	Bad Request	Faltam campos obrigatórios, valores inválidos (tipo de agenda, usuário, sequência) ou texto muito longo.
401	Unauthorized	Token inválido ou ausente.
404	Not Found	Slot não localizado (CODIGO_P = 2).
500	Server Error	Falha inesperada ao executar a procedure ou acessar o Oracle.