Central de Ajuda Quaza Provedores

NFe — Nota Fiscal Electrónica Modelo 55 (ES-PY)

NFe — Nota Fiscal Electrónica Modelo 55 — Quaza

NFe Brasil — Nota Fiscal Electrónica modelo 55 (mercancía)

Esta wiki cubre el módulo NFe de Quaza de punta a punta: qué es, cuándo emitir (mercancía, NO servicio/comunicación), cómo se arma el XML 4.00, se firma y se transmite a la SEFAZ del estado, qué acciones ejecutar en cada nota, cómo cancelar, hacer Carta de Corrección, procesar manifestación del destinatario y leer errores. Audiencia: equipo fiscal de proveedores de internet que venden equipos físicos — routers, ONUs, decoders, switches, antenas. Atención: NFe es documento fiscal de Brasil — si tu empresa solo opera en Paraguay o Argentina, esta wiki es referencia/contexto.

Resumen en una línea: NFe modelo 55 es la nota fiscal para mercancía (producto físico) en Brasil. Quaza arma el XML versión 4.00, lo firma con certificado A1 y lo transmite vía SOAP a la SEFAZ del estado de la empresa emisora — distinto de NFCom (SVRS centralizado) y NFSe (SEFIN Nacional). Cada UF tiene su propio webservice; cuando la SEFAZ estadual cae, la contingencia SVRS/SVAN entra automáticamente. Para proveedor, NFe sale principalmente al vender equipo al cliente.
En esta wiki:

Cuándo emitir NFe (y cuándo NO)

NFe modelo 55 cobre mercancía — coisa física que sai do seu stock e vai pro cliente. Para um provedor de internet, isso es menos frecuente que outros documentos fiscais. Resumen de cuando 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 equipo (router, ONU, decoder, antena) NFe 55
Streaming, telefonia OTT, antivirus NFeSVA —
Devolución de equipo (cliente cancelou e devolveu) NFe (entrada) 55 (CFOP 1xxx/2xxx)
NFe pode ser de saída ou entrada:
  • Saída (CFOP 5xxx dentro del estado, 6xxx fora): ventas, doações, brindes — equipo sai do stock do provedor.
  • Entrada (CFOP 1xxx dentro, 2xxx fora): devolución de cliente, retorno de comodato, importação. Equipo volta pro stock.

Flujo general — del espejo al DANFE

CRON / VENDA AVULSA QUAZA (servidor) SEFAZ Estadual | | | | 1. Venda de equipo | | |------------------------->| | | | 2. Cria NFe como ESPELHO | | | (situacao=90) | | | sem numero fiscal | | | | | OPERADOR (voce) | | |------------------------->| | | 3. Confere espejo | | 4. Clica "Generar nota" | | |------------------------->| | | | 5. Promove a NFe oficial | | | -> numero sequencial | | | -> situacao = CRIADA(1) | | | | | 6. Clica "Procesar" | | |------------------------->| | | | 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: Espejo → Creada → Transmitida → Protocolada → DANFE. Cada SEFAZ tiene seu webservice — cuando a SEFAZ del estado cai, o Quaza fallback pra SVRS/SVAN (contingencia) automáticamente.

Glosario

Termo O que é
NFe Nota Fiscal Eletrônica — documento fiscal de mercancía emitido eletronicamente. Substituiu a Nota Fiscal modelo 1 (papel) em todo o Brasil desde ~2008.
Modelo 55 Código fiscal da NFe (mercancía). Compare: 65=NFCe (consumidor final no varejo), 62=NFCom, 21/22=antigas notas de comunicación (depreciadas).
Espejo Verson 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 (también 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 del estado, 6xxx = saída interestadual, 1xxx/2xxx = entrada. Ex: 5102=venta mercancía dentro del estado, 6102=venta fora.
NCM Nomenclatura Comum do Mercosul — 8 dígitos que classificam o produto. Obrigatório na NFe. Ex: router 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=suspenson, etc.
CSOSN Código de Situação da Operação do Síples Nacional — empresas optantes do Síples. 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=Síples Nacional (usa CSOSN), 2=Lucro Real, 3=Lucro Presumido (usa CST).
ICMS-ST Substituição Tributária do ICMS — cuando o imposto é retido na fonte (generalmente pelo fabricante) e o revendedor não paga mais. Aplica-se a alguns equipos eletrônicos.
DIFAL Diferencial de Alíquota Interestadual — cuando vende pra outro estado, diferença entre alícuota interna do destino e a interestadual. Devido nas ventas 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 equipo generalmente não calcula IPI (quem calcula é o fabricante/importador).
DANFE Documento Auxiliar da NFe — o PDF que vai pro cliente. Modelo padronizado nacional, com llave de acceso, QR Code, dados do emisor/destinatario, itens, totais, transportador.
Evento 110111 Cancelación da NFe. Prazo: 24h depois da autorización.
Evento 110110 Carta de Corrección Eletrônica (CCe). Corrige campos textuales não-fiscais. Prazo: 30 dias.
Manifestación del destinatario Eventos 210200 (confirmação), 210210 (ciência), 210220 (desconhecimento), 210240 (operação não realizada). O destinatario PJ pode/deve manifestar sobre NFes emitidas contra seu CNPJ.
SVRS / SVAN Sistieneas Virtuais (RS, AN) — usados como contingencia cuando a SEFAZ del estado cai. Quaza usa automático cuando primário falha.
Ambiente 1 = Producción (valor fiscal). 2 = Homologación (testes — não vale fiscalmente).

Configuración — prerrequisitos

Antes de emitir a primeira NFe configurá a Empresa NFe. Es allí que Quaza decide UF/endpoint, régimen tributario, certificado, ambiente.

Empresa NFe Fiscal → Empresa NFe

Todo en la misma pantalla, en pestañas:

  • Datos generales: CNPJ, razão social, IE (inscripción estadual), dirección, CNAE, UF (define qual SEFAZ usar), CEP.
  • CRT — Código do Regime Tributário: 1=Síples 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: Homologación pra testar; Producción só cuando todo o ciclo (emisión+cancelación+CCe) funcionar.
  • CSC (Código de Segurança do Contribuinte): obrigatório só pra NFCe (modelo 65) — modelo 55 não usa. Se o sistienea 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 (homologación e producción tienen numerações separadas — não compartilhe). Em general, série 1 pra producción e série 999 pra homologación é padrão de mercado.

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

Configure ao menos:

  • 5102 — venta de mercancía adquirida (dentro del estado).
  • 6102 — venta de mercancía adquirida (fora del estado).
  • 1202 — devolución de venta (entrada, dentro estado).
  • 2202 — devolución de venta (entrada, fora del estado).
Producto fiscal + Equipo Stock → Producto fiscal / Equipo

Cada equipo revendido necesita de Producto 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ícuota.

O cadastro de Equipo (ONU, router) referencia o Producto fiscal — ao vender, o Quaza puxa NCM/peso/tributación automáticamente.

Template de e-mail Comunicación → Templates → NFE_ENVIO

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

Producto fiscal — vínculo con stock

NFe é diferente de NFCom/NFSe porque cobre producto físico. Cada itiene da NFe necesita apontar pra um cadastro de produto com classificação fiscal completa. O Quaza encadeia: Equipo (cadastro) → Produto (stock) → Producto fiscal (tributación).

Tabela O que carrega
equipo 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 equipos do mesmo modelo.
produtoIcms / produtoIpi / produtoPis / produtoCofins Situação tributária + alícuota por tributo. Em general 1 row por produto por tributo.
Cuándo vos vende 1 router: Quaza acha o equipo (pelo serial) → puxa o idProduto → puxa NCM/peso/medida → puxa situação tributária ICMS/IPI/PIS/COFINS → calcula valor dos impostos → preenche o itiene da NFe. Tudo automático se o cadastro estiver bem feito.

Pantalla de NFe — listado y detalle

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

Listagem

Fiscal → NFe

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

Listagem de NFe

Listagem de NFe — a coluna marcada em vermelho tiene o ícone de editar (lápis): clica nele pra abrir o detalle 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 espejos.
Cliente / Destinatario Quem recebe a mercancía. Link abre o cadastro.
Valor Soma dos itens.
Emisión Data de emisión.
Natureza CFOP+descrição (ex: "5102 — Venda mercancía adquirida").
Situação Espejo / Creada / Transmitida / Protocolada / Rechazada / Cancelada / Inutilizada.

Detalle / formulário

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

Onde vos 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, cobranza, pagamento.

Estados de la nota y transiciones

Código Nome O que significa Próxima ação possível
90 Espejo Importada de fora ou rascunho. Sem número fiscal. Generar nota → vira Creada.
1 Creada Promovida do espejo. Tem número fiscal. Não transmitida ainda. Procesar → vira Transmitida.
2 Transmitida XML enviado à SEFAZ. Aguardando autorización. Consultar → cuando 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 Rechazada SEFAZ devolveu erro (cStat 4xx-5xx-6xx). Corrigir e retransmitir.
5 Inutilizada Número de NFe queimado (corrige pulo de numeración). Estado terminal.
99 Cancelada Cancelación aceito (evento 110111). Estado terminal.
Diferenças de prazo:
  • Cancelación (110111): até 24h da autorización.
  • Carta de Corrección (110110): até 30 dias da autorización. Só corrige campos textuales — não corrige valor, cantidad, destinatario, série, número, data.
  • Inutilização: até o 30º dia útil do mês seguinte — só pra números nunca usados (pulo de numeración).

Anatomía del XML 4.00

NFe verson 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 emisor
<natOp>Venda de mercancía</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=Síples 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 nItiene="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 Síples 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>                       # generalmente 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=emisor, 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 rechazo:
  • ide/cUF e ide/cMunFG — UF e código IBGE necesitam estar consistentes.
  • ide/idDest — 1/2/3 conforme operação interna/interestadual/exterior. Errar derruba CFOP.
  • emit/CRT — regime do emisor; Síples usa CSOSN, Lucro Real/Presumido usa CST. Trocar = rechazo.
  • 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 = rechazo 778.
  • det/prod/CFOP — bate com idDest: 5xxx só pra intra, 6xxx só pra inter.
  • imposto/ICMS/CST — bate com CRT da empresa: empresa Síples não pode mandar CST de Lucro Real e vice-versa.

Pantalla de agregar/editar — barra de acciones

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 tiene condição de exibição baseada na situação da nota — ex: Cancelar só em Protocolada; Generar nota só em Espejo; 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 (Procesar, Generar nota) não aparecem aqui; veja a tabela abaixo.

Botões da caixa-maneira

# Botão Cuándo 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 transmisson (XML existe) Abre o XML assinado em nova aba. Útil pra debug e entregar ao contador.
3 Ver XML Cancelación Cancelada (99) Mostra o XML do evento de cancelación (não o XML original).
4 Procesar Creada (1), Transmitida (2) ou Rechazada (4) Monta XML, valida XSD, assina A1, transmite ao SEFAZ. Também consulta protocolo cuando já transmitiu. Vira Transmitida → Protocolada ou Rechazada.
5 Consultar Tem llave de acceso Pergunta à SEFAZ "esta NFe já foi autorizada?". Útil cuando a transmisson deu timeout.
6 Generar de Espejo Espejo (90) Promove o espejo a NFe oficial — recebe número, vira Creada (1).
7 Cancelar Protocolada (3) ou Espejo (90), em até 24h Em Protocolada: dispara evento 110111 com justificación (mín. 15 chars). Em Espejo: descarta o rascunho.
8 Carta de Corrección (CCe) Protocolada + cliente vinculado, em até 30 dias Dispara evento 110110 com texto da correção (mín. 15 chars). Só pra ajustes textuales — não corrige valor, cantidad, destinatario.
9 Enviar por e-mail Protocolada + cliente vinculado Envia DANFE pro e-mail do cliente (tieneplate 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 cuando há salto de numeración (gerou número 1, 2, 4 — pulou 3). A inutilização "queima" o número 3 oficialmente.

DANFE — el PDF

O DANFE (Documento Auxiliar da NFe) é o PDF gerado após autorización. 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 Detalle
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, emisor, destinatario, 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.

Cancelación y CCe

Cancelación — Evento 110111 (24h)

NFe Protocolada pode ser cancelada em até 24h da autorización. Quaza envia um evento (não outra NFe) com tipo 110111, justificación 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 devolución — 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 Corrección (CCe) — Evento 110110 (30 dias)

Permite corrigir campos textuales não-fiscais em até 30 dias da autorización. 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 / cantidad dos itens
Dirección (algumas SEFAZ permitiene) CFOP que mude alícuota ou tipo de operação
Descrição do produto (textual) Destinatario (CNPJ/CPF)
Dados de transporte Número, série, data de emisión
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.

Manifestación del destinatario

Cuándo alguém emite NFe contra o CNPJ da sua empresa (como destinatario PJ), vos pode/deve manifestar dizendo o que aconteceu. Eventos:

Código Evento Cuándo usar
210200 Confirmação da Operação Vos recebeu a mercancía conforme a NFe. Manifestação positiva.
210210 Ciência da Emisión Tomou ciência. Cuidado: dar ciência e não manifestar depois pode gerar penalidade.
210220 Desconhecimento da Operação NFe emitida indevidamente — vos 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 esperam manifestação.

Endpoints SEFAZ por UF

Cada estado tiene seu próprio webservice SEFAZ pra NFe modelo 55. Quaza decide automáticamente baseado na UF da empresa emisora. Não configurá URL — só configurá 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 del estado SVRS / SVAN
MA SVAN (Sistienea Virtual do Ambiente Nacional) SVRS
AL, AP, DF, ES, PA, PB, PI, RJ, RN, RO, RR, SC, SE, TO SVRS (Sistienea Virtual da Receita Estadual RS) SVAN

Cuándo a SEFAZ primária del estado fica fora (status 108/109), o Quaza pode comutar pra contingencia automáticamente (configurável). Operações suportadas: Autorizacao, Consulta, StatusServico, Inutilizacao, RecepcaoEvento, ConsultaCadastro.

Tributos calculados

NFe é a mais complexa das notas em tributación. Quaza calcula tudo a partir do Producto fiscal + CRT da empresa + UF do destinatario.

Tributo O que é Quem paga
ICMS Estadual sobre circulação de mercancía. Alíquota varia por UF (generalmente 17-19% internas; 7-12% interestaduais). Emisor (regra general)
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ícuota interna do destino e a interestadual, em ventas interestaduais a consumidor final. Emisor recolhe DIFAL
FCP Fundo de Combate à Pobreza — adicional ICMS de 1-4% (varia por UF), em alguns produtos. Emisor
IPI Imposto sobre Produtos Industrializados (federal). Em general só fabricante/importador calcula; revendedor lança CST 99 (outras). Fabricante / Importador
PIS Federal — alícuota 0,65% (cumulativo) ou 1,65% (não-cumulativo). Emisor
COFINS Federal — alícuota 3% (cumulativo) ou 7,6% (não-cumulativo). Emisor
Empresas Síples 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 Síples é determinada pela faixa de receita do anexo I/II.

De dónde vienen los datos

Campo da NFe Origem
Emisor (CNPJ, IE, dirección, CRT) Empresa NFe
Destinatario (cliente, CPF/CNPJ, dirección) Cadastro do cliente
Itens (cProd, xProd, qtde, valor) Equipo / Produto
NCM, EAN, unidade, peso Producto fiscal
CFOP Natureza de operação (Fiscal → Natureza)
CST/CSOSN, alícuotas ICMS/IPI/PIS/COFINS Situação tributária do producto fiscal
Série + numeración 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 venta/cobranza

¿Cómo ler erros e debugar

Onde achar a mensagem de erro

  1. Abra a NFe Rechazada (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 Destinatario com problemas fiscais — SEFAZ não autoriza emitir contra ele.
135 Evento registrado e vinculado a NFe Cancelación/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 emisor diverge do CNPJ cUF na ide não bate com a UF na IE do emisor.
231 CPF/CNPJ do destinatario inválido Documento do cliente com dígito errado.
233 IE do destinatario não consta no SINTEGRA Cliente PJ com IE não cadastrada na UF dele. Pode ser baixa, suspenson.
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 numeración.
597 Rejeição: NFe com data emisión 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 producto fiscal.
778 NCM informado é inválido Mesma causa do 610.
805 Certificado expirado Renove o A1.

Trampas frecuentes

1. CFOP errado por UF. Vender pra cliente em outra UF e usar CFOP 5102 (intra) ao invés de 6102 (inter) = rechazo. 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 = rechazo 610/778. Mantenha cadastro de produtos atualizado.
3. CST × CSOSN trocados. Empresa Lucro Real usa CST (00, 10, 20...). Síples Nacional usa CSOSN (101, 102...). Trocar = rechazo imediata. Configure no Producto fiscal conforme o CRT da empresa.
4. Cancelación expira em 24h. Diferente da NFCom (también 24h) e NFSe Nacional (sem prazo). Filtro útil: "Protocoladas emitidas ontiene".
5. CCe ≠ cancelación. 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. Equipo de redes pode ser ST em alguns estados, e o revendedor não deve recalcular. Se duvidar, consulte o contador antes de mudar tributación do produto.
7. DIFAL em ventas interestaduais a consumidor final. Vendendo equipo 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 ≠ Cancelación. Inutilização "queima" número não usado (pulo de numeración). Cancelación anula nota emitida. Confundir gera problema com contador.
10. Manifestación del destinatario — não ignore. Se sua empresa recebe NFe (compra equipo), manifeste em até 180 dias (210220 desconhecimento) ou 30 dias (210200 confirmação). Não manifestar pode gerar problema fiscal.

FAQ

Cuándo emitir NFe versus NFCom/NFSe?

NFe = producto físico (equipo). NFCom = servicio de comunicación (internet, telefonia). NFSe = servicio (instalação, suporte, manutenção). Um provedor emite os três conforme o tipo de receita.

¿Puedo emitir NFe sem CFOP cadastrado?

No. CFOP vem da Natureza de operação. Configure ao menos 5102/6102 (venta intra/inter) e 1202/2202 (devolución intra/inter).

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

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

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

O cliente PJ tiene 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 devolución (entrada, CFOP 1202/2202) com referência à NFe original — anula o efeito fiscal. Confirme com seu contador antes.

Empresa Síples Nacional emite NFe?

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

¿Puedo emitir NFe de teste?

Sí — configurá ambiente Homologación (2). Notas em homologación não tienen valor fiscal mas todo o ciclo (XML, assinatura, transmisson, 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) emisión em homologación (QR aponta pra ambiente de homologación, vazio); (3) bug no leitor de QR.

¿Cómo 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 destinatario.

¿Puedo editar NFe depois de Protocolada?

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

Quanto tienepo guardar o XML da NFe?

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

Documentos relacionados