Central de Ajuda Quaza Provedores

NFe — Nota Fiscal Eletrônica Modelo 55 (PT)

NFe — Nota Fiscal Eletrônica Modelo 55 — Quaza

NFe Brasil — Nota Fiscal Eletrônica modelo 55 (mercadoria)

Esta wiki cobre o módulo NFe do Quaza ponta a ponta: o que é, quando emitir (mercadoria, NÃO serviço/comunicação), como o XML 4.00 é montado, assinado e transmitido pra SEFAZ do estado, quais ações executar em cada nota, como cancelar, fazer Carta de Correção, processar manifestação do destinatário e ler erros. Audiência: equipe fiscal de provedores de internet que vendem equipamentos físicos — roteadores, ONUs, decoders, switches, antenas.

Resumo em uma linha: NFe modelo 55 é a nota fiscal para mercadoria (produto físico). Quaza monta o XML versão 4.00, assina com certificado A1 e transmite via SOAP pra SEFAZ do estado da empresa emissora — diferente da NFCom (SVRS centralizado) e da NFSe (SEFIN Nacional). Cada UF tem seu próprio webservice; quando a SEFAZ estadual cai, contingência SVRS/SVAN entra automaticamente. Para provedor, NFe sai principalmente quando vende equipamento ao cliente.
Nesta wiki:

Quando emitir NFe (e quando NÃO)

NFe modelo 55 cobre mercadoria — coisa física que sai do seu estoque e vai pro cliente. Para um provedor de internet, isso é menos frequente que outros documentos fiscais. Resumo de quando emitir cada:

Tipo de receita do provedor Documento correto Modelo
Internet, telefonia, TV (mensalidade) NFCom 62
Instalação, suporte, manutenção (mão de obra) NFSe —
Venda de equipamento (roteador, ONU, decoder, antena) NFe 55
Streaming, telefonia OTT, antivirus NFeSVA —
Devolução de equipamento (cliente cancelou e devolveu) NFe (entrada) 55 (CFOP 1xxx/2xxx)
NFe pode ser de saída ou entrada:
  • Saída (CFOP 5xxx dentro do estado, 6xxx fora): vendas, doações, brindes — equipamento sai do estoque do provedor.
  • Entrada (CFOP 1xxx dentro, 2xxx fora): devolução de cliente, retorno de comodato, importação. Equipamento volta pro estoque.

Fluxo geral — do espelho ao DANFE

CRON / VENDA AVULSA QUAZA (servidor) SEFAZ Estadual | | | | 1. Venda de equipamento | | |------------------------->| | | | 2. Cria NFe como ESPELHO | | | (situacao=90) | | | sem numero fiscal | | | | | OPERADOR (voce) | | |------------------------->| | | 3. Confere espelho | | 4. Clica "Gerar nota" | | |------------------------->| | | | 5. Promove a NFe oficial | | | -> numero sequencial | | | -> situacao = CRIADA(1) | | | | | 6. Clica "Processar" | | |------------------------->| | | | 7. Monta XML v4.00 | | | Valida contra XSD | | | Assina com cert A1 | | | Envia via SOAP | | |--------------------------->| | | | 8. SEFAZ valida | | | Devolve protocolo | | | cStat=100 (autorizado) | | | ou cStat erro | |<---------------------------| | | 9. situacao = TRANSMITIDA | | | depois PROTOCOLADA | | | | | 10. Imprimir DANFE | | | 11. Enviar ao cliente | | | (e-mail / WhatsApp) | |
Leia o diagrama: Espelho → Criada → Transmitida → Protocolada → DANFE. Cada SEFAZ tem seu webservice — quando a SEFAZ do estado cai, o Quaza fallback pra SVRS/SVAN (contingência) automaticamente.

Glossário

Termo O que é
NFe Nota Fiscal Eletrônica — documento fiscal de mercadoria emitido eletronicamente. Substituiu a Nota Fiscal modelo 1 (papel) em todo o Brasil desde ~2008.
Modelo 55 Código fiscal da NFe (mercadoria). Compare: 65=NFCe (consumidor final no varejo), 62=NFCom, 21/22=antigas notas de comunicação (depreciadas).
Espelho Versão preliminar da NFe, situação 90. Sem número fiscal, sem valor jurídico. Serve pra conferir antes de promover.
Chave de acesso Identificador único de 44 dígitos da NFe. Diferente da NFCom (também 44) — a estrutura interna é parecida mas com modelo diferente (55 vs 62).
CFOP Código Fiscal de Operações e Prestações. Família de 4 dígitos. 5xxx = saída dentro do estado, 6xxx = saída interestadual, 1xxx/2xxx = entrada. Ex: 5102=venda mercadoria dentro do estado, 6102=venda fora.
NCM Nomenclatura Comum do Mercosul — 8 dígitos que classificam o produto. Obrigatório na NFe. Ex: roteador wireless = 85176294, ONU = 85176294.
CST Código de Situação Tributária do ICMS — empresas de Lucro Real/Presumido. 2 dígitos. 00=tributada integralmente, 10=ST, 20=BC reduzida, 40=isenta, 50=suspensão, etc.
CSOSN Código de Situação da Operação do Simples Nacional — empresas optantes do Simples. 3 dígitos. 101=permite crédito, 102=não permite, 201/202=ST, etc.
CRT Código do Regime Tributário da empresa: 1=Simples Nacional (usa CSOSN), 2=Lucro Real, 3=Lucro Presumido (usa CST).
ICMS-ST Substituição Tributária do ICMS — quando o imposto é retido na fonte (geralmente pelo fabricante) e o revendedor não paga mais. Aplica-se a alguns equipamentos eletrônicos.
DIFAL Diferencial de Alíquota Interestadual — quando vende pra outro estado, diferença entre alíquota interna do destino e a interestadual. Devido nas vendas interestaduais a consumidor final não contribuinte.
FCP Fundo de Combate à Pobreza — adicional de até 4% sobre o ICMS, varia por estado e produto.
IPI Imposto sobre Produtos Industrializados — federal. Provedor revendedor de equipamento geralmente não calcula IPI (quem calcula é o fabricante/importador).
DANFE Documento Auxiliar da NFe — o PDF que vai pro cliente. Modelo padronizado nacional, com chave de acesso, QR Code, dados do emitente/destinatário, itens, totais, transportador.
Evento 110111 Cancelamento da NFe. Prazo: 24h depois da autorização.
Evento 110110 Carta de Correção Eletrônica (CCe). Corrige campos textuais não-fiscais. Prazo: 30 dias.
Manifestação do destinatário Eventos 210200 (confirmação), 210210 (ciência), 210220 (desconhecimento), 210240 (operação não realizada). O destinatário PJ pode/deve manifestar sobre NFes emitidas contra seu CNPJ.
SVRS / SVAN Sistemas Virtuais (RS, AN) — usados como contingência quando a SEFAZ do estado cai. Quaza usa automático quando primário falha.
Ambiente 1 = Produção (valor fiscal). 2 = Homologação (testes — não vale fiscalmente).

Configuração — pré-requisitos

Antes de emitir a primeira NFe configure a Empresa NFe. É lá que o Quaza decide UF/endpoint, regime tributário, certificado, ambiente.

Empresa NFe Fiscal → Empresa NFe

Tudo na mesma tela, em abas:

  • Dados gerais: CNPJ, razão social, IE (inscrição estadual), endereço, CNAE, UF (define qual SEFAZ usar), CEP.
  • CRT — Código do Regime Tributário: 1=Simples Nacional (usa CSOSN nos produtos), 2=Lucro Real, 3=Lucro Presumido (usam CST).
  • Certificado A1 (aba Certificado): upload do .pfx + senha. Vence anualmente — programe lembrete 30 dias antes.
  • Ambiente: Homologação pra testar; Produção só quando todo o ciclo (emissão+cancelamento+CCe) funcionar.
  • CSC (Código de Segurança do Contribuinte): obrigatório só pra NFCe (modelo 65) — modelo 55 não usa. Se o sistema pedir, deixe em branco ou conforme orientação do contador.
Série fiscal modelo 55 Fiscal → Série fiscal

Pelo menos uma série modelo 55 por ambiente (homologação e produção têm numerações separadas — não compartilhe). Em geral, série 1 pra produção e série 999 pra homologação é padrão de mercado.

Natureza de operação Fiscal → Natureza de operação

Configure ao menos:

  • 5102 — venda de mercadoria adquirida (dentro do estado).
  • 6102 — venda de mercadoria adquirida (fora do estado).
  • 1202 — devolução de venda (entrada, dentro estado).
  • 2202 — devolução de venda (entrada, fora do estado).
Produto fiscal + Equipamento Estoque → Produto fiscal / Equipamento

Cada equipamento revendido precisa de Produto fiscal cadastrado com:

  • NCM (8 dígitos) — classifica o produto pra Receita Federal.
  • EAN / GTIN — código de barras (se aplicável).
  • Unidade de medida (UN, PC, MT, etc).
  • Peso bruto e líquido — usado no transporte.
  • Situação tributária ICMS, IPI, PIS, COFINS — CST/CSOSN por tributo + alíquota.

O cadastro de Equipamento (ONU, roteador) referencia o Produto fiscal — ao vender, o Quaza puxa NCM/peso/tributação automaticamente.

Template de e-mail Comunicação → Templates → NFE_ENVIO

Usado pelo botão "Enviar e-mail". Sem template configurado, botão fica inerte.

Produto fiscal — linkagem com estoque

NFe é diferente de NFCom/NFSe porque cobre produto físico. Cada item da NFe precisa apontar pra um cadastro de produto com classificação fiscal completa. O Quaza encadeia: Equipamento (cadastro) → Produto (estoque) → Produto fiscal (tributação).

Tabela O que carrega
equipamento Cadastro técnico: serial, MAC, status, vinculação ao cliente. Tem idProduto.
produto Descrição comercial, NCM, EAN, unidade, peso, dimensões. Compartilhado entre vários equipamentos do mesmo modelo.
produtoIcms / produtoIpi / produtoPis / produtoCofins Situação tributária + alíquota por tributo. Em geral 1 row por produto por tributo.
Quando você vende 1 roteador: Quaza acha o equipamento (pelo serial) → puxa o idProduto → puxa NCM/peso/medida → puxa situação tributária ICMS/IPI/PIS/COFINS → calcula valor dos impostos → preenche o item da NFe. Tudo automático se o cadastro estiver bem feito.

Tela de NFe — listagem e detalhe

Duas telas que trabalham juntas: listagem + detalhe. Navega-se da listagem pro detalhe pelo ícone da coluna de editar (lápis).

Listagem

Fiscal → NFe

Lista todas as NFes (espelhos, criadas, transmitidas, protocoladas, rejeitadas, canceladas, inutilizadas) com filtros por período, situação, cliente, série, ambiente.

Listagem de NFe

Listagem de NFe — a coluna marcada em vermelho tem o ícone de editar (lápis): clica nele pra abrir o detalhe da nota. A coluna anterior, da impressora, baixa o DANFE direto.

Coluna O que mostra
Número Número fiscal sequencial da série. Vazio nos espelhos.
Cliente / Destinatário Quem recebe a mercadoria. Link abre o cadastro.
Valor Soma dos itens.
Emissão Data de emissão.
Natureza CFOP+descrição (ex: "5102 — Venda mercadoria adquirida").
Situação Espelho / Criada / Transmitida / Protocolada / Rejeitada / Cancelada / Inutilizada.

Detalhe / formulário

Fiscal → NFe → [clicar no ícone da coluna Editar]

Onde você confere/edita os dados antes de transmitir, e de onde dispara todas as ações.

Formulário da NFe

Formulário de edição da NFe — cabeçalho (cliente, natureza, série), itens (com NCM/CFOP/CST e tributos), totalizadores, transporte, cobrança, pagamento.

Estados da nota e transições

Código Nome O que significa Próxima ação possível
90 Espelho Importada de fora ou rascunho. Sem número fiscal. Gerar nota → vira Criada.
1 Criada Promovida do espelho. Tem número fiscal. Não transmitida ainda. Processar → vira Transmitida.
2 Transmitida XML enviado à SEFAZ. Aguardando autorização. Consultar → quando autorizada, vira Protocolada.
3 Protocolada Autorizada pela SEFAZ. Tem nProt (número de protocolo). Valor fiscal. Imprimir DANFE, enviar ao cliente. Cancelar (24h). CCe (30 dias).
4 Rejeitada SEFAZ devolveu erro (cStat 4xx-5xx-6xx). Corrigir e retransmitir.
5 Inutilizada Número de NFe queimado (corrige pulo de numeração). Estado terminal.
99 Cancelada Cancelamento aceito (evento 110111). Estado terminal.
Diferenças de prazo:
  • Cancelamento (110111): até 24h da autorização.
  • Carta de Correção (110110): até 30 dias da autorização. Só corrige campos textuais — não corrige valor, quantidade, destinatário, série, número, data.
  • Inutilização: até o 30º dia útil do mês seguinte — só pra números nunca usados (pulo de numeração).

Anatomia do XML 4.00

NFe versão atual: 4.00, namespace http://www.portalfiscal.inf.br/nfe. Quaza usa a lib NFePHP/sped-nfe pra montar, assinar e transmitir.

<NFe xmlns="http://www.portalfiscal.inf.br/nfe">
<infNFe Id="NFe43260512345..." versao="4.00">
<ide>
<cUF>43</cUF>                              # codigo IBGE da UF do emitente
<natOp>Venda de mercadoria</natOp>
<mod>55</mod>                              # modelo fiscal (55 = NFe)
<serie>1</serie>
<nNF>12345</nNF>
<dhEmi>2026-05-12T10:00:00-03:00</dhEmi>
<tpNF>1</tpNF>                            # 0=entrada, 1=saida
<idDest>1</idDest>                          # 1=interna, 2=interestadual, 3=exterior
<cMunFG>4310902</cMunFG>                    # municipio fato gerador
<tpAmb>1</tpAmb>                            # 1=Producao, 2=Homologacao
<finNFe>1</finNFe>                          # 1=normal, 2=complementar, 3=ajuste, 4=devolucao
</ide>
<emit>                                       # EMITENTE (sua empresa)
<CNPJ>12345678000100</CNPJ>
<xNome>Empresa Exemplo LTDA</xNome>
<enderEmit>...</enderEmit>
<IE>1234567890</IE>
<CRT>1</CRT>                              # 1=Simples Nacional, 2=Lucro Real, 3=Presumido
</emit>
<dest>                                       # DESTINATARIO (cliente)
<CPF>12345678901</CPF>                   # ou CNPJ se PJ
<xNome>Cliente Exemplo</xNome>
<enderDest>...</enderDest>
<indIEDest>9</indIEDest>                  # 1=contribuinte, 2=isento, 9=nao contribuinte
</dest>
<det nItem="1">
<prod>
<cProd>ROUTER-AC1200</cProd>
<cEAN>7891234567890</cEAN>            # codigo de barras
<xProd>Roteador Wi-Fi AC1200</xProd>
<NCM>85176294</NCM>                   # classificacao Mercosul
<CFOP>5102</CFOP>                    # 5xxx=saida intra, 6xxx=saida inter
<uCom>UN</uCom>
<qCom>1.0000</qCom>
<vUnCom>299.90</vUnCom>
<vProd>299.90</vProd>
</prod>
<imposto>
<ICMS>                              # ou ICMSSN se Simples Nacional
<ICMS00>                        # CST 00 = tributada integralmente
<orig>0</orig>              # 0=nacional, 1=importada direta, 2=importada mercado interno
<CST>00</CST>
<modBC>3</modBC>             # base calculo
<vBC>299.90</vBC>
<pICMS>17.00</pICMS>
<vICMS>50.98</vICMS>
</ICMS00>
</ICMS>
<IPI>...</IPI>                       # geralmente CST 99 = outras (provedor revendedor)
<PIS>...</PIS>
<COFINS>...</COFINS>
</imposto>
</det>
<total>
<ICMSTot>
<vBC>299.90</vBC>
<vICMS>50.98</vICMS>
<vProd>299.90</vProd>
<vNF>299.90</vNF>                   # valor total da nota
</ICMSTot>
</total>
<transp>                                    # TRANSPORTE
<modFrete>9</modFrete>                  # 0=emitente, 1=destinatario, 9=sem transporte
</transp>
<pag>                                       # PAGAMENTO
<detPag>
<tPag>01</tPag>                     # 01=dinheiro, 03=cartao, 17=pix, 99=outros
<vPag>299.90</vPag>
</detPag>
</pag>
</infNFe>
<Signature>...</Signature>                  # assinatura digital A1
</NFe>
Campos que mais geram rejeição:
  • ide/cUF e ide/cMunFG — UF e código IBGE precisam estar consistentes.
  • ide/idDest — 1/2/3 conforme operação interna/interestadual/exterior. Errar derruba CFOP.
  • emit/CRT — regime do emitente; Simples usa CSOSN, Lucro Real/Presumido usa CST. Trocar = rejeição.
  • dest/CPF ou CNPJ + indIEDest — coerência cliente PF/PJ/contribuinte. Cliente PJ sem IE = indIEDest=2 (isento).
  • det/prod/NCM — 8 dígitos válidos da tabela TIPI. NCM errado = rejeição 778.
  • det/prod/CFOP — bate com idDest: 5xxx só pra intra, 6xxx só pra inter.
  • imposto/ICMS/CST — bate com CRT da empresa: empresa Simples não pode mandar CST de Lucro Real e vice-versa.

Tela de adicionar/editar — barra de ações

A tela de edição da NFe mostra o painel lateral fixo à direita — a caixa-maneira, mesma barra que aparece em NFCom e NFSe .

Botões contextuais: nem todos aparecem sempre. Cada um tem condição de exibição baseada na situação da nota — ex: Cancelar só em Protocolada; Gerar nota só em Espelho; CCe só em Protocolada.
caixa-maneira NFe anotada

Barra caixa-maneira em NFe Protocolada — botões visíveis numerados. Os botões que dependem de outras situações (Processar, Gerar nota) não aparecem aqui; veja a tabela abaixo.

Botões da caixa-maneira

# Botão Quando aparece O que faz
1 Imprimir DANFE Protocolada (3) ou Transmitida (2) Gera o PDF (DANFE) com QR Code. Abre em nova aba.
2 Ver XML Após transmissão (XML existe) Abre o XML assinado em nova aba. Útil pra debug e entregar ao contador.
3 Ver XML Cancelamento Cancelada (99) Mostra o XML do evento de cancelamento (não o XML original).
4 Processar Criada (1), Transmitida (2) ou Rejeitada (4) Monta XML, valida XSD, assina A1, transmite ao SEFAZ. Também consulta protocolo quando já transmitiu. Vira Transmitida → Protocolada ou Rejeitada.
5 Consultar Tem chave de acesso Pergunta à SEFAZ "esta NFe já foi autorizada?". Útil quando a transmissão deu timeout.
6 Gerar de Espelho Espelho (90) Promove o espelho a NFe oficial — recebe número, vira Criada (1).
7 Cancelar Protocolada (3) ou Espelho (90), em até 24h Em Protocolada: dispara evento 110111 com justificativa (mín. 15 chars). Em Espelho: descarta o rascunho.
8 Carta de Correção (CCe) Protocolada + cliente vinculado, em até 30 dias Dispara evento 110110 com texto da correção (mín. 15 chars). Só pra ajustes textuais — não corrige valor, quantidade, destinatário.
9 Enviar por e-mail Protocolada + cliente vinculado Envia DANFE pro e-mail do cliente (template NFE_ENVIO).
10 Enviar por WhatsApp Protocolada + cliente vinculado Abre web.whatsapp.com com mensagem + link do DANFE.
Inutilização não está na caixa-maneira: é uma rotina separada em Fiscal → NFe → Inutilização. Usa-se quando há salto de numeração (gerou número 1, 2, 4 — pulou 3). A inutilização "queima" o número 3 oficialmente.

DANFE — o PDF

O DANFE (Documento Auxiliar da NFe) é o PDF gerado após autorização. Não é a nota fiscal — a nota é o XML. O DANFE é representação visual com QR Code que permite consultar o XML no portal nacional.

Característica Detalhe
Pré-requisito NFe Transmitida (2) ou Protocolada (3).
Geração Lib NFePHP/sped-da gera o PDF a partir do XML autorizado.
Conteúdo Chave de acesso, emitente, destinatário, itens (NCM/CFOP/qtde/valor/tributos), totais, transportador, dados adicionais, QR Code.
Layout Padrão nacional definido pelo MOC (Manual de Orientação ao Contribuinte) — Retrato ou Paisagem conforme nº de itens.
Distribuição E-mail (NFE_ENVIO), WhatsApp ou portal do cliente.

Cancelamento e CCe

Cancelamento — Evento 110111 (24h)

NFe Protocolada pode ser cancelada em até 24h da autorização. Quaza envia um evento (não outra NFe) com tipo 110111, justificativa mínima 15 caracteres.

cStat retornado O que significa
135 Evento aceito. NFe passa pra Cancelada (99).
136 Aceito mas não vinculado (raro).
501 Prazo vencido — passou de 24h, não cancela mais.
573 Duplicidade — já cancelado.
Passou de 24h? Não cancela. Opções:
  1. NFe de devolução — emite NFe de entrada (CFOP 1202/2202) com referência à NFe original, anulando o efeito fiscal.
  2. Substituição — emite nova NFe complementar (finalidade=4) com ajuste; depende da natureza do erro.
  3. Processo administrativo na SEFAZ — em casos extremos, pode demorar semanas.

Carta de Correção (CCe) — Evento 110110 (30 dias)

Permite corrigir campos textuais não-fiscais em até 30 dias da autorização. Quaza envia evento 110110 com texto da correção (mín. 15 chars).

O que pode corrigir O que NÃO pode corrigir
Informações complementares Valor / quantidade dos itens
Endereço (algumas SEFAZ permitem) CFOP que mude alíquota ou tipo de operação
Descrição do produto (textual) Destinatário (CNPJ/CPF)
Dados de transporte Número, série, data de emissão
Natureza da operação (algumas) Tributação (CST/ICMS/IPI/PIS/COFINS)
Limite de CCes: SEFAZ aceita até 20 cartas de correção por NFe. Acima disso, rejeita.

Manifestação do destinatário

Quando alguém emite NFe contra o CNPJ da sua empresa (como destinatário PJ), você pode/deve manifestar dizendo o que aconteceu. Eventos:

Código Evento Quando usar
210200 Confirmação da Operação Você recebeu a mercadoria conforme a NFe. Manifestação positiva.
210210 Ciência da Emissão Tomou ciência. Cuidado: dar ciência e não manifestar depois pode gerar penalidade.
210220 Desconhecimento da Operação NFe emitida indevidamente — você nunca contratou nem recebeu.
210240 Operação não Realizada Contratou mas a entrega não aconteceu (cliente cancelou, transportador devolveu).

No Quaza, a manifestação aparece em Fiscal → NFe → Manifestação — lista as NFes emitidas contra seu CNPJ que aguardam manifestação.

Endpoints SEFAZ por UF

Cada estado tem seu próprio webservice SEFAZ pra NFe modelo 55. Quaza decide automaticamente baseado na UF da empresa emissora. Não configure URL — só configure a UF e o ambiente.

Estado Autorizador principal Contingência (fallback)
SP, MG, PR, RS, BA, GO, MS, MT, CE, PE, AC, AM SEFAZ própria do estado SVRS / SVAN
MA SVAN (Sistema Virtual do Ambiente Nacional) SVRS
AL, AP, DF, ES, PA, PB, PI, RJ, RN, RO, RR, SC, SE, TO SVRS (Sistema Virtual da Receita Estadual RS) SVAN

Quando a SEFAZ primária do estado fica fora (status 108/109), o Quaza pode comutar pra contingência automaticamente (configurável). Operações suportadas: Autorizacao, Consulta, StatusServico, Inutilizacao, RecepcaoEvento, ConsultaCadastro.

Tributos calculados

NFe é a mais complexa das notas em tributação. Quaza calcula tudo a partir do Produto fiscal + CRT da empresa + UF do destinatário.

Tributo O que é Quem paga
ICMS Estadual sobre circulação de mercadoria. Alíquota varia por UF (geralmente 17-19% internas; 7-12% interestaduais). Emitente (regra geral)
ICMS-ST Substituição Tributária — ICMS já recolhido pelo fabricante/importador. Revendedor não paga de novo (aplicado em alguns produtos eletrônicos). Substituto tributário
DIFAL Diferencial de Alíquota — diferença entre alíquota interna do destino e a interestadual, em vendas interestaduais a consumidor final. Emitente recolhe DIFAL
FCP Fundo de Combate à Pobreza — adicional ICMS de 1-4% (varia por UF), em alguns produtos. Emitente
IPI Imposto sobre Produtos Industrializados (federal). Em geral só fabricante/importador calcula; revendedor lança CST 99 (outras). Fabricante / Importador
PIS Federal — alíquota 0,65% (cumulativo) ou 1,65% (não-cumulativo). Emitente
COFINS Federal — alíquota 3% (cumulativo) ou 7,6% (não-cumulativo). Emitente
Empresas Simples Nacional: ICMS sai pelo DAS. No XML, marca CRT=1 e usa ICMSSN (em vez de ICMS) com CSOSN (101, 102, 201, 202...). Alíquota efetiva do Simples é determinada pela faixa de receita do anexo I/II.

De onde vêm os dados

Campo da NFe Origem
Emitente (CNPJ, IE, endereço, CRT) Empresa NFe
Destinatário (cliente, CPF/CNPJ, endereço) Cadastro do cliente
Itens (cProd, xProd, qtde, valor) Equipamento / Produto
NCM, EAN, unidade, peso Produto fiscal
CFOP Natureza de operação (Fiscal → Natureza)
CST/CSOSN, alíquotas ICMS/IPI/PIS/COFINS Situação tributária do produto fiscal
Série + numeração Fiscal → Série fiscal modelo 55
Certificado, ambiente Empresa NFe → aba Certificado
Transportador, peso, modalidade frete Itens + cadastro de transporte (se houver)
Forma de pagamento Vínculo com a venda/cobrança

Como ler erros e debugar

Onde achar a mensagem de erro

  1. Abra a NFe Rejeitada (situação 4).
  2. Aba "Retorno SEFAZ" mostra cStat + xMotivo (texto do erro vindo da SEFAZ).
  3. Botão Ver XML mostra o XML enviado — confira o campo apontado.

Códigos cStat mais comuns na NFe

cStat Mensagem típica Causa provável
100 Autorizado o uso da NFe Sucesso.
108 Serviço paralisado momentaneamente SEFAZ em manutenção. Aguardar.
110 Uso denegado Destinatário com problemas fiscais — SEFAZ não autoriza emitir contra ele.
135 Evento registrado e vinculado a NFe Cancelamento/CCe aceito.
204 Duplicidade de NFe Transmitiu a mesma chave 2x. Use Consultar.
225 Falha no Schema XML XML não bate com XSD 4.00. Atualize lib.
226 Código UF emitente diverge do CNPJ cUF na ide não bate com a UF na IE do emitente.
231 CPF/CNPJ do destinatário inválido Documento do cliente com dígito errado.
233 IE do destinatário não consta no SINTEGRA Cliente PJ com IE não cadastrada na UF dele. Pode ser baixa, suspensão.
539 Duplicidade de número Outro número da série foi reusado.
539 (variante) Rejeição: número já consta na base Inutilize o conflitante ou ajuste numeração.
597 Rejeição: NFe com data emissão atrasada NFe com dhEmi mais de 30 dias atrás.
610 NCM informado não consta na tabela TIPI NCM inválido — confira o cadastro do produto fiscal.
778 NCM informado é inválido Mesma causa do 610.
805 Certificado expirado Renove o A1.

Pegadinhas frequentes

1. CFOP errado por UF. Vender pra cliente em outra UF e usar CFOP 5102 (intra) ao invés de 6102 (inter) = rejeição. O Quaza pega CFOP da Natureza de operação — verifica se ela tá certa antes de transmitir.
2. NCM inválido. Lista TIPI muda periodicamente. NCM removido = rejeição 610/778. Mantenha cadastro de produtos atualizado.
3. CST × CSOSN trocados. Empresa Lucro Real usa CST (00, 10, 20...). Simples Nacional usa CSOSN (101, 102...). Trocar = rejeição imediata. Configure no Produto fiscal conforme o CRT da empresa.
4. Cancelamento expira em 24h. Diferente da NFCom (também 24h) e NFSe Nacional (sem prazo). Filtro útil: "Protocoladas emitidas ontem".
5. CCe ≠ cancelamento. CCe corrige texto, não valor. Não tente corrigir valor errado com CCe — não vai funcionar.
6. ICMS-ST vai gerar dúvida. Equipamento de redes pode ser ST em alguns estados, e o revendedor não deve recalcular. Se duvidar, consulte o contador antes de mudar tributação do produto.
7. DIFAL em vendas interestaduais a consumidor final. Vendendo equipamento pra cliente PF em outra UF, o Quaza calcula DIFAL automático. Confirme com contador a partilha vigente (varia por ano).
8. Cliente PJ sem IE = ISENTO. No campo dest/IE, use literalmente ISENTO (não vazio). E indIEDest=2. Errar = cStat 233.
9. Inutilização ≠ Cancelamento. Inutilização "queima" número não usado (pulo de numeração). Cancelamento anula nota emitida. Confundir gera problema com contador.
10. Manifestação do destinatário — não ignore. Se sua empresa recebe NFe (compra equipamento), manifeste em até 180 dias (210220 desconhecimento) ou 30 dias (210200 confirmação). Não manifestar pode gerar problema fiscal.

FAQ

Quando emitir NFe versus NFCom/NFSe?

NFe = produto físico (equipamento). NFCom = serviço de comunicação (internet, telefonia). NFSe = serviço (instalação, suporte, manutenção). Um provedor emite os três conforme o tipo de receita.

Posso emitir NFe sem CFOP cadastrado?

Não. CFOP vem da Natureza de operação. Configure ao menos 5102/6102 (venda intra/inter) e 1202/2202 (devolução intra/inter).

Cliente perdeu o e-mail com a NFe — como reenvio?

Abra a NFe e clique Enviar e-mail de novo. Usa o template NFE_ENVIO e envia pro e-mail atual do cliente.

NFe rejeitada com cStat 233 (IE não consta no SINTEGRA) — o que faço?

O cliente PJ tem IE que não está ativa na UF dele. Opções: (1) confirmar com o cliente que a IE está correta e ativa; (2) se realmente está suspensa/baixada, usar indIEDest=2 (isento) e IE=ISENTO; (3) se a IE é válida mas SINTEGRA está desatualizado, esperar atualização e retransmitir.

Cancelei depois de 24h — e agora?

Não cancela mais. Emita NFe de devolução (entrada, CFOP 1202/2202) com referência à NFe original — anula o efeito fiscal. Confirme com seu contador antes.

Empresa Simples Nacional emite NFe?

Sim. Configura CRT=1 na Empresa NFe. ICMS sai pelo DAS, mas o XML continua sendo emitido (com CSOSN nos itens).

Posso emitir NFe de teste?

Sim — configure ambiente Homologação (2). Notas em homologação não têm valor fiscal mas todo o ciclo (XML, assinatura, transmissão, DANFE) funciona idêntico. Use pra treinar a equipe.

O QR Code do DANFE não funciona — o que pode ser?

QR Code aponta pra URL pública da SEFAZ pra consulta. Se não funciona: (1) NFe foi cancelada e SEFAZ removeu; (2) emissão em homologação (QR aponta pra ambiente de homologação, vazio); (3) bug no leitor de QR.

Como saber se o cliente já manifestou minha NFe?

Em Fiscal → NFe → [a NFe] → aba Eventos aparecem os eventos retornados pela SEFAZ — incluindo manifestações 210xxx do destinatário.

Posso editar NFe depois de Protocolada?

Não. Estado fiscal definitivo. Se errou: cancela (24h), CCe (30 dias só texto), devolução (NFe de entrada) ou substituição (NFe complementar). Confirma com contador qual aplica.

Quanto tempo guardar o XML da NFe?

Mínimo 5 anos a partir do 1º dia do ano seguinte à emissão (prazo da Receita). Quaza guarda no disco (storage/) — não apague essa pasta sem backup.

Documentos relacionados