ธุรกรรม (ข้อมูลพร็อพเพอร์ตี้)

คำขอ

ไวยากรณ์

ข้อความ Transaction (Property Data) ใช้ไวยากรณ์ต่อไปนี้

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="timestamp"
             id="message_ID"
             partner="partner_key">
  <PropertyDataSet action="[overlay|delta]">
    <!-- (Required) ID that matches the Hotel List Feed -->
    <Property>HotelID</Property>
    <RoomData>
      <!-- (Required) One room ID per RoomData element -->
      <RoomID>RoomID</RoomID>
      <Name>
        <Text text="room_name" language="language_code"/>
      </Name>
      <Description>
        <Text text="room_description" language="language_code"/>
      </Description>
      <!-- (Optional) Restricts the rate plans allowed for this room type to
        those listed here. If specified, don't specify AllowableRoomIDs. -->
      <AllowablePackageIDs>
        <AllowablePackageID>PackageID</AllowablePackageID>
      </AllowablePackageIDs>
      <Capacity>max_number_of_occupants</Capacity>
      <AdultCapacity>max_number_of_adult_occupants</AdultCapacity>
      <ChildCapacity>max_number_of_child_occupants</ChildCapacity>
      <OccupancySettings>
        <MinOccupancy>min_number_of_occupants</MinOccupancy>
        <MinAge>min_age_of_occupants</MinAge>
      </OccupancySettings>
      <PhotoURL>
        <Caption>
          <Text text="photo_description" language="language_code"/>
        </Caption>
        <URL>photo_location</URL>
      </PhotoURL>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>[western|japanese|japanese_western]</JapaneseHotelRoomStyle>
        <Beds>
           <Bed size="[single|semi_double|double|queen|king]">
             <Width unit="cm" number="bed_width"/>
             <Length unit="cm" number="bed_length"/>
           </Bed>
           <!-- Include with any additional beds. -->
        </Beds>
        <Suite/>
        <Capsule/>
        <Roomsharing>[shared|private]</Roomsharing>
        <Outdoor/>
        <MobilityAccessible/>
        <Smoking>[smoking|non_smoking]</Smoking>
        <BathAndToilet relation="[together|separate]">
          <Bath bathtub="[false|true]" shower="[false|true]"/>
          <Toilet electronic_bidet="[false|true]" mobility_accessible="[false|true]"/>
        </BathAndToilet>
        <OpenAirBath/>
        <AirConditioning/>
        <Balcony/>
        <Views>
          <!-- (Optional) Defines the type of views from the room. -->
          <!-- Example: <OceanView/> -->
        </Views>
      </RoomFeatures>
    </RoomData>
    <PackageData>
      <!-- (Required) One package ID per PackageData element -->
      <PackageID>PackageID</PackageID>
      <Name>
        <Text text="package_name" language="language_code"/>
      </Name>
      <Description>
        <Text text="package_description" language="language_code"/>
      </Description>
      <!-- (Optional) Restricts the room types allowed for this rate plan to
        those listed here. If specified, don't specify AllowablePackageIDs. -->
      <AllowableRoomIDs>
        <AllowableRoomID>RoomID</AllowableRoomID>
      </AllowableRoomIDs>
      <Refundable available="[false|true]" refundable_until_days="number_of_days"
        refundable_until_time="time"/>
      <!-- For these next 3 elements, boolean_value can be 0/1 or true/false -->
      <BreakfastIncluded>boolean_value</BreakfastIncluded>
      <InternetIncluded>boolean_value</InternetIncluded>
      <ParkingIncluded>boolean_value</ParkingIncluded>
      <PhotoURL>
        <Caption>
          <Text text="photo_description" language="language_code"/>
          ...
        </Caption>
        <URL>photo_location</URL>
      </PhotoURL>
      ...
      <Meals>
        <Breakfast
          included="[true|false]" buffet="[true|false]"
          in_room="[true|false]" in_private_space="[true|false]"/>
        <Dinner
          included="[true|false]" buffet="[true|false]"
          in_room="[true|false]" in_private_space="[true|false]"/>
      </Meals>
      <CheckinTime>checkin_time</CheckinTime>
      <CheckoutTime>checkout_time</CheckoutTime>
    </PackageData>
  </PropertyDataSet>
</Transaction>

องค์ประกอบและแอตทริบิวต์

ข้อความ Transaction (Property Data) มีองค์ประกอบและแอตทริบิวต์ต่อไปนี้

องค์ประกอบ / @แอตทริบิวต์ จำนวนข้อผิดพลาด ประเภท คำอธิบาย
Transaction 1 Complex element ในการใช้งาน ARI นี่คือองค์ประกอบรูทของข้อความที่ระบุประเภทห้องและแพ็กเกจสำหรับที่พักแห่งเดียว
Transaction / @timestamp 1 DateTime วันที่และเวลาที่สร้างข้อความนี้
Transaction / @id 1 string ตัวระบุที่ไม่ซ้ำกันสำหรับข้อความคำขอนี้ ค่านี้จะแสดงในข้อความตอบกลับ อักขระที่อนุญาตคือ a-z, A-Z, 0-9, _ (ขีดล่าง) และ - (ขีดกลาง)
Transaction / @partner 1 string บัญชีพาร์ทเนอร์สำหรับข้อความนี้ ค่าของสตริงนี้คือค่า "Partner key" ซึ่งแสดงอยู่ที่ หน้าการตั้งค่าบัญชีใน Hotel Center

หมายเหตุ: หากคุณมีแบ็กเอนด์ที่มีฟีดสำหรับหลายบัญชี ค่านี้ต้องตรงกับค่าแอตทริบิวต์ ID ที่ระบุในองค์ประกอบ <RequestorID> ของข้อความ <OTA_HotelRateAmountNotifRQ> และ <OTA_HotelAvailNotifRQ> สำหรับบัญชีเดียวกัน
Transaction / PropertyDataSet 1.. PropertyDataSet คอนเทนเนอร์สำหรับกำหนดประเภทห้องและแพ็กเกจสำหรับที่พักแห่งเดียว
Transaction / PropertyDataSet / @action 0..1 enum

ประเภทของการอัปเดตที่จะใช้กับการกำหนดราคาห้องพัก

ค่าที่ใช้ได้มีดังนี้

  • overlay : แทนที่ <RoomData> และ <PackageData> ที่กำหนดไว้ก่อนหน้านี้ทั้งหมดสำหรับพร็อพเพอร์ตี้ ใช้ได้เฉพาะ <RoomData> และ <PackageData> ในข้อความปัจจุบันเท่านั้น
  • delta : เพิ่ม <RoomData> และ <PackageData> ที่ไม่ได้กำหนดก่อนหน้านี้หรือแก้ไขรายการที่มีอยู่

แอตทริบิวต์นี้เป็นค่าที่ไม่บังคับและมีค่าเริ่มต้นเป็น delta หากไม่ได้ระบุไว้
Transaction / PropertyDataSet / Property 1 string ตัวระบุที่ไม่ซ้ำกันของที่พัก ค่านี้ต้องตรงกับรหัสโรงแรมที่ระบุโดยใช้ <id> ในองค์ประกอบ <listing> ในฟีดข้อมูลโรงแรม นอกจากนี้ รหัสโรงแรมยังแสดงอยู่ใน Hotel Center ด้วย
Transaction / PropertyDataSet / RoomData 0..n RoomData

อธิบายห้องพัก

หมายเหตุ: ต้องมี <RoomData> หรือ <PackageData> อย่างน้อย 1 รายการ

Transaction / PropertyDataSet / RoomData / RoomID 1 RoomID ตัวระบุที่ไม่ซ้ำกันสำหรับประเภทห้องพัก ค่านี้จะได้รับการอ้างอิงโดยใช้แอตทริบิวต์ InvTypeCode ในองค์ประกอบ <StatusApplicationControl> ในข้อความ <OTA_HotelAvailNotifRQ> และ <OTA_HotelRateAmountNotifRQ>
Transaction / PropertyDataSet / RoomData / Name 1 Name คอนเทนเนอร์สำหรับชื่อหมวดหมู่ห้องพักในภาษาอย่างน้อย 1 ภาษา
Transaction / PropertyDataSet / RoomData / Name / Text 1..n Text ระบุชื่อหมวดหมู่ห้องพักในภาษาเดียว
Transaction / PropertyDataSet / RoomData / Name / Text / @text 1..n string ชื่อหมวดหมู่ห้องพักในภาษาที่ระบุโดยแอตทริบิวต์ language
Transaction / PropertyDataSet / RoomData / Description 1 Name คอนเทนเนอร์สำหรับคำอธิบายหมวดหมู่ห้องพักในภาษาอย่างน้อย 1 ภาษา
Transaction / PropertyDataSet / RoomData / Description / Text 1..n Text ระบุคำอธิบายหมวดหมู่ห้องพักในภาษาเดียว
Transaction / PropertyDataSet / RoomData / Description / Text / @text 1..n string คำอธิบายหมวดหมู่ห้องพักในภาษาที่ระบุโดยแอตทริบิวต์ language
Transaction / PropertyDataSet / RoomData / Description / Text / @language 1..n string รหัสภาษาแบบ 2 ตัวอักษร
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs 0..1 AllowablePackageIDs คอนเทนเนอร์สำหรับองค์ประกอบ <AllowablePackageID>

หากระบุ <AllowablePackageIDs> แล้ว ประเภทห้องพักที่ระบุโดย <RoomID> ในองค์ประกอบ <RoomData> ระดับบนสุดจะนำไปรวมกับแพ็กเกจราคาที่กำหนดโดยองค์ประกอบ <AllowablePackageID> ได้เท่านั้น

หากไม่ได้ระบุ <AllowablePackageIDs> ประเภทห้องพักที่ระบุโดย <RoomID> ในองค์ประกอบ <RoomData> ระดับบนสุดจะนำไปรวมกับแพ็กเกจราคาใดก็ได้

ใช้ <AllowablePackageIDs> หรือ <AllowableRoomIDs> แต่ไม่ใช่ทั้ง 2 อย่าง
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs / AllowablePackageID 1..n AllowablePackageID ระบุ PackageID ของแพ็กเกจราคาที่ใช้ร่วมกับประเภทห้องพักนี้ได้ แพ็กเกจราคาจะกำหนดโดยชุดค่าผสมของแพ็กเกจ ราคา และห้องว่าง โดย PackageID มีความสอดคล้องกับ RatePlanCode ในข้อความ OTA_HotelRateAmountNotifRQ และ OTA_HotelAvailNotifRQ
Transaction / PropertyDataSet / RoomData / Capacity 0..1 integer จำนวนผู้ใหญ่และเด็กสูงสุดที่ห้องพักรองรับได้ ซึ่งควรมากกว่าหรือเท่ากับค่า NumberOfGuests ที่คุณส่งพร้อมราคา

ค่าของ <Capacity> ต้องเป็นจำนวนเต็มบวกตั้งแต่ 1 ถึง 99 ดูตัวอย่างได้ที่นี่

หมายเหตุ: หากไม่ได้ตั้งค่า <Capacity> ระบบจะถือว่าจำนวนผู้เข้าพักที่อนุญาตเป็นแบบไม่จำกัด หากไม่ได้ตั้งค่าช่องนี้ไว้และมีการกำหนด ExtraGuestCharges หรือ AdditionalGuestAmounts ไว้ คุณจะสร้างราคาสำหรับผู้เข้าพักได้ไม่จำกัดจำนวน เราขอแนะนำให้ตั้งค่า <Capacity> หากมีการกำหนด ExtraGuestCharges หรือ AdditionalGuestAmounts เพื่อให้มั่นใจว่าราคาจะไม่แสดงสำหรับตัวเลือกอัตราการเข้าพักที่ไม่ถูกต้อง
Transaction / PropertyDataSet / RoomData / AdultCapacity 0..1 integer จำนวนผู้ใหญ่สูงสุดที่ห้องพักรองรับได้ ซึ่งควรมากกว่าหรือเท่ากับค่า NumberOfGuests ที่คุณส่งพร้อมราคา

ค่าของ <AdultCapacity> ต้องเป็นจำนวนเต็มบวกระหว่าง 1 ถึง 99 ดูตัวอย่างได้ที่นี่
Transaction / PropertyDataSet / RoomData / ChildCapacity 0..1 integer จำนวนเด็กสูงสุดที่ห้องพักรองรับได้

ค่าของ <ChildCapacity> ต้องเป็นจำนวนเต็มบวกตั้งแต่ 1 ถึง 99 ดูตัวอย่างได้ที่นี่
Transaction / PropertyDataSet / RoomData / OccupancySettings 0..1 OccupancySettings การตั้งค่าที่จะจำกัดหรือแก้ไขข้อกำหนดด้านอัตราการเข้าพักของห้องได้

องค์ประกอบ <OccupancySettings> มีองค์ประกอบย่อยต่อไปนี้

  • <MinOccupancy>: จำนวนแขกขั้นต่ำที่เข้าพักในห้องพักได้ เช่น หากตั้งค่าเป็น 2 จะจองห้องนี้สำหรับแขกคนเดียวไม่ได้

    ค่าของ <MinOccupancy> ต้องเป็นจำนวนเต็มบวกตั้งแต่ 1 ถึง 99

  • <MinAge>: อายุขั้นต่ำสำหรับแขกทุกคนที่เข้าพักในห้องพัก เช่น หากตั้งค่าเป็น 18 ห้องนี้จะจองได้สำหรับกลุ่มที่แขกทุกคนมีอายุ 18 ปีขึ้นไปเท่านั้น

    ค่าของ <MinAge> ต้องเป็นจำนวนเต็มบวกตั้งแต่ 0 ถึง 99

<OccupancySettings>
  <MinOccupancy>2</MinOccupancy>
  <MinAge>16</MinAge>
</OccupancySettings>

คุณไม่จำเป็นต้องรวมองค์ประกอบย่อยบางรายการ
Transaction / PropertyDataSet / RoomData / PhotoURL 0..n PhotoURL URL และคำบรรยายภาพแบบไม่บังคับสำหรับรูปภาพห้องพักหรือแพ็กเกจห้องพัก คุณระบุ <PhotoURL> ได้มากกว่า 1 รายการสำหรับห้องพักหรือแพ็กเกจห้องพัก

องค์ประกอบนี้มีองค์ประกอบย่อยต่อไปนี้

  • <URL>: ระบุตำแหน่งของรูปภาพ ตำแหน่งควรเป็นสาธารณะ (ไม่มีไฟร์วอลล์กั้น) และควรมีโปรโตคอล (http://)
  • <Caption>: กำหนดคำบรรยายภาพสำหรับรูปภาพ องค์ประกอบนี้มีองค์ประกอบย่อย <Text> เพียงรายการเดียว ซึ่งมีแอตทริบิวต์ที่ต้องระบุ 2 รายการ ได้แก่ Text และ language แอตทริบิวต์ Text คือคำบรรยาย ส่วนแอตทริบิวต์ language จะระบุรหัสภาษาแบบ 2 ตัวอักษร เช่น en
<PhotoURL>
 <URL>http://www.example.com/image1.jpg</URL>
 <Caption>
  <Text text="A bright way to enjoy your
   mornin' cuppa tea." language="en"/>
  <Text text="Une façon lumineuse pour profiter
   de votre tasse de thé." language="fr"/>
 </Caption>
</PhotoURL>
Transaction / PropertyDataSet / RoomData / RoomFeatures 0..1 <RoomFeatures> มีข้อมูลเกี่ยวกับฟีเจอร์ของห้องพัก
Transaction / PropertyDataSet / RoomData / RoomFeatures / JapaneseHotelRoomStyle 0..1 enum

ระบุสไตล์ของห้องพักโรงแรมแบบญี่ปุ่น

ค่าที่ใช้ได้มีดังนี้

  • western: ห้องพักสไตล์ตะวันตกพร้อมเตียง
  • japanese: ห้องพักสไตล์ญี่ปุ่นพร้อมเตียงฟูก
  • japanese_western: ห้องพักสไตล์ญี่ปุ่นตะวันตกที่มีทั้งเตียงสไตล์ตะวันตกและฟูกสไตล์ญี่ปุ่น
Transaction / PropertyDataSet / RoomData / RoomFeatures / Beds 0..1 Object มี <Bed> เท่ากับห้อง โปรดทราบว่าไม่ควรนับฟูกญี่ปุ่นที่นี่

<Bed> แต่ละรายการจะมีแอตทริบิวต์ต่อไปนี้

  • size (ไม่บังคับ): ค่าที่ถูกต้องคือ single, semi_double, double, queen และ king
<Bed> แต่ละรายการมีองค์ประกอบย่อยต่อไปนี้
  • <Width> (ไม่บังคับ): ระบุความกว้างของเตียง ต้องมีแอตทริบิวต์ unit ที่มีค่า cm และแอตทริบิวต์ number ที่มีความกว้างของเตียงเป็นหน่วยเซนติเมตร
  • <Length> (ไม่บังคับ): ระบุความยาวเตียง ต้องมีแอตทริบิวต์ unit ที่มีค่า cm และแอตทริบิวต์ number ที่มีความยาวของเตียงเป็นหน่วยเซนติเมตร
เช่น 
<Beds>
  <Bed size="double">
    <Width unit="cm" number="140"/>
    <Length unit="cm" number="195"/>
  </Bed>
  <Bed/> <!-- Size unknown -->
</Beds>
Transaction / PropertyDataSet / RoomData / RoomFeatures / Suite 0.. enum ระบุองค์ประกอบนี้เมื่อห้องนี้เป็นห้องสวีท
Transaction / PropertyDataSet / RoomData / RoomFeatures / Capsule 0..1 enum ระบุองค์ประกอบนี้เมื่อห้องนี้เป็นห้องแคปซูล
Transaction / PropertyDataSet / RoomData / RoomFeatures / Roomsharing 0..1 enum ห้องนี้แชร์กับผู้เข้าพักคนอื่นๆ เช่น เจ้าของหรือแขกคนอื่นๆ หรือไม่ ค่าที่ถูกต้องคือ shared และ private
Transaction / PropertyDataSet / RoomData / RoomFeatures / Outdoor 0..1 enum ระบุองค์ประกอบนี้เมื่อห้องนี้เป็นที่พักกลางแจ้งที่ไม่มีผนังตายตัว ระบบประปา และระบบปรับอากาศ เช่น ห้องพักของโรงแรมไม่ใช่ที่พักกลางแจ้ง ส่วนจุดตั้งแคมป์ที่แขกเข้าพักในเต็นท์และจุดจอดรถบ้านที่แขกนำรถบ้านมาเองเป็นที่พักกลางแจ้ง
Transaction / PropertyDataSet / RoomData / RoomFeatures / MobileAccessible 0..1 enum ระบุองค์ประกอบนี้เมื่อห้องนี้เข้าถึงได้ง่าย
Transaction / PropertyDataSet / RoomData / RoomFeatures / Smoking 0..1 enum ห้องนี้เป็นห้องปลอดบุหรี่หรือห้องสูบบุหรี่ ค่าที่ถูกต้องคือ non_smoking และ smoking
Transaction / PropertyDataSet / RoomData / RoomFeatures / BathAndToilet 0..1 Object มีข้อมูลเกี่ยวกับอ่างอาบน้ำและห้องสุขาในห้องพัก

โดยมีแอตทริบิวต์ดังนี้

  • relation (ไม่บังคับ): ระบุว่าควรวางห้องอาบน้ำและห้องสุขาอย่างไรโดยสัมพันธ์กัน ค่าที่ใช้ได้คือ together เช่น ห้องน้ำที่ทั้งห้องอาบน้ำและห้องสุขาอยู่ร่วมกันในห้องเดียวกัน และ separate ซึ่งห้องน้ำและห้องสุขาแต่ละห้องมีพื้นที่พิเศษ ต้องไม่ตั้งค่าแอตทริบิวต์นี้เมื่อห้องไม่มีทั้งห้องอาบน้ำและห้องสุขา

องค์ประกอบนี้จะเลือกใช้องค์ประกอบย่อยต่อไปนี้

  • <Bath> (ไม่บังคับ): การมีอยู่ขององค์ประกอบนี้บ่งบอกว่าห้องมีอ่างอาบน้ำ

    แอตทริบิวต์มีดังนี้

    • bathtub (ไม่บังคับ): ระบุว่าอ่างอาบน้ำมีอ่างอาบน้ำในห้องน้ำ ค่าที่ใช้ได้คือ 0 (หรือ false) และ 1 (หรือ true)
    • shower (ไม่บังคับ): บ่งบอกว่าห้องอาบน้ำมีฝักบัว ค่าที่ใช้ได้คือ 0 (หรือ false) และ 1 (หรือ true)
  • <Toilet> (ไม่บังคับ): การมีอยู่ขององค์ประกอบนี้บ่งบอกว่าห้องนี้มีห้องน้ำ

    แอตทริบิวต์มีดังนี้

    • electronic_bidet (ไม่บังคับ): บ่งบอกว่าห้องน้ำมีโถสุขภัณฑ์ไฟฟ้า ค่าที่ใช้ได้คือ 0 (หรือ false) และ 1 (หรือ true)
    • mobility_accessible (ไม่บังคับ): ระบุว่าห้องน้ำนี้รองรับการเคลื่อนไหว ค่าที่ใช้ได้คือ 0 (หรือ false) และ 1 (หรือ true)

ตัวอย่าง

<BathAndToilet relation="separate">
  <Bath bathtub="1" shower="1"/>
  <Toilet
    electronic_bidet="1"
    mobility_accessible="1"/>
</BathAndToilet>
Transaction / PropertyDataSet / RoomData / RoomFeatures / OpenAirBath 0..1 enum โปรดระบุองค์ประกอบนี้เมื่อห้องนี้มีอ่างอาบน้ำส่วนตัวแบบเปิดโล่ง
Transaction / PropertyDataSet / RoomData / RoomFeatures / AirConditioning 0..1 enum ระบุองค์ประกอบนี้เมื่อห้องนี้มีเครื่องปรับอากาศ
Transaction / PropertyDataSet / RoomData / RoomFeatures / Balcony 0..1 enum ระบุองค์ประกอบนี้เมื่อห้องนี้มีระเบียงหรือระเบียง
Transaction / PropertyDataSet / RoomData / RoomFeatures / Views 0..1 Object ตัวเลือกที่ใช้ได้มีดังนี้

<AirportView/>
<BayView/>
<BeachView>/>
<CastleView/>
<CityView/>
<CountrysideView/>
<CourtyardView/>
<DuneView/>
<ForestView/>
<GardenView/>
<GolfCourseView/>
<HarborView/>
<LagoonView/>
<LakeView/>
<MarinaView/>
<MountainView/>
<NatureView/>
<OceanView/>
<ParkView/>
<PartialOceanView/>
<PisteView/>
<PoolView/>
<PyramidView/>
<RiverView/>
<StreetView/>
Transaction / PropertyDataSet / PackageData 0..n PackageData

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

หมายเหตุ: ต้องมี <RoomData> หรือ <PackageData> อย่างน้อย 1 รายการ

Transaction / PropertyDataSet / PackageData / PackageID 1 string PackageID ในข้อความเหล่านี้สอดคล้องกับ RatePlanCode ในข้อความ OTA_HotelRateAmountNotifRQ และ OTA_HotelAvailNotifRQ
Transaction / PropertyDataSet / PackageData / Name 1 Name คอนเทนเนอร์สำหรับชื่อแพ็กเกจในอย่างน้อย 1 ภาษา
Transaction / PropertyDataSet / PackageData / Name / Text 1..n Text ระบุชื่อแพ็กเกจในภาษาเดียว
Transaction / PropertyDataSet / PackageData / Name / Text / @text 1..n string ชื่อแพ็กเกจในภาษาที่ระบุโดยแอตทริบิวต์ language
Transaction / PropertyDataSet / PackageData / Description 1 Description คอนเทนเนอร์สำหรับคำอธิบายแพ็กเกจในภาษาอย่างน้อย 1 ภาษา
Transaction / PropertyDataSet / PackageData / Description / Text 1..n Text ระบุคำอธิบายแพ็กเกจเป็นภาษาเดียว
Transaction / PropertyDataSet / PackageData / Description / Text / @text 1..n string คำอธิบายแพ็กเกจในภาษาที่ระบุโดยแอตทริบิวต์ language
Transaction / PropertyDataSet / PackageData / Description / Text / @language 1..n string รหัสภาษาแบบ 2 ตัวอักษร
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs 0..1 AllowableRoomIDs คอนเทนเนอร์สำหรับองค์ประกอบ <AllowableRoomID>

หากระบุ <AllowableRoomIDs> แล้ว แพ็กเกจราคาที่ระบุโดย <PackageID> ในองค์ประกอบ <PackageData> ระดับบนสุดจะนำไปรวมกับประเภทห้องพักที่กำหนดโดยองค์ประกอบ <AllowableRoomID> ได้เท่านั้น

หากไม่ได้ระบุ <AllowableRoomIDs> แพ็กเกจราคาที่ระบุโดย <PackageID> ในองค์ประกอบ <PackageData> ระดับบนสุดจะนำไปรวมกับห้องพักประเภทใดก็ได้

ใช้ <AllowablePackageIDs> หรือ <AllowableRoomIDs> แต่ไม่ใช่ทั้ง 2 อย่าง
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs / AllowableRoomID 1..n AllowableRoomID ระบุ RoomID ของประเภทห้องพักที่ใช้ร่วมกับแพ็กเกจราคานี้ได้ ประเภทห้องพักจะกำหนดไว้ในองค์ประกอบ <RoomData>
Transaction / PropertyDataSet / PackageData / Refundable 0..1 Refundable แสดงราคาห้องพักที่ขอเงินคืนได้หรือยกเลิกได้ทั้งหมด หากไม่ได้ระบุไว้ ระบบจะไม่แสดงข้อมูลเกี่ยวกับการคืนเงิน

หมายเหตุ: เราขอแนะนำให้ตั้งค่าแอตทริบิวต์ทั้งหมด ระบบจะสร้างข้อความเตือนสถานะฟีดเมื่อไม่ได้ตั้งค่าแอตทริบิวต์อย่างน้อย 1 รายการ

หากไม่ได้ระบุแอตทริบิวต์ ราคาจะไม่แสดงเป็นขอเงินคืนได้

โปรดคำนึงถึงสิ่งต่อไปนี้เมื่อตั้งค่าแอตทริบิวต์

  • หากไม่ได้ตั้งค่า available หรือ refundable_until_days ไว้ ระบบจะไม่แสดงราคาห้องพักเป็นขอเงินคืนได้
  • หาก available คือ 0 หรือ false ระบบจะละเว้นแอตทริบิวต์อื่นๆ ราคาห้องพักจะไม่แสดงเป็นขอเงินคืนได้แม้จะมีการตั้งค่าแอตทริบิวต์อื่นๆ อย่างน้อย 1 รายการหรือทั้ง 2 รายการก็ตาม
Transaction / PropertyDataSet / PackageData / Refundable / @available 1 boolean (ต้องระบุ) ตั้งค่าเป็น 1 หรือ true เพื่อระบุว่าราคาห้องพักนี้ขอเงินคืนเต็มจำนวนได้หรือไม่ มิเช่นนั้นให้ตั้งค่าเป็น 0 หรือ false
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days 0..1 integer (ต้องระบุหาก available คือ true) ระบุจำนวนวันก่อนเช็คอินที่จะขอเงินคืนเต็มจำนวนได้ ค่าของ refundable_until_days ต้องเป็นจำนวนเต็มตั้งแต่ 0 ถึง 330
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_time 0.. Time (แนะนำอย่างยิ่งหาก available คือ true) ระบุเวลาล่าสุดของวันตามเวลาท้องถิ่นของโรงแรมที่ขอเงินคืนเต็มจำนวนได้ คุณใช้ค่านี้ร่วมกับ refundable_until_days ได้ เช่น เพื่อระบุว่า "ขอเงินคืนได้จนถึงเวลา 16:00 น. ก่อนเช็คอิน 2 วัน" หากไม่ได้ตั้งค่า refundable_until_time ไว้ ค่าเริ่มต้นจะเป็นเที่ยงคืน
Transaction / PropertyDataSet / PackageData / BreakfastIncluded 0..1 boolean ระบุว่าประเภทห้องพักนี้รวมอาหารเช้าหรือไม่ ค่าที่ใช้ได้คือ 0 (หรือ false) และ 1 (หรือ true)

เราขอแนะนำให้คุณใช้ <Meals> แทน <BreakfastIncluded>
Transaction / PropertyDataSet / PackageData / CheckinTime 0..1 Time เวลาเช็คอินที่เร็วที่สุดคือเวลาท้องถิ่นของโรงแรม เวลาต้องไม่เกิน 24:00
Transaction / PropertyDataSet / PackageData / CheckoutTime 0..1 Time เวลาเช็คเอาต์ล่าสุดที่เป็นไปได้ตามเวลาท้องถิ่นของโรงแรม
Transaction / PropertyDataSet / PackageData / InternetIncluded 0..1 boolean ระบุว่าห้องพักมีบริการอินเทอร์เน็ตฟรีหรือไม่ ในขณะที่ห้องอื่นๆ ไม่มีสิ่งอำนวยความสะดวกนี้ อย่าตั้งค่าองค์ประกอบนี้ในโรงแรมที่ให้บริการอินเทอร์เน็ตฟรีสำหรับห้องพักทุกห้อง องค์ประกอบนี้ใช้ไม่ได้กับอินเทอร์เน็ตแบบใช้สายในห้องพักหรืออินเทอร์เน็ตแบบไร้สายที่ไม่ได้ให้บริการในห้องพักของแขก ค่าที่ใช้ได้คือ 0 (หรือ false) และ 1 (หรือ true)
Transaction / PropertyDataSet / PackageData / Meals 0..1 Object มีข้อมูลเกี่ยวกับมื้ออาหารในแพ็กเกจนี้

องค์ประกอบ <Meals> มีองค์ประกอบย่อย (ไม่บังคับ) 2 รายการ ได้แก่ <Breakfast> และ <Dinner> ซึ่งมีแอตทริบิวต์ต่อไปนี้

  • included (จำเป็น): ตั้งค่าเป็น 1 (หรือ true) หากราคารวมอาหารเช้า/อาหารค่ำ หากไม่ใช่ ให้ตั้งเป็น 0 หรือ false
  • in_room (ไม่บังคับ): ตั้งค่าเป็น 1 (หรือ true) หากแขกมีตัวเลือกในการรับประทานอาหารเช้า/อาหารค่ำในห้องที่เข้าพัก หรือตั้งค่าเป็น 0 (หรือ false)
  • in_private_space (ไม่บังคับ): ตั้งค่าเป็น 1 (หรือ true) หากแขกมีตัวเลือกในการรับประทานอาหารเช้า/อาหารเย็นในห้อง (ยกเว้นห้องที่เข้าพัก) ที่สามารถหลีกเลี่ยงการติดต่อกับแขกคนอื่นๆ หรือตั้งค่าเป็น 0 (หรือ false)
  • buffet (ไม่บังคับ): ตั้งค่าเป็น 1 (หรือ true) หากอาหารเช้า/อาหารเย็นให้บริการแบบบุฟเฟ่ต์ หรือตั้งค่าเป็น 0 (หรือ false)

ระบบจะใช้แอตทริบิวต์ที่ไม่บังคับเมื่อ included เป็นจริงเท่านั้น

หากต้องการให้ตัวกรองอาหาร (no meals, breakfast only, dinner only และ breakfast and dinner) ทำงานได้ คุณต้องระบุทั้ง <Breakfast> และ <Dinner> ด้วยแอตทริบิวต์ included
Transaction / PropertyDataSet / PackageData / ParkingIncluded 0..1 boolean ระบุว่าห้องพักมีที่จอดรถฟรีหรือไม่ ซึ่งหากไม่เป็นเช่นนั้นก็จะหมายความว่าโรงแรมนี้มีการเรียกเก็บค่าที่จอดรถ อย่าระบุค่าขององค์ประกอบนี้สำหรับโรงแรมที่มีที่จอดรถฟรี ค่าที่ใช้ได้คือ 0 (หรือ false) และ 1 (หรือ true) ค่าเริ่มต้นคือ false
Transaction / PropertyDataSet / PackageData / PhotoURL 0..1 Object (เหมือนกับ <PhotoURL> ใน <RoomData> แต่สำหรับแพ็กเกจ (เช่น รูปภาพอาหาร))

ตัวอย่าง

ข้อมูลห้องพักและแพ็กเกจ

ตัวอย่างต่อไปนี้เป็นตัวอย่างพื้นฐานของวิธีกำหนดข้อมูลห้องพักและแพ็กเกจของที่พักในข้อความ Transaction (Property Data) ระบบใช้แอตทริบิวต์ overlay เพื่อให้มั่นใจว่า หากมีข้อมูลอยู่แล้วโดยไม่คาดคิด ระบบจะลบข้อมูลที่มีอยู่ทั้งหมดและแทนที่ด้วยข้อมูลในข้อความนี้

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-05-18T16:20:00-04:00"
             id="12345678"
             partner="partner_key">
  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Description>
        <Text text="Room with a king bed" language="en"/>
      </Description>
      <Capacity>2</Capacity>
      <PhotoURL>
        <URL>http://www.foo.com/static/bar/image.jpg</URL>
        <Caption>
          <Text text="Room with a king bed" language="en"/>
        </Caption>
      </PhotoURL>
    </RoomData>
    <RoomData>
      <RoomID>RoomID_2</RoomID>
      <Name>
        <Text text="Double" language="en"/>
      </Name>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
    <PackageData>
      <PackageID>PackageID_2</PackageID>
      <Name>
        <Text text="Free Breakfast" language="en"/>
      </Name>
      <Description>
        <Text text="Free breakfast rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>

เพิ่มประเภทห้อง

ตัวอย่างต่อไปนี้เป็นตัวอย่างของวิธีเพิ่มประเภทห้องพักและแพ็กเกจไปยังข้อมูล <Transaction> ที่มีอยู่

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-07-18T16:20:00-04:00"
             id="12345678"
             partner="partner_key">
  <PropertyDataSet action="delta">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>RoomID_3</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
    <PackageData>
      <PackageID>PackageID_3</PackageID>
      <Name>
        <Text text="Non-Refundable" language="en"/>
      </Name>
      <!-- Additional PackageData child elements omitted. -->
      <Refundable available="false"/>
    </PackageData>
  </PropertyDataSet>
</Transaction>

นำประเภทห้องออก

ตัวอย่างต่อไปนี้เป็นตัวอย่างของวิธีการนำประเภทห้องพักและแพ็กเกจที่มีอยู่ออก ในกรณีนี้ หากระบบส่งข้อความใน "ข้อมูลห้องพักและแพ็กเกจ" และ "เพิ่มประเภทห้องพัก" ไปยัง Google ก่อนหน้านี้ ประเภทห้อง King และ Double จะไม่มีอยู่อีกต่อไปเมื่อ Google ได้รับข้อความ โปรดทราบว่าการนำข้อมูลแพ็กเกจออกจะส่งผลต่อแพ็กเกจราคาโดยรวมตามที่ระบุไว้ใน Transaction (Property Data), OTA_HotelRateAmountNotifRQ และข้อความ OTA_HotelAvailNotifRQ (อ้างอิงจากค่า PackageID เดียวกัน) จึงอาจต้องมีการอัปเดตที่สอดคล้องกันโดยใช้ข้อความประเภทอื่นๆ เพื่อแสดงให้เห็นว่า PackageID_2 และ PackageID_3 ไม่ได้กำหนดไว้ในที่นี้อีกต่อไป

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-08-18T16:20:00-04:00"
             id="12345678"
             partner="partner_key">
  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <!-- Additional RoomData child elements omitted. -->
      <Capacity>2</Capacity>
      <PhotoURL>
        <URL>http://www.foo.com/static/bar/image.jpg</URL>
        <Caption>
          <Text text="Room with a queen bed" language="en"/>
        </Caption>
      </PhotoURL>
    </RoomData>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Refundable" language="en"/>
      </Name>
      <!-- Additional PackageData child elements omitted. -->
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>


จำกัดแพ็กเกจราคา

ตัวอย่างต่อไปนี้เป็นตัวอย่างวิธีใช้องค์ประกอบ <AllowablePackageIDs> เพื่อจำกัดแพ็กเกจราคาที่อนุญาตสำหรับประเภทห้องพัก ในตัวอย่างนี้ ประเภทห้องพัก Queen (RoomID_2) จะใช้ร่วมกับแพ็กเกจและแพ็กเกจราคาที่ระบุเป็น PackageID_1 ได้เท่านั้น

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-12-18T16:20:00-04:00"
             id="12345678"
             partner="partner_key">
  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
    <RoomData>
      <RoomID>RoomID_2</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <AllowablePackageIDs>
        <AllowablePackageID>PackageID_1</AllowablePackageID>
      </AllowablePackageIDs>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <!-- Additional PackageData child elements omitted. -->
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
    <PackageData>
      <PackageID>PackageID_2</PackageID>
      <Name>
        <Text text="Free Breakfast" language="en"/>
      </Name>
      <!-- Additional PackageData child elements omitted. -->
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>

จำกัดความจุของห้อง

ต่อไปนี้คือตัวอย่างวิธีใช้องค์ประกอบ <Capacity>, <AdultCapacity>,<ChildCapacity> เพื่อกำหนดข้อจำกัดเกี่ยวกับความจุของห้อง

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-12-18T16:20:00-04:00"
             id="12345678"
             partner="partner_key">
  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <Name>
        <Text text="Double" language="en"/>
      </Name>
      <Capacity>4</Capacity>
      <AdultCapacity>4</AdultCapacity>
      <ChildCapacity>3</ChildCapacity>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
  </PropertyDataSet>
</Transaction>

ประเภทห้องแบบคู่ (RoomID_1) อาจเข้าพักได้สูงสุด 4 คน นอกจากนี้ โรงแรมอาจมีผู้ใหญ่ที่มีสมาชิกไม่เกิน 4 คนและเด็กสูงสุด 3 คน โดยต้องเป็นไปตามข้อกำหนดเกี่ยวกับความจุทั้ง 3 รายการจึงจะจองห้องนี้ได้ การกำหนดค่านี้หมายถึงห้องพักทั่วๆ ไปที่มี 2 เตียงโดยที่แต่ละหลังรองรับได้ 2 คน ความจุสำหรับเด็กต่ำกว่าจำนวนผู้เข้าพักทั้งหมด 1 คน เนื่องจากห้องพักต้องมีผู้ใหญ่อย่างน้อย 1 คนอยู่

ตัวอย่างเพิ่มเติมกับ <RoomFeatures> และอาหาร

JapaneseHotelRoomStyle ไม่มีค่าเริ่มต้น การละเว้นค่าจะไม่ส่งผลให้เกิดข้อผิดพลาดของ XML แต่ข้อมูลของคุณจะไม่ปรากฏในผลการค้นหาเมื่อผู้ใช้กรองตามสไตล์ห้องพักหรือเตียง

2 เตียงเดี่ยว

ตัวอย่างต่อไปนี้แสดงวิธีใช้ <RoomFeatures>

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
        <Beds> <!-- Two single beds -->
          <Bed size="single">
            <Width unit="cm" number="97"/>
            <Length unit="cm" number="195"/>
          </Bed>
          <Bed size="single">
            <Width unit="cm" number="97"/>
            <Length unit="cm" number="195"/>
          </Bed>
        </Beds>
        <Suite/>
        <Capsule/>
        <Roomsharing>private</Roomsharing>
        <Outdoor/>
        <MobilityAccessible/>
        <Smoking>non_smoking</Smoking>
        <BathAndToilet relation="separate">
          <Bath bathtub="1" shower="1"/>
          <Toilet electronic_bidet="1" mobility_accessible="1"/>
        </BathAndToilet>
        <OpenAirBath/>
        <AirConditioning/>
        <Balcony/>
        <Views>
          <LakeView/>
          <MarinaView/>
          <BeachView/>
          <ForestView/>
          <MountainView/>
          <NatureView/>
        </Views>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

เตียงคู่ 2 เตียง

ต่อไปนี้คือตัวอย่างห้องพักสไตล์ western ที่มี 2 เตียง double เตียง

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
        <Beds> <!-- Two double beds-->
          <Bed size="double"></Bed>
          <Bed size="double"></Bed>
        </Beds>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

สไตล์ญี่ปุ่นไม่มีเตียง

ต่อไปนี้เป็นตัวอย่างห้องพักสไตล์ญี่ปุ่นที่ไม่มีเตียง ไม่จำเป็นต้องมีข้อมูลเตียงสำหรับห้องสไตล์ japanese

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>japanese</JapaneseHotelRoomStyle>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

อาหารญี่ปุ่นตะวันตกแบบมีเตียง

ต่อไปนี้คือตัวอย่างห้องสไตล์ japanese_western ที่มีเตียงขนาด king

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
        <Beds>
          <Bed size="king"></Bed>
        </Beds>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

หากพาร์ทเนอร์ไม่มีข้อมูลจำนวนเตียงใน japanese_western ห้อง ให้ดูตัวอย่างต่อไปนี้

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>


อาหาร

ตัวอย่างต่อไปนี้กำหนดข้อมูลเมตาของห้องพักและแพ็กเกจสำหรับอาหาร รูปภาพ รวมถึงเวลาเช็คอินและเช็คเอาต์

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Meals Included" language="en"/>
      </Name>
      <PhotoURL>
        <Caption>
          <Text text="Breakfast" language="en"/>
          <Text text="朝食" language="ja"/>
        </Caption>
        <URL>http://example.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <Meals>
        <!-- Guests can choose to have breakfast in their room or in another
        space to avoid contact with other guests. -->
        <Breakfast included="1" in_room="1" in_private_space="1"/>
        <Dinner included="1" buffet="1"/>
      </Meals>
      <CheckinTime>15:00</CheckinTime>
      <CheckoutTime>11:00</CheckoutTime>
    </PackageData>
  </PropertyDataSet>
</Transaction>

มีเฉพาะอาหารเช้า

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Breakfast Included" language="en"/>
      </Name>
      <PhotoURL>
        <Caption>
          <Text text="Breakfast" language="en"/>
          <Text text="朝食" language="ja"/>
        </Caption>
        <URL>http://example.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <Meals>
        <Breakfast included="true"/>
        <!-- Dinner not included needs to be explicitly specified -->
        <Dinner included="false"/>
      </Meals>
      <CheckinTime>15:00</CheckinTime>
      <CheckoutTime>11:00</CheckoutTime>
    </PackageData>
  </PropertyDataSet>
</Transaction>

การตอบกลับ

ไวยากรณ์

ข้อความ TransactionResponse (Property Data) ใช้ไวยากรณ์ต่อไปนี้

<?xml version="1.0" encoding="UTF-8"?>
<TransactionResponse 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>
</TransactionResponse>

องค์ประกอบและแอตทริบิวต์

ข้อความ TransactionResponse (Property Data) มีองค์ประกอบและแอตทริบิวต์ต่อไปนี้

องค์ประกอบ / @แอตทริบิวต์ จำนวนข้อผิดพลาด ประเภท คำอธิบาย
TransactionResponse 1 Complex element องค์ประกอบรูทที่บ่งบอกความสำเร็จหรือปัญหาของข้อความคำขอ Transaction ที่ได้รับ
TransactionResponse / @timestamp 1 DateTime วันที่และเวลาที่สร้างข้อความนี้
TransactionResponse / @id 1 string ตัวระบุที่ไม่ซ้ำกันจากข้อความ Transaction ที่เกี่ยวข้อง
TransactionResponse / @partner 1 string บัญชีพาร์ทเนอร์สำหรับข้อความนี้
TransactionResponse / Success 0..1 Success บ่งบอกว่าข้อความ Transaction ได้รับการประมวลผลเรียบร้อยแล้วโดยไม่มีคำเตือน ข้อผิดพลาด หรือความล้มเหลว

แต่ละข้อความจะมี <Success> หรือ <Issues> ปรากฏอยู่
TransactionResponse / Issues 0..1 Issues คอนเทนเนอร์สำหรับปัญหาอย่างน้อย 1 รายการที่พบขณะประมวลผลข้อความ Transaction

แต่ละข้อความจะมี <Success> หรือ <Issues> ปรากฏอยู่
TransactionResponse / Issues / Issue 1..n Issue คำอธิบายของคำเตือน ข้อผิดพลาด หรือความล้มเหลวที่พบขณะประมวลผลข้อความ Transaction ดูรายละเอียดเกี่ยวกับปัญหาเหล่านี้ได้ในข้อความแสดงข้อผิดพลาดของสถานะฟีด
TransactionResponse / Issues / Issue / @code 1 integer ตัวระบุสำหรับปัญหา
TransactionResponse / Issues / Issue / @status 1 enum

ประเภทของปัญหาที่พบ

ค่าที่ถูกต้องคือ warning, error และ failure

ตัวอย่าง

Success

การตอบกลับข้อความ Transaction ที่ประมวลผลเรียบร้อยแล้วมีดังนี้

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

ปัญหา

การตอบกลับข้อความ Transaction ที่ยังไม่ได้ประมวลผลเนื่องจากมีข้อผิดพลาดมีดังนี้

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