1) Como funciona a api RecreaSoft
Na api RecreaSoft você consegue através de sistemas de terceiros fazer a consulta de informações cadastradas no RecreaSoft.
A api é desenvolvida em REST. Para obter os resultados das consultas disponibilizadas pela api do RecreaSoft, você deve antes obter o token. A consulta vai retornar o token. Com o valor do token você deve usar a autorização no formato bearer para fazer a consulta no método desejado.
2) Como obter o token
Para realizar a consulta dos metódos é necessário antes obter o token. O token deve ser usado para realizar a autorização de consulta.
Para obter o token deve ser realizado um POST passando por parâmetro o usuário, senha e idempresa.
As informações da URL de consulta, usuário, senha e idempresa devem ser consultadas no canal de suporte do RecreaSoft
Exemplo de como fazer a consulta do token:
Sendo a URL https://127.0.0.1:8001/integracao-v1/token o login 1234567, a senha 7654321 e o idempresa 1
Você terá que realizar o POST no endereço https://127.0.0.1:8001/integracao-v1/token passando como parâmetro usuario=1234567&senha=7654321&idempresa=1
Esse POST vai retornar em formato JSON
{
"codigo_token": "ZGF0YWdlcmFjYW89MzAvMDEvMjAyMyAyMjozMTowMg==",
"tipo_token": "bearer",
"expiracao_token": 44957.1882229282
}
O token que será usado para as consultas dos métodos é o valor que foi retornado no codigo_token.
3) Como obter os resultados dos métodos disponibilizados pela api RecreaSoft
Os métodos que você poderá consultar devem ser consultados no canal de suporte do RecreaSoft.
Com os métodos disponibilizados pelo suporte do RecreaSoft, você terá que realizar um GET usando o token obtido. A forma de autenticação do envio do token é no formato bearer.
4) Ambiente de homologação
Disponibilizamos um ambiente de homologação onde é possível testar a comunicação com a integração.
Para obter o token você deve usar o usuário teste12345 e senha teste54321. Dessa forma, você deverá realizar o POST no endereço http://plimtec.servehttp.com:8003/integracao-v1/token?usuario=teste12345&senha=teste54321&idempresa=1
O comando POST para obter o token, caso seja realizado com sucesso irá retornar uma mensagem no formato JSON com o token conforme explicado no item 2 desse manual.
Para fazer a consulta das informações, deve ser usado o comando GET. O endereço que vai ser usado vai depender do método disponibilizado para a consulta. Nós disponibilizamos alguns métodos no ambiente de homologação, como por exemplo o método historico-do-tempo e venda-produto-analitico
A informação codigo_token retornada na consulta do token, deverá ser usada na consulta do método como autenticação token bearer.
Nesses métodos de exemplo, os endereços das consultas são:
No método historico-do-tempo o endereço http://plimtec.servehttp.com:8003/integracao-v1/historico-do-tempo?idempresa=1&datainicial=01-01-2024&datafinal=31-01-2024
No método venda-produto-analitico o endereço http://plimtec.servehttp.com:8003/integracao-v1/venda-produto-analitico?idempresa=1&datainicial=01-01-2024&datafinal=31-01-2024
É obrigatório informar os parâmetros, idempresa (identificação da empresa), datainicial (data inicial da pesquisa), datafinal (data final da pesquisa). Sendo assim, o idempresa no ambiente de homologação você vai sempre informar 1. No parâmetro datainicial e datafinal você vai informar o período que deseja pesquisar.
Os métodos de consulta retornarão o resultado das consultas no formato JSON.