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.
| Tag | Tipo |
|---|---|
codigoControleTransação | Caractere |
Código da Versão do PTU
Alterado o conteúdo do bloco codigoVersaoPTU.
| Tag | Conteú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.
| Tag | Campo do Sistema | Tipo |
|---|---|---|
codigoControleUnimedBrasil | BA1_CODUBR | Caractere |
Código Controle Remido
Inclusão do bloco codigoControleRemido.
| Tag | Conteúdo | Tipo | Regra |
|---|---|---|---|
codigoControleRemido | BA1_CODUBR do beneficiário titular | Caractere | Gerado 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.
| Tag | Regra |
|---|---|
valorMensalidade | Calculada baseada no mês e ano atual. |
Produto Agregado
Alterações no agrupador secundário produtoAgregado.
| Tag | Regra |
|---|---|
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 |
| Tag | Conteúdo | Tipo | Regra |
|---|---|---|---|
valorMensalidade | BZX_VALFAI | Numérico | Valor 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
| Tag | Regra |
|---|---|
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:
| Tag | Conteúdo |
|---|---|
dataInicioVigencia | |
tipoAbrangencia | 1= Nacional Quando tipo 2, obrigatório preencher |
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.
| Tag | Tipo |
|---|---|
codigoControleTransação | Caractere |
Código da Versão do PTU
Alterado o conteúdo do bloco codigoVersaoPTU.
| Tag | Conteúdo |
|---|---|
codigoVersaoPTU | F”012” |
04. DEMAIS INFORMAÇÕES
| Campo | Tipo | Tamanho | Decimal | Título | Descrição | Usado | Obrigatório | Exibe Browser | Visual | Contexto | Help |
|---|---|---|---|---|---|---|---|---|---|---|---|
| BG7_CODEDI | C | 3 | 0 | Cod. EDI | Cod. EDI | Sim | Não | Não | Visual | Real | 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.
| Tag | Conteú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
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas