| Campo | O que é | Quem preenche |
|---|
| **NCM** | Código de 8 dígitos que classifica a mercadoria (Nomenclatura Comum do Mercosul) — obrigatório em qualquer nota fiscal de produto. | Você (ou herdado do seu ERP/IA — veja abaixo) |
| **CEST** | Código Especificador da Substituição Tributária — só se aplica a produtos sujeitos a Substituição Tributária de ICMS. Se não for o seu caso, deixe em branco. | Você |
| **CST/CSOSN** | Situação tributária do ICMS naquela venda. **Depende do seu regime tributário** (Simples Nacional, Lucro Presumido, Lucro Real), não do produto em si — por isso nunca é preenchido automaticamente por IA, só manualmente ou pelo seu ERP. | Você (ou seu contador) |
| **Origem da mercadoria** | 0 = nacional (padrão da maioria), outros códigos para produtos importados ou com conteúdo de importação. | Você (ou herdado do seu ERP/IA) |
## 2. Como preencher — 4 formas, escolha a que já usa
### 2.1. Botão Mágico (cadastro por IA)
Ao cadastrar um produto pelo Botão Mágico, a IA agora sugere automaticamente **NCM**, **CEST** (quando aplicável) e **Origem da mercadoria**, com base na análise das fotos e descrição. O campo **CST/CSOSN** pode ser preenchido opcionalmente na mesma tela de revisão (a IA nunca sugere esse valor sozinha, já que depende do seu regime tributário) — ou depois, pela planilha ou pela ferramenta de atualização em massa.
### 2.2. Planilha de cadastro manual
Quem cadastra produtos pela planilha (sem ERP) agora encontra as 4 colunas fiscais (`ncm`, `cest`, `cst_csosn`, `origem`) direto no modelo de download — inclusive na tabela de exemplo, para você ver o formato esperado. Preencha junto com os demais dados do produto e envie normalmente.
### 2.3. Atualização em massa por SKU (sem recadastrar o produto)
Nova ferramenta em **Produtos > Dados fiscais dos produtos**: baixe uma planilha com todo o seu catálogo atual (ou o modelo em branco), preencha NCM/CEST/CST-CSOSN/Origem por SKU, e reenvie — atualiza só os campos fiscais, sem mexer em preço, estoque ou descrição. Ideal para quem já tem produtos cadastrados e só precisa regularizar a parte fiscal de uma vez.
### 2.4. Integração com ERP (Tiny e Bling)
Se sua loja está conectada ao **Tiny** ou ao **Bling**, a importação de produtos agora já traz automaticamente os campos fiscais que essas plataformas já têm cadastrados:
- **Tiny:** NCM, Origem da mercadoria e GTIN/código de barras.
- **Bling:** NCM, CEST e Origem da mercadoria.
Ou seja: se você já preenche esses campos no seu ERP, não precisa preencher de novo na Saara Online — a próxima sincronização já traz tudo.
## 3. Configuração fiscal da loja
Em **Configurações > Dados fiscais (NF-e)**, cadastre uma vez:
- **Inscrição Estadual** — número, ou "ISENTO" se sua loja não for contribuinte de ICMS (ex.: alguns MEIs de serviço).
- **Regime tributário** — Simples Nacional, Lucro Presumido ou Lucro Real.
- **Certificado digital A1** — envie o arquivo (.pfx/.p12) e a senha. O sistema valida na hora (senha correta, arquivo íntegro, ainda dentro da validade) e guarda tudo de forma criptografada — a senha nunca é mostrada de novo depois do envio.
Enquanto esses dados não estiverem completos, a loja continua funcionando normalmente — cada pacote despachado sai com uma **declaração de conteúdo** gerada automaticamente pela plataforma, documento simples de transporte (sem valor fiscal), até você configurar a emissão de nota de verdade.
## 4. Emissão da Nota Fiscal — dois caminhos, você escolhe
Em **Documentos de envio**, para cada pedido você tem duas opções:
| Opção | Como funciona |
|---|
| **Emitir NF-e pelo sistema** | A Saara Online gera a nota, assina digitalmente com o seu certificado e envia direto para a SEFAZ do seu estado — sem precisar de nenhum sistema externo. Exige Inscrição Estadual, regime tributário e certificado já configurados (item 3). O documento fica claramente identificado como "Nota fiscal (Saara)" na tela de Documentos de envio. |
| **Enviar a nota que você já gerou** | Se você já emite sua própria NF-e por outro sistema (contador, ERP próprio, etc.), é só subir o PDF antes do pacote passar pelo check-in no CD — ele substitui a declaração automática. Aparece como "Nota fiscal (Lojista)" na tela, pra ficar claro de onde veio. |
**Atualização — teste real concluído com sucesso (19/09/2026):** a emissão direto pela SEFAZ (sem gateway pago, sem sistema externo) foi testada de ponta a ponta em ambiente de homologação — certificado digital, geração e assinatura do XML, envio para a SEFAZ do Rio de Janeiro, autorização de uso e geração do DANFE em PDF, tudo funcionando corretamente com uma nota real (cStat 100 — "Autorizado o uso da NF-e"). O caminho técnico está validado. A liberação para emissão com validade fiscal real em produção segue sendo feita loja por loja, conforme cada lojista configura seus dados fiscais reais (Inscrição Estadual habilitada, certificado válido) — quem quiser já pode configurar tudo agora em Configurações > Dados fiscais.
## 5. Pedidos com confirmação por vídeo
Se o seu pedido passou pela **confirmação por vídeo antes do envio** (o cliente confirma o produto numa chamada rápida antes do despacho), a emissão da nota fiscal só é liberada depois que essa chamada terminar — e a nota sai apenas com os itens que o cliente realmente confirmou, nunca com produtos recusados na call.
# Botão Mágico v4: novidades e manual completo
O Botão Mágico ganhou uma versão nova, mais rápida e mais completa: a **v4**. Continua sendo a mesma ferramenta simples de sempre — você manda fotos e uma descrição, a inteligência artificial faz o resto — mas agora com mais recursos e muito mais resistente a quedas de internet e fechamento acidental da aba.
## O que mudou por baixo dos panos
Antes, se você fechasse a aba ou a internet caísse no meio de uma geração, o trabalho se perdia. Agora não: assim que você clica em "Gerar com IA", o pedido já fica salvo no nosso sistema. Pode fechar a aba, trocar de rede, voltar depois — o resultado vai estar esperando por você (veja a seção **"Recuperar geração"** mais abaixo).
## Passo a passo: cadastrando um produto novo
1. **Conecte sua loja** — com email e senha do lojista, ou com o código de ativação (pra lojas cadastradas em massa que ainda não têm login).
2. **Envie até 3 fotos** do produto (câmera ou galeria) e escreva uma **descrição simples** em texto livre — pode escrever do seu jeito, sem formalidade.
3. **Descreva o estoque** em linguagem natural. Exemplo: *"Preto: P tem 5, M tem 8, G tem 3. Branco: P tem 2, M tem 4."*
4. Escolha quais fotos a IA deve gerar — **Produto em estúdio** (fundo liso), **Produto ambientalizado** (cenário) e/ou **Produto Modelo/Cenário** — e a **qualidade**: Rápida (padrão) ou Máxima fidelidade (mais cara, mais lenta, mais fiel aos detalhes).
5. Clique em **Gerar com IA**. Pode levar de 30 segundos a 2 minutos — a tela mostra o progresso, e como explicado acima, não tem problema sair da página nesse meio tempo.
## Revisando o resultado
Quando a geração termina, você cai na tela de revisão com tudo que a IA preparou: título, descrição, fotos, categoria, dados fiscais, variantes (cor/tamanho) com preço e estoque editáveis.
### Título e descrição editáveis
Clique diretamente no texto do título, da descrição curta ou da descrição completa — eles têm um ícone de lápis (✎) do lado indicando que são editáveis. O texto final que vai pro site é sempre o que estiver escrito ali na hora de finalizar, mesmo que você tenha corrigido algo que a IA errou.
### Categorias (mãe e subcategorias)
Um quadrante com todas as categorias do site aparece na revisão — a categoria mãe em negrito, com as subcategorias logo abaixo, indentadas. Marque quantas quiser: por exemplo, a categoria mãe *"Vestuário"* e a subcategoria específica *"Vestidos"* ao mesmo tempo. A IA já vem com um palpite pré-marcado, mas você decide o que fica.
Não encontrou a categoria certa pro seu produto? Tem um aviso na própria tela com um link direto pro nosso WhatsApp de suporte pra pedirmos a criação dela.
### Variantes: preço e estoque
Cada combinação (ex: Preto/P, Preto/M...) vira uma linha na tabela, com campos de **preço** e **estoque** editáveis diretamente ali. Se o produto tiver uma dimensão visual (Cor ou Material), aparece também um botão **"Gerar foto"** por valor — pra ter uma foto própria de cada cor, não só a foto genérica. Isso é cobrado à parte (ver tabela de preços abaixo). Se preferir não gastar crédito nisso, tem o botão **"Usar Gerada"**, que reaproveita a foto principal pra essa cor sem custo.
### Refazendo uma foto (retake)
Se uma das 3 fotos geradas não ficou boa, dá pra pedir um ajuste pontual escrevendo o que você quer mudar — sem precisar gerar tudo de novo. **O primeiro retake de cada geração é grátis** (já incluso no pacote); a partir do segundo, é cobrado à parte.
### Foto extra
Precisa de uma foto que as 3 padrão não cobrem — de costas, produto aberto, um detalhe do acabamento? Marque uma ou mais fotos já existentes como referência, escreva o que você quer, e a IA gera uma foto nova mantendo fidelidade ao produto. Pode pedir quantas quiser, e todas vão pra galeria do produto.
### Guia de tamanho
Digite as medidas por tamanho (a tabela sai sempre com os números exatos que você digitar — isso nunca passa pela IA) e, se quiser, anexe uma foto de referência pra sair também com um desenho técnico ilustrado da peça. Só a tabela é grátis; o desenho ilustrado é cobrado como uma foto extra.
### Vídeo
Com a foto de estúdio pronta, dá pra gerar um vídeo de vitrine (produto girando/em destaque) ou um vídeo UGC (com uma pessoa usando/mostrando o produto) — ótimo pra redes sociais.
## Finalizando
Quando estiver tudo do seu jeito, clique em **"✅ Finalizar e Cadastrar Produto"**. O produto é criado na hora, com todas as fotos, variantes, preços, estoque e categorias que você revisou.
## Editar produto existente (novidade)
Se você já cadastra produtos por outro caminho — ERP, planilha, ou digitando na mão — o Botão Mágico agora também serve pra **completar e atualizar** esses produtos, não só criar novos.
1. Na tela inicial, clique em **"📦 Editar produto existente"**.
2. Busque pelo nome ou SKU do produto.
3. Clique em **"Carregar"** no produto certo — ele abre na mesma tela de revisão de sempre, já preenchido com o que existe hoje (título, fotos, preço, estoque). Os campos que ainda faltam (descrição curta, dados fiscais) ficam em branco pra você completar.
4. Use os mesmos recursos de sempre: gere foto extra, foto de cor, ajuste preço e estoque, marque as categorias.
5. No lugar de "Finalizar", o botão agora é **"🔄 Atualizar Cadastro do Produto"** — clique nele pra salvar tudo em cima do produto que já existe. Não cria um produto duplicado.
*Importante: esse modo atualiza título, descrição, fotos, preço, estoque e dados fiscais das variantes que já existem — mas não cria nem remove variante (não dá pra adicionar um tamanho novo por aqui, por exemplo).*
## Recuperar geração
Fechou a aba sem querer, ou a internet caiu no meio de uma geração? Clique em **"🔄 Recuperar geração"** no topo da página — aparece a lista das suas últimas gerações, com status (na fila, gerando, pronto, falhou) e se já virou produto ou não. Clique em "Ver" pra retomar de onde parou.
## Crédito de IA e preços
Cada loja tem uma cota de gerações grátis por mês, de acordo com o plano. Depois de usar a cota, cada ação é descontada do **crédito de IA** (saldo pré-pago). O saldo atual e a cota restante aparecem no topo da página, assim que você conecta sua loja.