PRD: Đơn vị tính & quy đổi

Module	Kho	PRD ID	PRD-UOM-001
Trạng thái	Chưa tạo item	FEAT	UOM
Epic	—	Plane	—
Ngày	2026-07-13	Phiên bản	v1.0
Gói	@nx/inventory	URD	UOM
Surface	Client · Chủ/QL
Phụ trách	Phát Nguyễn

Đơn vị tính & quy đổi là gì

Một chi nhánh (Merchant) đếm hàng bằng nhiều cách: nhập Coca theo thùng, bán lẻ theo lon, nhập đường theo bao 25 kg nhưng pha chế theo gram. Đơn vị tính (Unit of Measure) là danh mục các cách đếm đó, và quy đổi (Conversion) là việc đưa mọi con số về một thang đo chung.

Hệ thống dựng sẵn một bộ đơn vị dùng chung (cái, hộp, thùng, kg, g, lít, ml...), dùng được ngay từ ngày đầu. Merchant thêm đơn vị riêng của mình khi bộ dùng chung không đủ.

Đơn vị gốc và ba vai trò

Mỗi mặt hàng khai ba vai trò đơn vị. Đây là bộ khái niệm mọi PRD Kho khác dựa vào khi nói tới số lượng:

Vai trò	Nghĩa	Bắt buộc
Đơn vị gốc	Đơn vị nhỏ nhất mà mặt hàng được đếm. Toàn bộ tồn kho luôn lưu theo đơn vị này, hệ số luôn bằng 1	Có
Đơn vị mua hàng	Đơn vị mặc định khi lập đơn mua và nhận hàng	Không
Đơn vị bán hàng	Đơn vị mặc định khi bán ra	Không

Con số nằm trong mục kho luôn là số theo đơn vị gốc. Chứng từ nhập bằng thùng hay bằng bao thì tồn vẫn tăng theo đơn vị gốc sau khi quy đổi.

Vì sao không để người lập phiếu tự nhân hệ số

Tồn kho bắt buộc phải quy về một đơn vị chung, nếu không thì cộng trừ ra số vô nghĩa: 2 thùng cộng 5 lon không ra được con số nào dùng được.

Đẩy việc quy đổi sang cho người lập chứng từ - cho họ một ô hệ số rồi tự nhân tay và điền số vào đó - là cách làm hỏng tồn kho. Điền sai một lần là tồn sai vĩnh viễn, và không ai phát hiện ra cho tới kỳ kiểm kê.

Còn một vấn đề riêng của thị trường Việt Nam: cùng gọi là "thùng" nhưng thùng Coca 24 lon, thùng bia 20 lon, thùng mì 30 gói. Bắt hệ số nằm ở danh mục đơn vị dùng chung thì merchant buộc phải phát sinh thêm "thùng-24", "thùng-20", "thùng-30". Danh mục phình ra, chọn nhầm liên tục, và báo cáo không gom nhóm được.

Ba mặt hàng, một đơn vị "thùng"

Danh mục chỉ có đúng một đơn vị "thùng". Quy cách đóng gói khai riêng ngay trên từng mặt hàng.

Mặt hàng	Đơn vị gốc	Đơn vị mua	Khai riêng trên mặt hàng	Nhập 2 đơn vị mua	Tồn tăng
Coca	lon	thùng	24	2 thùng	48 lon
Bia	lon	thùng	20	2 thùng	40 lon
Đường	g	kg	bỏ trống	5 kg	5000 g

• Coca và bia dùng cùng một đơn vị "thùng" trong danh mục, nhưng ra hai con số khác nhau. Con số khai riêng trên mặt hàng thắng hệ số chung của danh mục.
• Đường bỏ trống ô khai riêng, nên hệ thống đi theo chuỗi hệ số của danh mục: 1 kg = 1000 g. Đúng cho đơn vị đo lường chuẩn, vì 1 kg ở đâu cũng là 1000 g.
• Người lập phiếu chỉ chọn đơn vị và nhập số lượng. Màn nhập liệu hiện lại "2 thùng = 48 lon" để soát trước khi duyệt.

Chỗ dễ sai nhất

Hệ số bị khóa kể từ lúc mặt hàng có phát sinh kho

Mặt hàng đã từng nhập, bán, chuyển hay kiểm kê thì ô hệ số bị khóa. Sửa hệ số lúc đó là viết lại lịch sử: số lượng cũ nằm nguyên nhưng ý nghĩa của chúng đổi, và giá vốn các kỳ trước lệch theo.

Nhà cung cấp bán quy cách khác thì khai một đơn vị mới trên mặt hàng (Thùng 10 bên cạnh Thùng 12), không sửa đơn vị cũ.

Hệ quả: chứng từ đóng băng cả đơn vị lẫn số lượng đã quy ra đơn vị gốc ngay lúc lập. Mở một đơn mua cũ luôn ra đúng con số của ngày lập nó.

1. Mục tiêu & Loại trừ

Mục tiêu

• Một danh mục đơn vị hai tầng: đơn vị hệ thống dựng sẵn dùng chung cho mọi merchant, và đơn vị riêng do merchant tự thêm.
• Tồn kho luôn lưu và hiển thị theo đơn vị gốc của mặt hàng, bất kể chứng từ nhập bằng đơn vị nào.
• Hệ thống tự tính hệ số quy đổi bằng cách đi theo chuỗi tham chiếu trong danh mục và nhân dồn, thay cho việc người dùng điền hệ số bằng tay.
• Ba vai trò đơn vị trên mỗi mặt hàng: đơn vị gốc, đơn vị mua hàng, đơn vị bán hàng.
• Khai riêng quy cách đóng gói theo từng mặt hàng cho vai mua hàng và vai bán hàng, và con số khai riêng thắng hệ số chung của danh mục.

Loại trừ

• Khai quy cách đóng gói theo phần trăm - chỉ có một chế độ duy nhất là giá trị tuyệt đối ("1 thùng = 24 lon"), không có "1 thùng = 80% của...".
• Quy đổi giữa hai nhóm đơn vị khác nhau (vd từ kg sang lít) - hệ số chỉ khai được giữa các đơn vị cùng nhóm.
• Đổi đơn vị gốc của một mặt hàng khi mặt hàng đó đã phát sinh tồn.
• Đơn giá theo đơn vị (giá một thùng so với giá một lon) - thuộc Đơn mua hàng và Định giá.

2. Thước đo thành công

Thước đo	Mục tiêu / tín hiệu
Sai sót quy đổi khi nhập hàng	Giảm dần về 0 - không còn chênh lệch tồn do người lập phiếu nhân hệ số sai
Độ gọn của danh mục đơn vị	Merchant bán đồ uống chỉ cần một đơn vị "thùng", không sinh thêm biến thể "thùng-12" / "thùng-24"
Độ phủ đơn vị gốc	100% mặt hàng có đơn vị gốc ngay khi được tạo, không mặt hàng nào rơi vào trạng thái không biết đếm bằng gì
Thời gian lập một dòng phiếu nhập	Nhanh hơn - người lập chọn đơn vị rồi nhập số lượng, không phải bấm máy tính rồi điền ô hệ số

3. Persona & Tình huống

Persona	Mục tiêu trong tính năng này
Chủ merchant / Quản lý	Khai đơn vị cho từng mặt hàng, khai quy cách đóng gói của hàng mình nhập, và tin được con số tồn
Nhân viên kho	Lập phiếu nhập bằng đúng đơn vị ghi trên thùng hàng, không phải quy đổi trong đầu
Thu ngân	Bán bằng đơn vị lẻ quen tay, không cần biết tồn đang lưu bằng đơn vị nào
Đội vận hành	Duy trì bộ đơn vị dùng chung của hệ thống để merchant mới mở là dùng được ngay

Kịch bản cốt lõi: chủ merchant chọn đơn vị gốc "lon" cho sản phẩm Coca, chọn đơn vị mua hàng là "thùng" và khai riêng 24 lon một thùng → nhân viên kho lập phiếu nhập 2 thùng → hệ thống tự ghi 48 lon vào tồn → thu ngân bán 3 lon → tồn còn 45 lon, tất cả đều theo đơn vị gốc.

4. User Stories

#	Là một	Tôi muốn	Để
01	chủ merchant	mở màn Đơn vị tính và thấy sẵn các đơn vị thông dụng	merchant mới mở là dùng được ngay, không phải khai từ đầu
02	chủ merchant	thêm đơn vị riêng của mình (khay, vỉ, can)	danh mục hợp với cách tôi thật sự đếm hàng
03	chủ merchant	khai "1 thùng Coca của tôi là 24 lon" ngay trên sản phẩm	không phải tạo một đơn vị "thùng-24" riêng chỉ vì mỗi hàng một quy cách
04	nhân viên kho	nhập "2 thùng" và hệ thống tự ra 48 lon	tôi không phải nhân tay và không nhập nhầm
05	thu ngân	tồn kho luôn hiện theo đơn vị bán lẻ quen thuộc	tôi biết còn bao nhiêu lon mà bán
06	đội vận hành	đơn vị của hệ thống không bị merchant sửa hay xóa	hệ số quy đổi chuẩn (kg/g, lít/ml) không bị phá

5. Yêu cầu chức năng

#	Yêu cầu	Trạng thái	URD ref
FR-001	Danh mục đơn vị tính có hai tầng, merchant nhìn thấy cả hai trong cùng một danh sách. • Đơn vị hệ thống: dựng sẵn, dùng chung cho mọi merchant, có ngay từ ngày đầu merchant mới mở. • Đơn vị riêng: merchant tự thêm cho mình, chỉ merchant đó thấy. • Mã đơn vị không được trùng trong phạm vi một merchant. Merchant đặt trùng mã với một đơn vị hệ thống thì đơn vị riêng được ưu tiên dùng.	🔶	URD-UOM-001
FR-002	Đơn vị của hệ thống là chỉ đọc với merchant. • Merchant chọn và dùng được đơn vị hệ thống ở mọi nơi cần chọn đơn vị. • Merchant chỉ sửa và xóa được đơn vị do chính mình thêm. • Trên bảng danh sách, dòng của một đơn vị hệ thống không hiện nút Sửa và nút Xóa.	🔶	URD-UOM-001
FR-003	Mỗi đơn vị khai một mã, tên song ngữ, một nhóm và một trạng thái. • Nhóm chọn trong bảy giá trị: đếm, khối lượng, thể tích, chiều dài, thời gian, diện tích, khác. • Trạng thái đi theo vòng đời: kích hoạt → ngừng hoạt động → lưu trữ. • Đơn vị ngừng hoạt động không còn hiện trong danh sách chọn khi lập phiếu, nhưng chứng từ cũ đã dùng nó vẫn giữ nguyên.	🔶	URD-UOM-001
FR-004	Mỗi mặt hàng có đúng một đơn vị gốc, và tồn luôn lưu theo đơn vị đó. • Màn tồn kho, cảnh báo sắp hết hàng, báo cáo đều đọc ra con số theo đơn vị gốc. • Chứng từ nhập bằng thùng hay bằng bao thì tồn vẫn tăng theo đơn vị gốc sau khi quy đổi.	🔶	URD-UOM-002
FR-005	Merchant khai hệ số quy đổi giữa một đơn vị và một đơn vị tham chiếu cùng nhóm. • Form đơn vị có hai ô: đơn vị tham chiếu và hệ số (vd "kg" tham chiếu "g", hệ số 1000). • Đơn vị tham chiếu phải cùng nhóm với đơn vị đang khai. • Nhiều cặp khai nối tiếp nhau tạo thành một chuỗi quy đổi nhiều tầng (tấn → kg → g). • Chuỗi không được tạo vòng và không được sâu quá một giới hạn; con số giới hạn cụ thể chờ PO chốt.	🔶	URD-UOM-003
FR-006	Hệ thống tự tính hệ số quy đổi khi lập chứng từ bằng đơn vị khác đơn vị gốc. • Hệ thống đi theo chuỗi tham chiếu từ đơn vị đang chọn về tới đơn vị gốc và nhân dồn các hệ số. • Người lập chứng từ chỉ chọn đơn vị và nhập số lượng, không có ô hệ số để điền tay. • Hệ số đã dùng được ghi kèm vào dòng sổ biến động, nên mở lại một chứng từ cũ vẫn ra đúng con số đã quy đổi lúc đó.	🚧	URD-UOM-004
FR-007	Mỗi biến thể sản phẩm và mỗi nguyên vật liệu khai ba vai trò đơn vị. • Đơn vị gốc: đơn vị lưu tồn, bắt buộc. • Đơn vị mua hàng: đơn vị mặc định khi lập đơn mua và nhận hàng. • Đơn vị bán hàng: đơn vị mặc định khi bán ra. • Ba vai trò chọn được ba đơn vị khác nhau, hoặc trùng nhau nếu mặt hàng chỉ dùng một đơn vị. • Form nguyên vật liệu và form sản phẩm đều có đủ ba ô đơn vị này.	🔶	URD-UOM-005
FR-008	Với vai trò mua hàng và vai trò bán hàng, merchant khai riêng quy cách đóng gói cho chính mặt hàng đó. • Ô khai riêng nằm ngay cạnh ô chọn đơn vị: số đơn vị gốc trong một đơn vị đóng gói của mặt hàng này (vd chọn "thùng", khai 24 nghĩa là 1 thùng Coca = 24 lon). • Ô khai riêng là tùy chọn. Bỏ trống thì mặt hàng dùng hệ số chung của danh mục.	🚧	URD-UOM-006
FR-009	Số khai riêng của mặt hàng thắng hệ số chung của danh mục. • Không khai riêng: dùng chuỗi hệ số đã khai ở danh mục đơn vị - đúng cho các đơn vị đo lường chuẩn như kg/g, lít/ml. • Có khai riêng: dùng con số của mặt hàng đó - đúng cho đơn vị đóng gói như thùng, lốc, kết, vì cùng tên "thùng" nhưng mỗi hàng một quy cách.	🚧	URD-UOM-007
FR-010	Đơn vị gốc không có ô khai riêng. Hệ số của đơn vị gốc luôn bằng 1 theo định nghĩa.	🚧	URD-UOM-008
FR-011	Quy cách đóng gói chỉ nhận giá trị tuyệt đối, không có chế độ phần trăm. • Con số khai riêng là số đơn vị gốc, phải lớn hơn 0, nhận tới 4 chữ số thập phân (vd 0,5 kg cho một gói nửa cân). • Không có lựa chọn khai theo tỉ lệ phần trăm của một hệ số khác.	🚧	URD-UOM-006
FR-012	Merchant chỉ cần một đơn vị "thùng" trong danh mục, dùng chung cho nhiều mặt hàng dù mỗi mặt hàng đóng gói khác quy cách, thay vì phải tạo "thùng-12", "thùng-24" thành nhiều đơn vị riêng biệt.	🚧	URD-UOM-009
FR-013	Nơi khai đơn vị khác nhau theo loại mặt hàng, nhưng cấu trúc ba vai trò là một. • Nguyên vật liệu khai đơn vị ngay trong form nguyên vật liệu của module Kho. • Biến thể sản phẩm khai đơn vị trong form sản phẩm của module Danh mục sản phẩm.	🔶	URD-UOM-010
FR-014	Màn nhập liệu hiện luôn số lượng đã quy đổi để người lập phiếu soát lại. • Dòng phiếu hiện số đã nhập theo đơn vị đang chọn, kèm số tương ứng theo đơn vị gốc (vd "2 thùng = 48 lon"). • Đơn vị đang chọn chưa có đường quy đổi về đơn vị gốc thì dòng phiếu báo lỗi ngay tại chỗ và không lưu được.	🚧	URD-UOM-004
FR-015	Hệ số quy đổi của một đơn vị trên một mặt hàng không sửa được khi mặt hàng đã có phát sinh kho. • Mặt hàng đã từng nhập, bán, chuyển hay kiểm kê thì ô hệ số bị khóa, kèm lời giải thích ngay tại form. • Sửa hệ số lúc đó là viết lại lịch sử: số lượng cũ nằm nguyên nhưng ý nghĩa của chúng đổi, giá vốn các kỳ trước lệch theo. • Nhà cung cấp bán quy cách khác thì khai một đơn vị mới trên mặt hàng, không sửa đơn vị cũ.	🚧	URD-UOM-011
FR-016	Chứng từ đóng băng cả đơn vị lẫn số lượng quy ra đơn vị gốc ngay lúc lập. • Dòng đơn mua hàng và dòng phiếu kho lưu lại đơn vị người dùng đã chọn và số lượng đã quy ra đơn vị gốc. • Con số đó không bao giờ được tính lại, nên mở một chứng từ cũ luôn ra đúng số của ngày lập nó.	🚧	URD-UOM-012

5.1 Tiêu chí nghiệm thu

• Mở màn Đơn vị tính của một merchant vừa tạo → thấy sẵn danh sách đơn vị hệ thống (cái, hộp, thùng, kg, g, lít, ml...) mà chưa cần thêm gì.
• Bấm vào một đơn vị hệ thống → không có nút sửa và nút xóa; bấm vào một đơn vị do chính merchant thêm → sửa và xóa được bình thường.
• Thêm một đơn vị riêng tên "khay", nhóm "đếm" → đơn vị hiện trong danh sách và chọn được ở form nguyên vật liệu.
• Thêm đơn vị riêng trùng mã với một đơn vị hệ thống → khi chọn đơn vị theo mã đó, hệ thống dùng đơn vị riêng của merchant.
• Thêm một đơn vị riêng có mã trùng với một đơn vị riêng khác của chính merchant đó → form báo lỗi trùng mã, không lưu được.
• Chuyển một đơn vị sang trạng thái ngừng hoạt động → đơn vị đó biến mất khỏi danh sách chọn khi lập phiếu, nhưng mở lại một phiếu cũ đã dùng nó thì vẫn thấy đúng tên đơn vị.
• Khai đơn vị "kg" tham chiếu "g" hệ số 1000, rồi khai "tấn" tham chiếu "kg" hệ số 1000 → chọn "tấn" khi lập phiếu cho một nguyên liệu có đơn vị gốc là "g" → hệ thống ra 1.000.000 g cho 1 tấn.
• Chọn đơn vị tham chiếu khác nhóm (khai "kg" tham chiếu "lít") → form báo lỗi, không lưu được.
• Lập phiếu nhập 5 kg đường cho nguyên liệu có đơn vị gốc là "g" → dòng phiếu hiện "5 kg = 5000 g" → duyệt phiếu → tồn tăng đúng 5000 g, không có ô hệ số nào phải điền tay.
• Mở sản phẩm Coca, đơn vị gốc "lon", đơn vị mua hàng "thùng", khai riêng 24 → lập đơn mua 2 thùng → tồn ghi nhận 48 lon.
• Mở sản phẩm Pepsi, cũng chọn đơn vị mua hàng "thùng" nhưng khai riêng 20 → lập đơn mua 2 thùng → tồn ghi nhận 40 lon; cùng một đơn vị "thùng" trong danh mục nhưng ra hai con số khác nhau.
• Xóa trắng ô khai riêng của một nguyên liệu có đơn vị mua hàng là "kg" và đơn vị gốc là "g" → lập phiếu nhập 5 kg → hệ thống vẫn ra 5000 g, dùng đúng hệ số chung của danh mục.
• Mở form sản phẩm ở vai trò đơn vị gốc → không có ô khai riêng nào cho vai trò này.
• Nhập số 0 hoặc số âm vào ô khai riêng → form báo lỗi; nhập 0,5 → lưu được và quy đổi ra đúng nửa đơn vị gốc.
• Tìm trong màn Đơn vị tính → chỉ có một đơn vị tên "thùng", dù merchant đang bán Coca 24 lon/thùng và bia 20 lon/thùng.
• Mở form nguyên vật liệu trong module Kho và form biến thể sản phẩm trong module Danh mục sản phẩm → cả hai đều có đủ ba ô đơn vị: gốc, mua hàng, bán hàng.
• Chọn cho một dòng phiếu một đơn vị không cùng nhóm và không có đường quy đổi nào về đơn vị gốc của mặt hàng → dòng phiếu báo lỗi ngay tại chỗ, phiếu không lưu được.
• Mặt hàng "Sữa" chưa từng có phát sinh kho, sửa hệ số Thùng từ 12 sang 10 → lưu được bình thường.
• Cùng mặt hàng đó, sau khi đã nhập một phiếu kho → mở lại form, ô hệ số bị khóa, form giải thích vì sao và mời khai một đơn vị mới.
• Nhà cung cấp B bán thùng 10 lít trong khi Thùng của mặt hàng đang là 12 lít → khai thêm đơn vị Thùng 10 trên mặt hàng, trỏ dòng nhà cung cấp B vào đó → đặt 5 thùng của B → tồn tăng 50 lít, không phải 60.
• Lập đơn mua 5 Thùng 10, sau đó đổi tên hoặc thêm đơn vị khác trong danh mục → mở lại đơn mua cũ → vẫn đọc ra 5 Thùng 10 và 50 lít như ngày lập.

6. Yêu cầu phi chức năng

Khía cạnh	Yêu cầu
Toàn vẹn dữ liệu	Hệ số đã dùng để quy đổi được ghi kèm vào dòng sổ biến động và không đổi về sau, kể cả khi merchant sửa lại hệ số trong danh mục
Chống vòng lặp	Chuỗi tham chiếu không được tạo vòng (A tham chiếu B, B tham chiếu lại A); chuỗi cũng phải có giới hạn độ sâu, vượt quá thì form báo lỗi; con số giới hạn cụ thể chờ PO chốt
Phân quyền theo merchant	Đơn vị riêng chỉ merchant tạo ra nó nhìn thấy; đơn vị hệ thống mọi merchant đều đọc được nhưng không ai trong merchant ghi được
Độ chính xác	Hệ số quy đổi và số lượng dùng độ chính xác 4 chữ số thập phân xuyên suốt
Hiệu năng / quy mô	Danh sách đơn vị của một merchant trả về đủ toàn bộ đơn vị hệ thống cộng đơn vị riêng trong một lần tải, không cắt bớt
i18n	Tên và mô tả đơn vị là song ngữ Việt - Anh

7. UX & Luồng

Merchant vào màn Đơn vị tính từ menu Kho trên Client. Màn có một bảng liệt kê đủ cả đơn vị hệ thống và đơn vị riêng, lọc theo nhóm và theo trạng thái. Bấm "Thêm đơn vị" mở form với các ô mã, tên, nhóm, đơn vị tham chiếu và hệ số.

Việc khai ba vai trò đơn vị và ô khai riêng quy cách đóng gói không nằm ở màn này. Nó nằm trong form nguyên vật liệu (module Kho) và form sản phẩm (module Danh mục sản phẩm), ngay tại khối "Đơn vị tính".

8. Dữ liệu & Miền nghiệp vụ

Khái niệm	Vai trò
Đơn vị tính	Một cách đếm hàng: lon, thùng, kg, g. Thuộc một nhóm, có mã và tên song ngữ
Đơn vị hệ thống	Đơn vị dùng chung cho mọi merchant, do đội vận hành duy trì, merchant chỉ đọc
Đơn vị riêng	Đơn vị do một merchant tự thêm, chỉ merchant đó thấy và sửa được
Nhóm đơn vị	Bảy nhóm: đếm, khối lượng, thể tích, chiều dài, thời gian, diện tích, khác. Hệ số chỉ khai được trong cùng nhóm
Đơn vị tham chiếu	Đơn vị mà một đơn vị khác quy về, kèm hệ số (kg tham chiếu g, hệ số 1000)
Chuỗi quy đổi	Nhiều cặp tham chiếu nối tiếp nhau (tấn → kg → g); hệ số về đơn vị gốc là tích các hệ số trên chuỗi
Đơn vị gốc	Đơn vị nhỏ nhất mà một mặt hàng được đếm. Tồn luôn lưu theo đơn vị này, hệ số luôn bằng 1
Vai trò đơn vị	Ba vai trên mỗi mặt hàng: gốc, mua hàng, bán hàng
Quy cách đóng gói khai riêng	Số đơn vị gốc trong một đơn vị đóng gói của chính mặt hàng đó ("1 thùng của tôi = 24 lon"). Chỉ có ở vai mua hàng và vai bán hàng
Hệ số đã dùng	Con số quy đổi ghi kèm vào dòng sổ biến động lúc lập chứng từ, không đổi về sau

Chỉ ở mức khái niệm - schema và bất biến đầy đủ nằm trong inventory domain model.

9. Phụ thuộc & Giả định

Phụ thuộc vào

#	Feature	Phụ thuộc điều gì
01	MAT Nguyên vật liệu	nơi khai ba vai trò đơn vị cho nguyên liệu.
02	Danh mục sản phẩm	nơi khai ba vai trò đơn vị cho biến thể sản phẩm; ranh giới này giữ nguyên, Kho không ôm việc khai đơn vị của sản phẩm.
03	LDG Sổ biến động	nơi hệ số đã dùng được ghi kèm và giữ nguyên về sau.
04	TKT Phiếu kho · PO Đơn mua hàng	nơi người dùng chọn đơn vị khác đơn vị gốc và cần hệ thống quy đổi.

Giả định

#	Giả định	Sai thì sao
01	Đơn vị gốc của một mặt hàng được chọn một lần lúc tạo mặt hàng, và không đổi khi mặt hàng đã phát sinh tồn.	Đổi đơn vị gốc khi đã có tồn thì mọi con số lịch sử đổi nghĩa: tồn cũ, giá vốn cũ và dòng sổ cũ đều thành số vô nghĩa mà không cách nào dựng lại.
02	Bộ đơn vị hệ thống đủ phủ nhu cầu phổ thông của bán lẻ và F&B Việt Nam; đơn vị riêng chỉ dùng cho trường hợp đặc thù.	Bộ dùng chung thiếu thứ merchant cần thì mỗi merchant tự thêm một biến thể riêng, danh mục phình ra và báo cáo gom nhóm theo đơn vị không còn so sánh được giữa các merchant.
03	Một mặt hàng chỉ cần một quy cách đóng gói cho mỗi vai trò; hàng có nhiều cỡ thùng cùng lúc thì tách thành hai mặt hàng.	Một mặt hàng thật sự có hai cỡ thùng cùng lúc thì ô khai riêng chỉ giữ được một con số, và lần nhập theo cỡ còn lại quy đổi sai ngay từ dòng phiếu.

10. Kế hoạch phát hành & Tiêu chí

Khía cạnh	Kế hoạch
Phase	P2 (Kho v2) - xem danh mục feature URD
Rollout	Mọi merchant; không feature flag. Bộ đơn vị hệ thống có sẵn cho merchant ngay khi mới mở
Migration	Mặt hàng đang có tồn giữ nguyên đơn vị gốc hiện tại; ô khai riêng quy cách đóng gói mặc định để trống, nên mọi mặt hàng cũ tiếp tục dùng hệ số chung của danh mục và không đổi con số tồn
Tiêu chí phát hành	Merchant vào được màn Đơn vị tính từ menu Kho; lập một phiếu nhập bằng thùng ra đúng số lon; hai sản phẩm cùng đơn vị "thùng" nhưng khai riêng khác nhau ra hai con số khác nhau
Theo dõi	Số mặt hàng có khai riêng quy cách đóng gói, số dòng phiếu bị chặn vì không có đường quy đổi, chênh lệch kiểm kê của các mặt hàng nhập theo đơn vị đóng gói

Tham chiếu

• URD: Kho - Đơn vị tính & quy đổi
• Liên quan: Nguyên vật liệu · Mục kho & mức tồn · Sổ biến động · Đơn mua hàng
• Module: Kho - URD
• Developer: @nx/inventory

Rủi ro & Câu hỏi mở

#	Rủi ro / câu hỏi	Giảm thiểu / trạng thái
01	Merchant sửa hệ số trong danh mục sau khi đã nhập hàng, làm số lượng cũ bị hiểu lại sai	Hệ số đã dùng ghi kèm vào dòng sổ biến động lúc lập chứng từ, không đọc lại từ danh mục (FR-006)
02	Merchant khai riêng sai quy cách (gõ 240 thay vì 24) thì tồn sai gấp mười lần	Màn nhập liệu luôn hiện lại số đã quy đổi ngay trên dòng phiếu để người lập soát trước khi duyệt (FR-014)
03	Chuỗi tham chiếu bị khai thành vòng lặp	Form chặn vòng lặp và giới hạn độ sâu chuỗi (§6); con số giới hạn còn chờ PO chốt
04	Danh sách đơn vị bị cắt bớt khi merchant có nhiều đơn vị riêng, người dùng không thấy đơn vị mình vừa tạo	Danh sách trả về toàn bộ đơn vị hệ thống cộng đơn vị riêng trong một lần tải, không cắt bớt (§6)
05	Đổi đơn vị gốc của một mặt hàng đang có tồn sẽ làm mọi con số lịch sử vô nghĩa	Mở: cần luật xử lý tồn cũ trước khi cho đổi đơn vị gốc, hoặc chặn hẳn việc đổi
06	Nguyên liệu nhập theo cân nhưng công thức tính theo gram, sai số làm tròn cộng dồn qua nhiều lần nổ định lượng	Mọi hệ số và số lượng dùng độ chính xác 4 chữ số thập phân xuyên suốt (§6)

Câu hỏi thường gặp

#	Câu hỏi	Trả lời
01	Tồn kho được lưu theo đơn vị nào?	Luôn theo đơn vị gốc của mặt hàng. Nhập bằng thùng, bán bằng lon, nhưng con số nằm trong kho là số lon. Nhờ vậy cộng trừ lúc nào cũng ra số dùng được.
02	Tôi có phải tự nhân hệ số khi lập phiếu không?	Không. Chọn đơn vị và nhập số lượng; hệ thống đi theo chuỗi quy đổi đã khai, nhân dồn ra số theo đơn vị gốc, rồi hiện lại cho bạn soát ("2 thùng = 48 lon").
03	Thùng Coca 24 lon còn thùng bia 20 lon thì khai thế nào?	Giữ đúng một đơn vị "thùng" trong danh mục, rồi vào từng sản phẩm khai riêng: Coca 24, bia 20. Con số khai riêng trên sản phẩm luôn thắng hệ số chung của danh mục.
04	Khi nào thì nên khai riêng, khi nào dùng hệ số chung?	Đơn vị đo lường chuẩn (kg/g, lít/ml) thì dùng hệ số chung, vì 1 kg ở đâu cũng là 1000 g. Đơn vị đóng gói (thùng, lốc, kết, khay) thì khai riêng, vì mỗi mặt hàng một quy cách.
05	Có khai quy cách theo phần trăm được không?	Không. Chỉ có một chế độ duy nhất là giá trị tuyệt đối - số đơn vị gốc trong một đơn vị đóng gói. Phần trăm sinh ra số lẻ vô nghĩa và phụ thuộc ngầm vào một hệ số dùng chung, rất khó soát lúc nhập kho.
06	Tôi sửa được đơn vị "kg" của hệ thống không?	Không. Đơn vị hệ thống là chỉ đọc với merchant: bạn dùng được ở mọi nơi nhưng không sửa và không xóa được. Cần một cách đếm riêng thì thêm đơn vị của merchant mình.
07	Đơn vị gốc có ô khai riêng không?	Không. Hệ số của đơn vị gốc luôn là 1 theo định nghĩa, nên không có gì để khai.
08	Nguyên liệu và sản phẩm khai đơn vị ở hai chỗ khác nhau à?	Đúng. Nguyên vật liệu khai trong form nguyên vật liệu của module Kho, biến thể sản phẩm khai trong form sản phẩm của module Danh mục sản phẩm. Cấu trúc ba vai trò thì giống hệt nhau, chỉ khác nơi thao tác.