Histórico da Página

...

1. Visão Geral
2. APIs
   1. APIs Disponíveis
   2. Parâmetros
   3. Autenticação
3. CPCs
4. Homologação 12.1.26

01. VISÃO GERAL

O TOTVS Saúde Planos (Linha Datasul) oferece uma série de APIs para integração com o APP da Unimed Brasil.

As APIs foram desenvolvidas seguindo as definições disponibilizadas no Swagger da Unimed Brasil. 

02. APIs 

APIs disponíveis:

As APIs estão disponíveis em um dos seguintes contextos, dependendo do servidor de aplicação utilizado pelo cliente.

TOMCAT: http://<CONTEXTO-TOTVS:PORTA>/api/appUnimedBrasil

JBOSS: http://<CONTEXTO-TOTVS:PORTA>/healthmanagementwebservices/rest/appUnimedBrasil

* Para Clientes que utilizam o Boletos padrão do produto, o atributo linhaDigitavel só será retornado para títulos cujo lote de boletos já tenha sido gerado (processo de geração) e o download (momento em que é criado o PDF ou TXT) já tenha sido finalizado.

**Para apresentar esse demonstrativo são utilizados os dados enviados na DMED. Dessa forma, sempre que for gerado o arquivo da DMED será carregada uma tabela com a competência e valores para apresentação no demonstrativo do IRPF.

Parâmetros:

Algumas dessas APIs esperam receber alguns parâmetros via header ou via query parameters.

* O formato desses valores é definido pelo retorno das APIs PeriodosDemonstrativoCoparticipacao e Títulos, que retornam os IDs utilizados para alimentar esses parâmetros.

Além desses parâmetros, todas as APIs exigem que seja informado ao menos um dos cabeçalhos abaixo no header da requisição:

Autenticação:

As APIs são protegidas via Basic Authentication, utilizando um usuário e senha válidos do TOTVS Planos - Linha Datasul. 

Para utilizar as APIs, o usuário e senha devem ser enviados em base64 no formato USUARIOusuario:SENHA senha no cabeçalho de autenticação do tipo Basic.

Exemplo de uma requisição requisição com Basic Authentication onde o usuário é "superuser" e a senha "superpassword", resultando em um base64  = "c3VwZXI6c3VwZXIdXNlcjpwYXNzd29yZA==":

curl -b cookie.txt -c cookie.txt --location --request GET 'http://<CONTEXTO-TOTVS:PORTA>/api/appUnimedBrasil/Beneficiario/v1/IRPF?ano=2020' \
--header 'x-CPF: 98765432100' \
--header 'Authorization: Basic c3VwZXI6c3VwZXIdXNlcjpwYXNzd29yZA=='

03. CPCs

Cada API possui dois pontos de CPC. Um no início do processo que permite sobrescrever total ou parcialmente a lógica do produto padrão e outro ao final do processo que permite fazer ajustes nos dados antes de enviar a resposta da requisição.

...

Abaixo a listagem das CPCs disponíveis juntamente com o manual de cada ponto de CPC e um programa de exemplo.

04. Homologação 12.1.26

Abaixo os programas disponíveis para Homologação na 12.1.26. É necessário estar atualizado com o último patch disponível no console oficial de atualização.

Observação: Para a homologação do item IRPF é necessário aplicar, momentaneamente, o delta em uma tabela especifica e realizar a compilação dos programas .p. Com a aplicação da tabela liberada antecipadamente em um banco específico, ao ocorrer a expedição da tabela oficialmente não acontecerá erros no console oficial de atualização.

É necessário atualizar o jar datasul-hgp-webservices-12.1.26-SNAPSHOT.jar no caminho:
..\ServidorAplicacao\jboss-4.2.3.GA\server\<INSTANCE>\deploy\datasul-byyou-<VERSÂO>-SNAPSHOT.ear\datasul-hgp-webservices-<VERSÂO>-SNAPSHOT.war\WEB-INF\lib

Também é necessário reiniciar a aplicação para que as alterações tenham efeito.

05. Clientes na 12.1.29 e 12.1.31 com JBOSS

É necessário atualizar o jar disponibilizado no pacote abaixo no seguinte caminho do JBOSS:
..\ServidorAplicacao\jboss-4.2.3.GA\server\<INSTANCE>\deploy\datasul-byyou-<VERSÂO>-SNAPSHOT.ear\datasul-hgp-webservices-<VERSÂO>-SNAPSHOT.war\WEB-INF\lib

Também é necessário reiniciar a aplicação para que as alterações tenham efeito.

Pacote 12.1.29

Pacote 12.1.31

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>