Đơ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.

Xem Markdown

Tạo đơn hàng và trừ tồn ở kho chỉ định. Mỗi dòng hàng tham chiếu variation_id.

Endpoint

MethodEndpointMô tả
POST/api/v1/shops/{shop_id}/ordersTạo đơn hàng

Tham số

Tham sốVị tríKiểuBắt buộcMô tả
shop_idđường dẫnstringCóID cửa hàng
warehouse_idthânstringCóKho xuất hàng
itemsthânobject[]CóDòng hàng: variation_id + quantity
shop_customer_idthânstringKhôngKhách hàng (nếu đã có)

Kiểm thử tại chỗ

POSThttps://pos.hitechcloud.vn/api/v1/shops/{shop_id}/orders

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.