Para que seja possível o consumo de APIs geradas pelo TOTVS Agro Bioenergia, por meio do TOTVS Fluig, e também o acionamento das APIs do TOTVS Fluig pelo TOTVS Agro Bioenergia, é necessário que algumas configurações sejam realizadas na plataforma Fluig.
IMPORTANTE
Estas configurações somente são possíveis por meio do usuário cadastrado na plataforma Fluig como Administrador. Caso ainda não tenha realizado tal cadastro, verifique os passos apresentados neste link, para a configuração da "Empresa".
Configuraremos três itens importantes para a integração entre os produtos TOTVS Agro Bioenergia e TOTVS Fluig, que podem ser encontrados no menu "Painel de Controle". São eles:
- Painel de Controle > Parâmetros Técnicos > OAuth provider;
- Painel de Controle > Parâmetros Técnicos > OAuth application;
- Painel de Controle > Desenvolvimento > Serviços;
1) OAuth Provider e OAuth application:
Para realizar o cadastro dos parâmetros técnicos OAuth Provider e Oauth application, por favor, acesse a documentação disponibilizada neste link.
Pontos de Atenção
a) No momento de realizar o cadastro do OAuth application, lembre-se de também realizar o cadastro do Usuário Aplicativo, para que seja gerado o Access Token e Token Secret. Tais tokens serão utilizados nas chamadas das APIs do Fluig e são essenciais para o desenvolvimento da integração.
b) As seguintes chaves, além de cadastradas no Fluig, também necessitam ser cadastradas pelo usuário, no PAR_PIMS:
Chave | Parâmetro PAR_PIMS (Seção - Entrada) | Onde obter |
Consumer Key | GERAIS > FLUIG_CONSUMERKEY | Cadastro do OAuth application |
Consumer Secret | GERAIS > FLUIG_CONSUMERSEC | Cadastro do OAuth application |
Access Token | GERAIS > FLUIG_ACCESSTOKEN | Usuário Aplicativo, em OAuth application |
Token Secret | GERAIS > FLUIG_TOKENSECRET | Usuário Aplicativo, em OAuth application |
2) Serviços:
O cadastro de um serviço na plataforma Fluig é necessária para que o Fluig aceite e realize as chamadas das APIs disponibilizadas pelo Bioenergia. O passo a passo para cadastro de um serviço na plataforma TOTVS Fluig está disponível neste link.
Um ponto importante a ser destacado é a forma a qual este serviço deve ser cadastrado. Abaixo consta um exemplo de um serviço cadastrado (no caso, o Servidor IIS apresentado no presente manual), que disponibiliza as APIs vinculadas ao TOTVS Agro Bioenergia:
Os atributos apresentados acima, no cadastro do serviço, deverão ser informados da seguinte maneira:
Tipo de Serviço | REST. |
Nome | Nome de livre escolha do usuário. Este nome será utilizado na configuração dos eventos dos processos registrados no Fluig. |
Descrição | Descrição do serviço. |
Domínio | Domínio ao qual o servidor IIS foi disponibilizado. |
Swagger | |
Tipo de autenticação | Selecionar o tipo de autenticação "None". |
URL para teste de serviço | Inserir o endpoint conforme exemplo acima, alterando apenas o nome do aplicativo que foi gerado pelo Servidor IIS (texto no início do endpoint). |