Integração com a Nuvemshop

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 a Nuvemshop com o Eccosys, é possível centralizar a operação da loja, gerenciando cadastros, estoque, preços, pedidos de venda, informações de rastreio e faturamento em um só lugar.


Neste manual, você aprenderá:


  • Fluxo da integração;

  • Particularidades da Nuvemshop;

  • Pré-requisitos para configuração;

  • Como instalar o aplicativo do Eccosys na loja da Nuvemshop;

  • Como configurar a integração Eccosys - Nuvemshop;

  • Como mapear atributos da ficha técnica;

  • Como funciona a atualização de estoque, produtos e pedidos;

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

  • Como enviar código de rastreio para Nuvemshop.

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.


Particularidades da Nuvemshop

  • Os atributos da Nuvemshop não possuem referência quando importads.

Pré-requisitos

  • Domínio;

  • Access token;

  • User ID.

Note que estas informações podem ser obtidas automaticamente a partir da Loja de Aplicativos da Nuvemshop (ver próxima seção).

Como instalar o aplicativo do Eccosys na loja da Nuvemshop

Para configurar a integração entre Eccosys e Nuvemshop, será necessário acessar o painel em sua plataforma.


No canto direito da tela, procure pelo módulo "Meus aplicativos" e clique no aplicativo "ERP Eccosys". Ao acessá-lo, clique no botão "Instalar aplicativo".





Você será redirecionado a uma página de autenticação no Eccosys, onde deverá preencher os seguintes campos:

  • Apelido da empresa: Nome da sua conta no Eccosys, sem espaços, acentos e caracteres especiais. Usado no link/URL de acesso ao Eccosys (ex.: minhalojavirtual).

  • Login: Nome de usuário administrador do Eccosys

  • Senha: Senha do usuário administrador

Clique em "Entrar".


Caso a configuração seja bem-sucedida, o Eccosys irá obter as informações necessárias diretamente da Nuvemshop, sem necessidade de informar dados da plataforma manualmente. Neste momento você será autenticado e poderá começar a usar integração.

O Eccosys permite ter integração simultânea com múltiplas lojas Nuvemshop. No entanto, o número de integrações disponíveis varia de acordo com os limites do plano contratado pela empresa.

Para verificar se a sua integração ocorreu corretamente, acesse Configurações > Integrações > Plataformas.

Acesse a plataforma referente à Nuvemshop e clique no botão "Testar conexão".



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

Caso o processo não ocorra de forma automática ou seja necessário ajustar algum detalhe nas configurações da integração, siga os passos abaixo:

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 Nuvemshop para iniciar a configuração.

Preenchendo os dados de acesso

Na tela de configuração da integração com a Nuvemshop, 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 Nuvemshop.

  • 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 Nuvemshop.

  • Access Token:
     Informe o Token de acesso obtido na Nuvemshop.

  • User ID:
     Cole o ID obtido junto a Nuvemshop.

💡 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 Nuvemshop 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 Nuvemshop, 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 Nuvemshop.

    • 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 Nuvemshop. Ú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 Nuvemshop.

    • Não: nenhuma imagem será enviada.

  • Controla exclusão de imagens
     Se ativado (Sim), o Eccosys irá excluir, na Nuvemshop, 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.

  • Sincronizar descrição com o e-commerce
     Sincronizará o conteúdo referente ao campo “Descrição E-commerce” do produto.

  • Importação de Produtos - Deduzir Código do Pai pelo Código dos Filhos
     Permite que o sistema identifique automaticamente o código do produto pai com base no padrão dos códigos das variações (filhos) durante a importação.

  • Importação de Produtos - Vincular Produtos pelo Código
     Permite que o sistema vincule automaticamente produtos importados aos já cadastrados no Eccosys, com base na correspondência do código do produto.

  • Idioma da Integração de Catálogo
     Define o idioma que será considerado para os dados enviados e recebidos na integração de catálogo, como títulos e descrições de produtos.

Estoque

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

    • 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 Nuvemshop.

    • 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 Nuvemshop 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 à Nuvemshop 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.

  • Atualização Status de Pedido - Obrigatória URL de Rastreio
     Exige que a URL de rastreio esteja preenchida para que o status do pedido seja atualizado na plataforma de e-commerce.

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 Mapeamentos

A aba Mapeamentos permite configurar campos personalizados entre o Eccosys e a plataforma integrada, utilizados quando determinadas informações não são contempladas na comunicação padrão da integração.

Ela serve como um complemento, possibilitando que dados específicos — como NCM, descrições adicionais, canais de venda, entre outros — sejam alinhados corretamente entre os sistemas, conforme a estrutura e nomenclatura utilizadas na plataforma.

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 Nuvemshop. 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 Nuvemshop, 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 Nuvemshop 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 Nuvemshop.

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 Nuvemshop.

  • 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 Nuvemshop conforme as regras configuradas na aba anterior.

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


Webhook

  • Eventos de vendas
     Permite consultar em tempo real eventos de venda, como baixa de estoque, confirmação de pagamento e cancelamento, garantindo que as informações estejam sempre atualizadas na plataforma integrada.

Como funciona a importação de depósito

Para que a sincronização de produtos funcione corretamente entre o Eccosys e a Nuvemshop, os depósitos (centro de distribuição) devem ser criados com a mesma nomenclatura entre eccosys e Nuvemshop. Após criados, deve-se programar a tarefa “Instalador apenas depósito” para que ela identifique os depósitos entre os ambientes e permita sua devida identificação nos pedidos de venda.

Recomendações de uso:

  • É 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.

A integração entre Eccosys e Nuvemshop 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 Nuvemshop ou para importar da Nuvemshop 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 Nuvemshop 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 Nuvemshop, 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 Nuvemshop. 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!


Clientes que não possuem múltiplos depósitos terão seu fluxo normal de importação de pedidos e atualização após seu faturamento via tarefa agendada.

Envio de rastreamento para a plataforma

O envio das informações de rastreamento para a plataforma Nuvemshop 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 Nuvemshop foi desenvolvida para oferecer uma operação centralizada, eficiente e conectada em tempo real. Com as configurações adequadas, é possível garantir o sincronismo completo entre catálogo, estoque, pedidos e informações logísticas — proporcionando mais controle, agilidade e confiabilidade para sua loja virtual.

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


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