Đơn hàng — Danh sách (API đầy đủ)

Danh sách đơn hàng với bộ lọc trạng thái, nguồn, đối tác và đồng bộ gia tăng.

Xem Markdown

Danh sách đơn hàng của cửa hàng. Hỗ trợ tìm kiếm, lọc theo trạng thái/nguồn/đối tác và đồng bộ gia tăng qua update_status + startDateTime/endDateTime.

Endpoint

MethodEndpointMô tả
GET/api/v1/shops/{shop_id}/ordersDanh sách đơ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
page_numbertruy vấnintegerKhôngSố thứ tự trang
page_sizetruy vấnintegerKhôngSố bản ghi mỗi trang (tối đa 100)
searchtruy vấnstringKhôngTìm theo mã đơn, SĐT, tên khách
filter_statustruy vấninteger[]KhôngLọc theo mã trạng thái đơn
update_statustruy vấnstringKhôngĐồng bộ theo mốc cập nhật (dùng với startDateTime/endDateTime)
startDateTimetruy vấnintegerKhôngMốc bắt đầu (Unix timestamp)
endDateTimetruy vấnintegerKhôngMốc kết thúc (Unix timestamp)
customer_idtruy vấnstringKhôngLọc theo khách hàng
order_sourcestruy vấninteger[]KhôngLọc theo nguồn đơn

Kiểm thử tại chỗ

GEThttps://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
Query
cURL mẫu
curl -X GET "https://pos.hitechcloud.vn/api/v1/shops/shop_0a1b2c3d/orders?page_number=1&page_size=20&search=0901234567&filter_status=1" \
  -H "Authorization: Bearer YOUR_API_KEY"
Phản hồi mẫu
{
  "status": "success",
  "data": [
    {
      "id": "order_900123",
      "code": "DH900123",
      "status": 1,
      "total": 558000,
      "customer_id": "cus_3001",
      "warehouse_id": "wh_main"
    }
  ],
  "meta": {
    "pagination": {
      "total": 512,
      "page_size": 20,
      "page_number": 1,
      "total_pages": 26,
      "has_more": true
    }
  }
}