Đơn trả hàng — Danh sách
Danh sách phiếu trả hàng (đổi/trả) của cửa hàng.
Trả về các phiếu trả hàng, lọc theo trạng thái và khoảng thời gian.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /api/v1/shops/{shop_id}/orders_returned | Danh sách đơn trả |
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 | 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) |
status | truy vấn | integer | Không | Mã trạng thái phiếu trả |
start_time | truy vấn | integer | Không | Mốc bắt đầu (Unix) |
end_time | truy vấn | integer | Không | Mốc kết thúc (Unix) |
Kiểm thử tại chỗ
GET
https://pos.hitechcloud.vn/api/v1/shops/{shop_id}/orders_returnedKiể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_returned?page=1&page_size=20&status=1&start_time=1761868800" \
-H "Authorization: Bearer YOUR_API_KEY"Phản hồi mẫu
{
"status": "success",
"data": [
{
"id": "ret_5001",
"order_id": "order_900123",
"status": 1,
"warehouse_id": "wh_main"
}
],
"meta": {
"pagination": {
"total": 42,
"page_size": 20,
"page_number": 1,
"total_pages": 3,
"has_more": true
}
}
}Trả về các phiếu trả hàng, lọc theo trạng thái và khoảng thời gian.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /api/v1/shops/{shop_id}/orders_returned | Danh sách đơn trả |
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 | 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) |
status | truy vấn | integer | Không | Mã trạng thái phiếu trả |
start_time | truy vấn | integer | Không | Mốc bắt đầu (Unix) |
end_time | truy vấn | integer | Không | Mốc kết thúc (Unix) |
Kiểm thử tại chỗ
GET
https://pos.hitechcloud.vn/api/v1/shops/{shop_id}/orders_returnedKiể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_returned?page=1&page_size=20&status=1&start_time=1761868800" \
-H "Authorization: Bearer YOUR_API_KEY"Phản hồi mẫu
{
"status": "success",
"data": [
{
"id": "ret_5001",
"order_id": "order_900123",
"status": 1,
"warehouse_id": "wh_main"
}
],
"meta": {
"pagination": {
"total": 42,
"page_size": 20,
"page_number": 1,
"total_pages": 3,
"has_more": true
}
}
}