Linha Datasul

Árvore de páginas


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



Importante

Os novos serviços de envio/recebimento de A800 estão sendo liberados parcialmente, pois a Unimed do Brasil ainda não disponibilizou totalmente os 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 04.2025 do PTU On-line.

03. SOLUÇÃO

  • Adequações gerais conforme manual do PTU.


Vigência

Essas alterações tem vigência a partir de 30/04/2025.


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


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



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.


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.

Junto a Unimed do Brasil deve ser feita a configuração do endpoint para recebimento dos anexos do protocolo.

Endpoint externo do recebimento de anexos do protocolo:

http://{HOST}:{PORTA}/totvs-hgp-webservices/gpu/v1/uploadAnexarProtocolo




Documentações Relacionadas:

Central PTU - Envio de contratos

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

Exportação para faturamento de intercâmbio de pré-pagamento - hfp.exportInvoiceExchange

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