API Reference: Reserva de una Tarifa - Hoteles
De Wiki PriceSurfer
Revisión del 18:32 31 mar 2014 de Heraldo.gerber (discusión | contribuciones)
Ejemplos y descripción
- Solicitud:
<BookingProductsRQ>
<GeneralParameters>
<PreferedLanguage LanguageCode="es"/>
<PreferedCurrency CurrencyCode="ARS"/>
</GeneralParameters>
<Products>
<Hotels>
<Hotel TripProductID="4a862d90-6fb5-42fe-87d0-910100f21d43">
<Rooms>
<Room RoomType="NMO.HTL.RMT.TPL">
<Guests>
<Guest PassengerSequence="1"/>
<Guest PassengerSequence="3"/>
<Guest PassengerSequence="4"/>
</Guests>
</Room>
<Room RoomType="NMO.HTL.RMT.2ST">
<Guests>
<Guest PassengerSequence="2"/>
<Guest PassengerSequence="5"/>
</Guests>
</Room>
</Rooms>
</Hotel>
</Hotels>
<Passengers>
<Passenger AgeType="NMO.GBL.AGT.ADT" Sequence="1">
<PersonNames>
<PersonName NameType="NMO.GBL.PNT.FIR">Priotr</PersonName>
<PersonName NameType="NMO.GBL.PNT.LAS">apellido</PersonName>
</PersonNames>
</Passenger>
<Passenger AgeType="NMO.GBL.AGT.ADT" Sequence="2">
<PersonNames>
<PersonName NameType="NMO.GBL.PNT.FIR">NombreB</PersonName>
<PersonName NameType="NMO.GBL.PNT.LAS">apellido</PersonName>
</PersonNames>
</Passenger>
<Passenger AgeType="NMO.GBL.AGT.ADT" Sequence="3">
<PersonNames>
<PersonName NameType="NMO.GBL.PNT.FIR">NombreC</PersonName>
<PersonName NameType="NMO.GBL.PNT.LAS">apellido</PersonName>
</PersonNames>
</Passenger>
<Passenger AgeType="NMO.GBL.AGT.CHD" Sequence="4">
<PersonNames>
<PersonName NameType="NMO.GBL.PNT.FIR">Ninio</PersonName>
<PersonName NameType="NMO.GBL.PNT.LAS">apellido</PersonName>
</PersonNames>
<BirthDate>2010-05-05</BirthDate>
</Passenger>
<Passenger AgeType="NMO.GBL.AGT.CHD" Sequence="5">
<PersonNames>
<PersonName NameType="NMO.GBL.PNT.FIR">NinioB</PersonName>
<PersonName NameType="NMO.GBL.PNT.LAS">apellido</PersonName>
</PersonNames>
<BirthDate>2008-08-03</BirthDate>
</Passenger>
</Passengers>
</Products>
</BookingProductsRQ>
| Parámetro | Obligatorio | Descripción |
|---|---|---|
| GeneralParameters | Sí | |
| PreferedLanguage | Sí | 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 | Sí | Establece la moneda requerida para la respuesta.
Atributos: CurrencyCode: Código de moneda correspondiente a los códigos de moneda estándar provistos. |
| Hoteles | No | |
| Hotel | Sí | |
| Rate | Sí | Tarifa a reservar, indicando con el atributo TripProductId el id del hotel a reservar. |
| Rooms | No | |
| Room | Sí | |
| Occupancy | Sí | Indica la cantidad de adultos, niños e infantes por cada habitación.
En el nodo Guest se encuentra el identificador del pasajero, atributo PassengerSequence. Este dato se obtiene del Sequence del nodo Passenger. |
| Passengers | Sí | Lista de pasajeros con su respectiva información. Sobre la Información de Pasajeros Requerida al Reservar |
| Passenger | Sí | Información de un pasajero.
Atributos: AgeType: Tipo de pasajero. Tabla de códigos Sequence: Número secuencial comenzando en 1 para el primer pasajero. Este dato será el contrastado contra el valor del atributo PassengerSequence del nodo Guest del Room. |
| PersonNames | No | Nombres del pasajero. |
| PersonName | Sí | Nombre del pasajero.
Atributos: NameType: Tipo de Nombre. Tabla de códigos |
| BirthDate | No | Fecha de Nacimiento. Suele ser obligatoria para pasajeros tipo Child e Infante. |
| Age | No | Edad del pasajero. |
| Identifiers | No | Documentos que identifican al pasajero |
| Identifier | No | Datos de un documentos que identifica al pasajero
Atributos: Type: Tipo de Identificador. Tabla de códigos |
| CountryOfResidence | No | Código de País del País de residencia del pasajero. Ver Resolución 3550 de la AFIP.
Atributos: CountryCode: Código de País. Códigos de país ISO - 2 letras |
| Nationality | No | Código de País de la Nacionalidad del pasajero. Ver Resolución 3550 de la AFIP.
Atributos: CountryCode: Código de País. Códigos de país ISO - 2 letras |
- Respuesta:
<BookingProductsRS>
<Details>
<BookingReference>QN_007GP</BookingReference>
<BookingState>NMO.GBL.BST.CNF</BookingState>
<Products>
<Hotels>
<Hotel HotelCode="2392" SupplierID="BOL" LogID="1">
<BookingReferences>
<BookingReference ReferenceType="NMO.HTL.RPT.MPH">QN_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="???">???</BookingStatusActor>
</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>
<HotelContracts ItemsCount="1">
<HotelContract>
<ContractName>CGW-TODOS</ContractName>
<IncomingOffice>
<IncomingOfficeCode>249</IncomingOfficeCode>
</IncomingOffice>
</HotelContract>
</HotelContracts>
</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-18</CheckIn>
<CheckOut>2014-08-20</CheckOut>
<Rate RateID="d8233eb837e1c0de093df4071da907cf@1" TripProductID="7b776d90-6fb5-42fe-87d0-910100f21d43">
<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>
</Passenger>
</Passengers>
</Occupancy>
<Availability AvailabilityCode="NMO.HTL.AVB.CNF">Confirmación inmediata</Availability>
</Room>
</Rooms>
<Board Code="3">ALOJAMIENTO Y DESAYUNO</Board>
<RatePrices>
<RatePrice Currency="ARS" Type="NMO.HTL.RPT.NET">1082.651622002821</RatePrice>
<RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">1082.651622002821</RatePrice>
</RatePrices>
</Rate>
<BookingCreationDT>2013-12-23T13:38:30.670Z</BookingCreationDT>
</Hotel>
</Hotels>
</Products>
</Details>
</BookingProductsRS>
| 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.
Atributos:
|
| Hotel | Sí | |
| BookingReferences | No | Identificadores de la resera. Tabla de Códigos |
| BookingStatusList | No | Estados del “ítem”. |
| BookingStatus | Sí | |
| BookingStatusDescription | Sí | Descripción del estado actual de la reserva.
BookingStatusCode: Código del estado de la reserva. Tabla de Códigos |
| Hotel | No | Contiene toda la información del hotel. |
| HotelName | Sí | Nombre del hotel. |
| AccomodationType | No | Indica si es hotel, hostel, camping, etc |
| HotelDescriptions | No | |
| HotelDescription | Sí | Descripción del hotel.
Atributos: HotelDescriptionType: Tipo de descripción del Hotel. |
| 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 | Sí | Dirección del hotel |
| AddressLines | Sí | Líneas que componen la dirección del hotel. |
| AddressLine | Sí | Indica la dirección del hotel. |
| Position | No | Coordenadas del hotel: Latitud y Longitud. |
| HotelRating | Sí | 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 | Sí | Valoración de la categoría del hotel expresada en el tipo de categoría indicado en el nodo padre. |
| ImageLinks | Sí | Conjunto de imágenes del hotel |
| ImageLink | No | |
| ImageDescription | Sí | 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 | Sí | URL de la imagen |
| DestinationDetails | Sí | 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 | Sí | Tarifa a reservar, indicando con el atributo TripProductId el id del hotel a reservar. |
| Rooms | No | |
| Room | Sí | |
| Occupancy | Sí | Indica la cantidad de adultos, niños e infantes por cada habitación.
En el nodo Passengers se encuentran los datos de los pasajeros. |
| ImageDescription | Sí | Descripción de la imagen
ImageDisplayType: Tipo de imagen correspondiente a los tipos de imágenes estándar provistos por Nemo. |
| ImageHeight | No | Dimensiones de la imagen: alto |
| ImageWidht | No | Dimensiones de la imagen: Ancho |
| ImageURL | Sí | URL de la imagen |
| ThumbnailURL | No | URL de la imagen miniatura |
| Fares | Sí | Datos de tarifas |
| FareType | No | Tipo de tarifas, ej. Tarifa web, precio de agencia |
| Prices | Sí | Precios, con valor y moneda |
| BookingState | Sí | 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) |
| ProductBookingExtraData | No | Nodo que se utiliza para registrar datos genéricos sobre una reserva. Luego al consultar la misma el sistema responderá con los datos registrados. |
| Exceptions | Sí | 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 |
