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