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.