Visão Geral

As integrações PTU disponíveis no Tomcat possibilitam o acesso às ferramentas institucionais do sistema da Unimed Brasil.

O processo na utilização dos programas continuará o mesmo. Também é necessário ressaltar que essa implementação é expedida juntamente com o TOTVS12, não sendo mais necessário atualizar a aplicação externa FOUNDATION considerando os processos já migrados.


Endpoints

Abaixo estão listados os serviços disponíveis e seus respectivos endpoints.

A510/A515 - Baixa de Faturas

Endereço: http://<SERVIDOR>/totvs-hgp-webservices/ptu/v1/a510


Requisição:

Exemplo de requisição com os campos mínimos obrigatórios:


   "codigoUnimedOrigemMensagem": "8888", 
   "codigoUnimedDestinoMensagem": "9999", 
   "versaoTransacao": "02", 
   "codigoUnimedRecebeuCobranca": "9999", 
   "numeroDocumento1": "MMMMKKKKKWWWWOOOOPPPP", 
   "tpDocumento1": "3",
"valorTotalPagoDoc1": "1000",
   "dataPagamentoDoc1": "2022-03-03", 
   "identificadorPagamentoDoc1": "83495798347589", 
   "debug": true 
}


ParâmetrosDescrição
codigoUnimedOrigemMensagem

Código da Unimed Origem do PTUA510 

codigoUnimedDestinoMensagemCódigo da Unimed Destino do PTUA510 
versaoTransacaoNúmero da versão da transação 
codigoUnimedRecebeuCobrancaCódigo da Unimed que recebeu a cobrança
numeroDocumento1Número do Documento 1
numeroDocumento2Número do Documento 2 
tpDocumento1Tipo do documento 1 
tpDocumento2Tipo do documento 2 
valorTotalPagoDoc1Valor total pago do Documento 1
valorTotalPagoDoc2Valor total pago do Documento 2
dataPagamentoDoc1Data do pagamento do Documento 1
dataPagamentoDoc2Data do pagamento do Documento 2
identificadorPagamentoDoc1Identificador do pagamento do Documento 1
identificadorPagamentoDoc2Identificador do pagamento do Documento 2
debugHabilita a saída de informações nos logs do Tomcat


Resposta:

Exemplo:

{ "xml": "String em Base64 do XML de retorno A515" }


Exemplo de retorno com erro:

{
    "xml": null,
    "error": {
        "message": "Erro ao converter data. Formato de data esperado yyyy-MM-dd.",
        "detailedMessage": "Unparseable date: a2022-03-03"
    }
}


ParâmetrosDescrição
xml

XML em Base64 retornado pela Unimed Brasil

error

Json contendo os campos de mensagem do erro e detalhes do erro

  • message: Mensagem de erro resumida
  • detailedMessage: Detalhes relacionados a mensagem de erro