Central de Ajuda Quaza Provedores

NFCom — Nota Fiscal de Comunicación (ES-PY)

NFCom — Nota Fiscal de Comunicación — Quaza

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.

Por qué existe la NFCom

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 NFe

Todo 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 fiscal

Creá 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ón

El 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 fiscal

Cada 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ía

La 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_ENVIO

Modelo 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

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

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).

caixa-maneira NFCom anotada

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:
  1. Carta de Corrección (CCe) — solo para ajustes textuales (información adicional, observaciones). NO corrige valores ni destinatario.
  2. 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).
  3. 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.

Campo de la NFCom Origen
Emitente (CNPJ, IE, dirección) Empresa NFe elegida en la nota
Destinatario (cliente, CPF/CNPJ, dirección) Alta del cliente
Ítems (planes, valores) Contrato + Factura
Producto fiscal (NCM, CST, alícuota) Stock → Producto fiscal
Categoría → modelo Stock → Categoría (campo "Modelo fiscal" = 62)
Serie + numeración Fiscal → Serie fiscal
Certificado, ambiente Fiscal → Empresa NFe → pestaña Certificado
Competencia Cron de facturación — mes/año de la factura generadora
Vínculo financiero idFinanceiro — apunta a la factura/débito del cliente

Cómo leer errores y depurar

Dónde encontrar el mensaje de error

  1. Abrí la NFCom rechazada (situación 4).
  2. La pestaña "Retorno SEFAZ" muestra cStat + xMotivo (texto que vino de la SEFAZ).
  3. 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"

  1. Probá la conexión SEFAZ — si devuelve cStat 108/109, la SEFAZ está caída.
  2. Verificá la fecha de validez del certificado A1 — si venció, caen todas las transmisiones.
  3. Confirmá que el ambiente de la empresa NFe no se cambió por error (homologación ↔ producción).
  4. Mirá la pestaña "Retorno SEFAZ" de la primera nota rechazada — el motivo de la primera suele valer para las otras.
  5. 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