SOP: Thiết lập Catalog (Danh mục Dịch vụ)

Thông tin nhanh

• Thời gian: 10-15 phút
• Yêu cầu: Tài khoản Admin, đăng nhập vào app.salehay.com
• Kết quả: Danh mục dịch vụ/sản phẩm sẵn sàng gắn vào bookings & leads

Xem thêm: Catalog API · Flow Catalog

Tổng quan Quy trình

Bước 1: Tạo Categories (Danh mục)

Vào: Settings → Catalog → Tab "Danh mục"

1. Click "+ Thêm danh mục"
2. Điền thông tin:
   • Tên: VD: "Chăm sóc da", "Massage", "Nail Art"
   • Icon: Chọn emoji hoặc icon
   • Màu sắc: Chọn màu để phân biệt
3. Click "Lưu"

TIP

Nên tạo 3-7 categories. Quá nhiều sẽ khó quản lý (Hick's Law).

Use Cases

Ngành	Categories gợi ý
Spa	Chăm sóc da, Massage, Body treatment, Nail
Clinic	Khám tổng quát, Nha khoa, Mắt, Da liễu
Salon	Cắt tóc, Nhuộm, Uốn, Dưỡng tóc
Gym	PT cá nhân, Lớp nhóm, Đánh giá thể lực

Exception Cases

Tình huống	Cách xử lý
Tạo trùng tên category	Hệ thống cho phép, nhưng slug sẽ khác
Xoá category đang có services	Services vẫn giữ, category_id = NULL
Muốn thay đổi thứ tự	Sửa sort_order trong form chỉnh sửa

Bước 2: Thêm Services (Dịch vụ)

Vào: Settings → Catalog → Tab "Dịch vụ"

1. Click "+ Thêm dịch vụ"
2. Điền thông tin:
   • Tên: VD: "Massage toàn thân 60 phút"
   • Mã: VD: "MASS-60" (không được trùng)
   • Danh mục: Chọn category đã tạo
   • Giá: 250.000đ
   • Giá cũ (optional): 300.000đ (hiển thị giảm giá)
   • Thời lượng: 60 phút
   • Loại: Service / Consultation / Treatment / Exam
3. Click "Lưu"

Use Cases

Tình huống	Cách làm
Dịch vụ có nhiều biến thể (VD: 30p/60p/90p)	Dùng field variants — JSON array
Dịch vụ miễn phí (tư vấn)	Giá = 0, Loại = "consultation"
Dịch vụ tạm ngưng	Toggle is_active = false

Exception Cases

Tình huống	Cách xử lý
Tạo dịch vụ trùng mã code	Lỗi 400 — "Mã dịch vụ đã tồn tại"
Thay đổi giá	Tự động ghi price_history
Xoá dịch vụ đang có bookings	Soft delete — bookings giữ service_id

Bước 3: Thêm Products (Sản phẩm)

Vào: Settings → Catalog → Tab "Sản phẩm"

1. Click "+ Thêm sản phẩm"
2. Điền: Tên, SKU, Danh mục, Giá, Giá vốn, Đơn vị, Tồn kho
3. Click "Lưu"

Use Cases

Ngành	Products gợi ý
Spa	Kem dưỡng, serum, mặt nạ
Salon	Dầu gội, thuốc nhuộm, gel tạo kiểu
Clinic	Thuốc, vật tư y tế

Exception Cases

Tình huống	Cách xử lý
Hết hàng (stock = 0)	Hiển thị warning, vẫn cho phép bán
SKU trùng	Lỗi 400 — "SKU đã tồn tại"
Sản phẩm ngưng bán	Toggle is_active = false

Bước 4: Tạo Packages (Gói dịch vụ)

Vào: Settings → Catalog → Tab "Gói dịch vụ"

1. Click "+ Tạo gói"
2. Đặt tên gói: VD: "Gói Thư giãn Cuối tuần"
3. Thêm items (services + products)
4. Thiết lập giảm giá: Fixed (VD: -100.000đ) hoặc Percent (VD: -20%)
5. Hệ thống tự tính: Giá gốc → Giá sau giảm
6. Click "Lưu"

Use Cases

Tình huống	Cách làm
Gói combo (2 services)	Thêm 2 services vào package, giảm %
Gói quarterly (mua 10 dùng 12)	Set max_uses=12, validity_days=90
Gói kèm sản phẩm	Mix services + products

Exception Cases

Tình huống	Cách xử lý
Giảm giá > giá gốc	Giá cuối = 0 (không âm)
Item trong gói bị xoá	Gói vẫn active, item biến mất khỏi list
Gói hết hạn (validity_days)	Admin manual disable