...
- Visão Geral
- Exemplo de utilização
- Tela PLPTU001
- Outras Ações / Ações relacionadas
- Tela PLPTU001
- Principais Campos e Parâmetros
- Tabelas utilizadas
01. VISÃO GERAL
| Column |
|---|
| Essa integração possibilita o envio das |
|
...
movimentações de inclusão, alteração e exclusão |
|
...
de beneficiários da Unimed diretamente para o Cadastro Nacional de Beneficiários (CadBenef). Com isso, |
|
...
...
de beneficiários à Unimed do Brasil |
|
...
...
...
No novo processo, o compartilhamento de risco |
|
...
...
também será desativado, pois já está contemplado na mensagem "Cadastro de Beneficiário" |
|
...
. Da mesma forma, o PTU A200 será substituído pela mensagem "Retorno do Compartilhamento de Risco". |
|
...
É importante destacar que essas mudanças trarão maior eficiência ao processo de cadastramento de beneficiários no intercâmbio, |
|
...
eliminando a necessidade de procedimentos manuais. |
| Column |
|---|
| | Dica |
|---|
Produto TOTVS Saúde Planos Linha Protheus está 100% homologado com a Unimed Brasil para utilização do CadBenef Online. |
|
|
| Column |
|---|
|
| Showcase |
|---|
| BtnURL | https://tdn.totvs.com/display/PROT/Minha+Carteirinha |
|---|
| button-link | https://tdn.totvs.com/pages/viewpage.action?pageId=886660058 |
|---|
| button-text | Doc |
|---|
| description | Configuração do CadBenef Online no sistema Plano de Saúde (Protheus). |
|---|
| BtnText | Ver doc. |
|---|
| Largura | 180px |
|---|
| Titulo | Minha Carteirinha |
|---|
| title | Configuração |
|---|
| Imagem | an an-debit-card |
|---|
|
| Showcase |
|---|
| BtnURL | https://tdn.totvs.com/display/PROT/Minha+Carteirinha |
|---|
| button-link | https://tdn.totvs.com/pages/viewpage.action?pageId=887724836 |
|---|
| button-text | Doc |
|---|
| description | Para enviar os beneficiários ao CadBenef Online, é preciso incluir um lote manualmente. |
|---|
| BtnText | Ver doc. |
|---|
| Largura | 180px |
|---|
| Titulo | Minha Carteirinha |
|---|
| title | Criação de Lotes |
|---|
| Imagem | an an-debit-card |
|---|
|
| Showcase |
|---|
| BtnURL | https://tdn.totvs.com/display/PROT/Minha+Carteirinha |
|---|
| button-link | https://tdn.totvs.com/pages/viewpage.action?pageId=887729611 |
|---|
| button-text | Doc |
|---|
| description | O sistema permite criar lotes recorrentes via agendamento no Schedule. |
|---|
| BtnText | Ver doc. |
|---|
| Largura | 180px |
|---|
| Titulo | Minha Carteirinha |
|---|
| title | Agendamento de Lotes |
|---|
| Imagem | an an-debit-card |
|---|
|
| Showcase |
|---|
| BtnURL | https://tdn.totvs.com/display/PROT/Minha+Carteirinha |
|---|
| button-link | https://tdn.totvs.com/pages/viewpage.action?pageId=887730845 |
|---|
| button-text | Doc |
|---|
| description | Após incluir o lote no CadBenef, o envio pode ser completo ou individual por beneficiário. |
|---|
| BtnText | Ver doc. |
|---|
| Largura | 180px |
|---|
| Titulo | Minha Carteirinha |
|---|
| title | Envio de Beneficiários |
|---|
| Imagem | an an-debit-card |
|---|
|
| Showcase |
|---|
| BtnURL | https://tdn.totvs.com/display/PROT/Minha+Carteirinha |
|---|
| button-link | https://tdn.totvs.com/pages/viewpage.action?pageId=887733041 |
|---|
| button-text | Doc |
|---|
| description | O sistema permite analisar erros de envio com críticas do Protheus e Unimed Brasil. |
|---|
| BtnText | Ver doc. |
|---|
| Largura | 180px |
|---|
| Titulo | Minha Carteirinha |
|---|
| title | Análise de Erros |
|---|
| Imagem | an an-debit-card |
|---|
|
| Showcase |
|---|
| BtnURL | https://tdn.totvs.com/display/PROT/Minha+Carteirinha |
|---|
| button-link | https://tdn.totvs.com/pages/viewpage.action?pageId=887736595 |
|---|
| button-text | Doc |
|---|
| description | O sistema gera um relatório detalhado dos erros de envio, facilitando a análise e correção. |
|---|
| BtnText | Ver doc. |
|---|
| Largura | 180px |
|---|
| Titulo | Minha Carteirinha |
|---|
| title | Relatório de Erros |
|---|
| Imagem | an an-debit-card |
|---|
|
| Showcase |
|---|
| BtnURL | https://tdn.totvs.com/display/PROT/Minha+Carteirinha |
|---|
| button-link | https://tdn.totvs.com/display/PROT/CadBenef+Online+-+Compartilhamento+de+Risco |
|---|
| button-text | Doc |
|---|
| description | O compartilhamento de risco ocorre por repasse ou custo, conforme o município. |
|---|
| BtnText | Ver doc. |
|---|
| Largura | 180px |
|---|
| Titulo | Minha Carteirinha |
|---|
| title | Compart. de Risco |
|---|
| Imagem | an an-debit-card |
|---|
|
| Showcase |
|---|
| BtnURL | https://tdn.totvs.com/display/PROT/Minha+Carteirinha |
|---|
| button-link | https://tdn.totvs.com/pages/viewpage.action?pageId=1010800927 |
|---|
| button-text | Doc |
|---|
| description | O sistema V-COM irá validar a conformidade daquele contrato de acordo com a ND 13, |
|---|
| BtnText | Ver doc. |
|---|
| Largura | 180px |
|---|
| Titulo | Minha Carteirinha |
|---|
| title | Envio Contrato (V-COM) |
|---|
| Imagem | an an-debit-card |
|---|
|
|
ÚLTIMAS ATUALIZAÇÕES
| Atualizado recentemente |
|---|
| showProfilePic | true |
|---|
| hideHeading | true |
|---|
| theme | sidebar |
|---|
| labels | cadbenef_online_pls |
|---|
|
...
02. EXEMPLO DE UTILIZAÇÃO
2.1 Configuração
2.1.1 Endpoint e Autenticação
Acesse o menu Operadora de Saúde (PLSA010), do módulo Plano de Saúde (SIGAPLS), e seleciona a código da unimed que deseja configurar a integração.
Clique em alterar e acesse a aba Integrações Unimed para preencher os seguintes campos:
Image Removed
| Informações |
|---|
|
URL Token: Endpoint de homologação/produção disponibilizado pela unimed brasil para autenticação. (BA0_UBURL)
Exemplo: https://gateway-hml.unimed.coop.br/oauth/v1/access-token ID Token: Client ID solicitado previamente para Unimed Brasil. (BA0_UBCLID) Secret Token : Secret ID solicitado previamente para Unimed Brasil. (BA0_UBCLSC) URL CadBenef: Endpoint de homologação/produção do CadBenef-Online. (BA0_CDBURL)
Exemplo: https://ua-gateway-hml.unimed.coop.br/cadbenef-online/v1/beneficiarios |
2.1.2 Certiciado Digital
A Unimed Brasil utiliza certificados digitais do tipo ICP-Brasil que funcionam como uma identidade virtual que permite a identificação segura e inequívoca do autor de uma mensagem ou transação.
Portanto é obrigatório a utilização de um certificado digital na integração com o CadBenef.
Obtido arquivo certificado com extensão .PFX (formato padrão do IIS - Internet Information Services), é nessecário que o mesmo seja adicionado no servidor do protheus:
| Dica |
|---|
| title | Diretório no RootPath |
|---|
|
\cadbenef\certificados\meu_certificado.pfx |
No cadastro da operada de saúde (mesmo caminho da configuração acima do endpoint e autentcação), e necessário informar os dados do certificado:
| Informações |
|---|
|
PFX CadBenef: O nome do certificado com extensão. (BA0_CDBPFX) Pass CadBen.: Senha que será utilizada para a abertura da chave privada. Para uma chave privada que não possua senha deve ser informada uma string vazia. (BA0_CDBPAS) |
Para a integração do CadBenef foi desenvolvido um novo programa (rotina) de menu no seguinte caminho:
| Dica |
|---|
|
 Miscelanea
Unimed Integrações Decrição: CadBenef Online Programa: PLPTU001 Módulo: Plano de Saúde Tipo: Função Protheus |
2.3 Criando Lote de Envio
Na tela inicial será apresentado todos os lotes criados para integrar com o CadBenef Online - Unimed Brasil:
Image Removed
Botão Novo Lote, irá criar um lote de beneficiários para envio ao CadBenef:
Image Removed
| Aviso |
|---|
| icon | false |
|---|
| title | Campos Obrigatórios do Lote |
|---|
|
Tipo de Mov.: Informe de qual forma o sistema irá buscar os beneficiários no cadastro, sendo: - Cadastro Ativo: Beneficiários que tiveram inclusão no intervalo da data inicial e final informada no lote e que estão sem data de bloqueio.
- Cadastro Completo: Todos os beneficiários
- Mov. Periódica: Beneficiários que tiveram alterações no intervalo da data inicial e final informada no lote no cadastro de Vidas (BTS) e no cadastro do Grupo/Familiar.
- Somente Exclusão: Beneficiários que tiveram bloqueio no intervalo da data inicial e final informada no lote e que já foram enviados para o CadBenef.
Data Inicial: Data inicial do periodo em que o sistema irá considerar a busca dos beneficiários Data Final: Data final do periodo em que o sistema irá considerar a busca dos beneficiários |
| Nota |
|---|
| Os demais campos serão utilizados para realização de fltros na busca dos beneficiários. |
Confirmando a inclusão do lote, caso algum beneficiário seja encontrado de acordo com os dados informados, será apresentado uma mensagem de quantos beneficiários foram adicionado ao lote:
Image Removed
| Dica |
|---|
| title | Lote incluído com sucesso! |
|---|
|
O lote ficará com o status de Recebido ao finalizar a gravação. |
2.4 Status do Lote
Os lotes poderam possuir os seguintes status:
...
: Recebe esse status ao criar o lote.
| Estado |
|---|
| subtle | true |
|---|
| colour | Blue |
|---|
| title | Processando Envio |
|---|
|
Recebe esse status quando estiver enviando os beneficiários para o CadBenef.
| Estado |
|---|
| subtle | true |
|---|
| colour | Red |
|---|
| title | Falha de Envio |
|---|
|
: Recebe esse status caso algum beneficiário tiver erro no envio.
...
| Estado |
|---|
| subtle | true |
|---|
| colour | Yellow |
|---|
| title | Finalizado Parcialmente |
|---|
|
: Recebe esse status quando houver beneficiários enviados com sucesso e nenhum com erro de envio.
2.4.1 Consultar Status
O botão consultar status, apresenta a quantidade de beneficiários no lote que já estão pendente de envio, enviados com sucesso e com erro:
| Informações |
|---|
|
| Estado |
|---|
| subtle | true |
|---|
| title | Pedente de Envio |
|---|
|
| Estado |
|---|
| subtle | true |
|---|
| colour | Green |
|---|
| title | Envio Finalizado |
|---|
|
| Estado |
|---|
| subtle | true |
|---|
| colour | Red |
|---|
| title | Erro de Envio |
|---|
|
|
03. TELA XXXXX
Outras Ações / Ações relacionadas
...
04. TELA XXXXX
Principais Campos e Parâmetros
...
| Card documentos |
|---|
| Informacao | Use esse box para destacar informações relevantes e/ou de destaque. |
|---|
| Titulo | IMPORTANTE! |
|---|
|
...
