Obter cardápio no Tasy

🌐 URLs dos Ambientes

🔹 Homologação

https://integracao.hml.cloud.medsenior.com.br/api/v1/agendamentos/cardapio?uf={{uf}}&cdEstabelecimento={{cdEstabelecimento}}&cdProcedimentoTuss={{cdProcedimentoTuss}}

🔹 Produção

https://integracao.medsenior.com.br/api/v1/agendamentos/cardapio?uf={{uf}}&cdEstabelecimento={{cdEstabelecimento}}&cdProcedimentoTuss={{cdProcedimentoTuss}}

O preenchimento dos parâmetros na URL é opcional, porém recomenda-se informar pelo menos um filtro (UF, estabelecimento ou procedimento TUSS) para reduzir o volume de dados retornado.

📌 Endpoint

GET /api/v1/agendamentos/cardapio

🔐 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
uf	string	Não	Sigla da UF vinculada às unidades de atendimento da MedSênior.
cdEstabelecimento	int	Não	Código do estabelecimento (unidade Tasy). Utilize para filtrar uma unidade específica.
cdProcedimentoTuss	long	Não	Código TUSS do procedimento interno. Útil para filtrar um exame específico.

Pelo menos um parâmetro deve ser informado para que a aplicação aceite a consulta.

🔄 Exemplo de Requisição

🔹 Ambiente de homologação

curl -X 'GET' \
'https://integracao.hml.cloud.medsenior.com.br/api/v1/agendamentos/exames/cardapio?uf=ES&cdEstabelecimento=104&cdProcedimentoTuss=40801095' \
-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/cardapio?uf=ES&cdEstabelecimento=104&cdProcedimentoTuss=40801095' \
-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_PROC_INTERNO": 123456,
      "DS_PROCEDIMENTO": "Ultrassonografia de Abdômen",
      "CLASSIFICACAO": "ULTRA SONOGRAFIA",
      "CD_PROCEDIMENTO_TUSS": 40801095,
      "DS_PROCEDIMENTO_TUSS": "USG Abdômen total",
      "IE_EXIGE_LADO": "N",
      "CD_ESTABELECIMENTO": 104,
      "DS_ESTABELECIMENTO": "Unidade Vitória",
      "DS_LOCALIZACAO": "Av. Dante Michelini, 435 - Praia do Canto - Vitória, ES",
      "UF": "ES",
      "DS_ORIENTACAO_PROC": "Jejum de 6 horas."
    }
  ],
  "CODIGO_P": "0",
  "MENSAGEM_P": "Consulta realizada!"
}

ℹ️ Observações de negócio

• Apenas exames classificados como SADT e com agendas ativas/turnos vigentes são retornados pela procedure API_MS_JORNADA_DIG_PCK.MS_CARDAPIO_EXAMES.
• O campo IE_EXIGE_LADO indica se o exame exige a definição de lateralidade (S ou N). Quando S, as próximas etapas do fluxo de agendamento devem solicitar “Lado esquerdo”, “Lado direito” ou “Ambos”.
• Utilize CD_ESTABELECIMENTO e UF retornados para compor chamadas posteriores ao calendário (MS_CALENDARIO_EXAME) e slots livres (MS_BUSCAR_SLOTS_LIVRES).

❌ Códigos de Erro

Status Code	Significado	Descrição
400	Bad Request	Nenhum parâmetro válido informado ou validações de entrada falharam.
401	Unauthorized	Falha na autenticação do token.
404	Not Found	Não há exames para os filtros informados.
500	Server Error	Erro interno ao consultar a procedure no Tasy.