01. DADOS GERAIS

Produto:

TOTVS Saúde Planos

Linha de Produto:

Linha Protheus 

Segmento:

Saude 

Módulo:PTU
Função:A1300
Ticket:
Issue:DSAUBE-27668


02. 
SITUAÇÃO/REQUISITO

Houve a necessidade de adequar o produto TOTVS Saúde Planos - Linha Protheus com a versão 2.2025 referente ao CadBenef Online - Serviços de Movimentação Cadastral de Beneficiários, com a entrada em vigor para 03/09/2025.

03. SOLUÇÃO

Todas as alterações descritas neste documento foram implementadas de acordo com as regras impostas pela Unimed do Brasil em seus manuais e comunicados.

        Para mais informações poderá ser consultado os manuais e comunicados no site http://www.unimed.coop.br/.

Novas Regras PTU Online Versão 9.2025:

Nos dados do cabeçalho foram realizadas as seguintes mudanças:

Código Controle Transação

Alterado o tipo do bloco codigoControleTransacao.

TagTipo

codigoControleTransação

Caractere

Código da Versão do PTU

Alterado o conteúdo do bloco codigoVersaoPTU.

TagConteúdo

codigoVersaoPTU

F”012”


Nos dados do beneficiário foram realizadas as seguintes mudanças:

Código de Controle Unimed Brasil

Alterado o tipo do bloco codigoControleUnimedBrasil.

TagCampo do SistemaTipo

codigoControleUnimedBrasil

BA1_CODUBR

Caractere

Código Controle Remido

Inclusão do bloco codigoControleRemido.

TagConteúdoTipoRegra

codigoControleRemido

BA1_CODUBR do beneficiário titular

CaractereGerado somente quando for beneficiário dependente e remido

Manual PTU Online Versão 9.2025:

Valor Mensalidade

Bloco valorMensalidade foi movido para dentro do agrupador produtoAgregado.

TagRegra

valorMensalidade

Calculada baseada no mês e ano atual.

Produto Agregado

Alterações no agrupador secundário produtoAgregado.

TagRegra

codigoPlanoDestino

Obrigatório quando beneficiário tiver Produto Agregado e IndicadorCompartilhamento igual a FALSE

dataRepasseUnimedDestino

Obrigatório quando beneficiário tiver Produto Agregado e IndicadorCompartilhamento igual a FALSE

dataInicioVigenciaProduto

Obrigatório quando beneficiário tiver Produto Agregado e IndicadorCompartilhamento igual a FALSE

dataBaseCarencia

Obrigatório quando beneficiário tiver Produto Agregado e IndicadorCompartilhamento igual a FALSE
TagConteúdoTipoRegra

valorMensalidade 

BZX_VALFAINuméricoValor de cada opcional cadastrado para o beneficiário


Manual PTU Online Versão 9.2025:


Mudanças no agrupador dadosEmpresaContratante, referentes aos dados da empresa:

Tipo Empresa

Alteração no agrupador tipoEmpresa

TagRegra

cnpj

Obrigatório o preenchimento de um dos campos.

caepf

Manual PTU Online Versão 9.2025:


Mudanças no agrupador dadosPlano, referentes aos dados da plano:

Alteração da obrigatoriedade para obrigatório dos seguintes blocos:

TagConteúdo

dataInicioVigencia


tipoAbrangencia

1= Nacional
2 = Regional A – Grupo de Estados
3 = Estadual
4 = Regional B – Grupo de Municípios
5 = Municipal


Quando tipo 2, obrigatório preencher
abrangências.codigoUf;
Quando tipo 4, obrigatório preencher
abrangências.codigoMunicipio.

tipoContratacao

1 = Individual ou Familiar
2 = Coletivo Empresarial
3 = Coletivo por Adesão

tipoAcomodacao

A = Coletiva
B = Individual
C= Não se Aplica

tipoRegistroPlanoAns

1 – Plano Não Regulamentado
2 – Plano Adaptado
3 – Plano Regulamentado

segmentacaoPlano

Conforme Tabela V – Anexo 01

tipoContrato

P – Pré-Pagamento
C – Custo Operacional

tipoRede

1 – Básica
2 – Especial (Tabela Própria)
3 – Master (Alto Custo)

indicadorAtendimentoUrgencia

Quando true, o atendimento Urgência e Emergência
será em todo território nacional.
Quando false, o atendimento Urgência e Emergência
será restrito a área de ação de acordo com o tipo de
abrangência.
Se tipoAbrangencia = 1, o campo deverá ser
obrigatóriamente True.

Manual PTU Online Versão 9.2025:

 

Coberturas

Criado campo BG7_CODEDI que será responsável pela associação entre código Protheus x código da tabela K. Também foi adicionado tratamento para não haver duplicidade entre os códigos enviados, sendo que em casos de duplicidade, a tag dataFimCobertura terá o conteúdo do nível mais forte, conforme explicado no boletim anterior.

No Compartilhamento de Risco, ocorreu as seguintes mudanças:

Código Controle Transação

Alterado o tipo do bloco codigoControleTransacao.

TagTipo

codigoControleTransação

Caractere

Código da Versão do PTU

Alterado o conteúdo do bloco codigoVersaoPTU.

TagConteúdo

codigoVersaoPTU

F”012”

04. DEMAIS INFORMAÇÕES

CampoTipoTamanhoDecimalTítuloDescriçãoUsadoObrigatórioExibe BrowserVisualContextoHelp
BG7_CODEDIC30Cod. EDICod. EDISimNãoNãoVisualReal

Código da tabela K informado no manual do PTU


Exclusão de Beneficiário

Com a chegada da versão 9.2025 do PTU Online, passou a ser obrigatório o envio da tag dataFimVigencia na exclusão dos beneficiários. 

TagConteúdo

dataFimVigencia

BA1_DATBLO



Para mais informações de como utilizar essa funcionalidade, acesse a documentação de referência: CadBenef Online - Movimentação Cadastral de Beneficiarios - PLPTU001

05. ASSUNTOS RELACIONADOS

        CadBenef - Serviços de Movimentação Cadastral de Beneficiários - Vigência 14/02/2024