Central de Ajuda Quaza Provedores

SVA — Servicio de Valor Agregado (ES-PY)

SVA — Servicio de Valor Agregado

SVA — Servicio de Valor Agregado — los servicios de socios que el proveedor revende junto con la internet

Cómo registrar y operar el módulo SVA (Servicio de Valor Agregado) en Quaza — los servicios que revendes junto con la internet (TV por streaming, ebooks, telefonía, antivirus). Aquí conectas la plataforma del socio a Quaza, importas los planes, provisionas al suscriptor y acompañas las llamadas de API. Dirigido a quien trabaja con productos y contratos en el proveedor.

SVA no es la factura. Esta wiki trata del registro y provisionamiento del servicio. La factura del SVA (la NFeSVA, modelo fiscal de São Paulo, Brasil) es tema de otra wiki: ver NFe SVA .

En esta wiki:

Qué es SVA

SVA (Servicio de Valor Agregado) es todo lo que el proveedor vende además del acceso a internet: TV por streaming, plataformas de ebook y audiolibro, telefonía, antivirus, monitoreo. En Quaza, un SVA es un servicio de un socio externo (la plataforma que entrega el contenido) que revendes a tu cliente final y cobras dentro del contrato de él.

Para que esto funcione, Quaza conversa con la plataforma del socio por una API: cuando registras un suscriptor, Quaza crea el acceso allá en el socio automáticamente; cuando el cliente queda moroso y el contrato es bloqueado, Quaza bloquea también el acceso al SVA — en cascada. El módulo cubre hoy más de 20 socios (Watch Brasil, PlayHub, Skeelo, Cariap, Now+, Olé TV, entre otros).

El SVA se ocupa de	El SVA NO se ocupa de
Conectar la plataforma del socio a Quaza (Integrador)	Emitir la factura del servicio — eso es NFe SVA
Importar y registrar los planes revendidos	Vender internet pura — eso va en NFCom
Crear el acceso del suscriptor en el socio (provisionar)	Lanzar el cobro/boleto — eso es Cobranza
Bloquear/desbloquear el acceso según el contrato	El contrato en sí — eso es Contrato

Cuándo usar (y cuándo NO)

Usa el módulo SVA cuando…	NO es aquí cuando…
Cerraste sociedad con una plataforma (ej.: Watch Brasil) y quieres revenderla	Solo necesitas emitir la factura de un SVA → NFe SVA
Quieres dar acceso a un servicio de streaming/ebook a un cliente específico	Quieres cobrar al cliente → Cobranza y Factura
Necesitas investigar por qué el acceso de un cliente al socio no funciona	Quieres agregar el servicio al contrato → pantalla de Contrato (pestaña Servicios)

Paso a paso — del socio al suscriptor

1	Registra el Integrador. En SVA → Integrador, haz clic en Añadir integrador SVA, elige el Gateway (el socio: Watch Brasil, PlayHub…) y completa las credenciales de API que el socio proporcionó. Los campos que aparecen cambian según el gateway.
2	Prueba la conexión. Abre el integrador guardado y haz clic en Probar conexión API. Si aparece "Conexión establecida con éxito", las credenciales están correctas.
3	Registra/Importa los Planes. En SVA → Plan, usa Importar planes para traer los planes directo del socio (cuando el gateway lo soporta) o regístralos manualmente. Cada plan guarda el código del integrador que será enviado al socio.
4	Provisiona al suscriptor. En SVA → Usuario, haz clic en Añadir usuario, elige el Cliente/Contrato, el Integrador y el Plan, y completa los datos exigidos por el socio (usuario, contraseña, documento, teléfono — varía por gateway). Al guardar, Quaza crea el acceso en la plataforma del socio.
5	Vincula al contrato (cobranza). Para que el servicio entre en la factura y siga el bloqueo por morosidad, debe estar como servicio del tipo SVA en el Contrato del cliente.
6	Acompaña. En SVA → Log Request ves cada llamada que Quaza hizo al socio (creación, bloqueo, desbloqueo) — útil para descubrir por qué algo falló.

Flujo — provisionamiento y bloqueo en cascada

Del registro del socio al provisionamiento del suscriptor; debajo de la línea punteada, el bloqueo/desbloqueo en cascada disparado por la situación del contrato.

Glosario

Término	Qué significa
SVA	Servicio de Valor Agregado: servicio de un socio (streaming, ebook, telefonía, antivirus) que el proveedor revende junto con la internet.
Integrador	El registro que conecta una plataforma socia a Quaza, con las credenciales de API. Un integrador = una cuenta tuya en un socio.
Gateway	Qué socio representa el integrador (Watch Brasil, PlayHub, Skeelo…). Define qué campos y qué API usará Quaza.
Plan	El paquete del socio que revendes (ej.: "Paramount+HBO", "Canales Premium"). Guarda el código que el socio reconoce.
Usuario SVA	El suscriptor provisionado: la conexión Cliente → Contrato → Integrador → Plan con el acceso creado en el socio.
Código de integración	El identificador que el socio devuelve/reconoce para ese plan o suscriptor; es lo que Quaza envía en las llamadas de API.
Provisionar	Crear el acceso del suscriptor en la plataforma del socio (sucede al guardar el Usuario SVA).
Homologación / Producción	Ambiente de la API del socio: homologación es prueba; producción es el ambiente real que crea accesos de verdad.
Log Request	Registro de cada llamada que Quaza hizo a la API del socio (URL, método, código de respuesta, fecha) — el rastro de auditoría.
Bloqueo en cascada	Cuando el contrato del cliente es bloqueado por morosidad, Quaza pide al socio suspender también el acceso al SVA.

Configuración / requisitos previos

Credenciales del socioSVA → Integrador

Antes de todo, necesitas una cuenta en la plataforma del socio y las credenciales de API que él provee (usuario/contraseña, token, client id/secret — varía). Sin eso la prueba de conexión falla.

Planes registradosSVA → Plan

Solo logras provisionar un suscriptor si su plan ya existe. Usa Importar planes para traer del socio cuando sea posible.

Cliente con contratoCliente → Contrato

El suscriptor SVA siempre está ligado a un contrato de un cliente. Es por ese vínculo que la cobranza y el bloqueo por morosidad funcionan.

Pantalla — Integrador

SVA → Integrador

Es donde conectas cada plataforma socia a Quaza. El listado muestra los integradores registrados; haz clic en el lápiz para abrir el detalle.

Listado de integradores (Listar integradores SVAs) — columnas Código, Descripción, Gateway, Modificación, Modificador y Empresa; el botón "Añadir integrador SVA" está arriba a la derecha.

En el detalle das una Descripción (un nombre tuyo para reconocer el integrador), eliges el Gateway y defines la Situación (habilitado/deshabilitado) y el ambiente (Homologación o Producción). Según el gateway elegido, Quaza muestra solo los campos de credencial que ese socio exige: usuario y contraseña de API, token, instancia, client id/secret. Usa el botón Probar conexión API para confirmar antes de operar.

Pantalla — Plan

SVA → Plan

Los paquetes que revendes. Cada plan pertenece a un integrador y guarda el código del integrador — el identificador que el socio reconoce.

Listado de planes (Listar planes) — columnas Código, Descripción, Integrador, Código del Integrador, Situación, Modificación, Modificador y Empresa; a la derecha están "Añadir plan" e "Importar planes".

Usa Importar planes para elegir un integrador y traer el catálogo directo del socio (cuando el gateway lo soporta) — así no digitas código por código. Los planes importados ya vienen con el código de integración completado.

Pantalla — Usuario

SVA → Usuario

El corazón de la operación: cada línea es un suscriptor provisionado. El listado muestra el camino completo Cliente → Contrato → Integrador → Usuario → Plan, con la situación.

Listado de usuarios (Listar usuarios) — columnas Código, Cliente, Contrato, Integrador, Usuario, Plan, Situación, Modificación, Modificador y Empresa; Cliente y Contrato son enlaces a la ficha del cliente.

Al añadir, eliges Cliente/Contrato, Integrador y Plan. Los campos siguientes (usuario, contraseña, documento, teléfono, MAC, modelo de equipo) aparecen según lo que el socio exige. Al guardar un usuario nuevo, Quaza llama a la API del socio y crea el acceso al instante — por eso el registro puede dar error de validación venido del socio (ej.: usuario ya en uso). En el detalle de un usuario ya creado, algunos gateways ofrecen acciones extra (ej.: consultar paquetes/suscripciones disponibles).

Pantalla — Log Request

SVA → Log Request

El rastro de auditoría de las llamadas de API. Cada línea es una solicitud que Quaza hizo al socio. Es solo lectura — no creas ni borras nada aquí, solo consultas.

Listado del Log Request (Listar registros de Solicitud) — columnas Código, URL, Método, Código de la Solicitud, Creación y Empresa; nota las llamadas de subscribe, BloquearLogin y DesbloquearLogin al socio.

Es el primer lugar para mirar cuando "el SVA del cliente no funciona": abre el log, encuentra la llamada del cliente, mira el código de la solicitud (200 = ok; 4xx/5xx = error) y el contenido de la respuesta. Las URLs suelen mostrar la acción (ej.: subscribe, BloquearLogin, DesbloquearLogin).

Tareas automáticas

Además de las acciones que disparas en la pantalla, el módulo SVA corre algunas tareas automáticas en segundo plano. Quien enciende, apaga y agenda esas tareas es el administrador del servidor (vía crontab) — el operador no controla eso por la pantalla.

Tarea	Qué hace	Cuándo
Renovación de token (Watch Brasil)	Renueva periódicamente el token de acceso a la API del socio, para que las llamadas no expiren.	Automática (tarea periódica)
Creación de usuarios (Digilivro)	Crea en lote los accesos pendientes en la plataforma del socio.	Automática (tarea periódica)
Bloqueo / desbloqueo por contrato	Cuando el contrato es bloqueado o desbloqueado (manual o vía tarea de cobranza), suspende/reactiva el acceso al SVA en el socio.	Manual o automático (sigue el contrato)

Las tareas varían según los socios que usas. Si una renovación de token o creación en lote deja de correr, habla con el soporte — la programación de esas tareas se hace en el servidor, no en la pantalla.

Barra de acciones

#	Botón	Dónde aparece	Qué hace
1	Probar conexión API	Detalle del Integrador	Hace una llamada de prueba con las credenciales y confirma si la conexión funciona.
2	Importar planes	Listado de Plan	Elige un integrador y trae el catálogo de planes directo del socio.
3	Consultar paquetes disponibles	Detalle del Usuario (gateways que lo soportan)	Lista, venido del socio, los paquetes que pueden asignarse a ese suscriptor.
4	Consultar suscripciones	Detalle del Usuario (gateways que lo soportan)	Muestra, venido del socio, las suscripciones ya activas del suscriptor.

Cuando sale mal

Síntoma	Causa probable	Qué hacer
"Conexión no establecida" al probar	Credenciales erradas o ambiente cambiado (Homologación x Producción)	Revisa usuario/contraseña/token y el ambiente en el Integrador; verifica en el panel del socio.
"Integrador: X, no registrado como gateway"	El integrador fue creado sin un gateway válido seleccionado	Edita el Integrador y selecciona el Gateway correcto.
"Usuario ya en uso" / "Documento ya en uso" / "Teléfono ya en uso"	Ya existe un suscriptor activo con ese dato	Verifica en SVA → Usuario si el suscriptor ya no está provisionado.
Importar planes falla	Ese socio no tiene importación automática implementada	Registra los planes manualmente con el código de integración.
El cliente dice que el SVA se detuvo	Contrato bloqueado por morosidad (bloqueo en cascada) o error de API	Revisa la situación del contrato; luego mira el Log Request (código de respuesta de la última llamada).

Trampas frecuentes

SVA no es la factura. Provisionar el servicio aquí no emite documento fiscal. La factura (NFeSVA) se genera en la pantalla propia — ver NFe SVA .

Guardar un usuario nuevo ya crea el acceso en el socio. No es un borrador: al guardar, Quaza llama a la API y provisiona de verdad. Revisa los datos antes.

El ambiente importa. Un integrador en Homologación no crea accesos reales. Antes de operar con clientes, asegura que esté en Producción.

El bloqueo del SVA sigue al contrato. Si el servicio no está vinculado al contrato como tipo SVA, el bloqueo por morosidad no alcanza el acceso — el cliente sigue usando aun debiendo.

Cada gateway pide campos distintos. Unos exigen usuario+contraseña, otros documento, otros teléfono o MAC. Los campos aparecen solos según el gateway; no inventes datos.

Borrar un usuario intenta remover el acceso en el socio. La eliminación no es solo local: Quaza pide al socio remover al suscriptor y desvincula el servicio del contrato.

Plan sin código de integración no funciona. El código es lo que el socio reconoce; sin él, el provisionamiento falla. Preferir importar a digitar.

El Log Request es solo lectura. Registra lo que pasó; no permite "rehacer" una llamada desde ahí. Para reprovisionar, vuelve al Usuario.

De dónde vienen los datos

Información enviada al socio	Dónde se registra en Quaza
Credenciales de API (usuario, token, etc.)	SVA → Integrador
Código del plan/paquete	SVA → Plan (campo Código de integración)
Datos del suscriptor (usuario, contraseña, documento, teléfono)	SVA → Usuario
Cliente y contrato vinculados	Cliente → Contrato (servicio del tipo SVA)

Preguntas frecuentes

¿Cuál es la diferencia entre SVA y NFe SVA?

SVA es el servicio que revendes y provisionas en el socio (esta wiki). NFe SVA es la factura de ese servicio, con modelo fiscal propio — ver NFe SVA .

¿Registrar al suscriptor ya crea el acceso en el socio?

Sí. Al guardar un usuario nuevo en SVA → Usuario, Quaza llama a la API y provisiona el acceso en la plataforma del socio al instante.

¿Necesito digitar los planes uno por uno?

No, cuando el socio lo soporta. Usa "Importar planes" en la pantalla de Plan para traer el catálogo automáticamente. Solo digita manualmente si ese gateway no tiene importación.

¿Por qué cada integrador pide campos distintos?

Cada socio tiene una API diferente. Quaza muestra solo los campos exigidos por el gateway elegido (usuario/contraseña, token, client id/secret, instancia).

¿El SVA del cliente se bloquea solo cuando queda debiendo?

Sí, si el servicio está vinculado al contrato como tipo SVA. Al bloquear el contrato (manual o por la tarea de cobranza), Quaza pide al socio suspender el acceso; al desbloquear, lo reactiva.

¿Cómo descubro por qué falló el acceso de un cliente?

Ve a SVA → Log Request, encuentra la llamada del cliente y mira el código de la solicitud (200 = ok; 4xx/5xx = error) y la respuesta del socio.

¿Qué significan Homologación y Producción en el integrador?

Homologación es el ambiente de prueba del socio (no crea acceso real); Producción es el ambiente real. Opera con clientes solo en Producción.

¿Puedo reaprovechar un usuario/documento/teléfono ya registrado?

No mientras haya un suscriptor activo con ese dato — el sistema bloquea la duplicidad. Verifica el listado de Usuario antes.

¿Borrar al suscriptor remueve el acceso en el socio?

Sí. La eliminación intenta remover al suscriptor en la plataforma del socio y desvincula el servicio del contrato.

¿Necesito permiso especial para usar el módulo?

Las pantallas de SVA están en el grupo "SVA" del menú. Si no las ves, pide al administrador del proveedor liberar el acceso a tu perfil.

¿Quién agenda las tareas automáticas (renovación de token, creación en lote)?

El administrador del servidor, vía crontab. Por la pantalla no enciendes ni apagas esas tareas; en caso de falla, contacta al soporte.

Documentos relacionados

NFe SVA — la factura del servicio de valor agregado.
Contrato — donde el SVA se vincula para entrar en la cobranza y en el bloqueo.
Cobranza — lanzamiento y gestión de la morosidad que dispara el bloqueo en cascada.
Factura — cómo el servicio aparece en la cobranza del cliente.