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 tarifário aparecem na resposta de disponibilidade da Rapid. A menos que um número seja especificado, como em "Café da manhã para 2 pessoas", a refeição deve ser incluída para todos os hóspedes na reserva.
"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 da propriedade 2001 "café da manhã grátis" significa que um café da manhã de cortesia está incluído em todos os quartos e planos tarifários da propriedade. Isso é replicado no nível da tarifa na resposta de compras da Rapid como 1073742786 "café da manhã grátis". É importante observar que, ao contrário das comodidades do plano tarifário, que mostram o que está incluído nele, as comodidades da propriedade mostram o que está disponível nela, mas não é necessariamente gratuito, por exemplo: 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 se nem todos os planos tarifários têm 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 tarifários que fazem parte de uma oferta especial podem ter conteúdo no nível da tarifa que inclui informações adicionais e restrições da oferta. Isso aparece no campo de texto livre special_offer_description retornado na resposta de conteúdo.
Exemplo:
"201510380": {
"id": "201510380",
"amenities": {
"2191": {
"id": "2191",
"name": "Free high-speed internet"
},
"2194": {
"id": "2194",
"name": "Breakfast for 2"
},
"2109": {
"id": "2109",
"name": "Free self parking"
},
"2192": {
"id": "2192",
"name": "Free WiFi"
}
},
"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>"
},