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. Envio dos Dados
  4. Recepção dos Contratos
  5. 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. 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

04. 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

05. 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.