title: “Bill of Materials (BOM)” description: “Resep produksi lengkap dengan komponen, quantity, cost per unit, version control, dan auto-calculation untuk production orders.”

Bill of Materials (BOM)

Bill of Materials (BOM) adalah resep digital yang mendefinisikan secara persis bahan baku apa saja yang dibutuhkan, berapa quantity-nya, dan berapa biayanya untuk memproduksi satu unit produk jadi. BOM menjadi fondasi dari production planning, cost calculation, dan raw material consumption. Setiap perubahan resep tercatat dalam version control sehingga kamu bisa melacak kapan dan mengapa BOM berubah.

Arsitektur BOM

Entity Relationship Diagram

Diagram berikut menunjukkan relasi antar entitas inti dalam modul manufacturing SNISHOP ERP. BOM menjadi pusat yang menghubungkan produk jadi, bahan baku, production order, hingga lot batch dan pergerakan stok.

Ringkasan Relasi Utama

Relasi	Tipe	Keterangan
`CompanyPOSProduct` → `BillOfMaterials`	One-to-Many	Satu produk bisa punya banyak versi BOM, tapi hanya satu yang `active`
`BillOfMaterials` → `RawMaterial`	Many-to-Many	BOM merujuk banyak bahan baku via array `raw_materials[]`; satu bahan bisa dipakai di banyak BOM
`BillOfMaterials` → `ProductionOrder`	One-to-Many	Satu BOM bisa digunakan oleh banyak production order; BOM yang sudah dipakai akan `is_locked = true`
`ProductionOrder` → `LotBatch`	One-to-Many	Satu production order menghasilkan satu output lot (`output_lot_id`) dan mengonsumsi banyak input lot (`input_lot_ids[]`)
`ProductionOrder` → `HACCPVerification`	One-to-One	Setiap production order memiliki satu verifikasi HACCP
`ProductionOrder` → `HPPCalculation`	One-to-One	Setiap production order menghasilkan satu kalkulasi HPP
`LotBatch` → `Inventory`	One-to-Many	Satu lot tersimpan di satu atau lebih lokasi inventory
`Inventory` → `StockMovement`	One-to-Many	Setiap perubahan stok tercatat sebagai movement
`QualityCheck` → `RawMaterial`	Many-to-One	QC memeriksa bahan baku yang datang dari supplier

Complete Entity Schema — BillOfMaterials

Tabel berikut mendokumentasikan setiap field pada entitas BillOfMaterials beserta tipe data, kewajiban, nilai default, dan deskripsi lengkap.

Field Identitas & Produk Output

Field	Tipe	Wajib	Default	Deskripsi
`company_id`	`string`	Ya	-	ID perusahaan (multi-tenant). Setiap BOM terikat ke satu perusahaan.
`product_id`	`string`	Ya	-	ID produk jadi dari `CompanyPOSProduct` yang menjadi output BOM.
`product_sku`	`string`	Tidak	-	SKU master output, disnapshot dari produk pada saat BOM dibuat.
`product_type`	`string`	Tidak	-	Jenis produk output dari master (`finished_good`, `semi_finished`, dll).
`product_name`	`string`	Tidak	-	Nama produk output (snapshot).
`category_key`	`string`	Tidak	-	Kategori output snapshot: `kecil`, `besar`, `pouch`, `bundle`.
`category_name`	`string`	Tidak	-	Label kategori canonical.
`variant_key`	`string`	Tidak	-	Varian output snapshot: `original`, `extra_spicy`, `bundle`.
`variant_name`	`string`	Tidak	-	Label varian canonical.
`variant_label`	`string`	Tidak	-	Gabungan kategori dan varian untuk referensi POS/inventory/manufacturing.
`size_grams`	`number`	Tidak	-	Ukuran produk output dalam gram.
`base_product_key`	`string`	Tidak	-	Kunci produk utama sebelum kategori/varian.

Field Resep & Komponen

Field	Tipe	Wajib	Default	Deskripsi
`raw_materials`	`array<object>`	Ya	-	Daftar bahan baku yang dibutuhkan. Setiap item merujuk ke `RawMaterial` atau `CompanyPOSProduct`.
`raw_materials[].material_id`	`string`	-	-	ID bahan baku dari entitas `RawMaterial`.
`raw_materials[].product_id`	`string`	-	-	ID `CompanyPOSProduct` jika input berasal dari master produk.
`raw_materials[].product_type`	`string`	-	-	Tipe produk canonical bahan.
`raw_materials[].product_sku`	`string`	-	-	SKU bahan baku.
`raw_materials[].category_key`	`string`	-	-	Kategori canonical bahan.
`raw_materials[].category_name`	`string`	-	-	Label kategori bahan.
`raw_materials[].variant_key`	`string`	-	-	Varian canonical bahan.
`raw_materials[].variant_name`	`string`	-	-	Label varian bahan.
`raw_materials[].variant_label`	`string`	-	-	Label gabungan bahan.
`raw_materials[].size_grams`	`number`	-	-	Ukuran bahan dalam gram.
`raw_materials[].base_product_key`	`string`	-	-	Kunci produk utama bahan.
`raw_materials[].material_name`	`string`	-	-	Nama bahan baku (snapshot).
`raw_materials[].quantity_per_unit`	`number`	-	-	Jumlah bahan per 1 unit produk jadi.
`raw_materials[].unit`	`string`	-	-	Satuan bahan (gram, kg, ml, liter, pcs).
`raw_materials[].unit_cost`	`number`	-	-	Harga per satuan bahan pada saat BOM dibuat/diupdate.
`raw_materials[].total_cost`	`number`	-	-	`quantity_per_unit` x `unit_cost`.
`packaging_materials`	`array<object>`	Tidak	-	Daftar kemasan dan bahan pendukung yang dibutuhkan (MFG-02).
`packaging_materials[].material_id`	`string`	-	-	ID bahan kemasan.
`packaging_materials[].material_name`	`string`	-	-	Nama bahan kemasan (botol, segel, label, dll).
`packaging_materials[].quantity_per_unit`	`number`	-	-	Jumlah kemasan per unit produk jadi.
`packaging_materials[].unit`	`string`	-	-	Satuan kemasan (pcs, ml, lembar).
`packaging_materials[].unit_cost`	`number`	-	-	Harga per satuan kemasan.
`total_material_cost`	`number`	Tidak	-	Total biaya seluruh bahan baku per unit produk jadi.

Field Versi & Siklus Hidup

Field	Tipe	Wajib	Default	Deskripsi
`bom_version`	`string`	Tidak	-	Versi BOM untuk tracking perubahan internal.
`version`	`string`	Tidak	`"1.0"`	Versi BOM eksplisit (1.0, 1.1, 2.0, dst). Format: `X.Y` dimana X = major change, Y = minor change.
`status`	`enum`	Tidak	`"draft"`	Status siklus hidup BOM: `draft`, `active`, `archived`, `obsolete`.
`is_active`	`boolean`	Tidak	`true`	Flag cepat apakah BOM sedang aktif digunakan.
`is_locked`	`boolean`	Tidak	`false`	Apakah BOM sudah terkunci karena pernah digunakan berproduksi (MFG-02). BOM terkunci tidak bisa diedit langsung — harus clone ke versi baru.
`effective_date`	`date`	Tidak	-	Tanggal berlakunya BOM ini.
`parent_bom_id`	`string`	Tidak	-	ID versi BOM induk sebelum revisi/kloning. Membentuk chain versi.
`notes`	`string`	Tidak	-	Catatan perubahan atau informasi tambahan.

Field Konfigurasi Output & QC

Field	Tipe	Wajib	Default	Deskripsi
`output_type`	`enum`	Tidak	`"finished_good"`	Tipe output BOM: `finished_good` (barang jadi siap edar) atau `semi_finished` (barang setengah jadi olahan, MFG-01).
`base_quantity`	`number`	Tidak	`1`	Basis kuantitas output resep (misal: 10 atau 100). Digunakan untuk scaling resep.
`base_unit`	`string`	Tidak	`"pcs"`	Satuan basis output resep (kg, pcs, pack, liter).
`yield_expected_percentage`	`number`	Tidak	`100`	Estimasi persentase rendemen output (MFG-02). Misalnya 95% berarti dari 100 unit input diharapkan 95 unit output baik.
`qc_sop_parameters`	`object`	Tidak	-	Snapshot parameter SOP untuk gate QC release (MFG-04).
`qc_sop_parameters.temperature_min_c`	`number`	-	-	Suhu minimum proses (Celsius).
`qc_sop_parameters.temperature_max_c`	`number`	-	-	Suhu maksimum proses (Celsius).
`qc_sop_parameters.cooking_time_min_minutes`	`number`	-	-	Waktu masak minimum (menit).
`qc_sop_parameters.pressure_min_bar`	`number`	-	-	Tekanan minimum proses (bar).

State Machine — Siklus Hidup BOM

BOM memiliki siklus hidup yang ketat untuk menjamin integritas data produksi. Setiap transisi status dicatat dan diaudit.

Detail Transisi Status

Dari	Ke	Trigger	Konsekuensi
`draft`	`active`	User klik Activate BOM	BOM siap digunakan untuk Production Order. Validasi: semua komponen memiliki `quantity_per_unit > 0`.
`draft`	`obsolete`	User hapus BOM	BOM tidak pernah digunakan. Bisa dihapus permanen.
`active`	`active`	Edit minor (version +0.1)	Hanya jika `is_locked = false`. Jika sudah locked, harus clone ke versi baru.
`active`	`archived`	Versi baru di-activate	BOM lama tetap tersimpan sebagai arsip. Tidak bisa diedit lagi.
`active`	`obsolete`	Produk discontinued	BOM ditandai tidak berlaku. Semua PO terkait tetap tersimpan.
`archived`	`active`	Rollback	Versi arsip diaktifkan kembali. Versi aktif saat ini menjadi `archived`.

Aturan Penguncian (Lock Mechanism)

Implikasi bisnis: Setelah BOM digunakan untuk produksi pertama kali, resep terkunci. Perubahan resep harus melalui versi baru sehingga traceability produksi tidak terputus — production order lama tetap merujuk ke resep yang berlaku saat produksi berlangsung.

Contoh BOM — Ayam Suwir Petir (150g)

Bahan Baku	Qty	Satuan	Harga/Satuan	Subtotal	% dari Total
Ayam suwir	150	gram	Rp 80	Rp 12.000	57.1%
Cabai merah	50	gram	Rp 50	Rp 2.500	11.9%
Bawang merah	20	gram	Rp 40	Rp 800	3.8%
Bawang putih	10	gram	Rp 35	Rp 350	1.7%
Minyak goreng	30	ml	Rp 20	Rp 600	2.9%
Garam	5	gram	Rp 10	Rp 50	0.2%
Gula	3	gram	Rp 15	Rp 45	0.2%
Penyedap	2	gram	Rp 25	Rp 50	0.2%
Kemasan pouch	1	pcs	Rp 500	Rp 500	2.4%
Label sticker	1	pcs	Rp 200	Rp 200	1.0%
Total Bahan Baku				Rp 17.095	81.4%
Tenaga Kerja	-	-	-	Rp 2.500	11.9%
Overhead	-	-	-	Rp 1.405	6.7%
HPP Total				Rp 21.000	100%
Harga Jual				Rp 45.000
Gross Profit				Rp 24.000	53.3%

Membuat BOM

Step-by-Step

Step	Aksi	Detail
1	Buka halaman produk (`/companyproducts`)	Pilih produk yang akan dibuat BOM-nya
2	Klik Edit BOM	Form BOM terbuka
3	Klik Add Component	Pilih bahan baku dari dropdown
4	Input quantity per unit produk	Contoh: 50 gram cabai per 1 unit produk
5	Pilih satuan	gram, kg, ml, liter, pcs
6	Harga otomatis terisi	Dari data harga bahan baku terakhir
7	Tambah komponen lain	Ulangi step 3-6
8	Review total cost	Sistem hitung otomatis
9	Klik Activate BOM	BOM siap digunakan untuk produksi

Field BOM

Field	Tipe	Wajib	Deskripsi
Produk	Dropdown	Ya	Produk jadi yang akan diproduksi
Komponen	Dropdown	Ya	Bahan baku dari katalog
Quantity	Number	Ya	Jumlah yang dibutuhkan per 1 unit produk
Satuan	Dropdown	Ya	gram, kg, ml, liter, pcs, box
Harga per Satuan	Auto	-	Diambil dari harga beli terakhir
Subtotal	Auto	-	Qty x Harga
Notes	Text	Tidak	Catatan (opsional)

Version Control

Field	Deskripsi
Version Number	Format: X.Y (X = major change, Y = minor change)
Date Created	Tanggal versi ini dibuat
Created By	User yang membuat perubahan
Changes	Deskripsi perubahan yang dilakukan
Status	Active (sedang dipakai) / Inactive (arsip)

Rollback

Jika perlu kembali ke versi sebelumnya:

Buka riwayat versi BOM
Pilih versi yang diinginkan
Klik Rollback
Konfirmasi — versi aktif saat ini menjadi inactive
Versi yang dipilih menjadi active kembali

Aturan Versioning

Jenis Perubahan	Impact	Contoh	Versi Baru
Minor (Y +0.1)	Tidak mengubah struktur resep	Koreksi typo nama bahan, update harga satuan	1.0 → 1.1
Major (X +1.0)	Mengubah komposisi atau proses	Tambah/hapus komponen, ubah quantity signifikan, ganti bahan	1.2 → 2.0
Clone (BOM baru dari existing)	Membuat versi independen	Resep alternatif untuk channel berbeda, eksperimen	BOM baru v1.0

Manajemen Versi BOM — Detail Teknis

Chain of Descent (Silsilah Versi)

Setiap BOM menyimpan parent_bom_id yang merujuk ke BOM induk. Ini membentuk chain yang memungkinkan audit trail lengkap:

Kapan BOM Harus di-Clone vs Edit?

Kondisi	Aksi	Alasan
`is_locked = false`, perubahan minor	Edit langsung	BOM belum pernah dipakai produksi
`is_locked = true`, perubahan minor	Clone → versi baru (Y +0.1)	BOM sudah dipakai, harus preserve versi lama
`is_locked = true`, perubahan komposisi	Clone → versi baru (X +1.0)	Major change membutuhkan versi baru
Produk sama, resep alternatif	Clone → BOM independen	Channel berbeda mungkin butuh kemasan berbeda

Sequence Diagram — Konsumsi BOM saat Produksi

Diagram berikut menunjukkan alur lengkap bagaimana BOM digunakan saat production order diproses, dari perencanaan hingga konsumsi bahan dan rilis output.

Sequence Diagram — Posting Konsumsi dengan Idempotency

Sistem SNISHOP ERP menggunakan mekanisme idempotency untuk mencegah double-posting konsumsi bahan:

Auto-Calculate untuk Production Order

Saat membuat production order, sistem otomatis menghitung kebutuhan bahan baku berdasarkan BOM: Contoh: Production Order 100 jar Ayam Suwir Petir (150g)

Bahan Baku	Qty per Unit	x	Jumlah Produksi	=	Total Kebutuhan	Stok Tersedia	Status
Ayam suwir	150g	x	100	=	15.000g (15kg)	20.000g	Cukup
Cabai merah	50g	x	100	=	5.000g (5kg)	3.000g	Kurang 2kg
Bawang merah	20g	x	100	=	2.000g (2kg)	5.000g	Cukup
Bawang putih	10g	x	100	=	1.000g (1kg)	2.000g	Cukup
Minyak goreng	30ml	x	100	=	3.000ml (3L)	10.000ml	Cukup

Alert: Sistem menampilkan warning untuk bahan yang kurang dan menyarankan untuk membuat Purchase Order.

Perhitungan dengan Yield Expected

Jika BOM memiliki yield_expected_percentage = 95, maka untuk menghasilkan 100 unit baik:

Input yang dibutuhkan = quantity_to_produce / (yield_expected_percentage / 100)
                      = 100 / 0.95
                      = 105.26 → dibulatkan 106 unit input

Sistem otomatis mengoreksi kebutuhan bahan baku berdasarkan rendemen yang diestimasi.

Cost Rollup — Kalkulasi Biaya dari BOM

Struktur Biaya Produksi

BOM menjadi dasar kalkulasi HPP (Harga Pokok Produksi) yang diroll-up dari beberapa komponen biaya:

Tabel Rollup Biaya — Contoh Batch 100 Unit

Komponen Biaya	Sumber Data	Perhitungan	Total
Direct Materials	`BOM.raw_materials[]`	Σ (qty_per_unit x unit_cost) x qty_produced	Rp 16.395.000
Packaging Materials	`BOM.packaging_materials[]`	Σ (qty_per_unit x unit_cost) x qty_produced	Rp 700.000
Semi-Finished Cost	`ProductionOrder.semi_finished_cost`	Dari batch produksi sebelumnya	Rp 0
Direct Labor	`ProductionOrder.direct_labor_cost`	Input manual / kalkulasi waktu	Rp 250.000
Overhead	`ProductionOrder.overhead_cost`	Alokasi proporsional	Rp 140.500
Total Batch Cost	`ProductionOrder.total_batch_cost`	Σ semua di atas	Rp 17.485.500
By-product Credit	`ProductionOrder.byproduct_credit`	Pengurang (jika ada sisa bernilai)	- Rp 0
Abnormal Loss	`ProductionOrder.abnormal_loss_amount`	Exclude dari HPP produk baik	- Rp 0
Allocated to Good	`ProductionOrder.allocated_cost_to_good`	Total - byproduct - abnormal	Rp 17.485.500
HPP per Unit	`ProductionOrder.unit_hpp`	allocated_cost_to_good ÷ quantity_produced	Rp 174.855

Cost Status — Status Kelengkapan Biaya

Status	Kondisi	Implikasi
`complete`	Semua lot bahan memiliki harga tercatat	HPP final, bisa digunakan untuk laporan keuangan
`provisional_incomplete`	Ada lot bahan yang belum tercatat harganya (`has_incomplete_cost_input = true`)	HPP sementara, perlu update saat harga tersedia
`zero_output_pending`	Output baik = 0 (semua defect / belum ada output)	HPP belum bisa dihitung

Produktivitas & Rendemen

Metrik	Rumus	Contoh	Interpretasi
`mass_yield_percentage`	(output_mass ÷ input_mass) x 100	85%	15% massa hilang (penyusutan, evaporasi, waste)
`productivity_ratio`	unit_output ÷ kg_input	4.0 botol/kg	Dari 1 kg pasta dihasilkan 4 botol
`fail_rate`	quantity_defected ÷ quantity_produced x 100	2.5%	Target: < 5%
`efficiency_status`	duration ÷ standard_time	110% → `normal`	> 120% = `inefficient`

Bundle/Package BOM

Untuk produk bundle, BOM berisi produk jadi lain (bukan bahan baku mentah): Contoh: Paket Sambal Komplit

Komponen	Qty	Tipe	Stok Komponen
Ayam Suwir Petir (150g)	1	Finished Good	100 jar
Baby Cumi Judes (150g)	1	Finished Good	80 jar
Sambal Tuna Mercon (150g)	1	Finished Good	60 jar

Maksimal paket yang bisa dibuat: 60 (limited by Sambal Tuna Mercon) Saat paket dijual:

Stok masing-masing komponen berkurang 1
Paket tidak punya stok sendiri — stok virtual = min(stok komponen)

Integrasi BOM dengan QC & HACCP

BOM tidak hanya mendefinisikan bahan, tetapi juga parameter kualitas yang harus dipenuhi saat produksi:

Parameter QC dari BOM

Parameter BOM	Digunakan di	Fungsi
`qc_sop_parameters.temperature_min_c`	HACCP Verification	Batas bawah suhu proses
`qc_sop_parameters.temperature_max_c`	HACCP Verification	Batas atas suhu proses
`qc_sop_parameters.cooking_time_min_minutes`	HACCP Verification	Waktu masak minimum
`qc_sop_parameters.pressure_min_bar`	HACCP Verification	Tekanan minimum (jika applicable)
`yield_expected_percentage`	Production Order	Estimasi rendemen untuk planning bahan

BOM Reporting

Cost Report

Metrik	Deskripsi
Cost per Component	Biaya setiap bahan per unit
Total Cost per Product	Total HPP per unit
Cost Trend	Perubahan biaya dari waktu ke waktu
Cost Comparison	Perbandingan biaya antar produk
Cost Impact	Dampak perubahan BOM terhadap total cost

Usage Report

Metrik	Deskripsi
Component Usage	Total pemakaian bahan per periode
Top Used Components	Bahan yang paling banyak digunakan
Usage Trend	Tren pemakaian dari waktu ke waktu
Waste Analysis	Selisih planned vs actual consumption

Variance Report

Metrik	Deskripsi	Target
Planned vs Actual	Perbandingan kebutuhan BOM vs pemakaian aktual	Selisih < 3%
Variance Amount	Selisih dalam unit	-
Variance %	Selisih persentase	< 3%
Root Cause	Penyebab variance (jika ada)	Documented

Traceability Report

Metrik	Deskripsi	Sumber Data
Lot Genealogy	Silsilah lot: input lot → output lot	`LotBatch.input_lots[]`
Material Traceability	Bahan baku dari supplier mana, dipakai di batch apa	`ProductionOrder.materials_actual[].allocations[]`
Batch Recall Readiness	Kecepatan identifikasi batch terdampak	Waktu dari identifikasi hingga list batch terdampak < 2 jam
Cost per Batch	Biaya aktual per batch produksi	`ProductionOrder.total_batch_cost`

Best Practices

Praktik	Detail
Update BOM saat resep berubah	Jangan biarkan BOM outdated — setiap perubahan resep harus langsung di-update
Verify dengan production team	Sebelum activate, konfirmasi dengan tim produksi bahwa qty sudah benar
Regular BOM audit	Review BOM setiap kuartal untuk memastikan akurasi
Document semua perubahan	Setiap versi harus punya catatan perubahan yang jelas
Update harga bahan berkala	Harga bahan baku berubah — update BOM agar HPP tetap akurat
Monitor cost trend	Jika cost naik terus, cari cara optimasi (supplier alternatif, efisiensi proses)
Gunakan yield_expected_percentage	Set rendemen realistis agar planning bahan lebih akurat dan mengurangi waste
Pisahkan raw_materials dan packaging_materials	Gunakan array terpisah untuk bahan baku dan kemasan agar reporting lebih jelas
Set qc_sop_parameters di BOM	Parameter QC harus terdefinisi di BOM agar setiap produksi otomatis punya standar kualitas
Lock BOM setelah produksi pertama	Jangan edit BOM yang sudah dipakai — clone ke versi baru untuk menjaga traceability

​title: “Bill of Materials (BOM)” description: “Resep produksi lengkap dengan komponen, quantity, cost per unit, version control, dan auto-calculation untuk production orders.”

​Bill of Materials (BOM)

​Arsitektur BOM

​Entity Relationship Diagram

​Ringkasan Relasi Utama

​Complete Entity Schema — BillOfMaterials

​Field Identitas & Produk Output

​Field Resep & Komponen

​Field Versi & Siklus Hidup

​Field Konfigurasi Output & QC

​State Machine — Siklus Hidup BOM

​Detail Transisi Status

​Aturan Penguncian (Lock Mechanism)

​Contoh BOM — Ayam Suwir Petir (150g)

​Membuat BOM

​Step-by-Step

​Field BOM

​Version Control

​Rollback

​Aturan Versioning

​Manajemen Versi BOM — Detail Teknis

​Chain of Descent (Silsilah Versi)

​Kapan BOM Harus di-Clone vs Edit?

​Sequence Diagram — Konsumsi BOM saat Produksi

​Sequence Diagram — Posting Konsumsi dengan Idempotency

​Auto-Calculate untuk Production Order

​Perhitungan dengan Yield Expected

​Cost Rollup — Kalkulasi Biaya dari BOM

​Struktur Biaya Produksi

​Tabel Rollup Biaya — Contoh Batch 100 Unit

​Cost Status — Status Kelengkapan Biaya

​Produktivitas & Rendemen

​Bundle/Package BOM

​Integrasi BOM dengan QC & HACCP

​Parameter QC dari BOM

​BOM Reporting

​Cost Report

​Usage Report

​Variance Report

​Traceability Report

​Best Practices