Exibir origem

CONTEÚDO

Visão Geral
APIs
1. APIs Disponíveis
  i. API Status do Documento/Movimentos
2. Parâmetros
3. Autenticação
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.

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/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.

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.

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.

03. CPCs

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
	ANTES-PROCESSO DEPOIS-PROCESSO
	ANTES-PROCESSO DEPOIS-PROCESSO

04. Homologação 12.1.31

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>