요청
문법
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의
계정 설정 페이지에 나열된 파트너 키 값입니다.
참고: 여러 계정에 피드를 제공하는 백엔드가 있는 경우 이 값은 거래 (속성 데이터) 메시지의 |
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 로 설정합니다.
|
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue | 0..1 | boolean | 화요일을 명시적으로 포함하려면 true 또는 1 로 설정합니다.
|
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds | 0..1 | boolean | 수요일을 명시적으로 포함하려면 true 또는 1 로 설정하세요.
|
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur | 0..1 | boolean | 목요일을 명시적으로 포함하려면 true 또는 1 로 설정합니다.
|
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri | 0..1 | boolean | 금요일을 명시적으로 포함하려면 true 또는 1 로 설정합니다.
|
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat | 0..1 | boolean | 토요일을 명시적으로 포함하려면 true 또는 1 로 설정합니다.
|
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun | 0..1 | boolean | 일요일을 명시적으로 포함하려면 true 또는 1 로 설정합니다.
|
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 | 지정 중인 인벤토리 수의 유형입니다. 유효한 값은 다음과 같습니다.
|
예
잔여 인벤토리
지정된 날짜에 RoomID_1
님에게 남은 회의실 5개를 설정합니다.
<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 메시지가 성공적으로 처리되었음을 나타냅니다.
각 메시지에는 |
OTA_HotelInvCountNotifRS / Errors | 0..1 | Errors | OTA_HotelInvCountNotifRQ 메시지를 처리하는 동안 발생한 하나 이상의 문제에 대한 컨테이너입니다.
각 메시지에는 |
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>