Đơ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.
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
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /api/v1/shops/{shop_id}/orders | Danh sách đơ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 |
page_number | truy vấn | integer | Không | Số thứ tự trang |
page_size | truy vấn | integer | Không | Số bản ghi mỗi trang (tối đa 100) |
search | truy vấn | string | Không | Tìm theo mã đơn, SĐT, tên khách |
filter_status | truy vấn | integer[] | Không | Lọc theo mã trạng thái đơn |
update_status | truy vấn | string | Không | Đồng bộ theo mốc cập nhật (dùng với startDateTime/endDateTime) |
startDateTime | truy vấn | integer | Không | Mốc bắt đầu (Unix timestamp) |
endDateTime | truy vấn | integer | Không | Mốc kết thúc (Unix timestamp) |
customer_id | truy vấn | string | Không | Lọc theo khách hàng |
order_sources | truy vấn | integer[] | Không | Lọc theo nguồn đơn |
Kiểm thử tại chỗ
GET
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
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
}
}
}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
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /api/v1/shops/{shop_id}/orders | Danh sách đơ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 |
page_number | truy vấn | integer | Không | Số thứ tự trang |
page_size | truy vấn | integer | Không | Số bản ghi mỗi trang (tối đa 100) |
search | truy vấn | string | Không | Tìm theo mã đơn, SĐT, tên khách |
filter_status | truy vấn | integer[] | Không | Lọc theo mã trạng thái đơn |
update_status | truy vấn | string | Không | Đồng bộ theo mốc cập nhật (dùng với startDateTime/endDateTime) |
startDateTime | truy vấn | integer | Không | Mốc bắt đầu (Unix timestamp) |
endDateTime | truy vấn | integer | Không | Mốc kết thúc (Unix timestamp) |
customer_id | truy vấn | string | Không | Lọc theo khách hàng |
order_sources | truy vấn | integer[] | Không | Lọc theo nguồn đơn |
Kiểm thử tại chỗ
GET
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
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
}
}
}