Para utilizar a integração do Solus com o CADSUS,

serão necessárias as credenciais que a Operadora deverá providenciar junto à ANS por meio de um manual do governo. Além disso, a Operadora precisará configurar a integração com o CADSUS no Módulo ADM.

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 Módulo ADM > Configurações > Cadastro de integrações. Na tela que se abrirá, clique no botão incluir (Image Modified) para criar um novo registro. O sistema mudará para a aba “Dados”, para que o operador realize o preenchimento das informações corretas: Image Removed Image Added Os seguintes campos precisarão ser informados: Campo Informação Nome Identificação da API. Pode ser o nome que a Operadora desejar. Uma sugestão adequada seria "Cadastro de Usuários do SUS - CADSUS". Descrição Descrição da API. Pode ser cadastrada da maneira que a Operadora desejar. Uma sugestão adequada seria "Consulta de beneficiários". URL Informar o link para a consulta de serviço do CADSUS. O link varia dependendo da base que for utilizada. Para a base de produção, preencha com o link: https://servicos.saude.gov.br/cadsus/v2/pesquisaCns. Para a base de homologação, preencha com o link: https://servicoshm.saude.gov.br/cadsus/v2/pesquisaCns   . 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 mudarremos para a aba “1. Configurações API”, onde será necessário cadastrar mais informações: Image Added Campo Informação Tipo da autenticação indique Indique a opção “Configurável”. URL para geração do token autenticado Informar o link para a geração do token. Para a base de produção, preencha com o link: https://ehr-auth.saude.gov.br/api/osb/token   . Para a base de homologação, preencha com o link: https://ehr-auth-hmg.saude.gov.br/api/osb/token   . Bloco “Configurações e acesso” É necessário incluir as chaves (crt e key) e informar o certificado destas chaves delas: 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 tenha somente o certificado ".pfx" e não possua tenha 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.

openssl pkcs12 -in [nome_certificado].pfx -nocerts -out [nome_chave].key

openssl pkcs12 -in [nome_certificado].pfx -clcerts -nokeys -out [nome_certificado_encrypted].crt

openssl rsa -in [nome_chave_encrypted].key -out [nome_chave].key

Pelo módulo No 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 (), conforme indicado na imagem a seguir:

Image RemovedImage Added

Ao realizar a consulta com o CADSUS corretamente, o sistema irá retornar retornará e atualizar atualizará o campo de CNS do cadastro. Consequentemente, o sistema atualizará todos os cadastros que esta pessoa possuir tiver o vínculo.

Pelo módulo Estrutural > Cadastros > Outros cadastros > Informações do sistema CADSUS, é possível acessar a tela de consulta do beneficiário:

Basta informar o nome do beneficiário já cadastrado na Operadora, como apresentado na imagem acima, clicar em pesquisar "Pesquisar" para buscar o beneficiário e clicar na alterar para a aba “Informações CADSUS”. Com isso, o sistema trará as informações do beneficiário:

Image Modified

Também é É possível também consultar o CNS dos beneficiários ao utilizar a Web Usuário, a Web Empresa ou a 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 pelo botão "Consultar" (). A seguir, apresentaremos alguns breves exemplos referente referentes à consulta:

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 exibirá a mensagem: “Sistema não está configurado para consumir o servido do CADSUS”.

• Caso não encontre o CNS para o beneficiário, o sistema mostrará a mensagem “Beneficiário não encontrado na base do CADSUS!” ”. 

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

• Se houver alguma falha no Solus para consumir a API do CADSUS, o sistema apresentará a mensagem “Erro ao consultar o CADSUS!” -- imagem --.

• Caso o certificado não esteja configurado, o sistema exibe exibirá a mensagem “Certificado não configurado” -- imagem --. 

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

• Ainda na web, quando o CPF informado não for localizado no CADSUS, será mostrada a mensagem “Usuário não localizado” -- imagem --.

• Por fim, ao realizar a pesquisa do CNS na web Web, e houver algum problema com o token de acesso, o sistema retornará a mensagem “Não autorizado realizar a consulta” -- imagem -.