Diferencia entre revisiones de «API Reference: Consulta de Gastos de Cancelación de una Reserva - Hotel»

De Wiki PriceSurfer
Ir a la navegaciónIr a la búsqueda
 
(No se muestran 11 ediciones intermedias de 2 usuarios)
Línea 9: Línea 9:
 
   <Bookings>
 
   <Bookings>
 
     <Booking>
 
     <Booking>
−
       <BookingReference>XX_007GP-1</BookingReference>
+
       <BookingReference>XX_007GP</BookingReference>
 
     </Booking>
 
     </Booking>
 
   </Bookings>
 
   </Bookings>
Línea 28: Línea 28:
 
LanguageCode: Código de lenguaje correspondiente a los códigos de lenguaje estándar provistos por Nemo.
 
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.
+
| PreferedCurrency || No || Establece la moneda requerida para la respuesta.
  
 
Atributos:
 
Atributos:
  
 
- CurrencyCode: Código de moneda correspondiente a los códigos de moneda estándar provistos.
 
- 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 || Sí ||  
 
| Bookings || Sí ||  
Línea 53: Línea 56:
 
             <Hotel HotelCode="2392" SupplierID="BOL">
 
             <Hotel HotelCode="2392" SupplierID="BOL">
 
               <BookingReferences>
 
               <BookingReferences>
−
                 <BookingReference ReferenceType="NMO.HTL.RPT.MPH">QN_007GP-1</BookingReference>
+
                 <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.PS1">249</BookingReference>
 
                 <BookingReference ReferenceType="NMO.HTL.RPT.PRS.PS2">278094</BookingReference>
 
                 <BookingReference ReferenceType="NMO.HTL.RPT.PRS.PS2">278094</BookingReference>
Línea 219: Línea 222:
 
                 </Deadline>
 
                 </Deadline>
 
               </Rate>
 
               </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>
 
             </Hotel>
 
             </Hotel>
 
           </Hotels>
 
           </Hotels>
Línea 246: Línea 254:
 
| Details || Sí ||
 
| Details || Sí ||
 
|-
 
|-
−
| Hotel || No || Contiene toda la información del hotel.
+
| Bookings || Sí ||  
−
|-
 
−
| HotelName || Sí || Nombre del hotel.
 
−
|-
 
−
| AccomodationType || No || Indica si es hotel, hostel, camping, etc, los tipos serán provistos por Nemo.
 
−
|-
 
−
| HotelDescriptions || No ||
 
−
|-
 
−
| HotelDescription || Sí || 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 || 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 Guest se encuentra el identificador del pasajero, atributo PassengerSequence. Este dato se obtiene del Sequence del nodo Passenger.
 
−
|-
 
−
| Passenger || No || Datos de los pasajeros.
 
−
 
 
−
Atributos:
 
−
 
 
−
AgeType: tipo de pasajero (chl, inf, adt).
 
−
 
 
−
Sequence: Este dato será asociado al PassengerSequence del nodo Guest en hoteles.
 
 
|-
 
|-
−
| Exceptions || Sí || Si no se puede armar el nodo Details se arma un nodo Exceptions con las notificaciones correspondientes.
+
| Booking || Sí || Detalle de la reserva.
 
|-
 
|-
−
| ChargeConditions || Sí || Nodo de gastos de cancelación
+
| BookingReference || Sí || Identificador de la reserva en Price Surfer.
 
|-
 
|-
−
| ChargeCondition || Sí || Gasto de Cancelación
+
| BookingState || Sí || Estado global de la reserva. [[API Reference: Estados de la Reserva|Tabla de Códigos]]
−
 
 
−
Atributo:  
 
−
 
 
−
- ChargeType, tipo de cargo (Ej. NMO.HTL.CHT.CAN cancelación, NMO.HTL.CHT.AMD Modificación)
 
 
|-
 
|-
−
| ChargeDescription || Sí || Descripción del gastos de cancelación
+
| Products || Sí || Productos en la reserva
 
|-
 
|-
−
| DateRangeWithDays || No || Indica que el gasto de cancelación tiene un rango en base a días.
+
| Hotels || Sí || Items de la reserva, productos tipo Hoteles
 
|-
 
|-
−
| DateFrom || Sí || Fecha desde
+
| Hotel || Sí || [[API Reference: Hoteles - Nodos tipo BookingProductHotels.Hotel|Detalle del nodo Hotel]]
 
|-
 
|-
−
| DateTo || Sí || Fecha hasta
+
!
 
|-
 
|-
−
| DateRangeWithDateType || No || Indica que el gasto de cancelación tiene un rango en base a fechas.
+
| Exceptions || Si || Si PriceSurfer no puede armar el nodo Details se devuelve un nodo Exceptions con las notificaciones correspondientes.
−
|-
 
−
| DateFrom || Sí || Fecha desde
 
−
|-
 
−
| DateTo || Sí || Fecha hasta
 
−
|-
 
−
| RatePrices || Sí ||
 
−
|-
 
−
| RatePrice || Sí || Indica el importe del concepto de cancelación
 
−
 
 
−
Atributos:
 
−
 
 
−
- RatePriceType, tipo de precio
 
 
|}
 
|}

Revisión actual del 16:17 6 sep 2018

Consulta de Gastos de Cancelación de una Reserva - Hotel

<CancellationFeesQueryRQ> 

 <GeneralParameters>
   <PreferedLanguage LanguageCode="es"/>
   <PreferedCurrency CurrencyCode="USD"/>
 </GeneralParameters>
 <Bookings>
   <Booking>
     <BookingReference>XX_007GP</BookingReference>
   </Booking>
 </Bookings>

</CancellationFeesQueryRQ>


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 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 Sí
Booking Sí
BookingReference Sí Referencia (localizador) de PriceSurfer para la reserva.


      • Respuesta:

<?xml version="1.0" encoding="UTF-8"?> <CancellationFeesQueryRS> 

 <Details>
   <Bookings>
     <Booking>
       <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"/>
                 <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>
                         <Identifiers>
                           <Identifier xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Type="NMO.HTL.RPT.DNI" xsi:nil="true"/>
                         </Identifiers>
                       </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="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="ARS" Type="NMO.GBL.RPT.GRS">541.3258110014104</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>
           </Hotel>
         </Hotels>
       </Products>
     </Booking>
   </Bookings>
 </Details>

</CancellationFeesQueryRS>


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
Exceptions Si Si PriceSurfer no puede armar el nodo Details se devuelve un nodo Exceptions con las notificaciones correspondientes.
Obtenido de «https://wiki.psurfer.net/index.php?title=API_Reference:_Consulta_de_Gastos_de_Cancelación_de_una_Reserva_-_Hotel&oldid=284391»