Como funciona a integração com a Vtex

A plataforma de e-commerce é a base de uma loja virtual. Ela oferece a estrutura para que o administrador defina seu catálogo de produtos, organize sua "vitrine" e receba pedidos.

Ao integrar sua loja VTEX com o Eccosys, é possível centralizar a operação do e-commerce, gerenciando cadastros, estoque, preços, pedidos de venda, informações de rastreio e faturamento em um só lugar.

Neste manual, você aprenderá:
  1. Fluxo da integração;
  2. Particularidades da VTEX;
  3. Pré-requisitos para configuração;
  4. Como configurar a integração Eccosys - VTEX;
  5. Como importar os depósitos cadastrados na VTEX;
  6. Como funciona a importação e envio de catálogo para a VTEX;
  7. Como funciona a atualização de preços dos produtos;
  8. Como funciona a atualização de estoque entre Eccosys e VTEX;
  9. Como importar pedidos da VTEX.

Fluxo da integração



Importamos para o Eccosys
Enviamos para a plataforma
Árvore de categorias
Produtos
Atributos
✔*
Imagens

✔*
Marcas
✔*
Depósitos


(*) Enviados apenas em conjunto, quando informados no cadastro do produto. "Atributos" e "Marcas" serão enviados nos produtos desde que estas informações tenham sidos previamente cadastradas e importadas da plataforma para o Eccosys. 

Particularidades da integração com a VTEX

  1. É possível mapear campos, caso seja necessário para a operação;  
  2. Atualiza status entregue através de tarefa própria, caso a transportadora envia o status;
  3. Atualiza somente preços através de tarefa própria;
  4. Não importa pedidos de venda, caso o transportador não esteja corretamente mapeado;
  5. Tela para importação manual de pedidos (auditoria);
  6. O envio de imagens em novos produtos é obrigatório;
  7. Enviamos e importamos apenas um departamento com suas respectivas sub/categorias, por produto.

Pré-requisitos para configuração

  1. URL da Loja; 
  2. AppKey e Token gerados na VTEX.

Como configurar a integração Eccosys - VTEX

Caso deseje migrar sua operação para uma outra plataforma ou serviço já integrado ao Eccosys, solicitamos que notifique o time de suporte com antecedência mínima de 30 dias. Desta forma, poderemos fornecer as orientações necessárias e avaliar quaisquer ajustes relacionados à migração.

Em Configurações > Multiplataforma > Multiplataforma, clique em Incluir.
Na tela, preencha o Nome da loja, Domínio e o campo Plataforma (VTEX ou VTEX REST).



Aba Conexão

Caso sua integração com a VTEX seja na versão VTEX IO ou VTEX REST, preencha os seguintes campos:
  1. API Key
  2. API Token

Caso utilize uma versão mais antiga da integração, os campos disponíveis são:
  1. REST - Key (appkey)
  2. REST - Token (token)
  3. REST - URL Base (http://SEUDOMINIO.vtexcommercestable.com.br/api)
  4. SOAP - Usuário (appkey)
  5. SOAP - Senha (token)
  6. SOAP - WSDL URL (http://webservice-SEUDOMINIO.vtexcommerce.com.br/AdminWebService/Service.svc?singleWsdl)



Aba parâmetros da plataforma

  1. Enviar imagens: Defini se imagens vinculadas aos cadastros dos produtos no Eccosys serão enviadas a plataforma;
  2. ID da Loja: caso você utilize multilojas pela VTEX, será necessário informar o código da loja;
  3. Nome da Lojaapenas para referência;
  4. ID do estoque na VTEXcódigo do depósito padrão da VTEX;
  5. Regra de mapeamento de depósitoscaso utilize mais de um depósito no Eccosys, você pode consolidar todos os saldos e enviar tudo para o depósito padrão da VTEX; ou Mapear de 1 para 1, caso você tenha os mesmos depósitos na VTEX e no Eccosys;
  6. Importar pedidos de vendas por situaçãodefine se o Eccosys irá importar apenas pedidos pagos ou não;
  7. Código da Política Comercial InStore:  Deve-se informar os códigos dos marketplace cadastrados na VTEX para agrupar configurações de catálogo, preços, promoções, inventário, logística, segmentação de clientes e pagamentos para diferentes canais de venda. Canais de venda podem incluir marketplaces, e-commerce próprio, lojas físicas, ou lojas B2B;
  8. Seller namesÉ possível definir que apenas pedidos de alguns sellers (Vendedores) vão ser importados no Eccosys;
  9. Pedidos InStore:  Deve-se identificar se deseja importar todos os pedidos ou apenas os finalizados (Faturado);
  10. Atualizar status de pedido na VTEX apósdefine quando o Eccosys deve enviar as informações de faturamento para a VTEX;
  11. Dia de Pagamento Walmart: Deve-se preencher com o dia sem zeros a esquerda, exemplo 5;
  12. Regra Walmart: Deve-se selecionar o dia vai ser útil ou corrido;
  13. Dia de pagamento Extra: Deve-se preencher com o dia sem zeros a esquerda, exemplo 5;
  14. Regra Extra: Deve-se selecionar o dia vai ser útil ou corrido;
  15. Incluir prefixo no número da fatura: define se o Eccosys deve enviar alguma máscara ou somente números;
  16. Origem padrão de produtos importados da loja: ao importar um pedido de venda onde o produto não está cadastrado no ERP, define qual é a origem desse produto;
  17. Qual integração de preços deve ser utilizada?: Define qual das políticas de preço da VTEX devemos atualizar ao enviar preços de venda;
  18. Importar anexos de itens dos pedidos no campo Observação Internautilizado para importar anexos da VTEX para personalização de produtos;
  19. URL de imagem padrão para os SKUS: caso esse campo esteja preenchido e no cadastro do produto não tenha imagem cadastrada, enviaremos a imagem desta URL para a VTEX;
  20. Utilizar nome da imagem inserida no cadastro de produtosvocê pode usar SEO no nome das imagens dos produtos, e usando esse campo como sim, enviaremos esse nome para a plataforma;
  21. Utilizar rastreio da venda se NF não possuir: Envia código de rastreio do pedido de venda caso a Nota fiscal não tenha o campo código de rastreio preenchido;
  22. Importação de Produtos - Apenas Ativos: Define se apenas pedidos com situação ativa na VTEX serão importados ao Eccosys;
  23. Importar embalagens como itens separados na venda: Inclui embalagem como item nos pedidos de venda importados;
  24. Data de corte para baixa de pedidos somente para Feed de pedidos: Deve se preencher este campo com a data inicial de importação de pedidos, campo deve ser preenchido com dias meses e ano, exemplo 19/12/2022, o mesmo precisa ser validado na plataforma;
  25. Lista de preço da Plataforma: Uma lista de preço deve selecionada caso os valores a serem enviadas para a plataforma sejam diferentes do preço da tela de cadastro;
  26. Tipo de estoque a enviar o saldo: Recomendamos sempre enviar o saldo disponível;
  27. Canal de Venda PadrãoIdentificação padrão para o canal de venda, caso não exista mapeamento de marketplaces no ERP.
Atualmente as informações Código da Política Comercial InStore, Pedidos InStore, Dia de pagamento Walmart, Regra Walmart, Dia de pagamento Extra e Regra Extra não são enviadas/sincronizadas com a plataforma.

Aba Configurações Gerais

  1. Tipo de estoque a enviar o saldo: Deve-se selecionar qual tipo de estoque deseja enviara para a plataforma, podendo ser o físico ou disponível;
  2. Canal de Venda Padrão:  Campo vem preenchido com canal de venda padrão, sem mais possibilidades de seleção;

Como importar os depósitos cadastrados na VTEX

Para que seja possível atualizar os produtos, é necessário que pelo menos um depósito seja cadastrado na VTEX e importado via tarefa agendada no Eccosys. Esta tarefa agendada deve ser habilitada em Configurações > Outros > Tarefas agendadas, tarefa "Instalador Multiplataforma   Apenas Depósitos".

Atenção!
Os depósitos são descritos pela VTEX como Doca.

Como funciona a importação e envio de catálogo para a VTEX

A importação de catálogo cadastrado na plataforma acontece através de tarefas agendadas e estão identificadas no Eccosys com "Instalador multiplataforma" ou "Instalador Multiplataforma apenas catálogo".
O envio de produtos do Eccosys para a VTEX e pode ser feito individualmente em Configurações > Plataforma > Produtos, ou de forma massiva por nossas tarefas agendadas, disponíveis em Configurações > Outros > tarefas agendadas.

Solicite auxílio do nosso time de suporte para auxiliar na identificação e configurações das tarefas agendadas!

Como funciona a atualização de preços dos produtos

Produtos que passaram por atualização de preços podem ser atualizados automaticamente por nossas tarefas agendadas, disponível em Configurações > Outros > Tarefas agendadas, tarefa de nome "Atualiza preço"

Como funciona a atualização de estoque entre Eccosys e VTEX

O Eccosys permite a identificação de estoque por meio de duas situações, são elas o Estoque físico e disponível. Por padrão as atualizações de estoque consideram o estoque disponível para atualização na plataforma que nada mais é que a subtração do físico com a reserva em pedidos.
A reserva de estoque acontece no Eccosys sempre que um pedido é criado em seu ambiente independente do formato de criação, ou seja, sempre que houver um pedido, uma tarefa agendada "Atualização de Estoque" vai atualizar a quantidade do produto disponível para venda, disponível em Configurações > Outros > tarefas agendadas.

A VTEX permite que a reserva aconteça na própria plataforma, caso esta configuração seja implementada o nosso time de suporte deve ser acionado para que a reserva não seja duplicada e os seus produtos não fiquem indisponíveis para venda!

Como importar pedidos da VTEX

A importação de pedidos pode acontecer por meio de tarefa agendada importando no Eccosys todos os pedidos disponibilizados por sua plataforma de forma massiva e automática, assim como de forma individual em Configurações > Outros > Tarefas agendadas, tarefa "Importar Pedidos de Venda". Esta integração também possui uma tela própria para seleção e importação manual de pedidos. Você pode acessá-la em Configurações > Plataforma > Pedidos de venda.

Para que a importação aconteça, é necessário configurar as transportadoras na plataforma e posteriormente no Eccosys em Cadastros > Outros contatos, seu vinculo também precisa ser feito em Configurações > Cadastros > Vínculos de transportadoras. Para mais detalhes sobre a criação e vinculo de transportadoras, clique aqui.

Conclusão

Após realizar e revisar as configurações da plataforma, recomendamos que sejam realizados testes de envio / baixa de produtos e pedidos.

Em caso de dúvidas, nosstime de suporte está à disposição para auxiliar.

Atualizado em 23/04/2024
Este artigo foi útil?  
Agradecemos sua avaliação.