Search by

blueprint3d / module-date-order-numbers

stu583

Date-based order, invoice, shipment and credit memo numbers for Magento 2 (e.g. 20261112-001) that restart every day, with optional random suffixes and shared document numbers.

Package info

github.com/BluePrint3D-Dev/module-date-order-numbers

Documentation

Language:HTML

Type:magento2-module

pkg:composer/blueprint3d/module-date-order-numbers

Security

Advisories: 0

Aikido package health analysis

Transparency log

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v1.0.2 2026-11-13 13:10 UTC

Requires

  • php: >=8.1.0 <8.6.0
  • magento/framework: *
  • magento/module-config: *
  • magento/module-quote: *
  • magento/module-sales: *
  • magento/module-sales-sequence: *
  • magento/module-store: *

Requires (Dev)

None

Suggests

None

Provides

None

Conflicts

None

Replaces

None

proprietary 7d1b7202d936000a3a3e314b609353d02d74a083

Published on Packagist.org on 2026-11-13 16:19 UTC

This package is auto-updated.

Last update: 2026-11-13 16:20:32 UTC

README

Replaces Magento's 000000123 order numbers with readable, date-based ones such as 20261112-001. The count restarts every day, in the store's own timezone.

Features

  • Sequential (20261112-001, -002 ...) or random (20261112-4827) numbers. Random hides how many orders you take each day and never repeats within a day.
  • Orders, invoices, shipments and credit memos can share one number (order 20261112-003 gets invoice 20261112-003; a second partial invoice gets 20261112-003-2), or each can have its own daily counter.
  • Optional prefix per document type (e.g. FW-, INV-), date format, separator and number length.
  • Configured per store view, so one store can use it while another keeps Magento's defaults.
  • Safe under load: numbers are issued with a single atomic database statement.
  • A basket that reserved yesterday's number and pays after midnight is re-numbered with the day it was placed.

Install

composer require blueprint3d/module-date-order-numbers
bin/magento module:enable BluePrint3D_DateOrderNumbers
bin/magento setup:upgrade

Then enable it under Stores > Configuration > BluePrint3D > Date Order Numbers (it ships switched off).

Good to know

  • Only new orders and documents are affected. Existing numbers never change.
  • Invoices, shipments and credit memos of orders placed before you enabled the module keep Magento's normal numbering.
  • Numbers are limited to 32 characters by Magento (increment_id).
  • Payment, shipping and marketplace integrations that read the order number get the new value automatically.

Support

support@blueprint3d.dev