Numeración de pedidos personalizada: configuración y ayuda

Sube e instala mprordernumber mediante Módulos > "Module Manager". Haz clic en Configurar para abrir el panel de control. Usa "Improve" > Numeración de pedidos para acceder a Panel de control, Constructor de formato, Referencias generadas y Configuración. En versiones anteriores, usa la pantalla equivalente de subida de módulos.

Requiere PrestaShop 1.6.1 o posterior y PHP 7.1 o posterior.

La instalación crea el almacenamiento de contadores, referencias de clientes y referencias generadas. Amplía orders.reference y order_payment.order_reference a VARCHAR(64) cuando es necesario. El usuario de la base de datos debe poder crear tablas y modificar esas columnas. La integración con versiones anteriores incluye override/classes/order/Order.php; comprueba "Integrity" y los overrides de Order existentes tras la instalación.

Abre Constructor de formato. Introduce tu patrón en Patrón, usa las etiquetas disponibles, revisa la vista previa en directo y guarda. El patrón establecido durante la instalación es {YYYY}/{MM}/{NNNNNN}.

El campo Patrón se edita en Constructor de formato. La pestaña actual Configuración > Formato contiene Prefijo y Sufijo, sin un campo adicional para el patrón de pedidos.

Para una referencia anual como ORD-2026-000042:

Pattern: {YYYY}-{NNNNNN}
Prefix: ORD-
Suffix: empty
Counter Reset: yearly
Counter Scope: global

Para una secuencia mensual con el país:

Pattern: {COUNTRY}-{YYYY}-{MM}-{NNNNNN}
Counter Reset: monthly
Counter Scope: global

Guarda el patrón y las opciones del contador con sus respectivos controles. Una vista previa no reserva un número.

Los controles del prefijo, sufijo, alcance, reinicio y siguiente número también aparecen en los ajustes del contador de Constructor de formato. Establecer siguiente número se utiliza y se vacía cuando se genera el contador correspondiente. No renumera los pedidos existentes. Evita establecer un valor cuya referencia resultante ya exista.

Las reglas de reinicio requieren etiquetas de fecha en el patrón:

Los contadores se almacenan por tienda. La palabra global indica el contador de toda la tienda, no una secuencia compartida entre todas las tiendas. Usa {SHOP_ID} si necesitas distinguir visiblemente las tiendas. Los ajustes de formato se comparten entre las tiendas aunque sus contadores sean independientes.

Para una secuencia por cliente, incluye un elemento diferenciador único aceptado. Por ejemplo:

Pattern: CUST-{CUSTOMER_REF}-{CUSTOMER_NNNN}
Counter Scope: customer
Counter Reset: never

Las etiquetas diferenciadoras aceptadas incluyen {CUSTOMER_REF}, {CUSTOMER_ID}, {CART_ID} y de {RAND6} a {RAND9}. Distintos clientes pueden tener el mismo prefijo de correo electrónico.

El módulo rechaza {ORDER_ID}, {INVOICE_ID}, {DOC_TYPE} y {PAYMENT} para las referencias de pedido porque el pedido no existe en el momento de la generación. Un patrón válido necesita un contador, componentes de reinicio válidos y una vista previa de un máximo de 64 caracteres, incluidos el prefijo y el sufijo. Usa {NNNNN} para completar el número a cinco dígitos; el formateador no usa la sintaxis {number:5}.

El módulo proporciona actionGenerateDocumentReference para el proceso nativo de generación de referencias de pedido y actionValidateOrder para vincular una entrada de auditoría al pedido guardado. El override incluido de Order::generateReference() proporciona la integración con versiones anteriores. Revisa los conflictos si otro módulo también sobrescribe ese método.

El generador valida el formato, consume solo los contadores requeridos por sus etiquetas, resuelve la referencia y busca duplicados en los pedidos existentes, las referencias de pago y el registro del módulo. Los incrementos de los contadores usan una transacción y bloqueo de filas. Los fallos de generación, los procesos abandonados o los pedidos cancelados pueden dejar huecos en la secuencia.

Referencias generadas muestra el valor formateado, el contador, el patrón, las fechas y el contexto relacionado del pedido y del cliente. El panel de control muestra las referencias recientes y las estadísticas de los contadores. Las referencias de pedidos ya guardadas no se reescriben.

La referencia generada es la referencia de pedido habitual de PrestaShop. Los clientes la ven allí donde las plantillas de la tienda usan ese campo. Un desarrollador puede leer $params['order']->reference en actionValidateOrder para una integración con un ERP una vez que existe el pedido.

1. Guarda un formato anual con un intervalo de próximos números que aún no se haya utilizado.
2. Realiza un pedido de prueba mediante tu proceso de pago habitual.
3. Comprueba la referencia del pedido, el correo de confirmación y la entrada en Referencias generadas.
4. Realiza otro pedido y comprueba el incremento esperado.
5. Si usas el alcance por cliente, prueba con dos clientes y verifica el elemento diferenciador.

Si el formato no se guarda, comprueba las etiquetas desconocidas, las partes de fecha del reinicio, la presencia del contador, el elemento diferenciador del alcance y la longitud de la vista previa. Si el proceso de compra vuelve a una referencia aleatoria, comprueba Activar numeración personalizada de pedidos, los hooks, los overrides, "Integrity" y los registros de PrestaShop. Los formatos no válidos durante la ejecución y el agotamiento de los intentos para evitar duplicados no devuelven ninguna referencia personalizada.

Comprueba las integraciones que presuponen referencias de nueve caracteres antes de adoptar un patrón más largo. Cambiar Establecer siguiente número no evita la protección contra duplicados.

Exporta el registro de referencias generadas y anota la posición del contador antes de desinstalar. La desinstalación elimina la configuración del módulo, las preferencias, el menú y las tablas del esquema propias del módulo. La desinstalación estándar también gestiona sus hooks registrados y su contribución de override. Los pedidos nuevos vuelven a las referencias nativas; las referencias ya almacenadas en pedidos y pagos se conservan. El proceso de desinstalación no reduce las columnas nativas ampliadas.