Alle Dokumentation

Custom Order Numbering — Dokumentation

Ersetzen Sie die zufälligen Bestellreferenzen von PrestaShop, zum Beispiel XKBHMQWNY, durch strukturierte Referenzen, die Ihr Team auf einen Blick versteht. Mit Order Number erstellen Sie Referenzen aus Datums-Tags, Zähler-Tags, Shop-/Kundenkontext, Präfixen und Suffixen, zum Beispiel ORD-2026-000001.

Order Number

Die nativen Bestellreferenzen von PrestaShop sind eindeutig, aber für Kundenservice, Buchhaltung oder die interne Auftragsbearbeitung wenig aussagekräftig. Order Number ändert das, indem beim Erstellen einer neuen Bestellung eine formatierte Referenz erzeugt wird.

Ein typisches Format kann Jahr, Monat und Bestellposition anzeigen:

ORD-{YYYY}-{NNNNNN}

Beispielvorschau:

ORD-2026-000042

Das Modul unterstützt PrestaShop 1.6 bis 9.0 (latest), PHP 7.1+. Wir unterstützen auch weiterhin kommende PrestaShop-Versionen.

Custom Order Numbering — Reference format builder

Funktionsweise

Sie definieren ein Referenzmuster im Format Builder des Moduls. Wenn ein Kunde eine Bestellung aufgibt, erzeugt das Modul die nächste Referenz aus diesem Muster und speichert dazu einen Audit-Eintrag.

Auf PrestaShop-Versionen mit dem nativen Hook für Dokumentreferenzen verwendet das Modul:

actionGenerateDocumentReference
actionValidateOrder

Auf älteren Versionen, in denen dieser Hook nicht verfügbar ist, verwendet das Modul seinen enthaltenen Order::generateReference()-Override, damit neue Bestellungen trotzdem Ihre individuelle Referenz erhalten können.

Bestehende Bestellungen behalten ihre aktuellen Referenzen. Das Modul betrifft nur neue Referenzen, die nach der Installation und Konfiguration erzeugt werden.

Das Modul erweitert außerdem die Spalten für Bestellreferenzen, damit längere strukturierte Referenzen möglich sind:

orders.reference        VARCHAR(64)
order_payment.order_reference VARCHAR(64)
Custom Order Numbering — Reference live preview

Installation

  1. Gehen Sie in Ihrem Back Office zu Module → Module Manager
  2. Klicken Sie auf Upload a module und wählen Sie die ZIP-Datei aus
  3. Klicken Sie nach der Installation auf Configure
  4. Öffnen Sie Improve → Order Numbering

Das Modul fügt diese Back-Office-Seiten hinzu:

Order Numbering
- Dashboard
- Format Builder
- Generated References
- Settings
Custom Order Numbering — Counter reset settings

Konfiguration

Formatmuster

Die wichtigste Einstellung ist das Muster, mit dem jede Bestellreferenz erstellt wird.

Standardmuster:

{YYYY}/{MM}/{NNNNNN}

Beispielausgabe:

2026/06/000042

Häufige Musterbeispiele:

ORD-{YYYY}-{NNNNNN}

{YYYY}/{MM}/{NNNNNN}

SHOP-{SHOP_ID}-{YYYY}-{NNNNN}

{COUNTRY}-{YYYY}-{MM}-{NNNNNN}

Für eine kundenspezifische Nummerierung fügen Sie einen kundenspezifischen oder zufälligen Unterscheider ein, damit Referenzen global eindeutig bleiben:

CUST-{CUSTOMER_ID}-{CUSTOMER_NNNN}

{CUSTOMER_REF}-{CUSTOMER_NNNN}

Präfix und Suffix

Sie können außerdem ein statisches Präfix und Suffix rund um das Muster hinzufügen.

Echte Konfigurationsschlüssel, die vom Modul verwendet werden:

order_prefix=ORD-
order_format={YYYY}-{NNNNNN}
order_suffix=

Das erzeugt:

ORD-2026-000042

Zurücksetzen des Zählers

Wählen Sie, wann der Zähler zurückgesetzt wird:

never
yearly
monthly
daily

Wenn Sie yearly wählen, muss das Muster {YYYY} oder {YY} enthalten.

ORD-{YYYY}-{NNNNNN}

Wenn Sie monthly wählen, muss das Muster ein Jahres-Tag und {MM} enthalten.

ORD-{YYYY}-{MM}-{NNNNNN}

Wenn Sie daily wählen, muss das Muster ein Jahres-Tag, {MM} und {DD} enthalten.

ORD-{YYYY}-{MM}-{DD}-{NNNN}

Zählerbereich

Wählen Sie, wie Zähler gezählt werden:

global
customer

global verwendet eine Sequenz pro Shop.

ORD-{YYYY}-{NNNNNN}

customer gibt jedem Kunden eine eigene Sequenz, das Format muss aber weiterhin ein eindeutiges Kunden- oder Zufalls-Tag enthalten.

C-{CUSTOMER_ID}-{CUSTOMER_NNNN}

Nächste Nummer festlegen

Verwenden Sie Set Next Number, wenn die nächste Bestellung mit einer bestimmten Nummer beginnen soll, zum Beispiel nach dem Wechsel von einem anderen Bestellsystem.

order_start_number=5000

Die nächste erzeugte Referenz verwendet diesen Wert einmal, danach wird die Einstellung automatisch geleert.

Custom Order Numbering — Reference log dashboard

Verfügbare Tags

Der Format Builder zeigt die Tags an, die für Bestellreferenzen verfügbar sind. Die nützlichsten sind:

{YYYY}        Full year, e.g. 2026
{YY}          2-digit year, e.g. 26
{MM}          Month, e.g. 06
{DD}          Day, e.g. 16
{QUARTER}     Quarter, e.g. Q2
{WEEK}        ISO week, e.g. 25

{N}           Counter without padding
{NN}          Counter padded to 2 digits
{NNN}         Counter padded to 3 digits
{NNNN}        Counter padded to 4 digits
{NNNNN}       Counter padded to 5 digits
{NNNNNN}      Counter padded to 6 digits
{NNNNNNN}     Counter padded to 7 digits
{NNNNNNNN}    Counter padded to 8 digits

{GLOBAL_NNNNNN}    Global shop counter
{CUSTOMER_NNNN}    Per-customer counter
{CUSTOMER_ID}      Customer ID
{CUSTOMER_EMAIL}   Customer email prefix
{CUSTOMER_REF}     Stable secure customer reference
{COUNTRY}          Delivery country ISO code
{SHOP_ID}          Shop ID
{SHOP_NAME}        Shop name
{CART_ID}          Cart ID
{RAND6}            Random 6-letter code
{RAND9}            Random 9-letter code

Einige Dokument-Tags sind absichtlich nicht verfügbar, während PrestaShop die Bestellreferenz erstellt, weil die Bestellung oder Rechnung zu diesem Zeitpunkt noch nicht existiert:

{ORDER_ID}
{INVOICE_ID}
{DOC_TYPE}
{PAYMENT}
Custom Order Numbering — Mprordernumber counter settings

Standardeinstellungen

Nach der Installation startet das Modul mit diesen Standardwerten:

enabled=1
order_format={YYYY}/{MM}/{NNNNNN}
order_reset_mode=yearly
order_counter_scope=global
order_start_number=
order_prefix=
order_suffix=
Custom Order Numbering — Mprordernumber dashboard counters

Protokoll der erzeugten Referenzen

Jede erzeugte Referenz wird in einem schreibgeschützten Audit-Protokoll gespeichert. Das Protokoll erfasst:

id_order
id_cart
id_customer
id_shop
counter_value
format_pattern
formatted_reference
date_add

So können Sie prüfen, welches Muster für eine Referenz verwendet wurde, und eine erzeugte Referenz mit der Bestellung verknüpfen, sobald PrestaShop deren Erstellung abgeschlossen hat.

Custom Order Numbering — Mprordernumber format builder

Multi-Shop

Zähler werden pro Shop gespeichert. In einer Multi-Shop-Installation hat jeder Shop seine eigene id_shop in der Zählertabelle und kann dadurch seine eigene Nummernsequenz führen.

Ein nützliches Multi-Shop-Muster ist:

{SHOP_ID}-{YYYY}-{NNNNNN}

Oder, wenn jeder Shop ein Land oder eine Marke repräsentiert, verwenden Sie pro Shop ein statisches Präfix:

DE-{YYYY}-{NNNNNN}

FR-{YYYY}-{NNNNNN}
Custom Order Numbering — Mprordernumber generated log

Tipps

  • Verwenden Sie {YYYY} in den meisten Formaten, damit das Jahr sichtbar ist, ohne die Bestellung zu öffnen.
  • Verwenden Sie {MM}, wenn Sie Zähler monatlich zurücksetzen oder Referenzen nach Monat gruppieren möchten.
  • Verwenden Sie genug Stellen für Ihr Bestellvolumen. {NNNNN} ergibt fünf Stellen; {NNNNNN} ergibt sechs.
  • Konfigurieren Sie das Muster, bevor Sie live gehen. Das Format später zu ändern ist erlaubt, aber zukünftige Bestellungen sehen dann anders aus als ältere Bestellungen.
  • Für kundenspezifische Zähler fügen Sie {CUSTOMER_ID}, {CUSTOMER_REF}, {CART_ID}, {RAND6}, {RAND7}, {RAND8} oder {RAND9} ein, damit Referenzen eindeutig bleiben.
  • Halten Sie Referenzen unter 64 Zeichen. Das Modul validiert die erzeugte Vorschau gegen diese Grenze.
Custom Order Numbering — Mprordernumber integrity checks

Häufig gestellte Fragen

Erhalten bestehende Bestellungen neue Referenzen?

Nein. Bestehende Bestellungen behalten ihre ursprünglichen PrestaShop-Referenzen. Nur neue Bestellungen verwenden das individuelle Format.

Können Kunden die neue Bestellreferenz sehen?

Ja. Dies ist die normale PrestaShop-Bestellreferenz, daher sehen Kunden sie überall dort, wo der Shop die Bestellreferenz anzeigt, zum Beispiel in Kundenkonten, Bestell-E-Mails und Rechnungen.

Was passiert, wenn zwei Bestellungen im selben Moment aufgegeben werden?

Der Zähler wird innerhalb einer Datenbanktransaktion mit SELECT ... FOR UPDATE erhöht, sodass jede Bestellung ihren eigenen Zählerwert erhält.

Kann ich den Monat in die Referenz aufnehmen?

Ja. Verwenden Sie {MM}.

ORD-{YYYY}-{MM}-{NNNNNN}

Kann ich den Zähler jeden Monat zurücksetzen?

Ja. Stellen Sie den Reset-Modus auf monthly und fügen Sie {YYYY} oder {YY} plus {MM} in das Muster ein.

{YYYY}/{MM}/{NNNNNN}

Kann ich den Zähler jeden Tag zurücksetzen?

Ja. Stellen Sie den Reset-Modus auf daily und fügen Sie {YYYY} oder {YY}, {MM} und {DD} ein.

{YYYY}/{MM}/{DD}/{NNNN}

Kann jeder Kunde seinen eigenen Zähler haben?

Ja. Stellen Sie den Zählerbereich auf customer und fügen Sie ein eindeutiges Kunden- oder Zufalls-Tag in das Format ein.

C-{CUSTOMER_ID}-{CUSTOMER_NNNN}

Was passiert, wenn die individuelle Nummerierung deaktiviert ist?

PrestaShop kehrt zur normalen Erzeugung zufälliger Referenzen zurück.

Was passiert, wenn das Format ungültig ist?

Das Modul weigert sich, ungültige Formate im Format Builder zu speichern. Wenn während der Bestellung eine ungültige Konfiguration erkannt wird, protokolliert das Modul das Problem und gibt für diese Bestellung keine individuelle Referenz zurück.

Was passiert, wenn eine Bestellung storniert wird?

Die Bestellung behält die Referenz, die ihr zugewiesen wurde. Das Modul verwendet Nummern, die bereits für Bestellungen erzeugt wurden, nicht erneut.

Nach oben