Árvore de páginas

Versões comparadas

Chave

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

...

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.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
name68277db4.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:

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

Endpoint de inclusão de guias

Totvs custom tabs box items
defaultno
referenciapasso3
Totvs custom tabs box
tabsIncluir Guias no HUB,Operações realizadas a partir do Consulta de Dados pelo HUB
idsenvio,consulta
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
















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


Consulta de dados completos da guia

Essa API recebe um JSON contendo um array 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
		}
	]
}

...