Document Numbers in Ori
How does Ori number documents?
Ori numbers each document type in its own unbroken sequence, assigned when you issue a document: INV-2026-0001, INV-2026-0002 and so on for invoices, with receipts, delivery notes, quotations and purchase orders counting separately. A number is never reused, and the sequence never restarts, not at a new year and not when you change a prefix.
| Document | Default prefix | First number in 2026 |
|---|---|---|
| Invoice | INV-{YYYY}- |
INV-2026-0001 |
| Receipt | RCP-{YYYY}- |
RCP-2026-0001 |
| Delivery note | DLV-{YYYY}- |
DLV-2026-0001 |
| Quotation | EST-{YYYY}- |
EST-2026-0001 |
| Purchase order | PO-{YYYY}- |
PO-2026-0001 |
- A number has at least four digits, and grows past four when the sequence does: invoice 10,000 is INV-2026-10000.
- Every path that issues takes the next number: the issue dialog, Shopify’s order page, automation rules, bulk issue, receipts customers issue themselves, and New document.
- Bulk issue numbers the orders one after another: “Document numbers are assigned in order and cannot be undone — though a document can be voided.”
What do the prefix and the year print?
A prefix is the text in front of the sequence, and {YYYY} in it prints the year of the document’s date: “{YYYY} prints the year of the document’s date, and changing a prefix never restarts the numbering.” So INV-2026-0031 can be followed by INV-2027-0032, and the sequence carries on across the year.
The document’s date depends on where the document comes from:
- From an order: the order’s date, in Japan time. An invoice issued in January for a December order prints December’s year, so the years in a run of numbers follow the orders’ dates, not the order you issued them in.
- From New document: the day you issue it, in Japan time: quotations and invoices without an order.
How do I change a prefix?
To change a prefix in Ori, open Settings → Tax & compliance, find Document numbers and edit the field for that document type, then save. Each field shows the number the next document will take, as “Next: …”.
- In Ori, open Settings and the Tax & compliance tab.
- Under Document numbers, edit the prefix for the document type. Keep
{YYYY}where the year should print, or remove it for a prefix without a year. - Check “Next:” under the field, then click Save in Shopify’s save bar.
Ori checks each prefix as you type:
- “A prefix may be up to 10 letters, digits and hyphens.” The year counts as its four digits.
- Two document types can’t share numbers: “This prefix can print the same numbers as …”, naming the other type.
The new prefix applies from the next document you issue. Documents already issued keep the numbers they printed.
Can I start the numbering from a different number?
No. Ori has no setting for the next number: each sequence carries on from the last number issued, which is what keeps it unbroken. To keep Ori’s documents apart from an earlier series, such as numbers from another app or from paper, give them a prefix of their own.
What happens to a number after a reissue or void?
A reissue keeps the document’s number and a void keeps the number used, so a voided number is never given to another document and the sequence has no gaps. The next document you issue takes the next number.
| What you do | The number |
|---|---|
| Reissue | Stays the same. The new PDF is marked reissued, and the archive keeps the earlier one |
| Void | Stays used. The document stays in the archive as voided |
| Issue a corrected document after a void | Takes the next number in the sequence |
| Save a draft in New document | None yet: “Assigned at issue” |
How to reissue or void, and what each prints: reissue, void and refunds in Ori.
Why does a preview show a number?
A design preview or a test email in Ori prints a sample number in your format, such as INV-2026-0012, so you can see where the number sits. It isn’t a real number: only issuing a document takes one from the sequence.