API Reference: Consulta de una Reserva - Hoteles

De Wiki PriceSurfer
Ir a la navegaciónIr a la búsqueda

Ejemplo de uso:

      • Solicitud:

<BookingQueryRQ>

 <GeneralParameters>
   <PreferedLanguage LanguageCode="es"/>
   <PreferedCurrency CurrencyCode="ARS"/>
 </GeneralParameters>
 <Bookings>
   <Booking BookingReference="XX_007GP"/>
 </Bookings>

</BookingQueryRQ>


Parámetro Obligatorio Descripción
GeneralParameters Si
PreferedLanguage Si Establece el lenguaje requerido para la respuesta.

Atributos:

LanguageCode: Código de lenguaje correspondiente a los códigos de lenguaje estándar provistos por Nemo.

PreferedCurrency No Establece la moneda requerida para la respuesta.

Atributos:

CurrencyCode: Código de moneda correspondiente a los códigos de moneda estándar provistos.

(Dicho nodo es No Obligatorio ya que la moneda utilizada actualmente es la configurada en el contrato)

Bookings Si Mediante el nodo Booking se cargan las reservas a consultar.
Booking

Atributos:

- BookingReference: Localizador (Identificador) de la Reserva en Price Surfer

- Online: En "true" genera un "Detalle online" con el proveedor. En "false" se genera un "Detalle Offline" con la info en PriceSurfer - Ej: Online="false"

Valor por defecto sin estar explicitado el atributo "Online" es "true" (Deploy Setiembre 2020)

      • Respuesta:

<BookingQueryRS>

  <Details>
     <Bookings>
        <Booking>
           <BookingReference>XX_007GP</BookingReference>
           <BookingState>NMO.GBL.BST.CNF</BookingState>
           <BookingComments>Comentarios de la reserva</BookingComments>
           <Products>
              <Hotels>
                 <Hotel HotelCode="2392" SupplierID="BOL">
                    <BookingReferences>
                       <BookingReference ReferenceType="NMO.HTL.RPT.MPH">XX_007GP-1</BookingReference>
                       <BookingReference ReferenceType="NMO.HTL.RPT.PRS.PS1">249</BookingReference>
                       <BookingReference ReferenceType="NMO.HTL.RPT.PRS.PS2">278094</BookingReference>
                    </BookingReferences>
                    <BookingStatusList>
                       <BookingStatus>
                          <BookingStatusDescription BookingStatusCode="NMO.HTL.BST.CNF">Confirmado</BookingStatusDescription>
                          <BookingStatusActor BookingStatusActorType="HAR.DCO.DE1"></BookingStatusActor>
                          <RulesInfo>
                             <RuleInfo Permit="true" RuleType="NMO.GBL.RBS.DET"/>
                             <RuleInfo Permit="true" RuleType="NMO.GBL.RBS.VOU"/>
                             <RuleInfo Permit="true" RuleType="NMO.GBL.RBS.CAN"/>
                             <RuleInfo Permit="true" RuleType="NMO.GBL.RBS.PAY"/>
                          </RulesInfo>
                       </BookingStatus>
                    </BookingStatusList>
                    <Hotel SupplierID="BOL" HotelCode="2392">
                       <HotelName>Americas Towers</HotelName>
                       <HotelDescriptions>
                          <HotelDescription HotelDescriptionType="General">El hotel cuenta con 100 habitaciones espaciosas y lujosas, de las cuales 10 son suites; vestí­bulo con recepción 24 horas, caja fuerte, bar, restaurante, conexión a Internet, sala de conferencias moderna y decorada con paneles de madera y telas; servicio de habitaciones 24 horas, servicio de despertador y servicio de limpieza.</HotelDescription>
                          <HotelDescription HotelDescriptionType="General">La piscina del hotel permanece abierta de octubre a marzo.</HotelDescription>
                       </HotelDescriptions>
                       <LocationDetails ItemsCount="1">
                          <Location Sequence="1" LocationCode="G9">Cerca del centro</Location>
                       </LocationDetails>
                       <Amenities ItemsCount="50">
                          <Amenity Fee="No" Sequence="1">
                             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.LOC">Ubicación</AmenityGroup>
                             <Description AmenityCode="1">En la carretera principal</Description>
                          </Amenity>
                          ...
                       </Amenities>
                       <Addresses>
                          <Address>
                             <AddressLines>
                                <AddressLine>Libertad 1070</AddressLine>
                                <AddressLine>1012 - BUENOS AIRES</AddressLine>
                                <AddressLine>Buenos Aires</AddressLine>
                             </AddressLines>
                             <TelephoneNumbers>
                                <TelephoneNumber>
                                   <TelephoneNumberType TelephoneNumberType="NMO.GBL.TLT.TE1">phoneHotel</TelephoneNumberType>
                                   <TelephoneNumberValue>5411 4129 0700</TelephoneNumberValue>
                                </TelephoneNumber>
                                <TelephoneNumber>
                                   <TelephoneNumberType TelephoneNumberType="NMO.GBL.TLT.OFF">phoneBooking</TelephoneNumberType>
                                   <TelephoneNumberValue>5411 4129 0700</TelephoneNumberValue>
                                </TelephoneNumber>
                             </TelephoneNumbers>
                             <PostalCode CountryCode="AR">1012</PostalCode>
                             <Destinations>
                                <Destination DestinationType="NMO.HTL.DST.CTY" DestinationCode="5694">Buenos Aires</Destination>
                                <Destination DestinationType="NMO.HTL.DST.CTR" DestinationCode="202">Argentina</Destination>
                                <Destination DestinationType="NMO.HTL.DST.CNT" DestinationCode="15">América del Sur</Destination>
                                <Destination DestinationType="NMO.HTL.DST.ALL" DestinationCode="1">Planeta Tierra</Destination>
                             </Destinations>
                          </Address>
                       </Addresses>
                       <Position>
                          <Latitude>-34.595992</Latitude>
                          <Longitude>-58.384257</Longitude>
                       </Position>
                       <HotelRating HotelRatingCode="NMO.HTL.RTN.4ST" HotelRatingType="NMO.HTL.RTT.STR">
                          <RatingDescription>4 Estrellas</RatingDescription>
                          <RatingValue>4.0</RatingValue>
                       </HotelRating>
                       <ImageLinks ItemsCount="4">
                          <ImageLink Sequence="1">
                             <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">General</ImageDescription>
                             <DisplayOrder>1</DisplayOrder>
                             <ImageHeight UnitOfMeasureCode="9">52</ImageHeight>
                             <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                             <ImageURL>1/6/169FECAA517308C6D670861605F22743.jpg</ImageURL>
                             <ThumbnailURL>9/8/98AE7381AF851A3631486502673653F2.jpg</ThumbnailURL>
                          </ImageLink>
                          <ImageLink Sequence="2">
                             <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Habitación</ImageDescription>
                             <DisplayOrder>2</DisplayOrder>
                             <ImageHeight UnitOfMeasureCode="9">51</ImageHeight>
                             <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                             <ImageURL>6/0/60E1951BFA1D41836BCF1E8187675214.jpg</ImageURL>
                             <ThumbnailURL>5/0/5054FD9BAA428B52E49AD64DA800F23B.jpg</ThumbnailURL>
                          </ImageLink>
                          <ImageLink Sequence="3">
                             <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Piscina</ImageDescription>
                             <DisplayOrder>3</DisplayOrder>
                             <ImageHeight UnitOfMeasureCode="9">50</ImageHeight>
                             <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                             <ImageURL>6/D/6DE26A3917736F13E0FD5E78DD5C9723.jpg</ImageURL>
                             <ThumbnailURL>C/A/CACCD17D7DC58DAB61148E5BD9451D99.jpg</ThumbnailURL>
                          </ImageLink>
                          <ImageLink Sequence="4">
                             <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Vestí­bulo</ImageDescription>
                             <DisplayOrder>4</DisplayOrder>
                             <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                             <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                             <ImageURL>1/3/136806D8E0E937AB37CF6644424DA587.jpg</ImageURL>
                             <ThumbnailURL>5/1/51927647FC24A445C17A1B5CF47EF5BC.jpg</ThumbnailURL>
                          </ImageLink>
                       </ImageLinks>
                       <HotelChain>GRUPO AMERICAS</HotelChain>
                       <Emails ItemsCount="1">
                          <Email Sequence="1">
                             <EmailType EmailType="NMO.GBL.EMT.OFC"/>
                             <EmailValue>TOWERS@AMERICAS-BUE.COM.AR</EmailValue>
                          </Email>
                       </Emails>
                       <URLs ItemsCount="1">
                          <URL Sequence="1" URLType="web">www.grupoamericas.com.ar</URL>
                       </URLs>
                    </Hotel>
                    <DestinationDetails>
                       <Destination DestinationType="NMO.HTL.DST.CTY" DestinationCode="5694">Buenos Aires</Destination>
                       <Destination DestinationType="NMO.HTL.DST.CTR" DestinationCode="202">Argentina</Destination>
                       <Destination DestinationType="NMO.HTL.DST.CNT" DestinationCode="15">América del Sur</Destination>
                       <Destination DestinationType="NMO.HTL.DST.ALL" DestinationCode="1">Planeta Tierra</Destination>
                    </DestinationDetails>
                    <CheckIn>2014-08-18Z</CheckIn>
                    <CheckOut>2014-08-20Z</CheckOut>
                    <Rate>
                       <Rooms>
                          <Room>
                             <RoomDescription RoomType="NMO.HTL.RMT.SGL">INDIVIDUAL STANDARD</RoomDescription>
                             <Occupancy>
                                <AdultsCount>1</AdultsCount>
                                <ChildrenCount>0</ChildrenCount>
                                <InfantCount>0</InfantCount>
                                <RoomsCount>1</RoomsCount>
                                <Passengers>
                                   <Passenger AgeType="NMO.GBL.AGT.ADT">
                                      <PersonNames>
                                         <PersonName NameType="NMO.GBL.PNT.FIR">NOMBRE</PersonName>
                                         <PersonName NameType="NMO.GBL.PNT.LAS">APELLIDO</PersonName>
                                      </PersonNames>
                                      <Age>30</Age>
                                   </Passenger>
                                </Passengers>
                             </Occupancy>
                             <Availability AvailabilityCode="NMO.HTL.AVB.CNF">Inmediate Confirmation</Availability>
                          </Room>
                       </Rooms>
                       <Board Code="3">ALOJAMIENTO Y DESAYUNO</Board>
                       <RatePrices>
                          <RatePrice Currency="ARS" Type="NMO.HTL.RPT.NET">1082.65</RatePrice>
                          <RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">1082.65</RatePrice>
                       </RatePrices>
                       <ChargeConditions>
                          <ChargeCondition Sequence="1">
                             <ChargeDescription ChargeType="NMO.HTL.CHT.CAN">Cancellation</ChargeDescription>
                             <DateRangeWithDateType>
                                <DateFrom>2014-08-15T00:00:00.000Z</DateFrom>
                                <DateTo>2014-08-18T00:00:00.000Z</DateTo>
                             </DateRangeWithDateType>
                             <RatePrices>
                                <RatePrice Currency="ARS" Type="NMO.HTL.RPT.NET">541.32</RatePrice>
                                <RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">541.32</RatePrice>
                             </RatePrices>
                          </ChargeCondition>
                       </ChargeConditions>
                       <Deadline>
                          <Date>2014-08-12T00:00:00.000Z</Date>
                       </Deadline>
                    </Rate>
                    <SupplierComments>
                      <Comment Sequence="1">From: 2014-08-08 To: 2016-03-31. PARKING:the hotel does not provide.</Comment>
                      <Comment Sequence="2">From: 2014-09-05 To: 2016-03-31. from Apr1,2015 to Mar31,2016 Resort fee included in rate</Comment>
                      <Comment Sequence="3">Resort Fee: 13.0000 (included). per day.</Comment>
                    </SupplierComments>
                    <BookingCreationDT>2013-12-23T13:38:30.000Z</BookingCreationDT>
                 </Hotel>
              </Hotels>
           </Products>
        </Booking>
     </Bookings>
  </Details>

</BookingQueryRS>

Parámetro Obligatorio Descripción
Notifications No
Notification Nodo que informa cuando ocurre algún error o excepción. En el atributo TripNumber se indica el trip al cual se refiere la notificación.
NotificationId Identificador de la notificación. Las mismas serán provistas por Nemo.
NotificationType Tipo de notificación.
NotificationMessage Mensaje de notificación.
Details
Bookings
Booking Detalle de la reserva.
BookingReference Identificador de la reserva en Price Surfer.
BookingState Estado global de la reserva. Tabla de Códigos
Products Productos en la reserva
Hotels Items de la reserva, productos tipo Hoteles
Hotel Detalle del nodo Hotel
BookingComments No Comentarios de la reserva.
Exceptions Si Si PriceSurfer no puede armar el nodo Details se devuelve un nodo Exceptions con las notificaciones correspondientes.


Atención: Para los productos hoteles, si su operador tiene el módulo de CANCELACION AUTOMATICA activado deberá disparar una Consulta de una Reserva inmediatamente luego de la reserva cuando ésta quede en estado Confirmada o Pendiente de Confirmación; de esta forma se creará correctamente la tarea de autocancelación para la reserva.

Nota: Se recomienda disparar una Consulta de una Reserva luego de realizar un booking ya que brinda el estado final en el sistema.