Inclusões dos planos de refeições
Entenda melhor como as inclusões dos planos de refeições são retornadas na API.
Como as inclusões dos planos de refeições são retornadas na API
Os planos de refeições podem ser retornados em diferentes níveis, e isso influencia bastante o que eles significam. Eles podem ser retornados como comodidades da tarifa ou da propriedade, como conteúdo ou, em alguns casos, como promoções de valor agregado. Para ver todas as tarifas e comodidades da propriedade, consulte as listas de referência de conteúdo.
Comodidades do plano tarifário
Observação: as comodidades da tarifa também aparecem na resposta de conteúdo. No entanto, para ver as informações mais atualizadas sobre elas, parceiros devem consultar a inclusão de refeições e outras comodidades da tarifa na resposta de compras, e não na de conteúdo.
Nas listas de referência de conteúdo, elas aparecem em amenities_rates.
Algumas opções comuns:
- 1073742786 - Café da manhã grátis
- 2194 - Café da manhã para 2 pessoas
- 2205 - Buffet de café da manhã
- 2206 - Meia-pensão
- 2111 - Tudo incluído
As comodidades do plano de tarifas podem ser vistas na resposta de Disponibilidade Rápida. As refeições estão incluídas para todos os hóspedes na reserva, a menos que haja uma instrução em contrário. As instruções podem ser retornadas no nome da comodidade (por exemplo, 'Café da manhã para 2'), nome do tipo de quarto, descrição do hotel ou descrição da tarifa. Consulte a seção Valores agregados especiais abaixo para obter mais detalhes.
"amenities": {
"1073742857": {
"id": "1073742857",
"name": "Breakfast for 1"
},
"1073742617": {
"id": "1073742617",
"name": "Disney park tickets"
},
"2192": {
"id": "2192",
"name": "Free WiFi"
}
},As comodidades do plano tarifário também aparecem na resposta de recuperação de itinerário da Rapid:
"rate": {
"id": "384339493",
"merchant_of_record": "expedia",
"refundable": true,
"amenities": [
"2109",
"2192",
"1073742786"
],Comodidades da propriedade
Nas listas de referência de conteúdo, elas aparecem em amenities_property.
As comodidades da propriedade aparecem na resposta de conteúdo da Rapid:
"amenities": {
"2387": {
"id": "2387",
"name": "Tours/ticket assistance"
},
"4467": {
"id": "4467",
"name": "Beach towels"
},
"56": {
"id": "56",
"name": "Airport transportation (surcharge)"
},
"4003": {
"id": "4003",
"name": "Luggage storage"
},
"2001": {
"id": "2001",
"name": "Free breakfast"
},
"2386": {
"id": "2386",
"name": "Grocery/convenience store"
}
},A comodidade do estabelecimento, café da manhã gratuito (atributo 2001), significa que um café da manhã de cortesia está incluído em todos os quartos e planos de tarifas da propriedade. Isso é replicado no nível da tarifa na resposta de compras da Rapid como 1073742786 "café da manhã grátis".
Observação: Ao contrário das comodidades do plano de tarifas, que mostram o que está incluído no plano de tarifas, as comodidades da propriedade mostram o que está disponível na propriedade e não são necessariamente gratuitas. Por exemplo, atributo 361 'café da manhã disponível (sobretaxa)'.
Tudo incluído
As propriedades podem ter alguns ou todos os planos tarifários com tudo incluído. Esses detalhes estão na seção all_inclusive da resposta de conteúdo da Rapid.
Todos os planos tarifários têm tudo incluído
Se all_rate_plans: true, então todos os planos tarifários da propriedade têm tudo incluído, mesmo que não exista nenhuma comodidade do plano tarifário "tudo incluído".
"all_inclusive": {
"all_rate_plans": true,
"details": "This property is all-inclusive. Onsite food and beverages are included in the room price (some restrictions may apply). <strong>Gratuities and taxes</strong>
Gratuities and taxes are included. Additional gratuities at guests' discretion are accepted. <strong>Food and beverages</strong><ul><li>All buffet and à la carte meals, snacks, and beverages included</li><li>In-room minibar (some restrictions)</li><li>Limited gourmet or à la carte dining</li></ul> <strong>Activities and facilities/equipment</strong>
All non-motorized water sports, land activities, and use of recreational facilities and equipment are included.
Water activities<ul><li>Snorkeling</li><li>Windsurfing</li></ul>
Land activities<ul><li>Bicycling</li><li>Fitness facilities</li><li>Tennis</li><li>Tennis lessons</li><li>Volleyball</li><li>Access to golf course</li></ul>
Lessons/classes/games <ul><li>Aerobics</li><li>Dancing</li><li>Language</li></ul> <strong>Kids' club</strong><ul><li>Supervised activities for children between 4 and 12 years old</li></ul> <strong>Not included</strong><ul><li>Golf green fees</li><li>Use of golf cart</li><li>Use of golf equipment</li><li>Motorized water sports</li><li>Scuba-diving certification</li><li>Tennis racquets</li><li>Premium food items</li><li>Premium/non-domestic alcoholic beverages</li><li>Childcare</li><li>Spa/beauty facilities and services</li></ul>",
"some_rate_plans": false
},)Outros indicadores de que todos os planos tarifários têm tudo incluído são “tudo incluído” no nome da propriedade. O Expedia Group não vende uma propriedade com "tudo incluído" no nome, a menos que todos os planos de tarifas sejam "tudo incluído" para essa propriedade. Além disso, a categoria de propriedade na resposta de conteúdo pode aparecer como categoria de propriedade 8: "Propriedade com tudo incluído". Veja uma lista completa de categorias de propriedades aqui.
Alguns planos tarifários têm tudo incluído
Se some_rate_plans: true, então os planos tarifários com tudo incluído têm a comodidade do plano tarifário 2111 "tudo incluído". O nome do hotel não vai ter "tudo incluído", e a categoria da propriedade não vai ser "propriedade com tudo incluído".
Restrições de planos com tudo incluído
Existem restrições para planos com tudo incluído. Por exemplo, quando as bebidas alcoólicas não estão incluídas no plano tarifário, isso aparece no valor de details da resposta all_inclusive.
Exemplo:
"all_inclusive": {
"all_rate_plans": false,
"details": "<em>All-inclusive</em> room rates at Solymar Naama Bay are available. These rates are higher because they include onsite food and beverages in the room rate (some restrictions may apply). <strong>Gratuities and taxes</strong>
Gratuities and taxes are included. Additional gratuities at guests' discretion are accepted. <strong>Food and beverages</strong><ul><li>Buffet meals, snacks, and select beverages included</li><li>Basic alcoholic beverages included</li><li>Dining availability limited at one or more venues</li></ul> <strong>Activities and facilities/equipment</strong>
Lessons/classes/games <ul><li>Dancing</li></ul> <strong>Entertainment</strong><ul><li>Onsite entertainment and activities</li></ul> <strong>Not included</strong><ul><li>Motorized water sports</li><li>Premium/non-domestic alcoholic beverages</li><li>Activities and services offered by independent operators</li></ul>",
"some_rate_plans": truePromoções de valor agregado
A inclusão de refeições também pode, em alguns casos, aparecer na resposta de compras como uma promoção de valor agregado.
Exemplo:
"promotions": {
"value_adds": {
"287248": {
"id": "287248",
"description": "Free dinner for 2 per day",
"category": "food_and_beverage",
"offer_type": "free",
"frequency": "per_day",
"person_count": 2
}
}
}As promoções de valor agregado também aparecem na resposta de recuperação de itinerário da Rapid.
Exemplo:
"rate": {
"id": "209136450",
"merchant_of_record": "expedia",
"refundable": true,
"amenities": [
"2192"
],
"promotions": {
"value_adds": {
"279553": {
"id": "279553",
"description": "Free continental breakfast for 2 per day",
"category": "food_and_beverage",
"offer_type": "free",
"frequency": "per_day",
"person_count": 2
}
}
},Valores agregados especiais
Os planos de tarifas que fazem parte de uma oferta especial podem ter conteúdo por nível de tarifa e por propriedade que inclui informações adicionais e restrições à oferta. Eles são listados nos campos de texto livre rates.special_offer_description, checkin.special_instructions ou policies.know_before_you_go que são retornados na resposta de conteúdo.
Há uma variedade de políticas que podem ser aplicadas aos valores agregados. Alguns exemplos incluem:
- Sobretaxas adicionais para alguns clientes, por exemplo, com base no número real de viajantes, idade do viajante ou configuração de compartilhamento de cama.
- Não há bebidas incluídas nos planos de refeições gratuitas.
- É necessário fazer reserva para obter o horário
breakfastLimited, por exemplo, o café da manhã só está disponível em determinados horários ou em dias específicos. - Nacionalidade restrita.
- Local especial para refeições, por exemplo, um restaurante fora da propriedade.
- Tipo especial de comida, por exemplo, somente vegetariana.
Exemplo:
{
"12345": {
"property_id": "12345",
...
"checkin": {
"begin_time": "3:00 PM",
"end_time": "midnight",
"instructions": "<ul> <li>Extra-person charges may apply and vary depending on property policy</li><li>Government-issued photo identification and a credit card or cash deposit may be required at check-in for incidental charges</li><li>Special requests are subject to availability upon check-in and may incur additional charges; special requests cannot be guaranteed</li><li>This property accepts credit cards; cash is not accepted</li><li>Safety features at this property include a smoke detector</li><li>Please note that cultural norms and guest policies may differ by country and by property; the policies listed are provided by the property</li> </ul>",
"special_instructions": "This property doesn't offer after-hours check-in. Front desk staff will greet guests on arrival. For more details, please contact the property using the information on the booking confirmation. Additional fees apply to children 0 to 12 years old for breakfast. Breakfast is not included in the breakfast rate plans for children ages 6-12, and can be requested onsite for the listed child breakfast fee.",
"min_age": 18
},
...
"policies": {
"know_before_you_go": "<ul> <li>Up to 2 children 5 years old and younger stay free when occupying the parent or guardian's room, using existing bedding. </li><li>The Japanese Ministry of Health, Labour, and Welfare requires all international visitors to submit their passport number and nationality when registering at any lodging facility (inns, hotels, motels, etc. ). Additionally, lodging proprietors are required to photocopy passports for all registering guests and keep the photocopy on file. </li> </ul>"
},
...
"rates": {
"201510380": {
"id": "201510380",
"amenities": { ... },
"special_offer_description": "<strong>Stay for Breakfast</strong> Book a stay in this rate plan and receive breakfast for 2 adults and children under 12 years old registered in the same room. <em>Full details at check-in. Restrictions may apply.</em>"
}
}
}
}