Tạo giỏ hàng

Endpoint

POST /site/customercarts

Key	Value	Bắt buộc	Mô tả
`SiteTenantId`	`{tenant_id}`	Có	ID của công ty/tenant.
`SiteAuthorization`	`{jwt_token}`	Không	Token khách hàng (nếu đã đăng nhập).

Tạo quá nhiều giỏ hàng từ cùng một IP trong thời gian ngắn sẽ bị chặn với lỗi error_cart_creation_spam_detection.
source chỉ nhận 3 (Website), 5 (Mobile app), 7 (Mini app); giá trị khác hoặc không truyền sẽ dùng 3.
Nếu có data, mỗi phần tử phải có product_variant_id, uom_id, uom_quantity dạng số và biến thể phải tồn tại.
Tạo giỏ hàng với uuid mới, trạng thái 1 (Active), shipping_type = delivery, payment_method = 11 (COD). Nếu khách đã đăng nhập, giỏ được gắn với khách hàng.
Tính giá, khuyến mãi và trả về giỏ hàng. Frontend lưu uuid để dùng cho các API giỏ hàng tiếp theo.

{
  "source": 3,
  "data": [
    {
      "product_variant_id": 101,
      "uom_id": 0,
      "uom_quantity": 1
    }
  ]
}

Trường	Kiểu	Bắt buộc	Mô tả
`source`	`integer`	Không	Nguồn tạo giỏ: `3` Website (mặc định), `5` Mobile app, `7` Mini app.
`data`	`array`	Không	Danh sách sản phẩm ban đầu (cùng cấu trúc item như Thêm sản phẩm).

Trả về giỏ hàng vừa tạo (đã tính giá). Xem Customer Cart Object.

Mã lỗi	Mô tả
`error_cart_creation_spam_detection`	Tạo quá nhiều giỏ hàng từ cùng một IP.
`error_cart_data_item_missing_property`	Item trong `data` thiếu `product_variant_id`, `uom_id` hoặc `uom_quantity`.
`error_cart_data_item_product_variant_id_not_found`	Biến thể không tồn tại.
`error_cart_data_item_product_site_id_not_found`	Không tìm thấy sản phẩm của biến thể.
`error_add`	Tạo giỏ hàng thất bại (luôn đi kèm khi có lỗi ở trên).