Obter calendário no Tasy

🌐 URLs dos Ambientes

🔹 Homologação

https://integracao.hml.cloud.medsenior.com.br/api/v1/agendamentos/calendario?dtReferencia={{dtReferencia}}&uf={{uf}}&cdPessoaFisica={{cdPessoaFisica}}&nrSeqProcInterno={{nrSeqProcInterno}}&cdEstabelecimento={{cdEstabelecimento}}&ieLado={{ieLado}}&ieTurno={{ieTurno}}

🔹 Produção

https://integracao.medsenior.com.br/api/v1/agendamentos/calendario?dtReferencia={{dtReferencia}}&uf={{uf}}&cdPessoaFisica={{cdPessoaFisica}}&nrSeqProcInterno={{nrSeqProcInterno}}&cdEstabelecimento={{cdEstabelecimento}}&ieLado={{ieLado}}&ieTurno={{ieTurno}}

dtReferencia deve apontar para o primeiro dia do mês desejado (formato yyyy-MM-dd). O serviço buscará automaticamente até o último dia do mesmo mês.

📌 Endpoint

GET /api/v1/agendamentos/calendario

🔐 Autenticação

Este endpoint requer token válido (mesmos perfis do grupo de agendamentos).

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
dtReferencia	date	Sim	Primeiro dia do mês desejado (yyyy-MM-dd). Internamente o sistema busca até o último dia do mesmo mês.
uf	string	Sim	Sigla da UF vinculada às unidades de atendimento.
cdPessoaFisica	long	Sim	Identificador interno do beneficiário no Tasy.
nrSeqProcInterno	long	Sim	Código do procedimento interno (exame) no Tasy.
cdEstabelecimento	int	Não	Código da unidade. Quando informado, limita o calendário a um estabelecimento específico.
ieLado	string	Não	Lateralidade exigida: E, D ou A. Quando informado, só retorna slots compatíveis.
ieTurno	string	Não	Preferência de turno: M (manhã), T (tarde) ou N (noite). Se omitido, considera todos os turnos.

Todas as combinações opcionais respeitam as regras do Tasy: lateralidade exige exames parametrizados como bilaterais e turnos respeitam agendas vigentes.

🔄 Exemplo de Requisição

🔹 Homologação

curl -X 'GET' \
  'https://integracao.hml.cloud.medsenior.com.br/api/v1/agendamentos/exames/calendario?dtReferencia=2025-12-01&uf=ES&cdPessoaFisica=123456&nrSeqProcInterno=78910&cdEstabelecimento=104&ieTurno=M' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO'

🔹 Produção

curl -X 'GET' \
  'https://integracao.medsenior.com.br/api/v1/agendamentos/exames/calendario?dtReferencia=2025-12-01&uf=ES&cdPessoaFisica=123456&nrSeqProcInterno=78910' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer TOKEN_GERADO_NA_AUTENTICACAO'

✅ Resposta de Sucesso

• Status Code: 200 OK
• Exemplo de Resposta:

{
  "REF_CURSOR_P": [
    {
      "CD_ESTABELECIMENTO": 104,
      "DS_ESTABELECIMENTO": "Unidade Vitória",
      "NR_SEQ_PROC_INTERNO": 78910,
      "DURACAO_EXAME_MIN": 30,
      "DT_AGENDA": "05/12/2025",
      "PRIMEIRO_HORARIO": "08:00",
      "NR_SEQ_AGENDA": 456789,
      "QTD_SLOTS_DIA": 4
    }
  ],
  "CODIGO_P": "0",
  "MENSAGEM_P": "Consulta realizada!"
}

ℹ️ Observações de negócio

• A procedure API_MS_JORNADA_DIG_PCK.MS_CALENDARIO_EXAME já considera conflitos com agendas existentes, prioridade de exames e duração específica do procedimento.
• Utilize DT_AGENDA, NR_SEQ_AGENDA e DURACAO_EXAME_MIN nas chamadas subsequentes (MS_BUSCAR_SLOTS_LIVRES, MS_RESERVAR_SLOT_EXAME e MS_MARCAR_EXAME).
• Quando cdEstabelecimento, ieLado ou ieTurno forem informados, apenas os slots compatíveis são listados.

❌ Códigos de Erro

Status Code	Significado	Descrição
400	Bad Request	Parâmetros obrigatórios ausentes ou inválidos (dtReferencia, uf, etc).
404	Not Found	Nenhum dia do mês possui slots livres para os filtros informados.
500	Server Error	Falha ao executar a procedure; CODIGO_P = "9" retorna o SQLERRM.