Log de alterações

Recibos de reserva - Manage Booking | Feature | V3

Agora parceiros podem usar um link da resposta de recuperação do itinerário para recuperar um recibo de reserva de um novo ponto de extremidade na Rapid API. Consulte Recibos de reserva para mais detalhes.

Exemplo de solicitação de recibo de reserva na 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"

Exemplo de resposta na Rapid 3:

A resposta vai ser uma representação em PDF de um recibo da transação que pode ser compartilhado com o viajante.

Benefício:

Agora parceiros têm uma API fácil de consumir que fornece recibos de reserva para clientes de viagens corporativas que precisam informar as despesas de viagem aos seus empregadores.

Novas opções de busca e filtros – Content | Feature | V3

Novos parâmetros de solicitação foram adicionados para refinar os resultados de busca por este campo:

• trip_reason

Além disso, adicionamos um parâmetro de filtro à solicitação que vai permitir a remoção de avaliações que não estejam no idioma solicitado.

Exemplo de solicitação na Rapid 3: neste exemplo, estamos usando o novo parâmetro filter com o valor language e o novo parâmetro de busca trip_reason com os valores business e 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"

Exemplo de resposta na Rapid 3: nesta resposta, podemos ver que os novos campos stay_date e management_responses estão presentes, e são retornadas apenas avaliações com os valores trip_reason de business e 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"
                    }
                ]
            }
        ]
    }
}

Benefício:

Os campos adicionais retornados na resposta devem fornecer mais contexto e aumentar o valor dessas avaliações. Parceiros que querem restringir as buscas de avaliações de hóspedes agora podem limitar as avaliações a um único idioma e aos motivos de viagem que agregam mais valor.

Fidelidade - Book | Shop | Feature | V3

Estamos adicionando novos recursos que aumentam a sua capacidade de localizar tarifas corporativas que tenham oportunidades de recebimento de pontos do programa de fidelidade da propriedade associadas. Leia mais sobre os nossos pontos do programa de fidelidade do hotel.

Benefício:

Parceiros vão ter ferramentas melhores para ajudar viajantes de negócios a receber pontos em programas de fidelidade das propriedades.

Incentivos das taxas de marketing - Shop | Feature | V3

Adicionado um novo valor à solicitação de compra para o parâmetro include, que faz o objeto marketing_fee_incentives ser retornado na resposta.

Exemplo de solicitação na 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"

Exemplo de resposta na 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
  }
]

Benefício:

Parceiros podem identificar com mais facilidade as tarifas com incentivos especiais aplicados.

Novas opções de busca e filtros – Content | Feature | V3

Novos parâmetros de solicitação foram adicionados para refinar os resultados de busca por estes campos:

• all_inclusive
• amenity_id
• attribute_id
• category_id
• spoken_language_id

Agora, também é possível especificar com muito mais precisão quais partes da resposta você quer incluir aumentando o número de valores válidos do parâmetro include. Os novos valores incorporam todos os elementos de nível superior da resposta de conteúdo. Para mais informações, consulte Busca e filtragem.

Exemplo de solicitação na Rapid 3: neste exemplo, estamos usando o novo parâmetro de busca amenity_id, bem como os novos valores de name e amenities no 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"

Exemplo de resposta na Rapid 3: nesta resposta, é possível ver que apenas a propriedade 1337 foi retornada, pois a propriedade 1 não tem a comodidade de ID 115 disponível. Também é possível ver que as seções property_id, name e amenities estão incluídas na resposta. A seção property_id sempre é incluída na resposta e não precisa ser especificada como um parâmetro de solicitação include, a menos que seja o único campo desejado.

{
  "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)"
      },
      ...
    }
  }
}

Benefício:

Parceiros que procuram propriedades e campos de respostas mais específicos agora podem otimizar as interações com a API de conteúdo para Rapid. Quando parceiros especificam quais partes do conteúdo são necessárias, também comunicam às equipes da Rapid qual conteúdo é usado e, portanto, considerado mais importante.

Situação de promoção para dispositivos móveis – Shop | Feature | V3

O valor sale_scenario.mobile_promotion foi adicionado aos parâmetros include para solicitações de alteração de disponibilidade e compras.

O campo room.rate.sale_scenario.mobile_promotion foi adicionado às respostas para alterações de disponibilidade, taxas adicionais e compras.

Exemplo de solicitação na 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"

Exemplo de resposta noa 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
  }
]

Benefício:

Agora há um novo método para parceiros que buscam identificar com mais facilidade quais tarifas estão associadas a uma promoção para dispositivos móveis.

Novo tipo de região de rodoviária - Geography | Feature | V3

Adicionado o tipo de região bus_station à solicitação de pontos de extremidade de regiões. Tanto região quanto regiões agora fornecem dados sobre regiões com o tipo bus_station.

Exemplo de solicitação na 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"

Exemplo de resposta na Rapid 3:

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

Benefício:

Os parceiros podem incluir informações sobre rodoviárias nos seus sites para viajantes.

Nome do administrador integrado do aluguel por temporada no conteúdo - Content | Feature | V3

Adicionado o campo vacation_rental_details.ipm_name à resposta de conteúdo de propriedades.

Exemplo de resposta na 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": { ... }
  }
}

Benefício:

Parceiros que vendem produtos da Vrbo devem indicar o nome do administrador integrado para criar mensagens informando os hóspedes sobre o nome de quem que vai fazer a cobrança no cartão ou enviar um e-mail de confirmação. No momento, esta informação só está disponível como parte do conteúdo de fees.traveler_service em forma de parágrafo.

Taxa de marketing na função de recuperação - Manage Booking | Feature | V3

Adicionado o valor estimado no momento da recuperação de room.rate.pricing.totals.marketing_fee à resposta de recuperação.

Exemplo de resposta na 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": { ... },
  ...
}

Benefício:

Parceiros vão ver um valor atualizado para marketing_fee após realizar alterações principais na reserva.

Motivo da viagem na resposta de recuperação - Manage Booking | Feature | V3

Adicionado o valor armazenado de travel_purpose à resposta de recuperação.

Exemplo de resposta na Rapid 3:

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

Benefício:

Parceiros podem revisar o valor enviado à propriedade para indicar se a pessoa está viajando a negócios ou lazer.

Propriedades inativas — Content | Feature | V3

Adicionado o ponto de extremidade de propriedades inativas.

Exemplo de solicitação na Rapid 3:

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

Exemplo de resposta na Rapid 3:

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

Benefício:

Os parceiros podem remover de maneira rápida e fácil as propriedades do seu conteúdo armazenado em cache e saber para quais propriedades não devem mais enviar solicitações de disponibilidade.

Indicador de motivo da viagem — Shop | Feature | V3

Adicionado o parâmetro travel_purpose para solicitações de disponibilidade.

Exemplo de solicitação na Rapid 3:

Novo parâmetro para solicitação de disponibilidade:

travel_purpose=business

Benefício:

Os parceiros podem comunicar se a viagem é a negócios ou a lazer.

Motivo de indisponibilidade — Shop | Feature | V3

Adicionado o parâmetro include à solicitação de disponibilidade com o valor unavailable_reason para pedir que a resposta contenha entradas para propriedades com motivos para nenhuma tarifa ser retornada.

Exemplo de solicitação na Rapid 3:

Novo parâmetro para solicitação de disponibilidade:

include=unavailable_reason

Benefício:

Os parceiros podem incluir informações sobre o motivo da indisponibilidade de uma propriedade como parte dos resultados da compra.

Pesquisa de categoria de comodidades — Shop | Feature | V3

Adicionado o parâmetro amenity_category para solicitações de disponibilidade.

Exemplo de solicitação na Rapid 3:

Novo parâmetro para solicitação de disponibilidade:

amenity_category=wifi

Benefício:

Parceiros podem pesquisar tarifas que incluam comodidades com categorias correspondentes.

Preço riscado incluído — Shop | Feature | V3

Adicionadas informações de preços para inclusive_strikethrough.

Exemplo de resposta na 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": { ... }
              }
            }
          }
        ]
      }
    ]
  }
]

Benefício:

Parceiros podem comercializar um desconto financiado pelo hotel, incluindo impostos e taxas.

Alterações principais - Book | Feature | V3

Adicionado o novo ponto de extremidade de alterações principais e o fluxo da Rapid.

Benefício

Os parceiros agora podem modificar as reservas em nome de clientes de viagem por meio da Rapid API.

Consulte mais informações em Alterações principais.

Histórico do itinerário - Book | Feature | V3

Adicionadas informações de histórico do itinerário às chamadas de busca de itinerário e de recuperação de itinerário.

Benefício

Os parceiros agora podem recuperar as informações de histórico do itinerário relacionadas a criação, alterações principais e cancelamento como parte da busca de itinerário ou recuperação de itinerário.

Consulte mais informações em Histórico do Itinerário.

Descrição de texto livre do anfitrião da Vrbo – Content | Feature | V3

Adicionado free_text à seção vacation_rental_details da resposta de conteúdo de propriedades.

Exemplo de esquema da 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"
    }
  }
}

Observação: nem todas as propriedades de resposta de conteúdo estão representadas no exemplo.

Benefício

Parceiros podem apresentar mais informações sobre uma propriedade de aluguel por temporada fornecidas pelo anfitrião.

Consulte o Guia de integração da Vrbo na Rapid

Aprimoramentos da busca de regiões – Geography | Feature | V3

Adicionados vários novos parâmetros de busca:

• area define uma área usando um raio e uma coordenada, ou seja, um par de latitude/longitude, ou um ID de região.
• limit restringe o número de resultados retornados.
• country_subdivision_code retorna resultados que correspondem ao código de subdivisão do país ISO 3166-2.

Adicionado country_subdivision_code às respostas Regions e Region.

Benefício

Parceiros podem selecionar regiões que se cruzam com áreas específicas.

Busca de aeroporto dentro de 50 km da latitude/longitude:

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

Melhorias na especificação OpenAPI – Update | V3

Várias melhorias diferentes na especificação OpenAPI:

• As datas são citadas de modo que sejam representadas de maneira correta no API Explorer.
• BoundingPolygon ajustado de novo para melhorar a compatibilidade com o código gerado pelo cliente Java.
• Consistência aprimorada ao fazer referência a padrões ISO, por exemplo, ISO 639-1 alpha-2 e ISO 3166-1 alpha-2.

Essa alteração não afeta o funcionamento da API, apenas melhora a especificação OpenAPI.

Benefício

Funcionamento aprimorado no API Explorer e compatibilidade melhorada para parceiros usando o arquivo yaml de especificação OpenAPI baixado.

Excluir tarifas de depósito caução reembolsável — Shop | Feature | V3

Adicionado o parâmetro exclusion para solicitações de disponibilidade.

Exemplo de solicitação na Rapid 3:

Novo parâmetro para solicitação de compra

exclusion=refundable_damage_deposit

Benefício:

Parceiros vão poder indicar que a resposta não deve incluir tarifas com depósitos caução reembolsáveis.

Esclarecidos os polígonos de geografia e os exemplos – Geography | Update | V3

A especificação tinha detalhes incorretos dos formatos de polígonos em solicitações e respostas de coordenadas. Os exemplos foram atualizados para uso no API Explorer dos pontos de extremidade de geografia.

Essa alteração não afeta o funcionamento da API, apenas corrige a especificação OpenAPI.

Exemplo de esquema da Rapid 3

Este é um exemplo reduzido de uma resposta de regiões:

"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
            ]
          ]
        ]
      }
    },

Benefício:

A especificação agora reflete com precisão que as regiões podem retornar objetos Polygon e MultiPolygon na resposta. Também conta com um esquema correto e um exemplo de pesquisa de polígonos.

Calendário de disponibilidade da Vrbo – Shop | Feature | V3

Adicionado o ponto de extremidade do calendário de disponibilidade da Vrbo, "/calendars/availability".

Exemplo de esquema da 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
                }
            }
        ]
    }
]

Benefício

A API de calendário de disponibilidade para Rapid proporciona um resumo da disponibilidade diária de uma propriedade em um determinado período, que pode ser usada para ajudar hóspedes a visualizar a página de detalhes da propriedade.

Veja mais detalhes aqui.

Regras da propridade aprimoradas – Content | Feature |V3

As Regras da propridade aprimoradas, uma substituição das Regras da propridade, foram adicionadas à API de conteúdo para Rapid para as propriedades da Vrbo.

Exemplo de esquema da 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!"
            ]
        }
    }

Benefício:

As Regras da propridade aprimoradas mostram de forma mais clara as políticas da propriedade, incluindo notas de texto livre do anfitrião, para descrever limites/exceções a cada política ou outras informações relevantes para a estadia de hóspedes.

Aprimoramentos de geografia – Geography | Feature |V3

As ligações de geografia agora têm os seguintes aprimoramentos:

• Adicionados o filtro supply_source para região, regiões e propriedades nas solicitações de polígono.
• Adicionado o cabeçalho Pagination-Total-Results para região, regiões e propriedades nas solicitações de polígono.
• Adicionados os filtros type e country_code para a solicitação de regiões.

Benefício:

Esses aprimoramentos nas várias ligações de Geografia oferecem aos parceiros um controle mais preciso sobre os resultados que eles recebem de volta.

Adicionado o intervalo de datas não reembolsáveis – Shop | Manage Booking Feature | V3

Adicionado o objeto de intervalo de datas não reembolsável às respostas de disponibilidade e itinerário.

Exemplo de esquema da Rapid 3

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

Benefício

Os parceiros vão poder exibir as exceções de reembolso definidas pelo fornecedor com base em feriados ou outros fatores, para que viajantes tenham mais informações sobre quando vão receber um reembolso por cancelamento.

Lista de categorias e lista de tags adicionadas às respostas da região – Geography | Feature |V3

Lista de categorias e lista de tags foram adicionadas a todas as respostas da região.

Exemplo de esquema da Rapid 3

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

Benefício:

Os parceiros vão poder usar as categorias e as tags para ter informações de metadados sobre a região retornada.

Rapid versão 2.3 e 2.4 desativados – Remove | V2.4 |Breaking Change

As versões 2.3 e 2.4 da Rapid API foram desativadas.

Configurações de unidade da Vrbo adicionadas ao conteúdo – Content | Feature |V3

Adicionado o objeto de configuração da unidade às respostas de conteúdo.

Exemplo de esquema da 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
                }
            }
        ]
    }
]

Benefício

Configurações de unidade descrevem os tipos de cama em um quarto e o número de cada tipo de cama no quarto.

Idioma chinês (Hong Kong) adicionado – Content | Shopping | Feature | V3

A opção de idioma "chinês (Hong Kong)" foi adicionada. O código de idioma "zh-HK" agora pode ser usado nas solicitações compatíveis com esse parâmetro de idioma.

Para ver uma lista dos idiomas disponíveis, clique aqui.

Informações essenciais sobre a estadia da Vrbo – Manage Booking | Feature | V3

Adicionadas informações essenciais de estadia da Vrbo às respostas do itinerário.

Exemplo de esquema da 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"
}

Benefício

O conteúdo essencial para a estadia da Vrbo contém informações importantes para viajantes, incluindo o endereço da propriedade e os dados de contato do administrador profissional. Pode incluir também outras informações necessárias a viajantes durante a chegada, a estadia ou a partida.

Mudança regulatória no New Deal For Consumers (ND4C) para todas as versões – Shopping | Booking | Manage Booking | Feature | V3 |Breaking Change

Alterações feitas na Rapid para lidar com o impacto do regulamento New Deal for Consumers (ND4C) nos seus negócios. Essa lei vai ter efeito sobre os pontos de venda na União Europeia e no Reino Unido.

Exemplo de esquema da 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"
}

Benefício

Fornece informações de comerciantes parceiros para cumprir os requisitos regulamentares do ND4C.

Idiomas croata e lituano desativados – Content | Shopping | Remove |V3

Os idiomas croata e lituano foram desativados. A tentativa de usar esses idiomas em uma solicitação que aceita o parâmetro de idioma vai resultar em erro.

Rapid versão 2.3 e 2.4 descontinuadas – Deprecated | V2.4 | Breaking Change

As versões 2.3 e 2.4 da Rapid API foram descontinuadas. Ambas as versões vão ser desativadas em outubro de 2022.

Rapid versão 2.2 desativada – Remove | V2.2 |Breaking Change

A versão 2.2 da Rapid API foi desativada.

Adicionado o corpo de solicitação à API de teste de notificações – Notifications | Change | V3 | Breaking Change

Agora o corpo de solicitação é obrigatório.

Exemplo de esquema da Rapid 3

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

Benefício

Garantir a consistência em toda a Rapid API.

Adicionado um parâmetro que não pode ser entregue à API de notificações não entregues – Notifications | Change | V3 | Breaking Change

Agora um novo parâmetro de consulta que não pode ser entregue é obrigatório.

Benefício

Garantir a consistência em toda a Rapid API.

Campos Refundable Damage Deposit e Card On File Limit movidos para consistência com Shop – Manage Booking | Change | V3 | Breaking Change

Os campos Refundable Damage Deposit e Card On File Limit foram movidos para manter a consistência com Shop.

Exemplo de esquema da Rapid 3

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

Benefício

Simplificar o esquema para os parceiros.

Alteração dos pontos de extremidade da API de notificações – Notifications | Change | V3 | Breaking Change

Os pontos de extremidade da API de teste de notificações e da API de notificações não entregues foram alterados (/{event_type} e /undeliverable ao final foram removidos). O ponto de extremidade da API de teste de notificações foi alterado de GET para POST.

Benefício

Garantir a consistência em toda a Rapid API.

Alteração de nome de Deposit Policy para Deposits para consistência com Shop – Manage Booking | Change | V3 | Breaking Change

O nome do objeto Deposit Policy foi alterado para Deposits a fim de manter a consistência com Shop.

Exemplo de esquema da Rapid 2.4

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

Exemplo de esquema da Rapid 3

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

Benefício

Simplificar o esquema para os parceiros.

Desativação do ponto de extremidade da API de conteúdo do TripAdvisor – Content | Deprecate | V3 | Breaking Change

O Expedia Group não tem mais relação com o TripAdvisor. Portanto, o ponto de extremidade da API de conteúdo do TripAdvisor será desativado.

Benefício

Os parceiros não vão poder chamar pontos de extremidade redundantes.

Adição do ID de fidelidade – Booking | Manage Booking | Feature | V3 | Breaking Change

Novo recurso que permite que os parceiros forneçam a ID de fidelidade do hotel.

• É um identificador de um programa de fidelidade de hotel associado ao hóspede desse quarto.
• Existe no objeto rooms.

Exemplo de esquema da Rapid 3

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

Nota O novo campo vai estar localizado em vários lugares.

• Criar solicitação de reserva
• Recuperação de itinerário
• Alteração de itinerário

Benefício

Permitir que os parceiros incluam o ID de fidelidade e transmitam essa informação ao hotel.

*Tem fins informativos. Não garante que o hotel vai oferecer pontos extras nem benefícios.

Adição de dados de depósito à resposta de disponibilidade da Rapid – Shopping | Feature | V3

Com a Rapid 3, nossos parceiros não vão mais precisar fazer uma ligação separada para receber informações sobre o depósito (calendário de pagamentos). Vamos mostrar esses dados como um filho do objeto Rate.

Além de acabar com a necessidade de fazer outra ligação para o depósito (calendário de pagamentos), vamos disponibilizar os dados na resposta priceCheck para aumentar a visibilidade.

Exemplo de esquema da Rapid 3

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

A Rapid 3 não vai mais precisar retornar um link para depósitos a fim de recuperar os dados correspondentes. Em vez disso, a informação vai ser buscada e exibida na resposta.

Exemplo de esquema da 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"
  }
}

Exemplo de esquema da Rapid 3

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

A Rapid 3 não vai mais retornar um campo deposit_required, já que ele não é necessário com a nova matriz de depósitos.

Exemplo de esquema da Rapid 2.4

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

Exemplo de esquema da Rapid 3

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

Benefício

Os parceiros não vão mais precisar fazer uma chamada adicional para consultar dados, pois eles vão ser incorporados na resposta.

Adição de suporte para card_on_file_limit e refundable_damage_deposit de aluguéis por temporada na resposta priceCheck – Shopping | Feature | V3

Adicionados outros dados relevantes para aluguéis por temporada. O elemento card_on_file_limit é o valor máximo que pode ser cobrado em um cartão por danos à propriedade, enquanto refundable_damage_deposit é o valor do depósito exigido pela propriedade. Apenas um valor vai estar disponível na resposta. Nunca vão ser retornados os dois valores ao mesmo tempo para um parceiro com uma tarifa determinada.

Exemplo de esquema da Rapid 3

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

Benefício

Os parceiros vão ter visibilidade completa dos depósitos e das expectativas dos aluguéis por temporada.

Adição do campo obrigatório supply_source à API/arquivo de conteúdo de propriedade e o arquivo de catálogo de propriedades – Content | Feature | V3 | Breaking Change

Um novo campo obrigatório supply_source foi adicionado à API/arquivo de conteúdo de propriedade e ao arquivo de catálogo de propriedades para permitir que os parceiros especifiquem o tipo de inventário que desejam retornar.

Se for passado um valor "expedia", será retornado apenas o inventário da Expedia.

Se for passado um valor "vrbo", vai ser retornado apenas o inventário da Vrbo.

Exemplo de esquema da Rapid 3

"supply_source": "vrbo"

Nota Agora supply_source é um campo obrigatório. Para ter o mesmo comportamento que as versões anteriores da API, os parceiros devem passar "supply_source": "expedia".

Benefício

Os parceiros vão poder acessar o inventário da Vrbo pelo mesmo ponto de extremidade que o inventário da Expedia.

Adição de uma nova seção à API/arquivo de conteúdo de propriedade que consolida as informações específicas sobre a propriedade e os quartos de aluguéis por temporada – Content | Feature | V3 | Breaking Change

Foi adicionada uma nova seção de aluguéis por temporada à API/arquivo de conteúdo da Rapid em que os parceiros podem encontrar informações sobre a propriedade específicas para aluguéis por temporada, como os atributos que normalmente seriam encontrados na descrição do quarto de uma propriedade com várias unidades.

A visualização do contrato de locação na página de pagamento do parceiro agora é um requisito de lançamento da Rapid para os aluguéis por temporada.

Exemplo de esquema da 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"
        }
    }
  }
}

Benefício

Fornecer mais detalhes sobre propriedade para melhorar a visualização dos aluguéis por temporada com apenas uma unidade, e tudo isso em uma seção específica sobre aluguéis por temporada em nossa resposta de conteúdo.

Autenticação de terceiros para PSD2 – Booking | Feature | V3 | Breaking Change

Novo produto que permite aos parceiros utilizar o provedor de serviços de pagamento preferencial para conformidade com PSD2.

Requer os parâmetros cavv, eci, three_ds_version e ds_transaction_id.

Exemplo de esquema da 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"
}

Benefício

Permitir que os parceiros utilizem o provedor de serviços de pagamento preferencial para conformidade com PSD2.

Adição de codificação de caracteres especiais para corrigir bugs de segurança – Booking | Bug Fix | V3 | Breaking Change

Os caracteres especiais em vários campos vão ser codificados de novo para evitar uma vulnerabilidade de segurança.

Benefício

Eliminar uma potencial vulnerabilidade de segurança.

Correção de um bug no cabeçalho do teste de verificação de preço – Shopping | Bug Fix | V3

O nome do cabeçalho de teste inválido para a chamada de verificação de preço foi alterado para ter um valor válido.

Exemplo de esquema da Rapid 2.4

--header "Test: matched"

Exemplo de esquema da Rapid 3

--header "Test: available"

Benefício

Permitir que o parceiro teste a sua integração com a verificação de preço de maneira mais detalhada.

Correção de erro de digitação na enumeração Customer_account_Details – Booking | Bug Fix | V3 | Breaking Change

Um erro de digitação na enumeração customer_account_details foi corrigido de "fido_authenticaton" para "fido_authentication".

Exemplo de esquema da 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
},

Exemplo de esquema da 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
},

Benefício:

Um erro de ortografia foi eliminado, o que poderia confundir os parceiros.

Removidas as recomendações de propriedades alternativas e venda cruzada – Recommendations | Remove | V3 | Breaking Change

Os parâmetros reference_property_id, destination_iata_airport_code, origin_iata_airport_code e iata_airline_code foram removidos. O link para as recomendações não vai ser mais exibido na resposta.

Exemplo de esquema da Rapid 2.4

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

Benefício

Os parceiros não vão poder fazer ligações com parâmetros de solicitação redundantes.

Remoção de campos desativados no objeto Fee – Shopping | Booking | Manage Booking | Remove | V3 | Breaking Change

O objeto Taxas foi simplificado removendo campos que eram informativos e causavam confusão na exibição de totais de taxas.

Exemplo de esquema da 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"
  }
}

Exemplo de esquema da Rapid 3

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

Benefício

Scope e frequency foram removidos para que fique mais claro quais taxas são cobradas. Isso remove campos desnecessários e simplifica o esquema para o parceiro.

Remoção do caminho /properties/{property_id}/deposit-policies – Shopping | Remove | V3

O ponto de extremidade deposit-policies vai ser removido porque agora faz parte direta da ligação de disponibilidade.

Benefício

Os parceiros não vão mais precisar fazer outra ligação para consultar informações sobre a política de depósitos.

Simplificação da descrição do código postal – Booking | Update | V3

A descrição do campo de código postal foi simplificada para que seja menos confusa.

Exemplo de esquema da Rapid 2.4

Código postal do cliente. Postal_Code é obrigatório se a forma de pagamento é cartão de crédito (CC, CCC, VCC) e o código de país é US, GB ou CA.

Exemplo de esquema da Rapid 3

Código postal/CEP.

Benefício

Esclarece quando o campo é obrigatório.

Simplificação da descrição de Rate Plan Count – Shopping | Update | V3

Simplificação da descrição de Rate Plan Count A descrição do campo Rate Plan Count foi atualizada para incluir os limites mínimo e máximo, e também para esclarecer o que esse campo tenta retornar (o melhor preço disponível).

Exemplo de esquema da Rapid 2.4

O número de tarifas a serem retornadas por propriedade. O preço da tarifa determina quais tarifas são retornadas, por exemplo, um rateplancount=4 vai retornar as 4 tarifas mais baixas, mas elas não são ordenadas em ordem crescente ou decrescente na resposta. A menor tarifa foi comprovada para fornecer a melhor taxa de conversão e, portanto, o valor de 1 é recomendado. O valor deve ser maior que 0.

Exemplo de esquema da Rapid 3

O número de tarifas a serem retornadas por propriedade. As tarifas com o melhor valor serão retornadas, por ex., rate_plan_count=4 vai retornar as 4 melhores tarifas, mas elas não são ordenadas em ordem crescente ou decrescente na resposta. Em geral, as tarifas mais baixas aparecem primeiro. O valor deve estar entre 1 e 250.

Benefício

Informar com maior clareza os valores que o campo aceita.

Simplificação da descrição de State Province Code – Booking | Update | V3

A descrição do campo State Province Code foi simplificada para que seja menos confusa.

Exemplo de esquema da Rapid 2.4

Código do estado ou da província de cliente. Obrigatório se country_code = US, AU ou CA.

Exemplo de esquema da Rapid 3

Código do estado/província de 2 ou 3 letras da Austrália, Canadá e EUA.

Benefício

Esclarece quando o campo é obrigatório.