Histórico da Página

...

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

Totvs custom tabs box

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

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

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 -

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

A800

Envio Contrato

Totvs custom tabs box

tabs	Procedimento para Implantação, A800, Envio de Contrato (VCOM), Procedimento para Utilização
ids	passo1,passo2,passo3,passo4

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

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

Totvs custom tabs box items

default	no
referencia	passo3

Totvs custom tabs box items

default	no
referencia	passo4

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

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

Totvs custom tabs box items

default	no
referencia	passo4

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

A partir do início da utilização da versão PTU Online 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 Unimed do Brasil os dados juntamente com o anexo, que encaminhará para a Unimed de destino que automaticamente fará a importação do A800.

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

O envio e recebimento de A800 passa a ser via PTU Online, a partir do momento em que for configurada a versão PTU Online 02.2025 na tela hgp.integrationsParams.
Deve ser configurado o endpoint do serviço de repasse de pré-pagamento (A800) da Unimed do Brasil no campo Endpoint do serviço de repasse de pré-pagamento (A800) 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).
Dessa forma ao realizar uma exportação, os arquivos serão enviados para a central de documentos e também automaticamente serão enviados para a Unimed do Brasil, que por sua vez enviará para a Unimed destino que realizará a importação do A800. Mais informações podem ser conferidas na documentação Exportação para faturamento de intercâmbio de pré-pagamento - hfp.exportInvoiceExchange.
Ao receber via PTU Online uma importação de A800, o mesmo será processado da mesma forma como é feita via arquivo hoje, e nos detalhes do lote de importação que será criado, haverá o botão Baixar anexo, o qual conterá o arquivo recebido da outra Unimed, mais informações podem ser conferidas na documentação Importação de Repasse de Pré-Pagamento (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:

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

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.

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

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

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	passo5

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.

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

Totvs custom tabs box items

default	no
referencia	passo6

Integração GPU com GIU

Com a liberação da versão PTU 02.2025, serão feitas adequações no processo de integração GPU com GIU e a liberação do serviço de anexo de arquivos.

Adequações gerais do JSON

cabecalho
- nr_versao: valor fixo alterado de 001 para 002
solicitar_protocolo (Exemplo de um dos tipos, as mudanças equivalem para todos os métodos que possuem os campos abaixo)
- tp_manifestacao: adicionado novo tipo
- tp_categoria_manifestacao: mudança nos tipos válidos
- tp_sub_categoria: novo campo para especificação baseado no campo tp_categoria_manifestacao

Envio e recebimento de anexos

Estrutura do JSON

cabecalho_transacao
- cd_transacao
- tp_cliente
- cd_uni_origem
- cd_uni_destino
- nr_ans
- nr_transacao_prestadora
- dt_manifestacao
- id_usuario
- nr_versao_protocolo
anexar_arquivo
- nr_protocolo

O arquivo anexado na requisição deverá ser do tipo .zip com no máximo dez anexos compactados.

Informações

Importante: As novas funcionalidades só serão aplicadas ao processo quando a versão do GPU for atualizada para Versão 2 na Central de Integração Saúde Planos (hgp.integrationParams). E os anexos só serão enviados para integração caso a opção de Enviar anexos para beneficiários de intercâmbio esteja habilitada.

Image Added