**[[start|Inicio]] · [[help:mapa_antpro|Mapa]] · [[help:app_productos|Productos y servicios]] · [[help:venta_digital|Venta digital (productos digitales con cobro por QR)]]**

//Este complemento vende y entrega productos digitales sin intervención humana: un formulario de pago que se pega en el blog o en una página, el cliente paga por Yape escaneando el QR, NITRO detecta el pago, entrega el producto (un Excel personalizado, un PDF, la matrícula en un curso, un enlace o una licencia de una herramienta web) y contabiliza la venta. Esta guía recorre la administración completa. En el demo público https://nitro.com.de/demo (usuario **admin**, clave **4804**) encontrará el catálogo de ejemplo y las entregas registradas.//

====== Venta digital (productos digitales con cobro por QR) ======

===== En dos minutos =====

<code>
  Cliente en el blog  -->  Formulario de pago (celular, nombre, NIT)  -->  "PAGAR CON QR"
                                                                              |
                        Escanea el QR y paga por Yape  <----------------------+
                                                                              |
  NITRO detecta el pago (Cobros Yape/QR) --> entrega el producto --> factura + cobro
                                                                              |
                        Panel de Comercio Digital: Productos | Entregas | Ventas Yape | Config
</code>

Usted administra tres cosas: el **catálogo** de productos digitales (qué se vende, a qué precio, cómo se entrega), las **entregas** (quién recibió qué, cuántas descargas usó, revocar o reactivar) y las **ventas** contabilizadas. El cobro lo hace el complemento [[help:cobros_yape_qr|Cobros Yape / QR]]; la factura y el cobro se generan solos.

**Dónde está:** **Productos y servicios → Comercio digital → Tienda → Panel de Comercio Digital**, con las pestañas **Productos**, **Entregas**, **Ventas Yape** y **Config**. Desde la pestaña Productos se abre la pantalla completa de **Productos Digitales** (alta, edición, clonado, cortesías) y desde Entregas la de **Entregas Digitales** (filtros, revocar, reactivar).

{{:help:w6_dc_productos.png?650|Panel de Comercio Digital, pestaña Productos: nombre, slug, precio, ítem contable, código para pegar en el blog y acciones Editar / Ver}}

===== Conceptos que conviene tener claros =====

  * **Slug.** Identificador corto y único del producto (por ejemplo, //Control_CF_IVA//). Forma parte de la dirección del formulario de pago y del código para el blog. No lleve espacios ni tildes.
  * **Tipo de entrega.** Define qué recibe el cliente al pagar:
    * **excel**: un archivo Excel **personalizado** (con el nombre y NIT del comprador estampados como licencia) generado a partir de un archivo original que usted sube.
    * **pdf**: un archivo PDF descargable por enlace con límite de descargas.
    * **curso**: matrícula automática en un curso de la plataforma de cursos en línea; el cliente recibe usuario y contraseña.
    * **link**: un enlace a un recurso.
    * **token_web**: una licencia para una herramienta web (el celular queda como usuario).
    * **fisico**: registra un pedido para envío manual.
    * **manual**: registra la compra y un asesor completa la entrega por WhatsApp o correo.
  * **Ítem contable.** El artículo del catálogo de NITRO con el que se factura cada venta de ese producto (columna **Ítem (contab.)**). Si está vacío, la factura usa el ítem genérico configurado en Cobros Yape/QR y la pantalla lo muestra como //sin ítem//.
  * **Código para el blog (embed).** El fragmento que se pega en la entrada del blog o en la página de ventas para mostrar el formulario de pago incrustado.
  * **Token de descarga.** Clave única de cada entrega; el enlace de descarga la incluye y respeta el **máximo de descargas**.
  * **Cortesía.** Entrega gratuita otorgada desde la administración (sin pago), por ejemplo a un alumno o a un colega.
  * **Recuperación.** El comprador puede volver a obtener su producto dentro de los 30 días con el botón **Ya pague y no veo mi acceso**, usando el mismo celular.

===== Antes de empezar =====

  - Configure y pruebe [[help:cobros_yape_qr|Cobros Yape / QR]]: sin él no hay detección de pagos.
  - Cree en el catálogo de NITRO un **artículo de servicio** por cada producto digital (o uno genérico), con su cuenta de ingresos: [[help:productos_completo#alta_de_item_tipo_y_cuentas|Productos → alta de ítem]].
  - Tenga a mano la **imagen del QR** de cobro de Yape de la empresa (la que el cliente escanea) y los archivos a entregar.
  - Permisos: el rol necesita el área **Comercio Digital - productos y ventas**; de lo contrario verá //"No tiene permiso para este modulo. Asignelo en Configuracion -> Roles de Seguridad -> Comercio Digital."//

===== Procedimiento para crear un producto digital =====

  - En el panel, pestaña **Productos**, presione **+ Nuevo producto** (o abra **Productos Digitales** y use **Nuevo Producto**).
  - Complete **Nombre**, **Slug**, **Tipo**, **Precio** y **Moneda** (BOB).
  - Escriba la **Descripción** que verá el cliente y el **Stock ID** del ítem contable con el que se facturará.
  - En **QR Imagen (path)** indique la imagen del QR de cobro.
  - En **Entrega**, el formulario cambia según el tipo:
    * excel: **Generador** (el script de personalización), **Archivo original**, **Estampar licencia nominativa**, **Entregar tal cual (sin personalizar, preserva macros)**.
    * pdf: **Archivo**, **Recurso extra (URL, opcional)** y su texto, **Nota de entrega (opcional)**.
    * curso: **URL del LMS**, **ID del curso (numero)**, **Clave de matriculacion**.
    * link / token_web: la **URL** de acceso.
    * Para cualquier tipo: **Video de uso (URL, opcional)**, que se muestra al comprador tras la entrega.
  - Defina **Max Descargas** (3 por defecto) y **Activo**.
  - Suba el **Archivo (PDF/Upload)** o el **Archivo Original (Excel)** según corresponda (//"Archivo subido: guia.pdf"//).
  - Presione **Crear Producto** (//"Producto creado."//). Para variantes, use **Clonar** en la lista: //"Ajusta el nombre y el slug (deben ser unicos) y sube el archivo que corresponda. La configuracion de entrega ya viene precargada del producto original."//

{{:help:w6_dc_producto_editar.png?650|Edición de un producto tipo Excel en el demo: datos comerciales, ítem contable, QR, configuración de entrega y archivos}}

==== Publicar el formulario de pago ====

  - En la pestaña **Productos**, copie el contenido de la columna **Embed para el blog** de la fila del producto (un clic lo selecciona completo).
  - Péguelo en la entrada del blog o en la página donde se vende. El formulario aparece incrustado con el nombre del producto, el precio y los campos **Celular** (obligatorio), **Nombre** y **NIT** (opcional, para estampar el Excel).
  - El enlace **Ver** abre el formulario en página completa, útil para compartir por WhatsApp.

{{:help:w6_dc_checkout.png?650|El formulario de pago tal como lo ve el cliente: precio, celular, nombre, NIT, el botón PAGAR CON QR y el enlace de recuperación "Ya pague y no veo mi acceso"}}

==== Qué ve el cliente ====

  - Escribe su **celular** (el que usa para Yape), opcionalmente nombre y NIT, y presiona **PAGAR CON QR**.
  - Aparece el QR con la leyenda //"Escanea el QR para pagar"// y //"Paga con Yape. Detectamos tu pago automaticamente."//; abajo, //"Verificando pago..."//.
  - Paga desde su Yape por el importe exacto. En segundos la página detecta el pago y muestra la entrega: el enlace de descarga, el usuario y contraseña del curso, o el enlace de acceso.
  - Si cerró la página antes de ver la entrega, vuelve y usa **Ya pague y no veo mi acceso** con el mismo celular: NITRO le vuelve a mostrar su entrega (dentro de los 30 días).

===== Procedimiento para administrar entregas =====

{{:help:w6_dc_entregas.png?650|Pestaña Entregas: fecha, cliente, producto, tipo, método (pago o cortesía), descargas usadas, estado de la entrega y el texto listo para enviar al cliente}}

  * La pestaña **Entregas** muestra cada entrega con **Fecha**, **Cliente**, **Producto**, **Tipo**, **Metodo** (pago, cortesia, manual), **Descargas** (usadas / máximo), **Entrega** (**completa** o **pendiente**), **Estado** (activa / inactiva) y **Texto para el cliente**.
  * **Texto para el cliente** es un mensaje ya redactado con los datos reales de la entrega (enlace de descarga con su token, o usuario y contraseña del curso), listo para copiar y enviar por WhatsApp o correo cuando el cliente lo pide.
  * Una entrega **pendiente** es una matrícula de curso que todavía no se completó en la plataforma de cursos; NITRO la reintenta sola, y volver a activar desde el formulario también la completa sin duplicar el acceso.
  * En la pantalla **Entregas Digitales** puede filtrar por **Producto**, **Celular**, **Desde** y **Hasta**, y en cada fila **Revocar** (//"Entrega revocada."//) o **Reactivar** (//"Entrega reactivada y descargas reiniciadas."//), por ejemplo cuando el cliente agotó sus descargas por un problema de su conexión.

{{:help:w6_dc_deliveries.png?650|Entregas Digitales: filtros y la lista con token, descargas usadas y las acciones Revocar / Reactivar}}

==== Otorgar una cortesía ====

  - En **Productos Digitales**, presione **Cortesia** en la fila del producto.
  - Complete **Celular**, **Nombre** y **NIT** del beneficiario y presione **Otorgar Cortesia**.
  - NITRO responde //"Cortesia otorgada exitosamente. Token: ..."// o //"Este cliente ya tiene el producto activado."// La entrega queda con método **cortesia** y **no genera venta ni asiento**.

===== Qué asiento genera una venta =====

La venta digital no contabiliza por sí misma: lo hace [[help:cobros_yape_qr|Cobros Yape / QR]] al detectar el pago, con el ítem contable del producto. Para una venta de //Control CF IVA// a Bs 82:

^ Documento ^ Cuenta ^ Debe ^ Haber ^
| Factura directa FV- | Cuentas por cobrar | 82,00 | |
| | Ingresos por venta de productos digitales | | 71,34 |
| | Débito fiscal IVA 13 % | | 10,66 |
| | IT 3 % (gasto) / IT por pagar | 2,46 | 2,46 |
| Cobro CI | Banco Yape 631 BOB | 82,00 | |
| | Cuentas por cobrar | | 82,00 |

La pestaña **Ventas Yape** lista esas facturas: **Fecha**, **Cliente**, **Monto**, **Item**, **Factura #** y el enlace **Ver factura**. Si un pago se contabilizó sin poder identificar el producto, la fila muestra la marca //(revisar)//.

{{:help:w6_dc_ventas.png?650|Pestaña Ventas Yape: las facturas generadas por los pagos recibidos, con enlace a cada una}}

===== Pestaña Config =====

Muestra **Productos totales** (y cuántos activos), la dirección base del formulario de pago y el **Motor de cobro** con el enlace **configurar conector** hacia Cobros Yape/QR. No tiene parámetros propios: //"La gestion fina de cada producto (archivo, QR, tipo de entrega) esta en Productos -> Editar."//

{{:help:w6_dc_config.png?650|Pestaña Config: resumen del catálogo y enlace al motor de cobro}}

===== Situaciones y problemas comunes =====

  * **El cliente pagó y la página sigue en "Verificando pago".** El pago no llegó a NITRO (vea la lista de verificación de [[help:cobros_yape_qr|Cobros Yape / QR]]) o el cliente pagó un **importe distinto** al precio: el emparejamiento exige monto exacto. Solución rápida: registre un **Pago Manual** por el importe correcto y pida al cliente que use **Ya pague y no veo mi acceso**.
  * **"Pago requerido: falta un pago valido"** al activar. El pago no está **reservado** para ese celular (pagó desde otro número, o pasó la ventana de 30 minutos). Registre el pago manual o concilie el existente.
  * **"Numero de celular invalido"** o **"Ingresa tu numero de celular (el que usaste al pagar)"**. El cliente escribió el celular con letras o incompleto.
  * **"Producto no encontrado"** / **"Producto inactivo"**. El slug del código pegado en el blog no coincide con un producto activo. Revise la columna Slug y el estado **Activo**.
  * **"Ya existe una entrega para este producto".** El mismo celular ya compró ese producto: no se cobra dos veces; use **Ya pague y no veo mi acceso** para recuperarlo.
  * **"No se configuro archivo original para el producto Excel"** / **"No se configuro archivo PDF para el producto"**. Falta subir el archivo en la edición del producto.
  * **"Nombre, slug y tipo son obligatorios."** Al guardar un producto.
  * **El QR no se ve en el formulario ("QR no configurado").** El campo **QR Imagen (path)** está vacío o apunta a una imagen inexistente.
  * **El cliente agotó las descargas.** **Reactivar** en Entregas Digitales reinicia el contador.
  * **La matrícula del curso quedó "pendiente".** La plataforma de cursos no respondió en ese momento; NITRO reintenta. Si persiste, revise la **Clave de matriculacion** y el **ID del curso** del producto.

===== Preguntas frecuentes =====

**¿Puedo vender un producto físico?**
Sí, con tipo **fisico**: el cobro y la factura se generan igual y la entrega queda registrada como //"Pedido registrado, pendiente de envio"// para que usted despache.

**¿Qué es "Entregar tal cual (sin personalizar, preserva macros)"?**
Para Excel con macros: en vez de generar una copia personalizada (que pierde las macros), entrega el archivo original intacto.

**¿Cómo cambio el precio?**
En **Editar** del producto. Las compras en curso se validan contra el precio vigente, así que avise antes a los clientes que tengan un QR abierto.

**¿La cortesía emite factura?**
No. Es una entrega sin pago y no toca la contabilidad.

**¿Dónde veo cuánto vendí este mes?**
En la pestaña **Ventas Yape** o, con más detalle, en los [[help:ventas:reportes_de_clientes_y_ventas|reportes de ventas]] filtrando por el ítem del producto.

===== Ver también =====

  * [[help:cobros_yape_qr|Cobros Yape / QR (central de cobros)]]
  * [[help:productos_completo|Productos y servicios]] (alta del ítem contable)
  * [[help:ventas_completo|Ventas paso a paso]] · [[help:librodeventasiva-excel|Libro de Ventas IVA]]
  * [[help:yego_whatsapp|Walter: asistente de WhatsApp]]