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)

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

05. GLOSSÁRIO