Integração ERP com a HUB2B
Integração desenvolvida pela HUB2B, através da nossa API de integração.
Recursos disponíveis
| Receber pedidos Solução desenvolvida pela HUB2B | ✔ |
| Receber produtos | x |
| Enviar produtos | ✔ |
| Enviar estoque Disponível nos planos Iniciante e Básico através da extensão 'API para estoque em tempo real' de R$ 25,00. Grátis nos planos Essencial e Grande | ✔ |
| Enviar preços | x |
| Sincronizar situação | x |
Configuração no ERP
Configurar integração com a HUB2B
Acesse as integrações do ERP em Menu → Início → Integrações.
Caso já possua integrações configuradas em sua conta, as mesmas serão exibidas e indicadas com suas respectivas situações.
Cada situação indica:
- Ativa: Representa que a configuração da integração foi realizada com sucesso e a mesma encontra-se pronta para uso.
- Inativa: Indica a inatividade desta loja no ERP, a mesma não será utilizada ou mostrada para sincronização de pedidos, produtos e demais ações pertinentes.
- Não configurada: Esta situação indica que a configuração ainda não foi realizada.
- Não instalada: Representa que ainda não houve a comunicação com o e-commerce para ativar a integração.
Agora, clique no botão Adicionar integração, busque por HUB2B e clique em Instalar.
Na aba Conexão, no campo Nome informe o nome da sua loja.
Defina os seguintes campos abaixo:
Na aba Notificações > Notificações por e-mail
| Enviar e-mail de rastreamento ao alterar a situação no ERP para enviado | Se este parâmetro estiver ativo, sempre que o pedido for alterado para Enviado no ERP, o código de rastreio será enviado de forma automática via e-mail conforme layout estabelecido nas configurações da expedição. |
|---|---|
| Enviar e-mail de entrega ao alterar a situação no ERP para entregue | Ao habilitar este parâmetro, sempre que um pedido for alterado para a situação Entregue no ERP, será enviado de forma automática um e-mail conforme layout estabelecido nas configurações da expedição. |
Na aba Produtos > Regras de estoque, defina as regras de estoque da integração em:
| Atualizar estoque na loja virtual a partir do ERP | Selecione uma das opções disponíveis para atualização do estoque, sendo elas: não atualizar, enviar saldo físico (estoque total) ou enviar saldo disponível (estoque total considerando a reserva de estoque). |
|---|---|
| Depósito a ser considerado na integração |
Escolha qual será o depósito padrão para as ações: importar pedido, importar produtos e enviar estoque. * O campo depósito a ser considerado na integração será exibido nas contas que possuem a extensão depósitos de estoque instalada. |
| Lançamento de estoque para saídas |
Defina quando o estoque dos pedidos será lançado: ao selecionar a opção Manual , o usuário deverá através do menu de contexto localizado ao lado de cada pedido ou nota fiscal selecionar a opção Lançar estoque. Se escolhida uma das opções de Automático , o sistema fará o lançamento no momento determinado: Ao autorizar a NFe , Ao salvar NFe , Ao salvar o pedido ou Ao marcar pedido como enviado. Se selecionar Ao marcar pedido como enviado e o pedido tiver uma nota fiscal vinculada, o lançamento de estoque ocorrerá pela nota fiscal. * O lançamento do estoque pode ser parametrizado de acordo com as configurações das naturezas de operação. Ao lançar estoque manual para uma natureza configurada para não permitir lançamento de estoque, será exibido um aviso não permitindo lançar estoque. A configuração da natureza de operação deverá ser verificada. |
| Estoque de segurança |
Informe a quantidade de estoque de segurança para que, quando seu estoque atingir este número, a quantidade de estoque enviada para a plataforma seja Zero. * Produtos sob encomenda não estão abrangidos por este parâmetro. |
Na aba Pedidos > Dados Fiscais , no campo Natureza de operação para venda desta integração selecione uma Natureza de venda padrão para essa plataforma. A natureza selecionada será atribuída na Importação dos pedidos no ERP e no momento em que gerar a Nota Fiscal através do pedido importado.
Observação:
Além disso, você pode Habilitar ou Desabilitar o campo Definir natureza de operação diferente para destinatários contribuintes do ICMS. Habilitando esse campo, você poderá selecionar uma natureza de operação específica, a qual será aplicada no momento em que o ERP identificar que o pedido de venda trata-se de um cliente contribuinte.
Na aba Notificações > Urls de notificações preencha os campos URL do notificações de estoque e URL para envio de produtos com as URLs utilizadas para webhook de sua loja virtual.
Observação:
Estes links devem ser solicitados ao suporte da HUB2B.
Ao final, não esqueça de Salvar as configurações.
Adicionar extensão token api
Inicie adicionando a extensão Token API em sua conta. Para isso acesse Menu → Início → Extensões do ERP.
Na seção Vendas , adicione a extensão Token API.
Agora, clique em Instalar e Confirme a instalação da extensão.
Gerar token api
Acesse as configurações de e-commerce do ERP em Menu → Configurações → Aba E-commerce → Token API.
No campo Token , encontra-se o Token identificador da sua conta.
Esse token deve ser adicionado no momento que integrar o ERP na HUB2B, conforme orientação integrar o ERP com a plataforma HUB2B.
Como enviar produtos do ERP para HUB2B
Enviar apenas um produto
Para enviar apenas um produto para HUB2B, acesse em Menu → Cadastros → Produtos.
Agora, acesse o Menu de contexto do produto e clique em Enviar para o e-commerce.
A seguir, no campo Plataforma selecione sua loja HUB2B e marque a opção Atualizar estoque no e-commerce. Após isso, clique em Avançar.
Valide se o produto esta com as informações corretas para envio clique em Enviar.
Campos enviados:
- Descrição;
- Descrição complementar;
- Código;
- Preço;
- Preço promocional;
- GTIN da embalagem;
- NCM;
- Peso bruto;
- Estoque;
- Marca;
- Anexos;
- Dimensões;
- Variações;
Enviar produtos selecionados
Para enviar o cadastro de produtos do ERP para HUB2B, acesse em Menu → Cadastros → Produtos → Selecione os produtos que deseja enviar → Enviar para e-commerce.
A seguir, no campo Plataforma selecione sua loja HUB2B e marque a opção Atualizar estoque no e-commerce. Após isso, clique em Avançar.
Valide se o produto esta com as informações corretas para envio clique em Enviar.
Campos enviados:
- Descrição;
- Descrição complementar;
- Código;
- Preço;
- Preço promocional;
- GTIN da embalagem;
- NCM;
- Peso bruto;
- Estoque;
- Marca;
- Anexos;
- Dimensões;
- Variações;
Como mapear o cadastro dos produtos para integração do estoque
Para mapear o cadastro de um produto que já está no ERP e na HUB2B, você deverá acessar o produto na plataforma e copiar o ID do produto que está sendo exibido na URL da página acessada.
Feito esse processo na HUB2B, edite o produto no ERP e na aba Anúncios , insira um novo mapeamento.
No campo Identificador , insira o mesmo ID que você buscou na HUB2B.
Aplique e Salve as alterações.
Como visualizar os pedidos do e-commerce no ERP
A importação dos pedidos é realizada de forma automática. Para visualizar os pedidos, acesse sua conta no ERP em Menu → Vendas → Pedidos de venda.
Configuração na HUB2B
Como integrar o ERP com a plataforma HUB2B
Para ativar e configurar a integração da loja com o sistema ERP ERP, siga os passos a seguir:
Acesse o menu Integrações na HUB2B.
Clique em Adicionar Integração.
Busque o ERP na listagem de plataformas e clique em Conectar sistema.
Informe o token da API da conta no ERP ERP juntamente com o identificador do integrador.
Informações relacionadas
Cadastrando os produtos no ERP
Quando você opta por integrar o ERP à HUB2B , alguns dados são sincronizados entre as duas plataformas, evitando que você precise fazer o cadastro de produtos duas vezes.
É importante que você entenda quais campos serão sincronizados. Segue abaixo a lista com a especificação de cada campo:
| Código (SKU) | Este campo é OBRIGATÓRIO. Sem ele a exportação não funcionará. Ele é a chave de conexão do produto entre as duas plataformas, então preencha preferencialmente apenas com números. Ele será registrado na Dooca Commerce como ID_ERP, localizado nos detalhes da variação de um produto. |
|---|---|
| Descrição | O campo descrição no ERP equivale ao campo Descrição do produto no painel de controle da HUB2B. |
| Descrição complementar | O campo de descrição complementar no ERP equivale a descrição complementar do produto na HUB2B. |
| Preço | O campo preço venda no ERP equivale ao campo preço de venda no painel de controle da HUB2B. |
| Preço promocional | O campo preço promocional no ERP equivale ao campo preço comparativo no painel de controle da HUB2B. |
| Peso bruto | O peso bruto equivale ao campo peso no painel de controle da HUB2B. O peso líquido não será importado. |
| Largura | Preencha o campo largura no ERP com a largura exata do produto. Este campo será vinculado ao campo largura no painel HUB2B. |
| Altura | O campo altura no ERP equivale ao campo altura no painel de controle da HUB2B. |
| Comprimento | O campo comprimento no ERP equivale ao campo comprimento no painel de controle da HUB2B. |
| Estoque | O campo estoque no ERP corresponde ao estoque no painel de controle da HUB2B. |
| NCM | O campo NCM no ERP equivale ao campo NCM no painel de controle da HUB2B. |
| Garantia | O campo Garantia no ERP corresponde ao campo Garantia na plataforma. |
| GTIN da embalagem | O campo GTIN da embalagem no ERP corresponde ao campo GTIN na HUB2B. |
| Marca | O campo marca no ERP equivale ao marca no painel de controle da HUB2B. |
| Anexos | Os anexos cadastrados nos produtos do ERP (imagens, por exemplo) serão importados para a HUB2B. |
Saiba como cadastrar no ERP produtos Simples e Com variações.
Enviar estoque dos produtos no ERP ao e-commerce
Enviar quantidade em estoque em lote
Para realizar o envio da quantidade em estoque dos produtos ao e-commerce em lote, acesse em Menu → Cadastros → Produtos → Selecione os produtos → Mais Ações → Enviar estoque ao e-commerce.
Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio da quantidade em estoque dos produtos. Na lista que será exibida, selecione as integrações que deseja enviar a quantidade em estoque.
Após selecionar as integrações, defina se será enviado o saldo Físico ou Disponível dos produtos.
Clique no botão Selecionar. A seguir, serão exibidos os dados deste produto como: Identificador do anúncio, Descrição, Código (SKU) e Preço.
Para concluir o processo de envio, clique em Enviar.
Enviar quantidade em estoque de forma individual
Caso queira enviar somente a quantidade em estoque de um produto específico, acesse o Menu de contexto do produto e clique em Enviar estoque ao e-commerce.
No campo Plataforma você pode selecionar mais do que uma integração para o envio da quantidade em estoque do produto. Na lista que será exibida, selecione aquelas que deseja enviar a quantidade em estoque.
Após selecionar as integrações, defina se será enviado o saldo Físico ou Disponível dos produtos.
Clique no botão Selecionar. A seguir, serão exibidos os dados deste produto como: Identificador do anúncio, Descrição, Código (SKU) e Preço.
Para concluir o processo de envio, clique em Enviar.
Dicas e informações adicionais
- Caso seja necessário realizar a exclusão dos mapeamentos dos produtos com a sua plataforma, acesse Configurações → Aba E-commerce → Integrações e marque a integração desejada. Depois, clique em Mais ações → Excluir todos os anúncios no ERP. É importante mencionar que esta ação, depois de concluída, não poderá ser desfeita.
- Os campos sincronizados devem ser corrigidos/modificados apenas no ERP. Caso você corrija/modifique alguma destas informações no painel de controle da HUB2B, estas informações serão sobrescritas pelos dados cadastrados no ERP assim que rodar a próxima rotina de sincronização.
- Sempre que um pedido é importado, o cliente automaticamente é cadastrado em Cadastros → Clientes e fornecedores.
