Histórico da Página

Adequações gerais no processo de movimentação de beneficiários para a versão 02.2025 do PTU Online

• Adicionado o campo Versão na tela hgp.integrationsParams para que seja possível selecionar qual a versão do serviço de movimentação de beneficiários será utilizada pelo sistema.
• Para que as alterações dispostas nessa seção sejam aplicadas, a versão PTU Online 02.2025 deve estar configurada na tela hgp.integrationsParams.
• Adicionado o campo Motivo de suspensão na tela hgp.integrationsParams para que seja possível selecionar o motivo de suspensão padrão no caso de um recebimento em que o beneficiário está suspenso. O qual vai criar/atualizar o registro na tela hmc.beneficiaryTemporarySuspension.
• Adicionado campo referente ao Registro ANS da administradora de benefícios na manutenção de pessoas jurídicas (hvp.company).
• Criada uma nova opção N- Não Binário no campo Gênero Social das seguintes telas:
  • Manutenção de beneficiários (interna e Portal Empresa);
  • Manutenção de pessoa física;
  • Manutenção de Contratantes;
  • Manutenção de Prestadores.
• Efetuada alteração na tela Tipos de carência x Módulo (hvp.carenceTypeModules). O campo tipo de carência existente passou a se chamar tipo de cobertura, e foi incluído um campo novo chamado "Tipo de carência", os quais usam respectivamente os valores das tabelas K e K1 do PTU Anexos. Dessa forma Deve-se executar a spp "sp-ajusta-tipo-carencia-k1.p" para alterar o tipo de carência para o tipo de cobertura e preencher o tipo de carência conforme de-para a seguir.
• Image Added
• Alteração na tela hvp.contractTemporarySuspension - Suspensão temporária dos contratos, para que nas ações de inclusão/alteração/exclusão seja realizada uma movimentação no PTU online para cada beneficiário cadastrado no contrato suspenso.
  • Inclusão - Envio de movimentação dos beneficiários do contrato, marcando que o mesmo está suspenso caso seja um usuário repasse.
  • Alteração - Envio de movimentação dos beneficiário do contrato, caso seja alterada a data final de suspensão.
  • Exclusão - Envio de movimentação dos beneficiários do contrato, desmarcando a suspensão caso se encaixe nas regras  caso seja um usuário repasse.

A seguir estão dispostos na estrutura do JSON as principais alterações referentes ao PTU Online 02.2025.

Após o serviço ser habilitado, todas movimentações passíveis de envio para a Unimed Brasil serão processadas e enviadas de maneira automática. A movimentação pode ser consultada via Central PTU na aba PTU Movimentação.

Importante: Para beneficiários existentes na base é necessário que seja feita a atualização do Código de Controle Unimed. Foi disponibilizado a seguinte SP que permite importar o arquivo CSV que pode ser solicitado a Unimed Brasil.

Em situações especificas, onde seja necessário envio manual de dados que não tenham sido enviados de forma automática é possível fazer utilização da seguinte SP. 

Importante: Junto a Unimed do Brasil deve ser feita a configuração do endpoint para recebimento do compartilhamento de risco. Abaixo é possível verificar.

Endpoint externo do Compartilhamento de Risco:

http://{HOST}:{PORTA}/totvs-hgp-webservices/ptu/v8/integrations/beneficiarios/compartilhamento-riscos

Também criamos um endpoint que pode ser utilizado para verificar as as variáveis de ambiente do Tomcat estão configuradas corretamente. Esse serviço estará disponível somente a partir do patch 12.1.2311.12, 12.1.2403.8 e 12.1.2407.2.

Endpoint para validação de variáveis de ambiente:

http://{HOST}:{PORTA}/totvs-hgp-webservices/ptu/v8/integrations/gateway/serverInfo

Envio da movimentação de beneficiários

Adequação dos campos de acordo com o layout:

• cabecalho
  • codigoVersaoPtu: Adaptado para poder receber a nova versão ("

• • 001");
  • protocoloContrato - Após o envio com sucesso da abertura do contrato, deverão ser enviados todos os beneficiários que fazem parte da massa inicial desse contrato, com esse campo preenchido. Após o envio do contrato ser encerrado, esse campo não deve mais ser preenchido.
• dadosBeneficiario
  • motivoExclusaoBeneficiario - Ajustes de validação.
  • valorMensalidade

• • - Campo adicionado, valor é preenchido da mesma forma que no A300
  • rendaMensal - Campo adicionado, valor é preenchido da mesma forma que no A300
  • carteirinhaAnterior - Campo adicionado, valor é preenchido da mesma forma que no A300
  • idFilho - Campo adicionado, valor é preenchido da mesma forma que no A300
  • produtoAgregado - Alteração com adição de campos para funcionar como o A300
    • indicadorCompartilhamento - Se o beneficiário for de compartilhamento de risco (A100), será true, e false quando for produto externo (A300).
    • codigoUnimedDestino - Obrigatório quando tiver produto agregado
    • tipoProduto - Obrigatório quando tiver produto agregado
    • descricaoProduto
    • codigoPlanoDestino - Obrigatório quando tiver produto agregado
    • dataRepasseUnimedDestino - Obrigatório quando tiver produto agregado
    • dataInicioVigenciaProduto - Obrigatório quando tiver produto agregado
    • dataFimVigenciaProduto
  • dadosCooperado
    • cdigoUfConselho  - Tratado para utilizar a codificação do IBGE.
• dadosEmpresaContratante
  • dataInclusaoEmpresaUnimed - Obrigatório quando tiver produto agregado

• • dataExclusaoEmpresaUnimed
  • endereco
    • logradouroPrincipal: Tamanho aumentado para 80 caracteres;
    • complementoLogradouro: Tamanho aumentado para 80 caracteres;
    • bairro: Tamanho aumentado para 45 caracteres;
    • telefone  - Adicionados dados de telefone do contratante

• • • • tipoTelefone
      • ddd
      • numero
      • ramal
• dadosPlano
  • registroANSAdmBeneficios - Adicionado campo que utiliza o valor do campo que foi adicionado na tela hvp.company

• • abrangencias
    • codigoUf  - Tratado para utilizar a codificação do IBGE.
  • Tag carencias renomeada para cobertura;
    
    • dataFimCarencia renomeada para dataFimCobertura;
  • carencias - Adicionado novo bloco de carências
    • tipoCarencia
    • dataBaseCarencia
    • dataFimCarencia

• dadosPessoa
  • generoSocial: Adicionada opção N - Não binário;
  • rg
    • uf: Tratado para utilizar a codificação do IBGE;
  • complementosCadastrais
    • enderecos
      • tipoResidencia - Ajustada regra de obrigatoriedade.
      • lograduro - Tamanho aumentado para 80 caracteres;
      • bairro - Tamanho aumentado para 45 caracteres;
      • complemento - Tamanho aumentado para 80 caracteres;

• compartilhamentoRisco
  • indicadorSuspensaoAtendimento - Indica se o beneficiário deve ter a suspensão ou normalização do atendimento.

Recebimento da movimentação de beneficiários de compartilhamento de risco

Adequação dos campos de acordo com o layout:

• cabecalho
  • codigoVersaoPtu: Adaptado para poder receber a nova versão ("

• • 001");
• dadosBeneficiario
  • motivoExclusaoBeneficiario - Ajustes de validação
  • produtoAgregado

• codigoUnimedDestino
• tipoProduto
• descricaoProduto
• codigoPlanoDestino
• dataRepasseUnimedDestino
• dataInicioVigenciaProduto
• dataFimVigenciaProduto

• • - Alteração com adição de campos para funcionar como o A300
    • indicadorCompartilhamento - Se o beneficiário for de compartilhamento de risco (A100), será true, e false quando for produto externo (A300).
    • codigoUnimedDestino - Obrigatório quando tiver produto agregado
    • tipoProduto - Obrigatório quando tiver produto agregado
    • descricaoProduto
    • codigoPlanoDestino - Obrigatório quando tiver produto agregado
    • dataRepasseUnimedDestino - Obrigatório quando tiver produto agregado
    • dataInicioVigenciaProduto - Obrigatório quando tiver produto agregado
    • dataFimVigenciaProduto
  • idFilho
  • valorMensalidade
  • rendaMensal
  • indicadorSuspensaoAtendimento - Indica se o beneficiário deve ter a suspensão ou normalização do atendimento. No caso de estar recebendo uma suspensão, será criado/atualizado o registro na tela hmc.beneficiaryTemporarySuspension, usando o motivo de suspensão padrão configurado na tela hgp.integrationsParams.
• dadosPlano
  • Tag

• • carencias renomeada para cobertura;
    
    • dataFimCarencia renomeada para dataFimCobertura;
  • carencia - Adicionado novo bloco de carências
    • tipoCarencia
    • dataBaseCarencia
    • dataFimCarencia
• dadosPessoa
  • generoSocial: Adicionada opção N - Não binário;
  • rg
    • uf: Tratado para utilizar a codificação do IBGE;

Recebimento do retorno da movimentação de beneficiários de compartilhamento de risco

Adequação dos campos de acordo com o layout:

• cabecalho
  • protocoloContrato
• dadosBeneficiario
  • codigoControleUnimedBrasil : Adicionado código de controle da Unimed do Brasil;- Opcional, somente será recebido se o beneficiário foi incluído na Brasil.
• statusProcessamento
  • statusProcessamento 
    • status: É possível que a UB retorne um novo status: "A" - Análise.
• compartilhamentoRiscodadosPlano
  • Tag de carencias renomeada para cobertura;
    • dataFimCarencia renomeada para dataFimCobertura;