Danh sách đánh giá đơn hàng

EndpointCopy Anchor Link

GET /site/orderreviews

HeadersCopy Anchor Link

Workflow & LogicCopy Anchor Link

API này lấy danh sách các đánh giá đơn hàng của khách hàng đang đăng nhập, phục vụ việc hiển thị lịch sử đánh giá.

Quy trình xử lý (Internal Processing)Copy Anchor Link

1. Khởi tạo & Xác thực (Initialization & Authentication):

   • Khởi tạo site context từ header SiteTenantId.
   • Xác thực khách hàng từ JWT token trong header SiteAuthorization.
   • Chỉ lấy các đánh giá có visible = 1 (hiển thị công khai) và thuộc về khách hàng đang đăng nhập.

2. Lọc dữ liệu (Filtering):

   • Lọc theo đơn hàng: Nếu có sale_order_id, chỉ lấy đánh giá của đơn hàng đó.
   • Lọc theo danh sách đơn hàng: Nếu có sale_order_id_list, chỉ lấy đánh giá của các đơn hàng trong danh sách.

3. Sắp xếp & Phân trang (Sorting & Pagination):

   • Sắp xếp theo trường được chỉ định (sort_by), mặc định theo id giảm dần (DESC).
   • Phân trang với page và limit, mặc định page = 1 và limit = 50 (tối đa 50).

4. Đếm tổng số bản ghi (Counting):

   • Đếm tổng số bản ghi phù hợp với điều kiện lọc (không áp dụng limit).

5. Làm giàu dữ liệu (Data Enrichment):

   • Lấy danh sách OrderReview theo điều kiện lọc, sắp xếp và phân trang.
   • Với mỗi review, xóa các trường nhạy cảm (internal_note, moderator_id).
   • Mỗi review luôn có trường order; nếu enrich_sale_order = 1, order chứa thông tin đơn hàng đầy đủ, ngược lại là Order Object rỗng (giá trị mặc định).

6. Format & Trả về (Formatting & Response):

   • Tổng hợp vào cấu trúc response với total, currentpage, limit, và items[].

ParametersCopy Anchor Link

Response SchemaCopy Anchor Link

HTTP 200 - JSON ObjectCopy Anchor Link

{
  "total": 10,
  "currentpage": 1,
  "limit": 50,
  "items": [
    {
      "id": 1,
      "sale_order_id": 100,
      "rating_delivery": 5,
      "rating_packaging": 4,
      "rating_service": 5,
      "comment": "Giao hàng nhanh, đóng gói cẩn thận",
      "status": 3,
      "date_created": 1600000000
      // ... Xem thêm Order Review Object Schema
    }
  ]
}

Xem Order Review Object Schema

HTTP 401 - UnauthorizedCopy Anchor Link

Nếu thiếu token, token không hợp lệ hoặc đã hết hạn (error_customer_login_required), hoặc token không thuộc shop của SiteTenantId (error_customer_company_mismatch).