Ir para a Comunidade Ir para a Central de Ajuda
Ir para a Comunidade Ir para a Central de Ajuda

Módulo Magento SkyHub

Artigos nessa seção

Exibir mais

Instalação do Módulo para Integração entre Magento 2.x e SkyHub
Atualizado

Avatar
Lucas F.
Seguir

# Solicite a instalação ao seu desenvolvedor responsável pelo Magento.

Abaixo você encontra as informações necessárias para instalação do módulo de integração entre a plataforma Magento 2.x e a SkyHub desenvolvido pela SkyHub.

Atenção! - É muito importante que você mantenha o módulo atualizado. Se já possui a instalação, verifique qual é a versão e se necessário solicite a atualização para seu desenvolvedor Magento.

Etapas de Instalação do Módulo:

As etapas abaixo definem o fluxo de instalação do módulo no Magento.

  1. Verificando as dependências técnicas da sua instalação Magento;
  2. Instalação do módulo e suas dependências no Magento;
  3. Configuração do módulo para conexão com a API da SkyHub;
  4. Mapeamento de seus atributos no Magento;
  5. Configuração das rotinas de CRONs da sua loja;
  6. Atualizações das versões do módulo;
  7. O que o módulo altera no meu ambiente.

Para que o módulo funcione corretamente é imprescindível realizar todas as etapas, por isso siga
as orientações deste tutorial até o final.

1. Pré requisitos: 

* Veja no final desse artigo as últimas correções, documentação completa para o desenvolvedor e o que a instalação do módulo altera no ambiente do seller.

2. Instalação do módulo no Magento:

Solução #1: Composer (recomendada)

Obs.: para esta solução, é necessário que o lojista possua uma conta no Marketplace do
Magento (​https://marketplace.magento.com/​).

Passo 1:​ Execute as seguintes linhas de comando na pasta raiz do magento:

composer require bittools/skyhub-m2

Passo 2:​ informe seu usuário e senha (https://marketplace.magento.com/customer/accessKeys/):

Passo 3:​ Execute as seguintes linhas de comando na pasta raiz do magento:

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

Passo 4:​ Verifique se aparece o menu:

mceclip1.png

3. Configuração do módulo para conexão com a API da SkyHub

Deve-se escolher o escopo de loja a ser configurado no Magento

mceclip2.png

General Settings:

mceclip3.png

  • Versão do módulo atualmente instalado;
  • Cron Heartbeat que mostra a saúde das crons se estão funcionando;
  • Habilitar ou desabilitar o módulo.

Catalog Integration Settings:

mceclip4.png

  • A visibilidade dos produtos que podem ser integradas devem ser configuradas;
  • É possível escolher se a integração de um produto após a mudança de preço e/ou
    estoque reflita automaticamente ao salvar o produto, caso contrário será colocada na fila
    de integração de produtos;
  • É possível atualizar todos os itens de um pedido ao ser integrado no Magento;

Log Configuration:

mceclip5.png

  • Habilitar ou desabilitar o log de atividades do lado do Magento

API Service Configuration:

mceclip6.png

Order Status Configuration

mceclip7.png

  • Configuração dos status do Magento ao receber pedidos pendentes e aprovados e ao enviar status entregue e exceção na entrega.

4. Mapeamento de atributos de produtos e clientes

Mapeamento de Atributos de Produtos do Magento para a SkyHub

mceclip9.png

  • O mapeamento de atributos de produto é obrigatório para o funcionamento do módulo.
  • A integração só irá funcionar quando todos os atributos obrigatórios forem mapeados.

Mapeamento de atributos de clientes no recebimento de pedidos no Magento:

Caso a loja esteja preparada para trabalhar com diferentes tipos de clientes, pessoa física e
jurídica será preciso efetuar o mapeamento dos atributos de clientes.

Da mesma maneira que é feito para produtos, a diferença é que o mapeamento de atributos de clientes não impede a execução da integração.

Em BSeller - Integração Skyhub - Atributos de Clientes - Mapeamento de Atributos

Customer Attributes Mapping

mceclip10.png

Para mapear o atributo, basta clicar no nome do atributo, como por exemplo o CPF para o atributo Taxvat padrão do Magento:

mceclip11.png

Para criar um novo atributo de maneira automática, basta clicar em Create and Associate, o módulo fará a criação do novo atributo e o seu mapeamento.

mceclip12.png

Os atributos de clientes criados automaticamente serão identificados no registro do cliente:

mceclip13.png

5. Configuração do tempo de execução das crons

Configurado de acordo com a entidade (atributos, produtos, categorias, status de pedidos e importação de pedidos):

mceclip8.png

Obs: Ao salvar um produto após a edição ele é sincronizado com a Skyhub.

Order Import Cron Configuration

Em Configuração da Cron de importação de pedidos é possível escolher qual o formato do increment id (use default order sequence number).

Se for escolhido SIM o pedido será integrado com a numeração padrão do Magento e em caso de Não o pedido será integrado com a identificação vinda da Skyhub.

mceclip14.png

Configuração das rotinas de crons da sua loja

No módulo, as crons responsáveis pela integração são as seguintes:

bittools_skyhub_catalog_category_queue_create
Cria a fila de integração de Categorias

bittools_skyhub_catalog_category_queue_execute
Executa a fila de integração de Categorias

bittools_skyhub_catalog_product_attributes_queue_create
Executa a fila criada de integração de Atributos de Produtos

bittools_skyhub_catalog_product_attributes_queue_execute
Cria a fila de integração de Atributos de Produtos

bittools_skyhub_catalog_product_queue_create
Cria a fila de integração de Produtos

bittools_skyhub_catalog_product_queue_execute
Executa a fila de integração de Produtos

bittools_skyhub_sales_order_import
Executa a importação de novos pedidos

bittools_skyhub_sales_order_status_update_queue_create
Cria a fila de integração de status de pedidos

bittools_skyhub_sales_order_status_update_queue_execute
Executa a fila de integração de Status de Pedidos

6. Releases do módulo:

Na documentação a seguir estão disponíveis as datas com as versões lançadas do módulo:
>> https://github.com/bittools/skyhub-magento2/releases

E a seguir as correções e melhorias executadas em cada uma dessas versões:
>> https://github.com/bittools/skyhub-magento2/blob/master/CHANGELOG.md

Para atualizar ou reinstalar o módulo lembre-se sempre de seguir o procedimento indicado no tópico 2 (instalação do módulo Magento) desse material.

7. O que o módulo altera na minha loja?

Em relação a código, o módulo não altera e nem sobrescreve absolutamente nenhum arquivo do Magento e/ou de outros módulos.

Em questão de banco de dados, o módulo cria as seguintes tabelas:

bittools_skyhub_entity_id
Tabela responsável por guardar todas as entidades que já foram integradas entre a sua loja Magento e sua conta SkyHub.

bittools_skyhub_product_attributes_mapping
Esta tabela é responsável por armazenar todos os atributos de produto necessários para a integração de produtos na SkyHub e que devem ser mapeados com os atributos na sua loja Magento nos setup inicial do módulo.

bittools_skyhub_customer_attributes_mapping
Esta tabela é responsável por armazenar todos os atributos de cliente necessários para a integração de pedidos na SkyHub e que devem ser mapeados com os atributos na sua loja Magento nos setup inicial do módulo.

bittools_skyhub_customer_attributes_mapping_options
Quando o atributo de cliente a ser mapeado possui opções que também devem ser mapeadas, essa tabela armazenará o mapeamento dessas opções.

Exemplo: “tipo de pessoa”. Esse atributos possui 2 possíveis valores, pessoa jurídica e pessoa física. O Cliente pode já possuir esse atributo criado em sua loja com o valor “f” para fisica e “j” para jurídica, ou “fisica” para fisica e “juridica” para jurídica, ou “1” para física e “0” para jurídica, e por aí vai. Esse mapeamento é registrado nessa tabela.

bittools_skyhub_queue
Esta tabela é responsável por armazenar todas as entidades que deve ser enfileiradas para a integração com a SkyHub. Basicamente todas as filas de entidades (atributo de produto, produto, categoria, status de pedidos, etc) são criadas nesta tabela.

bittools_skyhub_orders
Essa tabela é utilizada para armazenar dados de pedidos relacionados à skyhub. Exemplo, chave de NFE, código da skyhub, etc.

Artigos relacionados

Comentários 0

Por favor, entre para comentar.