Nối Booking vào PriceLabs

Nối listing Booking.com vào PriceLabs

⚠️ Người bấm là user, KHÔNG phải agent. Mọi bước dưới đây đều là GHI (đổi cấu hình thật, đổi giá thật trên kênh bán). Luật vault/10-rules/ota-readonly-rule.md cấm agent tự làm; riêng nhãn Add/Re-import Listings nằm trong danh sách cấm chạm ở tầng C. Agent chỉ được làm hai việc: đo trạng thái trước khi nối và xác minh sau khi nối (mục 6).

Viết cho 25anthuong11 — property Booking 16927056, room 1692705601. Các căn khác dùng lại y hệt, chỉ đổi hai số đó.

1. Vì sao phải làm — tình trạng đo được 11/09/2026

Bốn bằng chứng độc lập đều chỉ cùng một kết luận: property này chưa nối channel manager nào.

Hệ quả đang gánh: giá Booking của căn này phẳng 5.000.000₫/đêm ở toàn bộ 81 ô lịch đọc được, không theo mùa, không theo cuối tuần, không theo nhu cầu. → issues.md L-15 + L-42.

2. Điều kiện tiên quyết — kiểm trước khi bấm gì

Quyết định phải chốt TRƯỚC khi bật sync: ba con số Min · Base · Max cho dòng Booking mới. Nối xong mà chưa đặt là PriceLabs đẩy giá của nó xuống, ghi đè mức 5.000.000₫ hiện tại. Mốc tham chiếu từ căn 4 phòng ngủ cùng cỡ 41lehycat trên Booking:

41 Lê Hy Cát · Booking:   Min 4.000.000   Base 5.500.000   Max chưa đặt
25 AT 11     · Booking:   giá tĩnh đang chạy 5.000.000
25 AT 11     · Airbnb:    Min 3.000.000   Base 4.000.000

Gợi ý điểm xuất phát an toàn: Base = 5.000.000 (đúng giá đang bán, không tạo cú sốc giá), Min = 3.500.000, Max đặt một trần thật thay vì bỏ trống. Đây là đề xuất, không phải số đã chốt — user quyết.

3. Phần A — Bên Booking extranet: khai PriceLabs là Connectivity provider

Nguồn: Booking Partner Help — Setting up and working with a Connectivity provider.

Cách A1 — làm cho riêng một property (đơn giản nhất)

1. Đăng nhập extranet, chọn đúng property 16927056 (4BR Villa in An Thuong 500m to MyKhe Beach).
2. Bấm Account trên thanh trên cùng, chọn Connectivity provider trong menu xổ xuống.
3. Bấm Search, tìm PriceLabs trong danh sách nhà cung cấp.
4. Chọn PriceLabs, rồi tick đủ các quyền. PriceLabs nói rõ: "If any one of these is not selected, then the sync will not work." - Rates and Availability - Reservations - Content (Booking gọi là Content and photos)
5. Tick ô đồng ý điều khoản, bấm Connect.

Cách A2 — làm từ group extranet (hợp với tài khoản này hơn)

Tài khoản này là group account 9 property, và PriceLabs đã là provider của 7 property khác — nên đường bulk là đường tự nhiên để thêm căn thứ 8.

1. Đăng nhập group extranet, bấm Bulk editing.
2. Mục Connectivity provider, bấm Take action cạnh Manage connectivity provider.
3. Tìm PriceLabs, bấm Connect, chọn các quyền cần tích hợp, bấm Next.
4. Chọn đúng property 16927056 (chỉ căn này, đừng động vào 7 căn đang chạy), bấm Check and confirm changes.
5. Soát lại rồi bấm Apply change.

Sau khi bấm Connect

Booking gửi yêu cầu kết nối sang PriceLabs qua email. PriceLabs làm phần mapping và cấu hình, rồi kết nối tự động hoàn tất khi họ xác nhận xong. Thông báo về hộp thư extranet. Trạng thái kết nối xem lại ở đúng chỗ cũ: Account → Connectivity provider.

⏱️ Không phải lập tức. Đừng kết luận hỏng nếu chưa thấy đổi ngay trong vài phút.

4. Phần B — Bên PriceLabs: nạp listing vào dashboard

Nguồn: PriceLabs — How to Integrate PriceLabs with Booking.com.

1. Đăng nhập PriceLabs.
2. Bấm Add/Reconnect Listings (tài khoản mới thì nhãn là Add your listings).
3. Chọn nhóm Airbnb/Booking.com/Houfy/Vrbo, rồi chọn Booking.com trong dropdown.
4. Câu hỏi "If you have added PriceLabs as your connectivity provider in Booking.com" → chọn Yes.
5. Nhập Property ID / Hotel ID:

16927056

6. Bấm Connect.

Kết quả mong đợi: mỗi room type thành một listing riêng trong PriceLabs. Căn này có đúng một room nên sẽ xuất hiện đúng một dòng, khoá dự kiến:

16927056___1692705601

5. Phần C — Cấu hình trước khi cho phép đẩy giá

Làm đủ ba việc này trước khi bật sync.

5.1 Đặt Min / Base / Max

Mở listing Booking mới, khối Configure Prices, nhập ba ô rồi bấm Save & Refresh. Số đã bàn ở mục 2.

5.2 Map cha–con với listing Airbnb của cùng căn

Đây là việc chống lệch giá giữa hai kênh và chống tính tiền hai lần. Vào Dynamic Pricing → Manage Listings → nút Map Listings:

• Parent: listing Airbnb 1729647978348243002
• Child: listing Booking 16927056___1692705601
• Bấm Map Listings.

Bằng chứng cách này chạy đúng đã có sẵn trong chính tài khoản: cặp cha–con của 36 Dương Tử Giang có Min và Base giống hệt nhau ở cả hai kênh. Bảy căn trong phạm vi chưa nối cha–con nên Base đang trôi mỗi kênh một kiểu → issues.md L-23.

⚠️ Nối cha–con không sửa số phòng ngủ khai trong PriceLabs. Kiểm riêng ô BR của dòng mới, đừng để nó thành 1 BR như ba dòng Booking đang sai (L-18).

5.3 Chênh lệch hoa hồng giữa hai kênh

Nếu muốn giá hai kênh khác nhau cho đúng phần hoa hồng, PriceLabs bảo dùng pricing offset và áp ở cấp tài khoản, không vá từng ngày.

6. Phần D — Bật sync, rồi xác minh

1. Trong PriceLabs, bật Sync Prices cho listing mới, hoặc bấm Sync Now để đẩy ngay một lần.
2. Đợi, rồi kiểm bốn dấu hiệu dưới đây. Nối đúng thì cả bốn phải đổi:

Agent chạy hộ bước xác minh này được, vì nó chỉ đọc:

node scripts/chrome-cdp-daemon.mjs &
node scripts/chrome-grab.mjs --out /tmp/verify-25at11 --settle 8000 \
  "https://admin.booking.com/hotel/hoteladmin/extranet_ng/manage/rate_plans.html?hotel_id=16927056&lang=xu" \
  "https://admin.booking.com/hotel/hoteladmin/extranet_ng/manage/home.html?hotel_id=16927056&lang=xu" \
  "https://app.pricelabs.co/pricing"

3. Ba rate plan của căn này ăn theo nhau nên chỉ cần Standard Rate được đẩy là cả ba đổi:

Standard Rate  67628679   ← PriceLabs đẩy vào đây
Weekly         67628681   = rẻ hơn Standard 5%
Monthly        69060005   = rẻ hơn Standard 10%

6b. Kết quả thật của lần chạy đầu — 25anthuong11, 11/09/2026

Bốn dấu hiệu đều đã lật ⇒ phần kết nối coi như xong. Nhưng đo tiếp trong PriceLabs thì thấy giá chưa hề được đẩy:

📌 Bài học đắt nhất của bước này: nối xong KHÔNG có nghĩa là giá chạy. Booking vẫn phục vụ mức tĩnh cũ cho tới khi bật Enable Price Sync. Ai chỉ nhìn nhãn XML (edits overwritten) rồi báo "xong" là báo sai.

🔎 Cách kiểm map cha–con bằng máy: trong GET /api/pd_dropdown_options, hai listing đã map dùng chung parent_key. Cặp mẫu đã map trong tài khoản: 36 Dương Tử Giang, Airbnb 1614694700651096321 và Booking 15995581___1599558101 cùng parent_key = 3583058.

⚠️ Xem giá PriceLabs định đẩy TRƯỚC khi bật sync. Lịch của căn này hiện phần lớn các đêm nằm đúng ở sàn 3.450.000, tức thuật toán còn muốn xuống thấp hơn nữa nhưng bị Min chặn. Bật sync là giá Booking rơi từ 5.000.000 xuống quanh 3.450.000. Đó có thể là điều mình muốn (lấp đầy 13%), nhưng phải là quyết định có chủ ý, không phải tác dụng phụ.

7. Phần E — Việc BẮT BUỘC làm sau: nối lịch bằng iCal

🔴 PriceLabs KHÔNG đồng bộ tình trạng phòng. Nguyên văn: "PriceLabs does not manage availability. You need another tool to ensure that the calendar for your Airbnb and Booking.com is synced."

Nghĩa là nối xong giá chạy đúng nhưng hai kênh vẫn có thể bán trùng một đêm. Villa nguyên căn thì đặt trùng là hỏng thật, không phải phiền toái nhỏ.

Thêm một bẫy PriceLabs cảnh báo thẳng: "Even if your Airbnb and Booking.com are already synced prior connecting them to PriceLabs, please follow this step again as Booking.com may have removed the sync." ⇒ sau khi nối, phải mở lại phần iCal của Booking và kiểm, kể cả khi trước đó đã nối rồi. iCal do Booking quản, PriceLabs không can thiệp được; hỏng thì hỏi Booking support.

8. Những thứ sẽ mất hoặc đổi — biết trước để khỏi hoảng

9. Thứ tự rút gọn

1. Chốt Min / Base / Max cho dòng Booking                      (user quyết)
2. Booking extranet → Account → Connectivity provider → PriceLabs → tick đủ quyền → Connect
   (hoặc group extranet → Bulk editing → Manage connectivity provider)
3. Đợi PriceLabs xác nhận — thông báo về hộp thư extranet
4. PriceLabs → Add/Reconnect Listings → Booking.com → Yes → 16927056 → Connect
5. Nhập Min/Base/Max → Save & Refresh
6. Map Listings: parent = Airbnb 1729647978348243002, child = 16927056___1692705601
7. Kiểm ô BR của dòng mới (phải là 4 BR)
8. Bật Sync Prices
9. Xác minh 4 dấu hiệu ở mục 6
10. Nối lại iCal Airbnb ↔ Booking và kiểm — PriceLabs không lo tình trạng phòng

10. Liên quan

• issues.md L-15 · L-42 — hai việc mở mà cẩm nang này đóng
• issues.md L-23 (chưa map cha–con) · L-18 (dòng Booking khai sai BR) — sửa luôn trong lúc làm
• platforms/pricelabs.md §2 — bản đồ 36 listing và cách đọc Base
• platforms/booking.md §3 — ý nghĩa nhãn XML, sửa ở đâu
• vault/10-rules/ota-readonly-rule.md — vì sao agent không tự bấm