Integração HUB2B [Interno]

Aqui vimos que o HUB2B é um hub de integração com alguns dos maiores marketplaces do mercado, como Amazon, Mercado Livre, Enjoei, Americanas, etc.

Neste artigo, explicamos quais configurações internas devem ser realizadas na Vnda para possibilitar a comunicação entre plataformas.

Escopo da integração

Envio de catálogo da Vnda para o HUB2B (atualiza a cada 1 hora e apenas produtos que tiveram alguma alteração);
Recebimento de pedidos do HUB2B para o Hub Vnda (quando o cliente tem integração de ERP no HUB o pedido entra para faturamento no ERP);
Cadastro de categorias, atualizações de nota-fiscal e códigos de rastreios de pedidos serão realizados diretamente no painel da Hub2b.

O que preciso solicitar ao cliente?

Access Token V1
ID da empresa
ID da categoria padrão: Verificar qual será a categoria de produtos que irá utilizar
IDs dos canais de venda: Verificar quais destes irá utilizar https://hub2bapi.docs.apiary.io/#introduction/tabela-de-sistemas-(saleschannels)
Fretes do Mercado Livre
App User:
App Password

Estas informações podem ser obtidas com o suporte do HUB2B <suporte@hub2b.com.br>.

Configurando HUB Vnda

No HUB, irá criar um nova integração e preencher:

Domínio: Domínio da loja
Integração: HUB2B
Importar pedidos: Sim
Access Token V1: Obtido com o HUB2B
ID da empresa: Obtido com o HUB2B
Enviar produtos: Sim
Enviar produtos inativos?: Sim
Preencher marca com: Nome da marca
Preencher nome da variante com: product:name (informação padrão)
ID da categoria padrão: Será utilizado quando o tipo da categoria não for preenchido ou o produto não tiver a tag do tipo especificado
Tipo da tag categoria: Tipo a ser considerado para as tags de marca
Client: oSWbhAIqSGxJHfrcyOoGfZzz2vP74a (informação padrão)
Client Secret: 6Yzq57m5I8FD2vDHZThZF95DyADsHC (informação padrão)
App User: Obtido com o HUB2B
App Password: Obtido com o HUB2B
Importar pedidos: Não*
- Caso a integração seja feita seguindo o modelo de notificação, selecione a opção Não.

Nas preferências da integração, existe a opção do envio dos seguintes campos extras:

Marca
Categoria
Modelo

Opções para preenchimento desses campos:

Texto padrão: preencher com um 'texto' que será enviado para todos os produtos
Tag tipada: preencher com 'category:tipodatag' e será enviado a tag tipada correspondente para cada produto
- Alterar a variável tipodatag de acordo com o tipo cadastrado.
Atributo: preencher com 'property:nomedoatributo' e será enviado o atributo correspondente para cada produto
- Alterar a variável nomedoatributo de acordo com o tipo cadastrado.

O ideal para esses campos é utilizar uma tag tipada, nesses casos instruir o cliente para mapear essas informações no admin.

Configurando HUB2B

As etapas abaixo ficaram sob responsabilidade do HUB2B.

Envio de pedidos

Enviar o token de API da loja (gerado no admin) e solicitar para a HUB2B cadastrar uma integração (utilizando a conta da loja) do tipo que faz o envio de pedidos.

Informar os seguintes campos:

URL: https://host-da-loja/api/v2/orders/hub2b
Token: Bearer <token_da_vnda_gerado_no_admin_da_loja>
Descrição do Token de acesso (Authorization, APIKey): Authorization
Código Hub2b: informar o código do cliente do Hub2b

Quando gerar o token na loja no acesso em API no painel Vnda, importante selecionar a permissão em "Pedidos > Cria pedidos a partir de um Hook recebido da Hub2b".

Depois de finalizar o cadastro, avisar a HUB2B que ativamos a integração e pedir para validar se os dados foram enviados para eles.

Envio de categorias

Após finalizar a integração e ao sinalizar a HUB2B, devemos enviar as categorias da marca.

Precisamos extrair a planilha de tags, criando um usuário no admin, então exportando as tags na página de produtos.

Após exportar, edite a planilha para deixar apenas as categorias de produtos, conforme seu critério, e então envie para a HUB2B no e-mail da tratativa.

Informações Adicionais

Os pedidos são integrados em ciclos a cada hora
Cadastro de categorias, atualizações de nota-fiscal e códigos de rastreios de pedidos, serão realizados diretamente no painel da HUB2B.
Caso os produtos não sejam enviados para o HUB2B, ajustar as referências dentro da Vnda para que fiquem iguais em ambas plataformas. Estes códigos não devem ser trocados senão eles perderão a sincronia com a plataforma e marketplaces.
Ou seja, caso haja inconsistência na atualização/envio dos produtos pode ser devido à divergência no cadastro de produtos.
Reenvio de pedidos pela Hub2b:
1. Pedir ao time de suporte HUB2B o reenvio de todos os eventos dos pedidos que estão necessitando;
2. Entrar no pedido e clicar no botão "Reenviar Status".
Os pedidos recebidos que tiverem produtos não cadastrados no Admin, vão aparecer em branco no painel do seller. Ou seja, não irão aparecer os produtos.
Só aparecerão produtos já cadastrados no Admin nos pedidos vindos de marketplace.