Nhập danh mục theo khối (file Excel/CSV)
Một file mô tả trọn vẹn: món, size, topping và định lượng nguyên liệu — mỗi mặt hàng là một khối liền nhau.
Xuất file hiện có làm mẫu
Web quản trị
Ở trang Sản phẩm bấm «Xuất danh mục». File tải về đúng định dạng dùng để nhập lại, nên không phải dựng tay từ đầu.
Hiểu cột row_type
Web quản trị
Cột này quyết định dòng là gì: san_pham (mở một khối mới), tuy_chon (size, mức đá), topping, nguyen_lieu (định lượng). Dòng con thuộc về mặt hàng gần nhất phía trên.
Điền các cột của dòng sản phẩm
Web quản trị
Bắt buộc: product_name, sku, product_code. product_type quyết định mặt hàng là gì (standard, service, combo, ingredient, topping, option). base_price là giá bán lên hoá đơn, standard_cost là giá vốn. Nhóm hàng, đơn vị và nhà cung cấp tra theo TÊN — bật tuỳ chọn tự tạo ở cuối hộp thoại nếu muốn hệ thống tạo giúp khi chưa có. Các cột bật/tắt (is_taxable, allow_discount…) nhận x hoặc true.
Khai topping trước khi dùng
Web quản trị
Topping là một mặt hàng thật, có ảnh, giá vốn và tồn kho. Khai nó bằng một khối san_pham với product_type = topping, rồi mới tham chiếu theo tên ở dòng topping của món.
Khai lựa chọn size
Web quản trị
Size M/L là mặt hàng loại option, không có tồn kho. Nếu size lớn tốn thêm nguyên liệu thì thêm dòng nguyen_lieu ngay dưới khối của chính lựa chọn đó.
Đặt lựa chọn mặc định
Web quản trị
Với nhóm bắt buộc (min_select ≥ 1), đánh dấu is_default = x cho lựa chọn phổ biến nhất.
Chú ý
Không có mặc định thì mỗi lần bán món đó, thu ngân phải mở bảng chọn — giờ cao điểm sẽ thấy ngay. Đây là lỗi dễ bỏ sót nhất khi nhập file.
Nhập file và soát lỗi
Web quản trị
Bấm «Nhập từ file». Hệ thống báo lỗi theo TỪNG DÒNG kèm số dòng; tải file lỗi về, sửa đúng những dòng đó rồi nhập lại — các dòng đã vào không bị nhập trùng.
Kiểm lại trên POS
Web quản trị
Mở màn bán hàng, chạm một món vừa nhập: phải thấy badge tuỳ chọn và bảng chọn hiện đúng size/topping với giá đúng.
Nên biết
Phụ thu khai ở cột price_delta là CHÊNH LỆCH so với giá món, không phải giá cuối. Size L của Trà đào 20.000 muốn bán 25.000 thì price_delta = 5000.
Hay sai ở đây
Kiểm lại trước khi bấm
- Đặt dòng con lên trên dòng sản phẩm: dòng con luôn thuộc về mặt hàng gần nhất PHÍA TRÊN, nên đặt sai chỗ sẽ gán nhầm sang món khác.
- Nhầm price_delta với giá bán: cột price_delta là phần cộng thêm, khai 25000 cho size L sẽ thành ly 45.000.
- Quên is_default ở nhóm bắt buộc — mất đường thêm nhanh ở quầy.
- Tham chiếu nguyên liệu bằng tên viết khác trong danh mục (thừa dấu cách, sai dấu): hệ thống báo không tìm thấy chứ không tự đoán, vì đoán sai sẽ trừ nhầm kho.