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 ("
011- 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
rendaMensalcarteirinhaAnterioridFilhoprodutoAgregado- codigoUnimedDestino
- tipoProduto
- descricaoProduto
- codigoPlanoDestino
- dataRepasseUnimedDestino
- dataInicioVigenciaProduto
- dataFimVigenciaProduto
dadosEmpresaContratante- - 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
dataInclusaoEmpresaUnimed telefone- 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
de - 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 ("
011protocoloContratodadosBeneficiarioprodutoAgregado- codigoUnimedDestino
- tipoProduto
- descricaoProduto
- codigoPlanoDestino
- dataRepasseUnimedDestino
- dataInicioVigenciaProduto
- dataFimVigenciaProduto
statusProcessamentostatus: É possível que a UB retorne um novo status: "A" - Análise- dadosBeneficiario
- motivoExclusaoBeneficiario - Ajustes de validação
- 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
- 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
de - 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
- 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;
- carencia - Adicionado novo bloco de carências
- tipoCarencia
- dataBaseCarencia
- dataFimCarencia
| 
