Integração com a Nuvemshop: conectar loja e sincronizar estoque nos dois sentidos

A tela Configurações > Integrações do painel do lojista agora também conecta com a Nuvemshop — traz seus produtos pro marketplace e mantém o estoque sincronizado nos dois sentidos, automaticamente, do mesmo jeito que já funciona com a VTEX.

Se você vende pela sua própria loja Nuvemshop e também pela Saara Online, o estoque de cada produto fica sempre certo nos dois lugares — vendeu na Nuvemshop, desconta aqui; vendeu aqui, desconta lá; cancelou em qualquer um dos dois, volta a ficar disponível nos dois. Nunca vende o mesmo item duas vezes.

Conectando

Clique em "Conectar com a Nuvemshop". Você será redirecionado pra própria Nuvemshop, onde autoriza o aplicativo Saara Online a acessar sua loja — depois de autorizar, você volta automaticamente pro painel do lojista, já conectado. Não precisa copiar token nem configurar nada manualmente: a autorização, o acesso e a notificação de pedidos já são configurados sozinhos nesse passo.

Como funciona a sincronização de estoque

• Vendeu na Nuvemshop (sua loja): o marketplace é avisado automaticamente e desconta a quantidade vendida do estoque daquele produto aqui.
• Vendeu aqui no marketplace: a mesma quantidade é descontada do estoque do produto na sua conta Nuvemshop.
• Pedido cancelado em qualquer um dos dois lados (inclusive pela Confirmação por Vídeo, quando o cliente reprova um produto antes do envio): a quantidade volta a ficar disponível dos dois lados também.

Tudo isso acontece sozinho, sem precisar reimportar nada — só precisa ter conectado uma vez.

Importando produtos

Com a conexão feita, clique em "Ver produtos para importar". O preview mostra os produtos da sua loja Nuvemshop, 50 por página, com:

• Filtrar por categoria — pelas categorias que vieram nos próprios produtos carregados.
• Estoque acima de — esconde produtos com estoque baixo/zerado.
• Filtrar por SKU — busca por código do produto ou de uma variação específica.

Selecionando o que importar

Cada linha é um produto. Produtos com mais de uma variação aparecem com os filhos logo abaixo, cada um com sua própria caixinha — dá pra desmarcar uma variação específica sem tirar o produto inteiro. Marcar o "pai" marca todas de uma vez.

Produtos já importados antes aparecem com a etiqueta "importado" — selecioná-los de novo atualiza o produto existente em vez de duplicar.

Categoria sem mapeamento

Se a categoria de um produto na Nuvemshop ainda não tem correspondente no marketplace, aparece um seletor na própria linha pra escolher a categoria certa. Dá pra fazer produto por produto, ou usar o bloco "Mapear categoria em massa" no topo do preview.

Produtos incompletos (vão como rascunho)

Quando um produto já tem peso, altura, comprimento, largura, descrição e foto cadastrados na Nuvemshop, aparece a chave "Importar como ativo/rascunho". Faltando qualquer um desses dados, o produto sempre entra como rascunho, com etiquetas laranjas mostrando o que falta — mesmo cuidado que já existe pro Tiny, Bling e VTEX, porque sem peso e dimensão certos o frete não fecha corretamente depois.

Sobre variações: assim como na VTEX, a Nuvemshop guarda o nome de cada variação de um jeito que ainda não conseguimos separar automaticamente em "Cor" e "Tamanho" com certeza — por enquanto, cada variação entra com o nome completo da Nuvemshop como opção única.

Confirmando a importação

Marque os produtos desejados e clique em "Confirmar importação". Ao final, o sistema informa quantos foram importados (novos) e quantos foram atualizados.

Desconectando

Clique em "Desconectar" no topo do card pra parar a sincronização. Isso não apaga os produtos já importados, só encerra a conexão.

Sobre o aplicativo

A integração usa o aplicativo oficial Saara Online, cadastrado no painel de parceiros da Nuvemshop (AppID 41933) — é o mesmo tipo de autorização que qualquer outro app da loja de aplicativos da Nuvemshop usa, só que feito sob medida pra puxar catálogo e manter estoque em dia com o marketplace.

Documentação oficial da API usada nessa integração: tiendanube.github.io/api-documentation.