Árvore de páginas

CONTEÚDO

  1. Visão Geral
  2. APIs
  3. Autenticação

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 por objetivo disponibilizar o acesso das 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/<rota>

JBOSS: http://<CONTEXTO-TOTVS:PORTA>/dts/datasul-rest/resources/prg/hrc/<versao>/<rota>/


Documentos: MétodoVersõesRotaDocumentação

Enviar para Auditoria: 

POST

v1

/documentExternal/auditory

API de Status do Documento/Movimentos

Liberação documento de Movimentos: 

POST

v1

/documentExternal/release

Manutenção de Documentos: MétodoVersõesRotaDocumentação
Consultar DocumentosGETv2/documentsMaintenance/



API de Manutenção de Documentos v2


Incluir/Modificar Documento

POST

v2

/documentsMaintenance/

Exclusão por DocumentoPOSTv2/documentsMaintenance/remove/doc
Exclusão por FaturaPOSTv2/documentsMaintenance/remove/fat
Inclusão Glosa ManualPOSTv2/documentsMaintenance/movement/addManualRestriction
Exclusão Glosa ManualPOSTv2/documentsMaintenance/movement/removeManualRestriction
Validação de GlosasPOSTv2/documentsMaintenance/movement/validateMovementRestriction
Manutenção ReembolsoMétodoVersõesRotaDocumentação
Consultar GETv1/refundDocumentsMaintenance/API de integração com o Revisão de Contas (Reembolso)
Incluir/ModificarPOSTv1/refundDocumentsMaintenance/
RemoçãoPOSTv1/refundDocumentsMaintenance/remove/doc

03. 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 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==":

Request
curl -b cookie.txt -c cookie.txt --location --request GET 'http://<CONTEXTO-TOTVS:PORTA>/dts/datasul-rest/resources/prg/hrc/v1/documentsMaintenance'
--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.