Diferencia entre revisiones de «API Reference: Reserva de una Tarifa - Hoteles»

De Wiki PriceSurfer
Ir a la navegaciónIr a la búsqueda
Línea 376: Línea 376:
 
Atributos:
 
Atributos:
  
−
HotelRatingCode: código de la categoría correspondiente a los códigos de categoría estándar provistos por Nemo.
+
HotelRatingCode: código de la categoría. [[API Reference: Códigos de Estrellas|Tabla de Códigos]]
  
−
HotelRatingType: Tipo de la categoría correspondiente a los tipos de categoría estándar provistos por Nemo.
+
HotelRatingType: Tipo de la categoría. [[API Reference: Tipos de Estrellas|Tabla de Códigos]]
 
|-
 
|-
 
| RatingValue || Sí || Valoración de la categoría del hotel expresada en el tipo de categoría indicado en el nodo padre.
 
| RatingValue || Sí || Valoración de la categoría del hotel expresada en el tipo de categoría indicado en el nodo padre.
Línea 396: Línea 396:
 
| DestinationDetails || Sí || Atributos:  
 
| DestinationDetails || Sí || Atributos:  
  
−
DestinationType: tipo de destino de los provistos por Nemo.
+
DestinationType: Tipo de destino. [[API Reference: Tipos de Destinos|Tabla de Códigos]]
  
−
Destination Code: código del destino a buscar, de los provistos por Nemo.
+
Destination Code: Código del destino a buscar.
 
|-
 
|-
 
| CheckIn || No || Fecha de entrada de la estadía.
 
| CheckIn || No || Fecha de entrada de la estadía.

Revisión del 12:36 1 abr 2014

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 Sí* 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:

  • BookingReference: identificador de la reserva en PriceSurfer.
  • BookingState: estado de la reserva. Tabla de Códigos
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. Tabla de Códigos

HotelRatingType: Tipo de la categoría. Tabla de Códigos

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. Tabla de Códigos

Destination Code: Código del destino a buscar.

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
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
Obtenido de «https://wiki.psurfer.net/index.php?title=API_Reference:_Reserva_de_una_Tarifa_-_Hoteles&oldid=1810»