이 페이지는 Cloud Translation API를 통해 번역되었습니다.

OTA_HotelInvCountNotifRQ

요청

문법

OTA_HotelInvCountNotifRQ 메시지는 다음 구문을 사용합니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="message_ID"
                          TimeStamp="timestamp"
                          Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="integer" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

요소 및 속성

OTA_HotelInvCountNotifRQ 메시지에는 다음과 같은 요소와 속성이 있습니다.

요소 / @Attribute	발생 횟수	유형	설명
OTA_HotelInvCountNotifRQ	1	Complex element	객실 요금 이용 가능 여부를 정의하는 메시지의 루트 요소입니다.
OTA_HotelInvCountNotifRQ / @xmlns	0..1	string (URI)	XML 네임스페이스입니다.
OTA_HotelInvCountNotifRQ / @EchoToken	1	string	이 요청 메시지의 고유 식별자입니다. 이 값은 응답 메시지에 반환됩니다. 허용되는 문자는 a~z, A~Z, 0~9, _(밑줄), - (대시)입니다.
OTA_HotelInvCountNotifRQ / @TimeStamp	1	DateTime	이 메시지의 작성 날짜 및 시간입니다.
OTA_HotelInvCountNotifRQ / @Version	1	decimal	OpenTravel 메시지 버전입니다.
OTA_HotelInvCountNotifRQ / POS	0..1	POS	이 메시지의 파트너 계정을 지정하기 위한 컨테이너입니다. 일반적으로 백엔드에서 여러 파트너 계정에 가격 피드를 제공하는 경우에 사용됩니다.
OTA_HotelInvCountNotifRQ / POS/ Source	1	Source	`<POS>`가 있는 경우 필수입니다. `<RequestorID>`의 컨테이너.
OTA_HotelInvCountNotifRQ / POS / RequestorID	1	RequestorID	`<POS>`가 있는 경우 필수입니다. 파트너 계정을 정의합니다.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID	1	string	이 메시지의 파트너 계정입니다. 이 문자열 값은 Hotel Center의 계정 설정 페이지에 표시된 파트너 키 값입니다. 참고: 여러 계정에 피드를 제공하는 백엔드가 있는 경우, 이 값은 동일한 계정에 대한 거래 (숙박 시설 데이터) 메시지의 `partner` 속성 값과 `<OTA_HotelRateAmountNotifRQ>` 메시지의 `<RequestorID>` 요소에 있는 `ID` 속성 값과 일치해야 합니다.
OTA_HotelInvCountNotifRQ / Inventories	1	Inventories	하나 이상의 `<Inventory>` 요소의 컨테이너입니다.
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode	1	string	속성의 고유 식별자입니다. 이 값은 호텔 목록 피드의<listing> 요소에서 <id>를 사용하여 지정된 호텔 ID와 일치해야 합니다. 호텔 ID는 Hotel Center에도 나와 있습니다.
OTA_HotelInvCountNotifRQ / Inventories / Inventory	1..n	Inventory	단일 속성에 대해 다양한 기간에 사용 가능한 회의실 수를 정의합니다.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl	1	StatusApplicationControl	기간과 객실 유형의 식별자(`InvTypeCode`)를 정의합니다.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start	1	Date	기간을 포함한 시작일입니다 (속성의 시간대를 기준으로 함).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End	1	Date	기간의 종료일 (속성의 시간대를 기준으로 함)입니다. `start` 값보다 크거나 같아야 합니다. `start`과 `end`이 같으면 업데이트가 해당 날짜에 적용됩니다.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon	0..1	boolean	월요일을 명시적으로 포함하려면 `true` 또는 `1`로 설정합니다. `true`로 설정하면 명시적으로 `true`로 설정되지 않은 다른 요일은 제외됩니다 (실제로 `Start` 및 `End` 내 날짜에서 필터링됨).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue	0..1	boolean	화요일을 명시적으로 포함하려면 `true` 또는 `1`로 설정합니다. `true`로 설정하면 명시적으로 `true`로 설정되지 않은 다른 요일은 제외됩니다 (실제로 `Start` 및 `End` 내 날짜에서 필터링됨).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds	0..1	boolean	수요일을 명시적으로 포함하려면 `true` 또는 `1`로 설정합니다. `true`로 설정하면 명시적으로 `true`로 설정되지 않은 다른 요일은 제외됩니다 (실제로 `Start` 및 `End` 내 날짜에서 필터링됨).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur	0..1	boolean	목요일을 명시적으로 포함하려면 `true` 또는 `1`로 설정합니다. `true`로 설정하면 명시적으로 `true`로 설정되지 않은 다른 요일은 제외됩니다 (실제로 `Start` 및 `End` 내 날짜에서 필터링됨).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri	0..1	boolean	금요일을 명시적으로 포함하려면 `true` 또는 `1`로 설정합니다. `true`로 설정하면 명시적으로 `true`로 설정되지 않은 다른 요일은 제외됩니다 (실제로 `Start` 및 `End` 내 날짜에서 필터링됨).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat	0..1	boolean	토요일을 명시적으로 포함하려면 `true` 또는 `1`로 설정합니다. `true`로 설정하면 명시적으로 `true`로 설정되지 않은 다른 요일은 제외됩니다 (실제로 `Start` 및 `End` 내 날짜에서 필터링됨).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun	0..1	boolean	일요일을 명시적으로 포함하려면 `true` 또는 `1`로 설정합니다. `true`로 설정하면 명시적으로 `true`로 설정되지 않은 다른 요일은 제외됩니다 (실제로 `Start` 및 `End` 내 날짜에서 필터링됨).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode	1	string	인벤토리의 고유 식별자입니다 (객실 유형). 이 값은 트랜잭션(숙박 시설 데이터) 메시지의 `<RoomID>`에 매핑됩니다.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts	1	InvCounts	단일 인벤토리 수를 정의하기 위한 컨테이너입니다.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount	1	InvCount	예약할 수 있는 회의실 수를 정의합니다.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count	1	integer	객실 유형에 대해 예약할 수 있는 회의실 수입니다. 값 0은 객실 유형이 매진되었음을 나타냅니다. 음수 값은 0으로 취급됩니다.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType	1	enum	지정되는 인벤토리 개수의 유형입니다. 유효한 값은 다음과 같습니다. `2`: 확실한 가용성.

예시

잔여 인벤토리

지정된 날짜에 5rooms left forRoomID_1` 을 설정합니다.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="5" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

매진 인벤토리

지정된 날짜에 RoomID_1 제품을 품절로 표시합니다.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

응답

문법

OTA_HotelInvCountNotifRS 메시지는 다음 구문을 사용합니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="timestamp"
                          EchoToken="echo_token"
                          Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>

요소 및 속성

OTA_HotelInvCountNotifRS 메시지에는 다음과 같은 요소와 속성이 있습니다.

요소 / @Attribute	발생 횟수	유형	설명
	1	Complex element	연락 가능 여부 메시지에 대한 응답의 루트 요소입니다.
OTA_HotelInvCountNotifRS / @TimeStamp	1	DateTime	이 메시지의 작성 날짜 및 시간입니다.
OTA_HotelInvCountNotifRS / @EchoToken	1	string	연결된 `OTA_HotelInvCountNotifRQ` 메시지의 고유 식별자입니다.
OTA_HotelInvCountNotifRS / Success	0..1	Success	`OTA_HotelInvCountNotifRQ` 메시지가 성공적으로 처리되었음을 나타냅니다. 각 메시지에 `<Success>` 또는 `<Errors>`가 있습니다.
OTA_HotelInvCountNotifRS / Errors	0..1	Errors	`OTA_HotelInvCountNotifRQ` 메시지를 처리하는 동안 발생한 하나 이상의 문제에 대한 컨테이너입니다. 각 메시지에 `<Success>` 또는 `<Errors>`가 있습니다.
OTA_HotelInvCountNotifRS / Errors / Error	1..n	Error	`OTA_HotelInvCountNotifRQ` 메시지를 처리하는 동안 발생한 오류에 대한 설명입니다. 이러한 오류에 관한 자세한 내용은 피드 상태 오류 메시지에서 확인할 수 있습니다.
OTA_HotelInvCountNotifRS / Errors / Error / @Type	1	integer	오류와 관련된 OpenTravel Alliance EWT (오류 경고 유형)입니다. `12 (Processing exception)` 값만 사용됩니다.
OTA_HotelInvCountNotifRS / Errors / Error / @Code	1	integer	오류와 관련된 OpenTravel Alliance ERR (오류 코드)입니다. `450 (Unable to process)` 값만 사용됩니다.
OTA_HotelInvCountNotifRS / Errors / Error / @Code	1	enum	원래 요청의 상태입니다. `NotProcessed` 값만 사용됩니다.
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText	1	string	문제의 Google 식별자입니다. 이러한 오류에 관한 자세한 내용은 피드 상태 오류 메시지에서 확인할 수 있습니다.

예시

성공

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

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Success/>
</OTA_HotelInvCountNotifRS>

오류

다음은 오류로 인해 처리되지 않은 OTA_HotelInvCountNotifRQ 메시지에 대한 응답입니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>