Query parameters

• page number

  Trang, bắt đầu từ 1

  Minimum value is 1. Default value is 1.

• page_size number

  Số bản ghi mỗi trang

  Minimum value is 1, maximum value is 500. Default value is 20.

• search string

  Free-text search across tracking_number / customer_name / customer_phone

  Maximum length is 100.

• status number

  Filter by OrderStatus code

  Values are -1, 0, 1, 16, 17, 18, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, or 99.

• category string

  Dashboard status bucket (timestamp-driven). Applies the cutover floor date.

  Values are today, shipped_today, in_transit, returned, need_print, awaiting_ship, or cancelled.

• statuses array[number]

  Lọc nhiều trạng thái cùng lúc (OR). Kết hợp AND với status nếu gửi cả hai.

  Values are -1, 0, 1, 16, 17, 18, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, or 99.

• from_date string

  Ngày tạo từ (YYYY-MM-DD, giờ Việt Nam)

• to_date string

  Ngày tạo đến (YYYY-MM-DD, giờ Việt Nam, bao gồm cả ngày)

• carrier number

  Lọc theo hãng vận chuyển

  Values are 0, 1, 2, 3, 4, or 99.

• source string

  Nguồn đơn (dealer_app | pancake | ...)

  Maximum length is 40.

• product string

  Lọc theo tên sản phẩm trong đơn

  Maximum length is 100.

• cod_from string

  COD tối thiểu (NUMERIC dạng chuỗi)

• cod_to string

  COD tối đa (NUMERIC dạng chuỗi)

Responses

• 200

  Paginated order list with { data, meta }