fact_reservations

Reservation — fact_reservations.csv

Doanh thu và đêm phòng ở trên là số đã cộng. Muốn biết có bao nhiêu ĐƠN, đặt vào lúc nào, ở mấy đêm, huỷ hay không thì phải xuống tầng đơn lẻ, và tầng đó nằm ở trang Reservations.

node scripts/ota-read-booking-reservations.mjs          # cào, tự chia cửa sổ theo quý
python3 scripts/ota-reservations-extract.py             # nạp vào fact_reservations.csv

✅ Trang GROUP không có hai trần đó — lấy TRỌN lịch sử (đo 26/09/2026)

admin.booking.com/hotel/hoteladmin/groups/reservations/index.html (menu nhóm → Reservations) trả mọi property một lần, không ép 1 năm, không giới hạn 3 tháng: dải nhận phòng 2010–2030 ra 189 đơn = dải 2023–2027; 2010–2022 ra 0; theo ngày đặt / ngày trả cũng 189 ⇒ đó là toàn bộ (đơn sớm nhất đặt 25/12/2024, nhận phòng sớm nhất 09/01/2025). Kiểm chéo: 165/165 đơn của lượt cào theo property có mặt, trang group thêm 24 đơn (23 đơn nhận phòng 2025 mà trang property cắt mất). Nút Download của trang (tạo file sau ~3 phút "Retrieving file") ra Reservations_<from>_<to>.xls khớp 189/189 mã.

• Cào: node scripts/ota-read-booking-group-reservations.mjs [--from 2023-01-01 --to 2027-12-31] → JSON có tên khách ở _private/reservations/<ngày>/ (đã .gitignore, không commit). GraphQL searchReservations, 🔴 pagination.offset là SỐ TRANG (0,1,2…) chứ không phải số dòng; rowsPerPage 30 (200 → lỗi 500).
• Nạp fact_reservations bằng gộp theo khoá (channel, slug, reservation_id) như ota-reservations-extract.py (đơn đã có thì THAY, giữ lại rooms/is_last_minute cũ khi nguồn group để trống) — ⚠️ 26/09 lần đầu lỡ nối thẳng thành 354 dòng trùng, đã gộp lại 27/09 còn 189 dòng = 189 đơn. Mốc 2026-09-26 là bản trọn đời 189 đơn từ nguồn group (source_file = groups/reservations …); cột rooms và is_last_minute để trống (nguồn không có); đơn không ok ghi price_vnd = 0 như quy ước cũ (giá gốc đơn huỷ còn trong bản _private). Bản CSV không tên khách: _raw/reservations-group/2026-09-26/booking-reservations-all.csv.
• ⇒ Lượt reservation của /ota-metrics-crawl nên dùng script group; script property chỉ còn cần khi muốn cột rooms.

🔴 Hai trần của Booking — đo 23/09/2026, không phải giới hạn của công cụ

⇒ Đơn nhận phòng trước hôm nay − 1 năm là không lấy được. Doanh thu và đêm phòng của giai đoạn đó thì vẫn có (window = 1m, lùi tới 2023-06) — nên số đêm có lịch sử dài hơn số đơn, và hai đường trên cùng một biểu đồ sẽ bắt đầu ở hai thời điểm khác nhau. Nói rõ điều đó trên biểu đồ, đừng để người đọc tưởng trước đó không có đơn nào.

Ba thứ tưởng làm được mà không

• page và perpage trên URL bị bỏ qua — trang luôn gọi page=1&perpage=100.
• token của endpoint là nonce dùng một lần; phát lại đúng URL đó trả success: 0, nên không tự phân trang bằng fetch được.
• Chặn fetch/XHR trong trang cũng không bắt được gì (calls:1 mà n:0) — request đi từ realm khác. Đường chạy được là để chrome-grab.mjs bắt ở tầng mạng.

Phép kiểm đủ

Mỗi cửa sổ tự đối chiếu: cộng price.amount của các đơn nhận được, so với totalPrice mà API trả cho toàn bộ tập lọc. Khớp thì cửa sổ đó chắc chắn không sót trang — mạnh hơn nhiều so với tin vào cờ hasNextPage, vì cờ đó từng trả '' cho cả trang đầy. Cờ complete trong file kết quả là AND của mọi cửa sổ.