> For the complete documentation index, see [llms.txt](https://developer.gotadi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.gotadi.com/vietnamese/doi-tac-b2b2c/phuong-thuc-api/hotel/quy-tac.md).

# Quy Tắc

* **Chống trùng theo `requestId`** — gửi lại cùng `requestId` và cùng `payload` trong 10 phút thì nhận lại đúng response cũ, không xử lý lần hai. Khi retry vì timeout, giữ nguyên `requestId`, chỉ đổi `timestamp` và ký lại. Chỉ áp dụng cho `price-check`, `bookings/create`, `bookings/commit`, `bookings/cancel`.
* **Chống trùng theo `partnerReference`** — `bookings/create` với `partnerReference` đã có booking sẽ trả lại booking đó.
* **Timeout ở `create` hoặc `commit`** — không tạo booking mới. Gọi `bookings/get` theo `partnerReference` để biết trạng thái thật.
* **Commit song song** — nếu một `bookings/commit` khác cho cùng booking đang chạy, Gotadi trả mã `01` và không trừ tiền lần hai. Nếu Gotadi đã trừ tiền nhưng bước sau gặp lỗi, kết quả là `09 PENDING`, **không phải lỗi**: đừng hoàn tiền cho khách, tra lại bằng `bookings/get`.
* **Giá** — giá ở `availability` và `offers` là giá tham khảo có cache. Giá chỉ chốt ở `price-check`; khách trả đúng `totalAmount` của booking. `price.total` là tổng cả kỳ ở, mọi phòng, đã gồm thuế (`taxAndFees`). `totalBeforePromo` cùng cơ sở với `total`, chỉ có khi `promo = true`.
* **Thời hạn** — `offerId` 30 phút, `bookingToken` 15 phút, thanh toán trước `paymentDeadline` trong response `create`.
* **Giới hạn** — `availability` tối đa 50 `masterIds`, 30 đêm, 8 phòng. Tần suất gọi theo hợp đồng; vượt thì nhận HTTP 429 từ gateway.
* **Content** — đồng bộ toàn bộ danh mục theo `countryCode` và `cursor`, lưu ở hệ thống đối tác. **Không gọi `content/properties` trong luồng tìm của khách.**
* **Dữ liệu cá nhân** — tên, email, số điện thoại khách chỉ dùng cho booking, không ghi log dạng rõ.
