Emitir sua primeira NF-e em homologação

Você chegou no momento mais importante do onboarding: emitir uma NF-e do zero. Como estamos em homologação, dá pra errar à vontade — vamos emitir uma nota de teste pra você ver o fluxo completo funcionando.

Pré-requisitos: licença ativada (passo 1), conta criada (passo 2), emitente cadastrado (passo 3), certificado A1 importado (passo 4) e ambiente confirmado como HOMOLOGAÇÃO (passo 5). Se algum desses não estiver pronto, volte e termine antes.

O que precisamos antes

Pra emitir uma nota, o programa precisa de:

Emitente ✅ (você cadastrou no passo 3)
Produto — vamos cadastrar 1 produto fictício agora
Cliente (destinatário) — vamos usar 1 cliente fictício

Como é homologação, a Receita até recomenda usar dados fictícios.

Cadastre um produto de teste rápido

Vá em Menu lateralCadastrosProdutos e clique em Novo produto (atalho Ctrl+N).

Preencha com dados simples:

Descriçãoobrig. → "Produto teste"
NCMobrig. → 61091000 (camiseta de algodão)
CFOPobrig. → 5102 (venda dentro do estado)
Unidadeobrig. → UN
Valor unitárioobrig. → 10,00
Origemobrig. → 0 - Nacional

Salve com Ctrl+S. Não se preocupe se algo estiver "errado" — em homologação não importa.

NCM 61091000 é genérico de vestuário. Se sua empresa vende outra coisa, qualquer NCM válido serve pra teste — só não pode inventar.

Cadastre um cliente de teste

Vá em Menu lateralCadastrosContatos e clique em Novo contato.

Preencha:

Tipoobrig. → Pessoa Física
Nomeobrig. → "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL"
CPFobrig. → 99999999999 (não precisa ser CPF real em homologação)
CEPobrig. → o do seu emitente (qualquer válido)
Endereço → pode usar o mesmo do emitente

Salve.

Por que o nome estranho? Esse texto exato é obrigatório por lei no campo de destinatário de notas em homologação. Sem ele, a SEFAZ rejeita a nota. Em produção (real), você usa o nome verdadeiro do cliente.

Emita a NF-e

Volte ao dashboard e clique em + Nova nota no canto superior direito (atalho Ctrl+N).

Você é levado à tela de emissão. Selecione:

Tipo de operaçãoobrig. → Venda
Destinatárioobrig. → "NF-E EMITIDA..." (o que você acabou de cadastrar)
Modeloobrig. → NF-e (55)

Tela inicial de emissão de NF-e — modo simples

Adicione o produto à nota

Na seção Itens, clique em + Adicionar item. Selecione "Produto teste" da lista. Defina:

Quantidadeobrig. → 1
Valor unitárioobrig. → já vem 10,00 do cadastro

O total da nota fica em R$ 10,00 automático.

Revise e envie pra SEFAZ

No pé da tela, clique em Emitir nota. O programa:

Valida todos os campos (~1 segundo)
Assina a nota com seu certificado A1 (~1 segundo)
Envia pra SEFAZ (~3 a 8 segundos)
Aguarda resposta de autorização (~1 a 5 segundos)

Total: até 15 segundos.

Veja a nota autorizada

Se tudo deu certo, aparece o card verde:

✅ NF-e autorizada Protocolo: 142250000... (número longo da SEFAZ) Número: 1 — Série: 1

Você acabou de emitir sua primeira NF-e! 🎉

Card de confirmação — nota autorizada pela SEFAZ

A nota agora aparece em Menu lateralNotas emitidas. Clique nela pra ver detalhes, baixar DANFE em PDF ou XML.

E se deu erro?

Se a SEFAZ rejeitou (mensagem vermelha em vez de verde), procure o código da rejeição (ex: Rejeição 539). Cada código tem um motivo específico.

Veja o tutorial Erros comuns da SEFAZ com os 10 mais frequentes e como resolver.

Erros típicos da primeira vez:

539 — CFOP incompatível com operação. Verifique se o CFOP do produto bate com a UF do destinatário.
778 — NCM inválido. Confirme o código (8 dígitos, sem ponto).
227 — IE de emitente irregular. Confira inscrição estadual do emitente.

E agora? Quando mudar pra produção?

Antes de mudar pra produção, faça mais 2 ou 3 testes em homologação variando situações:

Nota com mais de 1 item
Nota com cliente Pessoa Jurídica (CNPJ)
Nota cancelada (cancele a nota teste — vai aprender o fluxo)

Quando se sentir confortável, siga o tutorial de mudança de ambiente.

Próximos passos

Você completou os Primeiros Passos! 🎉

Daqui pra frente, explore por interesse:

Cadastros — produtos, clientes em massa via CSV
Emissão — modos avançados, NFC-e, cancelamento, CC-e
Operações — DANFE, XML, backup de dados