Mudanças entre as edições de "Integração dos dados"

De Wiki Trovata
Ir para: navegação, pesquisa
 
(6 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 2: Linha 2:
  
  
Para um bom funcionamento, todo sistema (software) depende de informações (dados) corretos, atualizados e consistentes. Os sistemas da TROVATA executam parte dos seus serviços usando os dados (cadastros de clientes, produtos, tabelas de preços, etc) fornecidos pelo sistema ERP (sistema interno gestão / vendas, faturamento, etc.) da empresa - nosso cliente. Estes dados devem ser disponibilizados obedecendo uma estrutura pré-definida e adequada para o bom funcionamento de nossas soluções.  
+
Para um bom funcionamento, todo sistema depende de informações corretas, atualizadas e consistentes. Os sistemas da TROVATA executam a maior parte dos seus serviços fazendo uso dos dados cadastrais fornecidos pelo seu sistema ERP (sistema interno de gestão / vendas, faturamento, etc.), dados estes que devem ser disponibilizados obedecendo uma estrutura pré-definida e adequada para o correto funcionamento de nossas soluções.  
  
Caso seu sistema ainda não tenha implementado um processo de integração com nossas aplicações, você pode encaminhar este material para o seu fornecedor ou então entre em contato conosco para avaliarmos como proceder.
+
Caso seu sistema ainda não tenha implementado um processo de integração com nossas aplicações, você pode encaminhar este material para o seu fornecedor ou então encaminhar entre em contato conosco para avaliarmos as melhores opções.
  
 
'''Atenção''', o processo de integração de nossa plataforma junto ao sistema de gerenciamento da empresa pode ter custos adicionais que precisarão ser tratados/negociados diretamente com seu fornecedor do sistema.
 
'''Atenção''', o processo de integração de nossa plataforma junto ao sistema de gerenciamento da empresa pode ter custos adicionais que precisarão ser tratados/negociados diretamente com seu fornecedor do sistema.
 +
 +
  
 
Atualmente contamos com os seguintes métodos de integração:
 
Atualmente contamos com os seguintes métodos de integração:
  
'''1 - Através da leitura e importação de dados via arquivos de texto.'''
 
  
Este é um processo já pouco utilizado pois, além de demorado, depende da empresa disponibilizar uma pessoa para ficar efetuando frequentes processos de atualização do sistema durante o dia.
+
'''1 - Integração via compartilhamento de dados por arquivos;'''
  
'''2 - Através da leitura e importação de dados via conexão remota ou Web-Services.'''
+
'''2 - Integração por conexão banco a banco;'''
  
Muito mais interessante que o método via arquivo texto, a integração dos dados via web possibilita mais agilidade e eficiência para o processo de comunicação entre empresa, cliente e representante.
+
'''3 - Integração por meio de API (Application Programming Interface).'''
  
Para utilização deste processo existem atualmente 2 caminhos disponíveis:
 
  
* '''Conexão ao servidor para leitura e gravação de dados diretamente na base ou via API do ERP.'''
 
  
Neste caso seu ERP deve estar preparado para que seja possível estabelecer uma conexão externa(via internet) para leitura dos dados e gravação de pedidos e clientes.
+
* Independente do formato escolhido, é importante se certificar junto ao fornecedor do sistema de gestão da empresa (ERP) para saber se existe algum tipo de método de integração pronto disponível ou se será necessário desenvolvimento e/ou adequação.
  
* '''Leitura e gravação de dados junto a nossa retaguarda de gerenciamento via API da Trovata.'''
 
  
Neste caso não necessita que seu servidor esteja com nenhum tipo de conexão externa visto que a chamada é feita diretamente para nossa retaguarda, tanto para gravação dos dados cadastrais quanto para obtenção de vendas e clientes novos ou alterados, porém é necessário sinalizar o interessem em trabalhar com este formato pois precisamos efetuar a liberação do módulo junto a base de dados.
 
  
Independente do formato de integração escolhida, será necessário estruturar os dados conforme nossos layout's, abaixo relacionamos a lista de dados considerados básicos, necessários para iniciar qualquer processo de implantação.
+
A Trovata disponibiliza uma API de integração própria, permitindo que todo processo de integração seja concentrado junto ao sistema de gestão da empresa (ERP).
  
'''Layouts de importação de dados:'''
+
Independente do formato de integração escolhido, será necessário estruturar os dados conforme nossos leiautes, por isso indicamos atenção especial aos dados abaixo relacionados, divididos em "Leiautes obrigatórios" e "Leiautes complementares".
  
* CLIENTE
 
* SITUACAO_CLIENTE (somente se houver necessidade de tratamento de situações de cliente - Ativo, Inativo, Inadimplente, etc, senão não precisa)
 
* TRANSPORTADOR (Se o ERP exigir na hora de exportar a venda, senão não precisa)
 
* VENDEDOR
 
* GRUPO_PRODUTO
 
* PRODUTO
 
* PRODUTO_COMPLEMENTO (necessita ser preenchida mesmo que não haja variação no cadastro do produto)
 
* COMPLEMENTO_1 (somente se houver variação no cadastro do produto, senão não precisa)
 
* COMPLEMENTO_2 (somente se houver variação no cadastro do produto, senão não precisa)
 
* COMPLEMENTO_3 (somente se houver variação no cadastro do produto, senão não precisa)
 
* PRAZO
 
* TABELA_PRECO
 
* ITEM_TABELA_PRECO
 
* ITEM_GRADE_PRODUTO (para os casos onde a grade - conjunto de tamanhos - é no nível do produto)
 
* ITEM_GRADE_GRUPO_PRODUTO (para os casos onde a grade - conjunto de tamanhos - é no nível do grupo do produto)
 
* TABELA_PRECO_PRAZO (somente se houver restrição de prazo por tabela de preços, senão não precisa)
 
* TABELA_PRECO_VENDEDOR (somente se houver liberação de tabela de preços por vendedor, senão não precisa)
 
* TITULO_FINANCEIRO (somente se desejar que o representante/vendedor veja os títulos financeiros do cliente, senão não precisa)
 
* CLIENTE_CREDITO (somente se desejar trabalhar com aprovação por limite de crédito na hora da venda, senão não precisa)
 
* CIDADE
 
* ESTADO
 
* PAIS
 
  
'''Layouts para exportação de vendas e clientes:'''  
+
'''Leiautes obrigatórios:'''
  
* Pedido de venda
+
Para o correto funcionamento do fluxo básico de nossas aplicações, precisamos receber os seguintes dados:
* Item do pedido de venda
+
 
* Cliente (inclusão e alteração)
+
* CLIENTE;
* Contato de cliente
+
* VENDEDOR;
 +
* VENDEDOR_CLIENTE (vinculando o cliente com cada vendedor que o atenderá);
 +
 
 +
* CIDADE;
 +
* ESTADO;
 +
* PAIS;
 +
 
 +
* PRODUTO;
 +
* PRODUTO_COMPLEMENTO (necessita ser preenchida mesmo que não haja variação no cadastro do produto);
 +
* COMPLEMENTO_1 (1º nível de variação do produto. Geralmente utilizado para registrar as variações de cores);
 +
* COMPLEMENTO_2 (Exclusivamente para definição da variação de TAMANHOS dos produtos);
 +
 
 +
* TABELA_PRECO;
 +
* ITEM_TABELA_PRECO;
 +
* MOEDA;
 +
* PRAZO (também conhecido como condição de pagamento);
 +
* TABELA_PRECO_PRAZO (liberando os prazos que cada tabela de preços permitirá comercializar);
 +
* TABELA_PRECO_VENDEDOR (liberando a tabela de preços para uso pelo vendedor);
 +
 
 +
 
 +
 
 +
Para integração das vendas e novos clientes junto ao ERP, nosso sistema disponibiliza os dados nas seguintes tabelas:
 +
 
 +
* VENDA
 +
* ITEM_VENDA
 +
* CLIENTE_INC_ALT (tanto para novos clientes incluídos, como para alterações de clientes já existentes)
 +
 
 +
 
 +
'''Atenção:'''
 +
 
 +
* A tabela CLIENTE não se confunde com a tabela CLIENTE_INC_ALT.
 +
 
 +
* A tabela CLIENTE é utilizada para receber e armazenar os dados da carteira de clientes já disponível no sistema da empresa (ERP), já a tabela CLIENTE_INC_ALT é onde são armazenados os novos clientes e/ou possíveis alterações de dados daqueles que já são clientes da empresa.
 +
 
 +
* Será necessário estabelecer um método de integração de clientes novos e/ou alterados, com base na tabela CLIENTE_INC_ALT e seu respectivo retorno como cliente disponível na tabela CLIENTE.
 +
 
 +
* Para que o vendedor possa "vender" para um referido cliente, este precisa ter seu cadastro disponível na tabela CLIENTE.
 +
 
 +
 
 +
 
 +
'''Leiautes complementares:'''
 +
 
 +
Além dos dados básicos, necessários para o funcionamento mínimo da aplicação, é possível integrar diversos outros dados com a finalidade de fornecer informações complementares para uso junto ao sistema, tais como:
 +
 
 +
* NOTA_FISCAL;
 +
* NOTA_FISCAL_ITEM;
 +
* NOTA_FISCAL_VENDA.
 +
 
 +
* VENDA_ERP;
 +
* VENDA_ERP_ITEM.
 +
 
 +
* CLASSIFICACAO_FISCAL;
 +
* CLASSIFICACAO_FISCAL_ESTADO.
 +
 
 +
* CLIENTE_CREDITO.
 +
 
 +
* TITULO_FINANCEIRO (atenção, integrar apenas títulos "Em aberto" ou "Parciais" - não deverão ser integrados títulos liquidados).
 +
 
 +
* COLECAO;
 +
* COLECAO_PRODUTO.
 +
 
 +
* CLIENTE_ULTIMO_PRODUTO.
 +
 
 +
* FORMA_PAGAMENTO.
 +
 
 +
* ESTOQUE.
 +
 
 +
* OCORRENCIA_VENDA.
 +
 
 +
* PERIODO_ENTREGA_VENDA.
 +
 
 +
* PRODUTO_COMERCIAL.
 +
 
 +
* TRANSPORTADOR.
 +
 
 +
 
 +
 
 +
Abaixo segue o link para acesso à documentação técnica de nossa API de integração, que permite obter mais detalhes sobre todos dados citados, além de diversas outras tabelas que não estão relacionadas neste artigo.
  
Além destes dados, é possível integrar diversos outros dados com a finalidade de fornecer informações complementares para uso junto ao sistema. Abaixo disponibilizamos um link para a documentação da nossa API que contém a instruções detalhadas de todas as tabelas de dados disponíveis para integração. Mesmo que o formato escolhido para integração não seja via API, nela será possível obter informações detalhadas para todos os dados.
 
  
 
* http://teste-api.trovata.com.br/doc/6a3bcba141d97ba0a45642fd85fbffed724833cc/1#/
 
* http://teste-api.trovata.com.br/doc/6a3bcba141d97ba0a45642fd85fbffed724833cc/1#/
 +
 +
 +
Mesmo que o formato escolhido para integração não seja via API, nela será possível obter maiores informações para todos os dados.
 +
 +
 +
Caso ainda restem dúvidas, basta entrar em contato com nossa equipe através do e-mail atendimento@trovata.com.br que um analista entrará em contato para maiores esclarecimentos.

Edição atual tal como às 14h29min de 7 de julho de 2021

Banner Topo 1.jpg


Para um bom funcionamento, todo sistema depende de informações corretas, atualizadas e consistentes. Os sistemas da TROVATA executam a maior parte dos seus serviços fazendo uso dos dados cadastrais fornecidos pelo seu sistema ERP (sistema interno de gestão / vendas, faturamento, etc.), dados estes que devem ser disponibilizados obedecendo uma estrutura pré-definida e adequada para o correto funcionamento de nossas soluções.

Caso seu sistema ainda não tenha implementado um processo de integração com nossas aplicações, você pode encaminhar este material para o seu fornecedor ou então encaminhar entre em contato conosco para avaliarmos as melhores opções.

Atenção, o processo de integração de nossa plataforma junto ao sistema de gerenciamento da empresa pode ter custos adicionais que precisarão ser tratados/negociados diretamente com seu fornecedor do sistema.


Atualmente contamos com os seguintes métodos de integração:


1 - Integração via compartilhamento de dados por arquivos;

2 - Integração por conexão banco a banco;

3 - Integração por meio de API (Application Programming Interface).


  • Independente do formato escolhido, é importante se certificar junto ao fornecedor do sistema de gestão da empresa (ERP) para saber se existe algum tipo de método de integração pronto disponível ou se será necessário desenvolvimento e/ou adequação.


A Trovata disponibiliza uma API de integração própria, permitindo que todo processo de integração seja concentrado junto ao sistema de gestão da empresa (ERP).

Independente do formato de integração escolhido, será necessário estruturar os dados conforme nossos leiautes, por isso indicamos atenção especial aos dados abaixo relacionados, divididos em "Leiautes obrigatórios" e "Leiautes complementares".


Leiautes obrigatórios:

Para o correto funcionamento do fluxo básico de nossas aplicações, precisamos receber os seguintes dados:

  • CLIENTE;
  • VENDEDOR;
  • VENDEDOR_CLIENTE (vinculando o cliente com cada vendedor que o atenderá);
  • CIDADE;
  • ESTADO;
  • PAIS;
  • PRODUTO;
  • PRODUTO_COMPLEMENTO (necessita ser preenchida mesmo que não haja variação no cadastro do produto);
  • COMPLEMENTO_1 (1º nível de variação do produto. Geralmente utilizado para registrar as variações de cores);
  • COMPLEMENTO_2 (Exclusivamente para definição da variação de TAMANHOS dos produtos);
  • TABELA_PRECO;
  • ITEM_TABELA_PRECO;
  • MOEDA;
  • PRAZO (também conhecido como condição de pagamento);
  • TABELA_PRECO_PRAZO (liberando os prazos que cada tabela de preços permitirá comercializar);
  • TABELA_PRECO_VENDEDOR (liberando a tabela de preços para uso pelo vendedor);


Para integração das vendas e novos clientes junto ao ERP, nosso sistema disponibiliza os dados nas seguintes tabelas:

  • VENDA
  • ITEM_VENDA
  • CLIENTE_INC_ALT (tanto para novos clientes incluídos, como para alterações de clientes já existentes)


Atenção:

  • A tabela CLIENTE não se confunde com a tabela CLIENTE_INC_ALT.
  • A tabela CLIENTE é utilizada para receber e armazenar os dados da carteira de clientes já disponível no sistema da empresa (ERP), já a tabela CLIENTE_INC_ALT é onde são armazenados os novos clientes e/ou possíveis alterações de dados daqueles que já são clientes da empresa.
  • Será necessário estabelecer um método de integração de clientes novos e/ou alterados, com base na tabela CLIENTE_INC_ALT e seu respectivo retorno como cliente disponível na tabela CLIENTE.
  • Para que o vendedor possa "vender" para um referido cliente, este precisa ter seu cadastro disponível na tabela CLIENTE.


Leiautes complementares:

Além dos dados básicos, necessários para o funcionamento mínimo da aplicação, é possível integrar diversos outros dados com a finalidade de fornecer informações complementares para uso junto ao sistema, tais como:

  • NOTA_FISCAL;
  • NOTA_FISCAL_ITEM;
  • NOTA_FISCAL_VENDA.
  • VENDA_ERP;
  • VENDA_ERP_ITEM.
  • CLASSIFICACAO_FISCAL;
  • CLASSIFICACAO_FISCAL_ESTADO.
  • CLIENTE_CREDITO.
  • TITULO_FINANCEIRO (atenção, integrar apenas títulos "Em aberto" ou "Parciais" - não deverão ser integrados títulos liquidados).
  • COLECAO;
  • COLECAO_PRODUTO.
  • CLIENTE_ULTIMO_PRODUTO.
  • FORMA_PAGAMENTO.
  • ESTOQUE.
  • OCORRENCIA_VENDA.
  • PERIODO_ENTREGA_VENDA.
  • PRODUTO_COMERCIAL.
  • TRANSPORTADOR.


Abaixo segue o link para acesso à documentação técnica de nossa API de integração, que permite obter mais detalhes sobre todos dados citados, além de diversas outras tabelas que não estão relacionadas neste artigo.



Mesmo que o formato escolhido para integração não seja via API, nela será possível obter maiores informações para todos os dados.


Caso ainda restem dúvidas, basta entrar em contato com nossa equipe através do e-mail atendimento@trovata.com.br que um analista entrará em contato para maiores esclarecimentos.