Escrito por: F.S.

Integração Solus x CadSUS

Sumário

» Objetivo

» Funcionalidade

» Configurações, Parâmetros e/ou Permissões de direitos

» Operacionalização

» Links úteis

Objetivo

Neste manual, será explicado como realizar a configuração da integração do Solus com o CADSUS, e como utilizá-la para complementar o cadastro dos beneficiários.

Funcionalidade

Atualização do número de CNS (Cartão Nacional de Saúde) do beneficiário.
Buscar o CNS do beneficiário na base CADSUS.

Configurações, Parâmetros e/ou Permissões de direitos

Configurações/Requisitos

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.

Credenciais de acesso

Com o link a seguir, é possível ter acesso ao manual disponibilizado no site do governo para solicitar as credenciais:

Manual de apoio para solicitação de credenciais no Portal de Serviços.

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

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

Caso a operadora tenha somente o certificado ".pfx" e não tenha os arquivos ".crt" e ".key", descreveremos a seguir uma orientação para converter o certificado ".pfx" em ".crt" e ".key".

Ambas as chaves precisam ser cadastradas para que a integração funcione corretamente.

Converter certificado .pfx em .crt e .key

Em algumas situações, a Operadora pode receber o certificado com a extensão ".pfx", sendo necessário realizar a extração deste arquivo para o certificado com extensão em ".crt" e um arquivo complementar ".key".

Para saber mais sobre como realizar a conversão do certificado, acesse o manual clicando aqui.

Voltar ao início

Operacionalização

Atualmente, é possível consultar o CNS do beneficiário pelo Conceito Pessoa pelos módulos ou realizar o cadastro de um novo beneficiário pela Web. Apresentaremos a seguir cada uma das maneiras possíveis de se realizar esse cadastro.

A integração com o CADSUS tem a finalidade de facilitar ou atualizar o cadastramento. Entretanto, a API do CADSUS consegue buscar apenas o CNS do beneficiário, ou seja, outros dados não serão trazidos pela integração.

Consultar CNS pelo Conceito pessoa

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:

A consulta do CNS funcionará apenas para pessoas do tipo "Física" e quando tiver um CPF preenchido.

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

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:

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

Consultar CNS pela Web

É 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 pelo botão "Consultar" (). A seguir, apresentaremos alguns breves exemplos referentes à consulta:

É importante ressaltar que o botão "Consultar", mencionado anteriormente, só ficará disponível para visualização na Web, caso a integração tenha sido configurada corretamente.

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 esse beneficiário:

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:

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, assim fará a pesquisa para esse beneficiário:

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:

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

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

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

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

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

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

Voltar ao início

Links úteis

Cadastro de Beneficiário

Web Empresa

Web Usuário

Documentação elaborada com base na versão vigente do sistema.

Voltar ao início

Revisado por: R. C., 7 de dez. de 2023

Navegador não compatível