Antes de ligar a Nuvemshop ao ERP, decida qual sistema manda em cada dado do catálogo. Se essa decisão fica para depois, o mesmo produto acaba editado nos dois lados, e a integração passa a sobrescrever preço, estoque ou descrição sem que ninguém perceba. A ordem que evita retrabalho é: definir o responsável por cada dado, preparar variações, categorias e campos no formato que o conector exige e validar tudo com uma amostra pequena antes de importar o catálogo inteiro.
Este guia é para quem vai abrir ou reorganizar uma loja Nuvemshop que precisa conversar com um sistema de gestão. A Central de Atendimento da Nuvemshop documenta integrações com ERPs como Bling, Olist Tiny e Linx (via e-Millennium), e a API da plataforma permite trabalhar com loja, produtos, estoque, variações, imagens, categorias, pedidos, clientes e cupons. O que cada conector faz, porém, varia. Os critérios gerais, válidos para qualquer plataforma, estão nos requisitos da integração com ERP. Se você ainda compara plataformas pensando em integrações, veja como comparar Tray e Nuvemshop.
Qual sistema manda em SKU, preço, estoque, imagens e descrição?
Na maior parte das operações com ERP, o sistema de gestão manda no que é cadastro e estoque, e a loja manda no que é apresentação e venda. Mas isso é uma decisão, não uma regra da plataforma. O importante é que cada dado tenha um único responsável e que a equipe saiba onde editar.
O mapa abaixo é um modelo para preencher. A coluna “Responsável sugerido” traz o arranjo mais comum; a coluna “Direção” precisa ser confirmada no conector escolhido, porque nem todo conector sincroniza todos os dados nos dois sentidos.
| Dado | Responsável sugerido | Direção | Onde conferir na Nuvemshop | O que a documentação da Nuvemshop diz |
|---|---|---|---|---|
| SKU | ERP | ERP → loja | Produto e cada variação | Deve ser único por produto e por variação, sem repetição |
| Nome e descrição | Decidir: ERP ou loja | Verificar no conector | Página do produto | A descrição é tratada em HTML na planilha |
| Preço | ERP | ERP → loja | Produto e variações | Na planilha, decimais com ponto |
| Preço promocional | Decidir | Verificar no conector | Produto | Campo próprio, com o preço original riscado na loja |
| Estoque | ERP | ERP → loja e baixa por pedido | Produtos > Inventário | Estoque zero deixa o item esgotado; há estoque infinito e limitado |
| Imagens | Decidir | Verificar no conector | Galeria do produto e das variações | A planilha não importa imagens; pelo Bling, os formatos aceitos são .jpg, .png e .gif |
| Categorias | Loja | Loja | Árvore de categorias | A planilha só associa a categorias já criadas no painel |
| Variações | ERP | ERP → loja | Seção Variações do produto | O nome de uma propriedade não pode ser alterado depois de criado |
| Peso e dimensões | ERP | ERP → loja | Produto | Obrigatórios para o frete; peso em kg e medidas em cm |
| Marca, MPN, sexo, faixa etária | Decidir | Verificar no conector | Produto | Obrigatórios para canais de venda como Google Shopping, Facebook e Instagram |
| Pedido | Loja | Loja → ERP | Vendas | O Olist Tiny, por exemplo, importa as vendas da loja |
| Cancelamento | Definir no processo | Verificar no conector | Vendas e inventário | Testar na amostra |
| Nota fiscal e rastreio | ERP | ERP → loja, se o conector suportar | Detalhe do pedido | Verificar no conector |
| Cliente | Loja | Loja → ERP | Clientes | Verificar no conector |
Algumas regras específicas aparecem na Central e mudam o desenho do mapa:
- Bling: só é possível vincular uma loja Nuvemshop a cada conta Bling. A Central orienta não excluir na Nuvemshop produtos importados do Bling, porque o vínculo permanece e o produto apagado não volta em uma nova importação. Entre os erros documentados está o de atributos diferentes entre os dois sistemas e o de exportar produto ou variação com estoque zerado ou negativo, que a Nuvemshop não aceita na exportação inicial.
- Olist Tiny: a Central informa que a integração não funciona com o Nuvem Envio. Se a logística da loja depende dele, isso decide a escolha.
- Linx via e-Millennium: a integração não é nativa da Nuvemshop. A Central diz que ela exige um projeto formal de implantação, feito pela Linx, por uma franquia Linx ou por equipe técnica própria seguindo os requisitos da Linx, com custo orçado por eles e versão mínima do ERP definida.
- Vendas de marketplaces: nas páginas do Bling e do Olist Tiny, a Central informa que vendas feitas em marketplaces e importadas do ERP para a Nuvemshop não têm cobrança de tarifa por venda.
Se nenhum conector disponível atende ao mapa, a alternativa é uma integração própria pela API. A Central informa que quem desenvolve precisa ser parceiro Nuvemshop.
Como preparar variações, categorias e campos obrigatórios?
Com o mapa fechado, prepare os dados no sistema responsável antes de ligar a integração. Corrigir depois, com os dois lados sincronizando, é mais caro.
SKU. A Central da Nuvemshop recomenda um código alfanumérico, no mesmo formato para todo o catálogo, sem começar com zero (para não quebrar em planilhas), sem caracteres especiais e com hífen para separar as partes. Cada variação tem o seu: um produto em 2 cores e 3 tamanhos tem 6 SKUs. Se o ERP já usa outro padrão, mantenha o do ERP; o que não pode é haver SKU repetido.
Variações. Na Nuvemshop, cor e tamanho são propriedades pré-cadastradas, e é possível criar outras, como material. Os valores precisam bater com o ERP: o erro de validação documentado no Bling acontece justamente quando os atributos do mesmo produto diferem entre os dois lados. Para cores, usar os nomes da lista de cores da Nuvemshop faz a loja exibir a amostra da cor, e não só o texto. A Central também avisa que muitas variações em um mesmo produto podem deixar a loja lenta e sugere dividir em mais de um produto quando possível.
Categorias. Decida se a árvore nasce na loja ou no ERP. Como a planilha da Nuvemshop não cria categorias, a árvore precisa existir antes de qualquer carga por arquivo.
Peso e dimensões. Sem eles, o frete não calcula corretamente. Peso em quilogramas e medidas em centímetros, com ponto como separador decimal.
Campos de canais de venda. Se a loja vai alimentar Google Shopping, Facebook ou Instagram, a Central lista marca, MPN, sexo e faixa etária como obrigatórios, além do SKU. Vale preencher no ERP desde já.
Imagens. Defina quem sobe as fotos. Pela planilha não dá; pelo painel, é um produto por vez; a Central cita o Bling e aplicativos como o Automagico e o Drive para Nuvemshop para envio em massa. Se for pelo ERP, confira o formato dos arquivos.
Estoque inicial. Conte e lance o estoque real antes da primeira exportação. Além de evitar venda do que não existe, isso evita o erro de estoque zerado na exportação inicial pelo Bling.
Como validar pedido, cancelamento e estoque com uma amostra?
Antes de importar o catálogo inteiro, escolha de 5 a 10 produtos que representem os casos difíceis: um produto simples, um com duas propriedades de variação, um com uma variação sem estoque, um em promoção, um pesado ou volumoso e um que esteja em duas categorias.
Demonstração. O roteiro abaixo é um documento de teste para preencher. Ele não foi executado pela SouLoja em nenhum ERP específico; a coluna da direita fica em branco até o teste ser feito na sua conta, com o seu conector.
| Passo | Ação | Resultado esperado | Onde conferir | Resultado observado |
|---|---|---|---|---|
| 1 | Enviar a amostra do ERP para a loja | Os produtos aparecem com SKU, variações, preço, peso e medidas corretos | Lista de produtos da Nuvemshop | |
| 2 | Conferir a página de cada produto | Variação sem estoque aparece esgotada; imagens na variação certa | Loja, no celular e no desktop | |
| 3 | Alterar um preço no ERP | O novo preço chega à loja | Página do produto | |
| 4 | Alterar o estoque de uma variação no ERP | Só aquela variação muda | Produtos > Inventário | |
| 5 | Fazer um pedido pago na loja | O pedido chega ao ERP com cliente, itens por SKU, frete e pagamento | ERP, tela de pedidos | |
| 6 | Conferir o estoque depois do pedido | A quantidade baixou nos dois sistemas, uma vez só | ERP e inventário da loja | |
| 7 | Cancelar o pedido | O status muda nos dois lados e o estoque segue a regra definida no processo | ERP e Vendas | |
| 8 | Emitir nota e informar rastreio no ERP | Status e código chegam à loja, se o conector suportar | Detalhe do pedido | |
| 9 | Ocultar um produto em vez de excluir | O produto sai da loja sem perder o vínculo com o ERP | Lista de produtos | |
| 10 | Anotar quanto tempo cada sincronização levou | Tempo compatível com o ritmo de vendas da loja | Registro do teste |
A amostra só está aprovada quando todas as linhas tiverem resultado observado igual ao esperado, ou uma decisão registrada sobre o que muda no processo. Aí sim vale importar o resto do catálogo, em lotes, conferindo a cada lote.
Condições e limites
As regras citadas vêm da Central de Atendimento da Nuvemshop, consultada em 20/10/2026. Os ERPs aparecem aqui porque a Nuvemshop documenta integrações com eles; o texto não avalia nem recomenda nenhum. Planos, preços e funcionalidades de cada ERP e conector devem ser confirmados com o próprio fornecedor, e a direção de cada dado depende do conector instalado. Integrações por API exigem desenvolvimento e parceria com a Nuvemshop.
Próximo passo
Se o catálogo vem de outra loja, junte este mapa ao inventário da migração da Loja Integrada para a Nuvemshop, para preparar os dados uma vez só. Se você quer que o mapa de dados, a amostra e os testes de pedido façam parte da implantação, com o responsável de cada dado definido por escrito, conheça a nossa criação de loja na Nuvemshop.
