Ajuda

Integração com VTEX

Esta página mostra:

O que é a VTEX?

A VTEX é uma das maiores plataformas globais de e-commerce e ecossistema de comércio digital do mercado, referência para marcas de médio e grande porte. Diferente de plataformas convencionais, a VTEX combina em uma única infraestrutura a gestão de e-commerce, arquitetura integrada unindo força de vendas com estoque e a capacidade de atuar tanto como integrador para vendas nos principais canais do mercado quanto transformar sua loja em um marketplace.

Com uma estrutura preparada para atender catálogos complexos de itens variáveis — organizando produtos por categorias e variações de SKUs —, a VTEX exige a máxima precisão no controle fiscal e logístico.

Por que utilizar a integração Maxiprod + VTEX?

A integração do ERP Maxiprod com a VTEX une a inteligência operacional do nosso ERP (gestão de estoque, produção, emissão fiscal e financeira) com a potência comercial de uma das plataformas mais robustas do mundo. Essa união permite a sincronização em tempo real de preços e saldos de estoque, com a entrada dos pedidos diretamente em seu fluxo operacional, promovendo alta eficiência para operações que não podem parar.

Como habilitar a integração com a VTEX?

A integração entre os sistemas é realizada por duas chaves geradas diretamente na VTEX, que são posteriormente informadas no ERP Maxiprod. Para consegui-las, siga os passos abaixo:

1) Na VTEX, acesse o usuário Admin da sua loja.

2) Vá para “Store > Aplicativos > Chaves de aplicação”.

3) Clique em “Gerenciar minhas chaves”.

4) Clique em “Gerar chave”.

5) Preencha os campos “Rótulo” e “Perfis”. Feito isso, clique em “Gerar”.

6) Serão geradas as chaves AppKey e AppToken, que devem ser copiadas para o MAXIPROD.

7) No ERP Maxiprod, clique no menu “Roda dentada > Configurações”.

8) Clique em “Configurações de vendas” e expanda a aba “Configurações de integração com e-commerce/Mercos”.

9) Ao final das configurações de vendas, preencha os campos abaixo da seguinte forma:

  • E-commerce: “Vtex”;
  • Chave 1: preencha com a chave “AppKey” da sua plataforma VTEX;
  • Chave 2: preencha com a chave “AppToken” da sua plataforma VTEX;
  • URL do web service e-commerce: preencha com o endereço URL do e-commerce. Ex: https://www.minhalojavirtual.com.br

Como importar pedidos de venda da VTEX para o Maxiprod?

1) Clique no menu “Vendas > Pedidos de venda”.

2) Clique no menu “Ações > Importar do e-commerce/Mercos”.

3) Na janela exibida, altere, se desejado, a data do campo “Alterado após”. O MAXIPROD só importará os pedidos de venda criados ou alterados após essa data.

4) Clique em “Importar”. Com isso, o sistema mostra o resultado da importação, podendo-se determinar os motivos pelos quais alguns pedidos não foram importados:

Quais dados dos pedidos são importados?

Na importação de pedido de venda da VTEX, são buscados e inseridos no sistema os seguintes dados:

    • Informações do pedido: número do pedido, valor total, valor de desconto, frete, observações e estado.
    • Informações do cliente: apelido/razão social/nome, CNPJ/CPF, inscrição estadual e telefone.
    • Informações do endereço de entrega: CEP, rua e dados gerais de localização.
    • Informações da transportadora: Apelido da transportadora.
    • Informações dos itens: produto, quantidade e valor unitário dos itens do pedido.

Como funciona a associação de cadastros entre VTEX e ERP Maxiprod?

A relação entre os itens do ERP Maxiprod e os produtos da VTEX possuem uma particularidade: No e-commerce, os itens são subdivididos em SKUs. Por exemplo:

  • Um determinado item “20 – Blusa Amarela”, na VTEX, possui as subdivisões de SKUs;
  • Com isso, os produtos variam, por exemplo, de tamanho. Cada variação recebe um código diferente;
  • Portanto, o item “20 – Blusa Amarela” nunca será comprado, mas sim seus SKUs (subdivisões).

Para que devidamente ocorra essa diferenciação e dinamicidade dos itens entre os sistemas, no ERP Maxiprod, os itens que são enviados para a VTEX precisam da relação de “Grupo” e “Item”:

  • Os “Grupos” do ERP Maxiprod são os “Produtos” da VTEX;
  • Os “Itens” do ERP Maxiprod são os SKUs da VTEX.

No exemplo acima, a “20 – Blusa Amarela” seria um grupo de itens e cada item cadastrado seria um SKU ao ser enviado à VTEX.

Como configurar itens cadastrados no ERP Maxiprod para envio à VTEX?

Para o item poder ser exportado para a VTEX, primeiramente precisa estar habilitado para ser integrado com e-commerce em seu cadastro. Para isso, siga o caminho abaixo:

1) Vá na tela “Itens > Itens” e abra o cadastro desejado.

2) Vá na aba “Vendas” e habilite a caixa de seleção de “Integrar com e-commerce/Mercos”.

Como exportar itens cadastrados no ERP Maxiprod para a VTEX?

1) Vá na tela “Itens > Itens”.

2) Agora, no menu “Ações”, clique em uma das opções destacadas na imagem abaixo. Pode-se exportar todos os itens cadastrados no ERP Maxiprod, ou apenas aqueles selecionados.

3) Na tela que abrir, clique em “Sim” caso deseje realizar o envio dos itens.

Como associar um item cadastrado na VTEX com um cadastrado no ERP Maxiprod?

Caso possua já itens existentes no VTEX e deseje vinculá-los com os cadastros que possui no ERP Maxiprod, pode utilizar o seguinte caminho:

1) Acesse o menu “Itens > Cadastros > Itens no e-commerce/Mercos”. Nessa tela, clique no botão “Novo”.

2) Preencha os campos abaixo da seguinte forma:

  • Item/grupo: selecione o item no ERP Maxiprod a ser relacionado (o grupo do item também será relacionado assim que informá-lo).
  • Minha empresa: selecione a empresa do envio à VTEX. De padrão, vem habilitada a empresa logada do usuário.
  • Id no e-commerce/Mercos: Id do “Produto” existente na VTEX.
  • Id da variação no e-commerce/Mercos: ID do SKU existente na VTEX.

Em caso de dúvidas, entre em contato com nosso time de suporte.

Veja também: