Histórico da Página

...

Totvs custom tabs box

tabs	Procedimento para Implantação, Procedimento para Configuração, Procedimento para Utilização
ids	passo1,passo2,passo3

Totvs custom tabs box items

default	yes
referencia	passo1

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.sendGuidesHub" e "hat.sendGuidesHubParams" para liberar as permissões de acesso

hat.sendGuidesHubParams - Tela de parâmetros do HUB de Guias
hat.sendGuidesHub - Tela de agendamento/envio das requisições para o HUB de Guias

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 menu

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 68277db4.0 para a pasta "/certs" da instalação do Progress que é utilizada pelo AppServer/PASOE do ERP.

View file

name	68277db4.0
height	150

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

default	no
referencia	passo2

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

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

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

Homologação: https://apiguiashml.unimedrs.com.br/login
Produção: https://apiguias.unimedrs.com.br/login

Endpoint de inclusão de guias

Homologação: https://apiguiashml.unimedrs.com.br/guias/store
Produção: https://apiguias.unimedrs.com.br/guias/store

Totvs custom tabs box items

default	no
referencia	passo3

Totvs custom tabs box

tabs	Incluir Guias no HUB,Operações realizadas a partir do HUB
ids	envio,consulta

Totvs custom tabs box items

default	yes
referencia	envio

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

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

default	no
referencia	consulta

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

O consumo da API 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 URL para chamada da API: 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 seu suas informações de autenticação e URL da API diretamente no HUB.

Consulta de dados completos da guia

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

Exemplo:

Bloco de código
{ "guias": [ "202300002382", "202300002383", "202300002384", "202300002385" ] }

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

...

Árvore de páginas

Versões comparadas

Versão antiga 25

Nova versão 26

Chave