Histórico da Página

...

02. SITUAÇÃO/REQUISITO

É necessário realizar adequações para atender as alterações disponibilizadas pela Unimed Brasil referente a nova versão 02.2025 do PTU On-line.

03. SOLUÇÃO

Adequações gerais conforme manual do PTU.
Adicionado o campo "Versão" na 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.
Adicionado o campo "Motivo de suspensão" na 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 o campo "Endpoint do serviço de contratos" na na tela hgp.integrationsParams, para que seja possível informar o endpoint do serviço de contratos da UB.
Adicionado o campo "Endpoint do serviço de repasse de pré-pagamento (A800)" na na tela hgp.integrationsParams, para que seja possível informar o endpoint do serviço de repasse de pré-pagamento (A800) da UB.
Ao selecionar a versão 02.2025 do PTU Online, abrirá a possibilidade de marcar o campo "Enviar contratos", que indica se deseja começar a utilizar o envio de contratos. A UB irá permitir que entre os períodos 14/02/2025 a 30/04/2025 a Unimed decida o momento que irá começar a utilizar esse processo.
Adicionado campo referente ao Registro ANS da administradora de benefícios na manutenção de pessoas jurídicas (hvp.company).
Adicionado o campo "Existe acordo de comercialização de planos entre Unimeds" na 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) nos Tipos de Anexo, para que seja possível informá-lo na manutenção desse contrato, e que o sistema identifique que esse anexo deve ser enviado junto na no envio da abertura do contrato.
Criada uma uma nova opção "N- Não Binário" no 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.
Criado novo serviço que permite enviar e receber A800.
Criado novo serviço que permite enviar a abertura do contrato, enviar a massa inicial dos beneficiários e enviar o encerramento do contrato.
Criado novo serviço que permite receber a atualização do contrato.
Criado novo serviço que permite receber a atualização dos beneficiários que ficaram em análise no envio do contrato.
O envio e recebimento de A800 passa a ser via PTU Online, a partir do novo serviço que foi criado.
O A300 agora passa a ser enviado via movimentação cadastral, através da tag produtoAgregado. Então 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.
Criado novo serviço que permite enviar a abertura do contrato, enviar a massa inicial dos beneficiários e enviar o encerramento do contrato.

Criado novo serviço que permite receber a atualização do contrato.
Criado novo serviço que permite receber a atualização dos beneficiários que ficaram em análise no envio do contrato.
Disponibilizada a aba "Contrato" na Central PTU, a qual conterá as movimentações de envio de abertura e encerramento do envio da abertura dos contratos.
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.

...

Totvs custom tabs box

tabs	Procedimento para Implantação, Procedimento para Configuração, Procedimento para Utilização
ids	passo1,passo2,passo3

Totvs custom tabs box items

default	yes
referencia	passo1

1. Acesse o menu Importação Menu Datasul (men706aa) e importe o arquivo men_hvp.d.

2. Acesse o menu Programa Produto Datasul (bas_prog_dtsul) e altere os registros "hvp.contractPtuIntegrations" para liberar a permissão de acesso

3. Acesse o menu Atualiza Menu Usuário (mer010aa) e execute a atualização.

Será disponibilizado novas opções de acesso em:
- Central PTU - Envio de contrato: aba Contrato

Informações
As configurações de certificado de ambiente, Tomcat e broker escalável mantém-se as mesmas do PTU Integrações 8, conforme o DT Adequações PTU Integrações 8.0.

Totvs custom tabs box items

default	no
referencia	passo2

Versão do PTU

Ajustado o campo da versão do PTU, adicionando a versão 02.2025.

Totvs custom tabs box items

default	no
referencia	passo3

A seguir estão dispostos na estrutura do JSON as alterações/inclusõ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 - Campo 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 ("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 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 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
- 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.
compartilhamentoRiscodadosPlano
- Tag de carencias renomeada para cobertura;
  - dataFimCarencia renomeada para dataFimCobertura;
- carencia - Adicionado novo bloco de carências
  - tipoCarencia
  - dataBaseCarencia
  - dataFimCarencia

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 ou pela tela de auditoria de contatos (hvp.auditContract), através do 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. Se for enviado um acordo de comercialização entre as Unimeds, a Unimed do Brasil irá analisar o arquivo enviado e enviará uma resposta posteriormente, seja do contrato ou dos beneficiários. O status desses envios poderá ser consultado pela Central PTU (aba Contrato), os quais poderão ser reprocessados em caso de erro.

Informações

Importante: Junto a Unimed do Brasil deve ser feita a configuração do endpoint para recebimento do da atualização do contrato, e recebimento da atualização dos beneficiários da massa inicial do contrato.

Endpoint externo do recebimento da atualização do Contrato:

http://{HOST}:{PORTA}/totvs-hgp-webservices/ptu/online/respostaEnvioContratos

Endpoint externo do recebimento da atualização dos beneficiários do contrato:

http://{HOST}:{PORTA}/totvs-hgp-webservices/ptu/online/beneficiarios

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

Importação e Exportação de Repasse de Pré-Pagamento (A800)

Com o PTU 02.2025 a importação e exportação de Repasse de Pré-Pagamento (A800) passam a ser realizadas via PTU Online.

Quando for realizada uma importação (recebimento), o sistema criará o lote e também deixará disponível o anexo para download nos detalhes do lote, o qual pode ser acessado pela mesma tela (hcg.centralPTU - menu A800).

Quando for realizada uma exportação (envio), o sistema enviará para a UB os dados juntamente com o anexo, que encaminhará para a Unimed de destino que automaticamente fará a importação do A800.

Informações

Importante: Junto a Unimed do Brasil deve ser feita a configuração do endpoint para recebimento do A800.

Endpoint externo do recebimento do A800:

http://{HOST}:{PORTA}/totvs-hgp-webservices/ptu/online/a800-prepagto

Estrutura do JSON

cabecalho
- codigoControleTransacao
- codigoUnimedOrigem
- codigoUnimedDestino
- numeroVersaoPTU
dadosFatura
- dataGeracao
- competencia
- dataInicialPeriodo
- dataFimPeriodo
- dataVencimentoDocumento
- dataEmissaoDocumento
- valorTotalDocumento
- valorLiquido
- valorAjusteDocumento
- valorIR
- numeroDocumento
- numeroDocumentoFiscal
- tipoDocumento
- dadosBeneficiario
  - codigoCarteiraBeneficiario
  - dependencia
  - dataNascimento
  - valorMensalidadeCobrada
  - valorInscricaoCobrada
  - valorAjuste
  - codigoEmpresa
  - dadosPlanoInter

...

Árvore de páginas

Versões comparadas

Versão antiga 27

Nova versão 28

Chave

02. SITUAÇÃO/REQUISITO

03. SOLUÇÃO