# 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](https://tiendanube.github.io/api-documentation/intro).