# Painel do Lojista

Guias e tutoriais para lojistas usarem o painel do vendedor na Saara Online.

# Pagamentos: como cadastrar seus dados de recebimento (Pagar.me)

Esta página explica os campos da tela **Pagamentos** do painel do lojista (menu Configurações > Pagamentos). É aqui que você cadastra os dados que a Saara Online usa para criar sua conta de recebedor dentro do **Pagar.me**, o sistema que processa os pagamentos da plataforma e faz o repasse (split) das suas vendas direto pra sua conta bancária.

**Atenção:** depois que você envia o formulário uma primeira vez, ele não pode ser reenviado pelo próprio painel. Se precisar corrigir banco, conta ou dados cadastrais depois de enviado, é preciso falar com o suporte da Saara Online.

## Por que esses dados são pedidos?

O Pagar.me é quem processa as vendas (cartão, Pix, boleto) e é obrigado, por regulação do Banco Central, a saber exatamente quem é o dono de cada conta que recebe dinheiro pela plataforma (isso se chama KYC — conheça seu cliente). Por isso o cadastro pede documento, endereço, telefone, sócios (se for empresa) e dados bancários: são as mesmas informações que o Pagar.me exige de qualquer recebedor.

## 1. Tipo de recebedor

Primeiro você escolhe como vai receber:

- **Pessoa Jurídica** — quando a loja está em nome de um CNPJ (mais comum).
- **Pessoa Física** — quando você vende como CPF, sem empresa aberta.

## 2. Dados do recebedor

<table id="bkmrk-n%C3%BAmero-do-documentoc"><tbody><tr><td>**Número do documento**</td><td>CPF (pessoa física) ou CNPJ (pessoa jurídica). Se você digitar um CNPJ válido, o sistema busca automaticamente na Receita Federal e já preenche razão social, nome fantasia, data de fundação, endereço, telefone e sócios — revise os dados preenchidos, eles só servem de ponto de partida.</td></tr><tr><td>**E-mail**</td><td>E-mail de contato do recebedor, usado pelo Pagar.me para notificações.</td></tr><tr><td>**Site do recebedor**</td><td>Coloque o link da sua loja na Saara Online.</td></tr></tbody></table>

### Se for Pessoa Física

<table id="bkmrk-nome-completonome-co"><tbody><tr><td>Nome completo</td><td>Nome como consta no documento.</td></tr><tr><td>Data de nascimento</td><td>Formato DD/MM/AAAA.</td></tr><tr><td>Faturamento mensal (R$)</td><td>Estimativa de quanto você fatura por mês.</td></tr><tr><td>Ocupação profissional</td><td>O que você faz / ramo de atuação.</td></tr><tr><td>Nome da mãe</td><td>Exigido pelo Pagar.me para validação de identidade.</td></tr></tbody></table>

### Se for Pessoa Jurídica

<table id="bkmrk-raz%C3%A3o-socialnome-ofi"><tbody><tr><td>Razão Social</td><td>Nome oficial da empresa no CNPJ.</td></tr><tr><td>Nome da empresa (fantasia)</td><td>Nome pelo qual a empresa é conhecida.</td></tr><tr><td>Faturamento anual (R$)</td><td>Estimativa do faturamento anual da empresa.</td></tr><tr><td>Data de fundação</td><td>Formato DD/MM/AAAA.</td></tr><tr><td>Tipo de empresa</td><td>MEI, EI, EIRELI, LTDA, SA, SLU ou Outros — conforme consta no CNPJ.</td></tr></tbody></table>

### Telefone (ambos os casos)

DDD + número de telefone celular do recebedor.

## 3. Endereço

Se preenchido o CEP corretamente, o sistema já busca rua, bairro, cidade e estado automaticamente (via ViaCEP) — só confira e complete número, complemento e ponto de referência.

<table id="bkmrk-cep%2C-logradouro%2C-n%C3%BAm"><tbody><tr><td>CEP, Logradouro, Número, Complemento, Bairro, Cidade, UF, Ponto de referência</td><td>Endereço completo do recebedor (residencial para PF, ou sede da empresa para PJ).</td></tr></tbody></table>

## 4. Conta Bancária

É pra essa conta que o dinheiro das suas vendas será transferido pelo Pagar.me.

<table id="bkmrk-bancoselecione-o-ban"><tbody><tr><td>**Banco**</td><td>Selecione o banco na lista (Banco do Brasil, Itaú, Nubank, Inter, etc). Se o seu banco não estiver na lista, escolha "Outro" e digite o código de 3 dígitos (código COMPESB) do banco.</td></tr><tr><td>**Agência**</td><td>Número da agência, sem o dígito.</td></tr><tr><td>**Dígito (agência)**</td><td>Dígito verificador da agência, se tiver. Se não tiver, deixe "0".</td></tr><tr><td>**Conta**</td><td>Número da conta, sem o dígito.</td></tr><tr><td>**Dígito (conta)**</td><td>Dígito verificador da conta.</td></tr><tr><td>**Tipo de Conta Bancária**</td><td>Conta corrente ou Conta poupança.</td></tr><tr><td>**Nome da conta bancária**</td><td>Nome do titular da conta (deve bater com o nome/razão social cadastrado, senão o Pagar.me pode recusar).</td></tr></tbody></table>

## 5. Sócios (somente Pessoa Jurídica)

Se o CNPJ tiver mais de um sócio, adicione um bloco para cada um clicando em "Adicionar sócio". Ao buscar o CNPJ, os sócios do quadro societário já aparecem automaticamente com nome e função — mas CPF, e-mail, telefone e data de nascimento de cada sócio precisam ser completados manualmente (esses dados não vêm da consulta automática).

<table id="bkmrk-n%C3%BAmero-do-documentoc-1"><tbody><tr><td>Número do documento</td><td>CPF do sócio.</td></tr><tr><td>Nome</td><td>Nome completo do sócio.</td></tr><tr><td>Data de nascimento</td><td>DD/MM/AAAA.</td></tr><tr><td>E-mail</td><td>E-mail do sócio.</td></tr><tr><td>Área de atuação ou função desempenhada</td><td>Cargo/função do sócio na empresa.</td></tr><tr><td>Faturamento mensal (R$)</td><td>Faturamento pessoal estimado do sócio.</td></tr><tr><td>Nome da mãe</td><td>Nome da mãe do sócio.</td></tr><tr><td>DDD / Número de telefone</td><td>Celular do sócio.</td></tr><tr><td>Endereço</td><td>Endereço completo do sócio (mesmos campos da seção 3).</td></tr><tr><td>"Este sócio é o representante legal"</td><td>Marque se este sócio é quem responde legalmente pela empresa perante o Pagar.me.</td></tr></tbody></table>

## Depois de enviar

Ao clicar em **Enviar dados de repasse**, esses dados são enviados para o Pagar.me, que cria a conta de recebedor (recipient) vinculada à sua loja. A tela passa a mostrar só o **status** da conta:

- **pending** — em análise pelo Pagar.me.
- **active** — aprovada, já pode receber repasses.
- **restricted** / **rejected** — algo precisa ser corrigido ou foi recusado; entre em contato com o suporte.

Como o formulário não pode ser reenviado pelo painel, revise todos os campos com calma antes de clicar em enviar — principalmente documento, dados bancários e nome do titular da conta.

# Integração com o Tiny ERP (Olist): como importar produtos

A tela **Configurações &gt; Integrações** do painel do lojista permite trazer seus produtos do **Tiny ERP (Olist)** direto pro marketplace, e manter estoque e preço sincronizados automaticamente depois disso.

Existem duas formas de usar: **conectar via token** (recomendado, sincronização automática) ou **importar via planilha CSV** (mais simples, mas sem sincronização depois).

## Opção 1 — Conectar via token (recomendado)

Clique em **"Conectar via token"**.

<table id="bkmrk-token-da-api-do-tiny"><tbody><tr><td>**Token da API do Tiny**</td><td>Gerado dentro do Tiny em Configurações &gt; API. Esse token dá acesso total à conta do Tiny (não dá pra restringir permissões) — se preferir não compartilhar, use a importação via planilha em vez disso.</td></tr><tr><td>**ID da lista de preço** (opcional)</td><td>Se você usa listas de preço diferentes no Tiny (ex.: atacado, varejo), pode fixar aqui qual lista usar como preço padrão dos produtos importados.</td></tr><tr><td>**Descrição da lista de preço** (opcional)</td><td>Só um rótulo pra você lembrar qual lista escolheu (ex.: "Atacado", "Padrão").</td></tr></tbody></table>

Depois de conectar, o sistema já busca as listas de preço e categorias reais cadastradas no seu Tiny, e você pode escolher entre elas na hora de importar.

### Configurar o webhook (sincronização automática)

Assim que a conexão é feita, aparece um botão **"Copiar webhook"**. Copie essa URL e cole em **todos** os campos de "URLs de notificações" dentro do Tiny, em:

*Configurações → E-commerce → Integrações → Webhook*

Cole a mesma URL nos campos de estoque, preço, produto, situação de pedido, rastreio e nota fiscal. Hoje, só **estoque** e **preço** são realmente processados — os outros eventos são recebidos e ignorados com segurança até serem implementados, então não tem problema colar em todos.

Com o webhook configurado, toda vez que você mudar o preço ou o estoque de um produto no Tiny, o marketplace atualiza sozinho, sem precisar reimportar nada.

## Opção 2 — Importar via planilha (CSV)

Clique em **"Importar via planilha"** se preferir não compartilhar o token do Tiny. Exporte do Tiny um CSV com as colunas:

`codigo, nome, preco, categoria, estoque, imagem_url`

Cole o conteúdo do CSV na caixa de texto e clique em **"Ver preview"**.

**Limitação importante:** como o CSV não tem colunas de peso, altura, largura, comprimento, descrição nem foto, todo produto importado por planilha entra como **rascunho** até você completar esses dados manualmente depois, dentro do marketplace. Além disso, essa via não sincroniza — pra atualizar preço/estoque depois, é preciso reimportar.

## Antes de importar: filtros e preview

Se conectado via token, antes de ver os produtos você pode escolher a **lista de preço** a usar. Depois de clicar em **"Ver produtos para importar"**, é aberto um preview com filtros adicionais:

- **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 do preview é um produto. Produtos com variações (grade — tamanho, cor etc.) aparecem com os filhos logo abaixo, cada um com sua própria caixinha de seleção — dá pra desmarcar só uma variação específica (ex.: um tamanho sem estoque) sem tirar o produto inteiro da importação. Marcar o produto "pai" marca todas as variações de uma vez.

Produtos que já foram importados antes aparecem com a etiqueta **"importado"** — selecioná-los de novo **atualiza** o produto já existente no marketplace em vez de criar um duplicado.

### Categoria sem mapeamento

Se a categoria de um produto no Tiny ainda não tem correspondente no marketplace, aparece um seletor de categoria na própria linha pra você escolher a categoria certa do marketplace. Dá pra fazer isso produto por produto, ou usar o bloco **"Mapear categoria em massa"** no topo do preview: escolha a categoria do Tiny de um lado e a categoria do marketplace do outro, e clique em **"Aplicar a todos dessa categoria"** — todos os produtos daquela categoria do Tiny recebem o mapeamento de uma vez.

### Produtos incompletos (vão como rascunho)

Quando um produto já tem todas as informações necessárias (peso, altura, comprimento, largura, descrição e foto), aparece uma chave **"Importar como ativo/rascunho"** — você escolhe se ele já entra publicado ou como rascunho.

Quando falta alguma dessas informações, o produto **sempre entra como rascunho**, e aparecem etiquetas laranjas indicando o que falta completar (ex.: peso, foto, descrição) — depois é só editar o produto no marketplace e preencher o que faltou pra poder publicar.

## Confirmando a importação

Marque os produtos desejados e clique em **"Confirmar importação"**. O botão mostra quantos produtos estão selecionados. Ao final, o sistema informa quantos foram **importados** (novos) e quantos foram **atualizados** (já existiam e foram sobrescritos com os dados atuais do Tiny).

## Desconectando

Se quiser parar de sincronizar com o Tiny, clique em **"Desconectar"** no topo do card. Isso não apaga os produtos já importados, só encerra a conexão/token e para a sincronização automática via webhook.

# Como aumentar (ou trocar) seu plano

Em **Financeiro**, no card "Plano atual", clique em **"Alterar plano"** pra ver as opções disponíveis e trocar de plano quando quiser.

## Planos disponíveis

<table id="bkmrk-planopre%C3%A7olimite-de-"><tbody><tr><td>**Plano**</td><td>**Preço**</td><td>**Limite de produtos**</td><td>**Botão Mágico grátis/mês**</td></tr><tr><td>Grátis</td><td>R$ 0</td><td>50</td><td>3</td></tr><tr><td>Básico</td><td>R$ 200,00/mês</td><td>200</td><td>5</td></tr><tr><td>Pro</td><td>R$ 300,00/mês</td><td>500</td><td>10</td></tr><tr><td>Avançado</td><td>R$ 400,00/mês</td><td>1000</td><td>15</td></tr></tbody></table>

Precisa de mais que isso (loja muito grande, condições especiais)? Existe também o plano **Personalizado**, negociado direto com o suporte da Saara Online — ele não aparece nessa tela, é combinado por fora.

## Como trocar

1. Clique em **"Alterar plano"**.
2. Escolha um dos 4 cards (o atual aparece marcado com "plano atual").
3. Clique em **"Confirmar plano"**.

O que acontece depois depende do plano escolhido:

- **Grátis** — muda na hora, sem cobrança.
- **Básico, Pro ou Avançado** — não muda ainda: aparece um lançamento pendente no seu **Extrato** com o valor da primeira mensalidade, e logo abaixo surge a seção "Pagar saldo em aberto" — pague com **cartão de crédito (1x)** ou **Pix**. O plano só passa a valer de verdade depois que esse pagamento é confirmado (na hora no cartão; após a leitura do QR Code no Pix).

## Fazendo downgrade (plano menor)

Se você tentar mudar pra um plano com **limite de produtos menor** que a quantidade de produtos que você já tem cadastrados hoje, o sistema **bloqueia a troca** e mostra uma mensagem parecida com:

*"Você tem 320 produtos cadastrados. Para mudar para este plano (limite de 200 produtos), reduza sua quantidade de produtos para 200 ou menos antes de continuar."*

Ou seja: para fazer downgrade, primeiro **arquive, exclua ou desative** produtos até ficar dentro do limite do plano desejado, e só então a troca é permitida — o sistema não desativa nada automaticamente por você.

# Bling no Saara Online

Integração do painel do lojista com o **Bling ERP**, permitindo conectar a conta Bling do lojista ao Saara Online.

## Como conectar

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

- Clique no card **Bling ERP** pra abrir.
- Clique em **"Conectar com o Bling"**.
- Você será redirecionado pro Bling — faça login (ou já estará logado) e autorize o aplicativo **"Saara Online"**.
- O Bling te traz de volta pro painel já com o status "Conectado".

*Importante:* use sempre o botão dentro do seu painel, não um link avulso — é isso que garante que a conexão fica vinculada à sua loja.

## Importando produtos

- Com a conta conectada, clique em **"Ver produtos para importar"**.
- A lista mostra todos os produtos do Bling, com filtro por nome/código, e o estoque de cada um (soma de todas as variações, quando tiver).
- Marque os produtos desejados (ou use "Marcar todos" nos filtrados).
- Categoria: o sistema tenta casar automaticamente com uma categoria do Saara pelo nome; se não achar, escolha manualmente no seletor ao lado do produto — ou use **"Categorizar em massa"** pra aplicar uma categoria a todos os produtos filtrados de uma vez (ex.: filtra "camisa", marca todos, aplica a categoria "Camisetas").
- Produtos com **variação** no Bling (ex.: tamanhos P/M/G) importam como um produto único com as variações agrupadas — cada variação aparece indentada na lista, com seu próprio código, preço e estoque.
- Clique em **Importar**.

## Campos obrigatórios pro frete

Pra calcular o frete corretamente, todo produto precisa ter no Bling: **peso**, **altura**, **largura**, **profundidade**, **descrição** e pelo menos **uma foto**. Na lista de importação, cada produto mostra o que falta:

> Vai como rascunho — informações a completar: peso, altura, ...

Produto completo importa direto como **ativo** (publicado na loja). Produto incompleto importa como **rascunho** — complete os dados que faltam no Bling e reimporte, ou edite o produto direto no painel do Saara.

## Fotos

A galeria do produto no Saara vem das fotos cadastradas no **produto principal** do Bling. Se cada variação (P, M...) tiver sua própria foto, ela é usada como miniatura da variação — mas essa parte visual no site (mostrar a foto certa quando o cliente escolhe o tamanho) ainda está em construção.

## Depois de uma venda

Quando um pedido é pago no Saara, o sistema automaticamente no Bling: cria o cliente (se ainda não existir), registra o pedido de venda, e dá baixa no estoque do produto vendido. Isso já foi testado ponta a ponta na API — falta só confirmar com uma compra real no site.

## Status atual (28/08/2026)

<table id="bkmrk-conex%C3%A3o-oauth2-%28cone"><tbody><tr><td>**Conexão OAuth2 (conectar/desconectar)**</td><td>Pronta e testada</td></tr><tr><td>**Importação de produtos (foto, categoria, variação, frete)**</td><td>Pronta e testada</td></tr><tr><td>**Homologação do app junto ao Bling**</td><td>Solicitada — aplicativo em análise pela equipe do Bling</td></tr><tr><td>**Envio de pedido pago (cliente + venda + baixa de estoque)**</td><td>Implementado, validado na API</td></tr><tr><td>**Webhook de estoque/produto (Bling → Saara, tempo real)**</td><td>Servidor cadastrado no Bling</td></tr></tbody></table>

# 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.

# Preços e Promoções: promoção, atacado, campanhas e atualização em massa

Esta página fica no menu do painel do lojista em **Preço promocional**. Nela você controla quatro coisas do seu produto: promoção com data de início/fim, preço por quantidade (atacado), participação em campanhas sazonais do marketplace, e atualização em massa via planilha.

## Como escolher o produto

No topo da tela, digite o **nome ou o SKU** do produto na caixa de busca. A lista mostra até 20 resultados que batem com o que você digitou (por nome do produto ou por SKU de qualquer variação). Clique no produto desejado na lista para abrir as seções abaixo. Se o produto já tiver uma promoção cadastrada, aparece "· Promoção cadastrada" ao lado do nome dele na lista.

Para trocar de produto depois de já ter selecionado um, use o botão **Trocar produto**.

## 1. Preço promocional

Essa seção define um período em que o produto (ou suas variações) fica com um preço reduzido. Enquanto a promoção estiver dentro do período, o preço promocional **substitui** o preço cheio em todo o site — no card, na página do produto e no carrinho.

<table id="bkmrk-campopara-que-serve-"><tr><th>Campo</th><th>Para que serve</th></tr><tr><td>Início da promoção / Fim da promoção</td><td>Data e hora exatas em que a promoção começa e termina. Fora desse período, o preço cheio volta a valer sozinho.</td></tr><tr><td>Aplicar o mesmo preço promocional a todas as variações</td><td>Só aparece quando o produto tem mais de uma variação (cor, tamanho, etc). Marcado: você digita um único valor e ele vale para todas as variações. Desmarcado: você digita um preço promocional diferente para cada variação.</td></tr><tr><td>Preço promocional</td><td>O novo preço em reais. Abaixo do campo aparece o preço cheio atual daquela variação, só como referência.</td></tr></table>

Clique em **Salvar promoção** para aplicar. Se quiser encerrar a promoção antes da data, use **Remover promoção** — o produto volta a vender pelo preço cheio na hora.

## 2. Preço por quantidade (atacado)

Essa seção cria faixas de desconto por quantidade — "compre X unidades, pague Y% mais barato por unidade". O desconto é sempre calculado **em cima do preço que estiver valendo naquele momento**: se houver uma promoção ativa, o atacado desconta a partir do preço promocional; se não houver promoção, desconta a partir do preço cheio. Isso evita que o preço de atacado fique, por engano, mais caro que uma promoção em andamento.

<table id="bkmrk-campopara-que-serve--1"><tr><th>Campo</th><th>Para que serve</th></tr><tr><td>A partir de ... unidades</td><td>Quantidade mínima da compra para o desconto daquela faixa valer (ex.: 10).</td></tr><tr><td>% (percentual)</td><td>Desconto percentual sobre o preço vigente naquela faixa (ex.: 15 = 15% de desconto).</td></tr></table>

Use **Adicionar faixa** para criar mais de um degrau de desconto (por exemplo: 5+ unidades = 5% off, 10+ unidades = 12% off). Depois de configurar, clique em **Salvar faixas de preço**.

**Importante:** se você mudar o preço promocional depois de já ter salvo faixas de atacado, volte nesta seção e clique em Salvar faixas de preço de novo — isso recalcula o valor do atacado em cima do novo preço promocional. Sem isso, a faixa de atacado guardada fica com o valor antigo.

## 3. Campanha sazonal

Campanhas sazonais (ex.: "Black Friday", "Dia das Mães") são criadas pelo administrador do marketplace, que define nome, período e as cores especiais do card (fundo e faixa diagonal). Nesta seção você escolhe em quais campanhas ativas o seu produto vai participar e define o preço dele para cada uma.

<table id="bkmrk-campopara-que-serve--2"><tr><th>Campo</th><th>Para que serve</th></tr><tr><td>Caixa de seleção da campanha</td><td>Marque para o produto participar daquela campanha.</td></tr><tr><td>Preço</td><td>O preço do produto durante essa campanha específica.</td></tr><tr><td>Ícone de pontinhos (arrastar)</td><td>Se o produto participar de mais de uma campanha ativa **ao mesmo tempo**, a que estiver no topo da lista é a que vence — aparece no card com a cor/faixa especial e é o preço realmente cobrado. Arraste pelo ícone para reordenar a prioridade.</td></tr></table>

Depois de marcar as campanhas e definir os preços, clique em **Salvar campanhas**. Uma campanha só aparece disponível aqui se o administrador já tiver ativado ela.

## 4. Atualização em massa (planilha)

Para quem tem muitos produtos, ajustar um por um fica inviável. O botão **Atualização em massa**, no canto superior direito da tela, abre um painel para editar promoção, atacado e campanhas de vários produtos de uma vez, por planilha (CSV).

### Passo a passo

1. **Baixar modelo**: baixa uma planilha de exemplo em branco, mostrando o formato esperado.
2. **Baixar meu catálogo atual**: baixa uma planilha já preenchida com todos os seus produtos e o que já está configurado hoje (promoção, atacado, campanhas). É a forma mais fácil de editar em massa: baixe essa, ajuste só o que precisa mudar, apague as linhas dos produtos que não vão participar de nada, e envie de volta.
3. Abra o arquivo baixado no Excel, LibreOffice ou Google Sheets normalmente.
4. Edite as colunas que quiser (veja a tabela abaixo).
5. **Apague as linhas** dos produtos/variações que você não quer alterar — só as linhas que sobrarem no arquivo são processadas.
6. Salve como **.csv**.
7. Volte na tela, clique em **Escolher planilha (.csv)**, selecione o arquivo salvo.
8. Clique em **Importar e processar**. O sistema mostra quantas linhas foram processadas e, se alguma linha der erro, lista o SKU e o motivo.

### Colunas da planilha

<table id="bkmrk-colunao-que-%C3%A9-skuide"><tr><th>Coluna</th><th>O que é</th></tr><tr><td>`sku`</td><td>Identifica o produto/variação. É a única coluna realmente usada para achar o produto — as demais (`produto`, `variacao`, `preco_atual`) são só para você reconhecer a linha, e são ignoradas na hora de processar.</td></tr><tr><td>`preco_promocional`</td><td>Novo preço promocional. Precisa vir preenchido junto com `promo_inicio` e `promo_fim` — os três juntos, ou os três vazios (vazio = sem promoção nessa linha).</td></tr><tr><td>`promo_inicio` / `promo_fim`</td><td>Data e hora no formato `AAAA-MM-DD HH:MM` (ex.: `2026-09-10 00:00`).</td></tr><tr><td>`atacado`</td><td>`sim` ou `não`. Se `sim`, precisa preencher `atacado_qtd` e `atacado_percentual` também.</td></tr><tr><td>`atacado_qtd`</td><td>Quantidade mínima para o desconto de atacado valer.</td></tr><tr><td>`atacado_percentual`</td><td>Percentual de desconto do atacado sobre o preço vigente daquela linha (promocional, se houver; senão o preço cheio).</td></tr><tr><td>`campanhas`</td><td>Nome exato de uma ou mais campanhas sazonais que o produto participa. Para mais de uma, separe com **ponto e vírgula** ( `;` ), na ordem de prioridade — a primeira da lista é a que vence se houver mais de uma ativa ao mesmo tempo. Os nomes exatos das campanhas disponíveis no momento aparecem numa área no **final da própria planilha baixada** — copie de lá para não errar a digitação.</td></tr><tr><td>`campanhas_precos`</td><td>Preço do produto em cada campanha listada em `campanhas`, na mesma ordem, também separado por ponto e vírgula. Exemplo: `campanhas = Black Friday;Dia das Mães` e `campanhas_precos = 69.90;74.90` significa R$69,90 na Black Friday e R$74,90 no Dia das Mães.</td></tr></table>

**Atenção com os separadores:** os valores em reais sempre usam **ponto** como separador decimal (ex.: `69.90`, nunca `69,90`) — a vírgula é reservada para separar as colunas da planilha. Ao abrir/salvar no Excel ou LibreOffice, se aparecer uma tela perguntando o "conjunto de caracteres" e o "separador", escolha **Unicode (UTF-8)** e marque só a opção **Vírgula** como separador de colunas (não marque ponto e vírgula).

# Produtos patrocinados: como destacar seus produtos com selo e cobrança

A página **Produtos patrocinados** deixa você destacar um ou mais produtos seus nas listagens do site — eles ganham um selo de estrela e um fundo especial no card, chamando mais atenção do comprador. É um serviço pago: cada produto patrocinado gera uma cobrança automática no seu extrato quando o período de destaque termina.

Essa função só aparece se o administrador do marketplace tiver ativado ela. Se você não vir a página no menu, ainda não está disponível.

## Como funciona

1. Na tela, use a caixa de busca para encontrar o(s) produto(s) pelo nome.
2. Marque a caixa de seleção dos produtos que você quer destacar. Produtos que já estão patrocinados no momento aparecem com a data em que o destaque termina, sem opção de marcar de novo (não dá pra "renovar" um destaque em andamento — é preciso esperar ele expirar).
3. Com um ou mais produtos marcados, aparece o resumo: quantos produtos, e o valor total. Clique em **Patrocinar selecionados**.
4. Uma tela de confirmação mostra o resumo completo — quantidade, prazo do destaque, valor total — e avisa que a ação não pode ser desfeita nem cancelada. Confirme só se tiver certeza.
5. Ao confirmar, o destaque é ativado imediatamente nos produtos escolhidos.

## Cobrança

O preço por produto e a duração do destaque são definidos pelo administrador do marketplace (aparecem escritos na própria tela antes de você confirmar). No momento em que você ativa, o sistema já lança a cobrança no seu extrato financeiro — mas ela só é efetivamente cobrada (descontada do seu repasse, ou cobrável via o pagamento de saldo em aberto) quando o prazo do destaque termina, não na hora da ativação.

Exemplo: se o preço configurado for R$5,00 por produto e a duração 30 dias, patrocinar 3 produtos de uma vez gera 3 lançamentos de R$5,00 no extrato, cada um com vencimento 30 dias depois da ativação daquele produto.

## Fim do destaque

Quando o prazo termina, o selo de estrela e o fundo especial saem do card automaticamente — você não precisa fazer nada. Depois disso, o produto pode ser patrocinado de novo normalmente.

## Importante

- A ativação é **irreversível**: depois de confirmada, não existe botão de cancelar ou estornar a cobrança.
- Um produto já patrocinado não pode ser selecionado de novo até o destaque atual expirar.
- Se o produto participar de uma campanha sazonal ativa ao mesmo tempo, a aparência da campanha (cor de fundo e faixa) tem prioridade sobre o fundo do patrocínio no card — mas o selo de estrela do patrocínio continua aparecendo normalmente.

# Vídeos do produto: link do YouTube ou upload MP4, e vídeo no card

A tela **Vídeos do produto** (menu do painel do lojista) deixa você adicionar até 2 vídeos por produto — um de **apresentação** e um **UGC** (depoimento de cliente) — e escolher se esse vídeo também aparece direto no card do produto na home e na página de categoria.

## Como cadastrar um vídeo

Pra cada um dos 2 campos (apresentação e UGC), você tem duas opções — pode usar as duas ao mesmo tempo em produtos diferentes, mas cada campo só guarda uma:

<table id="bkmrk-op%C3%A7%C3%A3ocomo-usarlink-d"><tr><th>Opção</th><th>Como usar</th></tr><tr><td>Link do YouTube</td><td>Cole a URL do vídeo no campo de texto. Aceita link normal (*youtube.com/watch?v=...* ou *youtu.be/...*) e também **YouTube Shorts** (*youtube.com/shorts/...*).</td></tr><tr><td>Upload direto (MP4)</td><td>Clique no botão de upload ao lado do campo (ícone de nuvem) e escolha um arquivo **.mp4 de até 10MB**. O sistema processa e preenche o campo sozinho com o link do vídeo já hospedado.</td></tr></table>

Depois de preencher, clique em **Salvar** na linha do produto.

## Mostrar o vídeo no card (home e categoria)

Existe uma coluna **Vídeo no card** com uma caixinha de marcar — só fica disponível depois que o produto tem pelo menos um dos dois vídeos preenchido. Marcando essa opção e salvando, o card desse produto na home e na página de categoria passa a mostrar um **carrossel de verdade**: os vídeos cadastrados + as 2 fotos do produto, alternando pela mesma setinha/arraste que já existe nos outros cards.

### O que muda dependendo do tipo de vídeo

- **MP4 enviado por upload**: toca mudo e em loop, preenchendo o quadrado do card por completo, sem cortes nem barras. Antes de carregar, mostra a própria foto do produto como capa (sem esse instante em branco).
- **Link do YouTube**: mostra a miniatura real do vídeo primeiro (capa), e o vídeo entra tocando por cima assim que carrega. Funciona tanto pra vídeo horizontal quanto pra Shorts (vertical) — o sistema detecta o formato e corta certinho pra preencher o quadrado, sem sobrar barra preta dos lados nem em cima/embaixo.

*Um detalhe do próprio YouTube, sem solução: nos primeiros 2-3 segundos aparece rapidinho o título e o ícone do canal por cima do vídeo — é o player oficial do YouTube que faz isso, não tem parâmetro que tire. Some sozinho e não volta. Se esse detalhe incomodar num vídeo específico, a alternativa é subir esse mesmo vídeo como upload MP4 em vez de link — aí não aparece nada, toca limpo desde o primeiro frame.*

# Crédito de IA, destaque de loja e banner na home: como funciona

Este guia explica três formas de dar mais visibilidade à sua loja e aos seus produtos na Saara Online — **Crédito de IA** (pra usar o Botão Mágico sem parar), **destaque de loja** e **banner na home** — e onde encontrar cada uma no seu painel.

## Crédito de IA — pra nunca ficar sem Botão Mágico

O Botão Mágico gera fotos e fichas de produto automaticamente com IA. Todo plano já inclui uma cota grátis por mês; quando ela acaba, você pode continuar usando pagando com o **Crédito de IA** — um saldo pré-pago que é descontado automaticamente a cada uso, sem interromper seu fluxo de cadastro.

### Como comprar

Vá em **Financeiro** no menu do painel. Na seção de pagamento, você verá duas opções lado a lado: **"Pagar saldo"**e **"Crédito de IA"** — clique em **"Crédito de IA"**.

- Escolha um dos valores prontos: **R$ 50**, **R$ 100**ou **R$ 150** — ou clique em **"Definir outro valor"**pra digitar o valor que quiser (mínimo de R$ 10).
- Pague com **cartão de crédito** (à vista) ou **Pix**(QR code, com 3 minutos pra confirmar o pagamento).
- Na primeira compra com cartão, seus dados ficam salvos com segurança. Da segunda vez em diante, você só precisa digitar o **CVV** — não precisa redigitar o número do cartão inteiro. Se quiser trocar de cartão, é só clicar em **"Usar outro cartão"**.

O saldo aparece na tela do Financeiro (logo abaixo do seu plano) e também no topo da página do Botão Mágico. Ele é debitado automaticamente, na ordem: primeiro a cota grátis do seu plano, depois o Crédito de IA.

### Quanto custa cada uso (acima da cota grátis)

<table id="bkmrk-a%C3%A7%C3%A3opre%C3%A7o-gera%C3%A7%C3%A3o-de"><thead><tr><th>Ação</th><th>Preço</th></tr></thead><tbody><tr><td>Geração de produto</td><td>R$ 15</td></tr><tr><td>Imagem extra / variante</td><td>R$ 5</td></tr></tbody></table>

**Importante:** se a cota grátis do mês já acabou e não houver Crédito de IA suficiente, a geração fica bloqueada até você comprar mais crédito — a tela mostra um aviso claro nesse momento, com um link direto pra comprar.

## Destaque de loja e banner na home — Vitrine Saara Online

A página inicial da Saara Online reserva posições pagas de destaque. Você contrata o espaço, envia um briefing e nossa equipe cria a arte pra você — sem precisar ter designer próprio. Acesse pelo menu **"Vitrine Saara Online"** no seu painel.

### Como contratar

1. Escolha o tipo: **"Destaque de loja"** (sua loja aparece em posição de destaque na home) ou **"Banner na home"**(um banner com a arte da sua loja no carrossel principal).
2. Escolha por quantas **semanas** quer contratar.
3. Informe o **link** pra onde o destaque/banner deve levar o visitante (ex.: a página da sua loja, ou de um produto específico).
4. Escreva um **briefing** contando o que você quer que a arte transmita (cores, promoção em destaque, produtos, etc.).
5. Confirme. O valor total (semanas × preço por semana) aparece antes de confirmar.

As vagas são limitadas — se não houver posição disponível no momento, a opção fica desabilitada até abrir uma vaga nova.

### Como funciona depois de contratado

- Nossa equipe de operação produz a arte com base no seu briefing.
- Quando a arte fica pronta, ela aparece na sua lista de solicitações com status **"Aguardando aprovação"** — dá pra clicar na imagem pra ver em tamanho grande e baixar.
- Você pode **aprovar** (a arte vai ao ar na home) ou **reprovar** pedindo uma correção (você tem direito a **uma correção gratuita**; da segunda reprovação em diante, nossa equipe entra em contato pra resolver manualmente).
- **A cobrança só acontece quando você aprova a arte** — ou seja, você nunca paga por uma arte que não gostou e ainda não teve chance de corrigir.

Assim que aprovado, o destaque/banner fica visível na home pelo período contratado, e a cobrança aparece no seu extrato em **Financeiro** já como paga.

## Produtos patrocinados

Além da loja inteira, também dá pra destacar produtos específicos do seu catálogo com um selo de patrocinado, aumentando a visibilidade nas buscas e listagens. Acesse pelo menu **"Produtos patrocinados"**— selecione os produtos, confirme, e a cobrança é automática por um período fixo. Detalhes completos de como funciona (preço, duração, seleção de produtos) estão na página dedicada: [Produtos patrocinados: como destacar seus produtos com selo e cobrança](https://wiki.saaraonline.com.br/books/painel-do-lojista/page/produtos-patrocinados-como-destacar-seus-produtos-com-selo-e-cobranca).

## Onde acompanhar tudo

Toda cobrança dessas três frentes — Crédito de IA, destaque de loja, banner na home e produtos patrocinados — aparece no seu extrato em **Financeiro**, com data, descrição, valor e status ("Pendente" ou "Pago"). É o mesmo lugar onde você acompanha seu plano, seu saldo disponível e o histórico de repasses.

# Receba do seu jeito: repasse automático ou saque manual

Agora você escolhe como e quando quer receber o dinheiro das suas vendas — sem precisar esperar por um calendário fixo. Este guia explica as duas formas disponíveis e como trocar entre elas.

## Duas formas de receber

Vá em **Financeiro** no seu painel. Perto do seu saldo disponível, você encontra a opção **"Forma de receber"** com dois modos:

- **Automático** (padrão de toda loja nova) — assim que o seu saldo disponível no Pagar.me atinge **R$ 100**, o sistema transfere sozinho pra sua conta bancária cadastrada, todo dia. Você não precisa fazer nada — só acompanhar em "Histórico de repasses".
- **Manual** — o repasse automático fica desligado, e **você decide quando quer o dinheiro**.

Pra trocar entre um e outro, é só selecionar a opção desejada — a mudança já vale a partir da próxima verificação de saldo.

## Solicitar saque — receba na hora, quando quiser

Independente do modo escolhido, sempre que houver saldo disponível aparece o botão **"Solicitar saque"** ao lado do seu saldo. Clicando nele:

- Todo o saldo disponível é transferido pra sua conta bancária **na hora**, sem esperar nenhum calendário.
- **Não tem valor mínimo** — diferente do repasse automático (que só age a partir de R$ 100), o saque manual libera qualquer valor disponível, mesmo que seja pequeno.

Uma observação importante: o Pagar.me cobra uma taxa fixa de transferência bancária em toda movimentação, automática ou manual. Pra valores muito pequenos essa taxa pode representar uma fatia grande do saque — por isso o repasse automático só age a partir de R$ 100, garantindo que a taxa não pese tanto. No saque manual a escolha é sua: você pode sacar qualquer valor disponível quando quiser, sabendo desse detalhe.

## Por que essa liberdade existe

Cada lojista tem uma necessidade diferente de fluxo de caixa. Se você prefere não pensar nisso e deixar o dinheiro se acumular até compensar a taxa de transferência, o modo automático cuida disso sozinho. Se você prefere ter controle total — sacar um valor pequeno hoje porque precisa, esperar mais dias em outra ocasião — o modo manual com o botão de saque te dá esse poder de decisão, na hora que você quiser.

## Onde acompanhar

Toda transferência — automática ou por saque manual — aparece em **Financeiro → Histórico de repasses**, com valor e data.

# Como funciona o envio dos seus produtos

Muitos lojistas têm dúvida sobre como funciona o envio dos produtos depois que uma venda acontece na Saara Online. Este manual explica o passo a passo em linguagem simples — sem termos técnicos.

## O maior diferencial: você não embala, não compra etiqueta, não imprime nada

Isso é proposital. Na Saara Online, quem cuida de toda a parte de envio é a nossa própria operação logística (Centro de Distribuição) — não você. Você só precisa separar o produto certo e entregá-lo (ou deixar disponível pra retirada, veja abaixo). **A partir daí, é problema nosso, não seu.**

<table id="bkmrk-voc%C3%AA-faza-saara-onli"><tr><th>Você faz</th><th>A Saara Online faz</th></tr><tr><td>Separa o produto vendido</td><td>Confere, pesa e fotografa o produto ao receber</td></tr><tr><td>Entrega ou disponibiliza pra retirada</td><td>Embala pra envio</td></tr><tr><td>Nada mais depois disso</td><td>Compra a etiqueta de envio (com a transportadora mais adequada)</td></tr><tr><td>—</td><td>Contrata seguro integral do produto durante o transporte</td></tr><tr><td>—</td><td>Despacha e insere o código de rastreio no seu pedido automaticamente</td></tr><tr><td>—</td><td>Avisa o cliente por e-mail com o rastreio</td></tr></table>

## Você é avisado automaticamente pelo WhatsApp

Pra facilitar ainda mais, a Saara Online avisa você pelo WhatsApp nos momentos que realmente importam — sem precisar ficar checando o painel o tempo todo:

- **Assim que a venda acontece** — notificação automática da nova compra, na hora.
- **Na hora de separar o produto** — avisamos exatamente qual item separar pra aquele pedido.
- **Na escolha entre entrega e retirada** — você decide direto pelo WhatsApp se vai levar o produto até o Centro de Distribuição ou se prefere que a gente busque na sua loja.

## Passo a passo, depois que a venda acontece

1. **A venda é confirmada.** Você recebe a notificação pelo WhatsApp na hora, e o pedido já aparece no seu painel normalmente, com o valor que vai cair pra você já calculado.
2. **Separação do produto.** Avisamos pelo WhatsApp exatamente qual item separar pra esse pedido.
3. **Você tem até 24 horas úteis** pra levar o produto até o nosso Centro de Distribuição (CD) — ou deixá-lo pronto pra retirada, dependendo da forma combinada com sua loja.
4. **Conferência no CD:** ao receber o produto, nossa equipe pesa e fotografa o item. Isso existe pra dar segurança pros dois lados — se algo estiver diferente do esperado, entramos em contato com você antes de qualquer coisa.
5. **Envio segurado:** todo produto viaja com **seguro integral** (o valor declarado do seguro é o valor real do item) — não é um seguro simbólico.
6. **Compra da etiqueta e despacho:** nossa operação compra a etiqueta com a transportadora, embala e despacha. Se o cliente comprou produtos de mais de uma loja na mesma compra, a gente também cuida de juntar tudo numa única remessa pra ele.
7. **Rastreio automático:** assim que o produto é despachado, o código de rastreio aparece sozinho no seu pedido — sem você precisar fazer nada.
8. **Cliente avisado:** o comprador recebe um e-mail automático com o código de rastreio. Fim da sua parte na operação.

## Entrega ou retirada — as duas formas existem

Você pode **levar o produto até o Centro de Distribuição** você mesmo, ou pedir que **nossa equipe busque diretamente na sua loja**. Essa escolha é feita direto pelo WhatsApp, na notificação que você recebe — sem precisar ligar ou entrar em contato com o suporte. As duas formas são válidas — o que importa é que o produto esteja disponível dentro do prazo de 24 horas úteis.

## Por que o prazo de 24h úteis importa

Esse prazo existe pra garantir que o cliente receba a compra rápido, o que é bom pra reputação da sua loja e da Saara Online como um todo. Se estiver perto de vencer, avisamos você por e-mail antes do prazo acabar. Um atraso real pode significar que seu produto fica de fora daquela remessa (o resto do pedido do cliente segue normalmente) ou, em casos de atraso, o pedido pode ser cancelado com reembolso ao cliente — por isso vale sempre ficar de olho no prazo.

## Perguntas frequentes

**Preciso comprar caixa, plástico bolha ou qualquer material de embalagem?**  
Não. A embalagem final pra envio é feita por nós.

**Preciso imprimir alguma etiqueta?**  
Não. A etiqueta é comprada e impressa pela nossa operação.

**E se o cliente comprou de mim e de outra loja ao mesmo tempo?**  
Nossa operação consolida os produtos das duas lojas numa remessa só pro cliente — você só entrega/disponibiliza a sua parte normalmente.

**O que acontece se eu não conseguir entregar a tempo?**  
Avisamos por e-mail antes do prazo vencer. Se mesmo assim não der, seu item pode ficar de fora do envio daquele pedido — o ideal é sempre respeitar as 24h úteis pra não acontecer.