# 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.
Data da última atualização do módulo: 16/02/2022
Versão: 1.0.17
Link: https://github.com/bittools/
Etapas de Instalação do Módulo:
As etapas abaixo definem o fluxo de instalação do módulo no Magento.
- Verificando as dependências técnicas da sua instalação Magento;
- Instalação do módulo e suas dependências no Magento;
- Configuração do módulo para conexão com a API da SkyHub;
- Mapeamento de seus atributos no Magento;
- Configuração das rotinas de CRONs da sua loja;
- Atualizações das versões do módulo;
- 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:
- A versão do Magento deve ser superior ou igual a 2.2.4;
- Caso queira integrar o módulo Magento 1.x com a SkyHub, por gentileza acesse o artigo a seguir: >> Instalação do Módulo de Integração SkyHub para Magento 1
- PHP 7.0 ou superior;
- MySQL 5.6;
- Cadastro no Marketplace B2W ou permissão da equipe comercial para outros marketplaces;
- Solicitar suas credenciais SkyHub (Token e Usuário) de acesso para integração:
- Para integrar com marketplace B2W solicite suas credenciais diretamente no portal parceiro B2W pelo artigo a seguir >> Como Solicitar Integração Entre SkyHub e B2W
- Para integrar com os demais marketplaces entre em contato com o nosso time comercial pelo formulário a seguir: >> Como Solicitar Integração Entre SkyHub e Outros Marketplaces
* 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:
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
General Settings:
- 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:
- 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:
- Habilitar ou desabilitar o log de atividades do lado do Magento
API Service Configuration:
- Dados de autenticação na API da Skyhub para cada uma das Stores a ser integrada no
Magento.- Utilize o login e token fornecido pela B2W através do procedimento abaixo ou pelo time Comercial SkyHub caso a integração seja para outros marketplaces:
Order Status Configuration
- 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
- 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
Para mapear o atributo, basta clicar no nome do atributo, como por exemplo o CPF para o atributo Taxvat padrão do Magento:
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.
Os atributos de clientes criados automaticamente serão identificados no registro do cliente:
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):
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.
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.
Comentários 0
Por favor, entre para comentar.