Schemas and Models
Modelos de datos del flujo de reserva
Sección titulada «Modelos de datos del flujo de reserva»Address
Sección titulada «Address»| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| city | Yes | string | Ciudad |
| country | Yes | string | País |
| countryCode | Yes | string | Código de país |
| state | Yes | string | Estado |
| postalCode | No | string | Código postal |
| street | No | string | Calle |
Attribute
Sección titulada «Attribute»| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| name | Yes | string | Nombre del atributo |
| value | Yes | string | Valor del atributo |
Booking
Sección titulada «Booking»| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| id | Yes | int | ID de la reserva |
| status | Yes | Status | Estado de la reserva |
| hotels | Yes | [Hotel] | Hoteles en la reserva |
| amount | Yes | decimal | Monto total |
| taxes | Yes | decimal | Impuestos de la reserva |
| client | Yes | Client | Titular |
| cancellationPolicies | Yes | [CancellationPolicy] | Políticas de penalización |
| currency | Yes | string | Moneda de la reserva |
BookingRequest
Sección titulada «BookingRequest»| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| bookingKey | Yes | string | De booking hold |
| clientReference | Yes | string | Referencia del partner. No permite localizar una reserva mediante la API. |
| roomCriteria | No | [RoomCriteria] | Info de pax |
| client | Yes | Client | Titular de la reserva |
| payment | No | Payment | Info de pago — Deprecated: no la envíes |
| commentsForHotel | No | string | Requisitos especiales |
En una muestra en la que se había enviado client en BookingHold, se aceptó una petición de BookingNew sin client (HTTP 200). Ver Guest data in the hold.
CancellationPolicy
Sección titulada «CancellationPolicy»| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| startDate | Yes | datetime | UTC. Cuándo comienza la penalización |
| endDate | Yes | datetime | Deprecated — no dependas de este campo |
| amount | Yes | decimal | Monto de la penalización |
| currency | Yes | string | Moneda |
| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| name | Yes | string (A-Z, a-z, 0-9) | Nombre |
| surname | Yes | string (A-Z, a-z, 0-9) | Apellido |
| contactData | Yes | [ContactData] | Info de contacto |
ContactData
Sección titulada «ContactData»| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| No | string | ||
| phone | No | Phone | Objeto Phone |
Confirmation
Sección titulada «Confirmation»| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| bookingId | Yes | int | ID de la reserva |
| clientReference | Yes | string | Referencia del partner. No permite localizar una reserva mediante la API. |
| status | Yes | Status | Estado de la reserva |
| amount | Yes | decimal | Monto final |
| cancellationPolicies | Yes | [CancellationPolicy] | Políticas de penalización |
| oldAmount | No | decimal | Monto original antes de cualquier cambio de tarifa |
Currency
Sección titulada «Currency»| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| id | Yes | string | ID de la moneda |
| name | Yes | string | Nombre de la moneda |
| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| code | Yes | string | Código de error |
| type | Yes | string | Categoría del error |
| message | Yes | string | Descripción |
| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| type | Yes | FeeType | Tipo de cargo |
| amount | Yes | decimal | Valor del cargo |
| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| total | Yes | decimal | Cargos totales |
| details | Yes | [Fee] | Desglose por cargo |
| currency | Yes | string | Moneda de los cargos |
| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| id | Yes | int | ID del hotel |
| name | No | string | Nombre |
| rooms | No | [Room] | Habitaciones |
HotelRateCriteria
Sección titulada «HotelRateCriteria»| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| checkIn | Yes | string | Fecha de llegada |
| checkOut | Yes | string | Fecha de salida |
| roomCriteria | Yes | [RoomCriteria] | Habitaciones solicitadas |
| hotelIds | Yes | [int] | Hasta 50 |
| hotelRateFilter | No | HotelRateFilter | Filtros de tarifa |
| market | No | string | Código de país ISO |
HotelRateFilter
Sección titulada «HotelRateFilter»| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| nonRefundable | No | bool | Filtro de tarifas. Observado sin efecto en una muestra de Integration — ver HotelRates. Default false |
| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| age | Yes | int | <17 = menor |
| name | No | string | Nombre del huésped |
| surname | No | string | Apellido del huésped |
En una respuesta de BookingGet en la que se habían enviado nombres de huéspedes en HotelRates, esos nombres no se reflejaron; primaryGuest contenía el nombre del titular de la reserva tomado de client. No esperes que BookingGet devuelva los nombres de huéspedes enviados en HotelRates. En una respuesta de BookingGet en la que se había enviado roomCriteria en BookingHold, el primaryGuest de cada habitación fue el primer huésped de esa habitación y los nombres de los demás huéspedes no aparecieron. Ver Guest data in the hold.
Payment
Sección titulada «Payment»| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| type | Yes | PaymentType | Tipo de pago |
| card | Yes | PaymentCard | Info de la tarjeta |
PaymentCard
Sección titulada «PaymentCard»| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| type | Yes | PaymentCardType | VI / MC / AE |
| holderName | Yes | string | Nombre del titular de la tarjeta |
| number | Yes | string | Número de la tarjeta |
| expirationMonth | Yes | int | MM |
| expirationYear | Yes | int | YYYY |
| cvc | Yes | string | Código de seguridad |
| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| countryCode | Yes | string | Código de país |
| number | Yes | string | Número de teléfono |
| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| rateKey | Yes | string | ID de la tarifa cotizada |
| clientCurrency | Yes | string | Moneda de visualización |
| cancellationPolicies | Yes | [CancellationPolicy] | Penalizaciones |
| reservationPolicies | Yes | [ReservationPolicy] | Condiciones de la reserva |
| amount | Yes | decimal | Monto neto de la tarifa |
| publicAmount | Yes | decimal | Precio de venta recomendado |
| taxes | Yes | Taxes | Objeto Taxes |
| feesNotIncluded | No | Fees | Cargos pagados en el hotel |
ReservationPolicy
Sección titulada «ReservationPolicy»| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| type | Yes | PolicyType | Tipo de política |
| description | Yes | string | Detalles |
| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| id | Yes | int | ID de la habitación |
| name | No | string | Nombre de la habitación |
| rates | No | [Rate] | Tarifas disponibles |
RoomCriteria
Sección titulada «RoomCriteria»| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| paxes | Yes | [Pax] | Ocupantes |
| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| type | Yes | TaxType | Tipo de impuesto |
| amount | Yes | decimal | Monto |
| Propiedad | Requerido | Tipo | Descripción |
|---|---|---|---|
| total | Yes | decimal | Impuestos totales |
| details | Yes | [Tax] | Desglose por impuesto |
| Valor | Descripción |
|---|---|
| CREATED | La reserva está registrada, pero no está CONFIRMED. No la trates como una reserva confirmada. |
| CONFIRMED | PT aceptó la reserva y responde por ella ante el partner. |
| CANCELLED | Creada y cancelada |
ErrorType
Sección titulada «ErrorType»| Valor | Descripción |
|---|---|
| SYSTEM | Error de sistema |
| VALIDATION | Error de validación |
| APPLICATION | Error de aplicación |
| SECURITY | Error de seguridad |
FeeType
Sección titulada «FeeType»| Valor | Descripción |
|---|---|
| RESORT | Cargo de resort cobrado por el hotel |
PaymentCardType
Sección titulada «PaymentCardType»| Valor | Descripción |
|---|---|
| VI | Visa |
| MC | Master Card |
| AE | American Express |
PaymentType
Sección titulada «PaymentType»| Valor | Descripción |
|---|---|
| VC | Tarjeta de crédito virtual |
PolicyType
Sección titulada «PolicyType»| Valor | Descripción |
|---|---|
| RESERVATION | Condiciones de la reserva |
| MEAL_PLAN | Plan de alimentos incluido |
TaxType
Sección titulada «TaxType»| Valor | Descripción |
|---|---|
| MANDATORY | Impuestos obligatorios |
| HOSPITALITY | Impuestos de hospitalidad |
| OTHERS | Impuestos sin tipo |

