Personalización de números de factura y pedido: por qué los números predeterminados no bastan

Revisado en junio de 2026. Aplicable a PrestaShop 1.6, 1.7, 8 y 9. Las claves de configuración siguientes se mantienen estables en esas versiones; las etiquetas de menú cambian ligeramente entre versiones, así que confirma la ruta exacta en tu propia instalación. Nada de lo que se explica aquí constituye asesoramiento legal o fiscal: tu asesor contable y la normativa local determinan cómo debe ser una secuencia conforme en tu país.

De serie, PrestaShop asigna a cada pedido una referencia como "XKJHQWER" y empieza las facturas en el número 1. En un catálogo de prueba, eso pasa desapercibido. El día que empiezas a recibir pedidos reales se convierte en un riesgo: un agente de soporte que no puede leer cómodamente un número de pedido por teléfono, un contable que no distingue qué documento es cuál y un inspector fiscal que quiere saber por qué la factura #4521 va seguida de la #4598 sin nada entre medias. Esta guía trata específicamente de los números: la referencia del pedido y la secuencia de facturas/abonos, qué te permite cambiar PrestaShop desde el panel de administración, dónde están sus límites y cómo conseguir un esquema de numeración que tu asesor contable acepte y tu equipo pueda usar de verdad.

Es un tema acotado a propósito. El formato del PDF de factura, las normas legales país por país sobre lo que debe incluir una factura y el salto a la facturación electrónica estructurada son problemas distintos, con sus propias respuestas, enlazadas al final. Aquí nos centramos en la numeración.

Qué te ofrece PrestaShop de forma nativa y qué no

En PrestaShop conviven dos sistemas de numeración distintos, y los comerciantes los confunden constantemente.

La referencia del pedido es el código visible para el cliente que se genera en el momento en que se realiza un pedido. PrestaShop la crea en Order::generateReference() como una cadena alfanumérica aleatoria en mayúsculas (la conocida forma "XKJHQWER"). No es secuencial, no se puede configurar desde el panel de administración y no transmite ningún significado. Es lo que aparece en el correo de confirmación, en Pedidos → Pedidos y lo que el cliente te lee por teléfono.

El número de factura es diferente: se asigna solo cuando se genera realmente una factura (cuando un pedido alcanza un estado marcado como factura disponible) y sí forma una secuencia continua. Tienes un pequeño margen de control sobre él en Pedidos → Facturas (PrestaShop 1.7 y posteriores: Vender → Pedidos → Facturas):

Eso cubre lo básico, y para una tienda de un solo país y una sola tienda puede ser todo lo que necesitas. Las carencias aparecen en cuanto tu configuración es un poco más exigente:

• La referencia del pedido sigue siendo aleatoria. Ningún ajuste nativo la toca. Tu almacén y tu equipo de soporte siguen obligados a leer "XKJHQWER" en voz alta.
• No hay control del relleno con ceros. Los números de factura avanzan 1, 2, 3 … 999 sin forma de imponer una anchura fija como 00001, de modo que no se ordenan ni se alinean bien en las exportaciones.
• Los abonos nativos tienen su propia numeración y prefijo básicos, pero una personalización de formato limitada. PrestaShop genera los abonos como un tipo de documento separado, con contador y prefijo propios, pero te da poco control sobre su formato, reinicio o serie en comparación con un módulo dedicado. Algunas jurisdicciones exigen que las notas de crédito estén en una serie claramente separada y descriptiva.
• El año es el único periodo de reinicio. Si tu contable usa secuencias mensuales, el conmutador nativo no sirve.
• La diferenciación por tienda es limitada. En multitienda puedes variar el prefijo por tienda, pero construir a mano un esquema limpio y específico para cada mercado resulta engorroso.

¿Y qué? Por qué la numeración importa de verdad

Esta es la parte que muchos comerciantes subestiman hasta que algo falla. Tres beneficios concretos:

Seguridad ante auditorías. Las normas de la UE exigen una numeración de facturas secuencial y única basada en una o varias series, y muchas autoridades fiscales esperan que cualquier salto pueda explicarse y documentarse; un salto que no puedes justificar es el tipo de detalle que convierte una revisión rutinaria en una inspección seria. Lo que se considera conforme varía según el país, y ese nivel de detalle corresponde a las guías legales, no a esta: consulta personalización de facturas: plantillas PDF y requisitos legales para saber qué exige cada mercado en el documento, y el resumen de la normativa de comercio electrónico en la UE para las obligaciones más amplias. Para la numeración, la idea es simple: una secuencia predecible y controlada es lo que hace posible que no haya "saltos sin explicar".

Soporte más rápido. Un cliente que lee "ORD-2026-00142" a tu agente permite localizar el pedido a la primera. El mismo cliente leyendo "XKJHQWER" confunde la K con una Q, se salta un carácter y tú pasas dos minutos confirmando letras. Multiplícalo por cada llamada de soporte.

Contabilidad que se importa sin fricciones. Tanto si tu gestor usa Datev, Xero o un programa local, espera un formato coherente y números de anchura fija que se ordenen correctamente. Acertar con el formato antes de la primera exportación es mucho más barato que reconciliar un descuadre después.

Diseñar un esquema de numeración que aguante

Antes de tocar cualquier ajuste, decide el esquema sobre papel. Un buen esquema es legible, autofechado y de anchura fija. Un patrón práctico:

• Prefijo que identifique el documento y el mercado: RE para una Rechnung alemana, FA para una facture francesa, INV para una factura genérica en inglés.
• Año (y mes, si tu contable usa series mensuales): hace que el documento lleve su propia fecha y no necesite referencias cruzadas para saber cuándo se emitió.
• Contador con ceros a la izquierda: 00001, no 1, para que todo se alinee y se ordene correctamente.
• Una serie separada para notas de crédito: usa un contador independiente para notas de crédito salvo que tu contable o la normativa local aprueben una serie compartida; una nota de crédito es un tipo de documento propio, y una serie distinta suele ser más clara.

Eso produce formatos como RE-2026-00001 o FV/00001/06/2026. La regla que importa más que la forma exacta es esta: elige una vez y no lo cambies a mitad de periodo. Cambiar el formato dentro de un ejercicio fiscal es lo que crea registros confusos y aparentes "saltos" que disgustan a los auditores. Si tienes que cambiarlo, hazlo en un cambio de año y deja una nota escrita para tu contable.

Conseguir control total: la vía del módulo

Cuando los ajustes nativos se quedan cortos — y para la referencia del pedido se quedan cortos de inmediato — dos de nuestros módulos cubren esas carencias, cada uno encargado de uno de los dos sistemas de numeración.

Nuestro módulo Order Number sustituye la referencia aleatoria del pedido por una referencia significativa y secuencial. Funciona sobrescribiendo la clase principal Order, de modo que la nueva referencia aparece en todos los sitios donde aparecía la anterior: la lista del panel de administración, la cuenta del cliente, el correo de confirmación, sin editar la plantilla. Construyes el formato con tokens: {YYYY} para el año, {MM} para el mes, {NNNNNN} para un contador con ceros a la izquierda, incluso {PAYMENT} para incluir el método de pago. ¿Qué ganas con eso? Una referencia como ORD-2026-000142 que el cliente puede repetir sin errores y que tu almacén puede escanear y buscar al instante: desaparece la mayor fricción diaria en la gestión de pedidos.

Nuestro módulo Invoice Number hace lo mismo en la parte documental y va mucho más allá del conmutador nativo de prefijo y año. Defines un prefijo personalizado, insertas el token {YYYY}, eliges la anchura del contador con {NNNN} o {NNNNNN}, cambias el reinicio entre anual y mensual y, la parte que el núcleo no resuelve limpiamente, mantienes una secuencia separada y con formato independiente para las notas de crédito. ¿Y qué? Entregas a tu contable exactamente el formato que te ha pedido, con la anchura exacta que se importa sin arreglos manuales y con las notas de crédito en su propia serie claramente etiquetada. La postura de cumplimiento (continua, controlada y explicable) y la comodidad contable salen del mismo ajuste.

Para el contenido de la nota de crédito, no su número — desgloses fiscales correctos, referencias a la factura original y formato de nivel contable en el propio documento — ese es el trabajo de Financial Revolution, que mejora los abonos que PrestaShop genera al reembolsar. La numeración y el contenido del documento son cuestiones separadas de forma deliberada; usa la herramienta que encaje con lo que estás corrigiendo.

Multitienda: un esquema por tienda

Si gestionas varias tiendas — marcas distintas, países distintos, canales distintos — cada una debería conservar su propio contador y su propio prefijo. Mezclarlos produce saltos aparentes cuando revisas la contabilidad de una sola tienda y hace imposible saber de un vistazo qué tienda emitió un documento. Una estructura limpia:

Cada tienda incrementa y reinicia de forma independiente, y el mercado se lee solo con el prefijo. Los ajustes de factura ya tienen en cuenta el contexto en una multitienda de PrestaShop; la parte de la referencia de pedido es donde un módulo se gana su sitio, porque la referencia aleatoria nativa no tiene ningún concepto por tienda.

Migrar desde números predeterminados sin crear duplicados

Cambiar una tienda en producción exige cuidado: si te equivocas con el número inicial, puedes chocar con documentos que ya existen. La secuencia segura:

1. Elige una fecha de transición: mejor en el cambio de ejercicio fiscal o de trimestre; si tienes que cambiar a mitad de periodo, documenta el cambio y mantén las series antigua y nueva claramente trazables.
2. Configura el siguiente contador por encima de tu número existente más alto: para facturas es PS_INVOICE_START_NUMBER (o el valor inicial del módulo); esto garantiza que no haya duplicados.
3. Deja tranquilos los documentos antiguos. Nunca renumeres retroactivamente facturas emitidas: conservan sus números originales durante toda su vida legal de conservación. Solo los documentos nuevos usan el nuevo formato.
4. Prueba el reinicio antes de depender de él. Si configuras un reinicio anual o mensual, comprueba en una copia de preproducción que realmente cambia de ciclo, en lugar de descubrir el 1 de enero que no lo hizo.
5. Déjalo por escrito para tu contable: una nota de una línea con qué cambió y cuándo elimina cualquier duda sobre el "salto" en el cambio.

Si prefieres comprobar o definir estos valores directamente, todos viven en la tabla ps_configuration como filas simples de clave/valor. Léelos antes de cambiar nada en el panel de administración para conocer el estado actual:

-- Inspect the native invoice-numbering settings
SELECT name, value
FROM ps_configuration
WHERE name IN (
  'PS_INVOICE_PREFIX',
  'PS_INVOICE_USE_YEAR',
  'PS_INVOICE_RESET',
  'PS_INVOICE_START_NUMBER',
  'PS_DELIVERY_PREFIX',
  'PS_DELIVERY_NUMBER'
);

Algunos de estos valores son por idioma (el prefijo en particular), así que en una tienda multilingüe la fila puede estar en ps_configuration_lang indexada por id_lang. El lugar más seguro para configurarlos sigue siendo el panel de administración, que escribe la fila correcta para la tienda, el idioma y el contexto adecuados; trata el SQL anterior como una forma de ver el estado actual y haz una copia de seguridad antes de cualquier escritura manual. El siguiente número secuencial de factura no se almacena como una única fila de configuración: PrestaShop lo deriva del number existente más alto en ps_order_invoice combinado con el valor inicial, que es exactamente por lo que definir el número inicial por encima de tu documento existente más alto (en lugar de renumerar nada) es la forma de evitar duplicados.

Errores habituales

• Cambiar el formato a mitad de año. La fuente clásica de libros confusos y saltos inexplicables. Cambia solo en un límite de periodo.
• Una sola serie para facturas y notas de crédito. Algunas jurisdicciones o contables exigen o prefieren una serie separada; verifícalo localmente. Incluso cuando se permite una serie compartida, mezclarlas complica la contabilidad. Mantén INV- y una serie distinta para notas de crédito.
• Dejar el contador sin ceros de relleno. Los números de anchuras distintas se ordenan mal en hojas de cálculo y exportaciones. Usa una anchura fija desde el primer día.
• Olvidar que existe la referencia del pedido. Los comerciantes arreglan los números de factura y dejan los pedidos con la referencia aleatoria; luego se preguntan por qué las llamadas de soporte siguen siendo lentas. Son dos sistemas separados; corrige ambos.
• No numerar los albaranes de forma coherente. Tienen menos exigencias legales, pero una secuencia errática de albaranes también cuesta tiempo a tu equipo de almacén.

Dónde termina la numeración y empieza el resto del cumplimiento

La numeración es solo una parte de tener documentos e impuestos bien resueltos en PrestaShop. Las piezas vecinas, cada una con su propia guía:

• Qué debe mostrar el PDF de factura y cómo crear su plantilla: personalización de facturas: plantillas PDF y requisitos legales.
• Facturación electrónica estructurada donde es obligatoria (el SDI de Italia, la reforma francesa y más): facturación electrónica en Europa: qué países la exigen.
• Aplicar correctamente el IVA transfronterizo: IVA en la UE: OSS, IOSS y lo que tu tienda debe gestionar y la guía práctica configuración fiscal en PrestaShop.
• Cómo se muestran los precios antes del pago: normas de visualización de precios en Europa.
• Gestión de devoluciones y reembolsos de principio a fin, de la cual la nota de crédito es un paso: devoluciones y reembolsos: cómo hacer que el proceso sea más sencillo.

Preguntas frecuentes

¿Puedo hacer que la referencia de pedido de PrestaShop sea secuencial sin un módulo?

No desde el panel de administración. La referencia del pedido viene de Order::generateReference(), que devuelve una cadena aleatoria en mayúsculas, y no existe ningún ajuste nativo que la cambie. Las únicas formas de hacerla secuencial son sobrescribir tú mismo la clase Order o usar un módulo que lo haga; el número de factura sí es configurable de forma nativa, pero la referencia del pedido no.

¿Por qué mi numeración de facturas tiene saltos?

Casi siempre porque un pedido generó una factura y después se canceló o reembolsó, o porque un estado que no esperabas que facturara tenía marcada la opción "Factura". El número se asignó y el documento se anuló más tarde, dejando un hueco. En varios países de la UE, un salto solo es aceptable si puedes explicarlo, así que la solución práctica está en el proceso, no en borrar: conserva el documento anulado, anota el motivo y nunca renumeres para "cerrar" el salto. Que se toleren o no los saltos depende de tu jurisdicción; confírmalo con tu contable.

Estoy migrando una tienda existente: ¿qué número inicial debo configurar?

Configúralo en uno más que el número de factura más alto que ya hayas emitido. PrestaShop deriva el siguiente número de los documentos existentes más el valor inicial, así que un número inicial por encima de tu máximo actual garantiza que no haya colisiones. Nunca reduzcas el número inicial por debajo de un documento emitido y nunca renumeres retroactivamente facturas antiguas: conservan sus números originales durante todo su periodo legal de conservación.

¿Deben compartir facturas y notas de crédito una misma serie numérica?

Normalmente no. Una nota de crédito es un tipo de documento distinto, y muchos contables y algunas jurisdicciones prefieren o exigen una serie separada y descriptiva. PrestaShop da a los abonos su propio contador básico; si necesitas una serie de notas de crédito con formato independiente y su propio reinicio, ahí es donde el módulo Invoice Number va más allá del conmutador nativo. Verifica la norma local antes de compartir una serie.

¿Cambiar el prefijo de factura renumera mis facturas antiguas?

No. El prefijo y los tokens de año se aplican a los documentos generados después de cambiar el ajuste; las facturas ya emitidas conservan el formato con el que se crearon, porque PrestaShop almacena el número asignado en cada fila de ps_order_invoice. Por eso también conviene cambiar el formato solo en un límite de periodo: mezclar dos formatos dentro de un mismo ejercicio fiscal es lo que produce registros que los auditores encuentran confusos.

La numeración de documentos es uno de esos ajustes que nadie elogia y que todo el mundo nota el día que está mal. Decide el esquema una vez — prefijo legible, autofechado, anchura fija, notas de crédito en su propia serie — configúralo desde el panel de administración o con un módulo que cubra las carencias nativas y después déjalo estable. Bien hecho, cumplirá discretamente su función en cada auditoría, llamada de soporte y cierre de ejercicio mientras la tienda siga funcionando.