Integração ERP com a Hipervinho
Integração desenvolvida pela Hipervinho, através da nossa API de integração.
Recursos disponíveis
| Receber pedidos | x |
| Receber produtos | x |
| Enviar produtos | ✔ |
| Enviar estoque | ✔ |
| Enviar preços | x |
| Sincronizar situação | x |
Configuração no ERP
Configurar integração com a Hipervinho
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 Hipervinho e clique em Instalar.
Na aba Conexão, no campo Nome informe o nome da sua loja.
Defina os seguintes campos abaixo:
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 → aba dados gerais → seção estoque → 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 > 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. |
Configurações adicionais
| Intermediador |
Selecione o intermediador de suas operações. Maiores informações em Como utilizar e configurar os intermediadores de operações. * A informação de intermediador da transação é obrigatória para emissão de NFe. |
|---|
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 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. |
| 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:
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 gestão de 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. Ao definir essa regra, siga a configuração de precificação de anúncios com base nas regras das plataformas de e-commerce e marketplaces.
- Conforme lista de preços: utiliza de listas de preços dos produtos, específicas para o e-commerce ou marketplace. Ao definir essa regra, no campo lista de preços utilizada nos produtos, selecione a lista de preços a ser considerada na importação de pedidos do e-commerce. Saiba como configurar em listas de preços.
Na aba 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 Hipervinho.
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 Hipervinho, conforme orientação Como integrar o ERP com a plataforma Hipervinho.
Como enviar produtos do ERP para Hipervinho
Enviar apenas um produto
Para enviar apenas um produto para Hipervinho, 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 Hipervinho 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
- Código
- Preço
- Estoque
Enviar produtos selecionados
Para enviar o cadastro de produtos do ERP para Hipervinho, acesse em Menu → Cadastros → Produtos → Selecione os produtos que deseja enviar → Enviar para e-commerce.
A seguir, no campo Plataforma selecione sua loja Hipervinho 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
- Código
- Preço
- Estoque
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 Hipervinho, 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 Hipervinho, edite o produto no ERP e na aba Anúncios , insira um novo mapeamento.
No campo Identificador , insira o mesmo ID que você buscou da Hipervinho.
Aplique e Salve as alterações.
Configuração na Hipervinho
Como integrar o ERP com a plataforma Hipervinho
Para ativar e configurar a integração da loja com o sistema ERP, encaminhe o Token e o Identificador do integrador para que o suporte da Hipervinho possa dar sequência na integração. Saiba mais através da ajuda Gerar Token Api.
Informações relacionadas
Cadastrando os produtos no ERP
Quando você opta por integrar o ERP à Hipervinho , 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 ERPequivale ao campo Título do produto no painel de controle da Hipervinho. |
| Preço | O campo preço venda no ERP equivale ao campo preço de venda no painel de controle da Hipervinho. |
| Estoque | O campo estoque no ERP corresponde ao estoque no painel de controle da Hipervinho. |
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 Hipervinho, estas informações serão sobrescritas pelos dados cadastrados no ERP assim que rodar a próxima rotina de sincronização.
- Os pedidos da Hipervinho não são exportados para o ERP.
