- ANTES-PROCESSO
- DEPOIS-PROCESSO
- ANTES-PROCESSO
- DEPOIS-PROCESSO
O TOTVS Saúde Planos (Linha Datasul) oferece uma série de APIs para integração.
As APIs foram desenvolvidas seguindo as definições disponibilizadas no Swagger da Unimed Brasil.
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/documentExternal
JBOSS: http://<CONTEXTO-TOTVS:PORTA>/healthmanagementwebservices/rest/documentExternal
| API | Método | Rota | Documentação |
|---|---|---|---|
Documentos - Enviar para Auditoria: /auditory | POST | /api/v1/documentExternal/auditory | API Autorizações do Beneficiário por Período |
Documentos - Liberação documento de Movimentos: /release | POST | /api/v1/documentExternal/release | |
* Para Clientes que utilizam o Boletos do GPS, 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 a apresentar no demonstrativo do IRPF.
Algumas dessas APIs esperam receber alguns parâmetros via header ou via query parameters.
| API | Parâmetro | Tipo Parâmetro | Tipo de dados | Formato | Obrigatório? |
|---|---|---|---|---|---|
| AutorizacoesPeriodo | dtInicio | Query Parameter | string | dd/mm/aaaa | Sim |
| AutorizacoesPeriodo | dtFim | Query Parameter | string | dd/mm/aaaa | Sim |
| DemonstrativoCoparticipacao | periodoId | Query Parameter | string | * | Sim |
| IRPF | ano | Query Parameter | integer | 9999 | Sim |
| SegundaViaBoleto | tituloId | Query Parameter | string | * | Sim |
| Extrato | periodoId | Query Parameter | string | * | Sim |
* 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:
| Cabeçalho | Tipo de dados | Formato |
|---|---|---|
| String | 99999999999999999 | |
| String | 99999999999 |
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 usuario:senha no cabeçalho de autenticação do tipo Basic.
Exemplo de uma requisição requisição com Basic Authentication onde o usuário é "user" e a senha "password", resultando em um base64 = "dXNlcjpwYXNzd29yZA==":
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 dXNlcjpwYXNzd29yZA==' |
Importante: é necessário que a aplicação que faz a requisição guarde os cookies da sessão para que a autenticação funcione. No exemplo acima, os parâmetros "-b cookie.txt -c cookie.txt " foram incluídos justamente para manter os cookies, tornando possível o login.
Abaixo a listagem das CPCs disponíveis juntamente com o manual de cada ponto de CPC e um programa de exemplo.
| API | Pontos de CPC | Nome Rotina da CPC | Manual CPC | Modelo de CPC |
|---|---|---|---|---|
|
|
| ||
|
|
|
Abaixo os programas disponíveis para Homologação na 12.1.31. É necessário estar atualizado com o último patch disponível no console oficial de atualização.
Observação:
Necessário reiniciar a aplicação para que as alterações tenham efeito.
<!-- 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>
|