Step 2: Confirming the reservations based on OTA_NotifReportRQ / OTA_NotifReportRS

This is part two of the asynchronuous method. The Hotel-Spider will confirm the successfull import of the reservations / modifications / cancellations received in step 1 by sending an OTA_NotifReportRQ request to the same endpoint as the one specified in step 1.

Endpoints

The two same endpoints will be used for the staging / testing and for production.

Example request and response

OTA_NotifReportRQ request

<OTA_NotifReportRQ Version="1.000" TimeStamp="2015-12-08T18:30:47+01:00" EchoToken="123456789">
  <Success/>
  <NotifDetails>
    <HotelNotifReport>
      <HotelReservations>
        <HotelReservation>
          <ResGlobalInfo>
            <HotelReservationIDs>
              <HotelReservationID ResID_Source="ONLINEBOOKINGSYSTEMID" ResID_SourceContext="ONLINEBOOKINGSYSTEMNAME" ResID_Type="14" ResID_Value="ABCD-668591"/>
			  <HotelReservationID ResID_SourceContext="Hotel-Spider" ResID_Type="40" ResID_Value="PMS-111333"/>
            </HotelReservationIDs>
          </ResGlobalInfo>
        </HotelReservation>
      </HotelReservations>
    </HotelNotifReport>
  </NotifDetails>
</OTA_NotifReportRQ>

OTA_ResRetrieveRS request

<OTA_NotifReportRS Version="1.000" TimeStamp="2015-12-08T18:30:48+01:00" EchoToken="123456789">
  <Success/>
</OTA_NotifReportRS>

Request structure

OTA_NotifReportRQ

Parent: None (Root element)

Mandatory: yes

Attributes:

Name	Mandatory	Description
TimeStamp	Yes	The format should respect the ISO 8601 2015-11-16T22:23:48+00:00
Target	Yes	When sending updates to the staging environment "Test" must be used. When sending updates to the production environment "Production" must be used.
Version	Yes	The default value should be "1.000"
EchoToken	Yes	The value will be returned in the OTA_HotelResNotifRS response

Child elements: Success, Warnings, Errors, NotifDetails

Success

Parent: OTA_NotifReportRQ

Mandatory: no

Attributes: None

Child elements: None

NotifDetails

Parent: OTA_NotifReportRQ

Mandatory: no

Attributes: None

Child elements: None

HotelNotifReport

Parent: NotifDetails

Mandatory: no

Attributes: None

Child elements: None

HotelReservations

Parent: HotelNotifReport

Mandatory: no

Attributes: None

Child elements: None

HotelReservation

Parent: HotelReservations

Mandatory: no

Attributes: None

Child elements: None

ResGlobalInfo

Parent: HotelReservation

Mandatory: no

Attributes: None

Child elements: None

HotelReservationIDs

Parent: ResGlobalInfo

Mandatory: no

Attributes: None

Child elements: None

HotelReservationID

Parent: HotelReservationIDs

Mandatory: yes

Attributes:

Name	Mandatory	Description
ResID_Type	Yes	Possible values are: 14 (Reservation) 15 (Cancellation) 40 (Confirmation)
ResID_Value	Yes	The reservation number as provided by the online booking system to the end customer/guest
ResID_SourceContext	No	The name of the online booking system
ResID_Source	Yes	The ID of the online booking system as defined on the Hotel-Spider system.

Child elements: None

Use case 1: Confirming a reservation

If the Hotel-Spider system imported a reservation in Step 1: Polling the reservations based on OTA_ReadRQ / OTA_ResRetrieveRS, it will return 1 HotelReservationID element containing the same ResID_Value, ResID_Source, ResID_SourceContext and ResID_Type="14" attribute values. In a second HotelReservationID element, a ResID_Type="40", ResID_SourceContext="Hotel-Spider" and a ResID_Value attribute containing the Hotel-Spider internal reservation ID will be returned.

Use case 2: Confirming a cancellation

If the Hotel-Spider system imported a cancellation in Step 1: Polling the reservations based on OTA_ReadRQ / OTA_ResRetrieveRS, it will return 1 HotelReservationID element containing the same ResID_Value, ResID_Source, ResID_SourceContext and ResID_Type="15" attribute values. In a second HotelReservationID element, a ResID_Type="40", ResID_SourceContext="Hotel-Spider" and a ResID_Value attribute containing the Hotel-Spider internal reservation ID will be returned.

Errors

Parent: OTA_NotifReportRQ

Mandatory: No

Attributes: None

Child elements: Error

Error

Parent: Errors

Mandatory: yes

Attributes:

Name	Mandatory	Description
Code	Yes	The unique error code assigned by the online booking system
Type	Yes
Status	Yes	Possible values are: NotProcessed Incomplete Complete Unknown
ShortText	Yes	A short textual explanation of the error
Tag	Yes	Indicates which element and/or attribute provoked the error to occur

Child elements: None

Response structure

OTA_NotifReportRS

Parent: None (Root element)

Mandatory: yes

Attributes:

Name	Mandatory	Description
TimeStamp	Yes	The format should respect the ISO 8601 2015-11-16T22:23:48+00:00
Target	Yes	When sending updates to the staging environment "Test" must be used. When sending updates to the production environment "Production" must be used.
Version	Yes	The default value should be "1.000"
EchoToken	Yes	The value will be returned in the OTA_HotelResNotifRS response

Child elements: Success, Warnings, Errors

Success

Parent: OTA_NotifReportRS

Mandatory: no

Attributes: None

Child elements: None

Errors

Parent: OTA_NotifReportRQ

Mandatory: No

Attributes: None

Child elements: Error

Error

Parent: Errors

Mandatory: yes

Attributes:

Name	Mandatory	Description
Code	Yes	The unique error code assigned by the online booking system
Type	Yes
Status	Yes	Possible values are: NotProcessed Incomplete Complete Unknown
ShortText	Yes	A short textual explanation of the error
Tag	Yes	Indicates which element and/or attribute provoked the error to occur

Child elements: None