Đơn trả hàng — Danh sách

Danh sách phiếu trả hàng (đổi/trả) của cửa hàng.

Xem Markdown

Trả về các phiếu trả hàng, lọc theo trạng thái và khoảng thời gian.

Endpoint

MethodEndpointMô tả
GET/api/v1/shops/{shop_id}/orders_returnedDanh sách đơn trả

Tham số

Tham sốVị tríKiểuBắt buộcMô tả
shop_idđường dẫnstringCóID cửa hàng
pagetruy vấnintegerKhôngSố thứ tự trang
page_sizetruy vấnintegerKhôngSố bản ghi mỗi trang (tối đa 100)
statustruy vấnintegerKhôngMã trạng thái phiếu trả
start_timetruy vấnintegerKhôngMốc bắt đầu (Unix)
end_timetruy vấnintegerKhôngMốc kết thúc (Unix)

Kiểm thử tại chỗ

GEThttps://pos.hitechcloud.vn/api/v1/shops/{shop_id}/orders_returned

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
    }
  }
}