Modelo fiscal 62 — reemplaza el convenio 115 (NFE 21/22) para servicios de comunicación en Brasil
Esta wiki cubre el módulo NFCom de Quaza de punta a punta: qué es, por qué existe, cómo se arma, firma y transmite el XML a la SEFAZ, qué acciones ejecutás en cada nota, cómo cancelar, cómo leer errores y dónde mirar cuando algo falla. Audiencia: equipo fiscal y operadores de proveedores de internet/telefonía que van a emitir NFCom en el día a día. Atención: NFCom es un documento fiscal exclusivo de Brasil — si tu empresa opera solo en Paraguay o Argentina, esta wiki es referencia/contexto; el flujo fiscal de tu país está en Documento Electrónico Paraguay
.
Resumen en una línea: NFCom es la nota fiscal electrónica obligatoria en Brasil para servicios de comunicación (internet, telefonía, TV por suscripción, VoIP, MVNO). Reemplaza las antiguas notas modelo 21 y 22 emitidas por el convenio ICMS 115/03. Quaza arma el XML, lo firma con certificado A1 y lo transmite vía SOAP a la SEFAZ del estado de la empresa emisora.
Hasta 2023, los prestadores de servicios de comunicación en Brasil emitían Nota Fiscal de Servicio de Comunicación (modelo 21) y Nota Fiscal de Telecomunicación (modelo 22), ambas regidas por el Convenio ICMS 115/03 — en formato texto/archivo propietario, sin firma digital ni transmisión electrónica estandarizada. Cada SEFAZ tenía su propio layout, y había mucha fricción operacional.
El Ajuste SINIEF 07/2022 instituyó la NFCom (modelo 62), en el mismo formato XML firmado/transmitido de las demás NF-e nacionales. La migración es obligatoria: quien todavía emite modelos 21/22 está en régimen de excepción y tiene plazo para adecuarse. Proveedores que adhirieron a la NFCom pasan a transmitir en tiempo real, reciben protocolo de la SEFAZ y el cliente final tiene un DANFE-COM (PDF con QR Code) estandarizado.
| Tipo de ingreso del proveedor |
Documento fiscal correcto |
| Internet, telefonía fija/móvil, VoIP, TV por suscripción |
NFCom (62) |
| Venta de equipo (ONU, router, decoder) |
NFe (55) |
| Instalación, mano de obra, soporte puntual |
NFSe (municipal) |
| Streaming, audiolibro, antivirus, telefonía OTT |
NFeSVA — ver SVA
|
| Convenio 115 antiguo |
NFE 21/22 — depreciado |
Dónde encaja Quaza: la NFCom no es un recurso aislado — nace de la factura del cliente. La cobranza mensual de internet se convierte en NFCom automáticamente cuando corre el cron de facturación, siempre que el producto fiscal esté configurado con modelo 62. Raramente vas a crear NFCom a mano — casi todo lo genera el flujo de facturación.
Flujo general — del espejo al protocolo
CRON DE FACTURACION QUAZA (servidor) SEFAZ
| | |
| 1. Mes nuevo (ej: 01/06) | |
|--------------------------->| |
| | 2. Crea NFCom como |
| | ESPEJO (situacion=90) |
| | -> sin numero fiscal |
| | -> borrador/preview |
| | |
| OPERADOR (vos) | |
|--------------------------->| |
| 3. Revisa espejo. Ajusta si hace falta. |
| | |
| 4. Clic "Generar nota" | |
|--------------------------->| |
| | 5. Promueve a NFCom real |
| | -> numero secuencial |
| | -> situacion = CREADA |
| | |
| 6. Clic "Procesar" | |
|--------------------------->| |
| | 7. Arma XML completo |
| | Valida contra XSD |
| | Firma con cert A1 |
| | Envia via SOAP |
| |------------------------->|
| | | 8. SEFAZ valida
| | | Devuelve protocolo
| | | cStat=100 (OK)
| |<-------------------------| o cStat error
| | |
| | 9. Guarda protocolo |
| | situacion=TRANSMITIDA |
| | despues PROTOCOLADA |
| | |
| 10. DANFE-COM generado | |
| Email + WhatsApp | |
| enviados al cliente | |
Leé el diagrama así: el cron crea un espejo (preview sin valor fiscal). Vos revisás, lo promovés a nota fiscal real y después transmitís. Cada paso graba un registro con situación distinta — todo lo seguís desde el listado.
Glosario
| Término |
Qué es |
| NFCom |
Nota Fiscal de Comunicación electrónica modelo 62, instituida por el Ajuste SINIEF 07/2022. |
| Modelo 62 |
Código numérico que identifica el tipo de documento fiscal (62 = NFCom). Compará: 55 = NFe, 65 = NFCe, 21/22 = antiguos modelos de comunicación. |
| Espejo |
Versión preliminar de la nota, situación 90. No tiene número fiscal, no fue enviada a la SEFAZ. Sirve para revisar antes de promover. No tiene valor fiscal.
|
| Llave de acceso |
Identificador único de 44 dígitos de la NFCom. Aparece como NFCom + Id="NFCom..." dentro del XML, en la esquina superior del DANFE y en el QR Code. |
| Competencia |
Mes/año de referencia del servicio prestado (ej: Mayo/2026). Distinta de la fecha de emisión. NFCom es facturación mensual por competencia — una nota cubre todo el mes. |
| Certificado A1
|
Certificado digital ICP-Brasil en archivo (.pfx). Vence en 1 año. Se usa para firmar el XML antes de transmitir. |
| SVRS |
Sistema Virtual de la Receita Estadual (SEFAZ-RS). Es el ambiente que la mayoría de los estados usa para NFCom — solo MG, MS y MT mantienen autoridad propia. |
| cStat |
Código de estado devuelto por la SEFAZ. 100 = autorizado, 107 = servicio operando, 108 = en mantenimiento, 109 = servicio paralizado, 135 = evento aceptado (cancelación OK), 3xx/4xx = rechazos. |
| Protocolo |
Número de 15 dígitos que la SEFAZ devuelve cuando autoriza la NFCom. Es la prueba jurídica de que el documento fue aceptado. |
| DANFE-COM
|
Documento Auxiliar de la NFCom — el PDF que va al cliente. Espejo visual del XML, con QR Code que permite consultar la nota en el portal de la SEFAZ. |
| Evento 110111 |
Tipo de evento "Cancelación de NFCom". Cuando cancelás, Quaza envía un XML específico (no otra NFCom) con ese código. |
| Inutilización |
Distinto de cancelación. Inutilizar marca un número de nota como nunca usado (cuando hubo salto de numeración). No cancela el contenido de una nota emitida. |
| Ambiente |
1 = Producción (valor fiscal real). 2 = Homologación (pruebas — la NFCom emitida en homologación no vale). |
| Serie fiscal |
Secuencia numérica aislada por modelo+ambiente. Ej: serie 1 de NFCom en producción empieza en 1, 2, 3... y es independiente de la NFe modelo 55. |
Configuración — prerrequisitos
Antes de emitir la primera NFCom necesitás tener todos los ítems de abajo configurados. Si falta uno, Quaza va a rechazar la transmisión (o transmite y la SEFAZ rechaza).
Empresa fiscal (NFe)
Fiscal → Empresa NFeTodo lo de la emisora queda en una sola pantalla, en pestañas:
-
Datos generales: CNPJ, razón social, dirección, inscripción estadual, régimen tributario, CNAE, UF.
-
Certificado A1 (pestaña Certificado): subir el
.pfx + clave. Vence anualmente — programá recordatorio 30 días antes.
-
Ambiente: empezá en
Homologación para probar; pasá a Producción solo cuando todo el ciclo (emisión+cancelación) funcione.
Serie fiscal modelo 62
Fiscal → Serie fiscalCreá al menos una serie modelo 62 por ambiente (homol. y prod. son separadas — no compartas numeración).
Naturaleza de operación
Fiscal → Naturaleza de operaciónEl CFOP de la NFCom es de la familia 5300/6300 (prestación de servicio de comunicación). Configurá al menos una naturaleza para "Internet — dentro del estado" y otra para "Internet — fuera del estado".
Producto fiscal
Stock → Producto fiscalCada plan (Internet 100MB, 300MB, telefonía VoIP) necesita un producto fiscal vinculado. El producto lleva CST/CSOSN, alícuota ICMS, código de servicio.
Categoría del plan → modelo NFCom
Stock → CategoríaLa categoría dice "esta venta emite modelo 62". Sin eso, el cron de facturación genera NFe o NFSe en lugar de NFCom.
Template de e-mail
Comunicación → Templates → NFCOM_ENVIOModelo estándar usado por el botón "Enviar e-mail" de la NFCom. Sin template configurado, el botón queda inerte.
Estado de adhesión: no todas las UFs liberaron NFCom 100%. Antes de pasar a producción, confirmá con la SEFAZ de tu estado si hay ventana activa y a qué ambiente (SVRS o propio) hay que apuntar. Los endpoints están en la sección
Endpoints SEFAZ por UF
.
Pantalla de NFCom — listado y detalle
El módulo NFCom tiene dos pantallas que trabajan juntas: un listado con todas las notas (filtrables por situación/competencia/cliente) y un formulario de detalle de cada nota individual (revisar, editar, procesar, transmitir, cancelar). Navegás del listado al detalle haciendo clic en el ícono de la 1ª columna; volvés con el botón "Atrás" del navegador o por el menú lateral.
Listado
Fiscal → NFCom
Lista todas las NFCom (espejos, creadas, transmitidas, protocoladas, rechazadas, canceladas) con filtros por período, situación, cliente, serie, ambiente.
Listado de NFCom — la 1ª columna (marcada en rojo) tiene el ícono de editar (lápiz): hacé clic en él para abrir el detalle de la nota. Las demás columnas muestran número, cliente, valor, emisión, situación y fecha de transmisión.
| Columna |
Qué muestra |
| Número |
Número fiscal secuencial de la serie. Vacío en los espejos (todavía no promovidos). |
| Cliente |
Destinatario de la nota — el link abre el alta del cliente. |
| Valor |
Suma de los ítems de la NFCom (mensualidad del plan + complementos). |
| Emisión |
Fecha de emisión de la nota (normalmente el día de la facturación, no el vencimiento). |
| Situación |
Espejo, Creada, Transmitida, Protocolada, Rechazada, Cancelada, Inutilizada — ver tabla Estados
. |
| Fecha Transmisión |
Cuándo se envió el XML a la SEFAZ por primera vez. Vacío si todavía no se transmitió. |
Filtros útiles en el día a día:
-
Situación = Rechazada → cola de notas que requieren corrección urgente.
-
Situación = Espejo + Competencia = mes corriente → lo que falta promover/transmitir del mes.
-
Cliente = X → historial fiscal completo de un cliente (útil para soporte).
Detalle / formulario
Fiscal → NFCom → [clic en el ícono de la 1ª columna (Código)]
Es donde revisás/editás los datos antes de transmitir, y desde donde disparás todas las acciones (generar, procesar, cancelar, descargar XML, imprimir DANFE, etc).
Formulario de la NFCom — encabezado (cliente, emisión, serie, situación), ítems (planes facturados), totalizadores y barra de acciones en el pie.
Bloques del formulario
| Bloque |
Contenido |
| Identificación |
Número, serie, modelo (62), fecha de emisión, competencia, ambiente (homologación/producción), naturaleza de operación. |
| Emitente |
Empresa NFe seleccionada — completa CNPJ, razón social, dirección, IE automáticamente. |
| Destinatario |
Cliente de la nota — viene del contrato. Editá con cuidado: cambiar destinatario también cambia la CFOP (dentro/fuera del estado). |
| Suscriptor |
Cuando el pagador (destinatario) es distinto del consumidor real del servicio (ej: empresa pagando la NFCom de un empleado). Normalmente vacío. |
| Ítems |
Cada plan/servicio cobrado. Línea = producto fiscal + descripción + valor + tributación. |
| Totales |
Valor base, ICMS, PIS, COFINS, FUST, FUNTTEL, valor de la nota. |
| Información adicional |
Texto libre que aparece en el DANFE — útil para "Pagado por débito automático" u observaciones fiscales. |
| Barra de acciones |
Botones del pie — ver sección Acciones disponibles
. |
Estados de la nota y transiciones
Cada NFCom tiene una situación (campo numérico en la base; mostrado como etiqueta en pantalla). La transición entre estados depende de una acción específica.
| Código |
Nombre |
Qué significa |
Próxima acción posible |
| 90 |
Espejo |
Borrador generado por el cron de facturación. Sin número fiscal. Sin valor jurídico. |
Generar nota → pasa a Creada. O descartar. |
| 1 |
Creada |
Promovida desde el espejo. Recibió número fiscal. Todavía no fue a la SEFAZ.
|
Procesar → pasa a Transmitida. |
| 2 |
Transmitida |
XML enviado a la SEFAZ. Esperando autorización (cStat aún no 100). |
Consultar → cuando se autoriza, pasa a Protocolada. |
| 3 |
Protocolada |
Autorizada por la SEFAZ. Tiene número de protocolo. Tiene valor fiscal.
|
Imprimir DANFE, enviar al cliente. Cancelar (hasta 24h). |
| 4 |
Rechazada |
SEFAZ devolvió error (ej: cStat 539, 540, 597). El XML no fue aceptado. |
Corregir y retransmitir. Vuelve a Transmitida. |
| 5 |
Inutilizada |
Número de nota marcado como nunca usado (corrigiendo salto de numeración). |
No hay — estado terminal. |
| 99 |
Cancelada |
Cancelación aceptada por la SEFAZ vía evento 110111. |
No hay — estado terminal. |
Atención al reciclaje de número: número fiscal usado en nota Rechazada sigue válido — al corregir y retransmitir, la SEFAZ acepta el mismo número. En cambio, una nota Inutilizada quema ese número para siempre.
Anatomía del XML
El XML de la NFCom es versión 1.00, namespace http://www.portalfiscal.inf.br/nfcom. Quaza arma cada bloque con clases en service/fiscal/nfcom/xml/. Raramente vas a tener que abrir el XML, pero conocer la estructura ayuda a entender errores de la SEFAZ.
<NFCom xmlns="http://www.portalfiscal.inf.br/nfcom" versao="1.00">
<infNFCom Id="NFCom43260512345..." versao="1.00">
<ide>
<cUF>43</cUF> # codigo de la UF del emitente
<mod>62</mod> # modelo fiscal (62 = NFCom)
<serie>1</serie>
<nNF>12345</nNF> # numero secuencial de la serie
<dhEmi>2026-05-12T10:00:00-03:00</dhEmi>
<competencia>2026-05</competencia> # mes/anio del servicio (AAAA-MM)
</ide>
<emit> # emitente (tu empresa fiscal)
<CNPJ>12345678000100</CNPJ>
<xNome>Empresa Exemplo LTDA</xNome>
<enderEmit>...</enderEmit> # direccion completa
<IE>1234567890</IE>
</emit>
<dest> # destinatario (cliente)
<CPF>12345678901</CPF> # o CNPJ si es PJ
<xNome>Cliente Exemplo</xNome>
<enderDest>...</enderDest>
<IE>ISENTO</IE> # o IE valida de la UF del cliente PJ
</dest>
<assinante> # consumidor real, cuando != destinatario
<CPF>...</CPF>
<xNome>...</xNome>
</assinante>
<det nItem="1"> # 1 bloque por item de servicio
<prod>
<cProd>INTERNET-100M</cProd>
<xProd>Internet 100 Mbps</xProd>
<NCM>00</NCM>
<CFOP>5301</CFOP> # 5xxx dentro del estado / 6xxx fuera
<vProd>89.90</vProd>
</prod>
<imposto>
<ICMS>...</ICMS> # CST/CSOSN + alicuota + valor
<PIS>...</PIS>
<COFINS>...</COFINS>
<FUST>...</FUST> # 1% recaudacion telecom
<FUNTTEL>...</FUNTTEL> # 0,5% recaudacion telecom
</imposto>
</det>
<total> # totalizadores
<vBC>89.90</vBC>
<vICMS>22.48</vICMS>
<vPIS>0.58</vPIS>
<vCOFINS>2.70</vCOFINS>
<vNF>89.90</vNF> # valor total de la nota
</total>
<infAdic> # observaciones textuales
<infCpl>Pagado por debito automatico</infCpl>
</infAdic>
</infNFCom>
<infNFComSupl> # completado tras autorizacion
<qrCodNFCom>https://...</qrCodNFCom>
</infNFComSupl>
<Signature>...</Signature> # firma digital con certificado A1
</NFCom>
Campos que más generan rechazo:
-
ide/competencia — formato AAAA-MM, debe coincidir con la competencia de la factura.
-
dest/IE — cuando el cliente es PJ, la IE tiene que ser válida y consistente con la UF de la dirección. Cliente sin IE: usar ISENTO.
-
det/imposto/ICMS/CST — depende del régimen tributario (Lucro Real/Presumido = CST; Simples Nacional = CSOSN). Confundirlo es la causa #1 de rechazo.
-
det/CFOP — 5301/5302/5303 (dentro del estado) vs 6301/6302/6303 (fuera). Errar la UF del destinatario derriba la CFOP.
Pantalla de agregar/editar — barra de acciones
La pantalla de edición (y de creación manual) de cualquier NFCom muestra un panel lateral fijo a la derecha con los botones de acción contextual. Ese panel — internamente llamado caixa-maneira en el código de Quaza — tiene 230px de ancho, queda pegado al borde derecho y acompaña el scroll. Vas a ver el mismo patrón en todos los módulos fiscales (NFe, NFSe, NFCe, NFCom).
Barra caixa-maneira en NFCom Protocolada — botones visibles: 1 (Probar SEFAZ), 4 (Consultar), 8 (Cancelar), 9 (Enviar e-mail), 10 (Enviar WhatsApp), 11 (Ver cliente). Los botones 2 (Procesar), 3 (Generar nota), 5 (XML), 6 (XML Cancelación) y 7 (Imprimir) solo aparecen en otras situaciones — ver tabla abajo.
Botones contextuales: no todos aparecen siempre. Cada botón tiene una condición de exhibición según la situación actual de la nota — ej: Cancelar solo aparece en notas Protocoladas; Generar nota solo aparece cuando la nota está como Espejo. Es a propósito: evita que ejecutes una acción inválida y termines con rechazo de la SEFAZ.
Además de la caixa-maneira, en el tope de la pantalla están los botones estándar de cualquier formulario Quaza: Guardar y Cancelar (gestionados por la clase base del formulario, no por la caixa-maneira).
Botones de la caixa-maneira (en orden de exhibición)
| # |
Botón |
Color |
Cuándo aparece |
Qué hace |
| 1 |
Probar conexión SEFAZ |
verde |
Siempre |
Hace una llamada de estado a la SEFAZ. Devuelve cStat 107 (operando), 108 (en mantenimiento) o 109 (paralizado). Usalo antes de transmitir un lote para no acumular Rechazadas. |
| 2 |
Procesar |
amarillo |
Cuando la nota NO está en Protocolada, Cancelada ni Espejo |
Guarda el registro, arma XML, valida XSD, firma con certificado A1 y transmite vía SOAP. Pasa a Transmitida (2) o Rechazada (4) según el retorno. |
| 3 |
Generar nota |
violeta |
Espejo (90) |
Promueve el espejo a NFCom oficial. Asigna número de la serie y cambia situación a Creada (1). Abre popup de confirmación antes de generar. |
| 4 |
Consultar |
rojo |
Cuando la nota ya tiene llave de acceso generada |
Pregunta a la SEFAZ "¿esta NFCom ya fue autorizada?". Útil cuando la transmisión original tuvo timeout — evita transmitir de nuevo (y duplicar). |
| 5 |
XML |
— |
Cuando el archivo XML existe y la nota tiene llave |
Abre el XML firmado en pestaña nueva. Botón también sirve como descarga (guarda en Descargas). Útil para depurar y para mandarle al contador. |
| 6 |
XML Cancelación |
— |
Cuando existe protocolo de cancelación (situación Cancelada) |
Muestra el XML del evento de cancelación (no el XML original de la NFCom). |
| 7 |
Imprimir |
celeste |
Cuando XML existe y nota tiene llave (Transmitida/Protocolada) |
Genera el PDF (DANFE-COM) con QR Code. Abre en pestaña nueva. |
| 8 |
Cancelar |
rojo |
Protocolada (3) o Espejo (90) |
Abre popup pidiendo justificación (mínimo 15 caracteres). En Protocolada, dispara el evento 110111 (válido solo en las primeras 24h); en Espejo, descarta el borrador. |
| 9 |
Enviar por e-mail |
amarillo |
Protocolada + cliente vinculado |
Envía el DANFE al e-mail del cliente usando el template NFCOM_ENVIO. |
| 10 |
Enviar por WhatsApp |
verde |
Protocolada + cliente vinculado |
Abre web.whatsapp.com con mensaje preparada + link del DANFE. Vos confirmás el envío manualmente. |
| 11 |
Ver cliente |
celeste |
Siempre |
Abre el alta del cliente en pestaña nueva. |
Pista visual: el
color del botón en la
caixa-maneira indica el "peso" de la acción:
-
verde — acción segura/informativa (probar conexión, enviar WhatsApp).
-
celeste — informativo (ver cliente, generar DANFE).
-
amarillo — operación que cambia situación o invoca a terceros (procesar, enviar e-mail).
-
rojo — acción delicada/destructiva (cancelar, consultar estado).
-
violeta — transición de flujo importante (generar nota desde el espejo).
DANFE — el PDF
El DANFE-COM (Documento Auxiliar de la NFCom) es el PDF que Quaza genera tras la autorización de la SEFAZ. No es la nota fiscal — la nota fiscal es el XML. El DANFE es solo una representación visual con QR Code que permite consultar el XML en el portal nacional.
| Característica |
Detalle |
| Prerrequisito |
NFCom Transmitida (2) o Protocolada (3). No se puede imprimir Espejo ni Creada. |
| Generación |
Report\Nfcom\Nfcom vía TCPDF (lib en third/pdf/tcpdf/). |
| Contenido |
Encabezado con llave de acceso, datos del emitente, destinatario, suscriptor, lista de ítems, totalizadores, QR Code, número de protocolo. |
| Distribución |
E-mail (template NFCOM_ENVIO), WhatsApp (link manual) o portal del cliente (auto-descarga). |
QR Code del DANFE: apunta al endpoint público de la SEFAZ (misma URL que usan los consumidores para consultar NFCom). El cliente puede escanear con cualquier lector y ver los datos de la nota. En homologación, el QR Code apunta al ambiente de homologación — útil para pruebas.
Cancelación y CCe
Cancelación (evento 110111)
Una NFCom Protocolada se puede cancelar hasta 24 horas después de la autorización. Quaza envía un evento — un XML separado, no otra NFCom — con tipo 110111. La SEFAZ valida y responde con cStat:
| cStat devuelto |
Qué significa |
135 |
Evento aceptado. La NFCom pasa a Cancelada (99). |
136 |
Evento aceptado pero no vinculado (raro). |
573 |
Duplicidad — ya cancelaste esa nota. |
501 |
Plazo de cancelación vencido (pasaron las 24h). |
4xx-5xx |
Justificación inválida, certificado equivocado, etc — corregí y reintentá. |
¿Pasaron más de 24h? Ya no se puede cancelar. Alternativas:
-
Carta de Corrección (CCe) — solo para ajustes textuales (información adicional, observaciones). NO corrige valores ni destinatario.
-
Emitir NFCom de ajuste con signo contrario (rarísimo en telecom — lo más común es dejar la nota y ajustar en la competencia siguiente).
- En última instancia, proceso administrativo en la SEFAZ para desconsiderar la nota — puede llevar semanas y requiere contador.
CCe — Carta de Corrección
La SEFAZ permite Carta de Corrección para NFCom solo en campos textuales (observación, descripción). No permite alterar: valores, alícuotas, número, serie, fecha de emisión, destinatario, CNPJ. Para esos casos, el camino es cancelar (si está en plazo) o ajustar en la competencia siguiente.
Endpoints SEFAZ por UF
Quaza decide automáticamente el endpoint SOAP de cada UF. No configurás URL — solo configurás la UF de la empresa fiscal y el ambiente (producción/homologación). Tabla de referencia:
| UF |
Autoridad |
Endpoint base (producción) |
| MG |
SEFAZ-MG |
nfcom.fazenda.mg.gov.br |
| MS |
SEFAZ-MS |
nfcom.sefaz.ms.gov.br |
| MT |
SEFAZ-MT |
sefaz.mt.gov.br |
| Demás UFs |
SVRS (delegado) |
nfcom.svrs.rs.gov.br |
En homologación, el subdominio cambia (ej: nfcom-homologacao.svrs.rs.gov.br). Los web services disponibles son: RECEPCAO (envío), CONSULTA (consulta de protocolo), STATUS_SERVICO (probar SEFAZ), RECEPCAO_EVENTO (cancelación, CCe), QRCODE (URL pública para QR Code del DANFE).
Cuando una UF entra en mantenimiento: el STATUS_SERVICO devuelve cStat 108. Quaza no bloquea la transmisión — podés enviar igual, pero la NFCom vuelve Rechazada. Esperá que la SEFAZ vuelva (1-3h en general) y reprocesá el lote.
Tributos calculados
Cada ítem de la NFCom tiene cálculo tributario propio, derivado del producto fiscal + régimen tributario + naturaleza de operación. Quaza calcula vía Service\Fiscal\NFCom\Nfcom::calculaValoresTributarios(). Los tributos que aparecen en el XML:
| Tributo |
Qué es |
Quién paga |
| ICMS-Comunicación |
Impuesto estadual sobre servicio de comunicación. Alícuota varía por UF (en general 25-29%, con excepciones). |
Proveedor |
| PIS |
Federal — base de cálculo el valor del servicio. Alícuota 0,65% (cumulativo) o 1,65% (no-cumulativo). |
Proveedor |
| COFINS |
Federal — base idem PIS. Alícuota 3% (cumulativo) o 7,6% (no-cumulativo). |
Proveedor |
| FUST |
Fondo de Universalización de los Servicios de Telecomunicaciones — 1% sobre receita bruta de telecom. |
Operadora |
| FUNTTEL |
Fondo de Telecomunicaciones — 0,5% sobre receita bruta de telecom. |
Operadora |
| CSLL/IR |
Contribución Social/IR retenidos cuando el destinatario PJ lo exige (raro en comunicación al consumidor). |
Proveedor |
| IBS / CBS |
Reforma tributaria — campos ya presentes en el XML (versión 1.00) pero en transición. Seguí las actualizaciones de la SEFAZ. |
Proveedor (futuro) |
Estados con exención/reducción de ICMS-Comunicación para internet residencial: algunos estados (ej: AM, AC) conceden exención o reducción para internet de baja renta. Configurá en el producto fiscal: CST 40 (exento) o 50 (suspensión), con base reducida. Errores de clasificación acá causan rechazo inmediato.
De dónde vienen los datos
La NFCom no tiene datos propios — agrega datos de varias entidades de Quaza. Saber el origen ayuda a encontrar el punto correcto de corrección cuando algo está mal.
Cómo leer errores y depurar
Dónde encontrar el mensaje de error
- Abrí la NFCom rechazada (situación 4).
- La pestaña "Retorno SEFAZ" muestra cStat + xMotivo (texto que vino de la SEFAZ).
- El botón "Ver XML" muestra el XML enviado — revisá si el campo señalado por el error está bien.
Códigos cStat más comunes en la NFCom
| cStat |
Mensaje típico |
Causa probable |
100 |
Autorizado el uso de la NFCom |
Éxito — situación Protocolada. |
107 |
Servicio en operación |
SEFAZ OK (status check). |
108 |
Servicio paralizado momentáneamente |
Mantenimiento. Esperá 1-3h. |
109 |
Servicio paralizado sin previsión |
SEFAZ caída. Esperar comunicado oficial. |
135 |
Evento registrado y vinculado a NFCom |
Cancelación aceptada. |
204 |
Duplicidad de NFCom |
Transmitiste la misma llave de acceso 2x. Usá "Consultar" en lugar de "Procesar". |
217 |
NFCom no consta en la base de datos de la SEFAZ |
Consultaste una nota que aún no llegó (error en la consulta, no en la emisión). |
501 |
Plazo de cancelación vencido |
Pasaron las 24h. Ya no se puede cancelar. |
539 |
Duplicidad de número |
Otro número de la misma serie fue reusado. Inutilizá el conflictivo o ajustá la serie. |
597 |
Rechazo: llave de acceso difiere del contenido |
Algún campo (CNPJ, año/mes, serie, número) cambió tras generar la llave. Reprocesá. |
703 |
Esquema XML inválido |
El XML no coincide con el XSD. Verificá si la versión del producto fiscal está actualizada. |
805 |
Certificado expirado |
Renová el A1. |
Checklist cuando "todo se rechazó ahora"
- Probá la conexión SEFAZ — si devuelve cStat 108/109, la SEFAZ está caída.
- Verificá la fecha de validez del certificado A1 — si venció, caen todas las transmisiones.
- Confirmá que el ambiente de la empresa NFe no se cambió por error (homologación ↔ producción).
- Mirá la pestaña "Retorno SEFAZ" de la primera nota rechazada — el motivo de la primera suele valer para las otras.
- Si todo está OK y sigue rechazando, abrí ticket con la SEFAZ o consultá con tu contador.
Trampas frecuentes
1. El espejo no tiene valor fiscal. Aparece en el listado como NFCom pero es solo borrador. El cliente que pide "2da vía" y vos mandás la impresión del espejo está recibiendo un documento sin valor. Confirmá siempre situación = Protocolada antes de enviar.
2. Homologación y Producción comparten listado. Quaza muestra notas de los 2 ambientes en la misma pantalla. Usá el filtro "Ambiente" para separar. Filtrando mal, podés creer que tenés 500 NFCom autorizadas cuando 200 son de homologación (sin valor).
3. La numeración de serie no puede saltar. SEFAZ exige secuencia contínua. Si falta un número (1, 2, 4 — saltó el 3), la próxima transmisión va a rechazar. Usá Inutilización para "quemar" el número 3 oficialmente.
4. Cancelar después de 24h no existe. No importa el motivo — cliente equivocado, valor mal, duplicado — pasaron las 24h, quedó. Seguí el plazo: filtro "Protocolada + emisión = ayer" muestra lo que todavía se puede cancelar hoy.
5. Cancelar no devuelve plata. Cancelar la NFCom es solo un acto fiscal — no revierte la cobranza en el financiero ni devuelve nada al cliente. Para revertir la cobranza usá
Renegociación
o estorno en
Caja
.
6. La Carta de Corrección es limitada. No corrige valores, número, destinatario, alícuota, serie. Solo ajustes en campos textuales (observación, infAdic). Para errores de valor: cancelar en plazo o ajustar competencia siguiente.
7. Cliente PJ exige IE válida. NFCom para empresa requiere Inscripción Estadual válida en la UF de la dirección. Cliente PJ sin IE: usar ISENTO. Errar acá = cStat 226/227.
8. Cambiar el régimen tributario de la empresa cambia el CST. Empresa Lucro Presumido usa CST (00, 10, 20...). Empresa Simples Nacional usa CSOSN (101, 102...). ¿Cambiaste de régimen a mitad de año? Actualizá todos los productos fiscales.
9. Actualizar la versión XSD puede romper la emisión. Cuando la SEFAZ libera versión nueva (ej: 1.00 → 1.10), Quaza tiene que actualizar los schemas en service/fiscal/nfcom/schemas/. Antes de aplicar update del sistema con nueva versión XSD, hacé smoke test en homologación.
10. NFCom no es factura — es nota fiscal. La factura (financiero) sale aunque la NFCom rechace. No dependas de la NFCom para cobrar — el boleto/Pix sale aparte. Lo único que no le das al cliente es el documento fiscal hasta que la NFCom protocole.
FAQ
¿Quién está obligado a emitir NFCom?
Cualquier prestador de servicio de comunicación en Brasil que antes emitía modelo 21 o 22, en la medida en que su UF haya adherido al calendario de migración definido por el Ajuste SINIEF 07/2022. Internet residencial, empresarial, telefonía fija, móvil, VoIP, TV por suscripción — todo entra.
¿Puedo emitir NFCom de prueba?
Sí — configurá el ambiente de la Empresa NFe como Homologación (2). Las notas emitidas en homologación no tienen valor fiscal, pero todo el flujo (XML, firma, transmisión, DANFE) funciona idéntico. Usalo para entrenar al equipo y validar productos fiscales antes de pasar a producción.
¿Cómo sé si la SEFAZ está caída antes de transmitir un lote grande?
Usá el botón Probar conexión SEFAZ en cualquier NFCom. Si devuelve cStat 107, está OK. Si 108 o 109, esperá. Los proveedores grandes que transmiten miles por día agendan transmisiones en horarios conocidos de menos mantenimiento (madrugada).
El cliente perdió el e-mail con la NFCom — ¿cómo lo reenvío?
Abrí la NFCom y hacé clic en Enviar e-mail de nuevo. Va a usar el template NFCOM_ENVIO y enviarlo a la dirección actual del cliente. Si el e-mail está desactualizado: corregí el alta del cliente primero y después reenviá.
NFCom rechazada con cStat 539 (duplicidad de número) — ¿qué hago?
Significa que otra nota de la misma serie usó ese número. Verificá la serie fiscal — probablemente alguien creó una nota manual con número fuera de secuencia. Usá Inutilizar en el número conflictivo (si realmente nunca se usó) o ajustá la numeración de la serie al próximo disponible.
Migré del sistema X — ¿cómo importo el historial de notas?
El historial de NFE 21/22 no se convierte en NFCom (son modelos distintos). Mantené el historial en el sistema antiguo para consulta. Para el historial contable, exportá los XMLs del sistema antiguo y archivalos — la SEFAZ acepta consulta retroactiva por llave de acceso durante 5 años.
Cancelé después de 24h — ¿y ahora?
No se cancela. Opciones: emitir Carta de Corrección (solo texto, no valor), abrir proceso administrativo en la SEFAZ (caro/lento) o ajustar en la competencia siguiente (lo más común — emitís la próxima NFCom con valor compensatorio).
¿Empresa Simples Nacional emite NFCom?
Sí — la obligación no depende del régimen tributario. Lo único que cambia es el tratamiento de impuestos: Simples usa CSOSN en lugar de CST, y el ICMS se recauda vía DAS (no destacado en la nota). Configurá eso en el producto fiscal.
Usé la serie equivocada — ¿cómo corrijo?
Si la NFCom ya fue protocolada: cancelala (en 24h) y emití de nuevo en la serie correcta. Si pasaron las 24h: dejá la nota como está, ajustá lo operacional para emitir las próximas en la serie correcta y hablá con el contador sobre el impacto del desvío de numeración.
¿Puedo editar la NFCom después de Protocolada?
No. Protocolada es estado fiscal definitivo. Si te equivocaste: cancelás (24h) o Carta de Corrección (texto) o compensás en la siguiente.
Documentos relacionados