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
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. 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 - 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
:telefoneTag de - tipoTelefone
- ddd
- numero
- ramal
- dadosPlano
- - 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;
carencia- 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
Envio da abertura, da massa inicial de beneficiários e do encerramento do contrato Este processo deve ser realizado apenas uma vez, com a carga inicial dos beneficiários do contrato. Essa ação será disparada manualmente através de um botão presente dos detalhes do contrato. Após realizar o envio da abertura do contrato, o sistema enviará os beneficiários que fazem parte dessa massa inicial e após isso enviará o encerramento do contrato. O status desses envios poderá ser consultado pela Central PTU, os quais poderão ser reprocessados em caso de erro. Se a Unimed possuir acordo de comercialização de planos com outras Unimeds, tanto os envios do contrato quanto os envios dos beneficiários ficarão com o status "Análise", o qual será atualizado posteriormente após a UB analisar o arquivo do acordo que foi anexado no envio da abertura do contrato. Endpoint do retorno do compartilhamento de risco/movimentação cadastral: http://{HOST}:{PORTA}/totvs-hgp-webservices/ptu/online/beneficiarios Endpoint da resposta do envio do contrato: http://{HOST}:{PORTA}/totvs-hgp-webservices/ptu/online/respostaEnvioContratos cabecalho- codigoControleTransacao
- codigoVersaoPTU
- codigoUnimedOrigem
- dataGeracao
dadosEmpresaContratante- tipoEmpresa
- cnpjEmpresaMatriz
- nomeEmpresa
- quantidadeBeneficiariosInicial
- indicadorProcesso
dadosAcordoindicadorAcordoarquivoAcordo | 
