Yang bisa dilakukan operator

Masuk (login)

Beranda

Stock Opname (hitung stok fisik)

Delivery Note (kirim dari Sales Order)

Purchase Receipt (terima dari Purchase Order)

Material Request (minta barang)

• Tipe: Purchase, Transfer, Issue, atau Manufacture.
• Bisa dibuat kosong lalu scan barang, atau langsung dari laporan Perlu Restock (qty terisi otomatis dari reorder rule).
• Pilih tanggal dibutuhkan → Kirim MR → konfirmasi.

Menu Material Request langsung membuka form pembuatan MR baru — sama seperti Delivery Note, tidak lagi lewat daftar perantara. Ikon jam di kanan atas membuka Riwayat Material Request lengkap dengan filter. Kalau doctype ini diatur lewat Workflow, dokumen tidak langsung jadi — lihat Persetujuan.

Transfer Gudang (pindah stok antar gudang)

Repack (ubah barang jadi barang lain)

1. Pilih gudang asal dan tujuan (boleh sama).
2. Di bagian Barang dikonsumsi (merah): tambah barang yang dibongkar (mis. 1 karton).
3. Di bagian Barang dihasilkan (hijau): tambah barang hasilnya (mis. 24 eceran).
4. Ketuk Posting Repack.

Tidak ada selisih nilai. Nilai barang hasil dihitung otomatis oleh ERPNext dari total nilai barang yang dikonsumsi — jadi total nilai stok tetap sama, tidak ada "different amount". Diposting sebagai Stock Entry — Repack.

Ikon jam membuka Riwayat Repack (otomatis tersaring hanya repack).

Riwayat, Filter & Batalkan

Setiap layar transaksi punya ikon jam di kanan atas yang membuka Riwayat dokumen jenis itu — Delivery Note, Purchase Receipt, Material Request, Transfer, Repack, dan Stock Opname. Semua Riwayat bekerja sama.

Laporan

Batch, Serial & Saran FIFO

Persetujuan

Kalau sebuah doctype diatur lewat Workflow di ERPNext, aplikasi berhenti submit: dokumen disimpan draft dan didorong lewat aksi persetujuan. Diatur sepenuhnya di ERP — lihat Persetujuan (Workflow).

Pengaturan (di aplikasi)

Setting di ERPNext — WMS Settings

Buka /app/wms-settings (butuh role System Manager / Stock Manager). Aplikasi membaca ulang semua setelan ini setiap login, jadi perubahan langsung berlaku di semua handheld pada shift berikutnya — tanpa update APK.

Setting di ERPNext — Filter & halaman Riwayat

Masih di /app/wms-settings, bagian Riwayat Dokumen:

Jumlah per halaman

Field Jumlah per halaman (riwayat) — berapa dokumen dimuat sekali di layar Riwayat dan tiap "Muat lebih banyak". Default 20, boleh 5–200. Kalau kosong/0, aplikasi memakai 20.

Filter default

Tabel Filter default menentukan filter tambahan yang langsung aktif saat operator membuka Riwayat sebuah dokumen — mis. hanya status "To Bill". Operator tetap bisa menambah/menghapus filter sendiri di aplikasi.

Tanpa setelan apa pun, aplikasi sudah otomatis membuka Riwayat dengan filter tanggal bulan berjalan(chip Bulan ini yang bisa dihapus). Isi tabel ini hanya kalau ingin menambah filter default lain (status, gudang, dll.).

Contoh: baris Delivery Note · status · = · To Bill membuat Riwayat Delivery Note langsung menyaring hanya yang berstatus "To Bill". Tambah baris Purchase Receipt · posting_date · Timespan · this monthuntuk PR bulan berjalan.

Setting di ERPNext — Logo & warna aplikasi

Bagian Tampilan Aplikasi di WMS Settings mengubah wajah aplikasi tanpa build ulang APK:

Diambil ulang setiap login — ganti logo/warna sekali, semua handheld ikut berubah.

Setting di ERPNext — Field tambahan di form

Kalau Anda menambah Custom Field pada salah satu doctype yang diposting aplikasi (Stock Reconciliation, Delivery Note, Purchase Receipt, Material Request), field itu bisa muncul otomatis di form aplikasi — tanpa update APK.

Syaratnya, agar form aplikasi tidak penuh: field itu harus ditandai Mandatory (wajib) atau Bold. Aplikasi mengambil field ini saat login dan merendernya (Data, Select, Check, Date, Int, Float, dll.).

Contoh: tambah Custom Field No. Referensi (Mandatory) di Material Request → operator langsung diminta mengisinya di aplikasi. Field yang tidak wajib & tidak bold sengaja diabaikan agar layar tetap ringkas.

Setting di ERPNext — Batch barang masuk

Saat Purchase Receipt, nomor batch bisa diikuti dari supplier atau digenerate. Yang menentukan bukan satu tombol global, melainkan master data:

Default global-nya diatur di WMS Settings → Batch barang masuk (Purchase Receipt). Kalau batch digenerate sistem, nomornya ditampilkan di aplikasi setelah posting agar ditulis di kardus.

Setting di ERPNext — Teks aplikasi (WMS Labels)

Buka /app/wms-labels. Setiap teks di aplikasi punya key + teks bawaan. WMS Labels menyimpan overrideberbentuk JSON — isi hanya yang mau diubah:

{
  "menu.stock_opname": "Hitung Stok Fisik",
  "home.restock_alert": "{n} SKU di bawah batas aman",
  "app.name": "Gudang Pintar"
}

• Key yang dihapus otomatis kembali ke teks bawaan.
• JSON rusak / server mati tidak akan pernah membuat tombol kosong — paling buruk tampil seperti saat di-build.
• Lewat app.name aplikasi bisa di-rebrand per klien tanpa build ulang.

Setting di ERPNext — Persetujuan (Workflow)

Aplikasi membaca Workflow yang Anda buat di ERPNext dan menjalankannya persis. Ubah workflow di ERP, aplikasi ikut berubah pada login berikutnya.

• Buat Workflow, Workflow State, dan Workflow Action di ERPNext seperti biasa.
• Tentukan doctype mana yang butuh persetujuan, berapa tahap, dan siapa berwenang.
• Untuk mencegah setuju-sendiri, set allow_self_approval = 0 pada transisinya.

Persetujuan di aplikasi dibatasi ke dokumen stok saja (Stock Reconciliation, Delivery Note, Purchase Receipt, Material Request, Stock Entry) — workflow untuk dokumen ERP lain tidak ikut muncul di handheld.

Setting di ERPNext — Hak akses & izin Batalkan

User Permission & role

Aplikasi mengambil data lewat REST API, dan ERPNext menerapkan Role Permission & User Permission di sana. User yang dibatasi ke satu gudang hanya melihat gudang itu (ikut ke Bin, Stock Ledger, dst.). Batasi user seperti biasa — aplikasi mengikut.

Izin membatalkan dokumen

Tombol Batalkan dokumen di layar detail Riwayat hanya muncul kalau role user punya izin Cancel pada doctype tersebut, dan dokumen sudah submitted.

• Beri/lepas izin lewat Role Permissions Manager (/app/permission-manager): centang Cancel pada doctype + role yang boleh membatalkan.
• Operator biasa (mis. Stock User tanpa izin cancel) tidak akan melihat tombol itu.
• Pembatalan mengembalikan pergerakan stok (docstatus → Cancelled), sama seperti cancel di ERP.

Ini kontrol penuh di sisi ERP: yang menentukan siapa boleh membatalkan adalah role permission ERPNext, bukan aplikasi.