Exibir origem

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

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 no patch do dia 13/01/2025, conforme comunicado liberado a todos os clientes.

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

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

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.

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.

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

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

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

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

Documentações Relacionadas:

Central PTU - Envio de contratos

Central PTU - Movimentação de Beneficiário

Como criar variaveis de ambiente visiveis ao Datasul no Tomcat

Central de Integrações Saúde Planos (hgp.integrationsParams)

Manutenção Suspensão Temporária de Beneficiário - hmc.beneficiaryTemporarySuspension

Manutenção Pessoa Jurídica hvp.company

Manutenção dos Tipos de Documentos hcg.attachmentType

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

DSAUGPSCONTRAT2-18985 DT SP Carga Código Controle Do Beneficiário

CPC827_CPC_BOSAUPTUINTEGRATIONS

CPC826_CPC_BOSAUPTUINTEGRATIONSCOMPRISCO

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