Admin Orders API

Tài liệu chi tiết về API quản lý đơn hàng dành cho Admin (Merchant). Các API này được bảo vệ bởi middleware xác thực doanh nghiệp.

---

HTTP Endpoints

Phương thức	Đường dẫn	Mô tả
POST	/order/create_order	Tạo mới đơn hàng
GET	/order/get_order	Lấy ra danh sách hoặc chi tiết đơn hàng
PUT	/order/update_order	Cập nhật thông tin đơn hàng

---

Schema Reference

Request Headers

Header Key	Kiểu dữ liệu	Yêu cầu	Mô tả
Token-Business	string	Bắt buộc	Token doanh nghiệp dùng để xác thực và phân quyền.
Content-Type	string	Bắt buộc	Phải là application/json.

Order Object Schema

Dưới đây là chi tiết các thuộc tính chính trong đối tượng Order:

Thuộc tính	Kiểu dữ liệu	Mô tả
order_id	string	Mã định danh duy nhất của đơn hàng.
products	array	Danh sách sản phẩm trong đơn hàng. Mỗi phần tử chứa product_id, quantity, price.
total_money	number	Tổng số tiền khách hàng cần thanh toán.
status	string	Trạng thái của đơn hàng (NEW_ORDER, CONFIRM_ORDER, DELIVERY_ORDER, END_ORDER).
payment_method	string	Phương thức thanh toán (CASH, TRANSFER, WALLET, CARD).

---

API Methods

Lấy danh sách đơn hàng

GET /order/get_order
Token-Business: <business_access_token>

Query Parameters

• limit (number): Số lượng bản ghi tối đa trả về.
• skip (number): Số lượng bản ghi bỏ qua.
• stage (string): Lọc đơn hàng theo giai đoạn xử lý.

---

Tạo đơn hàng

POST /order/create_order
Token-Business: <business_access_token>
Content-Type: application/json

Request Body Example

{
  "products": [
    {
      "product_id": "prod_9381920",
      "quantity": 2,
      "price": 150000
    }
  ],
  "payment_method": "TRANSFER",
  "contact_name": "Nguyen Van A",
  "contact_phone": "0987654321",
  "address": "123 Đường ABC, Quận 1, TP. HCM"
}