Linha Datasul

Árvore de páginas


01. DADOS GERAIS


Produto:TOTVS Saúde Planos
Linha de Produto:Linha Datasul
Segmento:Saúde
Módulo:HVP
Função:Atualização Cartão Nacional de Saúde (CNS) - RPW (hvp.datasus)
País:Brasil
Ticket:17999307



02. SITUAÇÃO/REQUISITO

É necessário atualizar o serviço de integração com o Datasus para o novo formato disponibilizado pelo ministério da saúde.

03. SOLUÇÃO

Foi realizado o ajuste da rotina de integração com o Datasus, visando consumir o novo serviço REST disponibilizado pelo ministério da saúde.


Alteração do programa Manutenção Parâmetros Venda de Planos/Manutenção de Contratos (hvp.vpSettings)

No programa Manutenção Parâmetros Venda de Planos/Manutenção de Contratos (hvp.vpSettings) foram adicionados os campos para a parametrização da conexão com o serviço do Datasus:

    • URL Token: Informar a URL do serviço do Datasus para obtenção do token para conexão ao serviço:
      • Para o ambiente de homologação, a ANS disponibilizou a URL https://ehr-auth-hmg.saude.gov.br/api/osb/token; 
      • Para o ambiente de produção, a ANS disponibilizou a URL https://ehr-auth.saude.gov.br/api/osb/token;
    • URL Consulta: Informar a URL do serviço do Datasus para a pesquisa do CNS do beneficiário:
      • Para o ambiente de homologação, a ANS disponibilizou a URL https://servicoshm.saude.gov.br/cadsus/v2/pesquisaCns;
      • Para o ambiente de produção, a ANS disponibilizou a URL https://servicos.saude.gov.br/cadsus/v2/pesquisaCns;


Alteração do programa Atualização Cartão Nacional de Saúde (CNS) - RPW (hvp.datasus)

Na área da tela denominada Dados para busca do CNS, foram removidos os campos que eram utilizados no serviço descontinuado pela ministério da saúde:

    • CPF
    • Nome
    • Nome da mãe
    • Data de nascimento
    • Sexo

Foi adicionado o campo Consulta por, com as seguintes opções:

    • CPF: Ao selecionar essa opção, a busca do CNS no serviço do Datasus será realizada pelo CPF do beneficiário;
    • Nome - Nome da mãe - Data de Nascimento: Essa opção permite a busca do CNS no serviço do Datasus através do nome do beneficiário, nome da mãe e data de nascimento.


04. PROCEDIMENTOS PARA IMPLANTAÇÃO

Ao atualizar o pacote contendo as alterações descritas neste documento, o servidor de aplicação Tomcat do cliente será atualizado com o artefato totvs-hgp-webservices.war. Este artefato contém o serviço responsável por realizar a comunicação com o serviço do Datasus. A criação deste serviço externo foi necessária em virtude de o novo serviço do Datasus exigir a autenticação com certificado digital. A seguir estão descritos os passos necessários para a configuração deste serviço.

Inicialmente, é necessário que o cliente obtenha o certificado digital para a autenticação. O passo a passo para obtenção deste arquivo está descrito no seguinte endereço, disponibilizado pelo ministério da saúde: https://servicos-datasus.saude.gov.br/detalhe/5HZZEZ4I8y.

É necessário parametrizar as variáveis de ambiente abaixo no arquivo de inicialização do Tomcat ou no sistema operacional:

    • TOTVS_DATASUS_JKS_FILE: Informar o caminho onde está armazenado o arquivo .pfx ou .jks referente ao certificado digital;
    • TOTVS_DATASUS_JKS_PASS: Informar a senha do certificado digital.

Exemplo de configuração:


Após realizar os passos descritos acima, o servidor de aplicação Tomcat pode ser iniciado.

Para a validação do serviço descrito nesta seção, disponibilizamos a coleção a seguir, que realiza a comunicação com o serviço de homologação do Datasus. 

Consulta CNS - Datasus.postman_collection.json

A coleção deve ser importada no Postman, está composta por duas requisições: uma que realiza a pesquisa por CPF e outra que realiza a pesquisa por nome, nome da mãe e data de nascimento do beneficiário.

Para o correto funcionamento das requisições, é necessário alterar o host e porta da URL.


Links relacionados

Manutenção Parâmetros Venda de Planos/Manutenção de Cadastro (hvp.vpSettings)

Atualização CNS com o Webservice Datasus (hvp.datasus)