[Manual] Integrador E-Commerce

Owned by Thais Sanches (Unlicensed)
Last updated: set. 06, 2023 by Damián Muñoz
11 min read

Introdução

O integrador E-Commerce é responsável pela integração do Guarani ERP com as plataformas Plugg.to, JetCommerce, EzCommerce e CWS Digital. Essa integração consiste em enviar Produtos, Estoque, Preços, Imagens, Atualizar Status dos Pedidos e receber os Pedidos e Clientes, com exceção da CWS Digital que apenas atualiza Estoque e Preço da lista de produtos que já existe na plataforma.

Atualmente o integrador suporta apenas uma empresa e uma plataforma.

O integrador não deve ser iniciado em dois lugares ao mesmo tempo, podendo ocorrer duplicidade de informações na plataforma e no ERP.

Instalação

A instalação deve ser feita no servidor do cliente através do SETUP que se encontra no FTP em “FTP\Sistemas\Guarani Integrador ECommerce\Setup\Setup_IntegradorECommerce_v1.X.X.exe”.

O integrador será instalado em “C:\Guarani\Integrador ECommerce”. Será gerado um atalho na área de trabalho da configuração do integrador “Guarani Integrador E-Commerce”, porém o mesmo funciona em modo de serviço do Windows, afim de que inicie sem a necessidade de logar no Windows. Esse atalho serve apenas para configurações e testes, a integração automática não ocorre por ele.

O serviço pode ser encontrado no Gerenciador de Serviços do Windows com o nome “Guarani Integrador E-Commerce” ou “SvcGuaraniECommerce”.

Sempre que for necessário criar um novo atalho do executável “GuaraniECommerce.exe”, o destino deve conter “/config” após o caminho do executável.

[Imagem 1 - Tela de atalho do integrador]

Integrador

Após instalado e iniciado o integrador pelo atalho criado, será apresentada a tela inicial que possui os seguintes recursos:

[Imagem 2 - Tela inicial de configuração do integrador]

  1. Serão apresentados os logs, sendo que quando for algum erro a linha ficará em vermelho;

  2. Continuar/Pausar Integração: Utilizado para pausar ou continuar a integração pausada sem a necessidade de interromper o serviço;

  3. Configuração Banco: Será apresentada a tela onde deverá ser configurado o banco de dados Guarani e o e-mail (opcional) que receberá os aviso de erros do log;

[Imagem 3 - Tela Configuração Banco]

a.O botão “Testar” testa a conexão com o banco e envia um e-mail de teste para verificar se esta funcionando.

b.O campo “Sincronizar(minuto)” define o tempo que a integração sera realizada no modo de serviço.

4. Configurações Gerais: Utilizado para definir o comportamento do integrador, será explicado com detalhes mais abaixo;

5. Carga de Dados

a. Quando forem os e-commerces Plugg.to, JetCommerce e EzCommerce, será apresentada a tela com as opções, conforme cada integração, para realização de integrações manuais. Utilizado em período de homologação do cliente para não enviar/receber dados desnecessários nos testes.

[Imagem 4 - Tela Carga de Dados]

b.Quando for o e-commerce CWS Digital, será apresentada a tela abaixo:

[Imagem 5 - Tela Carga de Dados CWS Digital]

i. Buscar Produtos CWS: Realiza de forma manual a busca de produtos do catalogo da loja na CWS Digital. Na loja os produtos devem estar liberados para venda na loja e com estoque criado com o “Código Interno” preenchido com o código existente no ERP. Nessa busca será feita a relação dos produtos da loja com o ERP para assim poder fazer a atualização de Estoque e Preço. Essa busca será feita no modo serviço de forma automática a cada 2 horas, verificando assim se novos produtos estão disponíveis na loja.

  1. No grid serão apresentados os produtos que disponíveis para a loja no site e se o mesmo foi encontrado no ERP com base no código informado na plataforma.

ii. Atualizar Estoque e Preço: Realiza a atualização de estoque e preço dos produtos no site, conforme os produtos que foram buscados.

6.Parado: Será apresentado os status do serviço, como “Não Instalado”, “Parado”, “Em Execução” e “Pausado”. Ao lado tem as opções para ser usadas apenas onde o serviço do integrador estiver instalado, sendo: “Instalar”, “Iniciar”, “Parar” e “Log Serviço”.

[Imagem 6 - Opções serviço]

a. A opção “Logs Serviços” é de extrema importância para verificar quando o serviço não estiver iniciando. Será apresentada uma tela com detalhes do funcionamento em modo serviço.

[Imagem 7 - Tela de Logs Serviços]

7. Fechar: Fecha a tela de configuração, porém se o serviço estiver em funcionamento não será interrompido.

Configurações Gerais

As configurações principais do integrador estão nessa tela, existem vários ajustes que devem ser definidos juntos ao cliente e o mesmo deve conseguir configurar/alterar quando necessário.

[Imagem 8 - Tela Configurações Gerais]

  • A aba “Web Service” e os campos “Empresa” e “E-commerce” só são habilitados ao clicar no botão “Hab. Config” e digitar a senha utilizada no Guarani.

  • Todos os campos da configuração devem ser preenchidos, caso contrário a integração não será iniciada.

  • Quando o E-commerce selecionado é CWS Digital, somente os campos “Empresa”, “E-commerce” e “Tabela Padrão” ficam disponíveis para preenchimento e também só a aba “Estoques” será exibida.

  • Após definir a “Empresa” e “E-Commerce” utilizados, os seguintes campos devem ser preenchidos na aba “Configurações De → Para”:

[Imagem 9 - Aba “Configurações De → Para” da tela Configurações Gerais]

  • Tipo de Ordem: Tipo de ordem que será utilizado para os pedidos importados;

  • Origem do Pedido: Utilizado para distinguir a origem de criação do pedido, exemplo: AFV, B2UD, etc…;

  • Tabela Padrão: Tabela utilizada para envio dos produtos/preços e para importação dos pedidos. É utilizada para definir quais produtos serão integrados, uma vez que somente os produtos que estão nessa tabela serão enviados;

  • Representante: Representante padrão utilizado para preenchimento do pedido quando não houver nenhuma configuração na aba “Representante”;

  • Centro Lucro Cliente: Centro de Lucro que será utilizado para preencher o cadastro de um novo cliente;

  • Transportadora Cliente: Transportadora que será utilizada para preencher o cadastro de um novo cliente;

  • Ramo Atividades Cliente: Ramo de Atividades que será utilizado para preencher o cadastro de um novo cliente;

  • Cada aba da configuração dentro de “Configurações De → Para” tem um papel importante na integração para definir alguns comportamentos.

    • Cobrança: Aqui é possível definir a cobrança que será criada no pedido importado. Utilizando a forma de pagamento enviada junto ao pedido e a origem, é possível definir qual será a cobrança do sistema será utilizada.

 

[Imagem 10 - Aba “Cobrança” da tela Configurações Gerais]

  • Forma Pgto (Ecommerce): Forma de pagamento enviado pela plataforma no pedido, cada plataforma tem sua forma de pagamento, exemplo: “CREDIT”, “BOLETO”, etc… (Esse campo é selecionável e será populado conforme os pedidos são recebidos);

    • Quando vier vazia a forma de pagamento poderá ser usada a opção “Todas”.

  • Origem Pedido (Ecommerce): Loja de origem do pedido, exemplo: “AMERICANAS”, “MERCADOLIVRE”, etc... (Esse campo é selecionável e será populado conforme os pedidos são recebidos);

  • Cobrança (Guarani): Cobrança Guarani que será usada pela combinação “Forma Pgto (Ecommerce)” + “Origem Pedido (Ecommerce)”;

  • Prazo Dias (Guarani): Prazo que será inserido nos campos de prazos do pedido no Guarani conforme as parcelas. Exemplo: Se informado 30 Dias e forem 3 parcelas no pedido recebido, será preenchido o campo Prz01 com 30, Prz02 com 60 e Prz03 com 90;

  • Caso no log apresente o erro “Forma de pagamento XXXXXXXX origem YYYYYY não configurada no integrador!”, será nessa aba que devera ser configurado a forma de pagamento.

  • Transportadora: Será possível definir a transportadora do pedido no Guarani com base na transportadora enviada.

[Imagem 11 - Aba Transportadora da tela Configurações Gerais]

  • Transportadora (Ecommerce): transportadora recebida no pedido e que será usada para definir qual será a transportadora correspondente no Guarani (Esse campo é selecionável e será populado conforme os pedidos são recebidos);

  • Transportadora (Guarani): Deverá ser preenchida qual é a transportadora correspondente no Guarani;

  • Roteiro de Entrega-Carga (Guarani): Informe qual será o roteiro utilizado pela transportadora;

  • URL de Rastreamento (Para Status “Enviado”): URL de rastreamento utilizado pela transportadora, será enviado junto ao status dos pedidos para plataforma. Exemplo: https://www2.correios.com.br/sistemas/rastreamento/ ;

  • Caso no log apresente o erro “Transportadora YYYYYYYYY não configurada no integrador!”, será nessa aba que devera ser configurado a Transportadora.

  • Estoques: nessa aba devem ser informados os locais de estoque que serão considerados para envio da quantidade em estoque dos produtos, sendo que se informado mais de um local de estoque, será feita a soma dos mesmos para envio.

[Imagem 12 - Aba “Estoque” da tela Configurações Gerais]

Cidades: Caso o integrador apresente nos logs algum erro “Cidade do cliente não encontrada na base”, basta informa a Cidade e Estado apresentados no erro nesta aba definindo no campo “Cidade (Guarani)” qual é cidade correspondente na base de dados Guarani. Esse erro pode ocorrer se for uma cidade que não esta no padrão de nomenclaturas do IBGE.

[Imagem 12 - Aba “Cidades” da tela Configurações Gerais]

Representantes: nessa aba podemos definir um representante para cada origem de pedido.

[Imagem 14 - Aba “Representantes” da tela Configurações Gerais]

  • Origem Pedido (Ecommerce): Loja de origem do pedido, exemplo: “AMERICANAS”, “MERCADOLIVRE”, etc... (Esse campo é selecionável e será populado conforme os pedidos são recebidos);

  • Representante (Guarani): Representante Guarani que corresponde a origem selecionada.

  • Aviso Cancelamento: Informe os usuário que receberam um aviso quando o pedido que foi importado for cancelado na plataforma.

[Imagem 15 - Aba “Aviso Cancelamento” da tela Configurações Gerais]

Aviso de cancelamento gerado no ERP:

[Imagem 16 - Quadro de Avisos Guarani ERP]

Na aba “Webservice”, que só é habilitada mediante a senha Guarani, serão preenchidos os dados de acesso da plataforma e o que devera ser integrado. Alguns campos são habilitados/desabilitados conforme o E-Commerce selecionado.

[Imagem 17 - Opções de Integração na aba “WebService” da tela Configurações Gerais]

Em “Opções de Integração” podemos definir como a integração deve funcionar:

[Imagem 18 - Aba “WebService” da tela Configurações Gerais]

  • Produtos, Preços, Estoque, Categorias, Imagem, S3 Amazon, Pedidos, Status: Essas opções podem ser habilitadas/desabilitadas na integração.

  • Data Inicio Pedido: Data considerada para inicio de integração dos pedidos. Utilizado apenas na integração com EzCommerce. Anterior a essa data, o pedido não será integrado ao ERP.

  • Status Importação p/ Integrador: Status que será considerado para que um pedido possa ser recebido no integrador. Geralmente é definido o status onde o pagamento é aprovado.

  • Status Importação p/ ERP: Status que será considerado para que um pedido possa ser enviado ao ERP. Geralmente é definido o status onde o pagamento é aprovado. Utilizado apenas na integração com EzCommerce.

  • Campo Chave do Produto: Campo do cadastro de produto que será usado como chave para enviar as informações do produto e para encontrar o produto no ERP vindo em um pedido.

  • As informações preenchidas em “WebService” devem ser solicitadas pelo cliente junto a plataforma e configuradas no integrador, cada campo conforme informado pela plataforma.

[Imagem 19 - WebService na aba “WebService” da tela Configurações Gerais]

  • URL integração: Atualmente existem as seguintes URL’s:

  • Os demais campos devem ser preenchidos conforme passado pela plataforma.

  • Os campos em “Amazon S3” são utilizados apenas na integração com Plugg.to, uma vez que atualmente a plataforma não disponibiliza o upload das imagens dos produtos via integração. Então para realizar a integração de imagens para Plugg.to é necessário que o cliente adquira uma espaço de armazenamento na Amazon S3 chamado “Bucket” configurado de forma publica (qualquer um com o link pode visualizar o que esta nesse espaço) e passe essas informações de acesso para serem configuradas no integrador. Assim o integrador envia para Amazon as imagens e é retornado um link de endereço web dessa imagem, esse link é enviado junto ao produto para Plugg.to. Essa integração com a Amazon é opcional, porém sem essa integração os produtos serão enviados sem as imagens, devendo inserir as imagens diretamente na plataforma.

[Imagem 20 - Amazon S3 na aba “WebService” da tela Configurações Gerais]

O botão “Testar” testa a comunicação do integrador com o WebSerive da plataforma e com a Amazon S3 (se configurado).

Funcionamento da integração

  • Após configurado o integrador, será possível inicia-lo como serviço ou realizar a carga de forma manual (Carga de Dados). Se iniciado como serviço, na primeira integração será feito o envio de todos os produtos que estão na tabela de preço e a cada intervalo de tempo, definido na “Configuração banco”, será feito o envio somente do que foi alterado no sistema.

  • O pedido assim que enviado ao ERP pelo integrador fica disponível na tela “Guarani móvel - Android - importação de dados” do ERP para que o pedido seja efetivamente gerado, seguindo o processo de importação de pedidos do AFV.

  • A mudança de status enviada para plataforma de forma automática quando ocorre alguns dos seguintes processos:

    • Quando o pedido é importado para o ERP:

      • Plugg.to: Muda o status para “Nota Fiscal Solicitada” (waiting_invoice);

      • JetCommerce: Não existe status para mudança;

      • EzCommerce: Não existe status para mudança;

    • Quando é feito o Faturamento do pedido:

      • Plugg.to: Muda o status para “Faturado” (invoiced);

      • JetCommerce: Muda o status para “Em produção”;

      • EzCommerce: Muda o status para “Enviado”;

    • Quando é preenchido o código de rastreio do pedido pela Digitação de Ordens:

      • Plugg.to: Muda o status para “Envio Informado” (shipping_informed);

      • JetCommerce: Muda o status para “Despachado”;

      • EzCommerce: Não existe status para mudança;

    • Quando for realizado o Fechamento da Ordem:

      • Plugg.to: Muda o status para “Entregue” (delivered);

      • JetCommerce: Muda o status para “Concluído”;

      • EzCommerce: Muda o status para “Finalizado”;

  • A quantidade em estoque enviada, além de ser a soma dos locais de estoques configurados, é também a somados estoques dos itens que estão na aba “Ficha Técnica” do Cadastro de Produto do ERP do com o tipo “Acabado” e com a opção “Separação?” marcado como SIM.

  • O e-commerce CWS Digital, como dito anteriormente, realiza apenas a atualização de Estoque e Preço, baseado em um catalogo de produtos já existente na plataforma, devendo o cliente habilitar os produtos que serão vendidos pela loja e criar o estoque com o código correspondente no ERP.

Links e Manuais