DT PTU ONLINE 02.2025

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.
• 
• 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.

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 - 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 - 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.
• compartilhamentoRisco
  • Tag de carencias renomeada para cobertura;
    • dataFimCarencia renomeada para dataFimCobertura;
  • carencia - Adicionado novo bloco de carências
    • tipoCarencia
    • dataBaseCarencia
    • dataFimCarencia

A300 - Produto

• A partir do início da utilização da versão PTU Online 02.2025 o envio e o recebimento de A300 passam a ser realizados via serviço de movimentação de beneficiários. 

Instruções para a correta utilização deste processo

• Para que o A300 passe a ser enviado e recebido via movimentação de beneficiários, deve ser configurada a versão PTU Online 02.2025 na tela hgp.integrationsParams.
• Dessa forma, sempre que o beneficiário receber um novo produto, módulo de cobertura, que seja produto terceirizado, deve ser gerado um envio de movimentação de beneficiário com todos os produtos que esse beneficiário possui. Assim como, se o beneficiário tiver esse produto cancelado ou excluído, deve ser enviado o beneficiário com as informações do produto em questão.

Exemplo do JSON de envio referente a parte do A300

• dadosBeneficiario
  • 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
• dadosEmpresaContratante
  • dataInclusaoEmpresaUnimed - Obrigatório quando tiver produto agregado
  • dataExclusaoEmpresaUnimed

Exemplo do JSON de recebimento referente a parte do A300

• dadosBeneficiario
  • idFilho
  • valorMensalidade
  • rendaMensal
  • 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

Envio da abertura do contrato, da massa inicial de beneficiários e do encerramento do contrato

A Unimed do Brasil criou um processo junto ao envio de dados de beneficiários para verificar se ao fechar um novo contrato, uma operadora está realizando invasão de área de outra operadora. Para isso deve ser enviado um contrato e sua massa de beneficiários para a Brasil avaliar ou não se existe invasão de área.

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 (Manutenção Contratos - hvp.contract) ou pela tela de auditoria de contatos (Auditoria Contratos hvp.auditContract), se o campo "Enviar contrato e beneficiários - PTU" estiver marcado no momento de realizar a auditoria.

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.

Instruções para a correta utilização deste processo

• Esse serviço passará a funcionar a partir do momento em que for configurada a versão PTU Online 02.2025 na tela hgp.integrationsParams.
  • Ao selecionar a versão 02.2025 do PTU Online, abrirá a possibilidade de marcar o campo Enviar contratos, que indica se deseja realmente começar a utilizar serviço o envio de contratos. A Unimed do Brasil permitirá que entre os períodos 14/02/2025 a 30/04/2025 a Unimed decida o momento correto para começar a utilizar esse processo.
• Deve ser configurado o endpoint de contratos da Unimed do Brasil no campo Endpoint do serviço de contratos que foi adicionado à tela hgp.integrationsParams. A URL a ser configurada pode ser conferida ao final da documentação da página Central de Integrações Saúde Planos (hgp.integrationsParams).
• Adicionado o campo Existe acordo de comercialização de planos entre Unimeds na tela hcg.attachmentType, o qual indica que o tipo de documento é referente à acordo de comercialização de planos entre Unimeds.
  • No caso do envio de contratos que possuam esse acordo entre Unimeds, esse tipo de documento deve estar relacionado com a manutenção de contratos na tela (hcg-associativeProcessAttachments), para que seja possível informá-lo na manutenção desse contrato, e que o sistema identifique que esse anexo deve ser enviado junto no envio da abertura do contrato.
• Disponibilizada a aba Contrato na Central PTU (Central PTU - Envio de contratos), na qual poderão ser consultadas as movimentações de envio de abertura e encerramento dos contratos.
• Ao realizar o envio do contrato, se ocorrer algum erro o envio tanto do contrato quanto dos beneficiários poderá ser reprocessado via Central PTU. Caso seja enviado um anexo de acordo de comercialização de planos entre Unimeds, a Unimed do Brasil irá analisar o documento enviado e retornará em um momento posterior, se comunicando através dos endpoints que estão descritos logo a seguir, para que o contrato/beneficiários sejam atualizados.

Envio do contrato

• cabecalho
  • codigoControleTransacao
  • codigoVersaoPTU
  • codigoUnimedOrigem
  • codigoUnimedDestino
  • dataGeracao
• dadosEmpresaContratante
  • tipoEmpresa
    • cnpj
    • caepf
    • cpf
  • cnpjEmpresaMatriz
  • nomeEmpresa
  • quantidadeBeneficiariosInicial
  • indicadorProcesso
• dadosAcordo
  • indicadorAcordo
  • arquivoAcordo

Resposta do envio do contrato

• cabecalho
  • codigoControleTransacao
  • codigoVersaoPTU
  • codigoUnimedOrigem
  • codigoUnimedDestino
  • dataGeracao
  • protocoloContrato
• statusProcessamento
  • statusProcessamento
    • statusProcessamento
    • codigoMensagem
    • descricaoMensagem