Trang này được dịch bởi Cloud Translation API.

Thông tin về thuế tại FeeInfo

Yêu cầu

Cú pháp

Thông báo TaxFeeInfo sử dụng cú pháp sau:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="timestamp"
            id="message_ID"
            partner="partner_key">
  <Property action="[overlay]">
    <ID>HotelID</ID>
    <Taxes>
      <Tax>
        <RoomTypes>
          <RoomType id="RoomID_1"/>
          <RoomType id="RoomID_2"/>
        </RoomTypes>
        <RatePlans>
          <RatePlan id="PackageID_1"/>
          <RatePlan id="PackageID_2"/>
        </RatePlans>
        <BookingDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </BookingDates>
        <CheckinDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckinDates>
        <CheckoutDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckoutDates>
        <StayDates application="[all|any|overlap]">
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </StayDates>
        <Type>[percent|amount]</Type>
        <Basis>[room|person]</Basis>
        <Period>[stay|night]</Period>
        <Currency>currency_code</Currency>
        <Amount>tax_amount</Amount>
        <ApplicableNights max="integer" excluded="integer"/>
        <LengthOfStay min="integer" max="integer"/>
        <!-- Use either <Amount> or <Brackets> -->
        <Brackets base_amount="tax_amount"/>
          <Bracket starts_at="nightly_rate" amount="tax_amount"/>
        </Brackets>
        <AgeBrackets>
          <AdultCharge amount="tax_amount"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="max_age" amount="tax_amount"/>
          </ChildAgeBrackets>
        </AgeBrackets>
        <UserCountries type="[include|exclude]">
          <Country code="country_code1"/>
          <Country code="country_code2"/>
        </UserCountries>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <RoomTypes>
          <RoomType id="RoomID_1"/>
          <RoomType id="RoomID_2"/>
        </RoomTypes>
        <RatePlans>
          <RatePlan id="PackageID_1"/>
          <RatePlan id="PackageID_2"/>
        </RatePlans>
        <BookingDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </BookingDates>
        <CheckinDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckinDates>
        <CheckoutDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckoutDates>
        <StayDates application="[all|any|overlap]">
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </StayDates>
        <Type>[percent|amount]</Type>
        <Basis>[room|person]</Basis>
        <Period>[stay|night]</Period>
        <Currency>currency_code</Currency>
        <Amount>fee_amount</Amount>
        <ApplicableNights max="integer" excluded="integer"/>
        <LengthOfStay min="integer" max="integer"/>
        <!-- Use either <Amount> or <Brackets> -->
        <Brackets base_amount="tax_amount"/>
          <Bracket starts_at="nightly_rate" amount="tax_amount"/>
        </Brackets>
        <AgeBrackets>
          <AdultCharge amount="tax_amount"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="max_age" amount="tax_amount"/>
          </ChildAgeBrackets>
        </AgeBrackets>
        <UserCountries type="[include|exclude]">
          <Country code="country_code1"/>
          <Country code="country_code2"/>
        </UserCountries>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Phần tử và thuộc tính

Thông báo TaxFeeInfo có các phần tử và thuộc tính sau:

Phần tử / @Thuộc tính	Số lần xuất hiện	Loại	Nội dung mô tả
TaxFeeInfo	1	Complex element	Phần tử gốc của thông báo giúp xác định thuế và phí cho một cơ sở lưu trú duy nhất.
TaxFeeInfo / @timestamp	1	DateTime	Ngày và giờ tạo thông báo này.
TaxFeeInfo / @id	1	string	Giá trị nhận dạng duy nhất cho thông báo yêu cầu này. Giá trị này được trả về trong thông báo phản hồi. Các ký tự hợp lệ là `a-z`, `A-Z`, `0-9`, `_` (dấu gạch dưới) và `-` (dấu gạch ngang).
TaxFeeInfo / @partner	1	string	Tài khoản đối tác của thông báo này. Giá trị của chuỗi này là giá trị của "Khóa đối tác" được liệt kê trên trang Cài đặt tài khoản trong Hotel Center. Lưu ý: Nếu bạn có phần phụ trợ là nguồn cấp dữ liệu cho nhiều tài khoản, thì giá trị này cần phải khớp với giá trị của thuộc tính `ID` được chỉ định trong phần tử `<RequestorID>` của thông báo `<OTA_HotelRateAmountNotifRQ>` và `<OTA_HotelAvailNotifRQ>` cho cùng một tài khoản.
TaxFeeInfo / Property	1..n	Property	Vùng chứa giúp xác định thuế và phí cho một cơ sở lưu trú duy nhất.
TaxFeeInfo / Property / @action	0..1	string	Chỉ định cách áp dụng bản cập nhật. Chúng tôi chỉ hỗ trợ `overlay` và mặc định là `overlay`. Mọi `Taxes` và `Fees` trước đó của tài sản này sẽ bị xoá trước khi áp dụng bản cập nhật này.
TaxFeeInfo / Property / ID	1	string	Giá trị nhận dạng duy nhất của cơ sở lưu trú. Giá trị này phải khớp với Mã khách sạn được chỉ định bằng phần tử <id> trong phần tử <listing> trong Nguồn cấp dữ liệu danh sách khách sạn. Mã khách sạn cũng có trong Hotel Center.
TaxFeeInfo / Property / Taxes	0..1	Taxes	Vùng chứa một hoặc nhiều phần tử `<Tax>`.
TaxFeeInfo / Property / Taxes / Tax	1..n	Tax	Một loại thuế riêng áp dụng cho cơ sở lưu trú.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes	0..1	RoomTypes	Vùng chứa danh sách các loại phòng áp dụng thuế. Mức thuế này được áp dụng cho mỗi `<RoomType>` được xác định. Nếu bạn không xác định `<RoomTypes>`, thuế sẽ áp dụng cho tất cả các phòng.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType	1..n	RoomType	Xác định một loại phòng. Loại phòng được xác định trong phần tử `<RoomData>` trong thông báo Giao dịch (Dữ liệu cơ sở lưu trú) và như được xác định bằng RoomID. (Giá trị `<RoomID>` cũng được thuộc tính `InvTypeCode` tham chiếu trong `OTA_HotelRateAmountNotifRQ` thông báo.)
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id	1	string	Giá trị nhận dạng duy nhất cho quỹ phòng (loại phòng). Giá trị này tương ứng với `<RoomID>` trong thông báo Giao dịch (Dữ liệu cơ sở lưu trú). Số lượng ký tự tối đa được phép là 50.
TaxFeeInfo / Property / Taxes / Tax / RatePlans	0..1	RatePlans	Vùng chứa danh sách các gói giá mà khoản thuế áp dụng. Nếu bạn không xác định `<RatePlans>`, thuế sẽ áp dụng cho tất cả gói giá.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan	1..n	RatePlan	Xác định một gói giá. Gói giá được định nghĩa là tổng hợp gói dịch vụ, giá và tình trạng phòng, theo cách xác định trong các thông báo Giao dịch (Dữ liệu cơ sở lưu trú), OTA_HotelRateAmountNotifRQ và OTA_HotelAvailNotifRQ, đồng thời gói giá còn được xác định bằng PackageID.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id	1	string	Giá trị nhận dạng duy nhất của gói giá. Giá trị này tương ứng với giá trị PackageID trong `<PackageData>` trong thông báo Giao dịch (Dữ liệu cơ sở lưu trú) và trong thuộc tính `RatePlanCode` trong `<StatusApplicationControl>` ở cả thông báo `<OTA_HotelRateAmountNotifRQ>` và `<OTA_HotelAvailNotifRQ>`. Số lượng ký tự tối đa được phép là 50.
TaxFeeInfo / Property / Taxes / Tax / BookingDates	0..1	BookingDates	Vùng chứa một hoặc nhiều phạm vi ngày dùng để xác định thời điểm phải đặt phòng để áp dụng thuế đó.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange	1..99	DateRange	Phạm vi ngày xác định thời điểm phải đặt phòng để áp dụng thuế đó.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start	0..1	Date	Ngày bắt đầu (dựa trên múi giờ của cơ sở lưu trú) trong phạm vi ngày. Ngày này phải trước hoặc đúng ngày `end`. Nếu bạn không xác định `start`, phạm vi ngày sẽ không có giới hạn vì không có ngày bắt đầu.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @end	0..1	Date	Ngày kết thúc (dựa trên múi giờ của cơ sở lưu trú) trong phạm vi ngày. Ngày này phải trùng hoặc sau ngày `start`. Nếu bạn không xác định `end`, phạm vi ngày sẽ không có giới hạn vì không có ngày kết thúc.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @days_of_week	0..1	string	Các ngày trong tuần được phép sử dụng trong phạm vi ngày. Nếu bạn không chỉ định, tất cả các ngày trong tuần đều được phép sử dụng trong phạm vi ngày. Mỗi ký tự trong chuỗi xác định một ngày. Ví dụ: "MTWHF" cho biết các ngày trong tuần được cho phép trong phạm vi ngày. Các ký tự hợp lệ là: `M` đại diện cho thứ Hai `T` đại diện cho thứ Ba `W` đại diện cho thứ Tư `H` đại diện cho thứ Năm `F` đại diện cho thứ Sáu `S` đại diện cho thứ Bảy `U` đại diện cho Chủ Nhật Mọi tổ hợp ký tự đều hợp lệ.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates	0..1	CheckinDates	Vùng chứa một hoặc nhiều phạm vi ngày dùng để xác định thời điểm phải trả phòng để áp dụng thuế đó.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange	1..20	DateRange	Phạm vi ngày xác định thời điểm phải trả phòng để áp dụng thuế đó.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start	0..1	Date	Ngày bắt đầu (dựa trên múi giờ của cơ sở lưu trú) trong phạm vi ngày. Ngày này phải trước hoặc đúng ngày `end`. Nếu bạn không xác định `start`, phạm vi ngày sẽ không có giới hạn vì không có ngày bắt đầu.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @end	0..1	Date	Ngày kết thúc (dựa trên múi giờ của cơ sở lưu trú) trong phạm vi ngày. Ngày này phải trùng hoặc sau ngày `start`. Nếu bạn không xác định `end`, phạm vi ngày sẽ không có giới hạn vì không có ngày kết thúc.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @days_of_week	0..1	string	Các ngày trong tuần được phép sử dụng trong phạm vi ngày. Nếu bạn không chỉ định, tất cả các ngày trong tuần đều được phép sử dụng trong phạm vi ngày. Mỗi ký tự trong chuỗi xác định một ngày. Ví dụ: "MTWHF" cho biết các ngày trong tuần được cho phép trong phạm vi ngày. Các ký tự hợp lệ là: `M` đại diện cho thứ Hai `T` đại diện cho thứ Ba `W` đại diện cho thứ Tư `H` đại diện cho thứ Năm `F` đại diện cho thứ Sáu `S` đại diện cho thứ Bảy `U` đại diện cho Chủ Nhật Mọi tổ hợp ký tự đều hợp lệ.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates	0..1	CheckoutDates	Vùng chứa một hoặc nhiều phạm vi ngày dùng để xác định thời điểm phải trả phòng để áp dụng thuế đó.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange	1..20	DateRange	Phạm vi ngày xác định thời điểm phải trả phòng để áp dụng thuế đó.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start	0..1	Date	Ngày bắt đầu (dựa trên múi giờ của cơ sở lưu trú) trong phạm vi ngày. Ngày này phải trước hoặc đúng ngày `end`. Nếu bạn không xác định `start`, phạm vi ngày sẽ không có giới hạn vì không có ngày bắt đầu.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @end	0..1	Date	Ngày kết thúc (dựa trên múi giờ của cơ sở lưu trú) trong phạm vi ngày. Ngày này phải trùng hoặc sau ngày `start`. Nếu bạn không xác định `end`, phạm vi ngày sẽ không có giới hạn vì không có ngày kết thúc.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @days_of_week	0..1	string	Các ngày trong tuần được phép sử dụng trong phạm vi ngày. Nếu bạn không chỉ định, tất cả các ngày trong tuần đều được phép sử dụng trong phạm vi ngày. Mỗi ký tự trong chuỗi xác định một ngày. Ví dụ: "MTWHF" cho biết các ngày trong tuần được cho phép trong phạm vi ngày. Các ký tự hợp lệ là: `M` đại diện cho thứ Hai `T` đại diện cho thứ Ba `W` đại diện cho thứ Tư `H` đại diện cho thứ Năm `F` đại diện cho thứ Sáu `S` đại diện cho thứ Bảy `U` đại diện cho Chủ Nhật Mọi tổ hợp ký tự đều hợp lệ.
TaxFeeInfo / Property / Taxes / Tax / StayDates	0..1	StayDates	Vùng chứa một hoặc nhiều phạm vi ngày dùng để xác định xem có áp dụng thuế đó hay không, chẳng hạn như để áp dụng chiết khấu theo mùa.
TaxFeeInfo / Property / Taxes / Tax / StayDates / @application	1	enum	Mô tả cách áp dụng thuế. Các giá trị hợp lệ là: `all`: Áp dụng thuế cho mỗi đêm trong hành trình nếu tất cả các ngày trong hành trình đều trùng với ngày trong thời gian lưu trú. `any`: Áp dụng thuế cho tất cả các đêm trong hành trình nếu có bất kỳ ngày nào trong hành trình đó trùng với một ngày trong phạm vi ngày lưu trú. `overlap`: Chỉ áp dụng thuế cho những đêm trong hành trình trùng với một ngày trong thời gian lưu trú. Lưu ý: `overlap` chỉ hợp lệ khi bạn đặt `<Period>` thành `night`. Thuộc tính này phải luôn được chỉ định.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange	1..99	DateRange	Phạm vi ngày xác định các ngày sẽ áp dụng thuế.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @start	0..1	Date	Ngày bắt đầu (dựa trên múi giờ của cơ sở lưu trú) trong phạm vi ngày. Ngày này phải trước hoặc đúng ngày `end`. Nếu bạn không xác định `start`, phạm vi ngày sẽ không có giới hạn vì không có ngày bắt đầu.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @end	0..1	Date	Ngày kết thúc (dựa trên múi giờ của cơ sở lưu trú) trong phạm vi ngày. Ngày này phải trùng hoặc sau ngày `start`. Nếu bạn không xác định `end`, phạm vi ngày sẽ không có giới hạn vì không có ngày kết thúc.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @days_of_week	0..1	string	Các ngày trong tuần được phép sử dụng trong phạm vi ngày. Nếu bạn không chỉ định, tất cả các ngày trong tuần đều được phép sử dụng trong phạm vi ngày. Mỗi ký tự trong chuỗi xác định một ngày. Ví dụ: "MTWHF" cho biết các ngày trong tuần được cho phép trong phạm vi ngày. Các ký tự hợp lệ là: `M` đại diện cho thứ Hai `T` đại diện cho thứ Ba `W` đại diện cho thứ Tư `H` đại diện cho thứ Năm `F` đại diện cho thứ Sáu `S` đại diện cho thứ Bảy `U` đại diện cho Chủ Nhật Mọi tổ hợp ký tự đều hợp lệ.
TaxFeeInfo / Property / Taxes / Tax / Type	1	enum	Các giá trị hợp lệ là: `percent:` Phần trăm tổng giá `amount:` Một số tiền cố định để thêm vào giá cuối cùng
TaxFeeInfo / Property / Taxes / Tax / Basis	1	enum	Các giá trị hợp lệ là: `room:` `<Amount>` được áp dụng cho phòng này. `person:` `<Amount>` áp dụng cho mỗi người. Giá trị này chỉ áp dụng nếu bạn đặt `<Type>` thành số tiền.
TaxFeeInfo / Property / Taxes / Tax / Period	1	enum	Các giá trị hợp lệ là: `stay:` `<Amount>` được thêm vào tổng giá của khoảng thời gian lưu trú. `night:` `<Amount>` được thêm vào mỗi đêm lưu trú.
TaxFeeInfo / Property / Taxes / Tax / Currency	0..1	string	Mã đơn vị tiền tệ gồm ba chữ cái của khoản thuế (ví dụ: USD).
TaxFeeInfo / Property / Taxes / Tax / Amount	0..1	float	Giá trị phần trăm hoặc số tiền thuế.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights	0..1	ApplicableNights	Giá trị này chỉ áp dụng nếu bạn đặt `<Type>` thành amount và đặt `<Period>` thành night. Giới hạn số đêm có thể áp dụng thuế. Hãy chỉ định `max` hoặc `excluded`, chứ không chỉ định cả hai.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @max	0..1	integer	`<ApplicableNights max="N">` cho biết rằng các đêm sau N đêm đầu tiên sẽ bị loại trừ.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded	0..1	integer	`<ApplicableNights excluded="N">` cho biết rằng bạn nên loại trừ N đêm đầu tiên.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay	0..1	LengthOfStay	Xác định giới hạn thời gian lưu trú mà thuế có thể được áp dụng. Thuế sẽ không được áp dụng khi thời gian lưu trú vượt quá giới hạn tối thiểu và giới hạn tối đa.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @min	0..1	integer	Số đêm tối thiểu được phép trong khoảng thời gian lưu trú để áp dụng thuế. Nếu bạn không xác định giá trị này, thì sẽ không có giới hạn tối thiểu.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @max	0..1	integer	Số đêm tối đa được phép trong khoảng thời gian lưu trú để áp dụng thuế. Nếu bạn không xác định giá trị này, thì sẽ không có giới hạn tối đa.
TaxFeeInfo / Property / Taxes / Tax / Brackets	0..1	Brackets	Vùng chứa một hoặc nhiều phần tử `<Bracket>`. Xác định một bộ khung thuế liền kề và không chồng chéo. Ví dụ: thuế thuộc nhóm GST (Thuế hàng hoá và dịch vụ) của Ấn Độ. Phần tử này chỉ hợp lệ khi bạn đặt `<Period>` thành `night` và chưa chỉ định `<Amount>`.
TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount	0..1	float	Giá trị phần trăm hoặc số tiền thuế, áp dụng cho giá mỗi đêm thấp hơn giá trị `starts_at` của khung thuế đầu tiên.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket	1..n	Bracket	Xác định khung thuế dựa trên giá mỗi đêm.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at	1	float	Xác định giới hạn dưới của khung thuế. Giới hạn trên được chỉ định trong trường `starts_at` của khung thuế tiếp theo. Không có giới hạn trên cho khung thuế cuối cùng. Khung thuế sẽ có hiệu lực khi giá mỗi đêm lớn hơn hoặc bằng giá trị `starts_at` của khung thuế và thấp hơn giá trị `starts_at` của khung thuế tiếp theo. Giá trị này phải hoàn toàn lớn hơn 0.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount	1	float	Giá trị phần trăm hoặc số tiền thuế áp dụng cho khung thuế này.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets	0..1	AgeBrackets	Cho phép chỉ định một nhóm thuế dựa trên độ tuổi của khách lưu trú. Phần tử này chỉ hợp lệ khi bạn không chỉ định `<Brackets>` và `<Amount>`, `<Basis>` được đặt thành `person` và `<Type>` được đặt thành `amount`.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge	0..1	AdultCharge	Vùng chứa để xác định thuế cho người lớn.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount	1	float	Mức thuế cố định áp dụng cho người lớn.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets	0..1	ChildAgeBrackets	Vùng chứa lưu giữ một hoặc nhiều phần tử `<ChildAgeBracket>`.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket	1..n	ChildAgeBracket	Xác định độ tuổi cho trẻ em và số tiền thuế tương ứng.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age	1	integer	Xác định giới hạn trên cho độ tuổi của trẻ. Giới hạn dưới được chỉ định trong trường `max_age` 1 của dấu ngoặc trước. Cả hai giới hạn trên và giới hạn dưới đều bao gồm. Giới hạn dưới cho dấu ngoặc đầu tiên là 0. `max_age` phải nằm trong khoảng từ 0 đến 17 (bao gồm).
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount	1	float	Mức thuế cố định áp dụng cho trẻ em trong độ tuổi này.
TaxFeeInfo / Property / Taxes / Tax / UserCountries	0..1	UserCountries	Vùng chứa để liệt kê các quốc gia có bao gồm hoặc không bao gồm thuế. Nếu có, thuế sẽ chỉ được thêm vào hoặc bị loại trừ cho người dùng ở những quốc gia được chỉ định.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type	0..1	enum	Loại thông số kỹ thuật UserCountry. Các giá trị hợp lệ là `include` và `exclude`. Nếu bạn đặt `type` theo quốc gia là `include`, thì thuế sẽ chỉ áp dụng cho người dùng ở những quốc gia trong danh sách. Trong khi đó, nếu UserCountry `type` là `exclude`, thì thuế sẽ chỉ áp dụng cho người dùng bên ngoài các quốc gia trong danh sách. Nếu bạn không đặt chính sách `type` quốc gia của người dùng, chúng tôi sẽ coi thuộc tính này là `include` và thuế sẽ chỉ áp dụng cho người dùng ở các quốc gia trong danh sách.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country	1..n	Country	Xác định một quốc gia trong danh sách UserCountry.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code	1	string	Mã CLDR, chẳng hạn như `DE` hoặc `FR`. Xin lưu ý rằng đối với một số quốc gia, mã quốc gia theo CLDR không giống với mã quốc gia gồm 2 chữ cái theo ISO. Ngoài ra, mã vùng CLDR không được hỗ trợ.
TaxFeeInfo / Property / Fees	0..1	Fees	Vùng chứa một hoặc nhiều phần tử `<Fee>`.
TaxFeeInfo / Property / Fees / Fee	1..n	Fee	Một loại phí riêng biệt áp dụng cho cơ sở lưu trú. Tất cả các phần tử con của `<Tax>` đều được hỗ trợ đối với `<Fee>` có cú pháp tương tự.

Ví dụ

Thông báo cơ bản

Thông báo cơ bản của TaxFeeInfo:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-05-18T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>10.00</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>person</Basis>
        <Period>night</Period>
        <Currency>USD</Currency>
        <Amount>5.00</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Xóa thuế

Xóa tất cả thuế và phí cấp cơ sở lưu trú cho khách sạn được chỉ định:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-06-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key"
  <Property action="overlay"/>
    <ID>Property_1</ID>
  </Property>
</TaxFeeInfo>

Thuế theo nhóm

Thuế thuộc nhóm GST của Ấn Độ, áp dụng dựa trên giá mỗi đêm. Khung thuế là:

Không tính thuế nếu giá mỗi đêm nhỏ hơn hoặc bằng 1.000.
12% thuế nếu giá mỗi đêm lớn hơn 1000 và nhỏ hơn hoặc bằng 7500.
18% thuế nếu giá mỗi đêm lớn hơn 7500.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-05-18T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Brackets base_amount="0">
          <Bracket starts_at="1000.01" amount="12"/>
          <Bracket starts_at="7500.01" amount="18"/>
        </Brackets>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Thuế theo độ tuổi

Mức thuế được áp dụng dựa trên độ tuổi của người cư trú:

Thuế $20 đối với người lớn.
Thuế $ 10 cho trẻ em từ 11 đến 17 tuổi.
Thuế $ 5 cho trẻ em từ 0 đến 10 tuổi.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-05-18T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>person</Basis>
        <Period>night</Period>
        <AgeBrackets>
          <AdultCharge amount="20"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="10" amount="5"/>
            <ChildAgeBracket max_age="17" amount="10"/>
          </ChildAgeBrackets>
        </AgeBrackets>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Nội dung trả lời

Cú pháp

Thông báo TaxFeeInfoResponse sử dụng cú pháp sau:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfoResponse timestamp="timestamp"
                    id="message_ID"
                    partner="partner_key">
  <!-- Either Success or Issues will be populated. -->
  <Success/>
  <Issues>
    <Issue code="issue_code" status="issue_type">issue_description</Issue>
  </Issues>
</TaxFeeInfoResponse>

Phần tử và thuộc tính

Thông báo TaxFeeInfoResponse có các phần tử và thuộc tính sau:

Phần tử / @Thuộc tính	Số lần xuất hiện	Loại	Nội dung mô tả
TaxFeeInfoResponse	1	Complex element	Phần tử gốc cho biết thông báo yêu cầu TaxFeeInfo nhận được thành công hay gặp vấn đề.
TaxFeeInfoResponse / @timestamp	1	DateTime	Ngày và giờ tạo thông báo này.
TaxFeeInfoResponse / @id	1	string	Giá trị nhận dạng duy nhất lấy từ thông báo TaxFeeInfo tương ứng.
TaxFeeInfoResponse / @partner	1	string	Tài khoản đối tác của thông báo này.
TaxFeeInfoResponse / Success	0..1	Success	Cho biết rằng thông báo TaxFeeInfo đã được xử lý thành công mà không có cảnh báo, lỗi hoặc thất bại. Có thông báo `<Success>` hoặc `<Issues>` trong mỗi thông báo.
TaxFeeInfoResponse / Issues	0..1	Issues	Vùng chứa một hoặc nhiều vấn đề gặp phải trong quá trình xử lý thông báo `TaxFeeInfo`. Có thông báo `<Success>` hoặc `<Issues>` trong mỗi thông báo.
TaxFeeInfoResponse / Issues / Issue	1..n	Issue	Thông tin mô tả về cảnh báo, lỗi hoặc lượt xử lý hỏng trong quá trình xử lý thông báo TaxFeeInfo. Bạn có thể xem chi tiết về các vấn đề này trong Thông báo lỗi về trạng thái của nguồn cấp dữ liệu.
TaxFeeInfoResponse / Issues / Issue / @code	1	integer	Giá trị nhận dạng của vấn đề.
TaxFeeInfoResponse / Issues / Issue / @status	1	enum	Loại vấn đề gặp phải. Các giá trị hợp lệ là `warning`, `error`, và `failure` .

Ví dụ

Thành công

Dưới đây là phản hồi cho một thông báo TaxFeeInfo được xử lý thành công.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfoResponse timestamp="2020-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</TaxFeeInfoResponse>

Vấn đề

Dưới đây là phản hồi cho thông báo TaxFeeInfo không được xử lý do gặp lỗi.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfoResponse timestamp="2020-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Issues>
    <Issue code="1001" status="error">Example</Issue>
  </Issues>
</TaxFeeInfoResponse>