SVA — Servicio de Valor Agregado y lla NFeSVA — Streaming, ebooks, telefonía y almacenamiento que el proveedor vende junto con el plan de internet — y la factura específica para facturarlos
Esta wiki explica el SVA (Servicio de Valor Agregado) desde dos perspectivas que se mezclan en todos los ISPs: (1) SVA como producto que vendes al cliente (TV vía streaming, ebooks, antivirus, etc.) e (2) SVA como tipo de factura — lla NFeSVA, modelo fiscal específico que separa servicio de valor agregado de la NFe de mercancía y la NFCom de comunicación.
El punto central: SVA no es internet, es todo lo que viene adicionalmente a internet (streaming, telefonía VoIP, monitoreo, antivirus). En la contabilidad fiscal brasileña, tiene un tratamiento diferente — emite NFeSVA (modelo propio), no NFe (mercancía) ni NFSe (servicio municipal) ni NFCom (telecom).
Por ques SVA importa para el proveedor
Proveedores de internet brasileños enfrentaron un problema fiscal histórico: todo que no era estrictamente "comunicación" (Netflix, telefonía, monitoreo) caía en un limbo entre ISS (municipio) e ICMS (estado). Para resolver, se creó la categoría SVA con su propio documento fiscal — la NFeSVA — generalmente exento o con tributación reducida.
| Tipo de producto |
Documento fiscal |
Tributo principal |
| Internet pura |
NFCom |
ICMS-Comunicação (con exención en varios estados) |
| Equipo (ONU, router vendido) |
NFe |
ICMS-Mercadoria + IPI |
| Instalación (mano de obra) |
NFSe |
ISS (municipio) |
|
SVA (Netflix, ebook, telefonía, cloud) |
NFeSVA |
Tratamiento propio (varía por SVA) |
¿Por ques separar? Si emites Netflix como NFCom, el estado puede multar (no es comunicación). Si emites como NFe (mercancía), tampoco cabe. NFSe (servicio municipal) tiene alícuota ISS de 2-5% — caro. NFeSVA quedó como tesrmino medio aceptado por la mayoría de las SEFAZ estaduales.
Visión general — el ciclo de un SVA
PROVEEDOR INTEGRADOR EXTERNO CLIENTE FINAL
(Quaza) (Watch Brasil, etc.) (suscriptor)
│ │ │
│ 1. Cliente quiere "Internet + Paramount+" │
├──────────────────────────────────────────►
│ │ │
│ 2. Crea contrato con SVA "Paramount+" │
├──┐ │ │
│ ▼ │ │
│ contratoServico │ │
│ + svaUsuario │ │
│ │ │ │
│ └─────► 3. Provisiona usuario en el integrador (POST API)
│ │ │
│ │ 4. Email al cliente: "usa user/contraseña X"
│ ├──────────────────────►│
│ │ │
│ 5. Cliente accede a Paramount+ con user X │
│ │◄──────────────────────│
│ │ │
│ 6. Fim do mês: gerla NFeSVA p/ cliente │
│ + Emite + cobra mensualidad │
│ │ │
│ 7. Cliente paga │
│ + Proveedor paga integrador (split) │
│ ├───────────────────────│
│ ◄────────────────│ │
│ (reparto acordado, ej: 30% a Paramount, 70% al proveedor)
Resumiendo: proveedor es el intermediario entre el servicio (Netflix, ebooks, telefonía) y el cliente. Factura al cliente, paga al integrador, emite la factura específica.
Glosario — vocabulario del SVA
Tipos de SVA más comunes
| Categoría |
Ejemplos |
Cómo funciona |
| TV / Streaming |
Watch Brasil, Paramount+, HBO Max, Globoplay, Disney+ |
Provisiona cuenta en el integrador, cliente accede vía app/web |
| Libros / Audiobooks |
Skeelo, UBook, Premium Audiobook, Storytel |
Cuenta SVA atada al plan da acceso a catálogo |
| Música |
Deezer Premium, Amazon Music |
Idem TV pero para música |
| Cloud / Email / Office |
Google Workspace, MS 365, Dropbox |
Cuenta de e-mail/cloud provisionada por el proveedor |
| Seguridad |
Antivirus McAfee, Kaspersky, Monitoreo Cámaras (CDNTV) |
Licencia de software o monitoreo entregada al cliente |
| Telefonía VoIP |
SIP Trunk, fijo digital, telefonía móvil virtual |
Cuenta SIP + número provisionado, integra al plan |
Conceptos del módulo
| Concepto |
Ques es |
| Integrador |
Empresa externa que provee el servicio (Watch Brasil, Skeelo, PlayHub, Celeti, UBook, Cariap OTT). Cada integrador tiene su API/credenciales. |
| Gateway |
Modo de integración con el integrador (REST API, OAuth, SOAP). Cada integrador define su gateway. |
| Plan SVA |
"Paquete" ofrecido por el integrador (ex: "UBOOK GO ADVANCED", "01 SERVICIO A ELECCIÓN"). Proveedor registra los planes que quiere revender. |
| Usuario SVA |
La cuenta provisionada para el cliente en ese integrador (credencial de acceso). 1 contrato puede tener varios usuarios SVA (Netflix + Skeelo + Antivirus). |
| NFeSVA |
Factura electrónica modelo SVA — documento fiscal específico que separa SVA de las demás facturas. |
| Serie Fiscal SVA |
Serie de facturas dedicada — emites cada SVA con numeración propia (no conflicta con NFe de mercancía o NFCom) |
1 Integradores — quiesn provee el servicio
SVA → SVA Integrador
Registra cada integrador externo con el cual el proveedor tiene contrato comercial. El integrador define el gateway (forma de comunicación) y cada uno requiere credenciales distintas (client_id, client_secret, endpoint).
Integradores registrados — note los ejemplos reales: Watch Brasil (HBO, BASICO), PlayHub, Celeti, Skeelo, Cariap OTT (UBook). Columna GATEWAY identifica el sistema tescnico de integración.
| Campo |
Función |
| Descripción |
Nombre comercial visible al operador (ex: "Watch Brasil - HBO") |
| Gateway |
Identificador tescnico de la integración en Quaza (Watch Brasil, PlayHub, Skeelo, etc.) |
| Client ID / Secret |
Credenciales que el proveedor recibe del integrador. Generalmente OAuth2. |
| Endpoint |
URL de la API del integrador (ex: https://apiweb.watch.tv.br/oauth/token) |
Flujo comercial: antes de registrar aquí, necesitas firmar contrato con el integrador, recibir credenciales (client_id/secret) y definir el split (% que queda para ti vs % para el integrador). Registro tescnico es el último paso.
2 Planes SVA — lo que revendes
SVA → Plan
Cada integrador ofrece múltiples planes. Aquí registras solo los planes que quieres revender con nombres amigables al cliente final.
Planes registrados — descripción comercial + integrador + código que será enviado al integrador (ex: UBO, UBP, Q01)
| Campo |
Función |
| Descripción |
Nombre comercial (ex: "UBOOK GO ADVANCED", "01 SERVICIO A ELECCIÓN") |
| Integrador |
De ques integrador es ese plan |
| Código Integrador |
SKU/código que el integrador exige en la API (ex: UBO, Q01) |
| Situación |
Habilitado (vende) / Deshabilitado (legado, no vende más nuevos) |
¿Por ques tantos planes parecidos? Integradores ofrecen combos diferenciados — "01 servicio a elección" significa que cliente puede elegir 1 libro/audiobook del catálogo; "03 servicios a elección" = 3 ítems. Proveedor vende cada nivel con precio diferente.
3 Usuários SVA — suscriptors provisionados
SVA → Usuario
Cada vez que un cliente del proveedor añade un SVA a su contrato, es creado un usuario SVA: el sistema llama a la API del integrador, provisiona una cuenta, recibe credenciales (usuario/contraseña) y almacena aquí. Cliente recibe e-mail con instrucciones.
Usuarios SVA — vinculación Cliente → Contrato → Integrador → Plan → Usuario
| Campo |
Función |
| Cliente |
Cliente del proveedor (ver Cliente
) |
| Contrato |
Contrato al cual el SVA está vinculado |
| Integrador |
Qué integrador (Skeelo, PlayHub, Watch Brasil) |
| Usuario |
Login provisionado por el integrador (generalmente un identificador único) |
| Plan |
Qué plan está activo (Audiobook Regular, Ebook Premium, Paramount+HBO) |
| Situación |
Habilitado / Bloqueado (cliente inadimplente, sistema bloqueia tambesm o SVA) / Cancelado |
Bloqueo en cascada: cuando el contrato del cliente queda
Bloqueado automático (cf.
Cliente
), o sistema tambesm tira acesso aos SVAs ativos — llama API del integrador deshabilitando temporalmente. Cliente paga, sistema reactiva. Esse es um dos motivos pra escolher integrador com API confiável.
4 Request Log — auditoría de las llamadas API
SVA → SVA Request Log
Cada vez que Quaza habla con la API del integrador (crear usuario, bloquear, cambiar plan), a request es registrada aqui. Herramienta de debug esencial — si algo salió mal en la provisión, está aquí.
Log de requests — URL chamada, mestodo (POST/GET), código de resposta, data
| Columna |
Qué muestra |
| URL |
Endpoint llamado (ex: https://apiweb.watch.tv.br/oauth/token) |
| Mestodo |
POST (crear/actualizar) / GET (consultar) / DELETE (eliminar) |
| Código de la Request |
HTTP status — 200 (ok) / 401 (credencial errada) / 500 (error del integrador) |
| Creación |
Fecha/hora de la llamada |
Troubleshooting: cliente reclama "Paramount+ no funciona". Ve en SVA → Usuario, pega o login dele. Ve en Request Log, filtra por hora cerca de la reclamación. Ve si hubo error 401/500 — se sim, es problema na integração; se 200, es problema no app do cliente.
5 NFeSVA — Factura Electrónica de SVA
Fiscal → NFe SVA
Aqui es onde a perspectiva fiscal entra. Toda venda de SVA es faturada com uma NFeSVA — não com NFe (mercadoria), nem NFSe (serviço municipal), nem NFCom (comunicação).
Listado de NFe SVA — IMP (¿impresa?), Código interno, Número de factura, Emisión, Empresa emisora, Cliente, CPF/CNPJ, Valor, Competencia, Estado de la factura
| Coluna |
O que es |
| IMP |
Ícono — si ya fue impresa/transmitida con éxito a SEFAZ |
| Código |
Secuencial interno de Quaza |
| Número |
Número fiscal da nota (gerado pela sesrie fiscal) |
| Emisión |
Fecha en que la factura fue emitida |
| Empresa de la Factura |
Empresa fiscal emisora (proveedor puede tener varias empresas, ex: "Empresa Exemplo 4" — ver Cliente
) |
| Cliente / CPF/CNPJ |
Destinatario de la factura |
| Valor Total |
Valor facturado en esa factura (R$ 10,50 = valor mensual del SVA) |
| Competencia |
Mes/año de referencia (ex: Maio/2026) |
| Estado |
Activa / Cancelada / Rechazada (SEFAZ rechazó) / Esperando |
Como la NFeSVA es gerada
| Paso |
Pasa |
| 1 |
Cliente tiene SVA activo en el contrato (ex: Paramount+ por R$ 39,90/mes) |
| 2 |
Cron mensual de facturación se ejecuta |
| 3 |
Sistema separa: parte de internet → vai pra NFCom; parte do SVA → vai prla NFeSVA |
| 4 |
Sistema busca a sesrie fiscal configurada para SVA (cf. Categoría
de producto SVA = "Servicios de Valor Agregado" + NFeSVA) |
| 5 |
Genera XML, envía a SEFAZ vía FacturaSend u otro proveedor de NFe |
| 6 |
Recibe protocolo, marca Estado=Activa, genera DANFE (PDF de la factura) |
| 7 |
NFeSVA queda disponible para download del cliente en el portal |
Filtros típicos: a tela tem filtros pres-criados ("Padrão", "Filtros Personalizados"). Cada filtro recorta un escenario específico — útil para acompañar SVAs de una empresa filial vs otra.
Flujos típicos paso a paso
Flujo 1: Agregar SVA nuevo a contrato existente
| Paso |
Dónde |
Qué hacer |
| 1 |
Cliente → Contrato
|
Abrir contrato del cliente que quiere agregar SVA |
| 2 |
Pestaña Servicios |
Agregar servicio, elegir tipo "SVA" |
| 3 |
Wizard SVA |
Elegir integrador, plan, datos personales del cliente (si exigido por el integrador, ej: e-mail para Watch Brasil) |
| 4 |
Sistema llama API |
POST al endpoint del integrador → recibe usuario/contraseña provisionados |
| 5 |
Sistema graba en svaUsuario |
Vincula Cliente ↔ Integrador ↔ Plan ↔ Login provisionado |
| 6 |
Sistema envía e-mail al cliente |
"Ya tienes Paramount+. Accede con user X, contraseña Y" |
| 7 |
Próxima mensualidad |
Inclui valor do SVA, gerla NFeSVA junto |
Flujo 2: Cancelar SVA (cliente ya no quiere)
| Paso |
Dónde |
Qué hacer |
| 1 |
Cliente → Contrato → Servicios |
Eliminar o deshabilitar servicio SVA |
| 2 |
Sistema llama API |
DELETE o status=inactive en el integrador |
| 3 |
Sistema graba en svaUsuario |
Situación = Cancelado |
| 4 |
Próxima mensualidad |
No incluye SVA (o proporcional si canceló a mitad del mes) |
Flujo 3: Cliente moroso — SVA bloqueado en cascada
| Passo |
Onde |
| 1 |
Cron de morosidad (D+30) marca contrato Bloqueado automático
|
| 2 |
Sistema lista SVAs del contrato y llama API del integrador deshabilitando |
| 3 |
Cliente pierde acceso a Paramount+, Skeelo, etc. |
| 4 |
Cliente paga → cron de retorno reactiva contrato → reactiva SVAs (llama API nuevamente) |
Flujo 4: Debug "cliente dice que SVA no funciona"
| Paso |
Dónde |
Qué verificar |
| 1 |
SVA → Usuario |
¿Cliente tiene SVA registrado? ¿Situación = Habilitado? |
| 2 |
SVA → Request Log |
¿Última llamada API con éxito? ¿Algún error 401/500 reciente? |
| 3 |
Caso error 401 |
Credencial del integrador expiró — actualizar Client Secret |
| 4 |
Caso error 500 |
Problema en el lado del integrador — abrir ticket con él |
| 5 |
Caso todo 200 |
Cliente está usando user/contraseña erradas — reenviar e-mail con instrucciones |
Trampas frecuentes
1. Integrador exige CPF/email para provisionar. Algunos SVAs (especialmente streaming) exigen CPF + e-mail válidos del cliente final para crear la cuenta. Si cliente está registrado sin esos datos, provisión falla. Ejecuta
Análisis de Registros
antes de habilitar SVA en masa.
2. Bloqueo en cascada depende de cada integrador. No todos los integradores tienen endpoint de "deshabilitar temporalmente" — algunos solo "cancelar". Si cancelas, cuando el cliente pague necesitas recrear la cuenta — puede dar usuario/contraseña diferentes.
3. NFeSVA tem sesrie fiscal própria. Não emita SVA na mesma sesrie da NFCom ou NFe — a SEFAZ vai rejeitar. Configure sesrie dedicada em
Categoria
→ sesrie fiscal = "Fatura de cobrança" / "Nota de cobrança (NFeSVA)".
4. Split com integrador es manual. Quaza fatura ao cliente, mas o repasse ao integrador (% acordado) es processo separado — no automatizado por defecto. Necesitas cerrar mensualmente y pagar.
5. Request Log crece mucho. Cada llamada API genera un registro. Si tienes 10k clientes con 2 SVAs cada uno y cron diario, son 600k+ registros/mes. Configura rotación/purga.
6. SVA no cuenta como Ingreso de Comunicación. Para ANATEL/SCI, SVA no entra en la base de ingreso de telecom. Importante a la hora de calcular tasas regulatorias e impuestos específicos.
Galería de pantallas
Integrador
Plano
Usuario
Requestlog
Nfesva
Documentos relacionados
Profundiza en los temas conexos:
-
Cliente / Contrato
— SVA es vinculado a um contrato (serviço do contrato)
-
Estoque / Categoria fiscal
— onde configura a categoria de produto que mapeia prla NFeSVA
-
Suporte / OS
— abrir OS cuando cliente reclama "SVA no funciona"
-
Paneles / Dashboards
— visión ejecutiva, indicadores diarios y alertas operacionales
-
Telefonía (VoIP + MVNO)
— servicios de voz fija y móvil que pueden ser vendidos junto con internet
-
Administración
— configuraciones, usuarios, permisos (ACL), tareas (crons) y logs de auditoría
-
Comunicación
— Email, SMS, WhatsApp y campañas masivas para clientes
-
Chat
— atención omnicanal en vivo (WhatsApp, bot, respuestas rápidas)
-
Portal / Área del Cliente
— autoatención del cliente final (2da vía, OS, dependientes, recomendaciones)
-
Mapa
— visualización geográfica de clientes, CTOs, postes, cables FO (georreferencia)
-
Fibra e Rede
— contexto tescnico (telefonia VoIP em SVA usa SIP via rede do provedor)
-
Factura — agrupación mensual de NFCom + NFeSVA
-
FacturaSend — para emissão dla NFeSVA em Paraguay (DE)
-
Fiscal Brasil — configuração geral de sesries e empresas fiscais
-
Cobrança — geração de cobrança do valor dla NFeSVA
Preguntas frecuentes
¿Puedo tener el mismo cliente con 5 SVAs diferentes?
Sí. Cada SVA = 1 svaUsuario distinto. Cliente puede tener Skeelo + Paramount+ + Antivirus + VoIP + Cloud, con 5 logins separados, generando 5 NFeSVAs todos los meses (o 1 solo con 5 ítems, dependiendo de la configuración).
¿Cliente cambió de plan (de Paramount Basic a Paramount+HBO) — necesito recrear?
Depende del integrador. Watch Brasil acepta "upgrade in-place" vía API; Skeelo generalmente exige cancelar y recrear (generando login nuevo). Mira el Request Log del integrador específico.
¿Cómo sé cuánto facturo mensualmente en SVA?
Filtra NFe SVA por mes de Competencia, suma de Valor Total. Exporta listado.
¿Proveedor puede vender SVA sin internet?
Técnicamente sí, pero la mayoría de los integradores tiene cláusula de "solo para clientes de internet". Verifica el contrato comercial con cada uno.
¿Cliente cancela contrato — SVAs se cancelan junto?
Sí, sistema cancela todos los SVAs vinculados cuando el contrato va a Cancelado. NFeSVAs futuras dejan de ser generadas. NFeSVAs ya emitidas quedan (son facturas históricas).
¿Puedo emitir NFeSVA retroactiva?
Sí, pero con límite (generalmente 90 días). Usa con cuidado — confunde contabilidad del cliente.
¿Cómo integro un SVA nuevo (que aún no está en Quaza)?
Necesitas que Quaza Tecnologia desarrolle el conector. El módulo SVA soporta varios gateways listos (Watch Brasil, PlayHub, Skeelo, Celeti, UBook/Cariap). Nuevos integradores son desarrollo bajo demanda.
¿Cómo medir el éxito operacional?
Defina 3 KPIs y acompañe semanalmente. Tendencia importa más que valor absoluto.
¿Hay entrenamiento oficial Quaza?
Sí — equipo de soporte ofrece sesiones de onboarding.
¿Cómo reportar bug o pedir nueva feature?
Por el canal de soporte. Incluya contexto: lo que esperaba, lo que pasó, frecuencia.
¿Cómo empezar a usar este módulo?
Configure los pre-requisitos, haga teste con pocos registros, valide con equipo, después active producción.
¿Necesito permiso especial?
Sí. Cada rol tiene permisos distintos.