Cross Segmentos - TOTVS CRM Automação de Força de Vendas (SFA) - Integração - Gerar token para integração

Tempo aproximado para leitura: 00:02:00 min

Dúvida
Como criar um token do usuário e senha do ERP para utilizar na integração?

Ambiente
Cross Segmentos - TOTVS CRM Automação de Força de Vendas (SFA) - Integração - Todas as versões
 
Solução
Para gerar um token do usuário e senha do ERP para as integrações executarem, seguir os passos a seguir:

1. Obter as Credenciais do ERP
   
   Validar qual usuário e senha configurados no ERP que serão utilizados exclusivamente para as integrações.
    

2.  Codificar as Credenciais em Base64
   
   2.1.  Acesse o site de codificação Base64: https://www.base64encode.org/ 
   
   2.2 Selecione a opção Encode.

   
    

3. Gerar o Token

   3.1. No primeiro campo de texto, informe o usuário e senha obtidos no Passo 1, utilizando o formato exato: usuario:senha.
    

   

   
   Atenção! 
   O exemplo teste:teste mostrado nas telas de demonstração NÃO deve ser utilizado. Utilize o usuário e a senha reais, que estão configurados no ERP.
    

   3.2. Clique no botão Encode para gerar o token Base64 no campo de saída.
    

4. Configurar o Token no Arquivo kettle.properties
    

   O token deve ser configurado no arquivo kettle.properties da instalação do SFA.
   
   4.1. Localize a pasta de instalação do SFA. O diretório raiz pode variar (ex: C:\ws ou C:\sim3g)
   
   4.2. Acesse o caminho: [DIRETÓRIO RAIZ]\integracao_spoon\producao\config\.kettle 
    

   Importante! 
   Altere [DIRETÓRIO RAIZ] para a partição correta e a pasta do SFA, os diretórios padrões seguem o exemplo a seguir:

   Windows - ?:\ws - alterar ? por C, D ou a partição correta;

   Linux - /ws/
   
   4.3. Abra o arquivo kettle.properties com um editor de texto.
   
   4.4. Localize a seção #TOKEN PARA REQUISIÇÕES e configure os seguintes campos (caso não existam, adicione-os):

   

   #TOKEN PARA REQUISIÇÕES
   # TOKEN REST
   INLOGIN=Basic [token_gerado]
   # TOKEN SOAP
   INLOGIN_SOAP=[token_gerado]

   
   Substitua [token_gerado] pelo valor Base64 obtido no Passo 3.

   
   Imagem apenas de exemplo: 

   

   SOBRE A AUTENTICAÇÃO:
   É crucial entender a diferença entre as variáveis:
   INLOGIN=Basic [token]: Esta variável é utilizada para requisições que exigem o formato de autenticação Basic Authentication (comumente usado em APIs REST). Mantenha a palavra Basic. 
   
   INLOGIN_SOAP=[token]: Esta variável é utilizada para integrações que usam o protocolo SOAP, onde apenas o token Base64 puro é exigido.
   
   4.5. Após adicionar as informações, salve o arquivo. A integração irá executar utilizando o novo token.
    

Importante!

Recomendamos testar esta configuração primeiramente em seu ambiente de homologação e após os testes necessários, replicar para o ambiente de produção.