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
(*) 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:
Configurações > Integrações > Plataformas.
Clique no botão Incluir Plataforma.
O sistema exibirá uma lista com todas as plataformas disponíveis para integração.
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:
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.
Como funciona a importação e envio de catálogo
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.
Exportação de produtos:
Permite enviar produtos cadastrados no Eccosys para a Nuvemshop.
Consulte o manual específico: Exportação de Catálogo nas Integrações de PlataformaImportação de produtos:
Permite trazer para o Eccosys os produtos já existentes na Nuvemshop.
Consulte o manual específico: Importação de Catálogo nas Integrações de Plataforma
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:
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.
A compra do cliente será confirmada, porém cada produto vai entregue por uma transportadora, em datas distintas.
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.
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.
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.