인벤토리 메시지

개요

인벤토리 메시지 (OTA_HotelInvCountNotifRQ)는 인벤토리 수를 정의합니다. 특정 회의실을 예약할 수 있는 (실제 회의실 수) 있습니다. Inventory 메시지를 보낼 때 해당 메시지 중 몇 개의 방이 있는지 표시합니다. 지정된 날짜에 사용할 수 있습니다. 해당 유형의 사용 가능한 방이 없는 경우 해당 객실 유형 및 날짜와 관련된 제품은 표시되지 않습니다.

다음 섹션에서는 일반 가이드라인, 기본 예 및 방법을 설명합니다. 인벤토리 추가 및 업데이트와 인벤토리 전송에 대해 인벤토리 메시지

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

필수 요소 및 선택적 요소

XML 참조 필수 및 선택 요소에 대한 설명이 나와 있습니다. 자세히 알아보기 자세한 내용은 인벤토리 요소 및 속성을 참조하세요.

구문 및 스키마

인벤토리 탭에서 인벤토리와 구문 예를 를 참조하여 인벤토리 메시지를 작성할 때 할 수 있습니다.

xmllint와 같은 타사 XML 도구를 사용하면 스키마를 다시 제출해야 합니다. 인벤토리용 메시지 스키마에 대한 자세한 내용은 호텔 광고 스키마를 참고하세요.

가이드라인

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

  • 인벤토리는 호텔, 날짜, 객실 유형으로 키가 지정됩니다.

  • 전체 숙박 일수에 대해 인벤토리 수가 0보다 커야 합니다. 관련 요금제 및 숙박 인원의 가격을 표시합니다.

  • 인벤토리 수가 0개보다 많으면 다음 사용자가 회의실을 사용할 수 없게 됩니다. 예약하기만 하면 됩니다.

  • CountType는 항상 2 값을 가져야 함을 나타냅니다. '무한 이용 가능 여부'의 카운트입니다.

  • 회의실 예약 또는 취소 시 업데이트된 인벤토리 전송 어떻게 해야 할까요?

인벤토리와 가용성 비교

Inventory(인벤토리)는 실제 수를 기준으로 예약 가능한 객실의 수입니다. 이용 가능 여부 는 객실 유형 및 요금제의 조합이 다음과 같은지 여부를 나타냅니다. 예약할 수 있습니다. 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> 요소를 호텔 목록 피드. <RoomID>의 경우 시스템에서 사용한 것과 동일한 ID를 사용하세요. 객실 유형 Google 서비스 제공을 보장하려면 시스템과의 일관성이 매우 중요합니다. 에서 데이터를 올바르게 표시하고 있습니다.

이 예에서는 12월:

<?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를 사용하여 인벤토리를 0로 설정하는 방법을 날짜 (예: 1월의 처음 몇 주)

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