# Configuração fiscal e emissão de Nota Fiscal (NF-e)

A Saara Online está estruturando o suporte fiscal completo da plataforma: cada produto agora carrega os dados que a nota fiscal exige, e cada loja pode configurar sua própria emissão de NF-e — pelo sistema da Saara Online ou pelo sistema que você já usa hoje.

## 1. Novos campos fiscais dos produtos

Todo produto agora pode (e deve, antes de vender de verdade com nota fiscal) ter estes 4 campos preenchidos, por variante:

<table id="bkmrk-campoo-que-%C3%A9quem-pre"><tr><th>Campo</th><th>O que é</th><th>Quem preenche</th></tr><tr><td>**NCM**</td><td>Código de 8 dígitos que classifica a mercadoria (Nomenclatura Comum do Mercosul) — obrigatório em qualquer nota fiscal de produto.</td><td>Você (ou herdado do seu ERP/IA — veja abaixo)</td></tr><tr><td>**CEST**</td><td>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.</td><td>Você</td></tr><tr><td>**CST/CSOSN**</td><td>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.</td><td>Você (ou seu contador)</td></tr><tr><td>**Origem da mercadoria**</td><td>0 = nacional (padrão da maioria), outros códigos para produtos importados ou com conteúdo de importação.</td><td>Você (ou herdado do seu ERP/IA)</td></tr></table>

## 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 &gt; 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 &gt; 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:

<table id="bkmrk-op%C3%A7%C3%A3ocomo-funciona-e"><tr><th>Opção</th><th>Como funciona</th></tr><tr><td>**Emitir NF-e pelo sistema**</td><td>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.</td></tr><tr><td>**Enviar a nota que você já gerou**</td><td>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.</td></tr></table>

**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 &gt; 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.