API Reference: Consulta de una Reserva - Hoteles
De Wiki PriceSurfer
Revisión del 12:16 1 abr 2014 de Heraldo.gerber (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 | Si | Establece la moneda requerida para la respuesta.
Atributos: CurrencyCode: Código de moneda correspondiente a los códigos de moneda estándar provistos. |
| Bookings | Si | Mediante el nodo Booking se cargan las reservas a consultar. |
| Booking | Sí |
Atributos: - BookingReference: Localizador (Identificador) de la Reserva en Price Surfer |
- Respuesta:
<BookingQueryRS>
<Details>
<Bookings>
<Booking>
<BookingReference>XX_007GP</BookingReference>
<BookingState>NMO.GBL.BST.CNF</BookingState>
<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.65162200282</RatePrice>
<RatePrice Currency="USD" Type="NMO.HTL.RPT.NBC">230.28</RatePrice>
<RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">1082.65162200282</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.3258110014104</RatePrice>
<RatePrice Currency="USD" Type="NMO.HTL.RPT.NBC">115.14</RatePrice>
<RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">541.3258110014104</RatePrice>
</RatePrices>
</ChargeCondition>
</ChargeConditions>
<Deadline>
<Date>2014-08-12T00:00:00.000Z</Date>
</Deadline>
</Rate>
<BookingCreationDT>2013-12-23T13:38:30.000Z</BookingCreationDT>
</Hotel>
</Hotels>
</Products>
</Booking>
</Bookings>
</Details>
</BookingQueryRS>
| Parámetro | Obligatorio | Descripción |
|---|---|---|
| Notifications | No | |
| Notification | Si | 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 | Si | Identificador de la notificación. Las mismas serán provistas por Nemo. |
| NotificationType | Si | Tipo de notificación. |
| NotificationMessage | Si | Mensaje de notificación. |
| Details | Si | |
| Bookings | Si | |
| Booking | Si | Detalle de la reserva. |
| BookingReference | Sí | Identificador de la reserva en Price Surfer. |
| BookingState | Sí | Estado global de la reserva. Tabla de Códigos |
| Hotel | Si | |
| BookingReferences | No | Identificadores de la resera. |
| BookingStatusList | No | Estados del “ítem”. |
| BookingStatus | Si | |
| BookingStatusDescription | Si | Descripción del estado actual de la reserva.
BookingStatusCode: Código del estado de la reserva correspondiente a los códigos estándar de reserva provistos por Nemo. |
| Hotel | No | Contiene toda la información del hotel. |
| HotelName | Si | Nombre del hotel. |
| AccomodationType | No | Indica si es hotel, hostel, camping, etc, los tipos serán provistos por Nemo. |
| HotelDescriptions | No | |
| HotelDescription | Si | Descripción del hotel.
Atributos: HotelDescriptionType: Tipo de descripción correspondiente a los tipos de descripción estándar provistos por Nemo. |
| LocationDetails | No | |
| Location | No | Descripción del área en la que se localiza el hotel.
Atributos: LocationCode: Código de área provisto por el proveedor. |
| Amenities | No | |
| Amenity | No | Código de amenidad admitido.
Atributos: AmenityGroupCode: Tipo de amenidad. Los tipos de amenidad admitidos corresponden a los provistos por Nemo. AmenityCode: Código de amenidad. Los códigos de amenidad admitidos corresponden a los provistos. |
| Address | Si | Dirección del hotel |
| AddressLines | Si | Líneas que componen la dirección del hotel. |
| AddressLine | Si | Indica la dirección del hotel. |
| Position | No | Coordenadas del hotel: Latitud y Longitud. |
| HotelRating | Si | Categoría del hotel.
Atributos: HotelRatingCode: código de la categoría correspondiente a los códigos de categoría estándar provistos por Nemo. HotelRatingType: Tipo de la categoría correspondiente a los tipos de categoría estándar provistos por Nemo. |
| RatingValue | Si | Valoración de la categoría del hotel expresada en el tipo de categoría indicado en el nodo padre. |
| ImageLinks | Si | Conjunto de imágenes del hotel |
| ImageLink | No | |
| ImageDescription | Si | Descripción de la imagen
ImageDisplayType: Tipo de imagen correspondiente a los tipos de imágenes estándar provistos por Nemo. |
| DisplayOrder | No | Orden del la imagen. |
| ImageURL | Si | URL de la imagen |
| DestinationDetails | Si | Atributos:
DestinationType: tipo de destino de los provistos por Nemo. Destination Code: código del destino a buscar, de los provistos por Nemo. |
| CheckIn | No | Fecha de entrada de la estadía. |
| CheckOut | No | Fecha de salida de la estadía |
| Rate | Si | Tarifa a reservar, indicando con el atributo TripProductId el id del hotel a reservar. |
| Rooms | No | |
| Room | Si | |
| Occupancy | Si | Indica la cantidad de adultos, niños e infantes por cada habitación.
En el nodo Passengers se encuentran los datos de los pasajeros. |
| BookingReferences | No | Identificadores de la reserva |
| BookingState | Si | Estado de la reserva (del ítem). La codificación de los estados será provista por Nemo.
Atributos: Code: Código del estado (confirmada, rechazada, etc) |
| Exceptions | Si | Si no se puede armar el nodo Details se arma un nodo Exceptions con las notificaciones correspondientes. |
| ChargeConditions | No | Detalle de los Gastos de Cancelación |
| ChargeCondition | Sí | Detalle de un Gasto de Cancelación |
| ChargeDescription | Sí | Descripción del Tipo de Gasto de Cancelación
Atributos: ChargeType: Tipo de gasto. Tabla de Códigos |
| Período de aplicación: | ||
| (1) DateRangeWithDateType | No | Indica que el gasto de cancelación tiene un rango en base a fechas. |
| DateFrom | Sí | Fecha a partir de la cual se cobra el Gasto de Cancelación |
| DateTo | Sí | Fechas hasta la que se cobra el Gasto de Cancelación |
| ó | ||
| (2) DateRangeWithDays | No | Indica que el gasto de cancelación tiene un rango en base a días: Rango de días antes de la fecha de Check-In en los que se aplica el Gasto de Cancelación |
| DateFrom | Sí | Cantidad de días antes del Check-In a partir de la cual se cobra el Gasto de Cancelación |
| DateTo | No | Cantidad de días antes del Check-In hasta que se cobra el Gasto de Cancelación |
| RatePrices | Sí | Montos del Gasto de Cancelación |
| RatePrice | Sí | Monto del Gasto de Cancelación |
