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|cumulative_percent]</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>
<Rank>integer</Rank>
</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|cumulative_percent]</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>
<Rank>integer</Rank>
</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 | 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ự được phép là a-z , A-Z , 0-9 , _ (dấu gạch dưới) và - (dấu gạch nối). |
TaxFeeInfo / @partner | 1 | string | Tài khoản đối tác dùng cho thông báo này. Giá trị của chuỗi này là giá trị của "Khoá đố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ợ cung cấp 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ị thuộc tính |
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ỉ hỗ trợ overlay và mặc định là overlay . Mọi Taxes và Fees trước đó cho 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 mà khoản thuế áp dụng.
Thuế sẽ áp dụng cho mỗi <RoomType> được chỉ định. Nếu bạn không xác định <RoomTypes> , thuế sẽ áp dụng cho tất cả phòng. |
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType | 1..n | RoomType | Chỉ đị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ủa cơ sở lưu trú) và như được xác định bằng RoomID. (Giá trị <RoomID> còn được thuộc tính InvTypeCode trong các thông báo OTA_HotelRateAmountNotifRQ tham chiếu.) |
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id | 1 | string | Giá trị nhận dạng duy nhất của 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ủa 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 | Chỉ định một gói giá. Gói giá được xác định 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ủa 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 liên kết với giá trị PackageID trong <PackageData> của thông báo Giao dịch (Dữ liệu của cơ sở lưu trú) và giá trị RatePlanCode được đặt theo thuộc tính <StatusApplicationControl> trong 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ế này. |
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start | 0..1 | Date | Ngày bắt đầu (sử dụng 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 trùng với 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 (sử dụng 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 | 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 chỉ định một ngày. Ví dụ: "MTWHF" cho biết là được phép sử dụng các ngày làm việc trong tuần trong phạm vi ngày. Các ký tự hợp lệ là:
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 nhận 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 nhận phòng để áp dụng thuế. |
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start | 0..1 | Date | Ngày bắt đầu (sử dụng 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 trùng với 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 (sử dụng 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 | 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 chỉ định một ngày. Ví dụ: "MTWHF" cho biết là được phép sử dụng các ngày làm việc trong tuần trong phạm vi ngày. Các ký tự hợp lệ là:
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 (sử dụng 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 giống với 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 (sử dụng 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 | 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 chỉ định một ngày. Ví dụ: "MTWHF" cho biết là được phép sử dụng các ngày làm việc trong tuần trong phạm vi ngày. Các ký tự hợp lệ là:
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 để xác định liệu 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ế. Các giá trị hợp lệ là:
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 những ngày sẽ áp dụng thuế. |
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @start | 0..1 | Date | Ngày bắt đầu (sử dụng 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 trùng với 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 (sử dụng 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 | 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 chỉ định một ngày. Ví dụ: "MTWHF" cho biết là được phép sử dụng các ngày làm việc trong tuần trong phạm vi ngày. Các ký tự hợp lệ là:
Mọi tổ hợp ký tự đều hợp lệ. |
TaxFeeInfo / Property / Taxes / Tax / Type | 1 | enum | Các giá trị hợp lệ là:
Bạn không thể chỉ định |
TaxFeeInfo / Property / Taxes / Tax / Basis | 1 | enum | Các giá trị hợp lệ là:
|
TaxFeeInfo / Property / Taxes / Tax / Period | 1 | enum |
Các giá trị hợp lệ là:
|
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).
Lưu ý: Nếu bạn không chỉ định |
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> là amount và đặt <Period> là night.
Giới hạn số đêm có thể áp dụng thuế. Hãy chỉ định |
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @max | 0..1 | integer | <ApplicableNights max="N"> cho biết rằng bạn nên loại trừ các đêm sau N đêm đầu tiên. |
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded | 0..1 | integer | <ApplicableNights excluded="N"> cho biết 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 nếu thời gian lưu trú nằm ngoài giới hạn tối thiểu và 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ó số đêm 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 tập hợp các khung thuế có liên quan với nhau và không chồng chéo. Ví dụ: thuế thuộc nhóm GST của Ấn Độ.
Phần tử này chỉ hợp lệ khi bạn đặt |
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 Một khung thuế sẽ được áp dụng khi giá mỗi đêm lớn hơn hoặc bằng giá trị 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 bộ thuế dựa trên độ tuổi của người lưu trú.
Phần tử này chỉ hợp lệ khi bạn không chỉ định |
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge | 0..1 | AdultCharge | Vùng chứa để chỉ định thuế cho người lớn. |
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount | 1 | float | Số tiền 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 của 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 về độ tuổi của trẻ. Giới hạn dưới được chỉ định trong trường
|
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount | 1 | float | Số tiền 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ủa người dùng có thuế được bao gồm hoặc không bao gồm thuế. Nếu có, thuế sẽ chỉ được tính hoặc không được tính cho người dùng ở các quốc gia được chỉ định. |
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type | 0..1 | enum | Loại thông số kỹ thuật UserCountries.
Các giá trị hợp lệ là Nếu bạn đặt Trong khi đó, nếu Nếu bạn không đặt |
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country | 1..n | Country | Xác định một quốc gia trong danh sách UserCountries. |
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code | 1 | string | Mã quốc gia theo CLDR, chẳng hạn như DE hoặc FR . Lưu ý: đố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 ký tự theo ISO. Ngoài ra, mã vùng CLDR không được hỗ trợ. |
TaxFeeInfo / Property / Taxes / Tax / Rank | 1 | integer | Hạng xác định thứ tự áp dụng cho khoản thuế hoặc phí này.
Ví dụ: giá trị 2 có nghĩa là thuế này sẽ được áp dụng thứ hai.
Bạn phải luôn chỉ định phần tử này nếu
|
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 |
Ví dụ
Mỗi cơ sở lưu trú chỉ được có tối đa 300 khoản thuế và phí. Hãy tham khảo ví dụ "Xoá thuế" để xoá thuế và phí khỏi một cơ sở lưu trú.
Thông báo cơ bản
Thông báo TaxFeeInfo
cơ bản:
<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-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>
Xoá thuế
Xoá 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="2024-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ế:
- Không tính thuế nếu giá mỗi đêm nhỏ hơn hoặc bằng 1.000.
- Thuế 12% nếu giá mỗi đêm lớn hơn 1.000 và nhỏ hơn hoặc bằng 7.500.
- Thuế 18% nếu giá mỗi đêm trên 7.500.
<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-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ế dựa trên độ tuổi
Thuế được áp dụng dựa trên độ tuổi của người lưu trú:
- Thuế 20 USD cho người lớn lưu trú.
- Thuế 10 USD đối với trẻ em từ 11 đến 17 tuổi.
- Thuế 5 USD cho trẻ em từ 0 đến 10 tuổi.
<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-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>
Phản hồ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 | 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 lỗi. |
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 dùng cho 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 lượt xử lý hỏng nào.
|
TaxFeeInfoResponse / Issues | 0..1 | Issues | Vùng chứa một hoặc nhiều sự cố xảy ra trong quá trình xử lý thông báo TaxFeeInfo .
Mỗi thông báo có |
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 thông tin 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à |
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="2024-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="2024-05-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<Issues>
<Issue code="1001" status="error">Example</Issue>
</Issues>
</TaxFeeInfoResponse>