Códigos promocionales: reutilizar un código

Un código promocional agrupa uno o varios vouchers: los códigos que el cliente escribe en el carrito. Cada vez que un pedido usa un voucher, ese uso cuenta para el límite de usos del voucher y para los usos por usuario de la promoción.

Si un cliente necesita volver a usar un voucher (por ejemplo, porque se ha cancelado el pedido en el que lo usó), puedes permitir que se reutilice desde el backoffice, sin abrir un soporte. La operación libera el uso de ese voucher en ese pedido concreto: deja de contar para los usos del voucher y para los del cliente, y queda registrada en el histórico del pedido con quién la permitió y cuándo.

Accede desde Promociones > Ofertas y cupones > Códigos promocionales y abre la ficha de un código. Las dos acciones están en la columna Acciones de la tabla de vouchers, junto a editar y eliminar:

Icono	Acción	Cuándo está disponible
Flecha circular	Reutilizar código	Solo en modo edición (botón Editar) y con permiso de gestión de códigos promocionales.
Reloj con flecha	Mostrar códigos reutilizados	Siempre que el código promocional esté guardado, también en modo visualización. Su tooltip indica cuántas reutilizaciones tiene el voucher: «Mostrar códigos reutilizados (N)».

Permisos

Perfil	Roles	Qué puede hacer
Gestión	promotional_codes:read, :create, :write	Ver la ficha y el histórico de reutilizaciones, entrar en modo edición con Editar y reutilizar códigos.
Solo consulta	promotional_codes:read	Ver la ficha y el histórico de reutilizaciones. El botón Editar no aparece y el icono Reutilizar código aparece deshabilitado con el aviso «No tienes permisos sobre códigos promocionales».
Sin acceso	—	La entrada de menú no aparece. Si se accede por la dirección de la página, se muestra el aviso «No tiene permisos para acceder a esta sección» y se vuelve a la página de inicio.

Para reutilizar hacen falta los dos roles de gestión, promotional_codes:create y promotional_codes:write: si falta cualquiera de ellos, el icono aparece deshabilitado con el aviso anterior. Con permisos pero en modo visualización, el aviso del icono es «Disponible solo en modo edición». El rol promotional_codes:admin incluye todos los anteriores.

Reutilizar un código

1. Abre la ficha del código promocional y pulsa Editar.
2. En la fila del voucher, pulsa Reutilizar código.
3. Indica el número de pedido en el que se usó el voucher y pulsa Confirmar.

Si todo va bien, el modal se cierra, aparece el mensaje «El código «voucher» usado en el pedido «número» se podrá reutilizar» y el contador del tooltip Mostrar códigos reutilizados sube en uno. Al recargar la ficha, la columna Usos del voucher refleja el uso liberado.

Si el código promocional ya no está vigente, el modal muestra el aviso «Este código promocional ya no está vigente». Es solo informativo: puedes confirmar igualmente.

Cancelar o cerrar el modal no cambia nada.

Errores

El modal sigue abierto y muestra el motivo:

Mensaje	Causa
El pedido indicado no existe	No hay ningún pedido con ese número.
El pedido indicado no utiliza este código promocional	El pedido existe, pero no usó este voucher (no usó ninguno o usó otro).
El código ya se liberó anteriormente en este pedido	El uso de este voucher en ese pedido ya se liberó antes.
No se ha podido completar la operación. Inténtalo de nuevo.	Error del servidor. No se ha aplicado ningún cambio; el botón pasa a Reintentar.

Nota: La reutilización no comprueba el estado del pedido: basta con que el pedido haya usado el voucher. En un mismo pedido se pueden liberar vouchers distintos, pero cada voucher solo una vez.

Consultar las reutilizaciones de un voucher

Pulsa Mostrar códigos reutilizados en la fila del voucher. La cabecera indica el voucher y el número de reutilizaciones permitidas.

Columna	Contenido
Pedido	Número de pedido y, debajo, su fecha.
Usuario del pedido	Código de usuario, email y documento (DNI, NIE, pasaporte…) del cliente. Si dos o los tres coinciden se muestran una sola vez; por ejemplo, cuando el código de usuario es el email o el DNI.
Usuario que permite reutilizar	Usuario del backoffice que permitió la reutilización y, debajo, la fecha en que lo hizo.

Las filas están ordenadas por fecha de modificación, de la más reciente a la más antigua. Si el voucher no tiene reutilizaciones, el modal muestra «Este código todavía no tiene reutilizaciones permitidas.». Si no se puede cargar el histórico, el modal muestra un error con el botón Reintentar.

Mientras se da de alta un código promocional nuevo, el icono está deshabilitado con el tooltip «Disponible cuando el código promocional esté guardado».

Traza en Gestión de pedidos

Cada reutilización queda también en el histórico del pedido. En Pedidos y clientes > Gestión de pedidos, los pedidos modificados muestran un icono de ojo junto a su número; al pulsarlo se abre «Este pedido ha sido modificado» con una entrada Reutilización de código promocional por cada voucher liberado:

• Fecha: fecha y hora en que se permitió la reutilización.
• Detalle de modificación: el código promocional y el usuario del backoffice que lo permitió.

Las entradas conviven con el resto de modificaciones del pedido (cambio de franja, productos añadidos, cancelación, desistimiento).