Cómo funciona la asignación de claves de licencia en POS
Cuando el cajero introduce el email del cliente en el TPV, el endpoint POS crea el registro Purchase y llama a assignLicenseKeysForPurchase al instante. Una clave se saca del pool etiquetado para ese producto, se adjunta a la compra y se incluye en el email de entrega que Alva envía segundos después. Sin cola antifraude, sin periodo de retención — el pago es la única puerta.
Email de entrega de Alva renderizado en una pantalla de móvil, mostrando una clave de licencia en un bloque de código encima del enlace de descarga. Usa una clave ficticia tipo XXXX-YYYY-ZZZZ. Sin datos reales de clientes visibles.
Configura un producto POS con clave de licencia
1. Sube tus claves de licencia
En el admin de Alva, abre Claves de licencia. Sube un CSV de códigos pregenerados (uno por fila) o usa el autogenerador para crear claves con un prefijo y una longitud elegidos. Consulta Añade claves de licencia mediante subida de CSV para el tutorial completo.
2. Etiqueta el lote
Aplica una etiqueta a las claves recién subidas — por ejemplo pos-software-2026. La etiqueta es la unión entre un pool de claves y el producto de Shopify que reclama de él.
3. Asigna la etiqueta a un producto de Shopify
Abre el producto de Shopify en el admin de Alva, elige Asignar etiqueta de clave de licencia y selecciona la etiqueta del paso 2. Las compras online y POS de ese producto reclaman ahora del mismo pool — sin catálogo POS aparte.
4. Confirma que la extensión POS de Alva está instalada
La extensión POS de Alva se instala automáticamente cuando Alva está en la tienda. En el dispositivo POS, abre Ajustes → Smart grid y confirma que Alva Digital Downloads es accesible en el menú de acciones posventa. Para detalles de la primera configuración, consulta Vende productos digitales en Shopify POS.
Página de asignación de productos en el admin de Alva. Resalta el desplegable "Etiqueta de clave de licencia" con una etiqueta tipo "pos-software-2026" seleccionada. Muestra el resto de la asignación del producto para contexto. Sin datos reales de clientes visibles.
Qué ven los clientes en tienda
El recibo de Shopify muestra los line items del pedido como siempre — sin clave impresa en papel. El cajero pulsa la celda de Alva, lee en voz alta el email del cliente para detectar erratas y confirma. En segundos el cliente recibe el email de entrega de Alva con la clave de licencia en el cuerpo. El recibo y la clave son dos artefactos distintos: uno impreso en el TPV, otro entregado a la bandeja de entrada.
Salvedades honestas
Los pedidos POS no pasan por la cola antifraude, y la asignación automática de claves de licencia no se puede pausar en ventas en tienda. Si un producto necesita revisión tipo antifraude antes de soltar las claves (códigos enterprise de alto valor, por ejemplo), deja su etiqueta de clave de licencia sin asignar — el cliente sigue recibiendo el email de descarga, y tú asignas la clave manualmente desde el admin de Alva una vez revisado el pedido. Para el razonamiento, consulta Por qué los pedidos POS se saltan la cola antifraude.
Preguntas frecuentes
¿El cliente ve la clave de licencia en el recibo POS?
No. El recibo de Shopify muestra solo los line items del pedido. La clave de licencia llega en el email de entrega de Alva después de que el cajero capture el email del cliente en el TPV.
¿Qué pasa si el pool de claves de licencia está vacío al cerrar una venta POS?
Alva crea un registro PendingLicenseKeyAssignment y envía el email de descarga sin clave. En cuanto se suben más claves con la etiqueta correspondiente, Alva asigna una y la envía al cliente automáticamente.
¿Puedo bloquear la asignación automática de claves de licencia POS para revisión?
No de forma selectiva. Los pedidos POS se saltan la cola antifraude por diseño. Si un producto concreto necesita revisión antes de soltar claves, deja su etiqueta de clave de licencia sin asignar y asigna las claves manualmente desde el admin de Alva tras cada venta.
Ver también
¿Te ha resultado útil?
Última actualización 2026-05-06