Integração com a plataforma Vnda

A plataforma de e-commerce é a base da operação de uma loja virtual. É nela que se define o catálogo de produtos, organiza-se a vitrine e se realiza a gestão dos pedidos recebidos.

Ao integrar a VNDA com o Eccosys, sua operação se torna mais fluida e centralizada. A integração permite que o ERP assuma o controle de cadastros, estoque, preços, pedidos, rastreios e faturamento, eliminando a necessidade de ajustes manuais entre sistemas e reduzindo erros operacionais.

Essa sincronização garante maior agilidade no dia a dia, oferecendo uma experiência mais confiável tanto para a equipe de gestão quanto para o consumidor final.

Neste manual, você aprenderá:

  • Como funciona o fluxo da integração entre VNDA e Eccosys.

  • Quais são as particularidades da plataforma VNDA.

  • Quais os pré-requisitos para realizar a configuração.

  • Como configurar a integração passo a passo.

  • Como funciona a importação de depósito.

  • Como importar e enviar o catálogo de produtos.

  • Como é feita a atualização dos pedidos de venda.

  • Como funciona a importação de pedidos com múltiplos centros de distribuição (Multi CD).

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 Vnda

  • Os atributos são importados junto aos SKUs e precisam ser mapeados para novos envios do Eccosys para a Vnda.

  • Marcas e categorias são tags na plataforma.

  • Caso o transportador não esteja corretamente mapeado, os pedidos de venda não serão importados.

  • A plataforma tem fulfillment, então 1 pedido pode ter vários pacotes que serão tratados como pedidos individuais no Eccosys.


Pré-requisitos


  • Domínio da sua Loja*

  • Token*

(*) disponibilizados pela Vnda.


⚙️ Como configurar a integração Eccosys - VNDA

Para ativar a comunicação entre o Eccosys e a plataforma VNDA, será necessário preencher no sistema Eccosys corretamente os dados de acesso fornecidos pela própria VNDA.

Acesse o menu:

  1. Configurações > Integrações > Plataformas.

  2. Clique no botão Incluir Plataforma.

  3. O sistema exibirá uma lista com todas as plataformas disponíveis para integração.

  4. Localize e clique sobre VNDA para iniciar a configuração.



Preenchendo os dados de acesso

Na tela de configuração da integração com a VNDA, preencha os campos da aba Acesso com as informações abaixo:

  • Nome:
     Defina um nome interno para identificar a integração. Exemplo sugerido: Integração VNDA.

  • Status da Integração:
     Deixe como Ativa para que o Eccosys possa iniciar as sincronizações com a plataforma.

Dados de Acesso

  • URL da Loja:
     Informe o endereço da sua loja na VNDA.

  • Ambiente:
     Selecione entre os ambientes disponíveis:

    • Produção – loja em funcionamento real (padrão).

    • Homologação – para testes com dados fictícios, se aplicável.

  • Domínio da sua Loja:
     Informe o domínio principal usado na sua loja virtual.

  • Token:
     Cole o token de autenticação gerado na VNDA.

💡 Importante: Certifique-se de preencher todos os campos corretamente antes de continuar. Dados incorretos podem impedir o funcionamento da integração.

Testar conexão

Após preencher os dados:

  1. Clique no botão Testar conexão para validar se as credenciais estão corretas e o Eccosys consegue se comunicar com a loja.

⚠️ Caso o teste de conexão retorne erro, revise o token e os domínios preenchidos. Se o problema persistir, entre em contato com o suporte da VNDA ou da Eccosys para validação.

⚙️ Aba Configurações

Após concluir o preenchimento dos dados de acesso à plataforma de e-commerce, o sistema Eccosys disponibiliza uma estrutura padronizada de abas para gerenciamento da integração.

Entre elas, a aba Configurações é uma das mais importantes, pois centraliza os parâmetros que controlam o comportamento da sincronização entre o ERP e a plataforma VNDA, tanto em relação aos produtos quanto ao estoque e aos pedidos de venda.

Abaixo, explicamos cada campo disponível nessa aba:

Produto

  • Importação de Produtos – Apenas Ativos
     Define se o Eccosys deve importar somente os produtos marcados como ativos na plataforma VNDA.

    • Sim: apenas produtos ativos serão sincronizados.

    • Não: todos os produtos serão importados, independentemente do status.

  • Origem padrão de produtos importados da loja
     Define a origem fiscal padrão (nacional/importado) a ser atribuída aos produtos que vierem da VNDA. Útil para emissão de notas fiscais.

  • Enviar imagens
     Determina se as imagens dos produtos cadastradas no Eccosys devem ser enviadas para a plataforma.

    • Sim: as imagens do ERP serão sincronizadas com a VNDA.

    • Não: nenhuma imagem será enviada.

  • Controla exclusão de imagens
     Se ativado (Sim), o Eccosys irá excluir, na VNDA, as imagens que não estiverem mais no cadastro do produto no ERP.

  • Lista de preço da Plataforma
     Permite vincular uma lista de preço específica do Eccosys à integração, para envio de valores personalizados.

    • Nenhuma: utiliza os preços padrão dos produtos.

  • Enviar tempo de produção ao sincronizar produtos
     Se marcado como Sim, o campo de tempo de produção (crossdocking) será enviado junto com o produto.

  • Importar juros/taxas na venda
     Define se valores de acréscimos financeiros (ex.: juros, taxas) devem ser considerados ao importar pedidos da VNDA.

Estoque

  • Regra de Envio de Estoque
     Define de que forma o estoque será enviado à plataforma VNDA:

    • Enviar Estoque do Depósito Padrão da Plataforma
       Envia apenas o saldo de estoque do depósito definido como padrão no cadastro da plataforma.

    • Enviar Estoque Consolidado de Todos os Depósitos
       Soma o estoque disponível em todos os depósitos cadastrados no ERP e envia o total para a VNDA.

    • Enviar Estoque de Depósitos Mapeados que Consideram Saldo
       Permite definir quais depósitos devem ser considerados, conforme os mapeamentos cadastrados na integração.

O Eccosys trabalha com duas formas de identificação de estoque: o estoque físico e o estoque disponível. Por padrão, as atualizações de estoque na plataforma são baseadas no estoque disponível, que é calculado pela diferença entre o estoque físico e as reservas feitas por pedidos.


A reserva de estoque no Eccosys ocorre sempre que um pedido é criado, independentemente de como ele é gerado. Ou seja, toda vez que um pedido é registrado, uma tarefa agendada chamada "Atualização de Estoque" é acionada, ajustando a quantidade do produto disponível para venda de acordo com as reservas.


Pedidos de Venda

  • Enviar imagens do produto pai nas variações
     Define se a imagem do produto principal (pai) será replicada nas variações (filhas).

  • Data de corte mínima para baixa de pedidos
     Permite definir uma data a partir da qual os pedidos passarão a ser sincronizados.

  • Importar pedidos de vendas por situação
     Define qual status os pedidos precisam ter na VNDA para serem importados pelo Eccosys.

    • Exemplo: Pagos — apenas pedidos já pagos serão integrados.

  • Regra de envio de status para a Plataforma
     Define quando o Eccosys deve comunicar à VNDA que o pedido foi processado.

    • Exemplo: Nota Fiscal Autorizada com Pedido Atendido — envia status somente após a emissão da NF-e e que o pedido permaneça com situação atendido.

Com as configurações ajustadas conforme o fluxo da sua operação, clique em Salvar para aplicar as alterações.

💡 Essas regras impactam diretamente na qualidade e na confiabilidade da integração. Revise com atenção e, se tiver dúvidas, consulte o suporte antes de ativar a sincronização.

Aba Automações

A aba Automações permite ativar ou desativar tarefas automáticas específicas da integração entre o Eccosys e a plataforma VNDA. Essa flexibilidade é essencial para personalizar o comportamento da sincronização, de acordo com as necessidades operacionais de cada loja.

As automações ativadas serão executadas de forma recorrente, em intervalos definidos no menu Configurações > Outros > Tarefas Agendadas do sistema.

A seguir, veja a descrição de cada opção disponível:

Produto

  • Criar/Atualizar Produtos
     Permite que o Eccosys crie ou atualize automaticamente os produtos na plataforma VNDA, com base nos dados do ERP.

  • Sincronizar produtos
     Habilita a sincronização periódica do catálogo entre os sistemas.

  • Importar produtos
     Autoriza o Eccosys a buscar os produtos cadastrados na VNDA e importar para a base do ERP.

  • Definir produtos como estoque alterado
     Marca os produtos para que sejam considerados na rotina de envio de estoque.

  • Definir produtos como alterados
     Força os produtos que foram atualizados no Eccosys (ex: alteração de nome, descrição, imagem, marca, etc.) a serem incluídos na fila de sincronização.

  • Instalador Multiplataforma – Apenas catálogo/categorias/marcas
     Importa seletivamente as estruturas da plataforma, ideal para implantações controladas:

    • Catálogo: apenas produtos.

    • Categorias: apenas as categorias.

    • Marcas: apenas as marcas.

  • Instalador Multiplataforma
     Executa a importação inicial completa da plataforma (catálogo, categorias, marcas e depósitos).

  • Sincronizar produtos novos
     Inclui na rotina apenas produtos que ainda não foram enviados à plataforma.

  • Sincronizar produtos inativos
     Habilita o envio de produtos inativos, atualizando a situação na plataforma.

  • Atualização de Preços
     Permite que o Eccosys atualize automaticamente os preços dos produtos na VNDA.

Estoque

  • Instalador Multiplataforma – Apenas depósitos
     Importa apenas os depósitos (centros de distribuição) cadastrados na plataforma.

  • Enviar estoque para a plataforma
     Ativa o envio automático de saldos de estoque conforme as regras configuradas na aba anterior.

Vendas

  • Enviar informação de entrega para Loja Virtual
     Habilita o envio de dados de rastreamento e status de entrega para a VNDA.

  • Sincronizar status dos pedidos de venda
     Permite que o Eccosys atualize o status dos pedidos com base no processamento interno (ex: faturado, enviado).

  • Consultar status de pedidos com pagamento pendente
     Importa atualizações de pedidos que ainda não foram pagos.

  • Importar pedidos de venda
     Habilita a entrada automática de pedidos recebidos na VNDA conforme as regras configuradas na aba anterior.

  • Cancelar pedidos
     Permite que cancelamentos feitos no ERP sejam sincronizados com a plataforma.

Como funciona a importação de depósito

Para que a sincronização de produtos funcione corretamente entre o Eccosys e a VNDA, é necessário que ao menos um depósito esteja cadastrado na plataforma e importado para o ERP.

Essa estrutura é fundamental, pois é a partir do vínculo com o depósito que o sistema controla estoque, disponibilidade e expedição dos produtos.

Recomendações de uso:

  • Sempre que um novo depósito for criado na VNDA, é importante habilitar a automação de importação de depósitos na aba Automações da integração.

  • Após a execução da tarefa e o mapeamento correto do depósito no Eccosys, a automação pode ser desabilitada novamente, caso deseje evitar importações repetidas.


A integração entre Eccosys e VNDA permite tanto a importação quanto a exportação do catálogo de produtos, mantendo as informações atualizadas e consistentes entre os dois sistemas.

Essas ações garantem que dados como nome, descrição, preço, imagens, categorias e estoque sejam sincronizados corretamente, seja para enviar do Eccosys para a VNDA ou para importar da VNDA para o ERP.

Ambas as rotinas podem ser executadas manualmente ou por meio das automações da integração.

Importação de pedidos

Para que os pedidos de venda sejam importados corretamente da plataforma VNDA para o Eccosys, é necessário que as transportadoras estejam previamente mapeadas.

Para instruções completas sobre criação e vínculo de transportadoras, consulte:

Manual de Cadastro e Vínculo de Transportadoras

Após essas configurações, os pedidos serão importados automaticamente por meio da automação disponível na aba Automações da integração. O Eccosys buscará periodicamente novos pedidos na plataforma, conforme o agendamento definido em Configurações > Outros > Tarefas Agendadas.

Também é possível realizar a importação manual, caso precise trazer pedidos pontualmente ou em situações específicas de contingência.

Para mais detalhes sobre como funciona o processo de importação de pedidos, acesse:
Importação de Pedidos de Venda nas Integrações de Plataforma

Como funciona a importação de pedidos com Multi CD

Para entender o fluxo de pedidos e atualização de estoque entre Eccosys e Vnda, considere o seguinte exemplo:

  1. Um cliente do estado de São Paulo efetua a compra de 5 camisas sociais e 2 calças. Sua loja possui saldo disponível para estes produtos, mas eles se encontram em depósitos diferentes.

  2. A compra do cliente será confirmada, porém cada produto vai entregue por uma transportadora, em datas distintas.

  3. Ao importar o pedido, o Eccosys irá identificar que o pedido possui dois centros de distribuição. Neste caso serão baixados dois pedidos para a mesma ordem de compra.

  4. As reservas dos produtos no Eccosys, assim como sua na plataforma, serão sempre para o depósito informado pela Vnda. Neste caso, as 5 camisas para o CD SP capital e as 2 calças para o CD Campinas.

  5. O Eccosys irá enviar todas as movimentações sobre a compra do cliente, porém na plataforma elas ficarão como "Separados parcialmente" e "Enviado parcialmente", até conclusão do fluxo para todos os produtos.

⚠️Atenção: o cancelamento de um pedido parcial no Eccosys irá cancelar todo o pedido na plataforma!

Envio de rastreamento para a plataforma

O envio das informações de rastreamento para a plataforma VNDA acontece de forma automática durante a sincronização do status dos pedidos, conforme configurado na aba Automações da integração.

Quando a automação “Sincronizar status dos pedidos de venda” está ativa, o Eccosys atualiza o status do pedido na plataforma com base no progresso da operação dentro do ERP.

Se houver um código de rastreamento retornado pela logística integrada e uma URL de rastreio configurada no vínculo da transportadora, essas informações também serão enviadas para a plataforma no momento da atualização de status.

Dessa forma, o consumidor final poderá acompanhar o andamento do pedido diretamente pela loja, com base nos dados transmitidos automaticamente pelo Eccosys.

Conclusão

A integração entre Eccosys e VNDA permite unificar o controle de catálogo, pedidos e logística em um único sistema, garantindo eficiência e consistência em toda a operação.

Com os parâmetros corretamente configurados, sua loja virtual passa a operar de forma automatizada, reduzindo falhas manuais e otimizando o tempo da equipe.

Para garantir o melhor aproveitamento da integração, mantenha os vínculos atualizados e acompanhe regularmente as automações ativas.

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


Atualizado em 11/07/2025
Este artigo foi útil?  
Agradecemos sua avaliação.

Sumário