Histórico da Página

...

O TOTVS Agro Connector Client é um aplicação On-Premise, que é instalado localmente no ambiente do cliente com um TENTANT_ID que é disponibilizado pela equipe do TOTVS Agro e atualmente possui uma interface do Swagger e a sua própria base de dados.

No Swagger, cadastramos cadastra-se a base de dados do produto, no caso TOTVS Agro Bioenergia.

Hoje, trabalhamos com Atualmente, o modelo de dados utiliza de Schemas Definitions, que é o mapeamento de tabelas e colunas que serão enviadas para parceira, conforme solicitação, a equipe TOTVS Agro realiza esse cadastro e será enviado os seguintes dados:

...

O TOTVS Agro Plataforma está disponível nos ambientes do TOTVS Apps, porém ele não possuí uma interface gráfica. Ele é responsável por receber as mensagens do TOTVS Connector Server que foi processado na fila do RabbitMQ, então ele pega o JSON recebido, insere os dados na própria base de dados para haver controles de chaves primárias, foreign key e garantir a integridade das tabelas e relacionamentos. Após conclusão de inserção com sucesso, novamente esse JSON é enviado para outra fila via RabbitMQ, que será processado pelo TOTVS Agro Conecta Dados.

Abaixo, exibiremos em detalhe um exemplo Exemplo detalhado de JSON que irá para fila do rabbit mostrado acima.RabbitMQ (mencionado acima):

Bloco de código

theme	Confluence

{
   "header":{
      "type":"FazendaCriada",
      "tenantId":"8c12da2baca8de2e6b5dd2f6999c6998cbc7b563e5c24e043fa26b72f1f406e8",
      "generatedOn":"2023-03-22T14:12:21.428785Z",
      "locale":"pt_BR"
   },
   "content":{
      "originId":"Q0RfVVBOSVZFTDE9NjAwODZB",
      "metadata":{
         
      },
      "codigo":"FazendaA1",
      "descricao":"Fazenda Teste",
      "documento":null,
      "instanciaOriginId":null,
      "cdMunicipio":"2308",
      "cdFornecedores":"94500",
      "endereco":"Fazenda Teste",
      "telefone":null,
      "cnpjCpf":"12345678",
      "incra":null,
      "inscricaoProdutorRural":"123.456.789-10",
      "cep":"111111",
      "tipoPessoa":"J",
      "qtdAreaTotal":"24",
      "qtdAreaProdutiva":"24",
      "cdIntErp":null
   }
}

...

- O TOTVS Agro Conecta Dados (Front/Web) é responsável por cadastrar as informações disponibilizadas pela Salesforce e também ativar ou desabilitar integrações, tais elas como:

...

- O TOTVS Agro Conecta Dados Server é responsável por receber o JSON via mensageria, então ele fica observando a fila que o TOTVS Agro Plataforma enviou os dados. Com o JSON disponível o TOTVS Agro Conecta Dados fica responsável por realizar a autenticação a partir dos dados informados no frontFront/Web, com isso ele monta o JSON baseado no modelo enviado e processamos a processam-se as requisições PATCH para Salesforce, conforme alguns exemplos abaixodemonstrados:

Aviso

title	Atenção

Para realizar as requisições é necessário passar o token recuperado, após autenticação.

Abaixo será exibidos Destacam-se as tabelas disponibilizadas para nós com base na API deles, ou seja o que devemos passar se deve informar no body da requisição como JSON e exemplos de como estamos utilizando se utilizam cada uma no postmanPostman:

Modelo à ser enviado: FAZENDA (Local de Producão Produção 1) para Salesforce.

API	Tipo	Descrição
IdConta__c	texto	Id Fazenda
CodigodaPropriedade__c	Texto(6) (ID Externo)	Cod Fazenda
Municipio__r.codigoMunicipio__c	Pesquisa	Cod Municipo PIMS
codigoFornecedor__c	Numero(8)	Cod Fornecedor
descricaoCompleta__c	texto(70)	Descrição Completa
BillingStreet	texto(70)	Endereço
Phone	texto(70)	Telefone
cnpjCPF__c	texto(18)	CNPJ ou CPF
numeroIncra__c	texto(15)	N° INCRA
numeroInscricaoProdutorRural__c	texto(20)	N° Insc.Produtor Rural
Cep__c	texto(16)	N° cep
Tipo_de_Pessoa__c	texto(1)
QtdeAreaTotalHA__c	numero(7,2)
QtdeAreaTotalProdHectares__c	numero(7,2)
codigoInternoErp__c	texto(15)
Instancia__r.CodigoInstanciaPIMS__c	texto(5)
flagAtivo__c	Lista de Opçoes

...

Modelo à ser enviado: SETOR (Local de Producão Produção 2) para Salesforce.

API	Tipo	Descrição
IdBloco__c	Texto(6) (ID Externo)	Id Bloco
Conta__r.IdConta__c	Pesquisa(Conta)	Cod Fazenda
codigoBloco__c	Texto(6) (ID Externo)	Cod Bloco
Municipio__r.codigoMunicipio__c	Pesquisa	Cod Municipo PIMS
Name	Name	Descrição do Bloco
Hectares__c	Number(16,2)	Qtde de Area Total em Hectares
AreaProdutivaHA__c	Number(16,2)	Qtde de Area Produtiva em Hectares

...

Modelo à ser enviado: TALHÃO (Local de Producão Produção 3) para Salesforce.

API	Tipo	Descrição
IdTalhao__c	Texto	Id Talhão
Safra__c	Numero(5)	Codigo da Safra
Conta__r.IdConta__c	Texto(6)	Cod Fazenda
Bloco__r.IdBloco__c	Pesquisa	Cod Bloco
codigoTalhao__c (ID Externo)	Texto(6)	Cod Talhão
CodigoTipoPropriedade__c	Lista de Opções	Cod Tipo de Propriedade
DistanciaTerra__c	Numero(4,1)	Distância Terra
DistanciaAsfalto__c	Numero(4,1)	Distância Asfalto
DistanciaHidrovia__c	Numero(4,1)	Distância Hidrovia
CodigoSistemaColheita__c	Lista de Opções	Codigo de Sistema de Colheita
DataPlantio__c	Date	Data do Plantio
CodigoOcupacao__c	Lista de Opções	Codigo de Ocupação
CodigoVariedade__c	Lista de Opções	Codigo de Variedade
CodigoEstagio__c	Lista de Opções	Codigo de Estagio
CodigoEspacamento__c	Lista de Opções	Codigo de Espaçamento
CodigoSistemaPlantio__c	Lista de Opções	Codigo de Sistema de Plantio
AreaProdutivaHA__c	Number(7,2)	Qtde de Area Produtiva em Hectares
CodigoOcupacaoAnterior__c	Lista de Opções	Codigo de Sistema de Plantio Anterior
FlagTipoPlantio__c	Lista de Opções	Flag de Tipo de Plantio

...

Páginas filhas

Versões comparadas

Versão antiga 26

Nova versão 27

Chave