BookingTài nguyên Booking
Thống kê Tài nguyên và nhân sự
Lấy thông tin thống kê và dữ liệu dashboard cho Tài nguyên và nhân sự.
Endpoint
GET /v1/bookingresources/stats
Query Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
date | string | Ngày xem thống kê (Định dạng: Ymd, ví dụ: 20260201). Mặc định là ngày hiện tại. |
Response Schema
HTTP 200 - JSON Object
{
"summary": {
"month_completed_sessions": 120,
"month_unique_members": 15,
"today_planned_sessions": 8
},
"weekly_stats": [
{
"date": "20260126",
"day": 26,
"label": "T2",
"count": 5,
"is_today": false
}
],
"upcoming_booking_sessions": [
{
"id": 123,
"customer_id": 456,
"date_started_plan": 1738227600,
"booking_catalog_name": "Nhóm dịch vụ A",
"note": "Ghi chú cho lịch hẹn",
"entitlement_date_created": 0,
"customer_name": "Nguyễn Văn A",
"customer_avatar": "https://..."
}
],
"booking_catalogs": [
{
"id": 1,
"name": "Nhóm dịch vụ A",
"status": 1
}
]
}Fields Description
summary
month_completed_sessions: Tổng số lịch hẹn đã hoàn thành trong tháng.month_unique_members: Tổng số khách hàng trong tháng.today_planned_sessions: Số lịch hẹn dự kiến trong ngày.
weekly_stats
Mảng 7 đối tượng đại diện cho các thứ trong tuần (từ Thứ 2 đến Chủ nhật).
date: Chuỗi ngày định dạngYmd.day: Số ngày trong tháng.label: Nhãn hiển thị (T2,T3, ...,CN).count: Số lượng lịch hẹn trong ngày đó.is_today: Đánh dấu nếu là ngày hiện tại.
upcoming_booking_sessions
Danh sách 4 lịch hẹn sắp tới gần nhất.
booking_catalogs
Danh sách các nhóm dịch vụ được gán cho Tài nguyên và nhân sự này.
Error Codes
| HTTP | Code | Mô tả |
|---|---|---|
| 401 | ERR_AUTH_REQUIRED | Thiếu token xác thực |
| 403 | ERR_NO_PERMISSION | Không có quyền truy cập |
| 500 | ERR_INTERNAL | Lỗi máy chủ |
Lấy Booking Resource theo User đăng nhập
Lấy thông tin chi tiết Booking Resource được gán cho user hiện tại, bao gồm thông tin user và assignment.
Danh sách Học viên
Lấy danh sách các học viên (khách hàng) của Chuyên viên/Chuyên gia, nhóm theo Nhóm dịch vụ với thông tin khách hàng và gói dịch vụ đã enrich. Dữ liệu được lấy từ BookingEntitlement dựa trên primary_booking_resource_id.