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.
A API Integração com o Revisão de Contas Médicas tem por objetivo disponibilizar o acesso das funções realizadas na Central TISS.
...
TOMCAT: http://<CONTEXTO-TOTVS:PORTA>/api/documentExternal<rota>
JBOSS: http://<CONTEXTO-TOTVS:PORTA>/healthmanagementwebservicesdts/datasul-rest/documentExternal/resources/prg/hrc/<versao>/<rota>/
| Documentos: | Método | Versões |
|---|
| Rota | Documentação |
|---|
Enviar para Auditoria: |
| POST |
| v1 | /documentExternal/auditory | API |
| de Status do Documento/Movimentos |
Liberação documento de Movimentos: |
| POST |
| 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.
...
| Manutenção de Documentos: | Método | Versões | Rota | Documentação |
|---|---|---|---|---|
| Consultar Documentos | GET | v2 | /documentsMaintenance/ | API de Manutenção de Documentos v2 |
Incluir/Modificar Documento | POST | v2 | /documentsMaintenance/ | |
| Exclusão por Documento | POST | v2 | /documentsMaintenance/remove/doc | |
| Exclusão por Fatura | POST | v2 | /documentsMaintenance/remove/fat | |
| Inclusão Glosa Manual | POST | v2 | /documentsMaintenance/movement/addManualRestriction | |
| Exclusão Glosa Manual | POST | v2 | /documentsMaintenance/movement/removeManualRestriction | |
| Validação de Glosas | POST | v2 | /documentsMaintenance/movement/validateMovementRestriction |
| Manutenção Reembolso | Método | Versões | Rota | Documentação |
|---|---|---|---|---|
| Consultar | GET | v2 | /refundDocumentsMaintenance/ | API de integração com o Revisão de Contas (Reembolso) |
| Incluir/Modificar | POST | v2 | /refundDocumentsMaintenance/ | |
| Remoção | POST | v2 | /refundDocumentsMaintenance/remove/doc |
* 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:
...
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.
A documentação detalhada pode ser consultada Desenvolvimento de APIs para o produto Datasul.
Exemplo de uma requisição requisição com Basic Authentication onde o usuário é "user" e a senha "password", resultando em um base64 = "dXNlcjpwYXNzd29yZA==":
| Bloco de código | ||||||
|---|---|---|---|---|---|---|
| ||||||
"curl -b cookie.txt -c cookie.txt --location --request GET 'http://<CONTEXTO-TOTVS:PORTA>/api/appUnimedBrasil/Beneficiario/dts/datasul-rest/resources/prg/hrc/v1/IRPF?ano=2020' \documentsMaintenance' --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.
...
...
...
...
...
...
...
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.
...
| Templatedocumentos |
|---|
| HTML |
|---|
<!-- 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>
|
