# Planilha (upload) no Saara Online

Integração pra quem **não usa Tiny nem Bling** — importa produtos direto por uma planilha (CSV) mais um zip de fotos, sem precisar de ERP.

## Como importar produtos novos

[Clique aqui](https://lojista.saaraonline.com.br/seller/configuracoes/integracoes) — abre a tela de Integrações do seu painel. Lá:

- Clique no card **"Planilha (upload)"** pra abrir.
- Clique em **"Baixar modelo (CSV)"** — vem com exemplos já preenchidos: um produto simples e um produto com variação.
- Preencha sua planilha com os produtos (até **50 por vez** — se tiver mais, divida em várias planilhas e importe uma de cada vez).
- Reúna as fotos dos produtos num arquivo **.zip**. Cada foto deve ter o mesmo nome que você colocou na planilha.
- Volte na tela, selecione o arquivo da planilha e o zip de fotos, clique em **"Ver preview"**.
- Confira/ajuste a categoria de cada produto (ou use **"Categorizar em massa"** pra aplicar a mesma categoria em todos de uma vez).
- Clique em **Importar**.

## Como atualizar preço/estoque de produtos que já existem

- Clique em **"Exportar produtos atuais"** — baixa uma planilha com todos os seus produtos já cadastrados, no mesmo formato.
- Edite as células que quiser (ex.: coluna `preco` ou `estoque`) direto no Excel/Sheets.
- Suba essa planilha de novo em **"Ver preview"** — **não precisa selecionar o zip de fotos** dessa vez.
- O sistema reconhece pelo **código (SKU)** que o produto já existe e só atualiza os dados — não duplica, e não mexe nas fotos que já estavam lá (a menos que você suba um zip com foto nova pro mesmo código).

## Colunas da planilha

<table id="bkmrk-nomenome-do-produtoc"><tr><td>**nome**</td><td>Nome do produto</td></tr><tr><td>**codigo**</td><td>SKU/código único do produto (ou da variação) — é por ele que o sistema reconhece se já existe</td></tr><tr><td>**preco**</td><td>Preço de venda (ex.: 59.90)</td></tr><tr><td>**categoria**</td><td>Nome da categoria — só na linha principal do produto</td></tr><tr><td>**estoque**</td><td>Quantidade disponível</td></tr><tr><td>**peso**</td><td>Peso em kg (ex.: 0.3) — só na linha principal</td></tr><tr><td>**altura / largura / profundidade**</td><td>Dimensões em cm — só na linha principal</td></tr><tr><td>**descricao**</td><td>Descrição do produto — só na linha principal</td></tr><tr><td>**nome\_arquivo\_imagem**</td><td>Nome do(s) arquivo(s) de foto dentro do zip. Mais de uma foto no mesmo produto: separe os nomes com `;` (ponto e vírgula) na mesma célula — ex.: `foto1.jpg;foto2.jpg`. Não use vírgula, que é o separador da planilha. Deixe vazio numa atualização sem zip.</td></tr><tr><td>**codigo\_pai**</td><td>Deixe **vazio** pra produto simples ou pra linha principal de um produto com variação. Nas linhas de variação, coloque o `codigo` da linha principal (na planilha exportada, esse valor já vem preenchido automaticamente pro produto — não precisa mexer).</td></tr><tr><td>**variacao**</td><td>Só nas linhas de variação — o nome da opção, ex.: "Azul - P", "Vermelha - M". Deixe vazio na linha principal.</td></tr></table>

## Produto com variação (tamanho, cor...)

Uma linha "principal" com os dados compartilhados (nome, peso, dimensões, descrição, categoria, foto) — `codigo_pai` e `variacao` vazios. Logo abaixo, uma linha por variação preenchendo só `codigo`, `preco`, `estoque`, `variacao` e `codigo_pai` (apontando pro código da linha principal). Cada variação pode ter sua própria foto também.

> nome,codigo,preco,categoria,estoque,peso,altura,largura,profundidade,descricao,nome\_arquivo\_imagem,codigo\_pai,variacao  
> Camiseta Polo,POLO-01,79.90,Camisetas,0,0.35,2,30,25,Camiseta polo piquet,polo-azul.jpg,,  
> ,POLO-01-AZ-P,79.90,,8,,,,,,polo-azul-p.jpg,POLO-01,Azul - P  
> ,POLO-01-AZ-M,79.90,,12,,,,,,polo-azul-m.jpg,POLO-01,Azul - M  
> ,POLO-01-VM-P,84.90,,5,,,,,,polo-vermelha-p.jpg,POLO-01,Vermelha - P

## Campos obrigatórios pro frete

Pra calcular o frete corretamente, o produto precisa ter: **peso**, **altura**, **largura**, **profundidade**, **descrição** e **foto**. Faltando algum, o preview mostra o que falta e o produto importa como **rascunho** em vez de ativo — você completa depois direto no painel.

## Fotos

Formatos aceitos: **JPG, PNG ou WEBP** — qualquer outro arquivo dentro do zip é ignorado automaticamente. Nomes de arquivo sem acentos, espaços ou caracteres especiais (use `-` ou `_`). Recomendado: fotos quadradas (proporção 1:1); imagens maiores que 1000×1000px são redimensionadas e comprimidas automaticamente.

## Status atual (28/08/2026)

Pronta e testada: produto simples, com variação, exportação e atualização por SKU. Sem conexão externa — cada importação é independente, você pode usar quando quiser.