Tempo aproximado para leitura: 10 minutos01. DADOS GERAIS
| Produto: | TOTVS Saúde Planos
|
|---|---|
| Linha de Produto: | Linha Protheus |
| Segmento: | Saude |
| Módulo: | PTU |
| Função: | A1300 |
| Ticket: | |
| Issue: | DSAUBE-25736 |
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 14/02/2024.
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 2.2025:
Nos dados do cabeçalho foram realizadas as seguintes mudanças:
Código da Versão do PTU
Alterado o contéudo do bloco codigoVersaoPTU.
| Tag | Contéudo |
|---|---|
codigoVersaoPTU | F”011” |
Nos dados do beneficiário foram realizadas as seguintes mudanças:
Código da Unidade Federativa do médico cooperado
Alterado o tipo do bloco codigoUfConselho.
| Tag | Campo do Sistema | Tipo | Regra |
|---|---|---|---|
codigoUfConselho | BAU_ESTCR | UF | Obrigatório quando indicadorBeneficiarioCooperado = True |
Motivo de exclusão
Alterado o tipo do bloco motivoExclusaoBeneficiario.
| Tag | Campo do Sistema | Tipo | Regra |
|---|---|---|---|
motivoExclusaoBeneficiario | BG3_CODEDI, BG1_CODEDI ou BQU_CODEDI | UF | Obrigatório quando dataExclusaoBeneficiario estiver preenchido. |
Novas tags
Foram incluidas as seguintes tags agrupador principal dadosBeneficiario:
| Tag | Contéudo | Regra |
|---|---|---|
valorMensalidade | Calculada baseada no mês e ano atual. | |
rendaMensal | BA3_VALSAL | |
carteirinhaAnterior | BA1_MATANT | Mandatório em casos de transferência de código de benefciciário. |
idFilho | BTS_UNIVER, BTS_DEFFIS ou "Outros" | Obrigatório sempre que o código do dependente for 10, 70 ou 75 e que tenha atingido a maioridade. 01 – Filho Universitário |
Manual PTU Online Versão 2.2025:
Produto Agregado
No agrupador secundário produtoAgregado, em dadosBeneficiario, foram incluidas as tags:
| Tag | Campo do Sistema | Regra |
|---|---|---|
indicadorCompartilhamento | Quando BA1_OPEORI for diferente do que BA1_OPEDES é igual .T. | Se o beneficiário for de compartilhamento de risco,preencher com TRUE (1) |
codigoUnimedDestino | Op. Destino (BA1_OPEDES) | Obrigatório quando beneficiário tiver Produto Agregado |
tipoProduto | Cod EDI (BI3_CODPTU) | |
codigoPlanoDestino | Quando houver compartilhamento de risco é o campo Cod EDI (BI3_CODPTU) buscado pelo campo Prod.Interc. (BA1_PLAINT) Caso contrário faz referência ao campo Cod EDI (BI3_CODPTU) buscado pelo campo Cód.Plano (BA1_CODPLA) | |
dataRepasseUnimedDestino | Quando houver compartilhamento de risco é o campo Data Repasse (BA1_DATREP) Caso contrário faz referência ao campo Dt. Inclusão (BA1_DATINC) | |
dataInicioVigenciaProduto | Data Base (BF4_DATBAS) | |
dataFimVigenciaProduto | Dt. Bloqueio (BF4_DATBLO) | |
dataBaseCarencia | Dt. Carência (BA1_DATCAR) | Obrigatório quando beneficiário tiver Produto Agregado |
Manual PTU Online Versão 2.2025:
Mudanças no agrupador (dadosEmpresaContratante), referentes aos dados da empresa:
Data de Inclusão e Exclusão da Empresa na Umined.
Inclusão das seguintes tags:
| Tag | Campo do Sistema | Regra |
|---|---|---|
dataInclusaoEmpresaUnimed | BQC_DATCON | Obrigatorio quando Produtos |
dataExclusaoEmpresaUnimed | BQC_DATBLO |
Manual PTU Online Versão 2.2025:
Endereços
Na agrupadora segundária endereco, foi realizado a mudanças no tamanho das seguintes tags:
| Tag | Campo do Sistema | Tamanho | Regra |
|---|---|---|---|
logradouroPrincipal | BQC_LOGRAD | 80 | Obrigatório quando indicadores estiverem preenchidos: indicadorAutoGestao /indicadorPlanoAcidenteTrabalho / indicadorPlanoSaudeOcupacional / indicadorPlanoAPS |
complementoLogradouro | BQC_COMPLE | 80 | |
bairro | BQC_BAIRRO | 45 |
Manual PTU Online Versão 2.2025:
Telefones
Inclusão de um novo bloco nomeado como "telefone" disposto na agrupadora dadosEmpresaContratante.
| Tag | Campo do Sistema | Tamanho | Regra |
|---|---|---|---|
tipoTelefone | BQC_TIPTEL | 80 | 1 – Residencial Quando telefone de empresa, valor do campo deverá ser 2 |
ddd | BQC_DDD | 80 | Obrigatório se tipoTelefone = 1, 2 ou 3 |
numero | BQC_TEL | 45 | |
ramal | Não Utilizado. |
Manual PTU Online Versão 2.2025:
Mudanças no agrupador (dadosPlano), referentes aos dados da plano:
AdmBeneficios
Inclusão de novas regras referentes as seguintes tags:
| Tag | Campo do Sistema | Regra |
|---|---|---|
cnpjAdmBeneficios | BQC_CNPADM | Obrigatório quando tipoContratacao = 3 e (Coletivo por Adesão) e protocoloProspeccao ou |
nomeAdmBeneficios | BQC_RAZSBE | |
nomeFantasiaAdmBeneficios | BQC_SEASPL |
Manual PTU Online Versão 2.2025:
Registro ANS da Administradora Beneficios
Adicionado a tag de Registro ANS da AdministradoraBeneficios
| Tag | Campo do Sistema | Regra |
|---|---|---|
registroANSAdmBeneficios | BQC_RECANS | Obrigatório quando tipoContratacao = 3 e (Coletivo por Adesão) e protocoloProspeccao ou |
Manual PTU Online Versão 2.2025:
Coberturas
As tags de carências, passou a ser nomeadas como "coberturas". Dessa forma, serão preenchidas de acordo com a cobertura do nível configurado.
| Tag | Campo do Sistema | Regra |
|---|---|---|
tipoCobertura | Obrigatório se Beneficiário possuir Cobertura | |
dataFimCobertura | BFE_DATCAR ou BA1_DATCAR | Obrigatório se campo tipoCobertura estiver |
Obs: O contéudo do tipoCobertura/dataFimCobertura será preenchido a partir do cadastro referente a cobertura. Considerando que a cobertura do beneficiário pode ser parametrizada nos seguintes níveis:
- Grupo Familiar (BA1): Grupos de Cobertura Usuários (BFE).
- Grupo Familiar (BA3): Grupos de Cobertura Famílias (BFC).
- Grupo Empresa - SubContrato (BQC): Empresa Grupo de Cobertura (BT7).
- Produto Saúde (BI3): Planos e Grupos de Cobertura (BRV).
Manual PTU Online Versão 2.2025:
Carências
Inclusão das tags de Carências.
| Tag | Campo do Sistema | Regra |
|---|---|---|
tipoCarencia | BDL_CODEDI | Obrigatório se Beneficiário possuir Carencia |
dataFimCarencia | BFO_DATCAR ou BA1_DATCAR | Obrigatório se campo tipoCarencia estiver |
Obs: O contéudo do tipoCarencia/dataFimCarencia será preenchido a partir do cadastro referente a carência. Considerando que a carência do beneficiário pode ser parametrizada nos seguintes níveis:
- Grupo Familiar (BA1): Classe de Carência do Usuário (BFO).
- Grupo Familiar (BA3): Classes Carências da Família (BFJ).
- Grupo Empresa - SubContrato (BQC): Subcont x Prod x Classe Car (BA6).
- Produto Saúde (BI3): Produtos da Classe Carência (BAN).
Manual PTU Online Versão 2.2025:
No Compartilhamento de Risco, ocorreu as seguintes mudanças:
Indicador da geração código no cartão beneficiario
Remoção da Regra da tag indicadorGeracaoCodigo.
| Tag | Regra |
|---|---|
indicadorGeracaoCodigo |
Obs: Indica se Unimed Origem é a responsavel pela geração código no cartão beneficiario
Manual PTU Online Versão 2.2025:
Indicador de suspensão atendimento para compartilhamento de riscos
Inclusão de nova tag em dadosBeneficiario.
| Tag | Contéudo do sistema | Regra |
|---|---|---|
indicadorSuspensaoAtendimento | Indicador de suspensão atendimento para compartilhamento de riscos |
Manual PTU Online Versão 2.2025:
Ocorreu mudanças na agrupador dadosPessoa:
Gênero Social do Beneficiário
Mudança da Regra, na tag generoSocial.
| Tag | Contéudo do sistema | Regra |
|---|---|---|
generoSocial | BTS_GENSOC | F = Feminino M = Masculino N = Não binário |
Manual PTU Online Versão 2.2025:
Código da Unidade Federativa da carteira de identidade
Mudança no tipo, na tag "uf" do agrupador "rg".
| Tag | Contéudo do sistema | Tipo |
|---|---|---|
uf | BTS_RGEST | AN |
Manual PTU Online Versão 2.2025:
Complementos Cadastrais
Tipo de Residência
Na agrupadora segundária enderecos, ocorreu a inclusão de nova regra na tag tipoResidencia.
| Tag | Contéudo do sistema | Regra |
|---|---|---|
tipoResidencia | BTS_RESEXT | 1 – Brasil Obrigatório quando indicadores estiverem preenchidos: indicadorAutoGestao/indicadorPlanoAcidenteTrabalho /indicadorPlanoSaudeOcupacional/indicadorPlanoAPS |
Manual PTU Online Versão 2.2025:
Endereços
Na agrupadora segundária enderecos, foi realizado a mudanças no tamanho das seguintes tags:
| Tag | Campo do Sistema | Tamanho | Regra |
|---|---|---|---|
logradouro | BA1_ENDERE ou BTS_ENDERE | 80 | Obrigatorio no caso do tipoResidencia = 1 |
bairro | BA1_BAIRRO ou BTS_BAIRRO | 45 | |
complemento | BA1_COMEND ou BTS_COMEND | 80 |
Manual PTU Online Versão 2.2025:
Atualização de Dicionário de Dados
Cadastro do Grupo Empresa - SubContrato
Inclusão na tabela SX3 (Campos):
Campo | Tipo | Tamanho | Decimal | Titulo | Descrição | Picture | Usado | Validação | Cbox | Exibe Browser | Folder | Visual | Contexto | Help |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| BQC_DDD | Caracter | 3 | 0 | DDD | Codigo do DDD | 999 | Sim | Não | 5 | Alterar | Real | Código do DDD referente ao Telefone. | ||
| BQC_TIPTEL | Caracter | 1 | 0 | Tipo Telefon | Tipo Telefone | @! | Sim | Pertence('123') .Or. Vazio() | 1=Residencial. 2=Profissional. 3=Celular. | Não | 5 | Alterar | Real | Tipo de telefone: Residencial, Profissional, ou Celular. |
Importante
As alterações de dicionário referente a essa implementação estarão disponíveis através de pacote de expedição contínua do plano de saúde com data igual ou superior 13/02/2025.
04. DEMAIS INFORMAÇÕES
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
Manual do PTU de Integrações 8.0
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas