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 |
---|
titleColor | White |
---|
titleBGColor | #013e61 |
---|
title | 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 através 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 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. | 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 |
---|
| 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 |
Painel |
---|
borderColor | grey |
---|
titleColor | White |
---|
borderWidth | 1px |
---|
titleBGColor | #B4044A |
---|
title | Operacionalização |
---|
| 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. Aviso |
---|
A integração com o CADSUS tem a finalidade de facilitar ou atualizar o cadastramento. Entretanto, esta a API do CADSUS consegue buscar apenas o CNS do beneficiário, ou seja, outros dados não serão trazidos pela integração. |
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 (), conforme indicado na imagem a seguir:
Aviso |
---|
A consulta do CNS funcionará apenas para pessoas do tipo "Física" e quando possuir um CPF preenchido. |
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:
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:
|
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" (). A seguir, apresentaremos alguns breves exemplos referentes à consulta: Nota |
---|
É 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. |
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:
|
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:
|
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:
|
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:
|
|
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”
- 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 exibe 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 |
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) |