거래 (속성 데이터)

요청

구문

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>

요소 및 속성

트랜잭션 (숙박 시설 데이터) 메시지에는 다음과 같은 요소가 있습니다. 속성:

요소 / @Attribute 발생 횟수 유형 설명
Transaction 1 Complex element ARI 구현에서 메시지의 루트 요소입니다. 단일 숙박 시설의 객실 유형 및 패키지 정의
Transaction / @timestamp 1 DateTime 이 메시지를 작성한 날짜 및 시간입니다.
Transaction / @id 1 string 이 요청 메시지의 고유 식별자입니다. 이 값이 반환됩니다. 을 입력합니다. 허용되는 문자는 a~z, A~Z, 0~9, _입니다. 밑줄, -(대시)를 입력합니다.
Transaction / @partner 1 string 이 메시지의 파트너 계정입니다. 이 문자열 값은 '파트너 키' 값이 <ph type="x-smartling-placeholder"></ph> 계정 설정 페이지로 이동합니다.

참고: 한 리소스에 대한 피드를 제공하는 백엔드가 있는 경우 계정이 여러 개인 경우 이 값은 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> 요소의 <id> 호텔 목록 피드에 표시됩니다. 호텔 ID는 Hotel Center에도 표시됩니다.
Transaction / PropertyDataSet / RoomData 0..n RoomData

방을 설명합니다.

참고: <RoomData> 중 하나 이상 또는 <PackageData>가 필요합니다.

Transaction / PropertyDataSet / RoomData / RoomID 1 RoomID 방 유형의 고유 식별자입니다. 이 값은 InvTypeCode 속성 다음의 요소 <StatusApplicationControl>개: <OTA_HotelAvailNotifRQ> 및 <OTA_HotelRateAmountNotifRQ> 메시지
Transaction / PropertyDataSet / RoomData / Name 1 Name 하나 이상의 회의실 카테고리 이름에 대한 컨테이너 있습니다.
Transaction / PropertyDataSet / RoomData / Name / Text 1..n Text 한 언어로 방 카테고리의 이름을 지정합니다.
Transaction / PropertyDataSet / RoomData / Name / Text / @text 1..n string language 속성
Transaction / PropertyDataSet / RoomData / Description 1 Name 하나 이상의 회의실 카테고리 설명을 위한 컨테이너 있습니다.
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 두 글자 언어 코드.
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs 0..1 AllowablePackageIDs <AllowablePackageID> 요소의 컨테이너입니다.

<AllowablePackageIDs>가 지정되면 방은 <RoomID>로 식별되는 유형 상위 <RoomData> 요소에는 <AllowablePackageID> 요소.

<AllowablePackageIDs>를 지정하지 않으면 회의실이 상위 요소에서 <RoomID>로 식별되는 유형 <RoomData> 요소는 다음 요소와 결합할 수 있습니다. 요금제를 사용하는 것이 좋습니다.

<AllowablePackageIDs> 또는 <AllowableRoomIDs> 중 한 가지만 지정할 수 있습니다.
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> 값은 양의 정수여야 합니다. 범위에 해당합니다.

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

모든 하위 요소를 포함할 필요는 없습니다.
Transaction / PropertyDataSet / RoomData / PhotoURL 0..n PhotoURL 주어진 방의 사진에 대한 URL 및 캡션(선택사항)입니다. 객실 패키지 <PhotoURL>을 2개 이상 지정할 수 있습니다. '객실 패키지'를 선택합니다.

이 요소는 다음과 같은 하위 요소를 사용합니다.

  • <URL>: 사진의 위치를 지정합니다. 이 위치는 방화벽 뒤가 아닌 공개되어야 하며 프로토콜 (http://)
  • <Caption>: 사진의 설명을 정의합니다. 이 요소는 단일 하위 요소 <Text>를 사용합니다. 여기에는 두 가지 필수 속성인 Text 및 language입니다. Text 속성은 자막입니다. language 속성은 두 문자를 언어 코드(예: 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 객실이 고정된 벽, 배관 및 실내 온도 조절기가 있습니다. 예: 호텔 객실 야외 숙박 시설은 아니지만 투숙객이 텐트에서 머무르는 캠핑장은 자신의 RV를 가져오는 RV 캠핑장은 야외 숙박 시설입니다.
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>가 필요합니다.

Transaction / PropertyDataSet / PackageData / PackageID 1 string 이러한 메시지의 PackageID는 OTA_HotelRateAmountNotifRQ의 RatePlanCode 및 OTA_HotelAvailNotifRQ 메시지
Transaction / PropertyDataSet / PackageData / Name 1 Name 하나 이상의 언어로 된 패키지 이름의 컨테이너입니다.
Transaction / PropertyDataSet / PackageData / Name / Text 1..n Text 패키지 이름을 한 가지 언어로 지정합니다.
Transaction / PropertyDataSet / PackageData / Name / Text / @text 1..n string 지정된 언어로 된 패키지 이름 language 속성
Transaction / PropertyDataSet / PackageData / Description 1 Description 하나 이상의 언어로 된 패키지 설명을 위한 컨테이너입니다.
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 두 글자 언어 코드.
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs 0..1 AllowableRoomIDs <AllowableRoomID> 요소의 컨테이너입니다.

<AllowableRoomIDs>을 지정하면 요금제가 <PackageID>로 식별 상위 <PackageData> 요소에는 (으)로 정의된 객실 유형과 결합됩니다. <AllowableRoomID> 요소.

<AllowableRoomIDs>를 지정하지 않으면 요율이 상위 요소의 <PackageID>에서 식별한 요금제 <PackageData> 요소는 다음 요소와 결합할 수 있습니다. 객실 유형입니다.

<AllowablePackageIDs> 또는 <AllowableRoomIDs> 중 한 가지만 지정할 수 있습니다.
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs / AllowableRoomID 1..n AllowableRoomID 이 항목과 결합할 수 있는 방 유형의 RoomID를 지정합니다. 요금제를 사용하는 것이 좋습니다. 방 유형이 <RoomData>에 정의되어 있음 요소가 포함됩니다.
Transaction / PropertyDataSet / PackageData / Refundable 0..1 Refundable 요금을 전액 환불 또는 취소 가능으로 표시할 수 있습니다. 제공하지 않은 경우 환불에 대한 정보가 표시되지 않습니다.

참고: 모든 속성을 설정하는 것이 좋습니다. 피드 하나 이상의 속성이 설정되지 않았습니다.

속성을 설정하지 않으면 요금이 환불이 가능합니다.

속성을 설정할 때는 다음 사항에 유의하세요.

  • available 또는 refundable_until_days인 경우 설정되어 있지 않으면 요금이 환불 가능으로 표시되지 않습니다.
  • available이 0 또는 false이면 다른 속성은 무시됩니다. 요금은 다른 속성 중 하나 또는 둘 다 설정되어 있더라도 환불이 가능합니다.
Transaction / PropertyDataSet / PackageData / Refundable / @available 1 boolean (필수) 1 또는 true: 요율이 전체 refund; 그렇지 않으면 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, 예를 들어 '환불은 2일 전 오후 4시까지 가능합니다. 확인합니다. 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> 요소는 두 개의 선택적 하위 요소를 사용합니다. 요소, <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이 true를 반환합니다.

식사 필터 (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 (<RoomData>의 <PhotoURL>와 동일, 패키지 (예: 식사 사진)에만 해당합니다.

예

객실 및 패키지 데이터

다음은 숙박 시설의 방을 정의하고 트랜잭션 (숙박 시설 데이터) 메시지에 패키지 데이터를 입력합니다. 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>

객실 유형 삭제

다음은 기존 방 유형을 삭제하는 방법과 패키지입니다 이 시나리오에서 'Room and package data'(회의실 및 패키지 데이터)의 메시지가 및 '객실 유형 추가' King 및 Google에서 메시지를 수신하면 Double개의 객실 유형이 더 이상 존재하지 않게 됩니다. 표시됩니다. 패키지 데이터를 삭제하면 전체 요금제에 영향을 미칩니다. 거래 (숙박 시설 데이터), 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명까지 투숙할 수 있습니다. 세 가지 용량 모두 요구사항을 충족해야 회의실을 예약할 수 있습니다. 이 배치는 각각 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 스타일 방의 예입니다. 침대가 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>

일본식 서양식 침대 포함

다음은 king를 사용하는 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>
        <Beds>
          <Bed size="king"></Bed>
        </Beds>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

</ph>

파트너가 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) 메시지에는 다음이 포함됩니다. 요소 및 속성:

요소 / @Attribute 발생 횟수 유형 설명
TransactionResponse 1 Complex element 수신된 거래 요청 메시지입니다.
TransactionResponse / @timestamp 1 DateTime 이 메시지를 작성한 날짜 및 시간입니다.
TransactionResponse / @id 1 string 연결된 거래 메시지의 고유 식별자입니다.
TransactionResponse / @partner 1 string 이 메시지의 파트너 계정입니다.
TransactionResponse / Success 0..1 Success 거래 메시지가 성공적으로 처리되었음을 나타냅니다. 알림을 받아볼 수 있습니다

<Success> 또는 <Issues>가 표시됩니다.
TransactionResponse / Issues 0..1 Issues 처리 중에 발생한 하나 이상의 문제에 대한 컨테이너입니다. 거래 메시지입니다.

<Success> 또는 <Issues>가 표시됩니다.
TransactionResponse / Issues / Issue 1..n Issue 해당 기간 동안 발생한 경고, 오류 또는 실패에 대한 설명 거래 메시지를 처리합니다. 이 문제에 대한 자세한 내용은 피드 상태 오류 메시지에서 확인할 수 있습니다.
TransactionResponse / Issues / Issue / @code 1 integer 문제의 식별자입니다.
TransactionResponse / Issues / Issue / @status 1 enum

발생한 문제의 유형입니다.

유효한 값은 warning, error, failure입니다.

예

성공

다음은 성공적으로 처리된 트랜잭션 메시지에 대한 응답입니다.

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

문제

다음은 오류가 발생했습니다.

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