API Reference: Consulta de una Reserva - Hoteles
De Wiki PriceSurfer
Revisión del 13:50 15 sep 2020 de Diego.alcantara (discusión | contribuciones)
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 | Sí |
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 | Sí | 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 | Sí | Identificador de la notificación. Las mismas serán provistas por Nemo. |
| NotificationType | Sí | Tipo de notificación. |
| NotificationMessage | Sí | Mensaje de notificación. |
| Details | Sí | |
| Bookings | Sí | |
| Booking | Sí | Detalle de la reserva. |
| BookingReference | Sí | Identificador de la reserva en Price Surfer. |
| BookingState | Sí | Estado global de la reserva. Tabla de Códigos |
| Products | Sí | Productos en la reserva |
| Hotels | Sí | Items de la reserva, productos tipo Hoteles |
| Hotel | Sí | 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. |
