NFSe Brasil — Nota Fiscal de Servicio (foco en el estándar Nacional unificado + providers legados)
Esta wiki cubre el módulo NFSe de Quaza de punta a punta: qué es, por qué el estándar Nacional unificó (y casi jubiló) los webservices municipales, cómo Quaza arma el DPS, lo transmite al SEFIN Nacional, recibe el protocolo y genera el DANFSE; qué acciones ejecutás en cada nota, cómo cancelar, cómo leer errores. Audiencia: equipo fiscal y operadores de proveedores de internet que facturan servicios (instalación, soporte, mensualidad cuando se enmarca como ISS, etc.). Atención: NFSe es documento fiscal de Brasil — si tu empresa solo opera en Paraguay o Argentina, esta wiki es referencia/contexto.
Resumen en una línea: NFSe es la nota fiscal electrónica obligatoria para servicios en Brasil. Históricamente cada una de las 5.500+ alcaldías tenía su propio webservice y layout (ABRASF, Ginfes, Issnet, Tecnospeed…). Desde 2024, el NFSe Estándar Nacional, gestionado por la Receita Federal (servidor SEFIN Nacional + portal ADN), está unificando ese caos — la mayoría de las alcaldías ya adhirió. Quaza soporta el Estándar Nacional + 3 providers legados (Tecnospeed, Tecnos, Abase).
Por qué existe el Estándar Nacional
Hasta 2023, el ISS (Impuesto Sobre Servicios) se recaudaba alcaldía por alcaldía, y cada una definía su propio estándar de NFSe: webservice distinto, layout XML distinto, endpoint distinto, credencial distinta. Esto obligó a sistemas como Quaza a integrar con decenas de "providers" (Tecnospeed, Ginfes, Issnet, Tinus, Govdigital, Megasoft, Sigiss, ABRASF v1, ABRASF v2…) para cubrir municipios diferentes.
La Ley Complementaria 157/2016 y el Convenio NFS-e (ENAT 2022) instituyeron el Estándar Nacional de la NFS-e, con servidor único de la Receita Federal — el SEFIN Nacional — y portal de consulta unificado — el ADN (Ambiente de Datos Nacional). Desde 2024 la adhesión es progresiva: hoy la mayoría de las capitales y grandes ciudades ya está en el Estándar Nacional, y los municipios más chicos van migrando a lo largo de 2025-2026.
| Antes del Estándar Nacional |
Con el Estándar Nacional |
| Cada alcaldía tiene su webservice, layout, credencial |
Servidor único de la RFB (sefin.nfse.gov.br), layout XML único (DPS), credencial certificado A1 |
| XML en estándares distintos (ABRASF v1, v2, Ginfes, Issnet…) |
Schema único DPS_v1.00.xsd / v1.01.xsd
|
| Comunicación SOAP (WSDL) en la mayoría |
Comunicación REST (JSON) con certificado PEM |
| DANFSE con layout propio por alcaldía |
DANFSE único generado por el ADN (adn.nfse.gov.br) |
| Cancelación varía (algunas solo en el mes de emisión) |
Cancelación estandarizada vía evento 101101, sin restricción de mes |
| Proveedor debe integrar con cada alcaldía |
1 integración cubre todas las alcaldías adheridas |
Cómo saber cuál usar: depende de la alcaldía del establecimiento de la empresa fiscal. En Fiscal → Empresa NFSe Config → Tipo de Integración elegís entre Nacional, Tecnospeed (legado más amplio), Tecnos o Abase. Para municipios ya en el Estándar Nacional, usá Nacional; para municipios no migrados, Quaza usa uno de los 3 legados según el sistema que la alcaldía haya elegido.
Los 4 providers que Quaza soporta
| # |
Provider |
Cuándo usar |
Comunicación |
Endpoint |
| 1 |
Estándar Nacional |
Alcaldía ya migró al Estándar Nacional (la mayoría de ciudades grandes desde 2024) |
REST/JSON + certificado A1 |
sefin.nfse.gov.br (emisión), adn.nfse.gov.br (PDF) |
| 2 |
Tecnospeed (legado) |
Alcaldía usa Tecnospeed como provider (sistema legado más popular antes del Nacional) |
SOAP/XML + token Basic |
Variable por municipio |
| 3 |
Tecnos (legado) |
Alcaldía usa sistema de Tecnos |
REST/JSON + token |
Endpoint custom en linkTecnosNfse
|
| 4 |
Abase (legado) |
Alcaldía usa sistema Abase |
REST/JSON + API Key |
Variable; configurado en abaseApiKey
|
Dirección de la migración: la tendencia es que todas las alcaldías migren al Estándar Nacional en los próximos años. Proveedores en municipios ya migrados deben cambiar a Nacional en cuanto sea posible — la integración es más simple, estandarizada y cubre las próximas regulaciones.
Flujo general — del espejo al DANFSE
CRON DE FACTURACION QUAZA (servidor) SEFIN Nacional ADN
| | | |
| 1. Servicio cobrado | | |
|------------------------->| | |
| | 2. Crea NFSe Creada (1) | |
| | sin numero fiscal | |
| | | |
| OPERADOR (vos) | | |
|------------------------->| | |
| 3. Revisa datos | |
| | | |
| 4. Clic "Transmitir" | | |
|------------------------->| | |
| | 5. Arma DPS XML | |
| | Valida contra XSD | |
| | Firma con cert A1 | |
| | Empaqueta en JSON | |
| | POST -> SEFIN | |
| |--------------------------->| |
| | | 6. SEFAZ valida|
| | | Devuelve |
| | | chave+idDps |
| |<---------------------------| |
| | 7. situacion = TRANSMITIDA | |
| | | |
| 8. Clic "Consultar" | | |
|------------------------->| | |
| | 9. Status -> SEFIN | |
| |--------------------------->| |
| | | Autorizada |
| |<---------------------------| |
| | 10. situacion= PROTOCOLADA | |
| | | |
| 11. Clic "DANFSE" | | |
|------------------------->| | |
| | 12. GET DANFSE -> ADN | |
| |---------------------------------------------|--->
| | | PDF |
| |<--------------------------------------------|
| | Envia al cliente | |
Leé el diagrama así: el ciclo es Creada → Transmitida → Protocolada → DANFSE. La transmisión usa el servidor SEFIN (REST), y la obtención del PDF usa otro servidor — el ADN.
Glosario
| Término |
Qué es |
| NFSe |
Nota Fiscal de Servicio Electrónica — documento fiscal que comprueba prestación de servicio y calcula el ISS (impuesto municipal brasileño). |
| Estándar Nacional |
Layout XML único y webservice único (RFB) que reemplaza los webservices municipales. En transición: no todas las alcaldías adhirieron todavía. |
| DPS |
Documento de Prestación de Servicio — el XML que el emisor envía al SEFIN. Es el "borrador" firmado de la NFSe; cuando el SEFIN lo acepta, se vuelve NFSe oficial. |
| SEFIN Nacional |
Sistema Electrónico de Fiscalización del ISS — servidor de la Receita Federal que recibe los DPS y devuelve la llave de acceso. Endpoint: sefin.nfse.gov.br. |
| ADN |
Ambiente de Datos Nacional — servidor separado que genera el PDF del DANFSE y lo expone para consulta. Endpoint: adn.nfse.gov.br. |
| DANFSE |
Documento Auxiliar de la NFSe — el PDF que va al cliente. No es la nota fiscal; es solo representación visual del XML. |
| Llave de acceso |
Identificador único de 50 caracteres de la NFSe (generado por el SEFIN). Distinta de la llave de la NFe (44 dígitos). |
| RPS |
Recibo Provisorio de Servicios — usado en algunos providers legados (Tecnospeed) para transmisión en lote o contingencia. En el Estándar Nacional el concepto de RPS se reemplaza por el DPS. |
| Código de servicio |
Clasificación del servicio prestado según la Lista de Servicios (LC 116/2003). Define la alícuota de ISS y el municipio competente. Registrado en nfseProduto.codServico. |
| CNAE municipal |
Código de Clasificación Nacional de Actividades Económicas reconocido por el municipio. Vincula la empresa a la actividad. No confundir con CNAE federal. |
| ISS |
Impuesto Sobre Servicios — impuesto municipal, alícuota 2% a 5% (LC 116/2003). Recaudado por la alcaldía del local de prestación (regla general; hay excepciones). |
| Tomador |
El cliente que paga el servicio (≠ destinatario NFe; mismo concepto, nombre distinto). |
| Prestador |
La empresa que presta el servicio (≠ emitente NFe; mismo concepto). |
| Retención de ISS |
Cuando el tomador es responsable tributario, retiene el ISS en la fuente (ej: contratos con órganos públicos). Quaza lo señaliza en el DPS. |
| Evento 101101 |
Tipo de evento "Cancelación de NFSe" en el Estándar Nacional. Cuando cancelás, Quaza envía un XML de evento con ese código. |
| Ambiente |
1 = Producción (valor fiscal real). 2 = Homologación (pruebas — NFSe en homologación no vale). |
| Versión DPS |
El Estándar Nacional tiene dos versiones publicadas: v1.00 y v1.01. Configurado en nfseEmpresaConfig.nfseNacionalVersao. |
Configuración — prerrequisitos
Antes de emitir la primera NFSe necesitás configurar la Empresa NFSe Config. Es allí que Quaza decide qué provider usar, qué versión del schema, ambiente, certificado, etc.
Empresa NFSe Config
Fiscal → Empresa NFSe ConfigTodo en una sola pantalla, en campos:
-
Tipo de Integración:
Nacional (recomendado cuando el municipio ya adhirió), Tecnospeed, Tecnos o Abase.
-
Versión DPS (solo Nacional):
v1.00 o v1.01 según lo que tu UF/municipio acepte.
-
Ambiente: empezá en
Homologación para probar; pasá a Producción solo cuando todo el ciclo (emisión + cancelación) funcione.
-
Certificado A1 (pestaña Certificado): mismo de la NFe — subir el
.pfx + clave. Vence anualmente — programá recordatorio 30 días antes.
-
Credencial del provider legado (si Tecnospeed/Tecnos/Abase): clave/token/API Key + URL custom cuando corresponda.
-
Municipio: nombre de la ciudad (
nomeCidadeNfse) — usado para ruteo y para completar el DPS.
-
RPS: ID inicial, tipo, serie, grupo — relevante para legados; el Estándar Nacional usa numeración centralizada.
Servicio (LC 116/2003)
Stock → Producto fiscal NFSeCada servicio cobrado (instalación, soporte técnico, mantenimiento) debe estar registrado como producto fiscal NFSe, con:
-
Código de Servicio LC 116 (
codServico): obligatorio, define la tributación.
-
Código de Tributación Municipal (
codServicoTributacao): si el municipio exige código propio (varía por ciudad).
-
CNAE municipal (
codCnae): clase de actividad reconocida por la alcaldía.
-
Alícuota ISS default (
issAliquota): 2-5% según tabla LC 116 + ley municipal.
-
Alícuotas PIS/COFINS (si corresponde).
Template de e-mail
Comunicación → Templates → NFSE_ENVIOModelo estándar usado por el botón "Enviar e-mail" de la NFSe. Sin template configurado, el botón queda inerte.
¿Municipio todavía no adhirió al Nacional? Consultá en el portal www.gov.br/nfse la lista de adhesiones. Si todavía no está, configurá uno de los 3 providers legados. Podés cambiar después: cambiá el Tipo de Integración a Nacional el día que la alcaldía migre.
Pantalla de NFSe — listado y detalle
El módulo NFSe tiene dos pantallas que trabajan juntas: un listado con todas las notas (filtrables por situación/competencia/cliente/municipio) y un formulario de detalle de cada nota individual. 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.
Listado
Fiscal → NFSe
Lista todas las NFSe (creadas, transmitidas, protocoladas, rechazadas, canceladas) con filtros por período, situación, cliente, provider, ambiente.
Listado de NFSe — la columna marcada en rojo tiene el ícono de editar (lápiz): hacé clic ahí para abrir el detalle de la nota. La columna anterior, de la impresora, baja el DANFSE directo.
| Columna |
Qué muestra |
| Número |
Número fiscal de la NFSe. Vacío en Creada hasta que la SEFAZ lo devuelva. |
| Emisión |
Fecha de emisión de la nota. |
| Valor total |
Valor bruto del servicio. |
| Descripción del servicio |
Texto libre que describe el servicio prestado (va en el DPS y en el DANFSE). |
| Situación |
Creada, Transmitida, Protocolada, Rechazada, Cancelada (ver Estados
). |
| Cliente / Tomador |
El cliente del proveedor. |
Detalle / formulario
Fiscal → NFSe → [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 (transmitir, cancelar, consultar, obtener DANFSE, obtener XML, etc).
Formulario de edición de la NFSe — encabezado, ítems (servicios), totalizadores, retención, descripción.
Estados de la nota y transiciones
| Código |
Nombre |
Qué significa |
Próxima acción posible |
| 1 |
Creada |
Generada en el sistema. Todavía no fue a la alcaldía/SEFIN. |
Transmitir → pasa a Transmitida. |
| 2 |
Transmitida |
DPS enviado al SEFIN. Esperando autorización. |
Consultar → cuando se autoriza, pasa a Protocolada. |
| 3 |
Protocolada |
Autorizada por la alcaldía/SEFIN. Tiene llave de acceso. Tiene valor fiscal.
|
Obtener DANFSE, enviar al cliente. Cancelar (regla varía). |
| 4 |
Rechazada |
SEFIN devolvió error. El XML no fue aceptado. |
Corregir y retransmitir. Vuelve a Transmitida. |
| 99 |
Cancelada |
Cancelación aceptada por el SEFIN vía evento 101101 (Nacional) o anulación en el provider legado. |
No hay — estado terminal. |
Estándar Nacional vs Legado — cancelación:
-
Nacional: sin restricción de plazo — podés cancelar incluso tras el mes de emisión. Siempre vía evento 101101.
-
Legado (Tecnospeed/Tecnos/Abase): solo en el mes de emisión. Tras cambiar el mes, no se puede cancelar — solo ajustar en competencias siguientes.
Anatomía del DPS (Estándar Nacional)
El DPS es el XML que Quaza envía al SEFIN. Versión actual v1.01, namespace http://www.sped.fazenda.gov.br/nfse. Schema en br/fiscal/modelos/nfse/xml/schemas/nacional/DPS_v1.01.xsd. Conocer la estructura ayuda a entender errores de rechazo.
<DPS xmlns="http://www.sped.fazenda.gov.br/nfse" Id="DPS3543..." versao="1.01">
<infDPS Id="DPS3543..." versao="1.01">
<tpAmb>1</tpAmb> # 1=Produccion, 2=Homologacion
<dhEmi>2026-05-12T10:00:00-03:00</dhEmi>
<verAplic>Quaza1.0</verAplic>
<serie>1</serie>
<nDPS>12345</nDPS> # numero secuencial
<dCompet>2026-05-12</dCompet> # competencia (fecha del servicio)
<tpEmit>1</tpEmit> # 1=Prestador, 2=Tomador, 3=Intermediario
<cLocEmi>4310902</cLocEmi> # codigo IBGE del municipio emisor
<prest> # PRESTADOR (tu empresa)
<CNPJ>12345678000100</CNPJ>
<IM>123456</IM> # inscripcion municipal
<xNome>Empresa Exemplo LTDA</xNome>
<enderNac>...</enderNac>
<regTrib> # regimen tributario
<opSimpNac>1</opSimpNac> # 1=optante Simples, 2=no optante
<regApTribISSQN>0</regApTribISSQN>
</regTrib>
</prest>
<toma> # TOMADOR (cliente)
<CPF>12345678901</CPF>
<xNome>Cliente Exemplo</xNome>
<enderNac>...</enderNac>
</toma>
<serv> # SERVICIO prestado
<cServ>
<cTribNac>0107</cTribNac> # codigo LC 116/2003 (sub-item 1.07)
<cTribMun>010701</cTribMun> # codigo tributacion municipal (si exigido)
<CNAE>6201500</CNAE>
<xDescServ>Instalacion de internet residencial</xDescServ>
</cServ>
<locPrest> # local de la prestacion
<cLocPrestacao>4310902</cLocPrestacao>
</locPrest>
<valores>
<vServPrest>
<vServ>100.00</vServ> # valor bruto
</vServPrest>
<trib>
<tribMun>
<tribISSQN>1</tribISSQN>
<pAliq>5.00</pAliq> # alicuota ISS
<tpRetISSQN>1</tpRetISSQN> # 1=no retenido, 2=retenido
</tribMun>
</trib>
</valores>
</serv>
</infDPS>
<Signature>...</Signature> # firma digital con certificado A1
</DPS>
Campos que más generan rechazo:
-
cTribNac — código LC 116 inválido o incompatible con la actividad del prestador (causa #1 de rechazo).
-
cLocPrestacao — código IBGE del municipio equivocado (sobre todo en casos de servicio prestado fuera de la sede).
-
regTrib/opSimpNac — régimen del prestador inconsistente (empresa Simples emitiendo como Lucro Real).
-
pAliq — alícuota ISS fuera del rango del municipio (cada ciudad tiene su tabla).
-
IM — inscripción municipal inactiva o inexistente.
Pantalla de agregar/editar — barra de acciones
La pantalla de edición de la NFSe muestra un panel lateral fijo a la derecha con los botones de acción contextual — lo que internamente Quaza llama caixa-maneira, misma barra que aparece en NFCom
, NFe y NFCe.
Botones contextuales: no todos aparecen siempre. Cada botón tiene condición de exhibición según la situación actual de la nota. Ej: Cancelar nota solo aparece en Protocoladas; Imprimir DANFE solo aparece cuando la nota tiene llave.
Barra caixa-maneira en NFSe Protocolada — 5 botones visibles numerados.
Botones visibles en una NFSe Protocolada
El print arriba muestra una NFSe en situación Protocolada — la barra tiene 5 botones. Otras situaciones (Creada, Transmitida, Rechazada) revelan botones distintos (Transmitir, Consultar) y esconden los que dependen de tener autorización.
| # |
Botón |
Color |
Cuándo aparece |
Qué hace |
| 1 |
Imprimir DANFE |
celeste |
Cuando la nota tiene llave (Transmitida o Protocolada) |
Llama al ADN (Estándar Nacional) o a la alcaldía (legado) y baja el PDF del DANFSE. Abre en pestaña nueva. |
| 2 |
Cancelar nota |
rojo |
Protocolada (3) |
Pide justificación (mínimo 15 caracteres). En el Estándar Nacional, dispara el evento 101101 sin restricción de plazo; en legado, solo hasta fin del mes de emisión. Si se acepta, situación pasa a Cancelada (99). |
| 3 |
Procesar |
amarillo |
Creada/Rechazada/Transmitida — todos los estados no-finales |
Arma DPS, valida XSD, firma con certificado A1 y envía al SEFIN (Nacional) o al provider configurado. También sirve para "consultar" cuando la nota ya fue transmitida (verifica autorización sin retransmitir). |
| 4 |
Ver venta |
celeste |
Siempre (cuando la NFSe vino de una venta/factura) |
Abre en pestaña nueva la venta o factura que originó esta NFSe. Útil para rastrear lo que fue cobrado. |
| 5 |
Ver cliente |
celeste |
Siempre |
Abre el alta del cliente (tomador) en pestaña nueva. |
Botones de otros estados: en una NFSe Creada (sit=1) la barra muestra Procesar (transmitir ahora), Ver venta, Ver cliente y a veces Probar conexión SEFIN. En Rechazada (sit=4) aparece Procesar para retransmitir tras corregir. En Cancelada (sit=99) solo los botones de visualización quedan disponibles.
DANFSE — el PDF
El DANFSE (Documento Auxiliar de la NFSe) es el PDF generado por el ADN de la Receita Federal (no por Quaza) tras la autorización. No es la nota fiscal — la nota fiscal es el XML. El DANFSE es solo representación visual con QR Code que permite consultar el XML en el portal nacional.
| Característica |
Detalle |
| Prerrequisito |
NFSe Transmitida o Protocolada. |
| Generación |
GET al endpoint adn.nfse.gov.br/api/v1/danfse/. Provider legado: la alcaldía genera. |
| Contenido |
Identificación prestador/tomador, descripción del servicio, valores, ISS, retenciones, QR Code, número de protocolo. |
| Distribución |
E-mail (template NFSE_ENVIO), WhatsApp o portal del cliente. |
Cancelación y eventos
Estándar Nacional — Cancelación vía evento 101101
NFSe Protocolada se puede cancelar vía evento. Quaza envía un XML separado (no otra NFSe) con tipo 101101. Sin restricción de plazo en el Estándar Nacional — distinto del legado.
| Respuesta |
Qué significa |
| Evento aceptado (cStat 135 análogo) |
NFSe pasa a Cancelada (99). |
| Duplicidad |
Ya cancelaste esa nota. |
| Justificación inválida |
Mínimo 15 caracteres exigido. |
Legados (Tecnospeed/Tecnos/Abase) — Cancelación restringida
Atención: en los providers legados, la cancelación generalmente se permite
solo en el mes de emisión. Después de cambiar el mes:
- No se puede cancelar técnicamente.
- Alternativas: emitir NFSe de complemento/sustitución (si la alcaldía permite), abrir proceso administrativo en la alcaldía, o ajustar en competencias siguientes.
Endpoints SEFIN y ADN
Para el Estándar Nacional, Quaza usa dos servidores distintos de la Receita Federal:
| Servidor |
Función |
Endpoint producción |
Endpoint homologación |
| SEFIN Nacional |
Recibe DPS, devuelve llave de acceso, recibe eventos (cancelación) |
sefin.nfse.gov.br/SefinNacional |
homologacao.nfse.gov.br/SefinNacional |
| ADN |
Genera y expone el DANFSE (PDF) + consulta pública |
adn.nfse.gov.br |
homologacao.adn.nfse.gov.br |
No configurás URL — solo configurás ambienteNfse (1=producción, 2=homologación) en Empresa NFSe Config; Quaza decide el endpoint automáticamente.
Tributos calculados
| Tributo |
Qué es |
Quién paga |
| ISS |
Impuesto Sobre Servicios — municipal. Alícuota 2-5% (LC 116/2003 + ley municipal). |
Prestador (regla general) |
| ISS retenido |
En contratos con órganos públicos o grandes tomadores, el tomador retiene el ISS en la fuente. |
Tomador (retiene y recauda) |
| PIS |
Federal — sobre ingreso del prestador. 0,65% (cumulativo) o 1,65% (no-cumulativo). |
Prestador |
| COFINS |
Federal — sobre ingreso del prestador. 3% (cumulativo) o 7,6% (no-cumulativo). |
Prestador |
| CSLL/IRPJ retenidos |
Cuando tomador PJ lo exige (en general grandes empresas y órganos públicos). |
Prestador (sufre retención) |
Empresas Simples Nacional: ISS sale por el DAS (no destacado en la nota — el DPS marca opSimpNac=1). Empresas Lucro Real/Presumido tienen ISS destacado en el XML según alícuota del municipio.
De dónde vienen los datos
| Campo de la NFSe |
Origen |
| Prestador (CNPJ, IM, dirección) |
Empresa NFSe Config
|
| Tomador (cliente, CPF/CNPJ, dirección) |
Alta del cliente
|
| Servicios (descripción, valor) |
Contrato
+ Factura
|
| Código de servicio LC 116, CNAE, alícuota ISS |
Producto fiscal NFSe
(nfseProduto) |
| Provider, ambiente, versión DPS, certificado |
Fiscal → Empresa NFSe Config |
| Municipio emisor / local prestación |
Dirección de la empresa (sede) o local específico del servicio |
Cómo leer errores y depurar
Dónde encontrar el mensaje de error
- Abrí la NFSe rechazada (situación 4).
- La pestaña "Retorno SEFIN" muestra la respuesta JSON del servidor (registrada en
nfseProtocolo.mensagem).
- El botón "Ver XML / DPS" muestra el DPS enviado — revisá el campo señalado por el error.
Códigos de error más comunes
| Tipo |
Mensaje típico |
Causa probable |
| Schema inválido |
Elemento X no esperado / formato inválido |
Versión DPS equivocada en la config (configurá v1.01 si SEFIN lo exige). |
| Código LC 116 inválido |
cTribNac no está en la lista oficial |
Registro del codServico en el Producto fiscal está mal. |
| Municipio no habilitado |
cLocEmi/cLocPrestacao no soportado |
La alcaldía todavía no adhirió al Nacional — cambiá provider a legado o esperá adhesión. |
| Inscripción Municipal inválida |
IM no consta en la base del municipio |
Verificá si la IM está activa en el municipio; actualizá nfseEmpresaConfig. |
| Alícuota ISS incompatible |
pAliq fuera del rango permitido |
Cada ciudad tiene tabla propia — confirmá con contador la alícuota correcta para ese servicio. |
| Régimen tributario inconsistente |
opSimpNac con valor incorrecto |
Empresa Simples Nacional necesita opSimpNac=1; Lucro Real/Presumido 0. |
| Certificado expirado / inválido |
Falla en la firma digital |
Renová el A1 y subí el nuevo .pfx. |
Trampas frecuentes
1. NFSe Nacional todavía no cubre todos los municipios. Cuando una ciudad todavía no migró, transmitir como Nacional va a rechazar. Usá provider legado (Tecnospeed/Tecnos/Abase) o esperá la migración oficial.
2. Cambié el tipo de integración — notas antiguas no funcionan más. Cada NFSe lleva en la base qué provider fue usado en la emisión. Cambiar la config afecta SOLO las próximas notas. Las anteriores deben tratarse con la config que tenían (consulta, cancelación vía legado sigue viable).
3. ISS es municipal — verificación obligatoria por municipio. No podés "tirar 5%". Cada ciudad publica su tabla. Registrá la alícuota correcta en Producto fiscal NFSe para cada servicio × municipio.
4. Código LC 116 ≠ CNAE. Son dos clasificaciones distintas:
- LC 116/2003: lista oficial de servicios para fines de ISS.
- CNAE: actividad económica (Federal/Municipal).
La NFSe Nacional exige los dos — confundirlos derriba la transmisión.
5. Retención de ISS es responsabilidad del tomador. Cuando órgano público contrata, la entidad retiene el ISS en la fuente. Quaza lo marca en el DPS (tpRetISSQN=2), pero tenés que configurar esa flag manualmente en los contratos con órganos.
6. Inscripción Municipal vence o caduca. Algunas alcaldías exigen renovación anual de IM. Sin IM activa = SEFIN rechaza. Mantené contacto con el departamento fiscal de la alcaldía.
7. NFSe legado: cancelación solo en el mes. Operación rutina: verificar diariamente notas que cambiaron de mes y quedaron "presas". Para ajustar, usá complemento o abrí proceso en la alcaldía.
8. Empresa optante del Simples no destaca ISS. El DPS marca opSimpNac=1 y la alícuota efectiva sale por el DAS. No completes alícuota en los ítems — dejá que Empresa NFSe Config controle.
9. Homologación x Producción comparten listado. Usá el filtro "Ambiente" para separar. Notas en homologación no tienen valor fiscal — no envíes al cliente sin confirmar.
10. NFSe no es factura — es nota fiscal. La cobranza financiera sale aunque la NFSe rechace. No dependas de la NFSe para cobrar — el boleto/Pix sale aparte. Solo el documento fiscal queda pendiente hasta protocolar.
FAQ
¿Quién está obligado a emitir NFSe?
Toda empresa que preste servicios está obligada a emitir NFSe por la alcaldía donde está sede (regla general) o donde el servicio se presta (algunos servicios específicos). Proveedores de internet emiten NFSe principalmente para instalación, soporte técnico, mantenimiento, configuración y otros servicios puntuales.
¿NFSe Nacional reemplaza completamente los webservices municipales?
En transición. La intención es que sí, pero la adhesión es progresiva. Cuando una alcaldía adhiere, pasa a aceptar ÚNICAMENTE el Estándar Nacional en ese municipio — no se puede emitir en los dos formatos simultáneamente para una misma ciudad.
¿Cómo sé si mi alcaldía ya adhirió?
Consultá la lista oficial en www.gov.br/nfse o preguntá a tu contador. Quaza no tiene listado interno — tenés que mirar afuera y configurar Empresa NFSe Config conforme.
¿Mensualidad de internet es servicio (NFSe) o comunicación (NFCom)?
Comunicación. Internet residencial/empresarial es servicio de telecomunicación → emite NFCom (modelo 62)
. NFSe es para servicios que no son comunicación: instalación, soporte técnico, mantenimiento, capacitación, consultoría.
El cliente perdió el e-mail con la NFSe — ¿cómo lo reenvío?
Abrí la NFSe y hacé clic en Enviar e-mail de nuevo. Va a usar el template NFSE_ENVIO y enviarlo al e-mail actual del cliente.
NFSe rechazada por código de servicio equivocado — ¿qué hago?
Verificá el codServico del Producto fiscal NFSe. Compará con la Lista LC 116/2003 — cada ítem tiene código (ej: 1.07 = "soporte técnico en informática"). Corregí el registro del producto y retransmití.
Cancelé después del mes (provider legado) — ¿y ahora?
En el legado, no cancela. Opciones: emitir NFSe de sustitución/complemento (si la alcaldía permite), abrir proceso administrativo en la alcaldía o ajustar competencia siguiente con compensación. Estándar Nacional no tiene esa restricción.
¿Empresa optante del Simples Nacional emite NFSe?
Sí, pero el ISS no se destaca en el XML — sale por el DAS. Configurá opSimpNac=1 en Empresa NFSe Config. La alícuota efectiva es la del anexo del Simples (no la alícuota municipal completa).
¿Puedo emitir NFSe de prueba antes de pasar a producción?
Sí — configurá el ambiente de la Empresa NFSe Config como Homologación (2). Las notas en homologación no tienen valor fiscal, pero todo el flujo (DPS, firma, transmisión, DANFSE) funciona idéntico.
¿NFSe no es prestada en la sede — dónde se recauda el ISS?
Depende del tipo de servicio. Regla general: ISS recaudado en la sede del prestador. Excepciones: algunos servicios (construcción civil, vigilancia, seguridad, transporte municipal) recaudan donde el servicio es prestado. Quaza completa cLocPrestacao según lo que configures en el producto — confirmá con contador para servicios específicos.
Documentos relacionados