Histórico da Página
CONTEÚDO
- Visão Geral
- APIs
- APIs Disponíveis
i. API Status do Documento/Movimentos - Parâmetros
- Autenticação
- APIs Disponíveis
- CPCs
- Homologação 12.1.31
01. VISÃO GERAL
O TOTVS Saúde Planos (Linha Datasul) oferece uma série de APIs para integração.
A API Integração com o Revisão de Contas Médicas tem o objetivo disponibilizar o acesso a funções realizadas na Central TISS.
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/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 de Status do Documento/Movimentos |
Documentos - Liberação documento de Movimentos: /release | POST | /api/v1/documentExternal/release | API de Status do Documento/Movimentos |
* O formato desses valores é definido pelo retorno das APIs Status do Documento/Movimentos, que retornam os IDs utilizados para alimentar esses parâmetros.
TOMCAT: http://<CONTEXTO-TOTVS:PORTA>/api/documentsMaintenance
JBOSS: http://<CONTEXTO-TOTVS:PORTA>/dts/datasul-rest/resources/prg/hrc/<versao>/
| API | Método | Rota | Documentação |
|---|---|---|---|
Modifica Documento/movimentos | POST | /documentsMaintenance/ | API de Manutenção de Documentos - Modifica |
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 usuario:senha no cabeçalho de autenticação do tipo Basic.
A documentação detalhada pode ser consultada https://tdn.totvs.com/display/public/FRAMJOI/Desenvolvimento+de+APIs+para+o+produto+Datasul#DesenvolvimentodeAPIsparaoprodutoDatasul-Login.
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/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.
| 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>
|