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