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.

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;

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: