SVA — Serviço de Valor Agregado e NFeSVA — Streaming, ebooks, telefonia y almacenamiento que el provedor vende junto con el plan de internet — y la fatura específica para faturarlos
Esta wiki explica el SVA (Serviço de Valor Agregado) desde dos perspectivas que se mezclan en todos os ISPs: (1) SVA como producto que vendes al cliente (TV vía streaming, ebooks, antivirus, etc.) e (2) SVA como tipo de fatura — lla NFeSVA, modelo fiscal específico que separa servicio de valor agregado da 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, telefonia VoIP, monitoreo, antivirus). En la contabilidad fiscal brasileña, tem un tratamiento diferente — emite NFeSVA (modelo propio), no NFe (mercancía) ni NFSe (servicio municipal) ni NFCom (telecom).
Por que SVA importa para o provedor
Provedores de internet brasileños enfrentaron un problema fiscal histórico: todo que no era estrictamente "comunicación" (Netflix, telefonia, monitoreo) caía en un limbo entre ISS (municipio) e ICMS (estado). Para resolver, se creó la categoría SVA con seu propio documento fiscal — la NFeSVA — geralmente 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) |
| Equipe (ONU, router vendido) |
NFe |
ICMS-Mercadoria + IPI |
| Instalación (mano de obra) |
NFSe |
ISS (municipio) |
|
SVA (Netflix, ebook, telefonia, cloud) |
NFeSVA |
Tratamiento propio (varía por SVA) |
Por ques separar? Si emites Netflix como NFCom, el estado pode multar (no es comunicación). Si emites como NFe (mercancía), tampoco cabe. NFSe (servicio municipal) tem alícuota ISS de 2-5% — caro. NFeSVA quedó como tesrmino medio aceptado por la mayoría de as SEFAZ estaduales.
Visão geral — o ciclo de um SVA
PROVEEDOR INTEGRADOR EXTERNO CLIENTE FINAL
(Quaza) (Watch Brasil, etc.) (suscriptor)
│ │ │
│ 1. Cliente quiere "Internet + Paramount+" │
├──────────────────────────────────────────►
│ │ │
│ 2. Crea contrato con SVA "Paramount+" │
├──┐ │ │
│ ▼ │ │
│ contratoServico │ │
│ + svaUsuário │ │
│ │ │ │
│ └─────► 3. Provisiona usuário en el integrador (POST API)
│ │ │
│ │ 4. Email al cliente: "usa user/senha X"
│ ├──────────────────────►│
│ │ │
│ 5. Cliente accede a Paramount+ con user X │
│ │◄──────────────────────│
│ │ │
│ 6. Fim do mês: gerla NFeSVA p/ cliente │
│ + Emite + cobra mensalidade │
│ │ │
│ 7. Cliente paga │
│ + Provedor paga integrador (split) │
│ ├───────────────────────│
│ ◄────────────────│ │
│ (reparto acordado, ej: 30% a Paramount, 70% al provedor)
Resumiendo: provedor es el intermediario entre el servicio (Netflix, ebooks, telefonia) y el cliente. Fatura al cliente, paga al integrador, emite la fatura específica.
Glossário — vocabulário do SVA
Tipos de SVA más comunes
| Categoría |
Ejemplos |
Como funciona |
| TV / Streaming |
Watch Brasil, Paramount+, HBO Max, Globoplay, Disney+ |
Provisiona conta en el integrador, cliente accede vía app/web |
| Libros / Audiobooks |
Skeelo, UBook, Premium Audiobook, Storytel |
Conta SVA atada al plan da acesso a catálogo |
| Música |
Deezer Premium, Amazon Music |
Idem TV pero para música |
| Cloud / Email / Office |
Google Workspace, MS 365, Dropbox |
Conta de e-mail/cloud provisionada por el provedor |
| Seguridad |
Antivirus McAfee, Kaspersky, Monitoreo Cámaras (CDNTV) |
Licencia de software o monitoreo entregada al cliente |
| Telefonia VoIP |
SIP Trunk, fijo digital, telefonia móvil virtual |
Conta SIP + número provisionado, integra al plan |
Conceptos do módulo
| Concepto |
Ques es |
| Integrador |
Empresa externa que provee el servicio (Watch Brasil, Skeelo, PlayHub, Celeti, UBook, Cariap OTT). Cada integrador tem seu API/credenciales. |
| Gateway |
Modo de integración con el integrador (REST API, OAuth, SOAP). Cada integrador define seu gateway. |
| Plan SVA |
"Paquete" ofrecido por el integrador (ex: "UBOOK GO ADVANCED", "01 SERVICIO A ELECCIÓN"). Provedor registra os planes que quiere revender. |
| Usuário SVA |
La conta provisionada para el cliente en ese integrador (credencial de acesso). 1 contrato pode tener varios usuários SVA (Netflix + Skeelo + Antivirus). |
| NFeSVA |
Fatura electrónica modelo SVA — documento fiscal específico que separa SVA de as demás faturas. |
| Serie Fiscal SVA |
Serie de faturas 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 provedor tem 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 os ejemplos reales: Watch Brasil (HBO, BASICO), PlayHub, Celeti, Skeelo, Cariap OTT (UBook). Columna GATEWAY identifica el sistema tescnico de integración.
| Campo |
Função |
| Descripción |
Nome comercial visible al operador (ex: "Watch Brasil - HBO") |
| Gateway |
Identificador tescnico da integración en Quaza (Watch Brasil, PlayHub, Skeelo, etc.) |
| Client ID / Secret |
Credenciales que el provedor recibe do integrador. Geralmente OAuth2. |
| Endpoint |
URL da API do integrador (ex: https://apiweb.watch.tv.br/oauth/token) |
Fluxo comercial: antes de registrar aquí, precisas 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 os 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 |
Função |
| Descripción |
Nome 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) |
| Situação |
Habilitado (vende) / Desabilitado (legado, no vende más nuevos) |
Por ques tantos planes parecidos? Integradores ofrecen combos diferenciados — "01 servicio a elección" significa que cliente pode elegir 1 libro/audiobook do catálogo; "03 serviços a elección" = 3 ítems. Provedor vende cada nivel con precio diferente.
3 Usuários SVA — suscriptors provisionados
SVA → Usuário
Cada vez que un cliente do provedor añade un SVA a seu contrato, es creado un usuário SVA: el sistema llama a la API do integrador, provisiona uma conta, recibe credenciales (usuário/senha) y almacena aquí. Cliente recibe e-mail con instrucciones.
Usuários SVA — vinculación Cliente → Contrato → Integrador → Plan → Usuário
| Campo |
Função |
| Cliente |
Cliente do provedor (ver Cliente
) |
| Contrato |
Contrato al cual el SVA está vinculado |
| Integrador |
O que integrador (Skeelo, PlayHub, Watch Brasil) |
| Usuário |
Login provisionado por el integrador (geralmente un identificador único) |
| Plan |
O que plan está activo (Audiobook Regular, Ebook Premium, Paramount+HBO) |
| Situação |
Habilitado / Bloqueado (cliente inadimplente, sistema bloqueia tambesm o SVA) / Cancelado |
Bloqueo en cascada: cuando el contrato do cliente queda
Bloqueado automático (cf.
Cliente
), o sistema tambesm tira acesso aos SVAs ativos — llama API do integrador deshabilitando temporalmente. Cliente paga, sistema reactiva. Esse es um dos motivos pra escolher integrador com API confiável.
4 Request Log — auditoria de as llamadas API
SVA → SVA Request Log
Cada vez que Quaza habla con la API do integrador (criar usuário, 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 |
O que mostra |
| URL |
Endpoint llamado (ex: https://apiweb.watch.tv.br/oauth/token) |
| Mestodo |
POST (criar/actualizar) / GET (consultar) / DELETE (eliminar) |
| Código da Request |
HTTP status — 200 (ok) / 401 (credencial errada) / 500 (error do integrador) |
| Creación |
Fecha/hora da llamada |
Troubleshooting: cliente reclama "Paramount+ no funciona". Ve en SVA → Usuário, pega o login dele. Ve en Request Log, filtra por hora cerca da 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 — Fatura 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).
Listagem de NFe SVA — IMP (impresa?), Código interno, Número de fatura, Emisión, Empresa emisora, Cliente, CPF/CNPJ, Valor, Competencia, Estado da fatura
| 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 fatura fue emitida |
| Empresa da Fatura |
Empresa fiscal emisora (provedor pode tener varias empresas, ex: "Empresa Exemplo 4" — ver Cliente
) |
| Cliente / CPF/CNPJ |
Destinatario da fatura |
| Valor Total |
Valor faturado en esa fatura (R$ 10,50 = valor mensual do SVA) |
| Competencia |
Mes/año de referencia (ex: Maio/2026) |
| Estado |
Activa / Cancelada / Rechazada (SEFAZ rechazó) / Esperando |
Como la NFeSVA es gerada
| Passo |
Pasa |
| 1 |
Cliente tem SVA activo en el contrato (ex: Paramount+ por R$ 39,90/mes) |
| 2 |
Cron mensual de faturació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 = "Serviços de Valor Agregado" + NFeSVA) |
| 5 |
Gera XML, envía a SEFAZ vía FaturaSend u otro provedor de NFe |
| 6 |
Recibe protocolo, marca Estado=Activa, gera DANFE (PDF da fatura) |
| 7 |
NFeSVA queda disponible para download do 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 uma empresa filial vs otra.
Fluxos típicos passo-a-passo
Fluxo 1: Agregar SVA nuevo a contrato existente
| Passo |
Onde |
O que fazer |
| 1 |
Cliente → Contrato
|
Abrir contrato do cliente que quiere agregar SVA |
| 2 |
Aba Serviços |
Agregar servicio, elegir tipo "SVA" |
| 3 |
Wizard SVA |
Elegir integrador, plan, datos personales do cliente (si exigido por el integrador, ej: e-mail para Watch Brasil) |
| 4 |
Sistema llama API |
POST al endpoint do integrador → recibe usuário/senha provisionados |
| 5 |
Sistema graba en svaUsuário |
Vincula Cliente ↔ Integrador ↔ Plan ↔ Login provisionado |
| 6 |
Sistema envía e-mail al cliente |
"Ya tienes Paramount+. Accede con user X, senha Y" |
| 7 |
Próxima mensalidade |
Inclui valor do SVA, gerla NFeSVA junto |
Fluxo 2: Cancelar SVA (cliente ya no quiere)
| Passo |
Onde |
O que fazer |
| 1 |
Cliente → Contrato → Serviços |
Eliminar o deshabilitar servicio SVA |
| 2 |
Sistema llama API |
DELETE o status=inactive en el integrador |
| 3 |
Sistema graba en svaUsuário |
Situação = Cancelado |
| 4 |
Próxima mensalidade |
No incluye SVA (o proporcional si canceló a mitad do mes) |
Fluxo 3: Cliente moroso — SVA bloqueado en cascada
| Passo |
Onde |
| 1 |
Cron de morosidad (D+30) marca contrato Bloqueado automático
|
| 2 |
Sistema lista SVAs do contrato y llama API do integrador deshabilitando |
| 3 |
Cliente pierde acesso a Paramount+, Skeelo, etc. |
| 4 |
Cliente paga → cron de retorno reactiva contrato → reactiva SVAs (llama API nuevamente) |
Fluxo 4: Debug "cliente dice que SVA no funciona"
| Passo |
Onde |
O que verificar |
| 1 |
SVA → Usuário |
Cliente tem SVA registrado? Situação = Habilitado? |
| 2 |
SVA → Request Log |
Última llamada API con éxito? Algún error 401/500 reciente? |
| 3 |
Caso error 401 |
Credencial do integrador expiró — actualizar Client Secret |
| 4 |
Caso error 500 |
Problema en el lado do integrador — abrir ticket con él |
| 5 |
Caso todo 200 |
Cliente está usando user/senha erradas — reenviar e-mail con instrucciones |
Pegadinhas frequentes
1. Integrador exige CPF/email para provisionar. Algunos SVAs (especialmente streaming) exigen CPF + e-mail válidos do cliente final para criar la conta. 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 os integradores tienen endpoint de "deshabilitar temporalmente" — algunos solo "cancelar". Si cancelas, cuando el cliente pague precisas recriar la conta — pode dar usuário/senha 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. Precisas cerrar mensualmente y pagar.
5. Request Log crece mucho. Cada llamada API gera 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 conta como Ingreso de Comunicação. 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.
Galeria de telas
Integrador
Plano
Usuario
Requestlog
Nfesva
Documentos relacionados
Aprofunde-se nos 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"
-
Painéis / Dashboards
— visión ejecutiva, indicadores diarios y alertas operacionales
-
Telefonia (VoIP + MVNO)
— serviços de voz fija y móvil que poden ser vendidos junto con internet
-
Administração
— configuraciones, usuários, permisos (ACL), tarefas (crons) y logs de auditoria
-
Comunicação
— Email, SMS, WhatsApp y campañas masivas para clientes
-
Chat
— atención omnicanal en vivo (WhatsApp, bot, respuestas rápidas)
-
Portal / Área do Cliente
— autoatendimento do 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)
-
Fatura — agrupación mensual de NFCom + NFeSVA
-
FaturaSend — para emissão dla NFeSVA em Paraguai (DE)
-
Fiscal Brasil — configuração geral de sesries e empresas fiscais
-
Cobrança — geração de cobrança do valor dla NFeSVA
Perguntas frequentes
Puedo tener el mismo cliente con 5 SVAs diferentes?
Sí. Cada SVA = 1 svaUsuário distinto. Cliente pode tener Skeelo + Paramount+ + Antivirus + VoIP + Cloud, con 5 logins separados, gerando 5 NFeSVAs todos os meses (o 1 solo con 5 ítems, dependiendo da configuração).
Cliente cambió de plan (de Paramount Basic a Paramount+HBO) — necesito recriar?
Depende do integrador. Watch Brasil acepta "upgrade in-place" vía API; Skeelo geralmente exige cancelar y recriar (gerando login nuevo). Mira el Request Log do integrador específico.
Como sé cuánto facturo mensualmente en SVA?
Filtra NFe SVA por mes de Competencia, suma de Valor Total. Exporta listado.
Provedor pode vender SVA sin internet?
Técnicamente sí, pero la mayoría de os integradores tem 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 os SVAs vinculados cuando el contrato va a Cancelado. NFeSVAs futuras dejan de ser geradas. NFeSVAs ya emitidas quedan (son faturas históricas).
Puedo emitir NFeSVA retroactiva?
Sí, pero con límite (geralmente 90 días). Usa con cuidado — confunde contabilidad do cliente.
Como integro un SVA nuevo (que aún no está en Quaza)?
Precisas 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.
Como medir o sucesso operacional?
Defina 3 KPIs e acompanhe semanalmente. Tendência importa mais que valor absoluto.
Há treinamento oficial Quaza?
Sim — equipe de suporte oferece sessões de onboarding. Documentação rica também ajuda.
Como reportar bug ou pedir nova feature?
Pelo canal de suporte. Inclua contexto: o que esperava, o que aconteceu, frequência do problema.
Como começar a usar este módulo?
Configure os pré-requisitos, faça um teste com poucos registros, valide com a equipe, e só então ative em produção.
Preciso de permissão especial?
Sim. Cada papel (operador/supervisor/admin) tem permissões distintas. Confirme com administrador.