Hub2b - Integração Shop Magento

Configuração da integração com o Magento 2

Introdução

O módulo da Hub2b é compatível com a versão 2.4+ para extensão da API nativa REST do Magento 2 e observadores de informações para que quando alteradas, notifiquem a Hub2b da alteração.

Instalação

Instalação via zip

Você pode fazer o download do módulo através do nosso repositório:

https://gitlab.com/hub2b/hub2b-extension-magento2

Descompacte os arquivos do módulo no diretório app/code/Hub2b/Marketplace

No terminal dentro da pasta de instalação do Magento rode os comandos abaixo para concluir a instalação.

Instalação com o Magento no modo Developer

bin/magento setup:upgrade

bin/magento cache:flush

Instalação com o Magento no modo Production

bin/magento setup:upgrade

bin/magento setup:di:compile

bin/magento setup:static-content:deploy

bin/magento cache:flush

caso não funcionar, tente utilizar “sudo bin/magento-cli” ao invés de “bin/magento”

Configurações

Caminho para a página de configuração: Stores > Configuration > Hub2b > Marketplace.

General

Client ID: É o identificador da loja na Hub2b. Você obtém no topo superior direito na Plataforma Hub.

Para gerar o token que será utilizado para conectar com a Hub2b, siga os passos abaixo:

1) Acesse System/Extensions/Integrations e adicione uma nova integração

2) Clique em Add New Integration (Adicionar Nova Integração)

3) Em Nova Integração, dê um nome à ela, um e-mail, e informe a senha do seu usuário para confirmar a criação da nova integração. Antes de Salvar, acesse a aba API e clique selecione a opção “All” (Todos).

4) Clique em Salvar. Você será redirecionado para a tela anterior. A nova integração aparecerá na listagem, com um link para Ativá-la.

5) Clique em “Activate” (Ativar), uma tela de permissão será aberta.

6) Clique em “Allow” (Permitir). Você será direcionado para uma tela com os tokens para integração. O Token que você precisa é o “Access Token”:

Utilize este Access Token para Adicionar uma nova integração na Hub2b.

Webhooks

Deve-se definir o caminho da API da Hub2b que irá lidar com mudança de preço, estoque, status de produtos e pedidos.

As rotas de produção serão fornecidas pela Hub2b.

As rotas de preço, estoque e status de produto são estas:

https://eb-api.plataformahub.com.br/RestServiceImpl.svc/Notifications/Magento2/{ID_LOJA}

Você consegue o ID_LOJA no topo superior direito da Plataforma Hub.

A rota de status de pedidos ainda não está disponível. A URL acima não faz o tratamento de atualizações de pedidos.

Operações e Fluxos

Magento <> Hub2b

Hub2b consulta no Magento:

Produtos
Categorias
Preço
Estoque
Status de pedidos
Nota fiscal
Código de Rastreio

Magento notifica a Hub2b (se configurado URLs de callback) alterações de:

Preço
Estoque
Status de produtos
Status de pedidos

Estas notificações são enviadas minuto a minuto para a Hub2b (a considerar tempo mínimo de notificação do grupo Index de Cron do Magento).

Produtos

A Hub2b consulta os produtos do Magento, importando os seguintes dados:

Nome Produto
Descrição Produto
Código da categoria
URL do produto
SKU
SKU pai
EAN ou ISBN (13 digitos)
Marca
Preço De
Preço Por
Estoque
Altura(m)
Largura(m)
Profundidade(m)
Peso(kg)
Tempo Compra / Fabricação
Url Imagem 1 (jpg/jpeg)
Url Imagem 2 (jpg/jpeg)
Url Imagem 3 (jpg/jpeg)
Url Imagem N (jpg/jpeg)
Atributo 1
Valores 1
Atributo 2
Valores 2
Atributo N
Valores N

Categorias

A Hub2b consulta as categorias do Magento, importando a estrutura de categorias e vinculando o último nível com o SKU.

Ex: Eletrodomésticos (1) > Frigobar (1.1)

Preço

A Hub2b consulta o preços dos SKUs no Magento e/ou é notificada pelo Magento, através das URLs de callback, quando há alteração nos preços, importando o Preço De e o Preço Por (promocional). É possível aplicar percentuais de acréscimo ou desconto ou criar campanhas diretamente na Hub2b, sem alterar o preço base no Magento.

Estoque

A Hub2b consulta estoque no Magento e/ou é notificada pelo Magento, através das URLs de callback quando há mudança nos estoques. Também consulta o tempo de manuseio (crossdocking) vinculado a cada SKU. Na Hub2b é possível adicionar ou subtrair um estoque virtual, que será somado com o estoque real ao ser enviado para o Marketplace.

Pedidos

A Hub2b cria os pedidos no Magento em tempo real e consulta os status e/ou é notificada pelo Magento, através das URLs de callback quando há mudanças nos status de pedidos. Todo o histórico das transações de um pedido fica disponível no log da Hub2b, desde sua criação na Hub2b, criação no Magento, atualizações de status e dados de nota fiscal e rastreio, até a atualização do last mile ao Marketplace.

Nota Fiscal e dados de envio do pedido

A Hub2b consulta os dados de Nota Fiscal no Magento, que precisam estar disponíveis no campo Observações do pedido, seguindo o padrão:

Na observação do pedido, colocar os dados da Nota Fiscal da seguinte forma (sem acento, sem espaço, como na forma abaixo):

Exemplo:

NUMERO:23423

SERIE:1

CHAVE:23947923874923840923843

A quebra de linha entre número, serie e chave deve ser “\r\n”.

Exemplo no código:

NUMERO:23423\r\n

SERIE:1\r\n