Đơn hàng — Tạo (API đầy đủ)
Tạo đơn hàng mới với danh sách biến thể, kho xuất và thông tin khách.
Tạo đơn hàng và trừ tồn ở kho chỉ định. Mỗi dòng hàng tham chiếu variation_id.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /api/v1/shops/{shop_id}/orders | Tạo đơn hàng |
Tham số
| Tham số | Vị trí | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
shop_id | đường dẫn | string | Có | ID cửa hàng |
warehouse_id | thân | string | Có | Kho xuất hàng |
items | thân | object[] | Có | Dòng hàng: variation_id + quantity |
shop_customer_id | thân | string | Không | Khách hàng (nếu đã có) |
Kiểm thử tại chỗ
POST
https://pos.hitechcloud.vn/api/v1/shops/{shop_id}/ordersKiểm thử tại chỗNhập tham số và API Key rồi bấm Gửi thử. Key không được lưu lại.
Tham số đường dẫn
Body
cURL mẫu (POST)
curl -X POST "https://pos.hitechcloud.vn/api/v1/shops/shop_0a1b2c3d/orders" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"warehouse_id": "wh_main",
"items": [
{
"variation_id": "var_1001",
"quantity": 2
}
],
"customer": {
"name": "Nguyen Van A",
"phone": "0901234567"
}
}'Phản hồi mẫu
{
"status": "success",
"data": {
"id": "order_900123",
"code": "DH900123",
"status": 1,
"total": 398000
}
}Nếu một biến thể không đủ tồn, API trả về
422 OUT_OF_STOCK và không tạo đơn.Tạo đơn hàng và trừ tồn ở kho chỉ định. Mỗi dòng hàng tham chiếu variation_id.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /api/v1/shops/{shop_id}/orders | Tạo đơn hàng |
Tham số
| Tham số | Vị trí | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
shop_id | đường dẫn | string | Có | ID cửa hàng |
warehouse_id | thân | string | Có | Kho xuất hàng |
items | thân | object[] | Có | Dòng hàng: variation_id + quantity |
shop_customer_id | thân | string | Không | Khách hàng (nếu đã có) |
Kiểm thử tại chỗ
POST
https://pos.hitechcloud.vn/api/v1/shops/{shop_id}/ordersKiểm thử tại chỗNhập tham số và API Key rồi bấm Gửi thử. Key không được lưu lại.
Tham số đường dẫn
Body
Nếu một biến thể không đủ tồn, API trả về
422 OUT_OF_STOCK và không tạo đơn.cURL mẫu (POST)
curl -X POST "https://pos.hitechcloud.vn/api/v1/shops/shop_0a1b2c3d/orders" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"warehouse_id": "wh_main",
"items": [
{
"variation_id": "var_1001",
"quantity": 2
}
],
"customer": {
"name": "Nguyen Van A",
"phone": "0901234567"
}
}'Phản hồi mẫu
{
"status": "success",
"data": {
"id": "order_900123",
"code": "DH900123",
"status": 1,
"total": 398000
}
}