Desarrollo alpha.3: pruebas locales
Cupos de unidades de campaña
Versión de trabajo: 0.1.0-alpha.3. Función de desarrollo local, no una versión de producción. Esta guía describe aquella implementación; la descarga pública del sitio podía contener una versión anterior.
Limita el total de unidades con descuento
Abre HookSpark → Pricing & Discounts, crea o edita una promoción y busca Discounted units across this campaign (0 = unlimited)(«Unidades con descuento en toda esta campaña; 0 = sin límite»). Introduce un entero y guarda. Deja cero para no limitar la campaña. Las promociones existentes utilizan cero por defecto.
Es un total entre pedidos para esta promoción, no un máximo por carrito ni un recuento de clientes. Siguen aplicándose la selección de productos, los requisitos, las fechas y el cálculo del descuento.
| Promoción | Pedido | Unidades que consumen cupo de esta campaña |
|---|---|---|
| 10 % de descuento en cada artículo coincidente | 12 artículos coincidentes | 12 |
| Comprar 2 y recibir 1 gratis, con repetición | 6 artículos, incluidas 2 recompensas | 2 |
| Reducción progresiva desde el quinto artículo | 6 artículos, solo los últimos 2 con descuento | 2 |
| Dos promociones acumuladas | Cada una descuenta los mismos 3 artículos | 3 por cada campaña, por separado |
Los productos que solo activan una promoción de compra y recompensa no consumen cupo de recompensa. Los regalos gratuitos automáticos sí cuentan. Cupo y existencias son restricciones distintas: un cupo no crea existencias. Min/Max sigue validando las cantidades físicas del pedido.
Qué experimenta el comprador
Añadir un producto al carrito no reserva disponibilidad de la campaña. La vista previa del producto y el simulador no garantizan que siga quedando cupo.
El proceso de pago reserva durante 15 minutos toda la asignación del pedido. Si no quedan suficientes unidades, se detiene con un mensaje que pide volver al carrito y revisar las cantidades. No aplica una promoción parcial sin avisar. Se probaron dos compras locales simultáneas con capacidad para un pedido: se completó exactamente una, tanto con pago clásico como mediante Store API.
Repetir el proceso de pago sustituye la asignación pendiente de ese pedido. Las campañas retiradas dejan de retener sus unidades pendientes. Si falta capacidad en cualquier campaña necesaria, la sustitución no se completa parcialmente.
Confirmación, caducidad y cancelación
Las reservas pendientes caducan a los 15 minutos. Un pedido en espera no amplía la reserva ni consume el cupo definitivamente. Tras caducar, otro pedido puede utilizar las unidades; una confirmación posterior debe volver a comprobar la disponibilidad. Un pedido que pasa a procesando o completado, o recibe la confirmación de pago de WooCommerce, consume definitivamente la asignación. Repetir esas notificaciones no multiplica el uso.
El estado «En proceso» no demuestra que se haya recibido el dinero. El pago contra reembolso puede pasar a ese estado antes del cobro; su asignación también se consume al confirmar.
Los pedidos cancelados o fallidos liberan reservas pendientes. En esta implementación, cancelar o reembolsar no devuelve automáticamente las asignaciones ya consumidas. No supongas que un reembolso monetario aumenta el cupo. La política de devolución del cupo consumido sigue pendiente en esta referencia.
Una confirmación tardía vuelve a comprobar la capacidad. Si quedan unidades suficientes, confirma la asignación sin aviso de revisión aunque la reserva original haya caducado. Si no puede confirmarla, el pedido conserva su estado y queda marcado para revisión. No se realiza un reembolso, cancelación o reversión de pago automáticos.
Resuelve el aviso de revisión del cupo de promoción
- Abre el pedido y lee el aviso y la nota interna antes de prepararlo.
- Comprueba por qué no se puede leer la disponibilidad o si el almacenamiento necesita atención. No supongas que el pago ha fallado porque falle la confirmación del cupo.
- Después de restablecer la disponibilidad, elige Recheck promotion quota («Volver a comprobar el cupo de promoción») en Acciones del pedido de WooCommerce y aplica la acción.
- El aviso solo desaparece cuando se confirma la asignación; de lo contrario, permanece.
La acción conserva la asignación original de unidades del pedido y comprueba el límite actual de la campaña. Por ejemplo, si ya se han consumido dos unidades y un pedido necesita otras dos, aumentar el límite de 2 a 4 permite confirmar su asignación al volver a comprobar. No modifica cantidades ni precios históricos. Si se ha eliminado la campaña, se utiliza como alternativa la capacidad guardada. Reducir el límite no revoca asignaciones ya confirmadas. Si queda por debajo del uso actual, no pueden confirmarse más asignaciones. Establecer cero deja la campaña sin límite; volver a comprobar un pedido señalado sigue registrando sus unidades exactas. Esta versión no tiene un control para restablecer manualmente el cupo. Solo puede ejecutar la recuperación un editor de pedidos autorizado.
Límites documentados antes de publicar
- La distribución en navegador, el uso con teclado y el envío de la acción nativa aún necesitan aceptación visual en esta referencia.
- Los ejemplos de precio de producto explican ahora si el cupo es limitado o insuficiente sin mostrar nombres internos de campañas ni la capacidad restante exacta. No reservan unidades; la disponibilidad del carrito completo puede ser distinta. El simulador muestra la disponibilidad de las campañas limitadas seleccionadas, avisa si es insuficiente e informa expresamente de un fallo de lectura. No reserva unidades. El editor de campaña guardada también muestra el uso actual y las reservas pendientes; la aceptación visual sigue abierta en esta referencia.
- Las pruebas HTTP locales utilizan pago contra reembolso. Las transiciones nativas a espera y la caducidad y reasignación se prueban con pedidos temporales y marcas de tiempo de reserva envejecidas. No se validan pasarelas remotas ni sus notificaciones tardías.
- Quedan pendientes la actualización y migración, la conservación durante la limpieza y la política de devolución del cupo consumido.
- No se estiman ni completan instantáneas históricas que carezcan de asignaciones exactas de unidades.
Consulta los controles actuales
