Obter slots livres no Tasy

🌐 URLs dos Ambientes

🔹 Homologação

https://integracao.hml.cloud.medsenior.com.br/api/v1/agendamentos/slots-livres?dtAgenda={{dtAgenda}}&cdEstabelecimento={{cdEstabelecimento}}&cdPessoaFisica={{cdPessoaFisica}}&nrSeqProcInterno={{nrSeqProcInterno}}&ieLado={{ieLado}}&ieTurno={{ieTurno}}

🔹 Produção

https://integracao.medsenior.com.br/api/v1/agendamentos/slots-livres?dtAgenda={{dtAgenda}}&cdEstabelecimento={{cdEstabelecimento}}&cdPessoaFisica={{cdPessoaFisica}}&nrSeqProcInterno={{nrSeqProcInterno}}&ieLado={{ieLado}}&ieTurno={{ieTurno}}

Os quatro primeiros parâmetros (dtAgenda, cdEstabelecimento, cdPessoaFisica e nrSeqProcInterno) são obrigatórios. ieLado e ieTurno são opcionais e servem para filtrar lateralidade (E/D/A) e turno (M/T/N).

📌 Endpoint

GET /api/v1/agendamentos/slots-livres

🔐 Autenticação

Este endpoint requer um token de autorização.

Authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO

🔽 Cabeçalhos

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

🔽 Parâmetros de Entrada (query string)

Nome	Tipo	Obrigatório	Descrição
dtAgenda	date	Sim	Data (formato yyyy-MM-dd) para a qual os slots livres serão consultados.
cdEstabelecimento	int	Sim	Código da unidade (Tasy) onde o exame será agendado.
cdPessoaFisica	long	Sim	Identificador interno do beneficiário no Tasy.
nrSeqProcInterno	long	Sim	Código do procedimento interno (exame) no Tasy.
ieLado	string	Não	Lateralidade desejada: E (esquerdo), D (direito) ou A (ambos). Quando o exame exige lateralidade, informar esse campo garante o cálculo correto da duração.
ieTurno	string	Não	Turno preferido: M (manhã), T (tarde) ou N (noite). Se omitido, retorna slots de todos os turnos.

Caso algum parâmetro obrigatório não seja informado, a API responde com HTTP 400 (Bad Request) e uma mensagem clara indicando as validações violadas.

🔄 Exemplo de Requisição

🔹 Ambiente de homologação

curl -X 'GET' \
  'https://integracao.hml.cloud.medsenior.com.br/api/v1/agendamentos/exames/slots-livres?dtAgenda=2025-12-10&cdEstabelecimento=104&cdPessoaFisica=123456&nrSeqProcInterno=987654&ieLado=A&ieTurno=M' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO' \
  -H 'content-type: application/json'

🔹 Ambiente de produção

curl -X 'GET' \
  'https://integracao.medsenior.com.br/api/v1/agendamentos/exames/slots-livres?dtAgenda=2025-12-10&cdEstabelecimento=104&cdPessoaFisica=123456&nrSeqProcInterno=987654&ieLado=A&ieTurno=M' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO' \
  -H 'content-type: application/json'

✅ Resposta de Sucesso

• Status Code: 200 OK
• Exemplo de Resposta:

{
  "REF_CURSOR_P": [
    {
      "NR_SEQ_AGENDA": 456789,
      "CD_AGENDA": 112233,
      "DT_AGENDA": "10/12/2025",
      "HR_INICIO": "09:30",
      "NR_SEQ_PROC_INTERNO": 987654,
      "NR_MIN_DURACAO": 30
    },
    {
      "NR_SEQ_AGENDA": 456790,
      "CD_AGENDA": 112233,
      "DT_AGENDA": "10/12/2025",
      "HR_INICIO": "10:00",
      "NR_SEQ_PROC_INTERNO": 987654,
      "NR_MIN_DURACAO": 30
    }
  ],
  "CODIGO_P": "0",
  "MENSAGEM_P": "Consulta realizada!"
}

ℹ️ Observações de negócio

• O serviço considera agendas futuras do beneficiário para evitar conflitos e só retorna horários realmente disponíveis.
• A duração (NR_MIN_DURACAO) respeita o tempo específico do exame; se ele exigir múltiplos slots, somente horários compatíveis são listados.
• Quando o exame exige lateralidade, informe ieLado para que a procedure aplique as regras de tempo corretas (inclusive exames bilaterais).
• Caso nenhum slot seja encontrado, REF_CURSOR_P virá vazio, porém CODIGO_P continuará como "0" com mensagem Consulta realizada!.
• Situações de erro interno no Tasy retornam CODIGO_P = "9" e MENSAGEM_P com o SQLERRM. Utilize essas informações para rastrear a falha.

❌ Códigos de Erro

Status Code	Significado	Descrição
400	Bad Request	Parâmetros obrigatórios ausentes ou valores inválidos para lateralidade/turno.
401	Unauthorized	Falha na autenticação do token.
404	Not Found	Nenhum resultado foi encontrado para os filtros informados (comportamento opcional).
500	Server Error	Erro interno ou indisponibilidade do Tasy (ver CODIGO_P e MENSAGEM_P).