Saldo y Redención en POS

Una vez emitida, la tarjeta de regalo puede ser consultada en cualquier momento para verificar su saldo disponible. Cuando el cliente desea usarla como pago, el cajero la aplica desde el POS.

Requisitos y permisos

Permiso	Acción permitida
gift_cards.ver	Consultar saldo y aplicar como pago en POS

Estados de una tarjeta

Estado	Descripción	¿Se puede usar como pago?
ACTIVA	Tiene saldo disponible y no ha vencido	Sí
AGOTADA	El saldo llegó a cero tras un uso	No (puede recargarse)
EXPIRADA	La fecha de vencimiento ya pasó	No
CANCELADA	Fue cancelada manualmente	No

Consultar el saldo de una tarjeta

Desde el listado de tarjetas

1. Navegue a Gift Cards (/gift-cards).
2. Use el campo Buscar por código para localizar la tarjeta.
3. La tabla muestra el saldo inicial y el saldo actual de cada tarjeta, así como su estado y fecha de vencimiento.

Desde el POS (diálogo de consulta)

El botón Tarjeta de Regalo en el POS abre el diálogo de consulta. Es la misma herramienta que se usa para aplicar la tarjeta como pago.

Cómo consultar desde el POS:

1. Haga clic en Tarjeta de Regalo en el pie del POS.
2. Ingrese el código de 12 caracteres en el campo correspondiente (solo acepta caracteres alfanuméricos en mayúsculas).
3. Haga clic en Consultar o presione Enter.
4. El sistema muestra:
   • El código de la tarjeta.
   • El estado actual (ACTIVA, AGOTADA, EXPIRADA o CANCELADA).
   • El saldo disponible en MXN.
   • La fecha de vencimiento (en rojo si ya venció).
   • El nombre del receptor (si fue registrado al emitir).

Nota

El código acepta solo los caracteres del alfabeto Base32 Crockford (sin O, I, L ni U). El campo convierte automáticamente a mayúsculas y limita la entrada a 12 caracteres.

Redención en el POS

Paso 1: Tener la venta activa

Asegúrese de que la caja esté abierta y que hay productos en el carrito.

Paso 2: Abrir el diálogo de tarjeta de regalo

Haga clic en el botón Tarjeta de Regalo en el pie del POS.

Paso 3: Consultar el saldo

Ingrese el código y haga clic en Consultar. Verifique que la tarjeta está en estado ACTIVA y que el saldo es suficiente.

Paso 4: Aplicar como pago

Si la tarjeta está activa y tiene saldo, el diálogo muestra el botón Aplicar como pago ($X.XX). Haga clic en él.

El saldo de la tarjeta se aplica como una forma de pago parcial o total de la venta:

• Si el saldo de la tarjeta cubre el total, la venta queda saldada y el estado de la tarjeta cambia a AGOTADA.
• Si el saldo de la tarjeta es menor al total, cubre una parte y el cliente paga el resto con otro método.

Precaución

No es posible aplicar una tarjeta en estado AGOTADA, EXPIRADA o CANCELADA. El diálogo muestra un aviso en esos casos y deshabilita el botón de aplicación.

Cancelar una tarjeta

Solo las tarjetas en estado ACTIVA pueden ser canceladas. Para cancelar:

1. Navegue a Gift Cards (/gift-cards).
2. Localice la tarjeta en el listado (busque por código si es necesario).
3. Haga clic en el botón Cancelar de la fila correspondiente.
4. El sistema muestra un diálogo de confirmación con el saldo restante que quedará inutilizable.
5. Confirme con Sí, cancelar.

Precaución

La cancelación no puede deshacerse. El saldo restante queda inutilizable y no se reembolsa automáticamente.

Ciclo de vida de una tarjeta

ACTIVA ──→ AGOTADA (saldo = $0 tras uso)
       ──→ CANCELADA (cancelación manual)
       ──→ EXPIRADA (cron nocturno, fecha vencida)

AGOTADA ──→ ACTIVA (si se recarga; la recarga no está disponible desde la UI, solo vía API admin)
        ──→ CANCELADA (cancelación manual)

Reglas y validaciones

• El monto a usar debe ser mayor a cero y no puede exceder el saldo disponible.
• La tarjeta no puede usarse si su fecha de vencimiento ya pasó, aunque tenga saldo.
• Solo las tarjetas ACTIVA permiten el botón Aplicar como pago en el diálogo del POS.
• El código de búsqueda acepta mínimo 3 caracteres para iniciar la consulta.

Casos frecuentes

La tarjeta aparece como AGOTADA pero el cliente dice que no la ha usado. Revise el historial de movimientos de la tarjeta. Es posible que haya quedado en estado AGOTADA por una venta que fue cancelada posteriormente; en ese caso el saldo debería haberse restaurado. Contacte soporte si detecta una inconsistencia.

El sistema dice que la tarjeta está vencida pero la fecha de impresión es posterior. La fecha de vencimiento es la que se configuró al emitir, no la fecha de impresión. Consulte la columna Expira en el listado de gift cards.

¿Puede el cliente usar varias gift cards en una misma compra? El flujo actual del POS aplica una tarjeta a la vez por consulta. El cajero puede aplicar el saldo de la primera y, si no es suficiente, abrir el diálogo nuevamente para aplicar otra tarjeta sobre el saldo restante.