หน้านี้ได้รับการแปลโดย Cloud Translation API

ข้อความภาษีและค่าธรรมเนียม

ภาพรวม

ข้อความ TaxFeeInfo จะกำหนดภาษีและค่าธรรมเนียมที่เกี่ยวข้องกับผู้ใช้เมื่อจองที่พัก และอิงตามกฎระเบียบด้านภาษีของที่พักที่ระบุไว้ในเว็บไซต์ หากต้องการเพิ่มข้อมูลภาษีและค่าธรรมเนียม ให้ใช้ข้อความเกี่ยวกับราคา (OTA_HotelRateAmountNotifRQ)

การดำเนินการเดียวที่รองรับสำหรับข้อความนี้คือ overlay ซึ่งใช้เพื่อแทนที่ ข้อมูลภาษีและค่าธรรมเนียมสำหรับที่พักแต่ละแห่ง คุณต้องส่งข้อมูลอัปเดตภาษีและค่าธรรมเนียม ทุกครั้งที่มีการเปลี่ยนแปลง

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีส่งภาษีและค่าธรรมเนียม รวมถึงรายละเอียดราคาที่เฉพาะเจาะจงสำหรับอัตราของคุณได้ที่นโยบายภาษีและค่าธรรมเนียม

วิธีการเพิ่มภาษีและค่าธรรมเนียม

การเพิ่มภาษีและค่าธรรมเนียมทำได้ 2 วิธีหลักๆ ดังนี้

ในวิธีแรก คุณจะระบุ AmountAfterTax ในข้อความราคาได้ โดยเพิ่มภาษีและค่าธรรมเนียมด้วยการส่งข้อความราคาที่มีทั้งราคาฐานต่อคืน (ไม่รวมภาษีและค่าธรรมเนียมทั้งหมด) และราคารวมต่อคืน (รวมภาษีและค่าธรรมเนียมทั้งหมด) เนื่องจากราคาเหล่านี้เป็นราคาต่อคืน วิธีนี้จึงใช้ได้กับภาษีและค่าธรรมเนียมแบบเปอร์เซ็นต์หรือจำนวนเงินคงที่ต่อคืนเท่านั้น และใช้ภาษีและค่าธรรมเนียมต่อการเข้าพักไม่ได้

วิธีที่ 2 (แนะนำ) คือการส่งเฉพาะราคาฐานแบบค้างคืนที่ไม่มีภาษีและค่าธรรมเนียมในข้อความราคา และใช้ TaxFeeInfo เพื่อสื่อถึงภาษีและค่าธรรมเนียมที่ระดับที่พัก คุณยังคงกำหนดขอบเขตภาษีและค่าธรรมเนียมแต่ละรายการให้แก่ประเภทห้องพักและแพ็กเกจราคาที่เฉพาะเจาะจงซึ่งใช้ได้กับช่วงวันที่ที่กำหนดได้

หน้านี้อธิบายและอ้างอิงเฉพาะวิธีการที่ต้องการใช้ TaxFeeInfo และไม่ใช่การระบุ AmountAfterTax ในข้อความอัตรา (OTA_HotelRateAmountNotifRQ)

วิธีการตั้งค่าภาษี

คุณมีตัวเลือกต่อไปนี้ในการตั้งค่าภาษี

Basis = [room|person]
Period = [stay|night]
ประเภท = [เปอร์เซ็นต์|จำนวน]

เมื่อ Period เป็น stay และ Type เป็น percent Google จะเรียกเก็บภาษีและค่าธรรมเนียมสำหรับการเข้าพักทั้งหมด แม้ว่าวันที่เดียวในแผนการเดินทางจะทับซ้อนกับช่วง StayDates ก็ตาม คุณไม่สามารถระบุให้เรียกเก็บภาษีและค่าธรรมเนียมเฉพาะในกรณีที่วันที่ทั้งหมดในแผนการเดินทางซ้อนทับกับช่วงวันที่เข้าพัก สำหรับช่วงวันที่เข้าพักหลายช่วงที่ทับซ้อนกัน ระบบจะระบุช่วง StayDates ในช่วงเปิดช่วงเดียว ดูTaxFeeInfoตัวอย่าง

ดูตัวอย่างสถานการณ์ต่างๆ ที่เกี่ยวข้องกับภาษีได้ที่วิธีการ ตัวอย่างครอบคลุมสถานการณ์ด้านภาษีที่พบบ่อยบางส่วน รวมถึงวิธีการสำหรับสถานการณ์ต่อไปนี้

ภาษีแบบคงที่และภาษีแบบเปอร์เซ็นต์ที่ใช้กับที่พักแต่ละแห่ง
ภาษีเปอร์เซ็นต์ใช้กับคืนหลังจากคืนแรกเท่านั้น
วิธีแทนที่ภาษีเก่าด้วยภาษีใหม่
รวมหรือยกเว้นภาษีสำหรับประเทศ
ตั้งค่าภาษีแบบขั้นบันไดพร้อมวงเล็บ
ตั้งค่าภาษีและค่าธรรมเนียมที่ต้องเสียภาษี

ส่วนต่อไปนี้ครอบคลุมหลักเกณฑ์ทั่วไป ตัวอย่างพื้นฐาน และสถานการณ์วิธี การที่จะช่วยให้คุณเริ่มต้นเพิ่มและอัปเดตข้อมูลภาษีได้

องค์ประกอบที่จำเป็นและไม่บังคับ

การอ้างอิง XML จะอธิบายองค์ประกอบที่จำเป็นและที่ไม่บังคับ ดูรายละเอียด เกี่ยวกับแอตทริบิวต์และองค์ประกอบย่อยได้ที่ องค์ประกอบและแอตทริบิวต์ของ TaxFeeInfo

ไวยากรณ์และสคีมา

ใช้ตัวอย่างTaxFeeInfoไวยากรณ์ เป็นข้อมูลอ้างอิงเมื่อสร้างข้อความเพื่อให้มั่นใจว่าคุณ ใช้รูปแบบที่ถูกต้อง คุณสามารถใช้เครื่องมือ XML ของบุคคลที่สาม เช่น xmllint เพื่อตรวจสอบความถูกต้องของฟีดด้วยสคีมาที่เผยแพร่แล้วก่อนส่งไปยัง Google สำหรับTaxFeeinfoสคีมาข้อความ โปรดดูสคีมาโฆษณาโรงแรม

หลักเกณฑ์

ส่วนนี้ครอบคลุมหลักเกณฑ์ทั่วไปและวิธีการพิเศษสำหรับการตั้งค่า ภาษีและค่าธรรมเนียม

การดำเนินการ

ซ้อนทับ: ใช้การดำเนินการ overlay เพื่อแทนที่ภาษีทั้งหมดสำหรับพร็อพเพอร์ตี้ overlay การดำเนินการเป็นค่าเริ่มต้นและเป็นการดำเนินการเดียวที่รองรับ ระบบจะล้างภาษีและค่าธรรมเนียมก่อนหน้านี้ของที่พักนี้เมื่อใช้การอัปเดตนี้

ทั่วไป

Tax แต่ละรายการจะได้รับการประเมินและคำนวณ (หากมี) โดยอิงตามจำนวน AmountBeforeTax ที่ระบุไว้ใน BaseByGuestAmt
หลังจากคำนวณภาษีและค่าธรรมเนียมที่เกี่ยวข้องทั้งหมดแล้ว ระบบจะเพิ่มภาษีและค่าธรรมเนียมเหล่านั้นลงในราคาฐานเพื่อกำหนดราคาโดยรวม
ไวยากรณ์สำหรับ <Tax> และ <Fee> จะเหมือนกัน
ภาษีและค่าธรรมเนียมอาจมีข้อจำกัด เช่น
- ใช้ได้กับประเภทห้องพักและแพ็กเกจราคาที่เฉพาะเจาะจงเท่านั้น
- มีผลกับวันที่เข้าพักที่เฉพาะเจาะจงเท่านั้น
ข้อจำกัดเหล่านี้เป็นแบบไม่บังคับ และคุณไม่จำเป็นต้องตั้งค่าข้อจำกัดทุกประเภท คุณสามารถปล่อยให้ว่างไว้ได้หากใช้ได้กับทุกประเภท
ส่งข้อมูลอัปเดต TaxFeeInfo ทุกครั้งที่มีการเปลี่ยนแปลงภาษีหรือค่าธรรมเนียม

ตัวอย่าง

ส่วนนี้แสดงตัวอย่างพื้นฐานของข้อความ TaxFeeInfo โดยใช้องค์ประกอบที่จำเป็น และองค์ประกอบที่ไม่บังคับ เมื่อเตรียมไฟล์แล้ว คุณจะต้องส่งไฟล์ไปยัง Google โดยใช้ข้อความ POST ไปยังปลายทางนี้

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีพุช/POST ข้อความได้ที่การพุชข้อความ

สำหรับแอตทริบิวต์ hotel_id ให้ใช้รหัสโรงแรมที่ไม่ซ้ำกัน ที่คุณใช้ภายในระบบเพื่อระบุที่พัก ค่านี้ต้องตรงกับรหัสโรงแรมที่ระบุโดยใช้ <id> ในองค์ประกอบ <listing> ในฟีดข้อมูลโรงแรม ความสอดคล้องกับระบบของคุณเป็นสิ่งสำคัญในการ ตรวจสอบว่า Google แสดงข้อมูลของคุณอย่างถูกต้อง

ตัวอย่างนี้แสดงวิธีตั้งค่าเปอร์เซ็นต์ภาษี 10% และจำนวนค่าธรรมเนียม $50 สำหรับที่พัก สำหรับการเข้าพักทั้งหมด (ไม่ใช่ต่อคืน)

<?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>

ดูตัวอย่างการเพิ่มภาษีที่เกี่ยวข้องกับอายุและตัวอย่างอื่นๆ ได้ที่ตัวอย่างภาษี

วิธีการ

ส่วนนี้จะแสดงวิธีแก้ปัญหาในสถานการณ์ที่คุณอาจพบขณะตั้งค่า ภาษีและค่าธรรมเนียม

สถานการณ์ที่ 1: วิธีเพิ่มภาษีแบบคงที่

ตัวอย่างภาษีนี้แสดงวิธีตั้งค่าภาษีแบบคงที่ต่อที่พัก

คำอธิบาย

คุณต้องการใช้ภาษีคงที่สำหรับห้องพักหรือการเข้าพักต่อที่พักแทนที่จะใช้ภาษีเป็นเปอร์เซ็นต์

โซลูชัน

ใช้ amount แทน percentage เพื่อเพิ่มตัวเลือกภาษีคงที่

ตัวอย่าง

ตัวอย่างนี้แสดงวิธีเพิ่มภาษีคงที่โดยใช้ amount แทน 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>

สถานการณ์ที่ 2: วิธีกำหนดเป้าหมายภาษีโดยใช้ `ApplicableNights`

คำอธิบาย

คุณต้องการใช้ภาษีค่าธรรมเนียมแบบคงที่กับคืนหลังจากคืนแรกเท่านั้น ตัวอย่างเช่น มีค่าธรรมเนียมที่ต้องชำระสำหรับการใช้สิ่งอำนวยความสะดวกบางอย่างในแต่ละวัน ซึ่ง ไม่รวมในคืนแรก เนื่องจากแขกไม่มีโอกาสได้ใช้สิ่งอำนวยความสะดวกดังกล่าว

โซลูชัน

ใช้ <ApplicableNights excluded="1"/> เพื่อควบคุมคืนที่มีการเรียกเก็บภาษี

ตัวอย่าง

ตัวอย่างนี้แสดงวิธีใช้ 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>

สถานการณ์ที่ 3: วิธีแทนที่ภาษีและค่าธรรมเนียมเก่าด้วยภาษีและค่าธรรมเนียมใหม่

คำอธิบาย

ภาษีและค่าธรรมเนียมปัจจุบันมีการเปลี่ยนแปลงและต้องแทนที่ด้วยภาษีและค่าธรรมเนียมใหม่

โซลูชัน

ใช้overlayเพื่อนำภาษีและค่าธรรมเนียมที่มีอยู่ทั้งหมดออก

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีนำภาษีและค่าธรรมเนียมทั้งหมดของที่พักออก

    <?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>

สถานการณ์ที่ 4: วิธีรวมหรือยกเว้นภาษีสำหรับประเทศต่างๆ

คำอธิบาย

คุณต้องรวมภาษีสำหรับบางประเทศในขณะที่ไม่รวมภาษีจาก ประเทศอื่น เช่น คุณต้องยกเว้นภาษีสำหรับสมาพันธรัฐขนาดเล็ก ที่มีภาษีนอกสหภาพยุโรปในขณะที่เก็บภาษีประเทศอื่นๆ ทั้งหมด

โซลูชัน

ใช้ตัวเลือก include หรือ exclude สำหรับ UserCountries type ใช้ include เพื่อใช้ภาษีกับประเทศที่ระบุไว้เท่านั้น หรือใช้ exclude เพื่อ ใช้ภาษีกับทุกประเทศยกเว้นประเทศที่ระบุไว้

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีตั้งค่าภาษีสำหรับผู้ใช้ที่อยู่นอกประเทศของโรงแรม (อิสราเอล)

<?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>

สถานการณ์ที่ 5: วิธีตั้งค่าภาษีแบบขั้นบันไดด้วยวงเล็บ

คำอธิบาย

คุณต้องการเพิ่มภาษี GST ที่ใช้ในการคำนวณตามราคาต่อคืน

โซลูชัน

สำหรับสถานการณ์นี้ สมมติว่าช่วงภาษี GST ของประเทศเป้าหมายมีดังนี้

ไม่ต้องเสียภาษีหากราคาต่อคืนต่ำกว่าหรือเท่ากับ 1,000
เสียภาษี 12% หากราคาต่อคืนสูงกว่า 1,000 และต่ำกว่าหรือเท่ากับ 7,500
เสียภาษี 18% หากราคาต่อคืนสูงกว่า 7,500

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีตั้งค่าภาษีแบบขั้นบันไดที่มีวงเล็บ

<?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>

สถานการณ์ที่ 6: วิธีตั้งค่าภาษีและค่าธรรมเนียมที่ต้องเสียภาษี

คำอธิบาย

คุณต้องการเพิ่มภาษี เช่น VAT และค่าบริการอีกรายการหนึ่งซึ่ง มีผลกับภาษีนั้นด้วย

โซลูชัน

สถานการณ์นี้พิจารณาตัวอย่างกรณีการใช้งาน 2 กรณีของค่าธรรมเนียมที่ต้องเสียภาษี

ทั้งภาษีและค่าธรรมเนียมที่ต้องเสียภาษีจะกำหนดเป็นการเรียกเก็บเงินเป็นเปอร์เซ็นต์
ภาษีเป็นค่าธรรมเนียมแบบเปอร์เซ็นต์ ส่วนค่าธรรมเนียมที่ต้องเสียภาษีเป็นจำนวนเงินคงที่ต่อการเข้าพัก

ตัวอย่าง

ค่าธรรมเนียมที่ต้องเสียภาษีเป็นเปอร์เซ็นต์

ตัวอย่างนี้มี AmountBeforeTax เท่ากับ $100, ภาษี GST 18% และค่าบริการเพิ่มเติม 5% ซึ่งทำให้เปอร์เซ็นต์ค่าธรรมเนียมทั้งหมดที่ต้องเสียภาษีเท่ากับ 5.9% (5*1.18) และจำนวนเงินทั้งหมดของอัตราเท่ากับ $123.90 [= $118 (GST 18%) + $5.9 (ค่าบริการ 5.9%)]

ข้อมูลโค้ดต่อไปนี้กำหนดภาษี (GST) และค่าธรรมเนียมที่ต้องเสียภาษี (ค่าบริการ) เป็นเปอร์เซ็นต์

<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>

ค่าธรรมเนียมที่ต้องเสียภาษีเป็นจำนวนเงิน

ตัวอย่างนี้มี AmountBeforeTax เท่ากับ $100, ภาษี GST 18% และค่าธรรมเนียมแบบคงที่อีก $20 ซึ่งทำให้ค่าธรรมเนียมที่ต้องเสียภาษีทั้งหมดเป็น $23.60 ($20*1.18) และจำนวนเงินตามอัตราทั้งหมดเป็น $141.60 [= $118 (GST 18%) + $23.60 (ค่าธรรมเนียมแบบคงที่ $20)]

ข้อมูลโค้ดต่อไปนี้กำหนดภาษี (GST) เป็นเปอร์เซ็นต์และค่าธรรมเนียมที่ต้องเสียภาษี (ค่าบริการ) เป็นจำนวนเงินแบบคงที่

<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>

ภาพรวม

วิธีการเพิ่มภาษีและค่าธรรมเนียม

วิธีการตั้งค่าภาษี

องค์ประกอบที่จำเป็นและไม่บังคับ

ไวยากรณ์และสคีมา

หลักเกณฑ์

การดำเนินการ

ทั่วไป

ตัวอย่าง

วิธีการ

สถานการณ์ที่ 1: วิธีเพิ่มภาษีแบบคงที่

คำอธิบาย

โซลูชัน

ตัวอย่าง

สถานการณ์ที่ 2: วิธีกำหนดเป้าหมายภาษีโดยใช้ ApplicableNights

คำอธิบาย

โซลูชัน

ตัวอย่าง

สถานการณ์ที่ 3: วิธีแทนที่ภาษีและค่าธรรมเนียมเก่าด้วยภาษีและค่าธรรมเนียมใหม่

คำอธิบาย

โซลูชัน

ตัวอย่าง

สถานการณ์ที่ 4: วิธีรวมหรือยกเว้นภาษีสำหรับประเทศต่างๆ

คำอธิบาย

โซลูชัน

ตัวอย่าง

สถานการณ์ที่ 5: วิธีตั้งค่าภาษีแบบขั้นบันไดด้วยวงเล็บ

คำอธิบาย

โซลูชัน

ตัวอย่าง

สถานการณ์ที่ 6: วิธีตั้งค่าภาษีและค่าธรรมเนียมที่ต้องเสียภาษี

คำอธิบาย

โซลูชัน

ตัวอย่าง

ค่าธรรมเนียมที่ต้องเสียภาษีเป็นเปอร์เซ็นต์

ค่าธรรมเนียมที่ต้องเสียภาษีเป็นจำนวนเงิน

สถานการณ์ที่ 2: วิธีกำหนดเป้าหมายภาษีโดยใช้ `ApplicableNights`