Integração com Salesforce

CONTEÚDO

1. Visão Geral
2. Premissas
3. Conector Salesforce - TOTVS Agro Conecta Dados
4. Envio dos Dados
5. Recepção dos Contratos
6. Glossário

01. VISÃO GERAL

Esta integração foi construída para efetuar o envio de dados entre TOTVS Agro Bioenergia para Salesforce, levando os cadastros de Fazenda (Nível 1), Setor (Nível 2) e Talhão (Nível 3) sempre que forem inseridos ou atualizados. Com esses dados é realizado a construção de contratos via Salesforce.

Salesforce Integration - Guia de Referência

TOTVS Agro Bioenergia (Pagadoria APIs) - Configuração IIS

02. PREMISSAS

• Possuir o TOTVS Agro Connector Client devidamente instalado e configurado.
• Para o funcionamento correto das integrações entre as aplicações os seguintes cadastros precisam estar equalizados (mesmo código). Atualmente estes cadastros não possuem DE PARA.
  • Tipo de Propriedade
  • Sistema de Colheita
  • Ocupação
  • Variedade
  • Estágio
  • Espaçamento
  • Sistema de Plantio
  • Sistema de Plantio Anterior

03. CONECTOR SALESFORCE - TOTVS AGRO CONECTA DADOS

1. CONFIGURAÇÃO DE CLIENTE
   

   1. Com o TENANT_ID disponibilizado pela TOTVS, acessar a URL: https://conectadados.totvs.app/tenants/[TENANT_ID] 

      
      

   2.  Ao acessar, devemos preencher as informações de acordo com o cliente e Confirmar. 

      Atenção

      T-Code é o código do cliente TOTVS. Este código pode ser obtido por meio da plataforma TOTVS License Server (LS Discovery, no Fluig), por meio da plataforma Empodera e/ou em contato com o time de CRM.

      
      
      

2. CONFIGURAÇÃO CONECTOR

   1. Navegar até o botão Autenticação do conector Salesforce.
      
      
      
   2. Clicar no botão Habilitar.
      
      
      
   3. Logo após, basta inserir as informações de autenticações fornecidas pela Salesforce e Salvar.
      
      
      

3. HABILITAR INTEGRAÇÕES
   

   1. Com o conector configurado, ele ficará na cor verde para habilitado e vermelho para desabilitado, para ativar ou desativar envios, podemos clicar no botão na lateral do conector.
      
      
      
   2. Pronto, agora você pode ativar ou desativar suas integrações com Salesforce.
      
      
      

04. EXEMPLO DE UTILIZAÇÃO (ENVIO DE DADOS)

• Com conector habilitado e os envios de dados ativados no Conecta Dados, esta solução proporciona o envio de dados. Ao inserir ou atualizar um registro nas tabelas do TOTVS Agro Bioenergia mapeada pelo TOTVS Agro Connector (Fazenda, Setor e Talhão), será enviado essas requisições para Salesforce, que poderá realizar a construção de contratos com os dados recebidos.
• Para verificar como é realizado essas requisições, podemos fazer o download da seguinte collection: Exemplos de Request - Conecta Dados para Salesforce (Postman) e realizar a importação no Postman e adicionar a instance_url, api_version e o acess_token. Com isso, podemos verificar através das requisições GET se os dados foram inseridos devidamente como nos exemplos abaixo:
  • GET 
    • <instance-url>/services/data/<api_version>/sobjects/Account/IdConta__c/<codigo_conta>
      

• • PATCH
    
    • <instance-url>/services/data/<api-version>/composite/sobjects/Account/IdConta__c
      

05. EXEMPLO DE UTILIZAÇÃO - RECEBER CONTRATOS (TOTVS Agro Bioenergia - Pagadoria APIs)

• Para verificar as requisições realizadas pela Salesforce, podemos fazer download da collection: Exemplos de Request - Salesforce para TOTVS Agro Bioenergia API (Postman), importar no Postman e inserir o link da URL disponibilizada pelo TOTVS Agro Bioenergia API no IIS, após isso podemos fazer as requisições conforme o exemplo abaixo:
  • POST
    
    • <url-api>/CONTRATOS_WS.asmx/apiIncluirContratoCana
      

06. GLOSSÁRIO