Registro de cambios

Recibos de reservas: Manage Booking | Feature | V3

Ahora los colaboradores pueden utilizar un enlace desde la respuesta de recuperación de itinerario para recuperar un recibo de reserva desde un nuevo punto final en Rapid API. Consulta Recibos de reserva para obtener más detalles.

Ejemplo de solicitud de recibo de respuesta en Rapid 3:

curl -X GET "https://test.ean.com/v3/itineraries/8999989898988/invoice\
?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"\
 -H "accept: application/pdf"\
 -H "customer-ip: 1.2.3.4"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Ejemplo de respuesta en Rapid 3:

La respuesta será una representación en PDF de un recibo de la transacción que puede compartirse con el viajero.

Ventaja:

Los colaboradores disponen ahora de una API fácil de usar que proporciona recibos de reserva a los clientes de viajes corporativos que necesitan informar de los gastos de viaje a sus empresas.

Nuevas opciones de búsqueda y filtrado: Content | Feature | V3

Hemos añadido nuevos parámetros de solicitud para poder limitar los resultados de la búsqueda por el campo siguiente:

• trip_reason

Además, hemos añadido un parámetro de filtro a la solicitud que te permitirá eliminar los comentarios que no estén en el idioma solicitado.

Ejemplo de solicitud de Rapid 3: En este ejemplo utilizamos el nuevo parámetro de filter con el valor de language y el nuevo parámetro de búsqueda trip_reason con valores de business y business_and_leisure

curl -X GET "https://test.ean.com/v3/properties/12345/guest-reviews\
?language=en-US\
&filter=language\
&trip_reason=business\
&trip_reason=business_and_leisure" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1719329586"\
 -H "user-agent: TravelNow/3.30.112"

Ejemplo de respuesta de Rapid 3: En esta respuesta podemos ver que están presentes los nuevos campos stay_date y management_responses, y solo se devuelven los comentarios con los valores trip_reason de business y business_and_leisure.

{
    "verified": {
        "recent": [
            {
                ...
                "stay_date": "2019-02",
                "trip_reason": "business",
                ...
            },
            {
                ...
                "stay_date": "2019-01",
                "trip_reason": "business_and_leisure",
                ...
                "management_responses": [
                    {
                        "text": "Dear Guest, Thank you for your feedback. I hope we have the opportunity to welcome you back in the near future. Best regards, Kara (General Manager)",
                        "date": "2019-02-11T14:36:54Z"
                    }
                ]
            }
        ]
    }
}

Ventaja:

Los campos adicionales que se devuelven en la respuesta deben proporcionar más contexto y aumentar el valor de esos comentarios. Los colaboradores que quieran limitar las búsquedas de comentarios de huéspedes ahora pueden limitar los comentarios a un solo idioma y a los motivos de viaje que les aportan más valor.

Programa de fidelidad - Book | Shop | Feature | V3

Vamos a añadir nuevas funciones que te permitirán localizar más fácilmente tarifas corporativas que sirvan para ganar puntos de fidelidad del hotel. Consulta más información sobre nuestros puntos de fidelidad del hotel.

Ventaja:

Los colaboradores dispondrán de mejores herramientas para ayudar a sus viajeros de negocios a ganar puntos en los programas de fidelidad de los alojamientos.

Incentivos de tarifas de marketing: Shop | Feature | V3

Se ha añadido un nuevo valor a la solicitud de compra para el parámetro include, que hará que se devuelva el objeto marketing_fee_incentives en la respuesta.

Ejemplo de solicitud en Rapid 3:

curl -X GET "https://test.ean.com/v3/properties/availability\
?checkin=2024-01-01\
&checkout=2024-01-03\
&currency=USD\
&country_code=US\
&language=en-US\
&occupancy=2\
&property_id=19248\
&rate_plan_count=1\
&sales_channel=website\
&sales_environment=hotel_only\
&include=rooms.rates.marketing_fee_incentives\
&travel_purpose=leisure" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Ejemplo de respuesta en Rapid 3:

[
  {
    "property_id": "19248",
    "status": "available",
    "rooms": [
      {
        "id": "123abc",
        "room_name": "Fancy Queen Room",
        "rates": [
          {
            "id": "333abc",
            "status": "available",
            ...
            "marketing_fee_incentives": [
              {
                "source": "property",
                "start": "2024-01-01",
                "end": "2024-01-01"
              }
            ],
            ...
          }
        ]
      }
    ],
    "links": { ... },
    "score": 10052
  }
]

Ventaja:

Los colaboradores podrán identificar más fácilmente las tarifas a las que se aplican incentivos especiales.

Nuevas opciones de búsqueda y filtrado: Content | Feature | V3

Hemos añadido nuevos parámetros de solicitud para poder limitar los resultados de la búsqueda por los campos siguientes:

• all_inclusive
• amenity_id
• attribute_id
• category_id
• spoken_language_id

Además, hemos añadido la posibilidad de especificar con una granularidad mucho mayor las partes de la respuesta que quieres que se incluyan, al aumentar la cantidad de valores válidos para el parámetro include. Los nuevos valores incluyen todos los elementos de nivel superior de la respuesta de contenido. Consulta Búsqueda y filtrado para obtener más información.

Ejemplo de solicitud de Rapid 3: En este ejemplo utilizamos el nuevo parámetro de búsqueda amenity_id y los nuevos valores de name y amenities en el parámetro include.

curl -X GET "https://test.ean.com/v3/properties/content\
?language=en-US\
&supply_source=expedia\
&amenity_id=115\
&include=name\
&include=amenities\
&property_id=1337\
&property_id=1" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Ejemplo de respuesta de Rapid 3: En esta respuesta, podemos ver que solo se devuelve como resultado el alojamiento 1337, ya que el alojamiento 1 no tiene disponible el identificador de servicio 115. También podemos ver que property_id, name y amenities están incluidos en la respuesta. property_id siempre se incluye en la respuesta, y no es necesario especificarlo como parámetro de la solicitud include a menos que sea el único campo que se quieras incluir en la respuesta.

{
  "1337": {
    "property_id": "1337",
    "name": "Hyatt Regency Paris Etoile",
    "amenities": {
      "8": {
        "id": "8",
        "name": "Elevator"
      },
      "43": {
        "id": "43",
        "name": "Concierge services"
      },
      "115": {
        "id": "115",
        "name": "Bicycle rentals nearby"
      },
      "361": {
        "id": "361",
        "name": "Breakfast available (surcharge)"
      },
      ...
    }
  }
}

Ventaja:

Los colaboradores que buscan alojamientos y campos de respuesta más específicos ahora pueden optimizar sus interacciones con la API de contenido de Rapid. Al especificar qué contenido se necesita, también comunican a los equipos de Rapid qué contenido se utiliza y, por tanto, es valioso para ellos.

Situación de venta de promoción para dispositivos móviles: Shop | Feature | V3

Se ha añadido el valor sale_scenario.mobile_promotion a los parámetros include para la disponibilidad y la tienda en las solicitudes de cambio.

Se ha añadido el campo room.rate.sale_scenario.mobile_promotion a la disponibilidad, las tarifas adicionales y la tienda para las respuestas de cambio.

Ejemplo de solicitud en Rapid 3:

curl -X GET "https://test.ean.com/v3/properties/availability\
?checkin=2024-01-01\
&checkout=2024-01-03\
&currency=USD\
&country_code=US\
&language=en-US\
&occupancy=2\
&property_id=19248\
&rate_plan_count=1\
&sales_channel=mobile_app\
&sales_environment=hotel_only\
&include=sale_scenario.mobile_promotion\
&travel_purpose=leisure" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Ejemplo de respuesta en Rapid 3:

[
  {
    "property_id": "19248",
    "status": "available",
    "rooms": [
      {
        "id": "123abc",
        "room_name": "Fancy Queen Room",
        "rates": [
          {
            "id": "333abc",
            "status": "available",
            ...
            "sale_scenario": {
              "package": false,
              "member": false,
              "corporate": false,
              "distribution": false,
              "mobile_promotion": false
            },
            ...
          }
        ]
      }
    ],
    "links": { ... },
    "score": 10052
  }
]

Ventaja:

Los colaboradores que deseen identificar con mayor facilidad las tarifas que tienen asociado un acuerdo de promoción para dispositivos móviles dispondrán de un nuevo método para conseguirlo.

Nuevo tipo de región de estación de autobuses: Geography | Feature | V3

Se ha añadido el tipo de región bus_station a la solicitud de puntos de conexión de Regiones. A partir de ahora, Región y Regiones proporcionarán datos sobre regiones con el tipo bus_station.

Ejemplo de solicitud en Rapid 3:

curl -X GET "https://test.ean.com/v3/regions\
?include=standard\
&language=en-US\
&supply_source=expedia\
&type=bus_station" \
 -H "Accept: application/json" \
 -H "Authorization: EAN apikey=1234,signature=14140287ea6ea1396b18b,timestamp=1697826383" \
 -H "Accept: application/json" \
 -H "Accept-Encoding: gzip" \
 -H "User-Agent: TravelNow/3.30.112"

Ejemplo de respuesta en Rapid 3:

[
  {
    "id": "11234754",
    "type": "bus_station",
    "name": "Port Authority Bus Terminal",
    "name_full": "Port Authority Bus Terminal",
    "country_code": "US"
  }
]

Ventaja:

Los colaboradores pueden incluir información sobre estaciones de autobuses en su sitio para los viajeros.

Nombre del IPM del alquiler vacacional en el contenido: Content | Feature | V3

Se ha añadido el campo vacation_rental_details.ipm_name a la respuesta del contenido del alojamiento.

Ejemplo de respuesta en Rapid 3:

{
  "4687248": {
    "property_id": "4687248",
    "name": "Beautiful 6 Bedroom Home With Two Pools, Only 10 minutes To Theme Park!",
    "address": { ... },
    ...
    "fees": {
      "traveler_service": "Your credit card statement will show two separate charges, one for the booking amount and property fees and another for the service fee. Both will be charged by Expedia partner Good Company.. The traveler service fee is refundable only when your entire booking is fully refundable. Please refer to the terms and conditions for the rules applicable to the booking facilitation services provided."
    },
    "attributes": { ... },
    ...
    "vacation_rental_details": {
      "private_host": true,
      ...
      "vrbo_srp_id": "334.3634257.3458973",
      "listing_id": "1252577",
      "listing_number": "3834275",
      "listing_source": "VRBO",
      "listing_unit": "/units/0001/429ecad2-bade-429a-a427-8adee57420ec",
      "ipm_name": "Good Company",
      "unit_configurations": { ... },
      "enhanced_house_rules": { ... },
      "free_text": "Stunning brand new 2-story home with 6 bedrooms, 4 bathrooms, brand new appliances/furniture, game room, grill, patio, and beautiful scenery all around. Minutes from Super Cool Lake. This place is the perfect getaway for a larger group whether it be a golf trip, lake trip, or time to gather with the family. Please note this property has two parking stalls, in addition to first come first serve overflow parking in the community. Celebrating something special? Birthday, Anniversary, Bachelor/Bachelorette, etc? We also offer decorating services for an extra fee. Please inquire within! This home features a fully-equipped kitchen for preparing meals, onsite washer and dryer and most importantly a private space, much larger than a hotel room for private family time away from crowds and people. We have a self-check-in and check-out system to limit your contact with people as well. THE BASICS: 6 bedrooms & 1 loft - 5 Kings, 2 Bunk beds , and 1 pull-out couch in the loft - Sleeps 16 people. 4 Bathrooms - Master (jetted tub, walk-in shower, double sinks), other 3 bathrooms (tub/shower combo & sink). Fully Equipped Kitchen. Open Main Room with plenty of seating. Dining Room table and bar stools around kitchen island area. Plenty of space to spread out and enjoy your friends/family. Free Wifi. THE EXPERIENCE IN DETAIL: -As you walk in the front door and are greeted by the open floor layout of our kitchen and great room you immediately breathe easy seeing that there is plenty of room here for you and your family. Our Kitchen is stocked with plenty of cookware and dishes so you can create a huge breakfast that will get everyone out of bed and ready for a day of fun. A potted coffee maker and a Keurig is available. You will need to bring your own coffee/pods/filters/creamer etc. Cozy up in the living room for a late night movie on our large flat-screen TV equipped for your viewing pleasure. Our luxury Master bedroom with it’s King size bed, premium bedding, and TV invite you and your spouse to relax together and feel a little spoiled. This is a vacation after all! Enjoy our Master Bath with it’s jetted tub, walk-in shower, and double sinks. Explore the Upstairs which has 4 Bedrooms - 3 furnished with a King size bed, premium bedding, 1 is the bunk room which is equipped with 4 twin size beds. This home is not handicapped accessible!!!"
    },
    "supply_source": "Vrbo",
    "spoken_languages": { ... }
  }
}

Ventaja:

Los colaboradores que venden productos de Vrbo deben indicar el nombre del IPM para poder crear mensajes para los huéspedes en los que se les informe sobre el nombre del IPM que realizará el cargo en su tarjeta o les enviará un correo electrónico de confirmación. Actualmente, esta información solo está disponible como parte del contenido de fees.traveler_service en forma de párrafo.

Tarifa de marketing en la función de recuperación: Manage Booking | Feature | V3

Se ha añadido el valor estimado en el momento de la recuperación para room.rate.pricing.totals.marketing_fee a la respuesta de recuperación.

Ejemplo de respuesta en Rapid 3:

{
  "itinerary_id": "8999989898988",
  "property_id": "8150374",
  ...
  "rooms": [
    {
      "id": "926784314",
      "confirmation_id": { ... },
      ...
      "status": "booked",
      ...
      "rate": {
        "id": "035943984",
        "merchant_of_record": "expedia",
        ...
        "pricing": {
          "nightly": [ ... ],
          "stay": [ ... ],
          "totals": {
            "inclusive": { ... },
            "exclusive": { ... },
            "marketing_fee": {
              "billable_currency": {
                "value": "7.75",
                "currency": "USD"
              }
            },
            "property_fees": { ... }
          },
          "fees": { ... }
        }
      },
      "links": { ... }
    }
  ],
  "billing_contact": { ... },
  ...
}

Ventaja:

Los colaboradores podrán ver un valor actualizado para marketing_fee después de realizar cambios importantes en la reserva.

Propósito del viaje en la función de recuperación: Manage Booking | Feature | V3

Se ha añadido el valor almacenado de travel_purpose a la respuesta de recuperación.

Ejemplo de respuesta en Rapid 3:

{
  "itinerary_id": "8999989898988",
  "property_id": "8150374",
  ...
  "conversations": {...}
  "travel_purpose": "leisure",
  "trader_information": {...}
}

Ventaja:

Los colaboradores podrán revisar el valor enviado al alojamiento para indicar si el viajero viaja por negocios o por placer.

Alojamientos inactivos - Content | Feature | V3

Se ha añadido el punto de conexión de propiedades inactivas.

Ejemplo de solicitud en Rapid 3:

https://test.ean.com/v3/properties/inactive?since=2023-07-12

Ejemplo de respuesta en Rapid 3:

[
  {
    "property_id": "15316"
  },
  {
    "property_id": "15362666"
  },
  {
    "property_id": "15462554"
  },
  {
    "property_id": "1614382"
  },
  {
    "property_id": "18762476"
  }
]

Ventaja:

Los colaboradores podrán eliminar alojamientos de su contenido en caché rápida y fácilmente, así como saber para qué alojamientos ya no deben enviar solicitudes de disponibilidad.

Indicador del propósito del viaje - Shop | Feature | V3

Se ha añadido el parámetro travel_purpose en la solicitud de disponibilidad.

Ejemplo de solicitud en Rapid 3:

Nuevo parámetro para la solicitud de disponibilidad:

travel_purpose=business

Ventaja:

Los colaboradores podrán indicar si el viajero viaja por negocios o por placer.

Motivo de falta de disponibilidad - Shop | Feature | V3

Se ha añadido el parámetro include en la solicitud de disponibilidad con el valor unavailable_reason para solicitar que la respuesta contenga entradas de propiedades con motivos procesables por los que no se han devuelto tarifas.

Ejemplo de solicitud en Rapid 3:

Nuevo parámetro para la solicitud de disponibilidad:

include=unavailable_reason

Ventaja:

Los colaboradores podrán incluir información sobre por qué un alojamiento no está disponible en los resultados de compra.

Búsqueda de servicios por categoría - Shop | Feature | V3

Se ha añadido el parámetro amenity_category en la solicitud de disponibilidad.

Ejemplo de solicitud en Rapid 3:

Nuevo parámetro para la solicitud de disponibilidad:

amenity_category=wifi

Ventaja:

Los colaboradores podrán buscar tarifas que incluyan servicios de categorías específicas.

Precios tachados incluidos - Shop | Feature | V3

Se ha añadido información sobre precios en inclusive_strikethrough.

Ejemplo de respuesta en Rapid 3:

[
  {
    "property_id": "19248",
    "rooms": [
      {
        "id": "123abc",
        "room_name": "Fancy Queen Room",
        "rates": [
          {
            "id": "333abc",
            ...
            "occupancy_pricing": {
              "2": {
                "nightly": [ ... ],
                "stay": [ ... ],
                "totals": {
                  "inclusive": { ... },
                  "exclusive": { ... },
                  "inclusive_strikethrough": {
                    "billable_currency": {
                      "value": "726.63",
                      "currency": "CAD"
                    },
                    "request_currency": {
                      "value": "549.60",
                      "currency": "USD"
                    }
                  },
                  "strikethrough": { ... },
                  "marketing_fee": { ... },
                  "gross_profit": { ... },
                  "minimum_selling_price": { ... },
                  "property_fees": { ... }
                },
                "fees": { ... }
              }
            }
          }
        ]
      }
    ]
  }
]

Ventaja:

Los colaboradores podrán comercializar los ahorros de los descuentos financiados por el hotel, con impuestos y tasas incluidos.

Cambio importante - Book | Feature | V3

Se ha añadido a Rapid el proceso y el nuevo punto de conexión de cambio importante.

Ventajas

A partir de ahora, los colaboradores pueden modificar las reservas en nombre de los viajeros mediante Rapid API.

Consulta la sección Cambio importante para obtener más detalles.

Historial del itinerario - Book | Feature | V3

Se ha añadido información sobre el historial del itinerario a las llamadas de búsqueda y recuperación de itinerario.

Ventajas

Ahora los colaboradores pueden recuperar los detalles del historial del itinerario relativos a la creación, los cambios importantes y la cancelación como parte de la búsqueda o de la recuperación de itinerario.

Consulta la sección Historial del itinerario para obtener más información.

Descripción de texto libre de propietarios de Vrbo - Content | Feature | V3

Se ha añadido free_text a la sección vacation_rental_details de la respuesta del contenido del alojamiento.

Ejemplo de esquema de Rapid 3:

{
  "12345": {
    "property_id": "12345",
    "name": "Test Property Name",
    "phone": "1-417-862-0153",
    "vacation_rental_details": {
      "free_text": "Free form description and explanation of property provided by the host.Can possibly contain html break tags.",
      "listing_id": "1237874"
    }
  }
}

Nota: No se muestran todos los alojamientos de la respuesta de contenido en el ejemplo.

Ventajas

Los colaboradores podrán mostrar más información facilitada por los propietarios sobre alquileres vacacionales.

Consulta la guía de integración de Vrbo en Rapid.

Mejoras en la búsqueda de regiones - Geography | Feature | V3

Se han añadido nuevos parámetros de búsqueda:

• area define un área con un radio y una coordenada (par de latitud y longitud) o un ID de región.
• limit restringe el número de resultados devueltos.
• country_subdivision_code devuelve los resultados que coinciden con el código de subdivisión de país del ISO 3166-2.

Se ha añadido country_subdivision_code a las respuestas Regions y Region.

Ventajas

Los colaboradores pueden seleccionar regiones que se cruzan con las áreas especificadas.

Búsqueda de aeropuertos en un radio de latitud o longitud de 50 km:

type=airport&limit=3&area=50,37.227924,93.310036

Mejoras en la especificación de OpenAPI - Update | V3

Se han hecho varias mejoras en la especificación de OpenAPI:

• Las fechas están indicadas para representarse correctamente en API Explorer.
• Se ha cambiado de nuevo el polígono delimitador para mejorar la compatibilidad con el código generado por el cliente de Java.
• La referencia a las normas ISO es más coherente (ejemplo: ISO 639-1 alfa-2 y también ISO 3166-1 alfa-2).

Este cambio no afecta a la funcionalidad de la API, solo mejora la especificación de OpenAPI.

Ventajas

Se ha mejorado la funcionalidad en API Explorer y la compatibilidad para los colaboradores que usan el archivo descargado de YAML de la especificación de OpenAPI.

Exclusión de tarifas con depósitos de daños reembolsables - Shop | Feature | V3

Se ha añadido el parámetro exclusion en las solicitudes de disponibilidad.

Ejemplo de solicitud en Rapid 3:

Nuevo parámetro para la solicitud de compra:

exclusion=refundable_damage_deposit

Ventaja:

Los colaboradores podrán designar que la respuesta no incluya tarifas con depósitos de daños reembolsables.

Aclaración de polígonos de geografía y ejemplos - Geography | Update | V3

La especificación continúa detalles inexactos de los formatos de polígonos en respuestas y solicitudes de coordenadas. Se han actualizado los ejemplos para que puedan usarse en API Explorer para los puntos de conexión de geografía.

Este cambio no afecta a la funcionalidad de la API, solo arregla la especificación de OpenAPI.

Ejemplo de esquema de Rapid 3:

Este es un ejemplo recortado de una respuesta de regiones:

"coordinates": {
      "center_longitude": -93.29277,
      "center_latitude": 37.207935,
      "bounding_polygon": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -93.298931,
              37.205162
            ],
            [
              -93.28672,
              37.205299
            ],
            [
              -93.286549,
              37.21005
            ],
            [
              -93.286763,
              37.210221
            ],
            [
              -93.298931,
              37.205162
            ]
          ]
        ]
      }
    },

Ventaja:

La especificación refleja ahora de forma exacta que las regiones pueden devolver tanto objetos polígono (Polygon) como multipolígono (MultiPolygon) en la respuesta. También proporciona esquema preciso y un ejemplo de una búsqueda de polígono.

Calendario de disponibilidad de Vrbo - Shop | Feature | V3

Se ha añadido el punto de conexión del calendario de disponibilidad de Vrbo, "/calendars/availability".

Ejemplo de esquema de Rapid 3:

[
    {
        "property_id": "1234",
        "days": [
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            },
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            }
        ]
    }
]

Ventajas:

La API del calendario de disponibilidad de Rapid proporciona un resumen de la disponibilidad diaria de un alojamiento durante un periodo determinado de tiempo, y puede utilizarse para ayudar a los huéspedes a que visualicen la página de detalles del alojamiento.

Haz clic aquí para consultar más información.

Enhanced House Rules - Content | Feature | V3

Se ha añadido Enhanced House Rules (Normas del alojamiento mejoradas), un reemplazo de House Rules (Normas del alojamiento) a la API de contenido de Rapid para los alojamientos de Vrbo.

Ejemplo de esquema de Rapid 3:

"enhanced_house_rules": {
        "CheckIn": {
            "rule": "Check in after 3:00 PM",
            "additional_information": []
        },
        "CheckOut": {
            "rule": "Check out before 11:00 AM",
            "additional_information": []
        },
        "Occupancy": {
            "rule": "Maximum overnight guests: 5 (sleeps up to 5 adults)",
            "additional_information": []
        },
        "MinBookingAge": {
            "rule": "Minimum age to rent: 18",
            "additional_information": []
        },
        "Children": {
            "rule": "Children allowed: ages 0-17",
            "additional_information": []
        },
        "Pets": {
            "rule": "Pets allowed: 1 pet less than 10kgs",
            "additional_information": [
                "Pets allowed under aproval/Se requiere aprobacion"
            ]
        },
        "Events": {
            "rule": "No Events allowed",
            "additional_information": []
        },
        "Smoking": {
            "rule": "Smoking allowed: outside",
            "additional_information": [
                "Silence is required after 10pm/Silencio 10pm",
                "At the balcony, Thank you! En el balcon, Gracias!"
            ]
        }
    }

Ventaja:

"Enhanced House Rules" permite una visualización más clara de las políticas del alojamiento, incluidas notas de texto libre del propietario, para describir los límites y excepciones de cada política o cualquier otra información relevante para la estancia de los huéspedes.

Mejoras en geografía - Geography | Feature | V3

Las llamadas de geografía disponen ahora de las siguientes mejoras:

• Se ha añadido el filtro supply_source a las solicitudes de región, regiones y alojamientos dentro de polígono.
• Se ha añadido el encabezado Pagination-Total-Results a las respuestas de región, regiones y alojamientos dentro de polígono.
• Se han añadido los filtros type y country_code a la solicitud de regiones.

Ventaja:

Estas mejoras de las diferentes llamadas de geografía aportan a los colaboradores un control más preciso de los resultados que reciben.

Se ha añadido el intervalo de fechas no reembolsable - Shop | Manage Booking Feature | V3

Se ha añadido el objeto de intervalo de fechas no reembolsable a las respuestas de itinerario y disponibilidad.

Ejemplo de esquema de Rapid 3:

"nonrefundable_date_ranges": [
    {
    "start": "2022-09-05",
    "end": "2022-09-11"
    }
   ],

Ventajas:

Los colaboradores podrán mostrar las excepciones de reembolso definidas por el proveedor en función de las vacaciones u otros factores, de forma que los viajeros estarán mejor informados acerca de cuándo recibirán los reembolsos por cancelación.

Se ha añadido la lista de categorías y la lista de etiquetas a las respuestas de región - Geography | Feature | V3

Se ha añadido la lista de categorías y la lista de etiquetas a todas las respuestas de región.

Ejemplo de esquema de Rapid 3:

"categories": [
    "tourism:region"
],
"tags": [
    "geoAdmin:city"
]

Ventaja:

Los colaboradores podrán utilizar las categorías y las etiquetas para obtener información de metadatos sobre la región devuelta.

Se han retirado las versiones de Rapid 2.3 y 2.4 - Remove | V2.4 | Breaking Change

Se han retirado las versiones 2.3 y 2.4 de Rapid API.

Se han añadido las configuraciones de unidad para Vrbo al contenido - Content | Feature | V3

Se ha añadido el objeto de configuración de unidad a las respuestas de contenido.

Ejemplo de esquema de Rapid 3:

[
    {
        "property_id": "1234",
        "days": [
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            },
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            }
        ]
    }
]

Ventajas:

La configuración de unidad describe los tipos y el número de camas de cada habitación.

Se ha añadido el idioma chino (Hong Kong) - Content | Shopping | Feature | V3

Se ha añadido la opción de idioma chino (Hong Kong). Ahora es posible utilizar el código de idioma "zh-HK" en las solicitudes en las que se admita el parámetro de idioma.

Encontrarás una lista de todos los idiomas compatibles aquí.

Información esencial sobre la estancia con Vrbo - Manage Booking | Feature | V3

Se ha añadido información esencial sobre la estancia con Vrbo a las respuestas de itinerario.

Ejemplo de esquema de Rapid 3:

"essential_information": {
  "contact": {
    "name": "John test",
    "phone": {
      "country_code": "1",
      "area_code": "367",
      "phone_number": "6876876"
    },
    "email": "dv@devmail.wvrgroup.internal",
    "address": {
      "line_1": "3rd St",
      "line_2": "421 W",
      "city": "Austin",
      "state_province_code": "TX",
      "postal_code": "86868",
      "country_code": "US"
    }
  },
  "essentials": [
    {
      "name": "directions",
      "instructions": "30.3079827,-97.8934852\n\nTurn right into the alley at the end of the road.",
      "images": [
        {
          "url": "https://odis-stage.vrbo.com/odis/hospitality/a94d96e2-499b-4155-8872-6d0a4dd9a9db.large.jpg",
          "width": 1024,
          "height": 768
        },
        {
          "url": "https://odis-stage.vrbo.com/odis/hospitality/e1713ff4-ad67-4498-93a1-befbdf5275a0.large.jpg",
          "width": 1024,
          "height": 768
        }
      ]
    },
    {
      "name": "wifi",
      "instructions": "Secure, hi speed wifi is available throughout the property.",
      "images": [
        {
          "url": "https://odis-stage.vrbo.com/odis/hospitality/caa47f61-3e7f-459b-bd74-e3cfe76a0edc.large.jpg",
          "width": 1024,
          "height": 768
        }
      ],
      "additional_info": {
        "network_name": "HomeNetwork",
        "network_password": "HomeNetwork1234567890"
      }
    },
    {
      "name": "thermostat",
      "instructions": "Thermostat\n\nDo not adjust thermostat below 59F/15C."
    }
  ],
  "updates_available_datetime": "2022-08-14T09:00:00-05:00"
}

Ventajas:

El contenido básico sobre la estancia con Vrbo proporciona a los viajeros instrucciones importantes antes de la llegada, incluida la dirección del alojamiento y la información de contacto del responsable del alojamiento. También puede incluir otros datos clave que el viajero pueda necesitar al llegar, durante la estancia o al irse.

Cambio del Nuevo Marco para los Consumidores (ND4C) para todas las versiones - Shopping | Booking | Manage Booking | Feature | V3 | Breaking Change

Se han introducido cambios en Rapid para dar respuesta al impacto que el Nuevo Marco para los Consumidores (ND4C) puede tener en tu empresa. Esta ley afectará a los puntos de venta de la Unión Europea y el Reino Unido.

Ejemplo de esquema de Rapid 3:

"trader_information": {
  "traders":[
    {
       "name": "Expedia",
       "address": {
         "line_1": "555 1st St",
         "line_2": "10th Floor",
         "line_3": "Unit 12",
         "city": "Seattle",
         "state_province_code": "WA",
         "postal_code": "98121",
         "country_code": "US"
       },
      "email": "travel@support.expedia.com",
      "phone": "0330-123-1235",
      "contact_message": "This property is managed by a professional host. The provision of housing is linked to trade, business or profession."
     }
   ],
   "terms_and_conditions": "https://www.expedia.com/terms_and_conditions"
}

Ventajas:

Proporciona a los colaboradores información comercial para cumplir los requisitos normativos del ND4C.

Se han retirado los idiomas croata y lituano - Content | Shopping | Remove | V3

Se ha retirado los idiomas croata y lituano. Los intentos de utilizar estos idiomas en una solicitud que acepte el parámetro de idioma darán lugar a un error.

Se han suspendido las versiones 2.3 y 2.4 de Rapid - Deprecated | V2.4 | Breaking Change

Se han suspendido las versiones 2.3 y 2.4 de Rapid API. Ambas versiones se retirarán en octubre de 2022.

Se ha retirado la versión 2.2 de Rapid - Remove | V2.2 | Breaking Change

Se ha retirado la versión 2.2 de Rapid API.

Se ha añadido un cuerpo de solicitud a la API de Notifications Test - Notifications | Change | V3 | Breaking Change

A partir de ahora se requiere un cuerpo de solicitud.

Ejemplo de esquema de Rapid 3:

{
    "event_type": "itinerary.agent.create"
}

Ventajas:

Esta medida garantiza la coherencia en Rapid API.

Se ha añadido un parámetro de consulta no entregable a la API de Notifications Undeliverable - Notifications | Change | V3 | Breaking Change

Ahora se requiere un nuevo parámetro de consulta de no entregable.

Ventajas:

Esta medida garantiza la coherencia en Rapid API.

Se han movido los campos "Refundable Damage Deposit" y "Card On File Limit" para mantener la coherencia con Shop - Manage Booking | Change | V3 | Breaking Change

Los campos "Refundable Damage Deposit" y "Card On File Limit" se han movido para mantener la coherencia con Shop.

Ejemplo de esquema de Rapid 3:

"card_on_file_limit": {
  "value": "string",
  "currency": "string"
},
"refundable_damage_deposit": {
  "value": "string",
  "currency": "string"
},

Ventajas:

Esta acción hace que el esquema sea más sencillo para los colaboradores.

Se han cambiado los puntos de conexión de la API de Notifications - Notifications | Change | V3 | Breaking Change

Se han cambiado los puntos de conexión de las API de Notifications Test y Notifications Undeliverable (se han eliminado /{event_type} y /undeliverable del final). El punto de conexión de la API de Notifications Test ha cambiado de GET a POST.

Ventajas:

Esta medida garantiza la coherencia en Rapid API.

Se ha cambiado el nombre de "Deposit Policy" a "Deposits" para que sea más coherente con Shop - Manage Booking | Change | V3 | Breaking Change

El nombre del objeto "Deposit Policy" se ha cambiado a "Deposits" para garantizar una mayor coherencia con Shop.

Ejemplo de esquema de Rapid 2.4:

"deposit_policies": [
  {
    "amount": "220.75",
    "due": "2018-12-12T01:01:01.000-08:00"
  }
],

Ejemplo de esquema de Rapid 3:

"deposits": [
  {
    "amount": "220.75",
    "due": "2018-12-12T01:01:01.000-08:00"
  }
],

Ventajas:

Esta acción hace que el esquema sea más sencillo para los colaboradores.

Se ha suspendido el punto de conexión de la API de Content de TripAdvisor - Content | Deprecate | V3 | Breaking Change

Expedia Group ya no mantiene ningún vínculo con TripAdvisor, por lo que el punto de conexión de la API de Content de TripAdvisor en Rapid 3 quedará obsoleto.

Ventajas:

Los colaboradores no podrán hacer llamadas a puntos de conexión redundantes.

Se ha añadido el ID de fidelidad - Booking | Manage Booking | Feature | V3 | Breaking Change

Nueva función que permite a los colaboradores facilitar un ID de fidelidad del hotel.

• Se trata de un identificador de un programa de fidelidad de hotel asociado con el huésped de esta habitación.
• Existe bajo el objeto "rooms".

Ejemplo de esquema de Rapid 3:

"rooms": [
  {
    "given_name": "John",
    "family_name": "Smith",
    "smoking": false,
    "special_request": "Top floor or away from street please",
    "loyalty_id": "ABC123"
  }
],

Notas: El nuevo campo se mostrará en distintos lugares.

• Creación de solicitud de reserva
• Recuperación de itinerario
• Cambio de itinerario

Ventajas:

Permite a los colaboradores incluir el ID de fidelidad y transmitir esta información al hotel.

Aclaración con fines informativos: No garantiza que el hotel vaya a ofrecer más puntos ni ventajas.

Se han añadido datos de depósito a la respuesta de disponibilidad de Rapid - Shopping | Feature | V3

Rapid 3 evitará que los colaboradores deban efectuar una llamada por separado para obtener información sobre el depósito (calendario de pagos). Mostraremos estos datos como un elemento secundario del objeto "Rate".

Además de eliminar la necesidad de realizar otra llamada para el depósito (calendario de pagos), haremos que los datos estén disponibles en la respuesta "priceCheck" para aumentar la visibilidad.

Ejemplo de esquema de Rapid 3:

"deposits": [
  {
    "value": "70.00",
    "due": "2021-08-21",
    "currency": "CAD"
  }
]

Rapid 3 ya no necesitará devolver un enlace para depósitos a fin de recuperar los datos correspondientes. En lugar de ello, la información se recogerá y se mostrará en la respuesta.

Ejemplo de esquema de Rapid 2.4:

"links": {
  "payment_options": {
    "method": "GET",
    "href": "/2.4/properties/19248/payment-options?token=MY5S3j36cOcL"
  },
  "deposit_policies": {
    "method": "GET",
    "href": "/2.4/properties/19248/deposit-policies?token=MY5S3j36cOcL"
  }
}

Ejemplo de esquema de Rapid 3:

"links": {
  "payment_options": {
    "method": "GET",
    "href": "/2.4/properties/19248/payment-options?token=MY5S3j36cOcL"
  }
}

Rapid 3 ya no devolverá un campo "deposit_required", ya que es innecesario con la nueva matriz de depósitos.

Ejemplo de esquema de Rapid 2.4:

"sale_scenario": {
  "package": false,
  "member": true,
  "corporate": false,
  "distribution": false
},
"deposit_required": true,
"merchant_of_record": "expedia",

Ejemplo de esquema de Rapid 3:

"sale_scenario": {
  "package": false,
  "member": true,
  "corporate": false,
  "distribution": false
},
"merchant_of_record": "expedia",

Ventajas:

Los colaboradores ya no tendrán que realizar otra llamada para obtener los datos, ya que estos se integrarán en la respuesta.

Se ha añadido compatibilidad con los elementos "card_on_file_limit" y "refundable_damage_deposit" de un alquiler vacacional en la respuesta "priceCheck" - Shopping | Feature | V3

Se han añadido más datos relevantes para los alquileres vacacionales. El elemento "card_on_file_limit" es el máximo que se puede cobrar a una tarjeta por daños al alojamiento, mientras que "refundable_damage_deposit" es el importe de depósito que requiere el alojamiento. Solo habrá un valor disponible en la respuesta; nunca se devolverán los dos a la vez para un colaborador con una tarifa determinada.

Ejemplo de esquema de Rapid 3:

"card_on_file_limit": {
  "value": "25.00",
  "currency": "CAD"
},
"refundable_damage_deposit": {
  "value": "75.00",
  "currency": "CAD"
}

Ventajas:

Los colaboradores disfrutarán de una visibilidad completa de los depósitos y las expectativas de los alquileres vacacionales.

Se ha añadido el campo obligatorio "supply_source" a la API/archivo de Property Content y al archivo de Property Catalog - Content | Feature | V3 | Breaking Change

Se ha añadido un nuevo campo obligatorio "supply_source" a la API/archivo de Property Content y al archivo de Property Catalog para que los colaboradores puedan especificar qué tipo de inventario desean devolver.

Si se aprueba un valor "expedia", se devolverá solo el inventario de Expedia.

Si se aprueba un valor "vrbo", se devolverá solo el inventario de Vrbo.

Ejemplo de esquema de Rapid 3:

"supply_source": "vrbo"

Notas: El campo "supply_source" ahora es obligatorio. Para lograr el mismo comportamiento que las versiones anteriores de la API, los colaboradores deben aprobar "supply_source": "expedia".

Ventajas:

Los colaboradores podrán acceder al inventario de Vrbo a través del mismo punto de conexión que para el inventario de Expedia.

Se ha añadido una nueva sección a la API/archivo de Property Content para consolidar la información específica sobre el alojamiento y las habitaciones de los alquileres vacacionales - Content | Feature | V3 | Breaking Change

Se ha añadido una nueva sección de alquileres vacacionales al archivo/contenido de Rapid en la que los colaboradores encontrarán información sobre el alojamiento específica de los alquileres de vacaciones, como los atributos que normalmente se encontrarían en la descripción de la habitación de un alojamiento con varias unidades.

La visualización del contrato de alquiler en la página de pago del colaborador ahora es un requisito de lanzamiento de Rapid para los alquileres vacacionales.

Ejemplo de esquema de Rapid 3:

"vacation_rental_details": {
  "property_registration":{
  },
  "private_host"{
  },
  "property_manager": {
    "name": "Frans Belderbos",
    "links": {
      "image": {
        "method": "GET",
        "href": "https://odis.vrbo.com/odis/story/89cd116a-14fd-4fbc-a0d1-861894171cd0.c1.jpg"
      }
    },
    "rental_agreement": {
      "links": {
        "rental_agreement": {
          "method": "GET",
          "href": "https://www.vrbo.com/td/proxies/ecomQuote/downloadRentalAgreement?unitUrl=/units/0000/1341f175-3550-4c80-b9a1-b6b330b7e032"
        }
      }
    },
    "house_rules": [
        "Children welcome",
        "Pets welcome (restrictions apply)",
        "No smoking",
        "No parties or events"
      ],
    "amenities": {
        "1073743284": {
            "id": "1073743284",
            "name": "Heating"
        },
        "4296": {
            "id": "4296",
            "name": "Furnished balcony or patio"
        }
    }
  }
}

Ventajas:

Esta medida ofrece más detalles del alojamiento para disfrutar de una mayor visualización de los alquileres vacacionales de una sola unidad, y todo ello en una sección específica sobre alquileres vacacionales en nuestra respuesta de contenido.

Verificación de terceros para PSD2 - Booking | Feature | V3 | Breaking Change

Nuevo producto que permite a los colaboradores utilizar su proveedor de servicios de pago preferido para cumplir con la PSD2.

Requiere los parámetros cavv, eci, three_ds_version y ds_transaction_id.

Ejemplo de esquema de Rapid 3:

"third_party_authentication": {
  "cavv": "jELUbgG+Tgj0AREBDMLeCad+oIs=",
  "eci": "05",
  "three_ds_version": "2.2.0",
  "ds_transaction_id": "ac01cc2b-c1a1-4981-8c6f-400d4eec88de",
  "pa_res_status": "Y",
  "ve_res_status": "C",
  "xid": "47133847-13be-4ae3-9be9-e4053b9c83c0",
  "cavv_algorithm": "3",
  "ucaf_indicator": "0"
}

Ventajas:

A partir de ahora, los colaboradores pueden utilizar su proveedor de servicios de pago favorito para cumplir con la PSD2.

Se ha añadido la codificación de caracteres especiales para corregir errores de seguridad - Booking | Bug Fix | V3 | Breaking Change

Se han vuelto a codificar determinados caracteres especiales de distintos campos para evitar una vulnerabilidad de seguridad.

Ventajas:

Eliminación de una posible vulnerabilidad de seguridad.

Se ha solucionado el error del encabezado de prueba de la verificación de precio - Shopping | Bug Fix | V3

El nombre del encabezado de prueba no válido para la llamada de verificación de precio se ha cambiado para que coincida con un valor válido.

Ejemplo de esquema de Rapid 2.4:

--header "Test: matched"

Ejemplo de esquema de Rapid 3:

--header "Test: available"

Ventajas:

Esta corrección permite al colaborador probar su integración con la verificación de precios con más detalle.

Se ha corregido el error tipográfico en la enum "Customer_account_Details" - Booking | Bug Fix | V3 | Breaking Change

Se ha corregido el error tipográfico en la enum "customer_account_details": se ha cambiado "fido_authenticaton" por "fido_authentication".

Ejemplo de esquema de Rapid 2.4:

"customer_account_details": {
  "authentication_method": "fido_authenticaton",
  "authentication_timestamp": "2018-02-12T11:59:00.000Z",
  "create_date": "2018-09-15",
  "change_date": "2018-09-17",
  "password_change_date": "2018-09-17",
  "add_card_attempts": 1,
  "account_purchases": 1
},

Ejemplo de esquema de Rapid 3:

"customer_account_details": {
  "authentication_method": "fido_authentication",
  "authentication_timestamp": "2018-02-12T11:59:00.000Z",
  "create_date": "2018-09-15",
  "change_date": "2018-09-17",
  "password_change_date": "2018-09-17",
  "add_card_attempts": 1,
  "account_purchases": 1
},

Ventajas:

Se ha eliminado un error de ortografía que puede confundir a los colaboradores.

Se han eliminado las recomendaciones de otros alojamientos y de venta cruzada - Recommendations | Remove | V3 | Breaking Change

Se han eliminado los parámetros reference_property_id, destination_iata_airport_code, origin_iata_airport_code y iata_airline_code. El enlace a las recomendaciones ya no se mostrará en la respuesta.

Ejemplo de esquema de Rapid 2.4:

"recommendations": {
  "method": "GET",
  "href": "/2.4/properties/availability?token=abcdef"
}

Ventajas:

Los colaboradores no podrán hacer llamadas con parámetros de solicitud redundantes.

Se han eliminado los campos obsoletos del objeto "Fees" - Shopping | Booking | Manage Booking | Remove | V3 | Breaking Change

Se ha simplificado el objeto "Fees" mediante la eliminación de campos que no eran informativos y provocaban confusión a la hora de mostrar el total de tasas.

Ejemplo de esquema de Rapid 2.4:

"fees": {
  "mandatory_fee": {
    "billable_currency": {
      "value": "5.00",
      "currency": "CAD"
    },
    "request_currency": {
      "value": "3.00",
      "currency": "USD"
    },
    "scope": "per_person",
    "frequency": "per_day"
  }
}

Ejemplo de esquema de Rapid 3:

"fees": {
  "mandatory_fee": {
    "billable_currency": {
      "value": "5.00",
      "currency": "CAD"
    },
    "request_currency": {
      "value": "3.00",
      "currency": "USD"
    }
  }
}

Ventajas:

Se han eliminado los campos "scope" y "frequency" para que quede más claro qué tasas se cobrarán. Esta acción elimina los campos que no eran necesarios y simplifica el esquema para el colaborador.

Se ha eliminado la ruta "/properties/{property_id}/deposit-policies" - Shopping | Remove | V3

Se ha eliminado el punto de conexión "deposit-policies", ya que ahora forma parte directamente de la llamada de disponibilidad.

Ventajas:

Los colaboradores no tendrán que hacer otra llamada para obtener información sobre la política de depósitos.

Se ha simplificado la descripción del código postal - Booking | Update | V3

La descripción del campo del código postal se ha simplificado para que sea menos confusa.

Ejemplo de esquema de Rapid 2.4:

Código postal del cliente. El elemento "Postal_Code" es obligatorio si el tipo de pago es una tarjeta de crédito (CC, CCC, VCC) y el código de país es US, GB o CA.

Ejemplo de esquema de Rapid 3:

Código postal.

Ventajas:

Esta medida aclara cuándo el campo es obligatorio.

Se ha simplificado la descripción del total de los planes de tarifas - Shopping | Update | V3

Se ha simplificado la descripción del total de los planes de tarifas. La descripción del campo del total de los planes de tarifas se ha actualizado para incluir límites máximos y mínimos, y para aclarar qué intenta devolver este campo (el mejor precio disponible).

Ejemplo de esquema de Rapid 2.4:

La cantidad de tarifas que se devuelve por alojamiento. El precio de la tarifa determina qué tarifas se devuelven, por ejemplo, "rateplancount=4" devolverá las cuatro tarifas más bajas, pero las tarifas no se ordenan de menor a mayor o viceversa en la respuesta. Se ha comprobado que la tarifa más barata ofrece la mejor tasa de conversión, por lo que se recomienda un valor de 1. El valor deberá ser mayor que 0.

Ejemplo de esquema de Rapid 3:

La cantidad de tarifas que se devuelve por alojamiento. Se devolverán las tarifas que ofrecen la mejor relación calidad-precio, por ejemplo, "rateplancount=4" devolverá las cuatro tarifas más bajas, pero las tarifas no se ordenan de menor a mayor o viceversa en la respuesta. En general, se dará prioridad a las tarifas más bajas. El valor debe estar entre 1 y 250.

Ventajas:

Los valores válidos para el campo son ahora más fáciles de entender.

Se ha simplificado la descripción del código de provincia o estado - Booking | Update | V3

La descripción del campo de código de provincia o estado se ha simplificado para que sea menos confuso.

Ejemplo de esquema de Rapid 2.4:

Código de provincia o estado del cliente. Obligatorio si el "country_code" es US, AU o CA.

Ejemplo de esquema de Rapid 3:

Código de estado o provincia de dos o tres letras utilizado para Australia, Canadá y Estados Unidos.

Ventajas:

Esta medida aclara cuándo el campo es obligatorio.