Integração Comercial x ERP

Integração Comercial x ERP

O que é?

Integração entre os pedidos de compra do Sistema Comercial e os pedidos de venda do Sistema ERP. Usuário do sistema comercial cadastra um pedido de compra destinado a indústria e o mesmo é enviado ao ERP, gerando um pedido de venda através do webservice.

Limitações

1. Não é possível lançar descontos no pedido a ser integrado. 2. O processo não está disponível para Indústria que trabalha com “Partes Customizáveis” e “Variação Indica Dimensão”.

Regra de Negócio

O sistema comercial envia apenas os dados do cliente e dos itens para o sistema ERP. Todo o restante é baseado na regra de negócios do próprio ERP. Ou seja, preços dos itens, prazos, fretes, local de entrega, consultores, supervisores e outros dados são todos definidos pelo próprio ERP. Para mais detalhes acompanhe o tópico processo.

Configurações

1.	Indústria

 a.	WebService
 A integração faz uso da mesma API utilizada pelo Tek-System Web Vendas. Logo, a indústria deverá ter corretamente configurado e em funcionamento o Webservice, para que seja possível a integração acontecer.

 b.	Cliente
 Deve existir na base de dados da indústria uma pessoa cadastrada como CLIENTE com o CNPJ correspondente ao CNPJ do comércio. Este cliente deve estar ATIVO.

 c.	Usuário para Acesso ao WebService
 Também é necessário que seja definido um usuário de acesso ao sistema para a integração. O módulo WEB 4G – Vendas deve estar liberado para este usuário assim como a empresa de destino dos pedidos de venda. Este usuário é que fornecerá o TOKEN para autenticação no WebService. Além disso, este usuário é o usuário que será exibido como responsável pelo cadastro dos pedidos de venda.

2.	Comércio

 a.	Integração
 Deverá existir no sistema comercial, cadastro da integração com o sistema do fornecedor.
 No caso da integração com o ERP da Tek-System, este cadastro já vem como padrão do sistema.

 b.	Configuração de Fornecedor
 No sistema comercial, deve existir um cadastro de fornecedor pessoa jurídica com CNPJ correspondente ao CNPJ da indústria. Além disso, na aba Integração, deve ser inserido o JSON com a configuração da integração. O JSON padrão pode ser utilizado para auxiliar o preenchimento. Para solicitar o mesmo utilize o botão verde com o símbolo ‘?’ (botão da imagem abaixo) ou dê um clique com o botão direito na área da configuração.

 Os parâmetros deste JSON são:

 •	codigoIntegracaoFornecedor: deve ser indicado o código do cadastro da integração com fornecedor atualmente utilizada, pois poderão existir outras integrações com fornecedores que não utilizam o ERP da Tek-System, por exemplo.

 •	url: endereço completo de acesso ao site de venda da indústria;

 •	token: token do usuário definido na etapa “Usuário para Acesso ao WebService” nos Requisitos da Indústria.

 •	receberCopiaPedidoPorEmail: indicar com true ou false. Em caso de true, após o envio do pedido, tenta enviar um e-mail contendo a cópia do pedido gerado para o e-mail definido no cadastro do cliente ERP correspondente ao comércio. 

 Este envio será realizado pelo WebService, da mesma forma quando solicitado pelo site de vendas.

 •	emailsCopia: se preenchido, tentará também enviar o e-mail com a cópia do pedido para os e-mails definidos no array.

 •	atualizarNegociacaoDeAcordoComERP: preencher com true ou false. Em caso de true, após o envio do pedido, serão atualizados os preços unitários dos produtos no pedido de compra, o preço total do pedido de compra e os prazos do pedido de compra de acordo com o que foi definido pela regra de negócios do sistema ERP do fornecedor ao gravar o pedido integrado no sistema. Além disso, tenta atualizar também a previsão de duplicatas de acordo com o ERP utilizando a mesma classe do botão Previsão de Duplicatas do ERP. Caso este processamento resulte em um erro (um dos itens sem configuração de tributação por exemplo), simplesmente calcula-se o total do pedido de compra dividindo-se pelos prazos, ignorando impostos, fretes, etc...).

Em caso de false, mantém os preços, prazos e previsão de duplicatas que foram estimados no sistema comercial (lembrando que os valores informados no sistema comercial não têm nenhuma influência nos valores e prazos gravados no ERP. São apenas informativos).

 c.	Mapeamento de Produtos
 Os produtos que serão enviados nos pedidos de compra devem ter mapeamento realizado em seu cadastro para que seja possível identificar o item correspondente no sistema ERP.