Histórico da Página
CONTEÚDO
- Visão Geral
- Premissas
- Envio dos Dados
- Recepção dos Contratos
- 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
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
- Estagio
- 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, 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 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>
- GET
...
- PATCH
- <instance-url>/services/data/<api-version>/composite/sobjects/Account/IdConta__c
- PATCH
04. EXEMPLO DE UTILIZAÇÃO - RECEBER OS CONTRATOS (API TOTVS Agro Bioenergia)
Nota | ||
---|---|---|
| ||
O recebimento de dados (Contratos) é realizado diretamente pela API do bioenergia 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 (POSTMANPostman), importar no postman e inserir o link da URL disponibilizada pela 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 Bioenergia | TOTVS Agro Bioenergia é um sistema de gestão agroindustrial completo, feito para gerenciar todos os processos envolvidos na produção de bioenergia. |
TOTVS Agro Connector | TOTVS Agro Connector é responsável por monitorar os dados que serão enviados e chegar até o TOTVS Agro Conecta Dados. |
TOTVS Agro Conecta Dados | TOTVS Agro Conecta Dados é responsável por realizar as requisições (Envio de dados) para API da Salesforce. |
Salesforce | Salesforce é a solução responsável pela construção de contratos. |
Postman | Postman é uma plataforma para realizar testes de API. |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas