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

Thông báo về thuế và phí

Tổng quan

Thông báo TaxFeeInfo xác định các khoản thuế và phí áp dụng cho người dùng khi đặt phòng tại một cơ sở lưu trú và dựa trên các quy định về thuế của cơ sở lưu trú được nêu trên trang web. Để thêm dữ liệu về thuế và phí, bạn sử dụng thông báo về Giá (OTA_HotelRateAmountNotifRQ).

Thao tác duy nhất được hỗ trợ cho thông báo này là overlay. Thao tác này được dùng để thay thế dữ liệu thuế và phí cho từng cơ sở lưu trú. Bạn cần gửi thông tin cập nhật về thuế và phí mỗi khi có thay đổi.

Để biết thêm thông tin về cách gửi thuế và phí, cũng như thông tin chi tiết cụ thể về giá cho mức giá của bạn, hãy tham khảo Chính sách về thuế và phí.

Các phương thức thêm thuế và phí

Có hai cách chung để thêm thuế và phí:

Trong phương thức đầu tiên, bạn chỉ định AmountAfterTax trong thông báo Giá; bạn thêm thuế và phí bằng cách gửi thông báo giá có cả giá cơ sở mỗi đêm (không bao gồm tất cả các khoản thuế và phí) và tổng giá mỗi đêm (bao gồm tất cả các khoản thuế và phí). Vì các mức giá này là giá mỗi đêm, nên phương pháp này chỉ áp dụng cho thuế và phí dựa trên tỷ lệ phần trăm hoặc số tiền cố định mỗi đêm, đồng thời bạn không thể sử dụng thuế và phí cho mỗi lượt lưu trú.

Phương thức thứ hai (ưu tiên) là chỉ gửi giá cơ sở theo đêm không bao gồm thuế và phí trong thông báo về giá, đồng thời sử dụng TaxFeeInfo để truyền đạt thuế và phí ở cấp cơ sở lưu trú. Bạn vẫn có thể đặt phạm vi cho từng khoản thuế và phí theo loại phòng và gói giá cụ thể, áp dụng cho một số phạm vi ngày nhất định.

Trang này chỉ mô tả và đề cập đến phương thức ưu tiên sử dụng TaxFeeInfo chứ không phải phương thức chỉ định AmountAfterTax trong thông báo Tỷ lệ (OTA_HotelRateAmountNotifRQ).

Các phương thức thiết lập thuế

Bạn có thể chọn một trong các phương án sau để thiết lập thuế:

Cơ sở = [room|person]
Khoảng thời gian = [stay|night]
Loại = [percent|amount]

Khi Period là stay và Type là percent, Google sẽ áp dụng thuế và phí cho toàn bộ thời gian lưu trú ngay cả khi một ngày trong hành trình trùng với phạm vi StayDates. Bạn không thể chỉ định áp dụng thuế và phí nếu TẤT CẢ các ngày trong hành trình đều trùng với phạm vi ngày lưu trú. Đối với nhiều phạm vi ngày lưu trú trùng nhau, các phạm vi StayDates được chỉ định trong một phạm vi mở duy nhất. Tham khảo TaxFeeInfoví dụ.

Để xem ví dụ về nhiều trường hợp liên quan đến thuế, hãy xem phần Hướng dẫn. Các ví dụ này đề cập đến một số trường hợp thuế phổ biến nhất, bao gồm cả hướng dẫn về:

Thuế cố định và thuế theo tỷ lệ phần trăm áp dụng cho mỗi cơ sở lưu trú
Thuế theo tỷ lệ phần trăm chỉ áp dụng cho những đêm sau đêm đầu tiên
Phương thức thay thế thuế cũ bằng thuế mới
Thêm hoặc bớt thuế cho các quốc gia
Đặt thuế theo bậc với các mức thuế
Thiết lập thuế và phí chịu thuế

Các phần sau đây trình bày hướng dẫn chung, ví dụ cơ bản và các tình huống hướng dẫn để giúp bạn bắt đầu thêm và cập nhật thông tin thuế.

Phần tử bắt buộc và không bắt buộc

Tài liệu tham khảo XML cung cấp nội dung mô tả về các phần tử bắt buộc và không bắt buộc. Để biết thông tin chi tiết về các thuộc tính và phần tử con, hãy xem TaxFeeInfo Phần tử và thuộc tính.

Cú pháp và giản đồ

Hãy tham khảo ví dụ về Cú pháp TaxFeeInfo khi bạn tạo thông báo để đảm bảo bạn đang tuân theo đúng định dạng. Bạn có thể sử dụng một công cụ XML của bên thứ ba như xmllint để xác thực nguồn cấp dữ liệu bằng các giản đồ đã xuất bản trước khi gửi nguồn cấp dữ liệu cho Google. Để biết lược đồ thông báo TaxFeeinfo, hãy xem Lược đồ quảng cáo khách sạn.

Nguyên tắc

Phần này trình bày các nguyên tắc chung và hướng dẫn đặc biệt để thiết lập thuế và phí.

Thao tác

Lớp phủ: Sử dụng thao tác overlay để thay thế tất cả các khoản thuế cho một tài sản. Thao tác overlay là thao tác mặc định và duy nhất được hỗ trợ. Mọi khoản thuế và phí trước đó cho cơ sở lưu trú này sẽ bị xoá sau khi bạn áp dụng bản cập nhật này.

Giải pháp chung

Mỗi Tax được đánh giá và tính toán (nếu có) dựa trên số tiền AmountBeforeTax mà bạn đã chỉ định trong BaseByGuestAmt.
Sau khi tính toán tất cả các khoản thuế và phí hiện hành, các khoản này sẽ được cộng vào giá cơ bản để tạo thành tổng giá.
Cú pháp cho <Tax> và <Fee> là như nhau.
Thuế và phí có thể có các hạn chế, chẳng hạn như:
- Chỉ áp dụng cho một số loại phòng và gói giá cụ thể.
- Chỉ áp dụng cho một số ngày lưu trú cụ thể.
Đây là các điều kiện ràng buộc không bắt buộc và bạn không cần phải đặt mọi loại điều kiện ràng buộc; bạn có thể bỏ trống các điều kiện này nếu điều kiện đó áp dụng cho tất cả.
Gửi thông tin cập nhật TaxFeeInfo mỗi khi có thay đổi về thuế hoặc phí.

Ví dụ:

Phần này cung cấp một ví dụ cơ bản về thông báo TaxFeeInfo bằng cách sử dụng các phần tử bắt buộc và không bắt buộc. Sau khi chuẩn bị tệp, bạn sẽ cần gửi tệp đó cho Google bằng cách sử dụng thông báo POST đến điểm cuối này:

https://www.google.com/travel/hotels/uploads/taxes

Để tìm hiểu thêm về cách gửi/POST thông báo, hãy xem phần Gửi thông báo.

Đối với thuộc tính hotel_id, hãy sử dụng mã nhận dạng duy nhất của khách sạn mà bạn đã dùng trong hệ thống để xác định 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 <id> trong phần tử <listing> trong nguồn cấp dữ liệu Danh sách khách sạn. Tính nhất quán với hệ thống của bạn là yếu tố quan trọng để đảm bảo rằng Google đang hiển thị dữ liệu của bạn một cách chính xác.

Ví dụ này cho biết cách đặt tỷ lệ phần trăm thuế là 10% và số tiền phí là 50 đô la cho một cơ sở lưu trú cho tổng thời gian lưu trú (không phải mỗi đêm):

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-20T16:20:00-04:00"
            partner="partner_key"
            id="12345678">
  <Property>
    <ID>HOTELID</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>10</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>50</Amount>
        <Currency>USD</Currency>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Để xem ví dụ về cách thêm thuế liên quan đến độ tuổi và các ví dụ khác, hãy xem Ví dụ về thuế.

Hướng dẫn

Phần này cung cấp giải pháp cho những trường hợp bạn có thể gặp phải khi thiết lập thuế và phí.

Tình huống 1: Cách thêm thuế cố định

Ví dụ về thuế này cho thấy cách đặt thuế cố định cho mỗi cơ sở lưu trú.

Mô tả

Bạn muốn áp dụng thuế cố định cho phòng hoặc lượt lưu trú cho mỗi cơ sở lưu trú thay vì thuế theo tỷ lệ phần trăm.

Giải pháp

Sử dụng amount thay vì percentage để thêm lựa chọn thuế cố định.

Mẫu

Ví dụ này cho thấy cách thêm thuế cố định bằng cách sử dụng amount thay vì percentage:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>30</Amount>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Tình huống 2: Cách nhắm đến thuế bằng `ApplicableNights`

Mô tả

Bạn chỉ muốn áp dụng thuế phí cố định cho những đêm sau đêm đầu tiên. Ví dụ: có một khoản phí bắt buộc cho việc sử dụng hằng ngày một tiện nghi nhất định, khoản phí này không bao gồm trong đêm đầu tiên, trong khi(các) khách không có cơ hội sử dụng tiện nghi cụ thể đó.

Giải pháp

Sử dụng <ApplicableNights excluded="1"/> để kiểm soát những đêm có áp dụng thuế.

Mẫu

Mẫu này cho biết cách sử dụng ApplicableNights:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Amount>50</Amount>
        <ApplicableNights excluded="1"/>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Trường hợp 3: Cách thay thế thuế và phí cũ bằng thuế và phí mới

Mô tả

Các khoản thuế và phí hiện tại đã thay đổi và cần được thay thế bằng các khoản thuế và phí mới.

Giải pháp

Sử dụng thao tác overlay để xoá tất cả các khoản thuế và phí hiện có.

Mẫu

Ví dụ sau đây minh hoạ cách xoá tất cả thuế và phí của một cơ sở lưu trú:

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

Tình huống 4: Cách thêm hoặc loại trừ thuế cho các quốc gia

Mô tả

Bạn cần phải thêm thuế cho một số quốc gia trong khi loại trừ thuế ở một số quốc gia khác. Ví dụ: bạn cần loại trừ thuế cho một liên minh nhỏ hơn có thuế không thuộc Liên minh Châu Âu trong khi tính thuế cho tất cả các quốc gia khác.

Giải pháp

Sử dụng các lựa chọn include hoặc exclude cho UserCountries type. Sử dụng include để chỉ áp dụng thuế cho quốc gia được liệt kê hoặc sử dụng exclude để áp dụng thuế cho tất cả các quốc gia, ngoại trừ quốc gia được liệt kê.

Mẫu

Ví dụ sau đây cho biết cách đặt thuế cho người dùng bên ngoài quốc gia của khách sạn (Israel):

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16: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>
        <UserCountries type="exclude">
          <Country code="IL"/>
        </UserCountries>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Tình huống 5: Cách thiết lập thuế theo bậc có khoảng giá

Mô tả

Bạn muốn thêm thuế thuộc nhóm GST áp dụng dựa trên giá mỗi đêm.

Giải pháp

Trong trường hợp này, giả sử các mức thuế GST của quốc gia mục tiêu là:

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.

Mẫu

Ví dụ sau đây cho thấy cách thiết lập thuế theo bậc với các mức thuế:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-28T16: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>

Trường hợp 6: Cách thiết lập thuế và phí chịu thuế

Mô tả

Bạn muốn thêm một loại thuế như thuế GTGT và một khoản phí dịch vụ khác cũng áp dụng cho loại thuế đó.

Giải pháp

Tình huống này xem xét 2 ví dụ về trường hợp sử dụng phí chịu thuế:

Cả thuế và phí chịu thuế đều được xác định là khoản phí tính theo tỷ lệ phần trăm.
Thuế là một khoản phí tính theo tỷ lệ phần trăm, còn phí chịu thuế là một khoản tiền cố định cho mỗi lượt lưu trú.

Ví dụ

Phí có tính thuế theo tỷ lệ phần trăm

Ví dụ này có AmountBeforeTax là 100 USD, thuế GST là 18% và phí dịch vụ bổ sung là 5% – tổng tỷ lệ phần trăm phí chịu thuế là 5,9% (5*1,18) và tổng số tiền thuế là 123,90 USD [= 118 USD (18% GST) + 5,9 USD (5,9% phí dịch vụ)].

Đoạn mã sau đây xác định thuế (GST) và phí chịu thuế (phí dịch vụ) theo tỷ lệ phần trăm:

<TaxFeeInfo timestamp="2022-08-16T16: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>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>5.9</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Phí chịu thuế dưới dạng số tiền

Ví dụ này có AmountBeforeTax là 100 USD, thuế GST là 18% và một khoản phí cố định bổ sung là 20 USD, khiến tổng phí chịu thuế là 23,6 USD (20 USD*1,18) và tổng số tiền thuế là 141,6 USD [= 118 USD (18% GST) + 23,6 USD (20 USD phí cố định)].

Đoạn mã sau đây xác định thuế (GST) theo tỷ lệ phần trăm và phí chịu thuế (phí dịch vụ) dưới dạng số tiền cố định:

<TaxFeeInfo timestamp="2022-08-16T16: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>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>23.6</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Thông báo về thuế và phí Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Tổng quan

Các phương thức thêm thuế và phí

Các phương thức thiết lập thuế

Phần tử bắt buộc và không bắt buộc

Cú pháp và giản đồ

Nguyên tắc

Thao tác

Giải pháp chung

Ví dụ:

Hướng dẫn

Tình huống 1: Cách thêm thuế cố định

Mô tả

Giải pháp

Mẫu

Tình huống 2: Cách nhắm đến thuế bằng ApplicableNights

Mô tả

Giải pháp

Mẫu

Trường hợp 3: Cách thay thế thuế và phí cũ bằng thuế và phí mới

Mô tả

Giải pháp

Mẫu

Tình huống 4: Cách thêm hoặc loại trừ thuế cho các quốc gia

Mô tả

Giải pháp

Mẫu

Tình huống 5: Cách thiết lập thuế theo bậc có khoảng giá

Mô tả

Giải pháp

Mẫu

Trường hợp 6: Cách thiết lập thuế và phí chịu thuế

Mô tả

Giải pháp

Ví dụ

Phí có tính thuế theo tỷ lệ phần trăm

Phí chịu thuế dưới dạng số tiền

Thông báo về thuế và phí

Tình huống 2: Cách nhắm đến thuế bằng `ApplicableNights`