01. DADOS GERAIS
| Produto: | TOTVS Saúde Planos |
|---|---|
| Linha de Produto: | Linha Datasul |
| Segmento: | Saúde |
| Módulo: | HVP - Venda de Planos |
| Função: | Central PTU |
| País: | Brasil |
02. SITUAÇÃO/REQUISITO
A versão 09.2025 do PTU Online introduziu mudanças importantes que impactam a estrutura de dados e as regras de atendimento do sistema. Destacam-se alterações no layout Cadbenef, com a inclusão de novos tipos de dependência, campos obrigatórios e ajustes no preenchimento de valores.
Uma das principais atualizações é o novo campo "indicadorAtendimentoUrgencia", relacionado ao compartilhamento de risco, que exige adequações tanto no layout do cartão magnético quanto na lógica de autorização de atendimentos. A partir desta versão, passa a ser necessário que o sistema bloqueie atendimentos de urgência e emergência fora da abrangência contratual para beneficiários cuja cobertura não seja nacional.
Essas atualizações têm como objetivo garantir maior conformidade com as regras contratuais das operadoras em atendimentos de urgência e emergência.
03. SOLUÇÃO
Bloqueio de Atendimento em Urgência e Emergência
Para atender aos requisitos, as alterações foram implementadas nas seguintes etapas:
Foi adicionada a opção: "Bloquear o atendimento de urgência e emergência fora da abrangência"
Essa nova opção está disponível na tela de contratos indicando se o atendimento de Urgência e Emergência será permitido em todo o território nacional para contratos com abrangências que não são de nível nacional.
Cartão Beneficiário 8.0
Foi ajustado o layout 8.0 (programa lap\lamc003o.p) para que, ao gerar o cartão, verifique o novo parâmetro. Se estiver ativo, a mensagem será alterada para "Urgência/emergência restrita à área de abrangência do produto.". Caso contrário, manterá o comportamento atual.
Adequações para a versão do PTU Online 09.2025
Versão 09.2025 disponibilizada para seleção nas configurações "Parâmetros de Integração PTU Movimentação" - hgp.integrationsParams
As adaptações necessárias para atender ao layout PTU versão 09.2025 foram concluídas com sucesso. As seguintes ações foram executadas:
- Inclusão de novos tipos de dependência:
Os tipos "Neto", "Genro" e "Nora" foram adicionados ao cadastro de beneficiários e contemplados na geração do layout PTU.
- Tratamento do campo codigoControleRemido:
Foi implementada a lógica para preencher esse campo sempre que o indicadorRemido estiver com valor true. O campo é preenchido com o código controle Unimed do beneficiário remido.
Também foram ajustados os preenchimentos da carteirinha do titular e o grau de dependência, conforme as orientações do manual. - Ajuste do campo valorMensalidade:
O campo foi devidamente ajustado dentro do bloco produtoAgregado para refletir os novos critérios de preenchimento. - Campos obrigatórios no produtoAgregado:
Foram aplicadas as novas regras de obrigatoriedade para os campos:- codigoPlanoDestino
- dataRepasseUnimedDestino
- dataInicioVigenciaProduto
- dataBaseCarencia
- Ajuste da regra de obrigatoriedade do campo tipoContrato:
Foi adicionada validação obrigatória para garantir que esse campo esteja sempre preenchido no layout gerado.
- Envio do campo indicadorAtendimentoUrgencia:
Implementado o envio do novo campo conforme regra de bloqueio de atendimento. O valor é definido como false quando o contrato possui o bloqueio marcado e true nos demais casos.
O processo de importação foi ajustado para suportar o layout PTU 09.2025.
- O campo "
indicadorAtendimentoUrgencia"passou a ser interpretado - O processamento do campo "
valorMensalidade"foi atualizado para refletir corretamente o novo layout.
- O campo "
Adequações de Campos Numéricos e Integrações PTU 09.2025
- Campos numéricos com mais de 16 posições foram adequados para envio e recebimento no formato alfanumérico (string), conforme nova especificação.
Ajustes aplicados nos seguintes processos:
CadBenef
Compartilhamento de Risco
A800 Online
- Envios contratos
- Adicionada Opção "PTU 09.2025" nos Parâmetros de Integração PTU A800



