Integração ERP com a Hoop
Integração desenvolvida pela Hoop, através da nossa API de integração.
Recursos disponíveis
| Receber pedidos Solução desenvolvida pela Hoop | ✔ |
| Receber produtos | x |
| Enviar produtos | ✔ |
| Enviar estoque | ✔ |
| Enviar preços | ✔ |
| Sincronizar situação | x |
Configuração no ERP
Configurar integração com a Hoop
Inicie a configuração, acessando menu → início → integrações.
Observações:
Caso já possua integrações configuradas em sua conta, elas serão exibidas e indicadas da seguinte forma:
- Ativa: Indica que a integração foi realizada com sucesso e encontra-se pronta para uso.
- Inativa: Indica a inatividade desta loja no ERP, ou seja, a loja não estará disponível para sincronização de pedidos, produtos e demais ações pertinentes.
- Não conectada: Indica que a configuração ainda não foi realizada.
Somente as integrações Ativas serão exibidas para uso nas sincronizações, importações e demais ações no ERP.
Clique em adicionar Integração, busque por Hoop e clique em instalar.
Na aba Conexão, campo nome informe o nome da integração no ERP.
Defina os seguintes campos:
Produtos > Fluxo de Produtos
| Enviar dias para preparação ao sincronizar |
Habilite a opção para enviar a informação da quantidade de dias necessários para o envio de produtos para a plataforma. * Para preencher este campo, acesse o menu → cadastro → produto → editar, na aba dados gerais, na seção estoque clique em dias para preparação. Lembramos que esse campo pode ser alimentado por planilha e será inserido também nas APIs de cálculos dos fretes. |
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:
| Atualizar estoque na loja virtual a partir do ERP | Selecione umas 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: 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. |
Na aba Produtos > Preços , defina qual será a regra de preços para a integração, tanto para importação, quanto para envio de produtos ao e-commerce.
- Preço fixo : conforme o preço do produto, o anúncio pode receber um valor fixo de preço de venda, levando em consideração acréscimos e descontos aplicados individualmente;
- Conforme regras de preço : trata-se de todas as regras do marketplace no que diz respeito ao percentual de comissão, adicional de frete para produtos com preço mínimo e/ou por faixa de peso cubado dos produtos e fórmula de cálculo para aplicar os valores adicionais;
- Conforme lista de preços : para uso de listas de preços dos produtos, específicas para o e-commerce ou marketplace.
Na aba 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 preencha os campos URL do notificações de estoque , URL para envio de produtos e URL para envio dos preços com as URLs utilizadas para webhook de sua loja virtual.
Observação:
Estes links são gerados diretamente através da configuração na Hoop. Saiba mais através da ajuda Como integrar o ERP na Hoop.
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 instalar o aplicativo do ERP na CartX, conforme orientação Como integrar o ERP na Hoop.
Como enviar produtos do ERP para Hoop
Enviar apenas um produto
Para enviar apenas um produto para Hoop, 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 Hoop 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;
- Unidade;
- GTIN;
- GTIN embalagem;
- Origem;
- NCM;
- Preço;
- Preço de custo;
- Peso bruto;
- Peso líquido;
- Estoque;
- Imagens;
- CEST;
- Unidades por caixa;
- Código no fabricante;
- Variações.
Enviar produtos selecionados
Para enviar o cadastro de produtos do ERP para Hoop, acesse em Menu → Cadastros → Produtos → Selecione os produtos que deseja enviar → Enviar para e-commerce.
A seguir, no campo Plataforma selecione sua loja Hoop 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;
- Unidade;
- GTIN;
- GTIN embalagem;
- Origem;
- NCM;
- Preço;
- Preço de custo;
- Peso bruto;
- Peso líquido;
- Estoque;
- Imagens;
- CEST;
- Unidades por caixa;
- Código no fabricante;
- Variações.
Como mapear o cadastro dos produtos para integração do estoque
Para que o mapeamento dos itens entre o ERP e a Hoop ocorra, é necessário sincronizar o produto desejado a partir do ERP. Saiba mais como enviar produtos para a plataforma através da ajuda Como enviar produtos do ERP para Hoop.
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 Hoop
Como integrar o ERP com a plataforma Hoop
Para ativar e configurar a integração da loja com o sistema ERP, acesse o painel da Hoop e clique sobre o ícone de sua loja.
Nas configurações de sua loja, selecione a integração do ERP e preencha os campos API Key com o Token gerado anteriormente e, também, o Identificador do integrador.
Caso você ainda não tenha gerado essas informações, acesse a ajuda Como configurar a Hopp no ERP.
Após realizar as demais configurações, clique em Salvar. Ao concluir esse processo, as URL para uso dos webhooks serão geradas e poderão ser configuradas no ERP.
Informações relacionadas
Cadastrando os produtos no ERP
Quando você opta por integrar o ERP à Hoop , 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. |
|---|---|
| Descrição | O campo descrição no ERP equivale ao campo Título no painel de controle da Hoop. Esse campo é obrigatório. |
| Preço | O campo preço venda no ERP equivale ao campo preço de venda no painel de controle da Hoop. |
| Preço de custo | O campo preço de custo no ERP equivale ao campo preço de custo no painel de controle da Hoop. |
| Peso bruto | O peso bruto equivale ao campo peso bruto no painel de controle da Hoop. |
| Peso líquido | O peso líquido equivale ao campo peso líquido no painel de controle da Hoop. |
| Unidade | A unidade do produto no ERP será sincronizada com a unidade do produto na Hoop. |
| Unidades por caixa | A quantidade de unidades por caixa do produto no ERP será sincronizada com o respectivo campo na Hoop. |
| Estoque | O campo estoque no ERP corresponde ao estoque no painel de controle da Hoop. |
| Descrição complementar | Esse campo equivale a descrição do produto no painel de controle da Hoop. |
| Imagens | As imagens dos produtos no ERP serão sincronizadas com as imagens dos produtos na Hoop. |
| NCM | A classificação fiscal do item na ERP será sincronizada com o NCM do produto na Hoop. |
| CEST | O código CEST do item no ERP será sincronizado com a Hoop. |
| Origem | A origem do produto no ERP será sincronizada com a origem do item na Hoop. |
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.
Enviar preço dos produtos no ERP ao e-commerce
Enviar preços em lote
Para realizar o envio dos preços dos produtos ao e-commerce em lote, acesse em Menu → Cadastros → Produtos → Selecione os produtos → Mais Ações → Enviar preços para o e-commerce.
Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio dos preços. Na lista que será exibida, selecione aquelas que deseja enviar os preços desses produtos.
Após definir para qual ou quais integrações receberão o envio dos preços, clique em Selecionar.
Para concluir o processo de envio, clique em Enviar.
Enviar preço de forma individual
Caso queira enviar somente o preço de um produto em específico, acesse o Menu de contexto do produto e clique em Enviar preços para o e-commerce.
Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio dos preços. Na lista que será exibida, selecione aquelas que deseja enviar os preços desses produtos.
Após definir para qual ou quais integrações receberão o envio dos preços, clique em Selecionar.
Para concluir o processo de envio, clique em Enviar.
Reajustar preço dos produtos no ERP e atualizar no e-commerce
Para realizar os ajustes nos preços dos produtos cadastrados no ERP e após atualizar na loja virtual, acesse em Cadastros → Produtos → Mais ações → Reajustar preço dos produtos.
Utilize as opções de Filtros caso deseje, ou clique direto em Listar produtos.
Após isso, será exibido a lista dos produtos, clique em Informar reajuste.
Selecione os produtos que deseja atualizar os preços, utilize uma das opções disponíveis para atualizar os preços, por reajuste de Percentual , ou adicione o novo preço em cada produto na coluna Novo preço , marque a opção Atualizar preços no e-commerce e selecione a integração correspondente, por fim clique em Salvar.
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 Hoop, 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.
