Após o serviço ser habilitado, todas movimentações passíveis de envio para a Unimed Brasil serão processadas e enviadas de maneira automática. A movimentação pode ser consultada via Central PTU na aba PTU Movimentação.
Importante: Para beneficiários existentes na base é necessário que seja feita a atualização do Código de Controle Unimed. Foi disponibilizado a seguinte SP que permite importar o arquivo CSV que pode ser solicitado a Unimed Brasil. Em situações especificas, onde seja necessário envio manual de dados que não tenham sido enviados de forma automática é possível fazer utilização da seguinte SP.
Também criamos um endpoint que pode ser utilizado para verificar as as variáveis de ambiente do Tomcat estão configuradas corretamente. Esse serviço estará disponível somente a partir do patch 12.1.2311.12, 12.1.2403.8 e 12.1.2407.2. Endpoint para validação de variáveis de ambiente: http://{HOST}:{PORTA}/totvs-hgp-webservices/ptu/v8/integrations/gateway/serverInfo
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
- dadosBeneficiario
- valorMensalidade
- rendaMensal
- carteirinhaAnterior
- idFilho
- produtoAgregado
- indicadorCompartilhamento
- codigoUnimedDestino
- tipoProduto
- descricaoProduto
- codigoPlanoDestino
- dataRepasseUnimedDestino
- dataInicioVigenciaProduto
- dataFimVigenciaProduto
- dadosEmpresaContratante
- dataInclusaoEmpresaUnimed
- dataExclusaoEmpresaUnimed
- endereco
- logradouroPrincipal: Tamanho aumentado para 80 caracteres;
- complementoLogradouro: Tamanho aumentado para 80 caracteres;
- bairro: Tamanho aumentado para 45 caracteres;
- Adicionados dados de telefone do contratante:
- telefone
- tipoTelefone
- ddd
- numero
- ramal
- dadosPlano
- registroANSAdmBeneficios
- Tag de carencias renomeada para cobertura;
- dataFimCarencia renomeada para dataFimCobertura;
- carencia
- tipoCarencia
- dataBaseCarencia
- dataFimCarencia
- dadosPessoa
- generoSocial: Adicionada opção N - Não binário;
- rg
- uf: Tratado para utilizar a codificação do IBGE;
- compartilhamentoRisco
- indicadorSuspensaoAtendimento
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");
- protocoloContrato
- dadosBeneficiario
- indicadorSuspensaoAtendimento
- produtoAgregado
- indicadorCompartilhamento
- codigoUnimedDestino
- tipoProduto
- descricaoProduto
- codigoPlanoDestino
- dataRepasseUnimedDestino
- dataInicioVigenciaProduto
- dataFimVigenciaProduto
- statusProcessamento
- status: É possível que a UB retorne um novo status: "A" - Análise.
- dadosPlano
- Tag de carencias renomeada para cobertura;
- dataFimCarencia renomeada para dataFimCobertura;
- carencia
- 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
- codigoControleUnimedBrasil: Adicionado código de controle da Unimed do Brasil;
- dadosPlano
- Tag de carencias renomeada para cobertura;
- dataFimCarencia renomeada para dataFimCobertura;
- carencia
- tipoCarencia
- dataBaseCarencia
- dataFimCarencia
Envio da abertura, da massa inicial de beneficiários e do encerramento do contrato 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. 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. O status desses envios poderá ser consultado pela Central PTU, os quais poderão ser reprocessados em caso de erro. Se a Unimed possuir acordo de comercialização de planos com outras Unimeds, tanto os envios do contrato quanto os envios dos beneficiários ficarão com o status "Análise", o qual será atualizado posteriormente após a UB analisar o arquivo do acordo que foi anexado no envio da abertura do contrato.
Endpoint do retorno do compartilhamento de risco/movimentação cadastral: http://{HOST}:{PORTA}/totvs-hgp-webservices/ptu/online/beneficiarios Endpoint da resposta do envio do contrato: http://{HOST}:{PORTA}/totvs-hgp-webservices/ptu/online/respostaEnvioContratos
- cabecalho
- codigoControleTransacao
- codigoVersaoPTU
- codigoUnimedOrigem
- dataGeracao
- dadosEmpresaContratante
- tipoEmpresa
- cnpjEmpresaMatriz
- nomeEmpresa
- quantidadeBeneficiariosInicial
- indicadorProcesso
- dadosAcordo
- indicadorAcordo
- arquivoAcordo
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 webservice. 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.
Endpoint de importação do A800: http://{HOST}:{PORTA}/totvs-hgp-webservices/ptu/online/a800-prepagto
- cabecalho
- codigoControleTransacao
- codigoUnimedOrigem
- codigoUnimedDestino
- numeroVersaoPTU
- dadosFatura
dataGeracao competencia dataInicialPeriodo dataFimPeriodo dataVencimentoDocumento dataEmissaoDocumento valorTotalDocumento valorLiquido valorAjusteDocumento valorIR numeroDocumento numeroDocumentoFiscal tipoDocumento - dadosBeneficiario
| 
