DT Integração com o HUB de Guias Eletrônicas

Foi realizada a criação da API hat/v1/hubGuides, responsável por receber as requisições enviadas pelo HUB.

O consumo segue o padrão de API's Datasul e mais informações podem ser verificadas na página: Consumindo API do TOTVS Saúde Planos - Linha Datasul

Exemplo de configurações na Interface do HUB de Guias

Tipo de autenticação - BASIC Consumindo API do TOTVS Saúde Planos - Linha Datasul: Para que seja possível realizar uma chamada externa para uma API do TOTVS é necessário realizar a autenticação com um usuário válida. Para isso deve ser utilizado o processo de Basic Authentication informando o nome e senha do usuário.

Token basic - Usuário e senha do sistema criptografado, conforme exemplo abaixo:

URL de obtenção de guias: Exemplo de URL para chamada: http://servidor:porta/dts/datasul-rest/resources/prg/hat/v1/hubGuides/consultaDadosGuia

URL de baixa das guias: Ainda não disponível

Exemplo do token basic:

Exemplo de URL para chamada: http://servidor:porta/dts/datasul-rest/resources/prg/hat/v1/hubGuides/consultaDadosGuia

• Deve ser substituído o "servidor" e "porta" conforme seu ambiente
• O método http para requisição deve ser POST

Consulta de dados completos da guia

Essa API recebe um JSON contendo um array de guias a serem consultadas;

Exemplo:

{
	"guias": [
		"202400000001",
        "202400000002",
        "202400000003",
        "202400000004"
	]
}

E retorna como resultado os dados das guias conforme estrutura do Manual de Integração Técnica.

Exemplo:

{
	"data": [
		{
			"beneficiario_numero_carteira": "01200001000000084",
			"numero_guia": "202400000002",
			"prestador_solicitante_conselho": "CRM",
			"beneficiario_nome": "BENEFICIARIO",
			"carater_atendimento": "E",
			"prestador_solicitante_conselho_codigo": 120319212,
			"prestador_solicitante_conselho_uf": "RS",
			"beneficiario_validade_carteira": "9999-12-31",
			"indicacao_clinica": "INFORMANDO A INDICAÇÃO CLINICA DA GUIA",
			"observacoes": "INFORMANDO AS OBSERVAÇÕES DA GUIA",
			"prestador_solicitante_nome": "PROFISSIONAL SOLICITANTE DA GUIA",
			"cooperativa_solicitante_codigo": 120,
			"data_solicitacao": "2024-01-02",
			"procedimentos": [
				{
					"qtde_solicitado": 1,
					"servico_codigo": 20010010,
					"servico_descricao": "ELETROCARDIOGRAMA",
					"status_procedimento_id": 2,
					"sequencia_item": 1,
					"qtde_autorizado": 1,
					"data_execucao": null
				}
			],
			"beneficiario_sexo": "M",
			"beneficiario_cpf": "",
			"id_rn": "N",
			"senha_autorizacao": "",
			"data_validade": "2024-02-01",
			"beneficiario_data_nascimento": "1952-01-01",
			"data_cancelamento": null,
			"status": 1
		}
	]
}

1. Acesse o menu Manutenção Guias HUB (hat.hubGuide):

É possível realizar operações como consultar as guias informando a Unidade e a Guia ou Carteira do beneficiário ou importar para o Sistema.

A guia importada ficará como digitada para ajuste de dados.

1. Para utilização no Autorizador é necessário a seguinte parametrização:

1.1. Ativar a integração com o HUB conforme Procedimento para Configuração;

1.2 Ativar parametrização Prestador x Clinica na aba Informações Adicional (hac.clinicalProvider) campo Consulta HUB:

2. Acesse o Checkin do Autorizador e informar a carteira do beneficiário:

3. Clicar no ícone de "Visualizar guias do HUB" .

4. Serão apresentadas as opções Exportar CSV, Carregar Guia e Detalhar a guia. Ao posicionar o ponteiro do mouse por cima da guia será apresentado os movimentos da guia.

    4.1. Exportar CSV 

        Exportar CSV irá exportar em um arquivo .csv todos os dados das guias listadas;

    4.2. Detalhar Guia

 Irá carregar os dados da guia selecionado;

   4.3 Carregar Guia

           Irá carregar os dados da guia selecionada e poderá ser solicitado no sistema , seguindo o processo de solicitação de exames;