Marcar agendamento no Tasy

🌐 URLs dos Ambientes

🔹 Homologação

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

🔹 Produção

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

📌 Endpoint

POST /api/v1/agendamentos/marcar

🔐 Autenticação

Requer token Bearer válido.

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
tokenReserva	string	Sim	Identificador único gerado na etapa de reserva de slot. Use o token retornado pela reserva para efetivar a marcação (máx. 32 caracteres).
nmUsuario	string	Sim	Usuário responsável pela marcação no Tasy (máx. 30 caracteres).

🔄 Exemplo de Requisição

🔹 Ambiente de homologação

curl -X 'POST' \
  'https://integracao.hml.cloud.medsenior.com.br/api/v1/agendamentos/exames/marcar' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO' \
  -H 'content-type: application/json' \
  -d '{
    "tokenReserva": "c7f0e9d8b6a643bc9f27f0a1e2d34b56",
    "nmUsuario": "portal-medsenior"
  }'

🔹 Ambiente de produção

curl -X 'POST' \
  'https://integracao.medsenior.com.br/api/v1/agendamentos/exames/marcar' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO' \
  -H 'content-type: application/json' \
  -d '{
    "tokenReserva": "c7f0e9d8b6a643bc9f27f0a1e2d34b56",
    "nmUsuario": "portal-medsenior"
  }'

✅ Resposta de Sucesso

• Status Code: 200 OK
• Exemplo:

{
  "IE_AGENDADO_P": "S",
  "CODIGO_P": "0",
  "MENSAGEM_P": "Exame agendado!"
}

❌ Códigos de Retorno (procedure TASY.API_MS_JORNADA_DIG_PCK.MS_MARCAR_EXAME)

CODIGO_P	Significado	Ação da API
0	Exame agendado	200 (sucesso)
1	Reserva não está mais disponível para agendamento	404 (reserva não encontrada/expirada)
2	Exame já consta agendado	400 (falha de regra de negócio)
9	SQLERRM (erro interno Oracle)	400 (erro na marcação)

ℹ️ Observações de negócio

• A marcação preenche o slot e registra também na Agenda Integrada com paciente, convênio, itens agendados, regional e forma de agendamento (Portal, APP, WhatsApp).
• O médico solicitante é preenchido de forma fixa com o código genérico 213974 (CRM 99999998 - Médico Externo), seguindo o padrão do Call Center.
• Exames associados ao procedimento interno são marcados automaticamente junto ao exame principal.
• O token de reserva e o status de agendamento são armazenados em TASY.API_MS_RESERVA_SLOT, permitindo controle do fluxo online.