1. Acesse o menu Envio de Requisições para HUB de Guias (hat.sendGuidesHub), informe os parâmetros conforme necessário e execute:

2. Será criado um pedido no RPW para processar a seleção e realizar o envio das guias, podendo ser acompanhado através do Monitor Pedidos Execução (pedido-execucao-monitor).

3. Após a execução do pedido no RPW, serão gerados relatórios de acompanhamento e erros na Central de Documentos no formato: "HUB_GUIAS_" + "Número do pedido no RPW" + ".zip"

• Operações: Executar procedimento.
• Objetivo: Enviar requisição para realizar a execução/baixa de procedimentos de uma determinada guia.

1. Acesse o menu Envio de Execução de Procedimentos para HUB de Guias (hat.sendExecutionHub), informe os parâmetros conforme necessário e execute:

2. Será criado um pedido no RPW para processar a seleção e realizar o Envio da execução/baixa de procedimentos para o HUB de Guias.

•  Pode ser acompanhado através do Monitor Pedidos Execução (pedido-execucao-monitor). 
  Exemplo:
  

3. Após a execução do pedido no RPW, serão gerados relatórios de acompanhamento e erros na Central de Documentos no formato: "HUB_GUIAS_" + "Número do pedido no RPW" + ".zip"

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: Exemplo de URL para chamada: http://servidor:porta/dts/datasul-rest/resources/prg/hat/v1/hubGuides/baixaProcedimento

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
		}
	]
}

Baixa/Execução de Procedimento

Essa API recebe um JSON contendo um objeto que é a guia, seus dados e os procedimentos que foram executados.

{
	"numero_guia": "{{guia}}",
	"cooperativa_solicitante": "0029",
	"numero_guia_executora": "21312",
	"cooperativa_executante": "0971",
	"procedimentos": [
		{
			"sequencia_item": 1,
			"codigo_tuss": 10101012,
			"dados_laboratorio": {
				"nome": "Teste",
				"cnpj": "00.000.000/0000-00",
				"telefone": "(54) 1234-5678",
				"endereco": "Rua Endereço, Endereço - RS"
			}
		}
	]
}

Exemplo de retorno de sucesso:

{
    "sucess": true,
    "message": ""
}

Exemplo de retorno com dado vazio ou tag mandatória inexistente:

{
    "error": "Dados fornecidos invalidos",
    "errors": {
        "numero_guia": [
            "Campo numero guia invalido."
        ]
    }
}

Acesse o menu Consulta 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.

Após receber uma execução de procedimento do Hub de Guias, será possível consultar essas execuções através do menu Histórico de Execuções de Procedimentos do Hub (hat.hubExecutionHistor).

O filtro dessa tela é através do número de guia da unidade solicitante, sendo possível realizar uma pesquisa aberta por todas as execuções recebidas:

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;