Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


01. DADOS GERAIS

Produto:

TOTVS Saúde Planos

Linha de Produto:

Linha Datasul

Segmento:

Saúde

Módulo:

HAT - Atendimento ao Público

Função:

                  

RotinaFunção
Central de Integrações Saúde Planoshgp.integrationsParams
Central Hub de Guiashat.hubGuidesCentral
Envio de Requisições para o
HUB
Hub de Guiashat.sendGuidesHub
Envio de Execuções para o Hub de Guiashat.sendExecutionHub
Consulta de Guias
HUB
do Hubhat.hubGuides
Histórico de Execuções de Procedimentos do Hubhat.hubExecutionHistor

                  

País:Brasil
Requisito:

DSAUGPSAUTOR-18013


02. SITUAÇÃO/REQUISITO


03. SOLUÇÃO

...

Totvs custom tabs box
tabsProcedimento para Implantação, Procedimento para Configuração, Procedimento para Utilização
idspasso1,passo2,passo3
Totvs custom tabs box items
defaultyes
referenciapasso1

1. Acesse o menu Importação Menu Datasul (men706aa) e importe o arquivo men_hat.d.

2. Acesse o menu Programa Produto Datasul (bas_prog_dtsul) e altere os registros "hat.sendGuidesHubParams", "hat.hubGuidesCentral", "hat.sendGuidesHub", "hat.sendGuidesHubParamssendExecutionHub" , "hat.hubGuides" e "hat.hubExecutionHistor" para liberar as permissões de acesso:

  • hat.sendGuidesHubParams - Tela de parâmetros do HUB de Guias
  • hat.hubGuidesCentral - Tela centralizadora dos menus do HUB de Guias (disponível a partir do patch de 26/08/2024 - 12.1.2407-3, 12.1.2403-9 e 12.1.2311-14)
  • hat.sendGuidesHub - Tela de sendGuidesHub - Tela de agendamento/envio das requisições para o HUB de Guias
  • hat.sendExecutionHub - Tela de agendamento/envio da execução de procedimentos para o HUB de Guias
  • hat.hubGuides - Tela para consulta hubGuides - Tela para consulta e importação das guias do HUB
  • hat.hubExecutionHistor - Tela de consulta das execuções de procedimentos do HUB

3. Acesse o menu Atualiza Menu Usuário (mer010aa) e execute a atualização.

  • Será disponibilizado o "Envio de Requisições para o HUB de Guias" no menuSerão disponibilizados os itens de menu conforme listagem acima

4. Importe o Certificado para acesso à API do HUB.

  • Para realizar a integração é necessário realizar a importação do certificado https.
  • Deve ser copiado o arquivo dc4d6a89.0 em anexo para a pasta "/certs" da instalação do Progress que é utilizada pelo AppServer/PASOE do ERP.

View file
namedc4d6a89.0
height150

  • Alternativamente, pode ser exportado o certificado diretamente pelo navegador acessando o endpoint do serviço e importando-o para o Progress através do comando certutil -import do proenv.
Totvs custom tabs box items
defaultno
referenciapasso2

1. Acesse o menu Central de Integrações Saúde Planos (hgp.integrationsParams) e no sub-menu "HUB de Guias" ative a integração: 

Âncora
Passo2
Passo2

Informações

Detalhes do programa na documentação: Central de Integrações Saúde Planos (hgp.integrationsParams)

Image RemovedImage Added


2. Informe uma data de início para o envio das guias.

Aviso
  • O envio só será realizado quando a integração estiver ativa e demais parâmetros preenchidos.
  • Só serão consideradas as guias com data de emissão entre a "Data de inicio do envio de guias" da tela de parâmetros e "Guias criadas até" da tela de envio (cfe. detalhado na aba Procedimento para Utilização).

3. Informe os dados de acesso e os endpoints do serviço:

Endpoint de autenticação

Endpoint de inclusão de guias

Endpoint de envio de execução

Endpoint de busca por guia

Endpoint de busca por carteira

4. Informe o "Tipo de guia" que será utilizado na criação automática da Guia. É necessário que seja uma tipo de guia de SADT(Exames).
Só é permitido a seleção de 1 tipo de guia.

Totvs custom tabs box items
defaultno
referenciapasso3
Totvs custom tabs box
tabsIncluir Enviar Guias no HUB,Consulta de Dados pelo HUB,Consulta de Guias no para o HUB,Enviar Execuções para o HUB,Receber Informações do HUB,Consultar Guias do HUB,Consultar Execuções do HUB,Autorizador Web, Histórico de Execuções de Procedimentos
idsenvio,baixaproced,consulta,consultaHub,historicoExec,autorizador,historicoExec
Totvs custom tabs box items
defaultyes
referenciaenvio

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

Informações

Detalhes do programa na documentação: Envio de Requisições para o HUB de Guias - RPW - hat.sendGuidesHub

Image Removed

A partir do patch de 26/08/2024 (12.1.2407-3, 12.1.2403-9 e 12.1.2311-14), esse programa deve ser acessado através do menu Central Hub de Guias (hat.hubGuidesCentral)

Image Added
















2. Será criado um 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"

Informações
  • Erros de integração serão apresentados no relatório de erros.
    • Caso não existam guias a serem enviadas, quando executado será apresentado no relatório de erros a mensagem de "Nenhuma guia pendente de envio encontrada com o filtro informado".
  • Guias enviadas com sucesso serão apresentadas no relatório de acompanhamento.
    • Guias enviadas com sucesso não serão reprocessadas em execuções posteriores.
Totvs custom tabs box items
defaultno
referenciaconsultabaixaproced
  • 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:

Informações

Detalhes do programa na documentação: Envio de Execução de Procedimentos para o HUB de Guias - RPW - hat.sendExecutionHub

A partir do patch de 26/08/2024 (12.1.2407-3, 12.1.2403-9 e 12.1.2311-14), esse programa deve ser acessado através do menu Central Hub de Guias (hat.hubGuidesCentral)

Image Added




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:
    Image Added

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"

Informações
  • Erros de integração serão apresentados no relatório de erros.
    • Caso não existam guias a serem enviadas, quando executado será apresentado no relatório de erros a mensagem de "Nenhuma guia pendente de envio encontrada com o filtro informado".
  • Guias enviadas com sucesso serão apresentadas no relatório de acompanhamento.
    • Guias enviadas com sucesso não serão reprocessadas em execuções posteriores.
{ "error": "Dados fornecidos invalidos", "errors": { "numero_guia": [ "Campo numero guia invalido." ] } }
Totvs custom tabs box items
defaultno
referenciaconsulta

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

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.


Image Added


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


Informações

Cada Unimed deverá configurar suas informações de autenticação e URL da API diretamente no HUB.

Linke de homologação: https://hubguiasteste.unimedrs.com.br/configuracoes


Consulta de dados completos da guia

Image Added

Essa API recebe um JSON contendo um array de guias a serem consultadas. Exemplo:

Bloco de código
{
	"guias": [
		"202400000001",
        "202400000002",
        "202400000003",
        "202400000004"
	]
}

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

Bloco de código
{
	"data": [
		{
			"beneficiario_numero_carteira": "01200001000000084",
			"numero_guia": "202400000002",
			"prestador_solicitante_conselho": "CRM",
			"beneficiario_nome": "BENEFICIARIO",
			"carater_atendimento": "E",
			"prestador_solicitante_conselho_codigo": 120319212

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

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.

Image Removed

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
Informações

Cada Unimed deverá configurar suas informações de autenticação e URL da API diretamente no HUB.

Linke de homologação: https://hubguiasteste.unimedrs.com.br/configuracoes

Consulta de dados completos da guia

Image Removed

Essa API recebe um JSON contendo um array de guias a serem consultadas. Exemplo:

Bloco de código
{
	"guias": [
		"202400000001",
        "202400000002",
        "202400000003",
        "202400000004"
	]
}

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

Bloco de código
{
	"data": [
		{
			"beneficiario_numero_carteira": "01200001000000084",
			"numero_guia": "202400000002",
			"prestador_solicitante_conselho_uf": "CRMRS",
			"beneficiario_validade_nomecarteira": "BENEFICIARIO9999-12-31",
			"caraterindicacao_atendimentoclinica": "EINFORMANDO A INDICAÇÃO CLINICA DA GUIA",
			"prestador_solicitante_conselho_codigoobservacoes": 120319212 "INFORMANDO AS OBSERVAÇÕES DA GUIA",
			"prestador_solicitante_conselho_ufnome": "RSPROFISSIONAL SOLICITANTE DA GUIA",
			"beneficiariocooperativa_validadesolicitante_carteiracodigo": "9999-12-31"120,
			"indicacaodata_clinicasolicitacao": "INFORMANDO A INDICAÇÃO CLINICA DA GUIA2024-01-02",
			"observacoesprocedimentos": "INFORMANDO AS OBSERVAÇÕES DA GUIA", [
				{
					"prestadorqtde_solicitante_nomesolicitado": "PROFISSIONAL SOLICITANTE DA GUIA"1,
					"cooperativaservico_solicitante_codigo": 12020010010,
					"dataservico_solicitacaodescricao": "2024-01-02ELETROCARDIOGRAMA",
					"procedimentosstatus_procedimento_id": [2,
				{	"sequencia_item": 1,
					"qtde_solicitadoautorizado": 1,
					"servicodata_codigoexecucao": 20010010,null
				}
			],
			"servicobeneficiario_descricaosexo": "ELETROCARDIOGRAMAM",
			"beneficiario_cpf": "",
			"statusid_procedimento_idrn": 2"N",
					"sequenciasenha_itemautorizacao": 1"",
					"qtdedata_autorizadovalidade": 1"2024-02-01",
					"beneficiario_data_execucaonascimento": null
				}
			]"1952-01-01",
			"beneficiariodata_sexocancelamento": "M"null,
			"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

Image Removed

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

Bloco de código
{
	"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:

Bloco de código
{
    "sucess": true,
    "message": ""
}

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

Bloco de código
status": 1
		}
	]
}

Baixa/Execução de Procedimento

Image Added

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

Bloco de código
{
	"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:

Bloco de código
{
    "sucess": true,
    "message": ""
}

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

Bloco de código
{
    "error": "Dados fornecidos invalidos",
    "errors": {
        "numero_guia": [
            "Campo numero guia invalido."
        ]
    }
}
Totvs custom tabs box items
defaultno
referenciaconsultaHub

Acesse o menu Consulta Guias HUB (hat.hubGuide):

Informações

Detalhes do programa na documentação: Consulta Guias HUB - hat.hubGuide

A partir do patch de 26/08/2024 (12.1.2407-3, 12.1.2403-9 e 12.1.2311-14), esse programa deve ser acessado através do menu Central Hub de Guias (hat.hubGuidesCentral)

É 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.

Image Added

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

Totvs custom tabs box items
defaultno
referenciaconsultaHubhistoricoExec

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 Acesse o menu Manutenção Guias HUB  (hat.hubGuidehubExecutionHistor):.

Informações

Detalhes do programa na documentação: 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.

Image Removed

A partir do patch de 26/08/2024 (12.1.2407-3, 12.1.2403-9 e 12.1.2311-14), esse programa deve ser acessado através do menu Central Hub de Guias (hat.hubGuidesCentral)

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:

Image AddedA guia importada ficará como digitada para ajuste de dados.


Totvs custom tabs box items
defaultno
referenciaautorizador

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.

Image Removed

Image Removed

    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;

Image Removed

Image Added

Image Added


    4.3 Carregar Guia.1. Exportar CSV 

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

Image Removed

Totvs custom tabs box items
defaultno
referenciahistoricoExec

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;

Image Added

   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;

Image Added

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 solicitante, sendo possível realizar uma pesquisa aberta por todas as exexecuções recebidas:

Image Removed




Templatedocumentos