title: “Purchase Order” description: “Purchase order dengan approval workflow, partial receiving, supplier integration, dan tracking end-to-end.”

Purchase Order

Purchase Order (PO) adalah modul untuk memesan bahan baku dari supplier secara terstruktur. Setiap PO melewati workflow approval, bisa diterima secara parsial (sebagian), dan terintegrasi langsung dengan Supplier Management dan Stock Management. Sistem ini memastikan setiap pembelian tercatat, terkontrol, dan bisa dipertanggungjawabkan.

Arsitektur Purchase Order

Status PO — Lifecycle Lengkap

Status	Ikon	Deskripsi	Aksi Selanjutnya
Draft	📝	Belum diajukan, masih bisa diedit	Submit untuk approval
Pending Approval	⏳	Menunggu persetujuan approver	Approve atau Reject
Approved	✅	Disetujui, siap dikirim ke supplier	Kirim ke supplier
Sent	📤	Sudah dikirim ke supplier, menunggu barang	Terima barang
Partial Received	📦	Barang diterima sebagian	Terima sisa atau close
Full Received	✅	Semua barang diterima lengkap	Stock in otomatis
Rejected	❌	Ditolak oleh approver	Revisi dan submit ulang
Closed	🔒	PO ditutup (manual atau otomatis)	Tidak ada aksi

Field PO — Detail Lengkap

Header PO

Field	Tipe	Wajib	Deskripsi
PO Number	Auto	Ya	Format: PO-- (contoh: PO-20261010-001)
Supplier	Dropdown	Ya	Pilih dari database supplier
Tanggal PO	Date	Ya	Tanggal pembuatan
Expected Delivery	Date	Ya	Perkiraan tanggal barang tiba
Payment Terms	Dropdown	Tidak	Cash, Net 7, Net 14, Net 30
Shipping Method	Dropdown	Tidak	Pickup, Delivery, Courier
Notes	Text	Tidak	Catatan untuk supplier
Total	Auto-calc	-	Jumlah total semua item

Line Items

Field	Tipe	Wajib	Deskripsi
Produk	Dropdown	Ya	Pilih dari katalog (bahan baku / produk)
Quantity	Number	Ya	Jumlah yang dipesan
Unit	Auto	-	Satuan (kg, liter, pcs, box)
Harga per Unit	Number	Ya	Harga satuan (auto-fill dari katalog supplier)
Subtotal	Auto-calc	-	Quantity x Harga
Discount	Number	Tidak	Diskon per item (%)
Notes	Text	Tidak	Catatan per item

Workflow Approval

Konfigurasi	Default	Bisa Diubah
Approver	Owner	Ya, bisa multi-level
Auto-approve threshold	PO < Rp500.000	Ya
Approval SLA	24 jam	Ya
Escalation	Notifikasi reminder setiap 12 jam	Ya

Penerimaan Barang (Receiving)

Partial Receiving

Sistem mendukung penerimaan parsial — kamu bisa menerima sebagian barang terlebih dahulu jika belum semua item tersedia:

Proses Penerimaan

Step	Aksi	Detail
1	Buka PO yang statusnya “Sent”	Lihat daftar item yang dipesan
2	Input quantity diterima per item	Bisa kurang dari qty yang dipesan
3	Catat kondisi barang	Normal, rusak, tidak sesuai
4	Upload foto (opsional)	Bukti kondisi barang
5	Submit penerimaan	Status berubah sesuai qty diterima
6	Stock in otomatis	Stok bertambah di lokasi yang ditentukan

Field Penerimaan

Field	Deskripsi
Quantity Diterima	Jumlah item yang benar-benar diterima
Quantity Ordered	Jumlah yang dipesan (reference)
Quantity Outstanding	Selisih: ordered - received
Kondisi	Normal / Damaged / Wrong Item
Batch Number	Nomor batch dari supplier
Expiry Date	Tanggal kadaluarsa (untuk bahan baku)
Lokasi Tujuan	Gudang mana barang disimpan
Notes	Catatan kondisi atau temuan

Perbandingan Ordered vs Received

Item	Ordered	Received	Outstanding	Status
Cabai Merah (kg)	100	100	0	Complete
Bawang Putih (kg)	50	45	5	Partial
Minyak Goreng (liter)	30	30	0	Complete
Kemasan Pouch (pcs)	500	0	500	Pending

Riwayat & Filter

Filter	Opsi	Fungsi
Status	Draft, Pending, Approved, Sent, Partial, Full, Rejected, Closed	Filter berdasarkan tahap
Supplier	Nama supplier	Filter per supplier
Tanggal	Date range	Filter periode pembuatan PO
Total Value	Range nilai	Filter berdasarkan nilai PO

Integrasi dengan Modul Lain

Modul	Integrasi	Arah
Supplier Management	Data supplier, harga katalog, rating	Supplier → PO
Stock Management	Stock in otomatis saat barang diterima	PO → Stock
Keuangan	Hutang usaha, pembayaran, budget tracking	PO → Finance
Manufacturing	Kebutuhan bahan baku memicu rekomendasi PO	Manufacturing → PO

Cetak & Kirim PO

Aksi	Format	Detail
Cetak PDF	PDF	PO lengkap dengan kop perusahaan, detail item, total
Kirim Email	Email + PDF attachment	Langsung ke email supplier
WhatsApp	Text summary	Ringkasan PO via WA
Export CSV	CSV	Untuk arsip atau integrasi eksternal

Tips

Gunakan data stok minimum dari Stock Management sebagai acuan quantity pemesanan — jangan memesan berdasarkan perkiraan.
Dokumentasikan setiap penerimaan dengan foto jika ada barang yang rusak atau tidak sesuai, supaya mudah diklaim ke supplier.
Evaluasi supplier secara berkala berdasarkan ketepatan waktu pengiriman dan kualitas barang yang tercatat di riwayat PO.
Manfaatkan partial receiving — jangan menunggu semua barang datang jika sebagian sudah bisa digunakan untuk produksi.

Entity Relationship Diagram (ERD)

Diagram berikut menggambarkan relasi antar entitas utama yang terlibat dalam alur Purchase Order — mulai dari Supplier sebagai sumber bahan baku, Purchase Order sebagai dokumen pemesanan, StockMovement sebagai pencatatan pergerakan barang, hingga CompanyPOSInventory sebagai audit trail stok di level POS.

Penjelasan Relasi

Relasi	Kardinalitas	Deskripsi
Supplier → PurchaseOrder	1 : N	Satu supplier bisa memiliki banyak PO. Setiap PO wajib merujuk ke satu supplier.
PurchaseOrder → PurchaseOrderItem	1 : N	Satu PO berisi minimal satu line item (produk yang dipesan).
PurchaseOrder → StockMovement	1 : N	Saat barang diterima, sistem membuat satu atau lebih StockMovement bertipe `in` dengan `reference_type = "purchase"` dan `reference_id`指向 ID PO.
StockMovement → CompanyPOSInventory	N : 1	Setiap StockMovement tercatat juga sebagai audit trail di CompanyPOSInventory agar stok di level POS selalu konsisten.
Supplier → StockMovement	Referensi	StockMovement bisa merujuk supplier sebagai sumber asal barang untuk keperluan traceability.

Entity Schema Lengkap

Schema: PurchaseOrder

Berikut adalah seluruh field yang tersimpan di entitas PurchaseOrder, sesuai definisi di base44/entities/PurchaseOrder.jsonc.

Field	Tipe	Wajib	Default	Enum / Format	Deskripsi
`company_id`	string	Ya	—	—	ID perusahaan pemilik PO. Digunakan untuk multi-tenancy dan Row-Level Security (RLS).
`po_number`	string	Tidak	—	Format: `PO-{YYYYMMDD}-{seq}`	Nomor PO unik yang di-generate otomatis oleh sistem. Contoh: `PO-20261010-001`.
`supplier_id`	string	Ya	—	—	ID supplier yang menjadi tujuan pemesanan. Merujuk ke entitas `Supplier`.
`supplier_name`	string	Tidak	—	—	Nama supplier (denormalized). Disimpan langsung di PO agar tidak perlu join setiap kali ditampilkan.
`po_date`	date	Ya	—	ISO 8601	Tanggal pembuatan PO. Menjadi acuan periode pembelian dan jatuh tempo pembayaran.
`expected_delivery_date`	date	Tidak	—	ISO 8601	Perkiraan tanggal barang tiba dari supplier. Digunakan untuk monitoring ketepatan pengiriman.
`items`	array<object>	Ya	—	—	Daftar line item / produk yang dipesan. Setiap item memiliki sub-field: `product_id`, `product_name`, `quantity`, `unit`, `unit_price`, `total_price`, `received_quantity`.
`items[].product_id`	string	Ya (per item)	—	—	ID produk yang dipesan. Merujuk ke katalog produk/bahan baku.
`items[].product_name`	string	Ya (per item)	—	—	Nama produk (denormalized).
`items[].quantity`	number	Ya (per item)	—	—	Jumlah yang dipesan dalam satuan yang tertera.
`items[].unit`	string	Ya (per item)	—	—	Satuan: kg, liter, pcs, box, dus, dll.
`items[].unit_price`	number	Ya (per item)	—	—	Harga satuan. Bisa di-auto-fill dari katalog harga supplier.
`items[].total_price`	number	Ya (per item)	—	—	`quantity × unit_price`. Dihitung otomatis.
`items[].received_quantity`	number	Tidak	`0`	—	Jumlah yang sudah diterima. Digunakan untuk menghitung outstanding dan menentukan status `received_status`.
`subtotal`	number	Tidak	`0`	—	Jumlah total semua `total_price` sebelum pajak dan ongkir.
`tax_amount`	number	Tidak	`0`	—	Jumlah pajak (PPN 11% atau sesuai konfigurasi).
`shipping_cost`	number	Tidak	`0`	—	Biaya pengiriman / ongkos kirim.
`total_amount`	number	Tidak	—	—	`subtotal + tax_amount + shipping_cost`. Nilai total yang harus dibayarkan.
`status`	string	Tidak	`"draft"`	`draft`, `sent`, `confirmed`, `received`, `invoiced`, `cancelled`	Status utama PO dalam lifecycle pemesanan.
`received_status`	string	Tidak	`"pending"`	`pending`, `partially_received`, `fully_received`	Status penerimaan barang. Berubah saat user melakukan receiving.
`notes`	string	Tidak	—	—	Catatan umum untuk PO (instruksi khusus, permintaan supplier, dll).

Required fields: company_id, supplier_id, po_date, items

Schema: Supplier

Berikut adalah seluruh field yang tersimpan di entitas Supplier, sesuai definisi di base44/entities/Supplier.jsonc.

Field	Tipe	Wajib	Default	Enum / Format	Deskripsi
`company_id`	string	Ya	—	—	ID perusahaan pemilik data supplier.
`supplier_code`	string	Tidak	—	—	Kode unik supplier. Di-generate otomatis atau diinput manual.
`company_name`	string	Ya	—	—	Nama perusahaan supplier. Wajib diisi saat pembuatan.
`contact_person`	string	Tidak	—	—	Nama kontak person di supplier.
`email`	string	Tidak	—	email format	Alamat email supplier untuk pengiriman PO dan notifikasi.
`phone`	string	Tidak	—	—	Nomor telepon / WhatsApp supplier.
`address`	string	Tidak	—	—	Alamat lengkap supplier.
`city`	string	Tidak	—	—	Kota domisili supplier.
`country`	string	Tidak	—	—	Negara (default Indonesia).
`tax_id`	string	Tidak	—	—	NPWP atau Tax ID supplier. Diperlukan untuk faktur pajak.
`bank_account`	string	Tidak	—	—	Nomor rekening bank supplier.
`bank_name`	string	Tidak	—	—	Nama bank tempat rekening supplier.
`payment_terms`	string	Tidak	—	`NET 30`, `NET 14`, `NET 7`, `COD`, `CBD`	Syarat pembayaran yang disepakati.
`currency`	string	Tidak	`"IDR"`	ISO 4217	Mata uang transaksi. Default Rupiah (IDR).
`rating`	number	Tidak	—	1 – 5	Rating supplier berdasarkan kinerja pengiriman dan kualitas barang.
`is_active`	boolean	Tidak	`true`	—	Status aktif supplier. Supplier non-aktif tidak muncul di dropdown PO.
`is_locked`	boolean	Tidak	`false`	—	Data terkunci karena sudah ada PO aktif. Field nama, NPWP, dan rekening tidak bisa diedit sampai semua PO terkait selesai.
`validation_score`	number	Tidak	`0`	0 – 100	Skor kelengkapan data supplier. Dihitung otomatis berdasarkan field yang sudah terisi (NPWP, rekening, alamat, kontak, dll).
`supplier_type`	string	Tidak	`"general"`	`general`, `farmer`, `distributor`, `importer`	Klasifikasi tipe supplier. Mempengaruhi aturan penerimaan dan dokumen yang diperlukan.
`supplied_materials`	array<string>	Tidak	—	—	Daftar bahan baku / komoditas yang dipasok oleh supplier ini.
`last_validated_at`	datetime	Tidak	—	ISO 8601	Timestamp terakhir data supplier divalidasi.
`notes`	string	Tidak	—	—	Catatan tambahan tentang supplier.

Required fields: company_id, company_name

State Machine — Siklus Hidup Purchase Order

Diagram berikut menunjukkan seluruh transisi status yang valid untuk sebuah Purchase Order, dari pembuatan hingga penutupan. Setiap panah mewakili satu aksi yang bisa dilakukan oleh user atau sistem.

Tabel Transisi Status

Status Awal	Status Tujuan	Pemicu	Kondisi
`[*]`	`draft`	User klik “Buat PO”	Supplier dan minimal 1 item sudah dipilih
`draft`	`sent`	User klik “Submit & Kirim”	Validasi: items lengkap, harga terisi, total > 0
`draft`	`cancelled`	User klik “Batalkan”	Belum ada barang dikirim
`sent`	`confirmed`	Supplier konfirmasi (manual/otomatis)	PO sudah diterima supplier
`sent`	`cancelled`	Supplier tolak / user batalkan	Barang belum dikirim supplier
`confirmed`	`received`	User input receiving	Semua `received_quantity` = `quantity` → `received_status = fully_received`
`confirmed`	`received` (partial)	User input receiving sebagian	Beberapa item belum diterima → `received_status = partially_received`
`received`	`invoiced`	User verifikasi invoice	Cocokkan qty terima dengan invoice supplier
`invoiced`	`[*]`	PO ditutup otomatis	Semua item diterima dan invoice terbayar

Penjelasan Detail Lifecycle

Draft — PO masih dalam tahap penyusunan. User bisa menambah, mengubah, atau menghapus item. Belum ada notifikasi ke supplier. Total dihitung otomatis tapi belum final.
Sent — PO sudah dikirim ke supplier (via email, cetak PDF, atau WhatsApp). Data PO dikunci — tidak bisa diubah lagi. Supplier diharapkan memberikan konfirmasi penerimaan pesanan.
Confirmed — Supplier telah mengkonfirmasi pesanan. Tahap ini menandakan supplier siap mengirim barang sesuai PO. User mulai bisa melakukan receiving.
Received — Barang sudah diterima di gudang. Jika semua item diterima lengkap, received_status berubah menjadi fully_received. Jika sebagian, tetap partially_received dan user bisa menerima sisa di kemudian hari. Setiap penerimaan memicu pembuatan record StockMovement bertipe in.
Invoiced — Invoice dari supplier sudah dicatat dan diverifikasi. Nilai invoice dicocokkan dengan total PO dan barang yang benar-benar diterima. Tahap ini memicu pencatatan hutang di modul Keuangan.
Cancelled — PO dibatalkan, bisa karena supplier menolak, barang tidak tersedia, atau keputusan internal. PO yang sudah dibatalkan tidak bisa di-reopen.

Sequence Diagram — Alur Lengkap PO

1. Pembuatan PO (Creation)

2. Approval & Pengiriman ke Supplier

3. Penerimaan Barang (Receiving)

4. Stock Update & Audit Trail

Evaluasi & Klasifikasi Supplier

Sistem SNISHOP menyediakan mekanisme evaluasi supplier berbasis skor validasi dan klasifikasi tipe supplier. Kedua aspek ini membantu tim procurement membuat keputusan pembelian yang lebih baik.

Skor Validasi Supplier (`validation_score`)

Skor validasi dihitung otomatis berdasarkan kelengkapan data supplier. Skor ini membantu mengidentifikasi supplier mana yang datanya masih perlu dilengkapi sebelum bisa diproses secara penuh.

Komponen Dinilai	Bobot	Keterangan
Nama perusahaan (`company_name`)	15 poin	Wajib diisi. Tanpa nama perusahaan, supplier tidak bisa digunakan.
Kontak person (`contact_person`)	10 poin	Nama PIC yang bisa dihubungi terkait pesanan.
Email (`email`)	10 poin	Diperlukan untuk pengiriman PO otomatis via email.
Telepon (`phone`)	10 poin	Untuk komunikasi cepat dan konfirmasi pesanan.
Alamat lengkap (`address` + `city`)	10 poin	Diperlukan untuk kalkulasi ongkos kirim dan visit.
NPWP / Tax ID (`tax_id`)	15 poin	Diperlukan untuk penerbitan faktur pajak dan laporan SPT.
Rekening bank (`bank_account` + `bank_name`)	15 poin	Diperlukan untuk transfer pembayaran.
Syarat pembayaran (`payment_terms`)	5 poin	Membantu sistem menghitung jatuh tempo otomatis.
Tipe supplier (`supplier_type`)	5 poin	Klasifikasi untuk aturan penerimaan yang berbeda.
Bahan yang dipasok (`supplied_materials`)	5 poin	Memudahkan pencarian supplier berdasarkan bahan baku.
TOTAL MAKSIMAL	100 poin	Skor 100 = data supplier lengkap dan siap digunakan.

Interpretasi Skor

Range Skor	Kategori	Tindakan yang Disarankan
80 – 100	Lengkap	Supplier siap digunakan untuk PO. Semua data penting terisi.
60 – 79	Cukup	Bisa digunakan, tapi lengkapi field yang kosong sebelum PO pertama.
40 – 59	Kurang	Prioritaskan melengkapi data. Hubungi supplier untuk minta informasi yang hilang.
0 – 39	Tidak lengkap	Jangan buat PO dari supplier ini. Data terlalu berisiko untuk transaksi.

Klasifikasi Tipe Supplier (`supplier_type`)

Tipe supplier menentukan aturan penerimaan dan dokumen yang diperlukan saat barang tiba di gudang.

Tipe	Kode	Deskripsi	Aturan Penerimaan Khusus
General	`general`	Supplier umum / toko bahan baku	Penerimaan standar. Cek qty dan kondisi visual.
Farmer	`farmer`	Petani / produsen langsung	Cek kualitas bahan segar (kesegaran, kadar air, ukuran). Wajib input `expiry_date` dan `batch_number`. Toleransi berat +/- 5%.
Distributor	`distributor`	Distributor / agen resmi	Cek kemasan utuh, label, dan sertifikat halal/BPOM jika diperlukan. Batch number wajib dicatat untuk traceability.
Importer	`importer`	Importir bahan baku luar negeri	Cek dokumen Bea Cukai, sertifikat asal barang (COO), dan label impor. Wajib verifikasi kesesuaian dengan spesifikasi yang disepakati.

Matriks Evaluasi Supplier Berkala

Selain skor validasi, evaluasi berkala dilakukan berdasarkan kinerja nyata supplier yang tercatat di riwayat PO.

Kriteria	Bobot	Cara Hitung	Target
Ketepatan Waktu	30%	% PO yang tiba sesuai `expected_delivery_date`	>= 85%
Kualitas Barang	25%	% penerimaan dengan kondisi “normal” (tidak rusak/salah)	>= 95%
Kelengkapan Qty	20%	% PO yang diterima fully tanpa outstanding	>= 90%
Responsivitas	15%	Rata-rata waktu konfirmasi PO setelah dikirim	< 24 jam
Harga Kompetitif	10%	Perbandingan harga vs rata-rata pasar untuk bahan yang sama	Dalam range +/- 5%

Schema: StockMovement (Detail Lengkap)

Entitas StockMovement adalah tulang punggung audit trail stok. Setiap kali stok berubah — baik karena pembelian, penjualan, produksi, transfer, atau adjustment — satu record StockMovement dibuat.

Field	Tipe	Wajib	Default	Enum / Format	Deskripsi
`company_id`	string	Ya	—	—	ID perusahaan. Untuk multi-tenancy.
`inventory_id`	string	Ya	—	—	ID record inventory yang berubah.
`product_id`	string	Tidak	—	—	ID produk.
`product_sku`	string	Tidak	—	—	SKU produk untuk identifikasi cepat.
`product_type`	string	Tidak	—	—	Tipe produk (bahan baku, produk jadi, kemasan).
`identity_status`	string	Tidak	—	`linked`, `legacy_review`	Status identitas produk. `linked` = sudah terhubung ke katalog. `legacy_review` = perlu review manual.
`source_material_id`	string	Tidak	—	—	ID material asal (untuk traceability bahan baku).
`product_name`	string	Tidak	—	—	Nama produk (denormalized).
`category_key`	string	Tidak	—	—	Key kategori produk.
`category_name`	string	Tidak	—	—	Nama kategori (denormalized).
`variant_key`	string	Tidak	—	—	Key varian produk.
`variant_name`	string	Tidak	—	—	Nama varian (denormalized).
`base_product_key`	string	Tidak	—	—	Key produk dasar (untuk produk dengan varian).
`variant_label`	string	Tidak	—	—	Label varian (misalnya “Ukuran Besar”, “Rasa Original”).
`size_grams`	number	Tidak	—	—	Ukuran produk dalam gram (untuk produk F&B).
`location_id`	string	Tidak	—	—	ID lokasi gudang tempat stok berada.
`location_name`	string	Tidak	—	—	Nama lokasi (denormalized).
`movement_type`	string	Ya	—	`in`, `out`, `transfer`, `adjustment`, `return`, `damaged`, `hold`, `hold_release`	Tipe pergerakan stok. `hold` dan `hold_release` bersifat informasional (blokir lot untuk QC) dan tidak mengubah jumlah on-hand.
`quantity`	number	Ya	—	—	Jumlah perubahan stok. Positif untuk `in`, negatif untuk `out`.
`stock_before`	number	Tidak	—	—	Jumlah stok sebelum pergerakan.
`stock_after`	number	Tidak	—	—	Jumlah stok setelah pergerakan.
`reference_type`	string	Tidak	—	`purchase`, `sale`, `cashier_sale`, `production`, `raw_material_outbound`, `qc_release`, `transfer`, `adjustment`, `opname_adjustment`, `return`, `manual`, `distribution_shipment`, `quality_hold`	Sumber / penyebab perubahan stok. Untuk PO yang diterima, nilainya `purchase`.
`lot_id`	string	Tidak	—	—	ID lot/batch untuk traceability. Penting untuk produk F&B yang perlu tracking tanggal kadaluarsa.
`lot_number`	string	Tidak	—	—	Nomor label lot/batch fisik pada kemasan.
`reference_id`	string	Tidak	—	—	ID transaksi terkait. Untuk penerimaan PO, field ini berisi ID PurchaseOrder.
`from_location_id`	string	Tidak	—	—	Lokasi asal (untuk movement tipe `transfer`).
`to_location_id`	string	Tidak	—	—	Lokasi tujuan (untuk movement tipe `transfer`).
`reason`	string	Tidak	—	—	Alasan perubahan stok.
`override_reason`	string	Tidak	—	—	Alasan jika pemilihan lot menyimpang dari urutan FIFO standar (rule FIFO-03).
`allocation_strategy`	string	Tidak	—	—	Strategi alokasi yang digunakan: `fifo`, `fefo`, atau `manual`.
`unit_cost`	number	Tidak	`0`	—	Harga modal per unit saat transaksi terjadi.
`total_value`	number	Tidak	`0`	—	`quantity × unit_cost` — nilai modal total.
`sales_channel`	string	Tidak	—	—	Nama channel penjualan (Shopee, TikTok, WhatsApp, Indomaret, B2B, dll).
`channel_price_key`	string	Tidak	—	—	Key pricing channel dari CompanyPOSProduct.
`unit_price`	number	Tidak	`0`	—	Harga jual per unit (dinamis per channel).
`total_revenue`	number	Tidak	`0`	—	`quantity × unit_price` — pendapatan penjualan.
`total_cost`	number	Tidak	`0`	—	`quantity × unit_cost` — total modal.
`profit`	number	Tidak	`0`	—	`total_revenue - total_cost` — laba/rugi.
`profit_margin`	number	Tidak	`0`	—	`profit / total_revenue × 100` — margin laba dalam persen.
`performed_by`	string	Tidak	—	—	Email user yang melakukan pergerakan stok.
`performed_by_name`	string	Tidak	—	—	Nama lengkap user (denormalized).
`notes`	string	Tidak	—	—	Catatan tambahan.
`idempotency_key`	string	Tidak	—	—	Retry identity untuk mencegah duplikasi pergerakan stok.
`created_by`	string	Tidak	—	—	Authenticated actor ID.
`metadata`	object	Tidak	—	—	Command correlation metadata untuk audit trail.

Required fields: company_id, inventory_id, movement_type, quantity

Tipe Pergerakan Stok (`movement_type`)

Tipe	Pengaruh pada Stok	Deskripsi
`in`	Menambah	Barang masuk — dari pembelian PO, retur penjualan, atau produksi.
`out`	Mengurangi	Barang keluar — untuk penjualan, produksi (bahan baku terpakai), atau distribusi.
`transfer`	Netral	Perpindahan antar lokasi gudang. Stok di lokasi asal berkurang, di lokasi tujuan bertambah.
`adjustment`	+/-	Penyesuaian manual — hasil stock opname atau koreksi selisih.
`return`	Menambah	Retur barang dari supplier atau retur penjualan dari customer.
`damaged`	Mengurangi	Barang rusak / tidak bisa dijual. Stok berkurang tapi tetap tercatat untuk audit.
`hold`	Netral	Blokir lot untuk Quality Control. Stok on-hand tidak berubah, tapi lot ditandai sebagai “ditahan”.
`hold_release`	Netral	Lepaskan blokir lot setelah QC selesai. Lot kembali tersedia untuk digunakan.

Schema: CompanyPOSInventory (Detail Lengkap)

Entitas ini berfungsi sebagai audit trail stok di level POS (Point of Sale). Setiap perubahan stok tercatat di sini agar sistem POS selalu memiliki data stok real-time.

Field	Tipe	Wajib	Default	Enum	Deskripsi
`company_id`	string	Ya	—	—	ID perusahaan.
`product_id`	string	Ya	—	—	ID produk.
`product_name`	string	Tidak	—	—	Nama produk (denormalized).
`type`	string	Ya	—	`in`, `out`, `adjustment`	Tipe pergerakan: masuk, keluar, atau penyesuaian.
`quantity`	number	Ya	—	—	Jumlah perubahan stok.
`stock_before`	number	Tidak	—	—	Stok sebelum perubahan.
`stock_after`	number	Tidak	—	—	Stok setelah perubahan.
`reason`	string	Tidak	—	—	Alasan perubahan (pembelian, penjualan, rusak, dll).
`reference_id`	string	Tidak	—	—	ID transaksi terkait (PO, SO, Transfer).
`notes`	string	Tidak	—	—	Catatan tambahan.
`performed_by`	string	Tidak	—	—	User yang melakukan perubahan.

Required fields: company_id, product_id, type, quantity

Ringkasan Alur Data End-to-End

Diagram berikut merangkum bagaimana data mengalir dari pembuatan PO hingga stok terupdate di sistem POS:

Catatan Implementasi

Denormalisasi: Field seperti supplier_name, product_name, location_name disimpan langsung di entitas terkait untuk menghindari join berulang saat query. Ini trade-off antara konsistensi data dan performa baca.
Idempotency: Setiap StockMovement memiliki idempotency_key untuk mencegah duplikasi jika ada retry pada proses penerimaan barang.
Row-Level Security (RLS): Semua entitas menggunakan RLS berdasarkan company_id untuk memastikan setiap perusahaan hanya melihat datanya sendiri.
Traceability Lot: Field lot_id dan lot_number di StockMovement memungkinkan pelacakan batch dari supplier hingga ke produk jadi — penting untuk standar HACCP dan recall produk.
FIFO/FEFO: Strategi alokasi (fifo atau fefo) dicatat di setiap StockMovement keluar untuk audit kepatuhan terhadap prosedur pengeluaran stok.

​title: “Purchase Order” description: “Purchase order dengan approval workflow, partial receiving, supplier integration, dan tracking end-to-end.”

​Purchase Order

​Arsitektur Purchase Order

​Status PO — Lifecycle Lengkap

​Field PO — Detail Lengkap

​Header PO

​Line Items

​Workflow Approval

​Penerimaan Barang (Receiving)

​Partial Receiving

​Proses Penerimaan

​Field Penerimaan

​Perbandingan Ordered vs Received

​Riwayat & Filter

​Integrasi dengan Modul Lain

​Cetak & Kirim PO

​Tips

​Entity Relationship Diagram (ERD)

​Penjelasan Relasi

​Entity Schema Lengkap

​Schema: PurchaseOrder

​Schema: Supplier

​State Machine — Siklus Hidup Purchase Order

​Tabel Transisi Status

​Penjelasan Detail Lifecycle

​Sequence Diagram — Alur Lengkap PO

​1. Pembuatan PO (Creation)

​2. Approval & Pengiriman ke Supplier

​3. Penerimaan Barang (Receiving)

​4. Stock Update & Audit Trail

​Evaluasi & Klasifikasi Supplier

​Skor Validasi Supplier (validation_score)

​Interpretasi Skor

​Klasifikasi Tipe Supplier (supplier_type)

​Matriks Evaluasi Supplier Berkala

​Schema: StockMovement (Detail Lengkap)

​Tipe Pergerakan Stok (movement_type)

​Schema: CompanyPOSInventory (Detail Lengkap)

​Ringkasan Alur Data End-to-End

​Catatan Implementasi