Central de Ajuda Quaza Provedores

NFe-SVA — Nota Fiscal de Servicios de Valor Agregado (ES-PY)

NFe-SVA — Nota Fiscal de Servicios de Valor Agregado — Quaza

NFe-SVA es la nota fiscal de Servicios de Valor Agregado — streaming, antivirus, telefonía OTT, audiolibro y otros servicios digitales que el proveedor revende al cliente. Esta wiki cubre las dos capas del módulo: el lado fiscal (emisión de la nota, cancelación, SPED mensual) y el lado operativo (integración con los más de 23 gateways de SVA: Watchbrasil, OleTV, Digilivros, Skeelo, NXTV, etc — registro de planes, integradores, usuarios activos). Para venta de equipo físico use NFe ; para servicios de comunicación (internet, telefonía) use NFCom ; para servicios técnicos (instalación, soporte) use NFSe .

NFe-SVA es la nota fiscal más simple del módulo Fiscal de Quaza. Apenas 3 estados (Activa, Cancelada, Espejo), sin transmisión a la SEFAZ en tiempo real, sin clave de acceso, sin CCe, sin código QR. Es esencialmente un registro fiscal interno de los cobros de servicios agregados, declarado mensualmente a la Hacienda mediante SPED EFD-Contribuições (combinado con NFSe). La complejidad del módulo está en la integración con los gateways externos, no en la fiscalidad.
En esta wiki:

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

NFe-SVA cubre servicios digitales de valor agregado revendidos por el proveedor — cosas que el cliente paga junto con la internet pero que no son internet. Resumen de cuándo usar cada documento:

Tipo de ingreso del proveedor Documento correcto
Internet, telefonía fija/móvil, TV (mensualidad) NFCom (62)
Instalación, soporte puntual, mantenimiento NFSe
Venta de equipo (router, ONU, decodificador) NFe (55)
Streaming, antivirus, audiolibro, telefonía OTT, plataformas digitales NFe-SVA
Caso típico: su cliente contrata el "Combo Internet + Watchbrasil + Antivirus". La internet se convierte en NFCom. Watchbrasil y Antivirus, por separado, se convierten en dos NFe-SVA (una por integrador). Cada plan de SVA tiene su integrador registrado, y la nota agrupa el valor cobrado en el mes.

Las dos capas del módulo

El módulo NFe-SVA es diferente de las demás notas fiscales de Quaza por tener dos capas distintas que trabajan juntas:

Capa Qué hace Dónde está
1. Operativa (gateway) Gestiona la integración con los proveedores externos del servicio (Watchbrasil, OleTV, Digilivros, etc). Registra integradores, planes vendidos, usuarios activos en el proveedor. Cuando el cliente contrata un plan SVA en Quaza, esta capa hace el aprovisionamiento real en el gateway externo. Menú SVA → Plan / Integrador / Usuario
2. Fiscal Registra el cobro como NFe-SVA para fines de declaración a la Hacienda. Genera el DANFE-SVA, cancela cuando es necesario, exporta el SPED mensual. Fiscal → NFe-SVA
Las dos capas no están acopladas — puede registrar planes e integradores SVA sin emitir nunca una nota fiscal, y puede emitir NFe-SVA sin tener integrador (caso raro, pero posible). En la práctica, el flujo completo es: cliente contrata el plan → la capa operativa activa el usuario en el gateway → la tarea de facturación cobra al cliente → se genera la NFe-SVA → SPED mensual.

Paso a paso — emitir su primera NFe-SVA

Guía mínima, desde cero hasta el DANFE-SVA en manos del cliente:

Paso Acción Dónde
1 Registre el Integrador SVA: elija el gateway (Watchbrasil, OleTV, Digilivros, etc), credenciales (apiUsuario, apiSenha, token, clientId), ambiente (Homologación/Producción). SVA → Integrador
2 Registre los Planes ofrecidos por ese integrador: descripción, código del integrador (ID en el gateway externo), valor. SVA → Plan
3 Registre el Producto NFe-SVA (lado fiscal): descripción, CFOP, unidad, valor, alícuotas PIS y COFINS. Fiscal → Producto NFe-SVA
4 Registre la Serie fiscal modelo NFe-SVA en la Empresa NFe. Fiscal → Serie fiscal
5 El cliente contrata el plan: al vincular el plan SVA en el contrato del cliente, el sistema llama al integrador externo para activar el usuario. Contrato → Plan SVA
6 La tarea de facturación (manual o automática vía crontab) genera las NFe-SVA del mes como espejos. Usted los revisa y hace clic en Generar nota para promoverlos a Activas. Fiscal → NFe-SVA
7 Envíe el DANFE-SVA al cliente por correo electrónico o WhatsApp. Fiscal → NFe-SVA → [la nota]
8 A fin de mes, genere el SPED EFD-Contribuições (combinado con NFSe) y envíelo mediante la contabilidad a la Hacienda. Fiscal → SPED SVA
Consejo: a diferencia de la NFe y la NFCom, NFe-SVA no requiere certificado A1 ni comunicación en tiempo real con la SEFAZ. La "transmisión" ocurre vía SPED, que es un archivo mensual entregado por la contabilidad. Esto simplifica MUCHO la operación — pero exige disciplina mensual para cerrar el SPED a tiempo.

Flujo general — del espejo al SPED

OPERADOR / TAREA QUAZA (servidor) HACIENDA (vía SPED) 1 Cobro SVA del mes (plan de streaming, etc) Crea NFe-SVA como ESPEJO estado 'E' · sin número 2 Revisa espejo hace clic en "Generar nota" ACTIVA (estado 'N') recibe número fiscal · valor fiscal 3 Genera DANFE-SVA (PDF) simple · sin código QR · sin clave Imprime/Envía DANFE-SVA correo · WhatsApp Cierre mensual 4 Fin del mes — genera SPED Fiscal → SPED SVA Agrega NFe-SVA + NFSe .TXT EFD-Contribuições Recibe escrituración vía contabilidad 5 Cancelar (en el mes) sin justificación exigida CANCELADA (estado 'S') no cuenta en el SPED del mes Sin efecto tributario (antes del fin del mes)

Flujo de la NFe-SVA en 3 carriles (Operador · Quaza · Hacienda vía SPED). Los pasos 1-3 cubren el ciclo de cada nota (Espejo → Activa → DANFE entregado). El paso 4 es el cierre mensual vía SPED. El paso 5 es la cancelación (solo dentro del mes). A diferencia de NFe/NFCom, no hay transmisión SEFAZ en tiempo real.

Lea el diagrama: los pasos 1-4 cubren el ciclo de cada nota (Espejo → Activa → DANFE entregado). El paso 5 es el cierre mensual vía SPED (combinado con NFSe). A diferencia de la NFe/NFCom, no hay transmisión a la SEFAZ en tiempo real — el SPED hace eso una vez al mes.

Glosario

Término Qué es
NFe-SVA Nota Fiscal Electrónica de Servicios de Valor Agregado — documento fiscal interno para registrar cobros de servicios digitales (streaming, antivirus, OTT) revendidos por el proveedor.
SVA Servicios de Valor Agregado — servicios digitales ofrecidos junto con internet/telefonía pero que no son comunicación (streaming, antivirus, audiolibro, OTT). Definido por la Anatel.
Integrador / Gateway SVA Proveedor externo del servicio (Watchbrasil, OleTV, Digilivros, etc). Quaza tiene más de 23 integraciones soportadas — cada una con su propia API.
Plan SVA Paquete ofrecido por un integrador (ej: "Watchbrasil Premium", "OleTV Mobile"). Cada plan tiene un código en el integrador que mapea a un producto remoto.
Usuario SVA Vínculo entre el cliente de Quaza y el usuario activo en el gateway externo. Tiene CPF, correo, contraseña, estado — sincronizado por API con el integrador.
Código del integrador ID remoto del plan/usuario en el gateway externo. Mapea la entidad Quaza ↔ entidad del proveedor.
SPED EFD-Contribuições Escrituración Fiscal Digital de Contribuciones — archivo mensual (.TXT) entregado a la Hacienda Federal con la totalización de PIS/COFINS de las notas emitidas en el mes. Cubre NFe-SVA + NFSe en el mismo archivo.
Espejo Versión preliminar de la NFe-SVA, estado 'E'. Sin número fiscal, sin efecto tributario. Sirve para revisar antes de promover.
Activa NFe-SVA emitida, estado 'N'. Tiene número fiscal, cuenta en el SPED del mes. Es el estado "Protocolada" del mundo SVA.
Cancelada NFe-SVA anulada, estado 'S'. La cancelación solo se permite dentro del mes de emisión.
DANFE-SVA Documento Auxiliar — PDF entregado al cliente. Simple, sin clave SEFAZ, sin código QR (no hay consulta pública).
CFOP Código Fiscal de Operaciones y Prestaciones. NFe-SVA usa CFOPs de prestación de servicio (familia 5300/6300, similar a NFCom). Configurado en cada producto NFe-SVA.
watchtoken / criarusuariosdigilivros Tareas operativas de la capa SVA (no fiscal) — sincronizan tokens y usuarios con integradores específicos. Cada gateway puede tener su tarea de mantenimiento.
PIS / COFINS Contribuciones federales sobre la facturación. En la NFe-SVA son las únicas alícuotas tributarias relevantes (no hay ICMS/IPI).

Integradores SVA soportados

Quaza soporta cerca de 23 integradores diferentes (la lista crece conforme se firman nuevos contratos con proveedores). Cada integrador es una API/protocolo propio — Quaza se encarga de la comunicación. Usted solo necesita registrar las credenciales.

Categoría Integradores soportados
Streaming de video Watchbrasil, OleTV, NXTV, NOW, MULTTV, EITV, ITTV, PLAYHUB
Libros / Audiolibros Digilivros, Skeelo, Historinhaas Kids, LeAI
Educación / Cursos Qualifica, Campsoft
Otros / Diversos Cariap, Celeti, Graviola, Youcast
Para agregar un integrador nuevo que no está en la lista: requiere desarrollo — abra un ticket con el soporte técnico aportando la documentación de la API del integrador. Cada integración nueva requiere cerca de 1-2 semanas de desarrollo + homologación.
Ambiente Homologación vs Producción: cada integrador soporta los dos. Configure Homologación al probar — los usuarios creados en homologación NO activan el servicio real en el proveedor. Solo cambie a Producción después de que el ciclo completo (registro → cobro → DANFE) funcione.

Configuración — prerequisitos

NFe-SVA exige menos configuración que NFe o NFCom porque no hay transmisión SEFAZ. Los requisitos:

Empresa NFe (datos básicos)Fiscal → Empresa NFe

NFe-SVA usa la misma Empresa NFe de las demás notas — solo necesita los datos básicos:

  • Principal: CNPJ, razón social, teléfono.
  • Dirección: domicilio, ciudad, código postal.
  • Información fiscal: CRT (1=Simples, 2=Lucro Real, 3=Lucro Presumido), IE, IM.

Certificado A1: opcional. NFe-SVA no transmite a la SEFAZ, así que el certificado solo es necesario si la empresa también emite NFe/NFCom/NFSe.

Serie fiscal NFe-SVAFiscal → Serie fiscal

Al menos una serie dedicada a la NFe-SVA. Numeración independiente de las demás notas.

Producto NFe-SVAFiscal → Producto NFe-SVA

Cada plan SVA vendido necesita tener un Producto fiscal NFe-SVA correspondiente, con:

  • Descripción — aparece en el DANFE-SVA y en la nota.
  • Unidad — generalmente "UN" (unidad).
  • CFOP — código fiscal de la operación (5301/5302/6301/6302 para prestación de servicio dentro/fuera de la UF).
  • Valor — valor predeterminado del plan (puede ser sobrescrito por nota).
  • Alícuota PIS — generalmente 0,65% (cumulativo) o 1,65% (no-cumulativo).
  • Alícuota COFINS — generalmente 3% (cumulativo) o 7,6% (no-cumulativo).

Nota: no hay NCM, CST/CSOSN, ICMS, IPI en el Producto NFe-SVA — solo PIS/COFINS. Por eso el registro es mucho más simple que el Producto NFe o el Producto NFSe.

Integrador SVASVA → Integrador

Registre cada proveedor externo:

  • Descripción — nombre interno (ej: "Watchbrasil Producción").
  • Gateway — elige el integrador de la lista (Watchbrasil, OleTV, Digilivros, etc).
  • Estado de la API — Homologación o Producción.
  • Credenciales — apiUsuario, apiSenha, instancia, token, clientSecret, clientId (los campos varían por gateway).
Plan SVASVA → Plan

Registre cada plan ofrecido por cada integrador:

  • Descripción — nombre del plan comercial.
  • Integrador — qué gateway ofrece ese plan.
  • Código del integrador — ID remoto del plan en el proveedor (debe ser exacto).
  • Mobile — flag específica del OleTV (indica si es plan móvil).

Pantalla de NFe-SVA — listado y detalle

Dos pantallas: listado con filtros + formulario de detalle.

Listado

Fiscal → NFe-SVA

Lista todas las NFe-SVA (espejos, activas, canceladas) con filtros por número, cliente, período, empresa, estado.

Columna Qué muestra
Imprimir Acción directa — descarga el DANFE-SVA.
Código ID interno del registro.
Número Número fiscal secuencial — vacío en Espejo.
Fecha de emisión Cuándo se generó la nota.
Empresa NFe Emisor.
Cliente Destinatario — el enlace abre el registro.
CPF/CNPJ Documento del cliente.
Valor total Valor de la nota.
Competencia Mes/año de referencia (ej: 05/2026).
Estado Espejo / Activa / Cancelada.
Modificación Fecha + usuario de la última modificación.

Detalle / formulario

Fiscal → NFe-SVA → [hacer clic en el ícono Editar]

El formulario tiene una única pestaña Principal con:

  • Empresa NFe, serie, número, cliente, documento fiscal vinculado.
  • Fecha de emisión, competencia, valor total.
  • Grilla de ítems (cada plan cobrado es una línea).
  • Observaciones (texto libre).

Estados de la nota y transiciones

Estado Nombre Qué significa Próxima acción posible
E Espejo Borrador generado por la tarea de facturación. Sin número fiscal, sin efecto tributario. Generar nota → se convierte en Activa. O descartar (cancelar un espejo elimina el registro).
N Activa NFe-SVA emitida con número fiscal. Cuenta para el SPED del mes. Valor fiscal. Imprimir DANFE-SVA, enviar al cliente. Cancelar (solo dentro del mes de emisión).
S Cancelada NFe-SVA anulada. No cuenta en el SPED. Estado terminal.
Cancelación solo en el mes de emisión. A diferencia de la NFe/NFCom que tienen un plazo de 24h, NFe-SVA permite la cancelación a lo largo de todo el mes — pero no después. ¿Canceló un espejo? Elimina el registro. ¿Canceló una Activa? La marca como Cancelada y la excluye del SPED del mes.

Registros del módulo SVA (operativo)

La capa operativa del SVA tiene 4 pantallas principales que viven fuera del módulo Fiscal:

IntegradorSVA → Integrador

Registra cada proveedor externo. Campos: descripción, gateway (enum con 23 opciones), estado de la API (Homologación/Producción), y credenciales (cada gateway usa un subconjunto: apiUsuario/apiSenha, instancia, token, clientSecret, clientId).

PlanSVA → Plan

Cada plan comercial vendido. Se vincula a un Integrador + tiene el ID del plan en el gateway externo (campo "código del integrador"). Algunos gateways pre-mapean planes en el enum (ej: Qualifica tiene PRO y PREMIUM); otros importan dinámicamente vía API.

Usuario SVASVA → Usuario

Vínculo entre el cliente Quaza y el usuario activo en el gateway externo. Campos:

  • Integrador + Plan + Contrato
  • Usuario (correo), contraseña, CPF, teléfono
  • Dirección MAC, modelo del equipo (cuando aplica — ej: TV box)
  • Código del integrador — ID del usuario en el proveedor
  • Situación — activo/inactivo en el proveedor

Cuando usted registra un Usuario SVA aquí, el sistema llama a la API del integrador externo para activar el servicio en el proveedor.

Request logSVA → Request log

Registro de todas las llamadas HTTP hechas a las APIs de los integradores. Útil para depurar cuando una activación falla — usted ve el request enviado y la respuesta del gateway.

Pantalla de agregar/editar — área de botones

NFe-SVA tiene un área de botones más reducida que NFe/NFCom porque no hay transmisión SEFAZ:

# Botón Cuándo aparece Qué hace
1 Imprimir danfe Siempre (cuando el registro fue guardado) Genera el PDF (DANFE-SVA). Abre en una nueva pestaña.
2 Generar nota Espejo ('E') Promueve el espejo a NFe-SVA Activa — asigna el número secuencial de la serie y cambia el estado a 'N'.
3 Cancelar nota Activa ('N') o Espejo ('E') En Activa: valida que esté dentro del mes de emisión y cambia el estado a Cancelada ('S'). En Espejo: elimina el registro.
4 Enviar por correo Activa o Espejo, con cliente vinculado y correo registrado Envía el DANFE-SVA al correo del cliente. El mensaje es armado automáticamente por el sistema.
5 Enviar por Whatsapp Activa o Espejo, con cliente vinculado Abre el WhatsApp Web en una nueva pestaña con el mensaje + enlace del DANFE-SVA para envío manual.
Sin botón "Procesar", "Consultar", "XML", "XML Cancelación", "Carta de Corrección" — porque no hay comunicación con la SEFAZ en tiempo real. Sin "Sustituir" tampoco — para corregir una NFe-SVA, se cancela y se emite una nueva.

Flujos comunes del operador

Guías cortas para las operaciones más frecuentes. NFe-SVA es simple en el lado fiscal, pero el módulo SVA tiene varias operaciones en la capa de integración con gateways externos.

Cómo emitir una NFe-SVA manualmente

  1. Acceda a Fiscal → NFe-SVA y haga clic en + Agregar espejo.
  2. Complete Empresa NFe, Serie, Cliente, Competencia (mes/año), y los ítems (planes SVA cobrados, con CFOP, valor, PIS/COFINS).
  3. Guarde — la nota queda en Espejo (estado 'E').
  4. Haga clic en Generar nota — recibe el número secuencial y se convierte en Activa (estado 'N').
  5. Haga clic en Imprimir danfe o Enviar por correo para entregar al cliente.
No hay "Procesar" ni "Consultar": NFe-SVA no transmite a la SEFAZ. La "transmisión" es vía SPED mensual, manual.

Cómo cancelar una NFe-SVA (dentro del mes)

  1. Confirme que la nota esté en Activa y que la emisión haya sido en el mes corriente.
  2. Abra la nota y haga clic en Cancelar nota.
  3. Confirme. No necesita justificación.
  4. La nota pasa a Cancelada y no entra en el SPED del mes.
Pasó del mes: ya no se cancela. Opciones: dejarla como está y ajustar en la competencia siguiente (nota negativa de ajuste, si aplica), o rectificar el SPED ya entregado (operación contable, fuera de Quaza).

Cómo activar un usuario en el gateway externo (capa operativa)

  1. Confirme que el Integrador y el Plan correspondiente ya estén registrados en SVA → Integrador y SVA → Plan.
  2. Acceda a SVA → Usuario y haga clic en + Agregar.
  3. Complete: Integrador, Plan, Contrato vinculado, correo, contraseña, CPF, teléfono del cliente. Para algunos gateways: dirección MAC y modelo del equipo.
  4. Guarde. El sistema llama a la API del integrador externo para crear/activar el usuario en el proveedor — el código del integrador (ID remoto) vuelve como respuesta y queda guardado en el registro.
  5. Si la activación falló, revise SVA → Request log — muestra el request HTTP enviado y la respuesta del gateway.
Cada gateway tiene sus propios requisitos de campos. Watchbrasil exige un token válido (renovado por la tarea watchtoken); Digilivros sincroniza usuarios en lote por la tarea criarusuariosdigilivros. Cuando una activación falla, primero revise el Request log.

Cómo desactivar un usuario en el gateway externo

  1. Acceda a SVA → Usuario y localice el usuario por el cliente/contrato.
  2. Edite y cambie la Situación a Inactivo.
  3. Guarde. El sistema llama a la API del integrador para desactivar el servicio en el proveedor.
Cancelar la nota fiscal no desactiva el servicio. Son dos actos separados: cancelar la NFe-SVA es solo un acto fiscal; desactivar el usuario es un acto operativo. Haga los dos cuando el cliente cancela el plan.

Cómo generar el SPED mensual

  1. Al inicio del mes siguiente al de la competencia, después de garantizar que todas las cancelaciones del mes fueron hechas, acceda a Fiscal → SPED SVA.
  2. Seleccione Empresa NFe, año y mes de referencia.
  3. Haga clic en Generar. El sistema crea un archivo UF+CNPJ+ANO+MES+EFDCont.TXT agregando las NFe-SVA + NFSe Activas del mes.
  4. Descargue el archivo y entréguelo a la contabilidad para transmitirlo a la Hacienda Federal dentro del plazo legal.
Las notas Canceladas no entran en el SPED. Después de generar el SPED del mes, cualquier modificación (cancelación, emisión de nota con competencia retroactiva) generará una inconsistencia — tendrá que hacer un SPED rectificador mediante la contabilidad.

Cómo reenviar el DANFE-SVA al cliente

  1. Abra la NFe-SVA (Activa o Espejo con cliente vinculado).
  2. Haga clic en Enviar por correo — envía automáticamente.
  3. O haga clic en Enviar por Whatsapp — abre el WhatsApp Web con el mensaje + enlace del DANFE-SVA.
  4. O haga clic en Imprimir danfe y descargue el PDF.

Cómo depurar una llamada al gateway externo que falló

  1. Acceda a SVA → Request log.
  2. Filtre por el integrador y por la fecha aproximada de la falla.
  3. Abra el registro más reciente — vea el request que Quaza envió (URL + headers + body) y la respuesta del gateway (código de estado + body).
  4. Analice el motivo:
    • 401/403: token expirado o credencial inválida — verifique SVA → Integrador.
    • 404: código del integrador incorrecto en el Plan o Usuario.
    • 500: error del lado del proveedor — abra un ticket con ellos.

Tareas automáticas

NFe-SVA está cubierta por tareas genéricas del Fiscal (las mismas que tratan NFe y NFCom) + tareas propias del módulo SVA para el mantenimiento de los integradores externos:

Quién enciende/apaga una tarea: el sysadmin vía crontab del servidor. No lo hace el operador. Vea la wiki Explicación de las tareas de la Crontab .
Seguimiento de las tareas en QuazaAdmin → Tareas

Solo informa lo que cada tarea hizo en la última ejecución — no enciende/apaga.

Tareas fiscales que tratan NFe-SVA

# Tarea Fase del ciclo Qué hace exactamente
508 Generar notas automáticamente Generación Recorre los cobros del mes corriente y genera NFe-SVA (junto con NFe y NFCom). Reconoce el tipo de la nota por el Producto fiscal vinculado.
510 Generar notas después del pago Generación (post-pago) Variante: crea NFe-SVA solo de los contratos cuyo financiero fue pagado.
502 Nota posterior (correo) Comunicación (post-pago) Para NFe-SVA Activas con pago liquidado en los últimos 14 días, dispara el correo al cliente con el DANFE-SVA adjunto.
NFe-SVA no tiene tarea de transmisión — porque no hay transmisión en tiempo real. La "transmisión" es el SPED mensual, ejecutado manualmente por la contabilidad en la pantalla Fiscal → SPED SVA.

Tareas operativas SVA (mantenimiento de los gateways)

Estas tareas mantienen funcionando la integración con los gateways externos — no tocan la nota fiscal:

Nombre Integrador Qué hace
watchtoken Watchbrasil Renueva el token de acceso a la API de Watchbrasil. Los tokens de esa API expiran y deben solicitarse periódicamente — sin esa tarea corriendo, las activaciones de nuevos usuarios empiezan a fallar.
criarusuariosdigilivros Digilivros Sincroniza usuarios Quaza ↔ Digilivros: crea los usuarios nuevos en el gateway, actualiza correos y códigos de vinculación.
Cada integrador puede tener su propia tarea de mantenimiento. La lista de arriba es la que existe hoy — cuando se agregan nuevos integradores a Quaza, pueden venir con tareas propias dependiendo del estándar de la API. Consulte al equipo técnico si un integrador específico dejó de funcionar.

SPED EFD-Contribuições

La "transmisión" de la NFe-SVA a la Hacienda es vía SPED EFD-Contribuições — archivo .TXT mensual entregado por la contabilidad. El SPED de Quaza combina NFe-SVA + NFSe en el mismo archivo (son los dos tipos de nota que entran en esa escrituración).

SPED SVAFiscal → SPED SVA

Pantalla de generación manual. Seleccione:

  • Empresa NFe — emisor.
  • Año y mes — competencia de la escrituración.

El sistema genera un archivo UF+CNPJ+ANO+MES+EFDCont.TXT conteniendo la totalización de PIS/COFINS de todas las NFe-SVA + NFSe en estado Activa en ese mes. El archivo se almacena y puede ser descargado por la contabilidad para entrega a la Hacienda.

Las notas Canceladas NO entran en el SPED. El SPED solo agrega NFe-SVA Activas. Cancelar una nota antes del cierre del mes es la forma correcta de excluirla de la escrituración. Después de cerrar el mes (SPED generado y entregado), las correcciones se convierten en tema de rectificación fiscal — hable con el contador.

DANFE-SVA — el PDF

El DANFE-SVA es un PDF simple generado por Quaza después de la emisión de la nota (estado Activa o Espejo). Difiere del DANFE/DANFE-COM por ser más minimalista:

Característica Detalle
Prerequisito NFe-SVA guardada (Espejo o Activa).
Generación Quaza la arma vía clase propia (TCPDF). Diseño simple sin código QR, sin clave de acceso (no hay).
Contenido Encabezado de la empresa, datos del cliente, lista de planes cobrados (con CFOP), totales (PIS/COFINS), observaciones.
Distribución Correo (botón "Enviar por correo"), WhatsApp o impresión.
Almacenamiento En caché en storage/nfesva/{id}.pdf.

Cancelación

Una NFe-SVA Activa puede ser cancelada — basta hacer clic en Cancelar nota y confirmar. A diferencia de la NFe y NFCom:

Característica NFe-SVA
Plazo Solo dentro del mes de emisión
Justificación No exigida
Comunicación SEFAZ No hay — la cancelación es interna
Efecto en el SPED La nota no entra en el SPED del mes (fue cancelada antes del cierre)
Revertir la cancelación No hay — emita una nueva nota si es necesario
¿Pasó del mes? Ya no se cancela. Después del fin del mes de emisión, el sistema rechaza la cancelación. Opciones: (1) dejarla como está y ajustar en la próxima competencia (emitir una nota negativa de ajuste, si aplica); (2) rectificar el SPED ya entregado — operación contable, fuera de Quaza.

Tributos calculados

NFe-SVA es tributariamente mucho más simple que NFe/NFCom/NFSe. Solo se calculan PIS y COFINS:

Tributo Qué es Alícuota típica
PIS Federal sobre el ingreso. 0,65% (cumulativo) o 1,65% (no-cumulativo)
COFINS Federal sobre el ingreso. 3% (cumulativo) o 7,6% (no-cumulativo)
No hay ICMS en la NFe-SVA — los servicios de valor agregado no son "comunicación" ni "circulación de mercancía", así que escapan de la incidencia del ICMS. Esto es un hecho fiscal externo (Anatel + Hacienda), no una decisión del sistema. Confirme con su contador la configuración de las alícuotas correctas para cada producto SVA.
Empresas Simples Nacional: PIS/COFINS salen por el DAS — no se destacan en la nota. Configure el CRT de la Empresa NFe correctamente; el sistema ajusta el cálculo.

De dónde vienen los datos

Campo de la NFe-SVA Origen
Emisor (CNPJ, IE, IM, dirección) Fiscal → Empresa NFe (pestañas Principal + Dirección + Información fiscal)
Destinatario (cliente, CPF/CNPJ, dirección) Registro del cliente
Plan (descripción, valor, CFOP, PIS/COFINS) Fiscal → Producto NFe-SVA
Integrador (gateway) SVA → Integrador
Mapeo Plan ↔ código en el integrador SVA → Plan
Vínculo cliente ↔ usuario del gateway SVA → Usuario
Serie + numeración Fiscal → Serie fiscal (modelo NFe-SVA)
Competencia Tarea de facturación — mes/año de la factura generadora
Ítems vinculados Contrato + Factura/débito

Trampas frecuentes

La retención de PIS/COFINS depende del registro del cliente. Si el cliente tiene las marcaciones de "retener PIS" y/o "retener COFINS" activas, la NFe-SVA calcula la retención de esos tributos sobre el total. Sin esas marcaciones, no hay retención. Revise el registro fiscal del cliente.
Al activar, la nota genera un débito financiero. Cuando el espejo es promovido (activado), Quaza crea automáticamente el documento/débito vinculado — que después puede convertirse en cobro. No es necesario lanzar el cobro por separado.
1. Confundir NFe-SVA con NFe modelo 55. NFe es mercancía (CFOP 5102/6102, tiene NCM, ICMS). NFe-SVA es servicio de valor agregado (CFOP 5301/6301, sin NCM, solo PIS/COFINS). Al registrar el Producto NFe-SVA, no intente poner NCM — el registro no tiene ese campo.
2. El token del gateway expira sin aviso. Algunos integradores (especialmente Watchbrasil) tienen tokens de corta duración. Sin la tarea watchtoken corriendo, las activaciones de nuevos usuarios empiezan a fallar silenciosamente. Síntoma: el cliente contrata el plan, el sistema "activa", pero en el proveedor el usuario no existe. Verifique el log en SVA → Request log.
3. Código del integrador incorrecto en el Plan. El ID del plan en el gateway externo (ej: ID del plan "Premium" en Watchbrasil) debe ser exacto. Un dígito equivocado y la activación falla. Confirme el código con el proveedor antes de registrar.
4. Cancelar la nota no cancela el servicio en el proveedor. Cancelar la NFe-SVA es solo un acto fiscal — no desactiva el usuario en el gateway externo. Para desactivar el servicio, edite el Usuario SVA y cambie la situación a Inactivo (que dispara la llamada de API correspondiente).
5. El SPED solo toma notas Activas. Las notas Canceladas no entran. Si cancela una nota después de generar el SPED del mes, tendrá una inconsistencia entre Quaza y el archivo entregado. Genere el SPED solo a fin de mes, después de cerrar todas las cancelaciones.
6. PIS/COFINS incorrecto en el producto. Una empresa Lucro Real generalmente usa no-cumulativo (1,65% + 7,6%); Lucro Presumido usa cumulativo (0,65% + 3%); Simples sale por el DAS. Configurarlo mal distorsiona el SPED.
7. Un integrador nuevo requiere desarrollo. La lista de más de 23 integradores cubre los principales, pero si el proveedor que quiere agregar no está, requiere implementación. No hay registro genérico — cada API es específica.
8. Homologación y Producción comparten el listado. Use el filtro "Ambiente" para separar. Las notas en homologación NO entran en el SPED real.
9. El correo con el DANFE-SVA es texto fijo del sistema. El contenido del correo se arma automáticamente — no es una plantilla configurable por el cliente.
10. NFe-SVA no es una factura — es un registro fiscal. El cobro financiero sale independiente de la emisión de la nota. Si la nota falla, el boleto o la tarjeta se cobra igual. Solo el registro fiscal queda pendiente.

FAQ

¿Quién está obligado a emitir NFe-SVA?

Cualquier proveedor que revenda servicios digitales de valor agregado al cliente — streaming, antivirus, audiolibro, telefonía OTT, etc. La regla fiscal sigue la definición de SVA de la Anatel.

¿Por qué NFe-SVA es tanto más simple que NFe o NFCom?

Porque los servicios de valor agregado tienen un tratamiento tributario simplificado: solo PIS/COFINS federales (sin ICMS), declaración mensual vía SPED (sin transmisión en tiempo real a la SEFAZ), y cancelación libre dentro del mes. La complejidad del módulo está en la integración con los más de 23 gateways externos, no en la fiscalidad.

¿Cómo sé si un servicio es SVA o comunicación?

Regla general: si el servicio usa la infraestructura de telecom pero es entregado por terceros (Netflix, Spotify, antivirus del proveedor X), es SVA. Si es el propio servicio de comunicación (internet, telefonía, TV operada por la empresa), es NFCom. En caso de duda, confirme con el contador — la clasificación errónea puede causar problemas fiscales.

¿Puedo emitir NFe-SVA sin certificado A1?

Sí — NFe-SVA no exige certificado porque no hay transmisión a la SEFAZ. Si la empresa también emite NFe/NFCom/NFSe, el certificado es necesario para esas, no para NFe-SVA.

El gateway externo (Watchbrasil, OleTV, etc) dejó de funcionar — ¿qué hacer?

Verifique SVA → Request log por las últimas llamadas y sus respuestas. Si hay muchos errores HTTP 401/403, generalmente es un token expirado o credencial inválida — confirme en SVA → Integrador. Si es un problema del lado del proveedor, abra un ticket con ellos. Las tareas watchtoken/criarusuariosdigilivros (y similares) ayudan a mantener la integración viva — verifique si están corriendo.

¿Cómo agrego un integrador nuevo (no está en la lista de 23)?

Requiere desarrollo. Abra un ticket técnico aportando la documentación de la API del nuevo integrador. Cada integración nueva exige cerca de 1-2 semanas de desarrollo y homologación.

¿Cuándo corro el SPED?

Al inicio del mes siguiente al de la competencia, después de garantizar que todas las cancelaciones del mes fueron hechas. La contabilidad entrega el archivo a la Hacienda hasta la fecha límite legal (consulte el calendario fiscal).

Cancelé la NFe-SVA pero el cliente sigue usando el servicio — ¿por qué?

Cancelar la nota es solo un acto fiscal. Para desactivar el servicio en el proveedor, vaya a SVA → Usuario y cambie la situación del usuario a Inactivo — eso dispara la llamada de API que efectivamente desactiva el servicio.

¿NFe-SVA tiene código QR?

No. No hay transmisión a la SEFAZ ni consulta pública. El DANFE-SVA es un PDF simple con los datos de la operación.

¿Cómo veo el historial de llamadas API al integrador?

En SVA → Request log. Cada llamada (crear usuario, alterar plan, cancelar) queda registrada con fecha, request enviado y respuesta recibida. Útil para depuración.

¿Una empresa Simples Nacional emite NFe-SVA?

Sí. PIS/COFINS salen por el DAS — no se destacan en la nota. Configure CRT=1 en la Empresa NFe.

¿Puedo editar la NFe-SVA después de Activa?

No — estado fiscal definitivo. Si se equivocó: cancela (dentro del mes) y emite una nueva. No hay CCe ni Sustitución.

Documentos relacionados