Histórico da Página
CONTEÚDO
- Visão Geral
- Premissas
- Conector Salesforce - TOTVS Agro Conecta Dados
- 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
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
CONFIGURAÇÃO DE CLIENTE
Com o TENANT_ID disponibilizado pela TOTVS, acessar a URL: https://conectadados.totvs.app/tenants/[TENANT_ID]
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.
CONFIGURAÇÃO CONECTOR
- Navegar até o botão Autenticação do conector Salesforce.
- Clicar no botão Habilitar.
- Logo após, basta inserir as informações de autenticações fornecidas pela Salesforce e Salvar.
- Navegar até o botão Autenticação do conector Salesforce.
HABILITAR INTEGRAÇÕES
- 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.
- Pronto, agora você pode ativar ou desativar suas integrações com Salesforce.
- 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.
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>
- <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
- <instance-url>/services/data/<api-version>/composite/sobjects/Account/IdConta__c
- PATCH
...
05. EXEMPLO DE UTILIZAÇÃO - RECEBER
...
CONTRATOS (
...
TOTVS Agro Bioenergia - Pagadoria APIs)
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 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
- <url-api>/CONTRATOS_WS.asmx/apiIncluirContratoCana
- POST
...
06. 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. |