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

ภาพรวม

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

หมายเหตุ: แนะนำให้ใช้ข้อความ TaxFeeinfo และไม่ต้องระบุ หากระบุ AmountAfterTax ในข้อความ Rate

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

ประเด็นสำคัญ: คุณต้องรวมภาษีและค่าธรรมเนียมทั้งหมดที่ผู้ใช้ต้องชำระ (VAT, ภาษีการเข้าพัก, ภาษีเมือง ฯลฯ) แม้ว่าลูกค้าจะไม่ได้ชำระในขณะจอง หรือไม่ได้ชำระให้ที่พักโดยตรงก็ตาม

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

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

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

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

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

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

• พื้นฐาน = [ห้อง|บุคคล]
• ระยะเวลา = [การเข้าพัก|คืน]
• ประเภท = [percent|amount]

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

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

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

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

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

การอ้างอิง 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

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

ประเด็นหลัก: ส่งข้อความ TaxFeeInfo ที่อัปเดตแล้วให้ Google ทุกครั้งที่ภาษีและค่าธรรมเนียมมีการเปลี่ยนแปลง

สำหรับแอตทริบิวต์ 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 เพื่อนำภาษีและค่าธรรมเนียมที่มีอยู่ทั้งหมดออก

หมายเหตุ: การดำเนินการ "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 ที่จะใช้โดยอิงตามราคาต่อคืน

หมายเหตุ: ในสถานการณ์นี้ ให้ใช้ Brackets (ชุดวงเล็บภาษีที่ไม่ซ้อนทับกัน) เพื่อตั้งค่าตัวเลือกนี้

โซลูชัน

ในสถานการณ์นี้ สมมติว่าช่วงชั้นการเสียภาษี 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*1.18)

ข้อมูลโค้ดต่อไปนี้กำหนดภาษี (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>