Memahami Nomor Pesanan

Penjelasan sederhana#

Nomor pesanan (kolom NO. PESANAN) adalah identitas transaksi yang Anda baca di struk, di daftar, dan pada riwayat stok. Backoffice tidak mengarang nomor untuk transaksi kasir; nomor itu diterbitkan di tempat transaksi terjadi, lalu diterima dan disimpan oleh server.

Bentuk yang terlihat#

Dari daftar pesanan pada tenant dokumentasi terlihat tiga pola, seluruhnya berawalan ORD-:

Pada pesanan contoh, nomor tanpa kode register memiliki channel Back-Office maupun POS (pesanan lama dari kasir sebelum penomoran register diberlakukan, misalnya ORD-20260917-0004). Karena itu jangan menebak channel dari bentuk nomor; baca kolom CHANNEL.

Kapan Anda perlu memahaminya#

• Saat mencocokkan struk pelanggan dengan data di Backoffice.
• Saat mencari transaksi: ketik sebagian nomor (misalnya KSR02 atau 20261015) pada kolom pencarian (Cara Mencari dan Menyaring Pesanan).
• Saat tanggal pada nomor tampak berbeda dari TANGGAL pada daftar.

Cara kerja dari perspektif pengguna#

• Transaksi kasir. Aplikasi kasir pada register tertentu menerbitkan nomor: tanggal bisnis, kode register, lalu urutan yang naik per register per hari. Server memeriksa bahwa nomor itu sesuai register dan tanggal bisnis serta menolak nomor yang sudah dipakai. Karena kode register ada di nomor, dua register tidak bentrok.
• Transaksi Backoffice. Nomor berurutan per hari dan per outlet, tanpa kode register. Pada versi Backoffice terbaru, tanggal pada nomor memakai tanggal bisnis outlet, yaitu tanggal pada zona waktu outlet saat pesanan dibuat. Bila zona waktu outlet tidak dapat dipastikan, pesanan tidak dibuat.
• Nomor lama. Pesanan Back-Office lama memakai tanggal server dalam UTC pada nomornya. Akibatnya untuk transaksi dini hari WIB tanggal pada nomor bisa tertinggal satu hari dari hari transaksi.
• Hari transaksi sebenarnya selalu dibaca dari Waktu transaksi pada detail atau kolom TANGGAL, bukan dari nomor.

Contoh operasional#

Dari 32 pesanan pada tenant contoh, 14 memiliki tanggal pada nomor yang berbeda satu hari dari Waktu transaksi lokalnya. Semuanya nomor lama tanpa kode register, misalnya ORD-20261014-0001 yang Waktu transaksi-nya 15/10/2026 06:35 (tanggal UTC-nya 14 Oktober), dan ORD-20260916-0003 yang waktunya 17/09/2026 00:04. Pesanan yang nomornya memuat kode register, seperti ORD-20261009-KSR02-0001 (09/10/2026 01:34), selalu cocok dengan hari lokal. Selisih pada nomor lama bukan kerusakan data: nomornya memang diterbitkan dengan aturan lama. Tidak ada pesanan baru yang dibuat untuk pengujian, jadi aturan tanggal bisnis outlet pada nomor Back-Office baru belum teramati di layar.

Klik untuk memperbesar

Ketentuan penting#

1. Nomor pesanan unik per tenant dan outlet; satu nomor tidak dipakai dua kali.
2. Pada channel POS, nomor berasal dari register dan tidak diubah server. Server menolak transaksi POS yang nomornya tidak sesuai register atau tanggal bisnis.
3. Backoffice menampilkan nomor apa adanya; tidak ada layar untuk mengubah nomor.
4. Anda dapat membuka detail langsung dengan nomor pada alamat halaman (/orders/<nomor>), dengan syarat nomor persis sama.
5. Tanggal dan kode pada nomor adalah penanda, bukan bukti waktu. Waktu transaksi yang sah ada di kepala halaman detail (Memahami Tanggal dan Waktu Transaksi).
6. Jangan menganggap selisih tanggal pada nomor lama sebagai bug yang masih aktif. Jangan pula menyimpulkan nomor baru pasti benar tanpa memeriksanya setelah pesanan dibuat.