«Sales Documents Numeration» extension

The «Sales Documents Numeration» extension for Magento 2 allows you to use a custom numeration for the sales documents: orders, invoices, shipments, and credit memos.
The source is on GitHub: https://github.com/mage2pro/sales-sequence

How to buy

Use the PayPal form below.

You can try it before buy

Use the self-installation instruction below.

How to install

1. Free installation service

Just order my free installation service.

2. Self-installation

composer require mage2pro/sales-sequence:*
bin/magento setup:upgrade
rm -rf pub/static/* && bin/magento setup:static-content:deploy en_US <additional locales, e.g.: de_DE>
rm -rf var/di var/generation generated/code && bin/magento setup:di:compile

If you have some problems while executing these commands, then check the detailed instruction.

Demo video


Custom order number

Custom invoice number

Custom shipment number

Custom credit memo number

Extension settings

The settings are located in the «Stores» → «Configuration» → «Mage2.PRO» → «Sales» → «Documents Numeration» section.


Enables or disables the «Sales Documents Numeration» extension.

«Pad Numbers with Leading Zeros?»

If enabled, the number 2189 will be rendered as 000002189.

«Numbers Length»

The minimum number of digits to display in the increment part of a sales document’s number.
The increment part is a document number without a prefix and suffix.
A sales document’s number will be padded with the leading zeros to the specified length.
The default length is 9, so the number 2189 is rendered as 000002189
(4 significant digits and 9 - 4 = 5 leading zeros).

«Prefix & Suffix»

You can use the following variables in a prefix/suffix:

{STORE-ID} It will be replaced with the store's ID.
{STORE-CODE} It will be replaced with the store's code.
{a date expression} It will be replaced with the current date. Use any expression supported by PHP date() function. Examples: {y-m} => 16-01 {Y-m} => 2016-01 {Y-M} => 2016-Jan

«Next Numbers»

Next increment numbers for sales, invoices, shipments, and credit memos.