Histórico da Página

01. DADOS GERAIS

Produto:	TOTVS Saúde Planos
Linha de Produto:	Linha Datasul
Segmento:	Saúde
Módulo:	HVP
Função:	Central PTU
País:	Brasil

Nota

title	Importante

Os novos serviços de envio/recebimento de A800, e Envio Contrato (VCOM) estão sendo liberados parcialmente pois a Unimed do Brasil ainda não disponibilizou totalmente os ambiente para que seja possível efetuar a homologação, então esses processos poderão sofrer mudanças que serão entregues nos próximos patches.

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.

Informações

title	Vigência

As alterações do A300 e Suspensão de Beneficiários entram em vigência a partir de 14/02/2025. VCOM tem vigência na mesma data, porém de maneira opcional.

Informações

title	Pacote Complementar

Os arquivos abaixo contém as últimas correções e ajustes do processo e podem ser utilizados com a versão indicada:

Últimas atualizações:

27/01/2025 - Ajustes referentes a:
- Abono carências na inclusão
07/03/2025 - Ajustes referentes a:
- Problema relacionado ao campo codigoUnimedOrigem (envio VCOM)

Versão

Compilação Progress 12 para os patches disponíveis

(Bancos Progress e Oracle)

Arquivo .war Tomcat

12.1.2503

12.1.2503.0

Sem alterações

12.1.2411

12.1.2411.5 / 12.1.2411.4 / 12.1.2411.3

totvs-hgp-integrations-params (12.1.2411.3)

12.1.2407

12.1.2407.11 / 12.1.2407.10 / 12.1.2407.9

totvs-hgp-integrations-params (12.1.2407.9)

Outras informações:

Arquivos .war devem ser colocados na pasta webapps do Tomcat

Totvs custom tabs box

tabs	Procedimento para Implantação, Movimentação de Beneficiários, A300, Envio de Contrato (VCOM)
ids	passo1,passo2,passo3,passo4

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

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

...

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.

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.

...

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

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 Modified

Totvs custom tabs box

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

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.

Totvs custom tabs box items

default	yes
referencia	passo1

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.

Image Removed

passo3

Totvs custom tabs box items

default

no

referencia

A seguir estão dispostos na estrutura do JSON as principais 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 - 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

Totvs custom tabs box items

default	no
referencia	passo3

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

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

Totvs custom tabs box items

default	no
referencia	passo4

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 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, os quais poderão ser reprocessados em caso de erro

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.

Informações

Importante: Junto a Unimed do Brasil deve ser feita a configuração do endpoint para recebimento 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

Documentações Relacionadas:

...

Manutenção dos Tipos de Documentos hcg.attachmentType

Manutenção Contratos - hvp.contract

Auditoria Contratos hvp.auditContract

DSAUGPSCONTRAT2-18799 DT SP para Envio Manual no Serviço de Movimentação de Beneficiários

...

CPC826_CPC_BOSAUPTUINTEGRATIONSCOMPRISCO

Manutenção Suspensão Temporária do Contrato - hvp.contractTemporarySuspension

HTML

			<style>				div.theme-default .ia-splitter #main {					margin-left: 0px;				}				.ia-fixed-sidebar,				.ia-splitter-left {					display: none;				}				#main {					padding-left: 10px;					padding-right: 10px;					overflow-x: hidden;				}				.aui-header-primary .aui-nav,				.aui-page-panel {					margin-left: 0px !important;				}				.aui-header-primary .aui-nav {					margin-left: 0px !important;				}			</style>

Árvore de páginas

Versões comparadas

Versão antiga 29

Nova versão Atual

Chave

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

03. SOLUÇÃO