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

De Wiki PriceSurfer
Ir a la navegaciónIr a la búsqueda
Línea 11: Línea 11:
 
     <Booking BookingReference="XX_007GP"/>
 
     <Booking BookingReference="XX_007GP"/>
 
   </Bookings>
 
   </Bookings>
−
</BookingQueryRQ></code>
+
</BookingQueryRQ>
 +
</code>
  
  
Línea 39: Línea 40:
  
 
-        BookingReference: Localizador (Identificador) de la Reserva en Price Surfer
 
-        BookingReference: Localizador (Identificador) de la Reserva en Price Surfer
−
Atributos:
 
−
 
−
BookingReference: identificador de la reserva a consultar.
 
 
|}
 
|}
  
Línea 191: Línea 189:
 
                                       </PersonNames>
 
                                       </PersonNames>
 
                                       <Age>30</Age>
 
                                       <Age>30</Age>
−
                                      <Identifiers>
 
−
                                          <Identifier Type="NMO.HTL.RPT.DNI" xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
 
−
                                      </Identifiers>
 
 
                                     </Passenger>
 
                                     </Passenger>
 
                                 </Passengers>
 
                                 </Passengers>
Línea 253: Línea 248:
 
|-
 
|-
 
| Booking || Si || Detalle de la reserva.
 
| Booking || Si || Detalle de la reserva.
−
 
−
Atributos:
 
−
 
−
* BookingReference: identificador de la reserva.
 
−
* BookingState: estado de la reserva
 
 
|-
 
|-
−
| ReceivedFrom || Si || Nombre de la persona que firma los cambios de la reserva.
+
| BookingReference || Sí || Identificador de la reserva en Price Surfer.
 
|-
 
|-
−
| BookingState || No || Estado de la reserva (del ítem). La codificación de los estados será provista por Nemo.
+
| BookingState || Sí || Estado global de la reserva. [[API Reference: Estados de la Reserva|Tabla de Códigos]]
 
|-
 
|-
 
| Hotel || Si ||  
 
| Hotel || Si ||  
Línea 355: Línea 345:
 
| Occupancy || Si || Indica la cantidad de adultos, niños e infantes por cada habitación.
 
| 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.
 
En el nodo Passengers se encuentran los datos de los pasajeros.
−
|-
 
−
| Fares || Si || Datos de tarifas
 
−
|-
 
−
| FareType || No || Tipo de tarifas, ej. Tarifa web, precio de agencia
 
−
|-
 
−
| Prices || Si || Precios, con valor y moneda
 
 
|-
 
|-
 
| BookingReferences || No || Identificadores de la reserva
 
| BookingReferences || No || Identificadores de la reserva
Línea 372: Línea 356:
 
| Exceptions || Si || Si no se puede armar el nodo Details se arma un nodo Exceptions con las notificaciones correspondientes.
 
| Exceptions || Si || Si no se puede armar el nodo Details se arma un nodo Exceptions con las notificaciones correspondientes.
 
|-
 
|-
−
| ChargeConditions || Si || Nodo de gastos de cancelación
+
| ChargeConditions || No || Detalle de los Gastos de Cancelación
 
|-
 
|-
−
| ChargeCondition || Si || Gasto de Cancelación
+
| ChargeCondition || Sí || Detalle de un Gasto de Cancelación
 +
|-
 +
| ChargeDescription || Sí || Descripción del Tipo de Gasto de Cancelación
 +
Atributos:
  
−
Atributo:  
+
ChargeType: Tipo de gasto. [[API Reference: Tipos de Gastos de Cancelación|Tabla de Códigos]]
−
 
+
|-
−
ChargeType, tipo de cargo (Ej. NMO.HTL.CHT.CAN cancelación, NMO.HTL.CHT.AMD Modificación)
+
!Período de aplicación:
 +
|-
 +
| (1) DateRangeWithDateType || No || Indica que el gasto de cancelación tiene un rango en base a fechas.
 
|-
 
|-
−
| ChargeDescription || Si || Descripción del gastos de cancelación
+
| DateFrom || Sí || Fecha a partir de la cual se cobra el Gasto de Cancelación
 
|-
 
|-
−
| DateRangeWithDays || No || Indica que el gasto de cancelación tiene un rango en base a días.
+
| DateTo || Sí || Fechas hasta la que se cobra el Gasto de Cancelación
 
|-
 
|-
−
| DateFrom || Si || Fecha desde
+
!ó
 
|-
 
|-
−
| DateTo || Si || Fecha hasta
+
| (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
 
|-
 
|-
−
| DateRangeWithDateType || No || Indica que el gasto de cancelación tiene un rango en base a fechas.
+
| DateFrom || Sí || Cantidad de días antes del Check-In a partir de la cual se cobra el Gasto de Cancelación
 
|-
 
|-
−
| DateFrom || Si || Fecha desde
+
| DateTo || No || Cantidad de días antes del Check-In hasta que se cobra el Gasto de Cancelación
 
|-
 
|-
−
| DateTo || Si || Fecha hasta
+
!
 
|-
 
|-
−
| RatePrices || Si ||  
+
| RatePrices || Sí || Montos del Gasto de Cancelación
 
|-
 
|-
−
| RatePrice || Si || Indica el importe del concepto de cancelación
+
| RatePrice || Sí || Monto del Gasto de Cancelación
−
 
 
−
Atributos:
 
−
 
 
−
RatePriceType, tipo de precio
 
 
|}
 
|}

Revisión del 12:16 1 abr 2014

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