인벤토리 메시지

개요

인벤토리 메시지 (OTA_HotelInvCountNotifRQ)는 특정 객실 유형에 대해 예약 가능한 인벤토리 수(실제 객실 수)를 정의합니다. 인벤토리 메시지를 전송할 때 특정 날짜에 사용 가능한 해당 유형의 객실 수를 표시합니다. 해당 유형의 객실이 없는 경우 해당 객실 유형 및 날짜와 관련된 제품이 표시되지 않습니다.

다음 섹션에서는 인벤토리를 추가 및 업데이트하고 인벤토리 메시지를 전송하는 데 도움이 되는 일반 가이드라인, 기본 예시, 방법 시나리오를 다룹니다.

다양한 인벤토리 관련 시나리오의 예는 방법을 참고하세요.

필수 요소 및 선택 요소

XML 참조에서는 필수 및 선택적 요소에 대해 설명합니다. 속성 및 하위 요소에 관한 자세한 내용은 인벤토리 요소 및 속성을 참고하세요.

구문 및 스키마

인벤토리 메시지를 만들 때 인벤토리 구문 예시를 참고하여 올바른 형식을 따르세요.

xmllint와 같은 서드 파티 XML 도구를 사용하여 게시된 스키마로 피드의 유효성을 검사한 후 Google에 제출할 수 있습니다. 인벤토리 메시지 스키마는 호텔 광고 스키마를 참고하세요.

가이드라인

인벤토리 메시지에 다음 가이드라인을 사용하세요.

인벤토리는 호텔, 날짜, 객실 유형별로 키가 지정됩니다.
연관된 요금제 및 숙박 인원에 대한 가격을 표시하려면 숙박 기간의 모든 밤에 대해 재고 수가 0보다 커야 합니다.
인벤토리 수가 0이면 지정된 객실 ID 및 기간에 예약할 수 있는 객실이 없습니다.
CountType는 '확실한 재고' 수를 나타내므로 유효하려면 항상 2 값을 가져야 합니다.
시스템에서 객실 예약 또는 취소가 발생할 때마다 업데이트된 인벤토리를 전송합니다.

인벤토리와 가용성 비교

인벤토리는 실제 수에 기반한 예약 가능한 객실 수이며, 예약 가능 여부는 객실 유형과 요금제의 조합을 예약할 수 있는지 여부를 나타냅니다. ARI의 경우 예약 가능 여부와 인벤토리는 모두 날짜 집합 또는 숙박 시설 유형에 따라 달라질 수 있으며, 둘 다 해당하는 메시지 유형이 있습니다. 인벤토리와 예약 가능 여부는 호텔, 날짜, 객실 유형을 기준으로 하며 예약 가능 여부에는 요금제가 추가됩니다.

인벤토리와 재고는 서로 독립적이므로 인벤토리가 있어도 '재고 없음'이 표시될 수 있습니다.

사용 가능 여부에는 두 가지 개념이 있습니다. 먼저 특정 숙박에 대한 제품의 전체 재고는 매일 정의된 요금이 있는지, 연결된 객실 유형의 인벤토리, 재고 제한이 열려 있는지 등의 요인에 영향을 받습니다. 두 번째는 특정 날짜의 제품에 대한 구체적인 제한사항으로, OTA_HotelAvailNotifRQ에서 <RestrictionStatus Restriction="Master" Status="Open"/>로 표시되며 이 재고를 종료하는 것을 '판매 중지'라고 합니다.

제품의 가격을 표시하려면 객실의 인벤토리가 0보다 큰 정수여야 하고 예약 가능 여부 제한이 열려 있어야 합니다.

예

이 섹션에서는 필수 요소와 선택적 요소를 사용하는 인벤토리 메시지의 기본 예를 제공합니다. 파일을 준비한 후에는 다음 엔드포인트로 POST 메시지를 통해 Google에 파일을 전송해야 합니다.

https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif

메시지를 푸시/POST하는 방법에 대한 자세한 내용은 메시지 푸시를 참고하세요.

HotelCode의 경우 시스템 내에서 숙박 시설을 식별하는 데 사용한 고유한 호텔 ID를 사용합니다. 이 값은 호텔 목록 피드에서 <listing> 요소의 <id>를 사용하여 지정된 호텔 ID와 일치해야 합니다. <RoomID>의 경우 시스템 내에서 객실 유형에 사용한 것과 동일한 ID를 사용합니다. Google에서 데이터를 올바르게 표시하려면 시스템과의 일관성이 중요합니다.

다음은 12월에 예약 가능한 객실 13개의 인벤토리를 설정하는 방법을 보여주는 예입니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

더 많은 예는 인벤토리 예시를 참고하세요.

방법

이 섹션에서는 인벤토리 메시지를 전송하는 중에 발생할 수 있는 시나리오를 제공합니다.

시나리오: 회의실 예약 차단 방법

설명

특정 날짜에 이 객실 유형으로 예약할 수 있는 객실이 남아 있지 않음을 표시해야 합니다. 이는 일반적으로 매진되었기 때문입니다.

솔루션

<InvCount Count>을 0 값으로 설정하고 원하는 기간을 추가합니다.

샘플

이 샘플은 InvCount를 사용하여 지정된 객실 및 날짜 (예: 1월 첫 몇 주)의 인벤토리를 0로 설정하는 방법을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>