Tarjetas de regalo
Ruta: /tarjetas
Quién la usa: dueño
Permiso requerido: giftcard.redeem para abrir la pantalla; giftcard.issue
para crear o desactivar tipos y para las secuencias (y el plan debe incluir
tarjetas de regalo)
Capturas: docs/manual/screenshots/catalogo/
Qué es
El control de las tarjetas de regalo: cuánto saldo hay emitido y sin consumir
(SALDO PENDIENTE (PASIVO)), cuántas TARJETAS ACTIVAS existen, un buscador
por código, y abajo los Tipos de tarjeta — las tarjetas que el cajero podrá
vender en el cobro, con su valor cargado y su precio de venta. En frankies-sim
el pasivo es B/. 0.00, hay 0 tarjetas activas y la lista dice
«Aún no hay tipos de tarjeta»: la simulación acepta gift_card como método de pago
pero nunca emitió ninguna.
Cuándo se usa
Al montar el programa de tarjetas (crear los tipos que el cajero verá en el cobro), y después, de forma puntual: consultar el saldo de una tarjeta que trae un cliente, o revisar cuánto saldo emitido queda pendiente antes de un cierre contable.
Paso a paso
- Abra Ajustes → Tarjetas de regalo.
- Para consultar una tarjeta, escriba el código en Buscar tarjeta por código (ej. A00006)… y presione Buscar. Los resultados salen con el código, el comprador, la fecha de vencimiento, el saldo y el estado (Activa, Agotada, Vencida o Anulada); presionando uno se abre su ficha.
- Para crear un tipo, presione ＋ Nuevo tipo de tarjeta y llene
Nombre del tipo, Descripción (opcional), Valor a cargar (B/.),
Precio de venta (B/.) y Vence en (días). Presione Crear tipo.
- Si el monto lo decide el cliente en caja, marque Abierta (valor y precio se definen en el cobro): entonces los campos de valor y precio se dejan vacíos.
- Cada tipo ya creado se lista con su valor, su precio y su vencimiento, y con el botón Desactivar / Activar a la derecha.
- Para los códigos impresos por sede, presione Secuencias por sede. Ahí se elige Sede, Tipo de secuencia (Tarjetas estándar o Regalos de servicio), Prefijo y Longitud, y se presiona Añadir. La tabla muestra SEDE · PREFIJO · LONGITUD · PRÓXIMO SERIAL · ACTIVA; en la simulación dice «Aún no hay secuencias».
Campos y botones
| Campo/Botón | Qué hace | Notas |
|---|---|---|
| SALDO PENDIENTE (PASIVO) | Saldo emitido y todavía no consumido | Es una deuda con el cliente, no una venta |
| TARJETAS ACTIVAS | Cuántas tarjetas siguen con saldo vigente | — |
| Buscar tarjeta por código… / Buscar | Busca por coincidencia parcial del código | Devuelve hasta 25 resultados |
| Secuencias por sede | Abre /tarjetas/seriales | Requiere giftcard.issue |
| ＋ Nuevo tipo de tarjeta | Despliega el formulario de alta | Requiere giftcard.issue |
| Nombre del tipo / Descripción (opcional) | Identifican el tipo en el cobro | — |
| Valor a cargar (B/.) | Saldo redimible que queda en la tarjeta | Se deja vacío en las abiertas |
| Precio de venta (B/.) | Lo que paga el cliente | Puede diferir del valor cargado |
| Vence en (días) | Días desde la venta hasta el vencimiento | Vacío = no vence |
| Abierta (valor y precio se definen en el cobro) | El cajero fija valor y precio al vender | Los descuentos afectan el precio, no el valor cargado |
| Crear tipo | Da de alta el tipo | — |
| Activar / Desactivar (tipo) | Saca o devuelve el tipo a la lista del cobro | Los tipos inactivos quedan marcados «inactivo» |
| Sede · Tipo de secuencia · Prefijo · Longitud · Añadir | Definen el prefijo y el contador de códigos impresos por sede | Ej. CE000001 / SF000005 |
| Gift Card (barra superior) | Consulta rápida de saldo desde cualquier pantalla | Pide Código de la tarjeta… y devuelve saldo, estado y vencimiento |
Mensajes y errores
"Sin resultados."
"Aún no hay tipos de tarjeta."
"Aún no hay secuencias."
En la consulta rápida Gift Card de la barra superior:
"Ingresa un código"
"Tarjeta no encontrada"
Al crear o editar una secuencia por sede, el error de la base se muestra tal cual: «No se pudo crear la secuencia: …» o «No se pudo guardar la secuencia: …».
Si el usuario no tiene giftcard.redeem o el plan no incluye tarjetas de regalo,
la ruta no existe para él:
"404 — This page could not be found."
Lo que la pantalla no hace. No emite tarjetas: una tarjeta nace en el
cobro del POS, vendiendo uno de estos tipos. Tampoco recarga saldo ni anula una
tarjeta desde el listado: eso vive en la ficha de cada tarjeta (/tarjetas/<id>),
a la que se llega presionando un resultado del buscador. En frankies-sim no hay
ninguna tarjeta emitida, así que esa ficha no se pudo recorrer y este manual
no la documenta; queda pendiente para una organización con tarjetas vivas.
Y una advertencia que decide todo lo demás en un restaurante: el POS de
/pedidos no ofrece el método «Tarjeta de regalo» al cobrar. Se comprobó en
la caminata, con el cajero y con el dueño: el panel Pagar lista Efectivo,
Yappy, Tarjeta, Tilopay (y Cortesía a quien tenga el permiso), pero nunca la
tarjeta de regalo, aunque gift_card figure activa en
Métodos de pago. O sea que hoy, desde el mostrador de un
restaurante, no se vende ni se redime una tarjeta: los tipos que se creen
aquí no llegan a tener dónde venderse, y una tarjeta que traiga un cliente no se
puede aplicar a su cuenta. Lo único que sí funciona en el turno es consultar el
saldo con el botón Gift Card de la
barra superior, que ven todos los roles —incluido el
cajero, que no puede abrir esta pantalla—. Si necesita el programa de tarjetas en
su restaurante, hable con soporte de Nura antes de venderlas.