Páginas filhas
  • Integração com Salesforce

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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

...

  • 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]
      Image Added


    2.  Ao acessar, devemos preencher as informações de acordo com o cliente. 
      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.
      1. 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, 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)

Nota
titleAtenção

O recebimento de dados (Contratos) é realizado diretamente pela API do TOTVS Agro Bioenergia e não tem conexão com o TOTVS Agro Conecta Dados.

  • 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 Postmane 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

Termo

Descrição

TOTVS Agro BioenergiaTOTVS Agro Bioenergia é um sistema de gestão agroindustrial completo, feito para gerenciar todos os processos envolvidos na produção de bioenergia.
TOTVS Agro ConnectorTOTVS Agro Connector é responsável por monitorar os dados que serão enviados e chegar até o TOTVS Agro Conecta Dados.
TOTVS Agro Conecta DadosTOTVS Agro Conecta Dados é responsável por realizar as requisições (Envio de dados) para API da Salesforce.
SalesforceSalesforce é a solução responsável pela construção de contratos.
PostmanPostman é uma plataforma para realizar testes de API.

...