Mục lục
- Tài liệu chính thức OTA — chỉ mục đầy đủ
- A · Booking.com — 172 bài, 7 nhóm
- B · Airbnb — 422 bài, 34 chủ đề
- C · PriceLabs — tài liệu đã dùng và xác minh
- D · Agoda — tài liệu đã dùng
- E · Booking.com — tài liệu API (KHÔNG phải cho host)
- E-bis · 📜 Booking.com — HỢP ĐỒNG (GDT), nguồn có thẩm quyền cao nhất
- F · Nguồn KHÔNG dùng được
Tài liệu chính thức OTA — chỉ mục đầy đủ
Chỉ mục toàn bộ tài liệu chính thức của bốn hệ thống, thu thập 03/09/2026.
Booking.com 172 bài · Airbnb 422 bài · PriceLabs 11 bài · Agoda 7 bài (+ 89 link Agoda bổ sung 04/09/2026, xếp theo chủ đề ở mục §17 của platforms/agoda-listing-playbook.md).
Cột Việc gắn bài đó với mã trong todo.md / issues.md.
⚠️
partner.booking.comchặn fetch tự động (403) — phải mở bằng trình duyệt đã đăng nhập. 🇻🇳 Booking có bản tiếng Việt: đổi/en-us/thành/vi/trong mọi link dưới đây.
A · Booking.com — 172 bài, 7 nhóm
Gốc: https://partner.booking.com/en-us/help · tiếng Việt: https://partner.booking.com/vi/help
1 · Đăng ký & lên sàn
Đăng ký
Lên sàn
Công cụ
| Bài | Việc |
|---|---|
| Using the Pulse app |
Kết nối & channel manager
Hợp đồng
2 · Giá & tình trạng phòng
Lịch, giá, rate plan
Deal & giá theo nhóm khách
Restriction
Sức chứa
| Bài | Việc |
|---|---|
| Updating your rooms or units |
Cài đặt phòng
3 · Thanh toán, hoa hồng, thuế
Khách thanh toán
Payments by Booking.com
Hoá đơn & hoa hồng
4 · Đặt phòng & liên hệ khách
Quản lý đặt phòng
Liên hệ khách
| Bài | Việc |
|---|---|
| Contacting guests | |
| Setting up templates, automatic replies, and message notifications | |
| Adding and managing your contact details |
5 · Tài khoản & bảo mật
Cài đặt tài khoản
Bảo mật
6 · Hồ sơ listing & trải nghiệm khách
Chính sách, dịch vụ, tiện ích
Trang listing
Đánh giá khách
| Bài | Việc |
|---|---|
| Guest review process and conditions | |
| Everything you need to know about Guest Review Scores | |
| Improving your Guest Review Score | |
| Where can I see my guest reviews? | |
| Responding to guest reviews |
Ảnh & công bố bắt buộc
7 · Tăng trưởng
Phân tích & báo cáo
| Bài | Việc |
|---|---|
| Understanding your Analytics space | |
| Using the performance analysis | |
| Using your Genius Report | |
| Using the peer group and competitive set | L-18 |
| Search results, ranking, and visibility | L-12 |
Chương trình tăng doanh thu
B · Airbnb — 422 bài, 34 chủ đề
Gốc: https://www.airbnb.com/help · Resource Center: https://www.airbnb.com/resources/hosting-homes
Bài mở theo https://www.airbnb.com/help/article/<id>.
Định giá · topic/1486
Chi tiết listing · topic/1484
Tình trạng listing · topic/1482
Quản lý lịch · topic/1444
Pre-approval & special offer · topic/1443
Cài đặt đặt phòng & Instant Book · topic/1483
Thuế cho host · topic/1447
Nhận tiền (payout) · topic/1688
Dùng phần mềm bên thứ ba · topic/1493
Công cụ host chuyên nghiệp · topic/1489
Marketing listing · topic/1485
Chuẩn bị cho thuê · topic/1424
Cách cho thuê · co-host · Superhost · topic/1442
Yêu cầu đặt phòng · topic/1446
Điều kiện nhận khách · topic/1445
Cơ chế đặt phòng · topic/1458
Thay đổi đơn · topic/1460
Huỷ đặt phòng · topic/1461
Hoàn tiền khách · topic/1459
| Bài | Việc |
|---|---|
| Refund your guest | |
| When guest complaints may require a refund | |
| Request or send money in the Resolution Center | |
| Find your Resolution Center requests |
Sự cố đơn đặt · topic/1457
| Bài | Việc |
|---|---|
| If a guest makes you uncomfortable | |
| When a guest doesn’t show up for a reservation | |
| When guests want to bring more people to your home |
Nhắn tin với khách · topic/1601
Đánh giá — phía host · topic/1412
| Bài | Việc |
|---|---|
| How reviews are ordered and sorted | |
| Ratings and reviews for co-hosts | |
| Understanding reviews with photos | |
| Ratings for homes |
Đánh giá — cơ bản · topic/1410
| Bài | Việc |
|---|---|
| Reviews for homes | |
| Reviews for services and experiences | |
| Leave a review | |
| Authentic and trustworthy reviews |
Viết đánh giá · topic/1411
| Bài | Việc |
|---|---|
| How long you have to write a review | |
| Leaving a review after your host canceled | |
| Reviews for a group of guests |
Sau khi có đánh giá · topic/1647
| Bài | Việc |
|---|---|
| Find your reviews as a guest or host | |
| Your reviews from hosts | |
| Editing a review | |
| Remove or dispute a review | |
| Responding to a review | |
| Review moderation |
Bảo vệ & bảo hiểm · topic/1516
| Bài | Việc |
|---|---|
| Getting protected through AirCover for Hosts | |
| Host damage protection | |
| Host liability insurance | |
| Experiences & Services liability insurance | |
| How the Resolution Center helps you | |
| Security deposits |
Quy định & chuẩn mực · topic/1437
Tạo tài khoản · topic/1698
Xác minh danh tính · topic/1389
Quản lý tài khoản · topic/1388
Bảo mật tài khoản · topic/1390
An toàn · topic/1394
Mẹo an toàn · topic/1395
Báo cáo sự cố · topic/1397
Năm bài đã trích nguyên văn trong phiên 03/09
| Bài | Câu đã trích | Việc |
|---|---|---|
| Airbnb service fees | Split fee: host 3 %, khách 14,1–16,5 %. Cơ sở tính = "nightly price and any fees charged by the host, but exclude the guest service fee and taxes". Host-only 15,5 %. Phí dịch vụ đã gồm VAT ở nơi áp dụng | L-01 L-32 |
| Calculating your payout | "Your nightly rate plus your optional extra charges (a cleaning fee or extra guest fee, etc.) minus the Host service fee and any Co-Host payouts you share = your payout" | L-01 |
| How much does Airbnb charge hosts? | Ai bắt buộc chuyển sang host-only — gồm host dùng phần mềm quản lý | L-01 |
| Simplifying service fees | Giải thích đợt chuyển đổi 15/09 | L-01 |
| Pricing and fees — hub | Mục lục chủ đề giá & phí | — |
⚠️ Bài phải đọc trước khi chốt L-32
Vietnam withholding taxes — Airbnb có bài riêng về thuế khấu trừ tại Việt Nam. Nếu Airbnb đang khấu trừ thuế tại nguồn thì hệ số nâng giá cho mốc 15/09 phải tính lại, và phép so tiền thực nhận giữa Airbnb và Booking cũng đổi. Đọc cùng VAT and how it applies to you và Add your VAT ID number.
Màn hình trong tài khoản (không phải tài liệu, nhưng là nơi đọc số thật)
| Đường dẫn | Đọc được gì |
|---|---|
/hosting/listings/editor/<id>/details/pricing |
Base price · Custom weekend price · Smart Pricing · Discounts; HTML nhúng sẵn khối HostCalendarFeeSettings với cleaning fee, promotion, weekend price |
/multicalendar/<id> |
Giá từng đêm, ngày bị chặn |
/earnings/paid |
Sổ chi trả thật — dùng đối chiếu Total Revenue của PriceLabs |
/hosting/listings |
Trạng thái Listed / Unlisted của mọi listing |
C · PriceLabs — tài liệu đã dùng và xác minh
Gốc: https://help.pricelabs.co/portal/en/kb
| Bài | Nội dung đã trích | Việc |
|---|---|---|
| Setting Cleaning Fees, Service Fees and Booking Fees | "We don't!" — "We do not directly manage the fees and discounts related to cleaning, processing, or other charges specific to each channel"; phí "are added or subtracted after our pricing is sent out" | L-14 L-25 L-26 |
| Airbnb fee structure change | Nâng Base + Min + Max ~15 %, và cleaning/pet/linen/extra guest trên Airbnb. Có VAT thì hệ số là 15 % × (1 + VAT) |
L-01 L-32 L-33 |
| How to set up your base price | Base "is not automatically updated by PriceLabs"; nudge "never auto-apply"; giá ngày cập nhật tới 24 lần/ngày | — |
| Weekly and Monthly discount | Bảng tương thích không có Airbnb, không có Booking.com | L-35 |
| Length of Stay Pricing Adjustments | "adjusts the nightly rate based on how long a guest is planning to stay", áp sau mọi customization — cũng không hỗ trợ Airbnb/Booking | L-35 |
| Pricing Customizations · List of all customizations | Danh mục customization — cần cho Applied Customizations đang rỗng |
L-34 |
| Understanding the Dynamic Pricing Calendar | Đọc lịch giá | L-39 |
| Getting Started (toàn diện) | Hướng dẫn tổng | — |
| Guide: dùng cả Airbnb, Booking.com và Vrbo | Nối cha–con nhiều kênh | L-23 L-38 |
| Timed Sync | Hẹn giờ đồng bộ | — |
| Airbnb integration — câu hỏi & lỗi thường gặp | Giới hạn tích hợp Airbnb | L-29 L-35 |
D · Agoda — tài liệu đã dùng
Gốc: https://partnerhub.agoda.com
📘 Chỉ mục Agoda ĐẦY ĐỦ nằm ở mục §17 của
platforms/agoda-listing-playbook.md— 89 link xếp theo 7 nhóm (xếp hạng & chương trình trả phí · Content Score & nội dung · đăng ký · phòng/rate plan/chính sách · giá & tình trạng phòng · khuyến mãi · review & analytics), mỗi bài gắn với mục đã trích. Bảng dưới đây chỉ giữ 7 bài dùng cho việc giá và phí (L-14,L-40) đã soát 03/09/2026.
| Bài | Nội dung đã trích | Việc |
|---|---|---|
| How do I manage surcharges and additional fees? | Surcharge = "additional charges to the room rate". Mandatory = "collected by Agoda on the property's behalf". Excluded = "paid directly to the property upon check-in", nhập đã gồm thuế | L-14 |
| What commission do I pay to Agoda? | Cơ chế compensation | L-14 |
| How do I calculate my base rate? | Base Rate = số host nhận sau khi trừ compensation, giảm giá, phí chương trình khỏi Reference Sell Rate |
L-14 |
| Operational Changes to Rate Loading on YCS | Net Rate đã chuyển thành Reference Sell Rate; Sell Inclusive vs Sell Exclusive |
L-14 |
| How do I create a rate plan? | Tạo rate plan | L-40 |
| YCS App — manage rate and availability | Quản lý giá & tình trạng phòng | — |
| How do I use Partner Portal? | Dùng Partner Portal | — |
E · Booking.com — tài liệu API (KHÔNG phải cho host)
https://developers.booking.com/demand/docs/accommodations/charge-calculation · <.../pricing-examples>
Đây là tài liệu phía demand — dành cho đại lý bán phòng của Booking, không phải cho host. Hữu ích để hiểu cơ chế dựng giá:
Base room rate
+ included charges (VAT theo %) → book price = khách trả khi đặt
+ excluded charges (city tax…) → final total price
Nguyên văn: "Excluded and included refer to how charges are displayed in relation to the book price, not how much Booking.com will charge." → L-31 L-36
E-bis · 📜 Booking.com — HỢP ĐỒNG (GDT), nguồn có thẩm quyền cao nhất
https://admin.booking.com/hotelreg/terms-and-conditions.html?cc1=vn&lang=en
Đọc 11/09/2026. Đây là nguồn cao hơn cả Partner Hub — Booking tự ràng buộc mình bằng câu chữ ở đây, và theo luật EU P2B phải công bố tham số xếp hạng.
| Mục trong GDT | Nội dung | Dùng ở |
|---|---|---|
| Annex 4 — RANKING | Bốn tham số được ưu tiên trong thuật toán: lịch sử tìm kiếm của khách · click-through rate · conversion · gross và net bookings. Cộng danh sách yếu tố ảnh hưởng tới CTR/conversion, và câu "The Commission percentage paid by the Accommodation… may also impact the default ranking" | platforms/booking-ranking-playbook.md §1 · §2 |
| Annex 5 — WIDE PARITY COUNTRY WORDING | Định nghĩa Rate Parity và Availability Parity áp cho wide-parity country | playbook §3 |
| Định nghĩa ba nhóm parity | Narrow: Armenia, Australia, Brazil, China, Georgia, Hong Kong, Israel, Japan, South Korea, Turkey, UK, New Zealand · No parity: EEA, Russia, South Africa, Switzerland · Wide: tất cả phần còn lại ⇒ Việt Nam = WIDE PARITY | playbook §3 |
⚠️ GDT đổi theo thời gian và theo quốc gia — đọc lại bằng cc1=vn khi có thay đổi chính sách lớn.
F · Nguồn KHÔNG dùng được
| Nguồn | Lý do |
|---|---|
github.com/PriceLabs-Pricing |
404 — org không tồn tại, trang rác SEO |
github.com/Wheelhouse-Airbnb |
Cùng dạng — org trống nhồi từ khoá |
| PMS/channel manager mã nguồn mở (HAIP · QloApps · Pesan) | Là thay thế cho PriceLabs + kết nối OTA, không phải bổ sung. Với 7 căn thì lỗ vốn |
ivannikolovbg/repull-mcp |
MCP đọc dữ liệu 50+ PMS/OTA, nhưng không có rates/availability — đúng thứ cần nhất. Cần API key trả phí. 0 sao, v0.2. Ghi theo dõi, chưa dùng |
Booking.com Partner Community (partner.booking.com/en-us/community · /en-gb/community) |
404 ở cả hai locale (kiểm 11/09/2026) — Booking đã gỡ diễn đàn đối tác chính thức. Không còn kênh cộng đồng chính chủ để tra kinh nghiệm host |
Reddit (r/airbnb_hosts, r/vacationrentals…) |
Bị chặn ở tầng mạng của máy này (ERR_CONNECTION_REFUSED) và crawler cũng không vào được. Không đọc được từ workspace |
| Blog SEO bên thứ ba về "thuật toán Booking" (Hostaway · Smoobu · Rentals United · Smart Order · Hostlyft…) | Đọc 8 nguồn, không nguồn nào có thông tin mà GDT + Partner Hub chưa có, và nhiều nguồn sai (nhầm điều kiện Genius với Preferred, bịa trọng số cố định, bịa response-rate là yếu tố xếp hạng). Danh sách lỗi ở playbook §11 |
Đáng đọc thật: DallasBuyer/awesome-dynamic-pricing — mục Hotel có "Customized Regression Model for Airbnb Dynamic Pricing" (KDD 2018) và "Deep Learning based Dynamic Pricing Model for Hotel Revenue Management" (ICDM 2019). Nền lý thuyết cho comp set và dự báo cầu — liên quan L-18, L-39.