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:

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.