Integração Solus x CADSUS
Sumário
Módulo para publicação: Estrutural > Cadastros (Estrutural)
| Painel |
|---|
| borderColor | grey |
|---|
| titleColor | White |
|---|
| borderWidth | 1px |
|---|
| titleBGColor | #B4044A |
|---|
| title | Objetivo |
|---|
| Neste manual, será explicado com realizar a configuração da integração do Solus com o CADSUS e utilizá-la para complementar o cadastro dos beneficiários. Voltar ao início |
| Âncora |
|---|
| Funcionalidade |
|---|
| Funcionalidade |
|---|
|
| Painel |
|---|
| borderColor | grey |
|---|
| titleColor | White |
|---|
| borderWidth | 1 px |
|---|
| titleBGColor | #B4044A |
|---|
| title | Funcionalidade |
|---|
|
Voltar ao início |
| Painel |
|---|
| borderColor | grey |
|---|
| titleColor | White |
|---|
| titleBGColor | #B4044A |
|---|
| title | Configurações, Parâmetros e/ou Permissões de direitos |
|---|
| | Painel |
|---|
| | Painel |
|---|
| titleColor | White |
|---|
| titleBGColor | #013e61 |
|---|
| title | Configurações/Requisitos |
|---|
| Para utilizar a integração do Solus com o CADSUS, é preciso realizar algumas configurações com a API. Além disso, são necessárias credenciais que a Operadora deverá providenciar junto à ANS. A seguir, explicaremos cada configuração que devemos realizar para o uso correto da integração.
| Expandir |
|---|
| title | Configurar integração |
|---|
| Para configurar a integração do Solus com o CADSUS, é necessário acessar o módulo ADM > Configurações > Cadastro de integrações. Na tela que se abrirá, clique no botão incluir ( ) para criar um novo registro. O sistema mudará para a aba “Dados” para que o operador realize o preenchimento das informações corretas: 
Os seguintes campos precisarão ser informados: | Campo | Informação |
|---|
Nome | Identificação da API. Pode ser o nome que a Operadora desejar. | Descrição | Descrição da API. Pode ser cadastrada da maneira que a Operadora desejar. | URL | Informar o link para a consulta de serviço do CADSUS. O link varia dependendo da base que for utilizada. | Sistema origem | Indique a opção “INDEPENDENTE” | Situação | Selecione a opção “ATIVO” para que o sistema saiba que esta integração está ativa | Tipo | Como estamos configurando uma API, indique a opção “API” | Forma de envio | Indique a opção “Síncrona” | Fornecedor | Necessário colocar o fornecedor como “Solus” | Serviço | Indique o serviço como “Cadastro de Usuários do SUS - CADSUS” |
Ao concluir as configurações nesta aba, iremos mudar para a aba “1. Configurações API”, onde será necessário cadastrar mais informações: | Campo | Informação |
|---|
Tipo da autenticação | indique a opção “Configurável” | URL para geração do token autenticado | Informar o link para a geração do token. | Bloco “Configurações e acesso” | É necessário incluir as chaves (crt e key) e informar o certificado destas chaves: - crt: no campo “Chave” digite a informação “crt” e no campo “Valor”, indique o nome do arquivo do certificado, por exemplo “certificado.crt”
- key: no campo “Chave” digite a informação “key” e no campo “Valor”, indique o nome do arquivo do certificado, por exemplo “certificado.key”
|
| Nota |
|---|
Caso a operadora possua somente o certificado ".pfx" e não possua os arquivos ".crt" e ".key", descreveremos a seguir uma orientação para converter o certificado ".pfx" em ".crt" e ".key" |
| Aviso |
|---|
Ambas as chaves precisam ser cadastradas para que a integração funcione corretamente. |
|
| Expandir |
|---|
| title | Converter certificado .pfx em .crt e .key |
|---|
| Para conseguir converter o certificado .pfx em .crt e .key, existem alguns pré-requisitos: - O pacote OpenSSL deve estar instalado em seu sistema;
- É necessário ter o arquivo em .pfx para o nome de domínio escolhido;
- Sistema Windows/Ubuntu/Linux para utilizar o pacote OpenSSL com crt.
A seguir, vamos enumerar os passos para realizar a extração do arquivo:
Passo 1 – Extrair a chave privada (key) do arquivo .pfx: É necessário abrir o terminal da máquina (Prompt de comando) e apontá-lo para o diretório que o certificado se encontra e digitar o comando a seguir: | Bloco de código |
|---|
| openssl pkcs12 -in [nome_certificado].pfx -nocerts -out [nome_chave].key |
Este comando irá extrair a chave privada do arquivo .pfx.
| Nota |
|---|
Perceba que os termos [nome_certificado] e [nome_chave] estão em destaque com os colchetes. Estes termos devem ser substituídos pelo nome do seu arquivo .pfx e o nome do arquivo criptografado .key que você deseja extrair, respectivamente. |
Após inserir o comando anterior e apertar a tecla "Enter", o Prompt pedirá para o operador digitar a senha de importação do arquivo .pfx. Essa senha é usada para proteger o par de chaves criado para o certificado .pfx. Após digitar a senha de importação, o OpenSSL solicita que digite outra senha duas vezes. Essa nova senha é para proteger o arquivo .key
| Aviso |
|---|
Note que, quando você digitar a senha, você não consegue vê-la, mas ela está sendo digitada. Pressione "Enter" após inserir sua senha segura. |
Passo 2 – Extrair o arquivo .crt do certificado .pfx: Ainda com o Prompt de comando aberto, utilize o comando a seguir para extrair o certificado criptografado em .crt | Bloco de código |
|---|
| openssl pkcs12 -in [nome_certificado].pfx -clcerts -nokeys -out [nome_certificado_encrypted].crt |
| Nota |
|---|
Da mesma maneira que no passo anterior, os termos [nome_certificado] e [nome_certificado_encrypted] estão em destaque com os colchetes. Estes termos devem ser substituídos pelo nome do seu certificado .pfx e o nome do certificado .crt que você deseja extrair, respectivamente. |
Após inserir o comando e apertar a tecla “Enter”, é necessário dar uma senha para seu certificado e apertar “Enter” novamente. Seu certificado será extraído para o mesmo diretório.
Passo 3 - Extrair o arquivo .key da chave privada criptografada do Passo 1: No Prompt de comando apontado no diretório do certificado .pfx, utilize o comando a seguir para extrair o arquivo .key da chave criptografada criada no Passo 1 | Bloco de código |
|---|
| openssl rsa -in [nome_chave_encrypted].key -out [nome_chave].key |
| Nota |
|---|
Novamente, os termos [nome_certificado] e [nome_certificado_encrypted] destacados com o colchetes. Estes termos devem ser substituídos pelo nome do seu arquivo de chave extraído na etapa 1 e o nome do arquivo .key que você deseja extrair, respectivamente. |
Após executar o código, digite a senha de importação criada no passo 1. Agora temos um certificado (.crt) e as duas chaves privadas (criptografadas e não criptografadas).
Com os arquivos gerados, coloque-os no diretório dos arquivos da web \solusweb_3_0\integracao\certificados. |
|
|
Voltar ao início |
| Painel |
|---|
| borderColor | grey |
|---|
| titleColor | White |
|---|
| borderWidth | 1px |
|---|
| titleBGColor | #B4044A |
|---|
| title | Operacionalização |
|---|
| - Explique o recurso de forma operacional, ou seja, de como fazer para utilizá-lo.
Ex. Controle de um ar-condicionado: Para definir a temperatura que desejo, eu utilizo o botão TEMP que tem a opção "+" para aumentar a temperatura e a opção "-" para reduzi-la. Para definir a intensidade do vento, eu utilizo o botão FAN onde tenho a opção "+" para uma intensidade maior e a opção "-" para uma intensidade menor. - No caso de rotinas onde há abas, criar um Expandir para cada uma delas.
| Expandir |
|---|
| | Para alterar o nome do componente Expandir:
Ao clicar no nome do componente, serão habilitados dois botões no rodapé: "Alterar" e "Eliminar"; clique em "Alterar" e será exibida a tela para trocar o título.Criar novos Expandir
Ao clicar no nome do componente > pressionar ctrl + C para copiar, posteriormente pressionar ctrl + V para colar.O CADSUS tem a finalidade de auxiliar no cadastramento dos beneficiários das Operadoras de saúde, além de facilitar a manutenção dos dados referentes ao CNS.
Atualmente, é possível realizar a consulta dos CNS do beneficiário através do conceito pessoa pelos módulos ou ao realizar o cadastro de um novo beneficiário pela Web. Apresentaremos a seguir cada uma das maneiras possíveis de se realizar o este cadastro. | Painel |
|---|
| titleColor | White |
|---|
| titleBGColor | #013e61 |
|---|
| title | Consultar CNS pelo Conceito pessoa |
|---|
| Pelo módulo Estrutural > Cadastros > Cadastro de pessoa > Cadastro de pessoas, teremos acesso aos cadastro de pessoas. No momento do cadastro de uma nova pessoa, é possível realizar a consulta das informações do CADSUS clicando no botão de pesquisa ( Image Added), conforme indicado na imagem a seguir:  Image Added
| Nota |
|---|
A consulta do CNS funcionará apenas se o cadastro de pessoa estiver com o campo “Beneficiário” marcado na opção “Tipos de vínculo” como apontado na imagem anterior. |
Ao realizar a consulta com o CADSUS corretamente, o sistema irá retornar e atualizar o campo de CNS do cadastro. Consequentemente, o sistema atualizará todos os cadastros que esta pessoa possuir o vínculo. |
| Painel |
|---|
| titleColor | White |
|---|
| titleBGColor | #013e61 |
|---|
| title | Informações do CADSUS |
|---|
| Pelo módulo Estrutural > Cadastros > Outros cadastros > Informações do sistema CADSUS, é possível acessar a tela de consulta do beneficiário:  Image Added
Basta informar o nome do beneficiário, como apresentado na imagem acima, clicar em pesquisar para buscar o beneficiário e clicar na aba “Informações CADSUS”. Com isso, o sistema trará as informações do beneficiário:  Image Added
|
| Painel |
|---|
| titleColor | White |
|---|
| titleBGColor | #013e61 |
|---|
| title | Consultar CNS pela Web |
|---|
| Também é possível consultar o CNS dos beneficiários ao utilizar a Web Usuário, Web Empresa ou Web Comercial, durante as movimentações de inclusão, alteração e reapresentação de beneficiários.
A consulta pelo CNS é realizada através do botão consultar ( Image Added). A seguir, apresentaremos alguns breves exemplos referente à consulta:
| Expandir |
|---|
| title | Exemplo Web Usuário – Inclusão de dependentes |
|---|
| No menu Movimentação > Pedido de inclusão de dependente > Seção “Dados pessoais”, é possível encontrar o campo “Cartão SUS”. Ao lado dele, é possível visualizar o botão de consulta do CNS e realizar a pesquisa para este beneficiário:  Image Added
|
| Expandir |
|---|
| title | Exemplo Web Empresa – Alteração de beneficiários |
|---|
| No menu Movimentação > Alterações de beneficiários > Seção “Dados pessoais”, é possível encontrar o campo “Cartão SUS”. Ao lado dele, é possível visualizar o botão de consulta do CNS e realizar a pesquisa para este beneficiário:  Image Added
|
| Expandir |
|---|
| title | Exemplo Web Empresa – Reapresentação de beneficiários |
|---|
| No menu Relatórios > Cadastro > Operações de cadastro, ao realizar a reapresentação de algum beneficiário rejeitado pela Operadora, o campo “Cartão SUS” terá ao lado dele, o botão de consulta do CNS e realizar a pesquisa para este beneficiário:  Image Added
|
| Expandir |
|---|
| title | Exemplo Web Comercial – Pré-cadastro de beneficiário |
|---|
| No menu Movimentação > Pré-cadastro de beneficiário > Seção “Dados pessoais”, também teremos o campo “Cartão SUS”, com o botão de consulta de CNS para realizar a pesquisa para o beneficiário que está sendo cadastrado:  Image Added
|
|
| Painel |
|---|
| titleColor | White |
|---|
| titleBGColor | #013e61 |
|---|
| title | Erros conhecidos |
|---|
| O sistema exibe mensagens de erro padrões para o operador logado no módulo ou para o utilizador da Web, quando houver algum problema no uso da integração do Solus com o CADSUS. A seguir, apresentaremos os possíveis erros consequentes da falha de integração:
- Quando não existe a configuração de integração com o CADSUS ou a configuração está incompleta, o sistema exibe a mensagem “Sistema não está configurado para consumir o servido do CADSUS”
 Image Added
- Caso não encontre o CNS para o beneficiário, o sistema mostrará a mensagem “Beneficiário não encontrado na base do CADSUS!”
 Image Added
- Se houver alguma falha não prevista na comunicação com a API do CADSUS, a mensagem “Falha na consulta do CADSUS!” será apresentada -- imagem --
 Image Added
- Se houver alguma falha no Solus para consumir a API do CADSUS, o sistema apresentará a mensagem “Erro ao consultar o CADSUS!” -- imagem --
 Image Added
- Caso o certificado não esteja configurado, o sistema exibe a mensagem “Certificado não configurado” -- imagem --
 Image Added
- Para a web, quando o utilizador não preencher o CPF e clicar no botão de consulta de CNS, será mostrado o alerta “Informações insuficientes para realizar a busca” -- imagem --
 Image Added
- Ainda na web, quando o CPF informado não for localizado no CADSUS, será mostrada a mensagem “Usuário não localizado” -- imagem --
 Image Added
- Por fim, ao realizar a pesquisa do CNS na web e houver algum problema com o token de acesso, o sistema retornará a mensagem “Não autorizado realizar a consulta” -- imagem -
 Image Added
|
Voltar ao início
| Painel |
|---|
| borderColor | grey |
|---|
| titleColor | White |
|---|
| borderWidth | 1 px |
|---|
| titleBGColor | #B4044A |
|---|
| title | Links úteis |
|---|
| - Indicar outros manuais correspondentes ao atual através de link.
Para incluir um link utilize o atalho Ctrl + K, onde na primeira opção é possível vincular documentos do mesmo ambiente do Confluence e, na opção "Link da web", é possível vincular links externos, sendo necessário indicar uma máscara para o link no campo "Texto do link".Cadastro de Beneficiário Web Empresa Web Usuário
Voltar ao início |
| Aviso |
|---|
Documentação elaborada com base na versão vigente do sistema. |
Revisado por: PREENCHER COM A INICIAL DO NOME E ÚLTIMO SOBRENOME, DATA (Exemplo: N. S., 10/06/2022) |