Histórico da Página

Section

Column

width	80%

Essa integração possibilita o envio das

Image Removed

Produto TOTVS Saúde Planos Linha Protheus está 100% homologado

com a Unimed Brasil para utilização do CadBenef Online.

CONTEÚDO

Visão Geral
Exemplo de utilização
1. Configuração
2. Programa de Menu
3. Criando Lote de Envio
4. Status do Lote
  1. Consultar Status
5. Enviando Beneficiários
  1. Detalhes do Envio
    1. Mensagens de Erro
6. Exportar Erros
7. Compartilhamento de Risco
Tabelas utilizadas

...

01. VISÃO GERAL

...

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,

...

o envio dos dados

...

de beneficiários à Unimed do Brasil

...

pelo PTU A1300

...

será descontinuado.

...

No novo processo, o compartilhamento de risco

...

pelo PTU A100

...

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

...

all	true
style	h4
excerptType	simple

...

02. EXEMPLO DE UTILIZAÇÃO

b. Programa de Menu

Para a integração do CadBenef foi desenvolvido um novo programa (rotina) de menu no seguinte caminho:

Dica

icon	false

Miscelanea

Unimed

Integrações

Decrição: CadBenef Online

Programa: PLPTU001

Módulo: Plano de Saúde

Tipo: Função Protheus

...

c. Criando Lote de Envio

Na tela inicial, serão apresentados todos os lotes criados para integrar com o CadBenef Online - Unimed Brasil:

Image Removed

Novo Lote, irá criar um lote de beneficiários para envio ao CadBenef:

Image Removed

Aviso

icon	false

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 que estão sem data de bloqueio.
Cadastro Completo: Todos os beneficiários.
Mov. Periódica: Beneficiários que tiveram alterações/inclusões (BX1), via de cartão (BED), repasse, bloqueio e desbloqueio (BCA) no intervalo da data inicial e final informada no lote.
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 período em que o sistema irá considerar a busca dos beneficiários.

Data Final: Data final do período em que o sistema irá considerar a busca dos beneficiários.

Nota
Os demais campos serão utilizados para realização de filtros na busca dos beneficiários.

Confirmando a inclusão do lote, caso algum beneficiário seja encontrado conforme os dados informados, será apresentada uma mensagem de quantos beneficiários foram adicionados ao lote:

Dica

title	Lote incluído com sucesso!

O lote ficará com o status de

Estado

subtle	true
title	Recebido

ao finalizar a gravação.

Image Removed

Informações

title	Customização

Para manipular query que busca os beneficiários para o lote, foi criado o seguinte ponto de entrada: PE PTU001QRY Manipula Query que Busca os Beneficiários do Lote - CadBenef Online

...

d. Status do Lote

Os lotes poderão possuir os seguintes status:

...

icon	false

Estado

subtle	true
title	Recebido

...

Estado

subtle	true
colour	Blue
title	Processando Envio

...

Estado

subtle	true
colour	Red
title	Falha de Envio

...

Estado

subtle	true
colour	Yellow
title	Finalizado Parcialmente

Quando houver beneficiários enviados com sucesso e nenhum com erro de envio.

...

i. Consultar Status

O consultar status, será apresenta a quantidade de beneficiários, sendo:

Image Removed

...

e. Enviando Beneficiários

Existem duas formas de enviar o beneficiário para o CadBenef, sendo envio em lote, opção Enviar Lote ou acessando o Consultar Beneficiários do lote, na opção Enviar, onde será enviado somente o beneficiário posicionado.

Quando enviado o lote, o sistema irá processar o envio dos beneficiários de forma assíncrona, ou seja, o usuário não precisará esperar terminar o envio. Nesse momento, o lote ficará com o status

Estado

subtle	true
colour	Blue
title	Processando Envio

.

...

i. Detalhes do Envio

Através do consultar beneficiários, será possível verificar os Detalhes de Envio de cada beneficiário para o CadBenef:

Image Removed

Dica

Status: Corresponde ao status de envio do beneficiário, sendo:

Estado

subtle	true
title	Pendente de Envio

,

Estado

subtle	true
colour	Green
title	Envio Finalizado

,

Estado

subtle	true
colour	Red
title	Erro de Envio

.

Cd. Transac.: Código de Transação do PTU (esse código não irá repetir), através dele será possível consultar a transação no portal da Unimed Brasil referente ao CadBenef.

Msg. Envio: Json enviado pelo sistema para o CadBenef.

Msg. Resp.: Json de resposta do CadBenef.

...

title	Customização

...

width	20%

Dica

Produto TOTVS Saúde Planos Linha Protheus está 100% homologado

com a Unimed Brasil para utilização do CadBenef Online.

Column

width	60%

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

...

Nota

title	API Serviço de Movimentação Beneficiarios - Unimed Brasil

Para mais detalhes do swagger da api da Unimed Brasil, clique aqui!

...

1. Mensagens de Erro

Quando o beneficiário estiver com o status

Estado

subtle	true
colour	Red
title	Erro de Envio

, será possível através das mensagens de erro, consultar com mais detalhes as críticas que o sistema encontrou ou que a Unimed Brasil retornou:

Image Removed

...

g. Exportar Erros

No botão Exportar Erros do lote, é possível obter todos os erros de envio dos beneficiários daquele lote:

Image Removed

Selecione o tipo de impressão: Arquivo, Spool, Planilha (Padrão) e E-mail para exportar os erros do lote:

Image Removed

...

g. Compartilhamento de Risco

Custo Operacional ou Pós-Pagamento

A Unimed do Brasil irá validar o código do município de residência do beneficiário quando a origem enviar a movimentação cadastral. Caso seja identificado que a área de ação pertença a uma Unimed diferente da Unimed de origem da transação, o acionamento do Compartilhamento de Risco será realizado pela Unimed do Brasil.

Essa ação indicará que é um compartilhamento de risco, custo operacional ou pós-pagamento.

Bloco de código

language	c#
theme	Emacs
title	Exemplo de Request Body
linenumbers	true
collapse	true

{
  "cabecalho": {
    "codigoControleTransacao": 12345678901234567000,
    "unimed": {
      "codigoUnimedOrigem": 999,
      "codigoUnimedDestino": 55
    },
    "dataGeracao": "2024-05-27T09:06:05-03:00"
  },
  "dadosEmpresaContratante": {
    "tipoContratoLocal": 1
  },
  "dadosBeneficiario": {
    "carteirinhaBeneficiario": "00011008000034016",
    "tipoCompartilhamentoRisco": "C",
    "dataInicioCompartilhamentoRisco": "2024-07-05",
    "dataFimCompartilhamentoRisco": "2024-10-05",
    "indicadorCompUB": true
    
  },
  "dadosPessoa": {
    "nomeCompletoBeneficiario": "FILIPE THALES RAFAEL PORTO",
    "dataNascimento": "1991-01-26"  
  }
}

Nota

title	API de Inclusão do Compartilhamento de Riscos - Unimed Brasil

Para mais detalhes do swagger da api da Unimed Brasil, clique aqui!

No sistema, na rotina do Grupo Familiar/Beneficiários (PLSA124), opção do menu Interc. Hab. Será possível verificar os compartilhamentos de risco dos beneficiários. (Processo realizado no antigo PTU A100 simplificado)

Nota
O código de transação do compartilhamento de risco, ficará gravado no campo Cd. Transac. (B5F_CODTRA)

Image Removed

Log

Para analisar as comunicações recebidas pela api do compartilhamento de risco, foi criado o log unimed-cadbenef-api-risksharing.log que fica no diretório protheus_data/logpls:

Image Removed

Para repassar os beneficiários para outra unimed, antes de enviar o beneficiário é necessário realizar o seguinte preenchimento no cadatro do beneficiário (BA1):

Op. Destino (BA1_OPEDES) - Unimed Destino.
Data Repasse (BA1_DATREP) - Data do compartilhamento.
Carteirinha (BA1_LOCEMI) - indica se a geração da carteirinha será pela Unimed origem ou destino.
Prod.Interc. (BA1_PLAINT) - código do Plano de intercambio.

...

03. TABELAS UTILIZADAS

...

Árvore de páginas

Versões comparadas

Versão antiga 78

Nova versão Atual

Chave

CONTEÚDO

01. VISÃO GERAL

02. EXEMPLO DE UTILIZAÇÃO

b. Programa de Menu

c. Criando Lote de Envio

d. Status do Lote

i. Consultar Status

e. Enviando Beneficiários

i. Detalhes do Envio

ÚLTIMAS ATUALIZAÇÕES

1. Mensagens de Erro

g. Exportar Erros

g. Compartilhamento de Risco

Custo Operacional ou Pós-Pagamento

Log

03. TABELAS UTILIZADAS