Pesantren OS
⚙️ Pengaturan

Penomoran Invoice & Surat

Panduan standardisasi pola penomoran otomatis (sequence numbering) dokumen keuangan dan persuratan resmi di platform Pesantren OS menggunakan token variabel dinamis.

Terakhir diperbarui:
  • format penomoran invoice otomatis
  • penomoran surat resmi pesantren
  • nomor invoice otomatis
  • penomoran dokumen pesantren
  • format nomor surat sekolah
  • kustomisasi nomor tagihan
  • software administrasi pesantren

Setiap dokumen finansial dan surat dinas resmi yang diterbitkan oleh sistem akan diberikan nomor identifikasi unik (unique identifier) secara otomatis. Walaupun sistem telah menyediakan konfigurasi standar (default sequence patterns), manajemen instansi diberikan kebebasan penuh untuk melakukan personalisasi struktur pola penomoran agar selaras dengan regulasi kearsipan internal lembaga.

Skema Format Standar Sistem (Default Sequence Patterns)

Sistem mengadopsi standarisasi penomoran dokumen bawaan sebagai berikut:

Kategori Dokumen LegalSkema Pola BawaanRepresentasi Contoh Hasil
Invoice / Nota TagihanINV-YYYY-####INV-2026-0001
Surat Keterangan AktifSK/YYYY/MM/####SK/2026/06/0001
Surat Mutasi KeluarMK/YYYY/MM/####MK/2026/06/0001
Surat Izin Keluar (a.n. Santri)IK/YYYY/MM/####IK/2026/06/0001

Setiap klasifikasi jenis surat dikonfigurasi dengan mesin penghitung (counter engine) mandiri yang terisolasi, sehingga urutan nomor dokumen antar-kategori tidak akan saling tumpang tindih.

📌 Catatan: Baris di atas mengatur penomoran Modul Surat. Fitur perizinan santri di Modul Asrama (izin pulang/keluar pondok) memakai penomoran tersendiri dengan pola bawaan IZIN-YYYY-#### (contoh IZIN-2026-0001) — terpisah dari nomor Surat Izin Keluar di atas.

Pustaka Komponen Token Variabel

Formulasi pola penomoran otomatis disusun dengan mengombinasikan token dinamis di bawah ini. Segala bentuk karakter alfanumerik atau simbol di luar daftar token akan dibaca secara literal sebagai teks statis, kode instansi, atau karakter pemisah.

Token SintaksParameter OutputHasil Konversi Sistem
YYYYTahun berjalan format empat digit2026
YYTahun berjalan format dua digit26
MMBulan berjalan format dua digit (dengan angka nol)06
MBulan berjalan tanpa angka nol di depan6
###Nomor urut otomatis kapasitas tiga digit (counter)001, 002, …
####Nomor urut otomatis kapasitas empat digit (counter)0001, 0002, …

Pengurus memiliki diskresi penuh untuk merancang urutan tata letak token serta menentukan jenis karakter pemisah logis, seperti garis miring (/), tanda hubung (-), atau titik (.). Kode referensi jenis dokumen (misalnya: SK, INV, NOTA) cukup diinput sebagai teks statis di dalam kolom pola penomoran.

Regulasi Finansial (SaaS Rule): Token variabel bulan (M/MM) hanya diproses pada klaster sistem persuratan. Pada pola invoice keuangan, sistem hanya mengenali token tahun (Y) dan nomor urut (#) — token M/MM di pola invoice akan tercetak apa adanya sebagai teks literal (mis. “MM”), bukan angka bulan. Karena itu untuk invoice gunakan hanya kombinasi token tahun berjalan dan nomor urut demi menjaga keabsahan pelaporan pajak dan keuangan.

Studi Kasus Formulasi Pola Dokumen

Berikut adalah beberapa implementasi kombinasi sintaks pola beserta output dokumen yang dihasilkan oleh sistem:

Formulasi Pola SintaksRepresentasi Output Dokumen
INV-YYYY-####INV-2026-0007
SK/YYYY/MM/###SK/2026/06/012
YYYY.MM.###2026.06.003
SR-YY-####SR-26-0021

Prosedur Mengubah Format Penomoran

  1. Masuk ke dasbor admin, lalu akses menu pengaturan skema penomoran melalui Sistem → Pengaturan → Format Penomoran.
  2. Pilih klaster entitas dokumen yang ingin disesuaikan, seperti Invoice Keuangan atau sub-kategori Jenis Surat tertentu.
  3. Input formulasi kombinasi pola baru menggunakan pustaka token di atas. Manfaatkan fitur Pratinjau Instan (Real-time Preview) pada layar untuk memvalidasi akurasi format sebelum diterapkan.
  4. Klik Simpan Perubahan.

Mekanisme Kerja Mesin Penghitung (Counter Engine Logic)

  • Invoice Tagihan: Sistem menerapkan mekanisme penghitung tunggal berskala tahunan berkelanjutan per tenant instansi. Reset nomor urut otomatis (auto-reset counter) dieksekusi sekali setahun pada pergantian tahun kalender.
  • Surat Resmi: Beroperasi menggunakan mesin penghitung mandiri per kategori surat. Apabila formulasi pola surat menyertakan token bulan (MM/M), sistem secara otomatis akan melakukan reset nomor urut ke angka 001 setiap pergantian bulan baru. Jika pola hanya memuat token tahun (YYYY), siklus reset berjalan sekali setahun.
  • Validasi Alokasi Nomor: Nomor urut resmi dokumen hanya akan dialokasikan secara permanen pada saat dokumen diterbitkan secara sah (Published/Approved) oleh pejabat berwenang, bukan pada saat dokumen masih berada dalam status draf (Draft State). Hal ini untuk menghindari adanya kekosongan nomor urut arsip (sequence gaps).

Regulasi dan Kebijakan Standardisasi Penomoran

Apabila modifikasi format penomoran dieksekusi di tengah periode berjalan, dokumen historis lama akan tetap mempertahankan format lamanya, sedangkan dokumen baru akan diproduksi dengan format baru. Kondisi ini berpotensi mempersulit proses audit kearsipan. Demi menjaga konsistensi integritas data, mohon perhatikan regulasi berikut:

  • Lakukan sinkronisasi atau pembaruan format penomoran secara eksklusif hanya pada momentum awal tahun ajaran baru atau pergantian tahun kalender.
  • Lakukan sosialisasi dan koordinasi kepada seluruh staf operator tata usaha dan bendahara sebelum perubahan skema pola diaktifkan pada sistem.
  • Hindari perumusan susunan pola yang terlalu panjang dan kompleks agar nomor identifikasi dokumen tetap mudah diidentifikasi, ditelusuri, dan diverifikasi oleh pemangku kepentingan (stakeholders).