Histórico da Página

CONTEÚDO

1. Visão Geral
2. Premissas
3. Conector Salesforce - TOTVS Agro Conecta Dados
4. Envio dos Dados
5. Recepção dos DadosContratos
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
  • EstagioEstá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] Image Added

      
      

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

      Nota
      title 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.

      Image Added
      
      

2. CONFIGURAÇÃO CONECTOR

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

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.
      Image Added
      
      
   2. Pronto, agora você pode ativar ou desativar suas integrações com Salesforce.
      Image Added
      
      

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, na qual que poderá realizar a construção de contratos com os dados recebidos.
• Para verificar como é realizado essas requisições, podemos baixar a fazer o download da seguinte collection: Exemplos de Request - Conecta Dados para Salesforce (POSTMANPostman) e e realizar a importação no postman 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 (POSTMANPostman), importar no postman Postmane inserir o link da URL disponibilizada pela 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
      Image Modified

...

06. GLOSSÁRIO