01. PRÉ REQUISITOS

a. Release mínima: 12.1.29

b. Configuração do serviço REST Logix

Para utilização do portal E-Cotação, é necessário configurar o serviço REST no produto Logix para que a aplicação externa possa se conectar ao Logix através das APIs. Para que isso seja possível é necessário realizar a configuração conforme consta na documentação do FrameWork no TDN. Caso esteja configurando um HostName com protocolo HTTPS, então certifique-se que esteja com certificado válido. Para validar seu HostName, poderá utilizar o site SSL Shopper.

Importante: Caso configure na seção HTTPREST o parâmetro SECURITY=0 então é obrigatório que na seção WEBSERVICES tenha o parâmetro USERID com um usuário logix. Se o SECURITY=1 então o usuário obrigatório será o usuário fornecido no cadastro do Alias no Mingle conforme mencionado no item "c. Parâmetro para informar o ambiente de acesso - Alias Mingle"

c. Parâmetro para informar o ambiente de acesso - Alias Mingle

Visão geral: Como forma de manter seguro o serviço REST do Logix e permitir que através do portal E-Cotação em Cloud seja acessado pelos Fornecedores, é necessário solicitar um ALIAS na plataforma do TOTVS MINGLE. O Mingle é uma plataforma disponibilizada para resolver a necessidade de autenticação e redirecionamento das APIs para o servidor. Para ter um Alias é necessário solicitar no portal do Mingle na opção "solicite seu alias". O campo "Cadastrar credencias de autenticação" deverá informar um usuário/senha de um usuário integrador. Este usuário poderá ser o mesmo usuário informado para geração do Token conforme item será mencionado no item e. Parâmetros para geração do Token.

Após o cadastro do formulário, você irá receber um email com o Alias disponibilizado para o servidor que você disponibilizou para essa integração.

Importante salientar que o endereço do serviço REST e PORT informados, deverão permitir acesso externo, isso é necessário para que o Mingle possa estabelecer uma comunicação e encontrar o serviço REST disponível. Caso deseja liberar o acesso apenas ao mingle, então no campo "Observações", solicitar o range de IPs cujo o Mingle irá enviar as solicitações de conexão para tráfego das mensagens entre a aplicação E-Cotação e o Logix, ou você pode configurar um IP público para ficar visível externamente e na máquina configurar para permitir receber requisições externa para a porta do serviço REST.

d. Arquivo Appserver.ini

O Alias será disponibilizado ao fornecedor para preencher na tela de Login do E-Cotação. Essa informação servirá para que o E-Cotação (em Cloud) seja redirecionado ao ambiente Logix do Cliente (On Premise), cujo o alias foi cadastrado pelo Mingle. 

        Para que o Alias seja enviado no e-mail ao fornecedor, deverá salvá-lo no arquivo appserver.ini na seção "HTTPREST" da seguinte forma:

Importante: Caso utilize Loadbalance, então deverá configurar essa seção com o parâmetro minglealias em todos os appservers, pois esse parâmetro será validado e carregado ao utilizar o sup21007.

e. Parâmetros para geração do Token

Visão geral: RFI (Request for Information) para o produto Logix, tem como objetivo disponibilizar acesso ao produto para um usuário que não está efetivamente autenticado ao produto, possibilitando que ele tenha acesso a algum fluxo restrito conforme necessidade de uma integração. Este acesso é disponibilizado através de um link que tem como garantia de acesso seguro o valor de uma chave de acesso denominada "Token de Acesso" que é enviada junto com seus demais dados de acesso. 

O Token de acesso será gerado por fornecedor sempre que necessário no momento que a rotina do compras de coleta de preço para o E-Cotação for executada. Para que o token seja gerado corretamente, é necessário a inclusão dos parâmetros conforme a seguir:

Arquivo TotvsProfile.pro

02. PARÂMETROS E TABELA

a. Parâmetros por empresa LOG00086

b. Tabela