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 cubre mercancía — cosa física que sale de su stock y va al cliente. Para un proveedor de internet, esto es menos frecuente que otros documentos fiscales. Resumen de cuándo emitir cada uno:

Tipo de ingreso del proveedor Documento correcto
Internet, telefonía, TV (mensualidad) NFCom
Instalación, soporte, mantenimiento (mano de obra) NFSe
Venta de equipo (router, ONU, decoder, antena) NFe
Streaming, telefonía OTT, antivirus SVA
Devolución de equipo (el cliente canceló y devolvió) NFe (entrada)
NFe puede ser de salida o entrada:
  • Salida (CFOP 5xxx dentro del estado, 6xxx fuera): ventas, donaciones, obsequios — el equipo sale del stock del proveedor.
  • Entrada (CFOP 1xxx dentro, 2xxx fuera): devolución de cliente, retorno de comodato, importación. El equipo vuelve al stock.

Paso a paso — emitir su primera NFe

Guía mínima, desde cero hasta el DANFE en la mano del cliente:

Paso Acción Dónde
1 Configure la Empresa NFe: CNPJ, IE, dirección, CRT, certificado A1 (.pfx + contraseña), ambiente Homologación. Fiscal → Empresa NFe
2 Registre la Serie fiscal modelo 55 (una para Homologación, otra para Producción). Fiscal → Serie fiscal
3 Registre la Naturaleza de operación (CFOP 5102 / 6102 / 1202 / 2202 como mínimo). Fiscal → Naturaleza de operación
4 Registre el Producto con NCM, EAN, peso, unidad y situación tributaria (CST/CSOSN, ICMS/IPI/PIS/COFINS). Stock → Producto
5 Haga una prueba en Homologación: cree una NFe, genere la nota, procésela. Si autoriza, todo el ciclo funciona. Fiscal → NFe
6 Pruebe cancelación y Carta de Corrección aún en Homologación — para asegurarse de que el certificado y los flujos responden. Fiscal → NFe → [la NFe]
7 Pase a Producción: cambie el ambiente de la Empresa NFe y de la Serie. Desde ahí, cualquier NFe tiene valor fiscal. Fiscal → Empresa NFe
8 Habilite la tarea diaria de retransmisión (NFe Transmisión) para reprocesar automáticamente las Creadas/Rechazadas pendientes. Admin → Tareas
Consejo: pase a Producción solo después de que todo el ciclo (emitir + cancelar + CCe) funcione en Homologación. Un error en Producción cuesta tiempo del contador.

Flujo general — del espejo al DANFE

OPERADOR QUAZA (servidor) SEFAZ Estadual 1 Venta de equipo (el equipo sale del stock) Crea NFe como ESPEJO situación 90 · sin número fiscal 2 Verifica el espejo clic en "Generar nota" Promueve a CREADA (1) asigna número secuencial 3 Clic en "Procesar" manual O tarea diaria TRANSMITIDA (2) arma XML · firma A1 · envía Valida XML contra XSD 4.00 4 Devuelve protocolo cStat = 100 (autorizado) PROTOCOLADA (3) tiene nProt · valor fiscal cStat 4xx/5xx/6xx error · motivo en xMotivo RECHAZADA (4) corregir y procesar de nuevo 5 Genera DANFE (PDF) con QR Code Imprime/Envía DANFE e-mail · WhatsApp · portal Post-emisión (opcional) 6 Cancelar (hasta 24h) justificación · 15 caracteres Pedido de cancelación cStat aceptado: 101/135/151 CANCELADA (99) estado terminal 7 Carta de Corrección 15-1000 caracteres · 30 días Pedido de corrección SEFAZ registra la corrección Sigue PROTOCOLADA CCe vinculada a la nota

Flujo de la NFe en 3 carriles (Operador · Quaza · SEFAZ). Pasos 1-5 cubren el ciclo normal (Espejo → Creada → Transmitida → Protocolada → DANFE). Pasos 6-7 cubren la post-emisión (Cancelación 24h y Carta de Corrección 30 días). La línea rojiza paralela muestra el camino de rechazo.

Lea el diagrama: Espejo → Creada → Transmitida → Protocolada → DANFE. Cada SEFAZ tiene su webservice — cuando la SEFAZ del estado cae, Quaza hace fallback a SVRS/SVAN (contingencia) automáticamente.

Glosario

Término Qué es
NFe Nota Fiscal Electrónica — documento fiscal de mercancía emitido electrónicamente. Reemplazó la Nota Fiscal modelo 1 (papel) en todo Brasil desde ~2008.
Modelo 55 Código fiscal de la NFe (mercancía). Compare: 65=NFCe (consumidor final en el comercio minorista), 62=NFCom, 21/22=antiguas notas de comunicación (deprecadas).
Espejo Versión preliminar de la NFe, situación 90. Sin número fiscal, sin valor jurídico. Sirve para verificar antes de promover.
Clave de acceso Identificador único de 44 dígitos de la NFe. Diferente de la NFCom (también 44) — la estructura interna es similar pero con modelo diferente (55 vs 62).
CFOP Código Fiscal de Operaciones y Prestaciones. Familia de 4 dígitos. 5xxx = salida dentro del estado, 6xxx = salida interestadual, 1xxx/2xxx = entrada. Ej: 5102=venta mercancía dentro del estado, 6102=venta fuera.
NCM Nomenclatura Común del Mercosur — 8 dígitos que clasifican el producto. Obligatorio en la NFe. Ej: router wireless = 85176294, ONU = 85176294.
CST Código de Situación Tributaria del ICMS — empresas de Lucro Real/Presumido. 2 dígitos. 00=tributada íntegramente, 10=ST, 20=base de cálculo reducida, 40=exenta, 50=suspensión, etc.
CSOSN Código de Situación de la Operación del Simples Nacional — empresas adheridas al Simples. 3 dígitos. 101=permite crédito, 102=no permite, 201/202=ST, etc.
CRT Código del Régimen Tributario de la empresa: 1=Simples Nacional (usa CSOSN), 2=Lucro Real, 3=Lucro Presumido (usa CST).
ICMS-ST Sustitución Tributaria del ICMS — cuando el impuesto es retenido en la fuente (generalmente por el fabricante) y el revendedor ya no paga. Se aplica a algunos equipos electrónicos.
DIFAL Diferencial de Alícuota Interestadual — cuando vende a otro estado, diferencia entre la alícuota interna del destino y la interestadual. Aplica en ventas interestaduales a consumidor final no contribuyente.
FCP Fondo de Combate a la Pobreza — adicional de hasta 4% sobre el ICMS, varía por estado y producto.
IPI Impuesto sobre Productos Industrializados — federal. El proveedor revendedor de equipo generalmente no calcula IPI (quien lo calcula es el fabricante/importador).
DANFE Documento Auxiliar de la NFe — el PDF que va al cliente. Modelo estandarizado nacional, con clave de acceso, QR Code, datos del emisor/destinatario, ítems, totales, transportador.
Evento 110111 Cancelación de la NFe. Plazo: 24h después de la autorización.
Evento 110110 Carta de Corrección Electrónica (CCe). Corrige campos textuales no fiscales. Plazo: 30 días.
Manifestación del destinatario Eventos 210200 (confirmación), 210210 (toma de conocimiento), 210220 (desconocimiento), 210240 (operación no realizada). El destinatario PJ puede/debe manifestar sobre NFes emitidas contra su CNPJ.
SVRS / SVAN Sistemas Virtuales (RS, AN) — usados como contingencia cuando la SEFAZ del estado cae. Quaza los usa automáticamente cuando el primario falla.
Ambiente 1 = Producción (valor fiscal). 2 = Homologación (pruebas — no tiene valor fiscal).

Configuración — prerrequisitos

Antes de emitir la primera NFe configure la Empresa NFe. Es allí donde 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ón social, IE (inscripción estadual), dirección, CNAE, UF (define qué SEFAZ usar), CEP.
  • CRT — Código del Régimen Tributario: 1=Simples Nacional (usa CSOSN en los productos), 2=Lucro Real, 3=Lucro Presumido (usan CST).
  • Certificado A1 (pestaña Certificado): carga del .pfx + contraseña. Vence anualmente — programe un recordatorio 30 días antes.
  • Ambiente: Homologación para probar; Producción solo cuando todo el ciclo (emisión+cancelación+CCe) funcione.
  • CSC (Código de Seguridad del Contribuyente): obligatorio solo para NFCe (modelo 65) — el modelo 55 no lo usa. Si el sistema lo pide, déjelo en blanco o consulte al contador.
Serie fiscal modelo 55 Fiscal → Serie fiscal

Al menos una serie modelo 55 por ambiente (homologación y producción tienen numeraciones separadas — no las comparta). En general, la serie 1 para producción y la serie 999 para homologación es el estándar del mercado.

Naturaleza de operación Fiscal → Naturaleza de operación

Configure al menos:

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

Cada equipo revendido necesita de Producto fiscal registrado con:

  • NCM (8 dígitos) — clasifica el producto para la Receita Federal.
  • EAN / GTIN — código de barras (si aplica).
  • Unidad de medida (UN, PC, MT, etc).
  • Peso bruto y neto — usado en el transporte.
  • Situación tributaria ICMS, IPI, PIS, COFINS — CST/CSOSN por tributo + alícuota.

El registro de Equipo (ONU, router) referencia el Producto fiscal — al vender, Quaza trae NCM/peso/tributación automáticamente.

Plantilla de e-mail Comunicación → Plantillas → NFE_ENVIO

Usada por el botón "Enviar e-mail". Sin la plantilla configurada, el botón no hace nada.

Producto fiscal — vínculo con stock

NFe es diferente de NFCom/NFSe porque cubre producto físico. Cada ítem de la NFe debe apuntar a un registro de producto con clasificación fiscal completa. Quaza encadena: Equipo (registro) → Producto (stock) → Producto fiscal (tributación).

Tabla Qué contiene
equipo Registro técnico: serial, MAC, estado, vinculación al cliente. Tiene idProduto.
produto Descripción comercial, NCM, EAN, unidad, peso, dimensiones. Compartido entre varios equipos del mismo modelo.
produtoIcms / produtoIpi / produtoPis / produtoCofins Situación tributaria + alícuota por tributo. En general 1 fila por producto por tributo.
Cuando vende 1 router: Quaza encuentra el equipo (por serial) → obtiene el idProduto → trae NCM/peso/medida → trae situación tributaria ICMS/IPI/PIS/COFINS → calcula el valor de los impuestos → completa el ítem de la NFe. Todo automático si el registro está bien cargado.

Pantalla de NFe — listado y detalle

Dos pantallas que trabajan juntas: listado + detalle. Se navega del listado al detalle por el ícono de la columna de editar (lápiz).

Listado

Fiscal → NFe

Lista todas las NFes (espejos, creadas, transmitidas, protocoladas, rechazadas, canceladas, inutilizadas) con filtros por período, situación, cliente, serie, ambiente.

Listagem de NFe

Listado de NFe — la columna marcada en rojo tiene el ícono de editar (lápiz): haga clic en él para abrir el detalle de la nota. La columna anterior, de la impresora, descarga el DANFE directamente.

Columna Qué muestra
Número Número fiscal secuencial de la serie. Vacío en los espejos.
Cliente / Destinatario Quién recibe la mercancía. El enlace abre el registro.
Valor Suma de los ítems.
Emisión Fecha de emisión.
Naturaleza CFOP+descripción (ej: "5102 — Venta mercancía adquirida").
Situación Espejo / Creada / Transmitida / Protocolada / Rechazada / Cancelada / Inutilizada.

Detalle / formulario

Fiscal → NFe → [hacer clic en el ícono de la columna Editar]

Donde verifica/edita los datos antes de transmitir, y desde donde se disparan todas las acciones.

Formulário da NFe

Formulario de edición de la NFe — encabezado (cliente, naturaleza, serie), ítems (con NCM/CFOP/CST y tributos), totalizadores, transporte, cobranza, pago.

Estados de la nota y transiciones

Código Nombre Qué significa Siguiente acción posible
90 Espejo Importada de fuera o borrador. Sin número fiscal. Generar nota → pasa a Creada.
1 Creada Promovida del espejo. Tiene número fiscal. No transmitida aún. Procesar → pasa a Transmitida.
2 Transmitida XML enviado a la SEFAZ. Esperando autorización. Consultar → cuando autorizada, pasa a Protocolada.
3 Protocolada Autorizada por la SEFAZ. Tiene nProt (número de protocolo). Valor fiscal. Imprimir DANFE, enviar al cliente. Cancelar (24h). CCe (30 días).
4 Rechazada SEFAZ devolvió error (cStat 4xx-5xx-6xx). Corregir y retransmitir.
5 Inutilizada Número de NFe quemado (corrige salto de numeración). Estado terminal.
99 Cancelada Cancelación aceptada (evento 110111). Estado terminal.
Diferencias de plazo:
  • Cancelación (110111): hasta 24h de la autorización.
  • Carta de Corrección (110110): hasta 30 días de la autorización. Solo corrige campos textuales — no corrige valor, cantidad, destinatario, serie, número, fecha.
  • Inutilización: hasta el 30º día hábil del mes siguiente — solo para números nunca usados (salto de numeración).

Anatomía del XML 4.00

NFe versión actual: 4.00, namespace http://www.portalfiscal.inf.br/nfe. Quaza usa la lib NFePHP/sped-nfe para armar, firmar y 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>Venta 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=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 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>
<impuesto>
<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>                       # generalmente CST 99 = outras (proveedor revendedor)
<PIS>...</PIS>
<COFINS>...</COFINS>
</impuesto>
</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 más generan rechazo:
  • ide/cUF y ide/cMunFG — UF y código IBGE deben estar consistentes.
  • ide/idDest — 1/2/3 según operación interna/interestadual/exterior. Equivocarse anula el CFOP.
  • emit/CRT — régimen del emisor; Simples usa CSOSN, Lucro Real/Presumido usa CST. Cambiar = rechazo.
  • dest/CPF o CNPJ + indIEDest — coherencia cliente PF/PJ/contribuyente. Cliente PJ sin IE = indIEDest=2 (exento).
  • det/prod/NCM — 8 dígitos válidos de la tabla TIPI. NCM incorrecto = rechazo 778.
  • det/prod/CFOP — debe coincidir con idDest: 5xxx solo para intra, 6xxx solo para inter.
  • impuesto/ICMS/CST — debe coincidir con el CRT de la empresa: empresa Simples no puede enviar CST de Lucro Real y viceversa.

Pantalla de agregar/editar — barra de acciones

La pantalla de edición de la NFe muestra el panel lateral fijo a la derecha — la caja de acciones, la misma barra que aparece en NFCom y NFSe .

Botones contextuales: no todos aparecen siempre. Cada uno tiene condición de visualización basada en la situación de la nota — ej: Cancelar solo en Protocolada; Generar nota solo en Espejo; CCe solo en Protocolada.
caixa-maneira NFe anotada

Barra de acciones en NFe Protocolada — botones visibles numerados. Los botones que dependen de otras situaciones (Procesar, Generar nota) no aparecen aquí; ver la tabla a continuación.

Botones de la barra de acciones

# Botón Cuándo aparece Qué hace
1 Imprimir DANFE Protocolada (3) o Transmitida (2) Genera el PDF (DANFE) con QR Code. Abre en nueva pestaña.
2 Ver XML Tras la transmisión (XML existe) Abre el XML firmado en nueva pestaña. Útil para depuración y entregar al contador.
3 Ver XML Cancelación Cancelada (99) Muestra el XML del evento de cancelación (no el XML original).
4 Procesar Creada (1), Transmitida (2) o Rechazada (4) Arma XML, valida XSD, firma A1, transmite a la SEFAZ. También consulta protocolo cuando ya transmitió. Pasa a Transmitida → Protocolada o Rechazada.
5 Consultar Tiene clave de acceso Pregunta a la SEFAZ "¿esta NFe ya fue autorizada?". Útil cuando la transmisión tuvo timeout.
6 Generar de Espejo Espejo (90) Promueve el espejo a NFe oficial — recibe número, pasa a Creada (1).
7 Cancelar Protocolada (3) o Espejo (90), hasta 24h En Protocolada: dispara evento 110111 con justificación (mín. 15 chars). En Espejo: descarta el borrador.
8 Carta de Corrección (CCe) Protocolada + cliente vinculado, hasta 30 días Dispara evento 110110 con texto de la corrección (mín. 15 chars). Solo para ajustes textuales — no corrige valor, cantidad, destinatario.
9 Enviar por e-mail Protocolada + cliente vinculado Envía el DANFE al e-mail del cliente (plantilla NFE_ENVIO).
10 Enviar por WhatsApp Protocolada + cliente vinculado Abre web.whatsapp.com con mensaje + enlace del DANFE.
Inutilización no está en la barra de acciones: es una rutina separada en Fiscal → NFe → Inutilización. Se usa cuando hay salto de numeración (generó el número 1, 2, 4 — saltó el 3). La inutilización "quema" el número 3 oficialmente.

Tareas automáticas — generación y transmisión

Quaza tiene un conjunto de tareas que corren en horarios programados que generan, transmiten y reprocesan NFes sin intervención manual. Las tareas se leen del crontab del servidor — cada línea apunta a un archivo PHP y define la frecuencia (diaria, cada X minutos, etc).

Quién prende/apaga una tarea: lo hace el sysadmin editando el crontab del servidor (comentar la línea con # la desactiva; descomentar la reactiva). No lo hace el operador dentro de Quaza. Si una tarea debe arrancar o parar, abra un ticket al equipo técnico.
Seguimiento de las tareas en QuazaAdmin → Tareas

La pantalla solo informa sobre cada tarea registrada — no la prende/apaga. En cada línea consulta:

  • Enum / Descripción — qué tarea es (ej.: "Fiscal - Transmisión de notas fiscales").
  • Resumen — qué pasó en la última ejecución (cuántos ítems procesó, errores).
  • E-mail de notificación — dirección que recibe aviso si la tarea falla.
  • Tiempo límite — cuánto tiempo tiene la tarea antes de abortar.
  • Última modificación — cuándo se actualizó el registro.

Es la pantalla para diagnosticar: si una nota no salió, esta es la primera parada — ves cuándo corrió la tarea y qué reportó.

Configuración clave: "Generación automática de notas"

Antes que nada, existe una configuración global que rige si el sistema genera notas solo. Sin ella encendida, las tareas de generación no hacen nada — aunque estén activas y corriendo.

Generación automática de notas fiscalesAdmin → Configuraciones → Fiscal
Opción Qué hace
Manual El sistema no genera nota automáticamente — usted la genera a mano por la pantalla de la NFe.
Persona Física Genera nota automáticamente solo para clientes PF. PJ se genera a mano.
Persona Jurídica Genera automáticamente solo para PJ.
Cualquiera Genera para PF y PJ.

Tareas relacionadas a la NFe

# Tarea Qué hace Pre-requisito
501 Nota anticipada Genera la nota fiscal antes del vencimiento de la factura — para clientes que necesitan la nota con anticipación. Corre a diario y respeta la configuración de Generación automática (Manual / PF / PJ / Cualquiera). Generación automática ≠ Manual
508 Generar notas automáticamente Tarea "paraguas" — recorre los cobros del mes corriente (o últimos N días) y dispara la generación de las notas que aún no se crearon. Generación automática ≠ Manual
510 Generar notas para financieros pagados Variante de la 508: genera nota solo de los contratos cuyo financiero fue efectivamente pagado. Para quien solo emite nota tras el cobro confirmado. Contrato con tributación "Por pago"
511 Transmisión de notas fiscales Toma NFes que quedaron en Creada o Rechazada con emisión desde el 1º día del mes anterior (~30-60 días) y retransmite cada una. Tiene lock — no corre en paralelo. Hay NFes en Creada/Rechazada con ítems
Flujo típico de producción: 501, 508 o 510 (según el caso) crea la NFe en situación Creada — la 511 la transmite a la SEFAZ. Las dos puntas trabajan juntas.
Lo que estas tareas NO hacen automáticamente:
  • No cancelan notas (la cancelación es siempre manual, con plazo de 24h).
  • No envían Carta de Corrección.
  • No manifiestan sobre NFes recibidas.
  • No inutilizan números.
Todo eso es decisión consciente del operador, en la pantalla de la nota.

DANFE — el PDF

El DANFE (Documento Auxiliar de la NFe) es el PDF generado tras la autorización. No es la nota fiscal — la nota es el XML. El DANFE es la representación visual con QR Code que permite consultar el XML en el portal nacional.

Característica Detalle
Prerequisito NFe Transmitida (2) o Protocolada (3).
Generación Lib NFePHP/sped-da genera el PDF a partir del XML autorizado.
Contenido Clave de acceso, emisor, destinatario, ítems (NCM/CFOP/cantidad/valor/tributos), totales, transportador, datos adicionales, QR Code.
Layout Estándar nacional definido por el MOC (Manual de Orientación al Contribuyente) — Retrato o Paisaje según nº de ítems.
Distribución E-mail (NFE_ENVIO), WhatsApp o portal del cliente.

Cancelación y CCe

Cancelación — Evento 110111 (24h)

NFe Protocolada puede cancelarse hasta 24h de la autorización. Quaza envía un evento (no otra NFe) con tipo 110111, justificación mínima 15 caracteres.

cStat retornado Qué significa
135 Evento aceptado. NFe pasa a Cancelada (99).
136 Aceptado pero no vinculado (raro).
501 Plazo vencido — pasó de 24h, ya no cancela.
573 Duplicidad — ya cancelado.
¿Pasó de 24h? No cancela. Opciones:
  1. NFe de devolución — emitir NFe de entrada (CFOP 1202/2202) con referencia a la NFe original, anulando el efecto fiscal.
  2. Sustitución — emitir nueva NFe complementaria (finalidad=4) con ajuste; depende de la naturaleza del error.
  3. Proceso administrativo en la SEFAZ — en casos extremos, puede demorar semanas.

Carta de Corrección (CCe) — Evento 110110 (30 días)

Permite corregir campos textuales no fiscales hasta 30 días de la autorización. Quaza envía evento 110110 con texto de la corrección (mín. 15 chars).

Qué puede corregir Qué NO puede corregir
Informaciones complementarias Valor / cantidad de los ítems
Dirección (algunas SEFAZ lo permiten) CFOP que cambie alícuota o tipo de operación
Descripción del producto (textual) Destinatario (CNPJ/CPF)
Datos de transporte Número, serie, fecha de emisión
Naturaleza de la operación (algunas) Tributación (CST/ICMS/IPI/PIS/COFINS)
Límite de CCes: SEFAZ acepta hasta 20 cartas de corrección por NFe. Superado ese límite, rechaza.

Manifestación del destinatario

Cuando alguien emite NFe contra el CNPJ de su empresa (como destinatario PJ), usted puede/debe manifestar indicando qué ocurrió. Eventos:

Código Evento Cuándo usar
210200 Confirmación de la Operación Usted recibió la mercancía conforme a la NFe. Manifestación positiva.
210210 Toma de Conocimiento de la Emisión Tomó conocimiento. Atención: tomar conocimiento y no manifestar después puede generar penalidad.
210220 Desconocimiento de la Operación NFe emitida indebidamente — usted nunca contrató ni recibió.
210240 Operación no Realizada Contrató pero la entrega no ocurrió (cliente canceló, transportador devolvió).

En Quaza, la manifestación aparece en Fiscal → NFe → Manifestación — lista las NFes emitidas contra su CNPJ que esperan manifestación.

Inutilización de numeración

La inutilización quema un intervalo de números que nunca se usaron — corrige saltos en la numeración fiscal. Úsela cuando, por algún motivo, generó el número 1, 2, 4 y saltó el 3 (falla del sistema, grabación interrumpida, etc).

Inutilización de NFe/NFCeFiscal → Inutilización de NFe/NFCe

La misma pantalla cubre NFe modelo 55 y NFCe modelo 65 — usted elige el modelo. Campos del formulario:

  • Configuración — qué Empresa NFe es la emisora.
  • Modelo — 55 (NFe) o 65 (NFCe).
  • Serie — qué serie fiscal (default 0).
  • Rango inicio y Rango fin — números a inutilizar (uno solo o un intervalo).

Al hacer clic en Inutilizar, abre un popup para confirmar y escribir la justificación — ya viene con el texto por defecto "Falla en la grabación de la base de datos del ERP", que puede cambiar por el motivo real. Acción irreversible.

Plazo: hasta el 30º día hábil del mes siguiente al salto. Después, la SEFAZ rechaza.
Inutilización ≠ Cancelación. La inutilización solo sirve para números nunca usados. Si el número se generó y la nota al menos se transmitió, el camino es cancelar (24h) o devolución/sustitución.

Importación de XML — NFe de compra

Cuando su proveedor compra equipo, el proveedor emite una NFe contra su CNPJ y envía el XML. Quaza tiene una pantalla para importar ese XML — lo lee, valida y genera movimientos de stock automáticamente, sin cargar ítem por ítem.

Importación de XMLStock → Importación de XML

Pantalla para registrar NFes recibidas de proveedores. Campos:

  • Nombre del archivo — nombre del XML que se importa (referencia).
  • Clave — clave de acceso de la NFe (44 dígitos), completada automáticamente tras el parse.
  • Cliente — proveedor asociado (registro de cliente tipo PJ en Quaza).
  • Total importado / Valor total — totales agregados.
  • XML — el contenido completo del XML, pegado en el campo. El sistema parsea clave, proveedor, ítems (con NCM/EAN/cantidad/valor) y dispara los movimientos de entrada al stock.

El listado muestra una columna MOV en cada línea — enlace a los movimientos de stock creados desde esa importación (entrada de mercadería). Útil para auditar lo que la importación registró.

También sirve para integrar con el registro de productos: si el producto/EAN/NCM ya existe en Quaza, lo enlaza; si no, ofrece crearlo.

Endpoints SEFAZ por UF

Cada estado tiene su propio webservice SEFAZ para NFe modelo 55. Quaza decide automáticamente basándose en la UF de la empresa emisora. No configure la URL — solo configure la UF y el ambiente.

Estado Autorizador principal Contingencia (fallback)
SP, MG, PR, RS, BA, GO, MS, MT, CE, PE, AC, AM SEFAZ propia del estado SVRS / SVAN
MA SVAN (Sistema Virtual del Ambiente Nacional) SVRS
AL, AP, DF, ES, PA, PB, PI, RJ, RN, RO, RR, SC, SE, TO SVRS (Sistema Virtual de la Receita Estadual RS) SVAN

Cuando la SEFAZ primaria del estado queda fuera (status 108/109), Quaza puede conmutar a contingencia automáticamente (configurable). Operaciones soportadas: Autorizacao, Consulta, StatusServico, Inutilizacao, RecepcaoEvento, ConsultaCadastro.

Tributos calculados

NFe es la nota más compleja en tributación. Quaza calcula todo a partir del Producto fiscal + CRT de la empresa + UF del destinatario.

Tributo Qué es Quién paga
ICMS Estadual sobre circulación de mercancía. Alícuota varía por UF (generalmente 17-19% internas; 7-12% interestaduales). Emisor (regla general)
ICMS-ST Sustitución Tributaria — ICMS ya recaudado por el fabricante/importador. El revendedor no paga de nuevo (aplica en algunos productos electrónicos). Sustituto tributario
DIFAL Diferencial de Alícuota — diferencia entre la alícuota interna del destino y la interestadual, en ventas interestaduales a consumidor final. El emisor recauda el DIFAL
FCP Fondo de Combate a la Pobreza — adicional ICMS de 1-4% (varía por UF), en algunos productos. Emisor
IPI Impuesto sobre Productos Industrializados (federal). En general solo el fabricante/importador lo calcula; el revendedor registra CST 99 (otras). Fabricante / Importador
PIS Federal — alícuota 0,65% (acumulativo) o 1,65% (no acumulativo). Emisor
COFINS Federal — alícuota 3% (acumulativo) o 7,6% (no acumulativo). Emisor
Empresas Simples Nacional: el ICMS sale por el DAS. En el XML, marque CRT=1 y use ICMSSN (en vez de ICMS) con CSOSN (101, 102, 201, 202...). La alícuota efectiva del Simples la determina la franja de ingresos del anexo I/II.

De dónde vienen los datos

Campo de la NFe Origen
Emisor (CNPJ, IE, dirección, CRT) Empresa NFe
Destinatario (cliente, CPF/CNPJ, dirección) Registro del cliente
Ítems (cProd, xProd, cantidad, valor) Equipo / Producto
NCM, EAN, unidad, peso Producto fiscal
CFOP Naturaleza de operación (Fiscal → Naturaleza)
CST/CSOSN, alícuotas ICMS/IPI/PIS/COFINS Situación tributaria del producto fiscal
Serie + numeración Fiscal → Serie fiscal modelo 55
Certificado, ambiente Empresa NFe → pestaña Certificado
Transportador, peso, modalidad de flete Ítems + registro de transporte (si existe)
Forma de pago Vínculo con la venta/cobranza

Cómo leer errores y depurar

Dónde encontrar el mensaje de error

  1. Abra la NFe Rechazada (situación 4).
  2. Pestaña "Retorno SEFAZ" muestra cStat + xMotivo (texto del error devuelto por la SEFAZ).
  3. Botón Ver XML muestra el XML enviado — verifique el campo señalado.

Códigos cStat más comunes en la NFe

cStat Mensaje típico Causa probable
100 Autorizado el uso de la NFe Éxito.
108 Servicio paralizado momentáneamente SEFAZ en mantenimiento. Esperar.
110 Uso denegado Destinatario con problemas fiscales — SEFAZ no autoriza emitir contra él.
135 Evento registrado y vinculado a NFe Cancelación/CCe aceptado.
204 Duplicidad de NFe Transmitió la misma clave 2 veces. Use Consultar.
225 Falla en el Schema XML XML no coincide con XSD 4.00. Actualice la lib.
226 Código UF del emisor difiere del CNPJ cUF en ide no coincide con la UF en la IE del emisor.
231 CPF/CNPJ del destinatario inválido Documento del cliente con dígito errado.
233 IE del destinatario no consta en el SINTEGRA Cliente PJ con IE no registrada en su UF. Puede ser baja, suspensión.
539 Duplicidad de número Otro número de la serie fue reutilizado.
539 (variante) Rechazo: número ya consta en la base Inutilice el conflictivo o ajuste la numeración.
597 Rechazo: NFe con fecha de emisión atrasada NFe con dhEmi más de 30 días atrás.
610 NCM informado no consta en la tabla TIPI NCM inválido — verifique el registro del producto fiscal.
778 NCM informado es inválido Misma causa del 610.
805 Certificado expirado Renueve el A1.

Trampas frecuentes

1. CFOP incorrecto por UF. Vender a cliente en otra UF y usar CFOP 5102 (intra) en lugar de 6102 (inter) = rechazo. Quaza toma el CFOP de la Naturaleza de operación — verifique que esté correcto antes de transmitir.
2. NCM inválido. La lista TIPI cambia periódicamente. NCM eliminado = rechazo 610/778. Mantenga el registro de productos actualizado.
3. CST × CSOSN invertidos. Empresa Lucro Real usa CST (00, 10, 20...). Simples Nacional usa CSOSN (101, 102...). Invertirlos = rechazo inmediato. Configure en el Producto fiscal según el CRT de la empresa.
4. La cancelación expira en 24h. Diferente de NFCom (también 24h) y NFSe Nacional (sin plazo). Filtro útil: "Protocoladas emitidas hoy".
5. CCe ≠ cancelación. CCe corrige texto, no valor. No intente corregir un valor incorrecto con CCe — no funcionará.
6. ICMS-ST puede generar dudas. El equipo de redes puede estar en ST en algunos estados, y el revendedor no debe recalcular. Si tiene dudas, consulte al contador antes de cambiar la tributación del producto.
7. DIFAL en ventas interestaduales a consumidor final. Vendiendo equipo a cliente PF en otra UF, Quaza calcula el DIFAL automáticamente. Confirme con el contador el reparto vigente (varía por año).
8. Cliente PJ sin IE = EXENTO. En el campo dest/IE, use literalmente ISENTO (no vacío). Y indIEDest=2. Equivocarse = cStat 233.
9. Inutilización ≠ Cancelación. La inutilización "quema" un número no usado (salto de numeración). La cancelación anula una nota emitida. Confundirlos genera problemas con el contador.
10. Manifestación del destinatario — no ignore. Si su empresa recibe NFe (compra equipo), manifieste hasta 180 días (210220 desconocimiento) o 30 días (210200 confirmación). No manifestar puede generar problema fiscal.

FAQ

¿Cuándo emitir NFe versus NFCom/NFSe?

NFe (55) = producto físico (equipo). NFCom (62) = servicio de comunicación (mensualidad). NFSe = servicio/mano de obra (instalación, soporte).

¿Puedo emitir NFe sin CFOP registrado?

No — la Naturaleza de operación con CFOP es obligatoria. Sin ella, la nota no se arma. Registre al menos 5102/6102 (venta) y 1202/2202 (devolución).

El cliente perdió el e-mail con la NFe — ¿cómo reenvío?

Abra la NFe y haga clic en Enviar e-mail de nuevo. Si el e-mail está desactualizado, corríjalo primero en el registro del cliente.

NFe rechazada con cStat 233 (IE no consta en el SINTEGRA) — ¿qué hago?

La inscripción estatal del destinatario no está activa en el padrón. Confirme la IE del cliente o, si es exento, marque "exento de IE" en el registro.

Cancelé después de 24h — ¿y ahora?

No se cancela. Opciones: emitir nota de devolución/sustitución, o ajustar contablemente con el contador. El plazo de cancelación (24h) es de la SEFAZ.

¿Una empresa del Simples Nacional emite NFe?

Sí — la obligatoriedad no depende del régimen. Cambia el tratamiento de impuestos: Simples usa CSOSN en vez de CST, y el ICMS va por el DAS.

¿Puedo emitir NFe de prueba?

Sí — configure el ambiente de la Empresa NFe como Homologación (2). Las notas en homologación no tienen valor fiscal, pero todo el flujo funciona idéntico.

El QR Code del DANFE no funciona — ¿qué puede ser?

Generalmente el DANFE se generó en homologación (QR apunta al ambiente de prueba) o la nota aún no está autorizada. Solo NFe Protocolada tiene QR válido en producción.

¿Cómo veo el histórico de eventos (autorización, cancelación, CCe, manifestación) de una NFe?

En la pantalla de la NFe, pestaña Protocolo/Eventos — lista cada evento con fecha, protocolo y cStat devuelto por la SEFAZ.

¿Puedo editar la NFe después de Protocolada?

No. Protocolada es estado fiscal definitivo. Si se equivocó: cancela (24h), Carta de Corrección (solo texto) o nota de devolución.

¿Cuánto tiempo guardar el XML de la NFe?

Como mínimo 5 años (plazo fiscal). Quaza guarda el XML; igual conviene tener respaldo. Confirme el plazo con el contador.

¿La tarea de retransmisión puede molestar?

No — la 511 solo reprocesa notas en Creada/Rechazada; no toca las Protocoladas. Tiene lock para no correr en paralelo.

Documentos relacionados