Skip to main content
Non ancora attivo. Qui è descritto il contratto definitivo, versione 1.0.0. Finché la sandbox non apre con la prima chiave di test, provalo su un mock del contratto (Test).
I prezzi seguono il gruppo di ospiti. Ogni notte di una tariffa porta il prezzo per ogni numero di adulti che la struttura accoglie, quanto aggiunge ogni bambino secondo la fascia d’età e quanto aggiunge un neonato, tutti come li paga l’ospite: il prezzo di qualsiasi soggiorno è una somma e non devi calcolare nessuna regola. Ogni importo è IVA inclusa, con il tuo ricarico applicato ai prezzi per notte e mai ai costi aggiuntivi.

​
Piani tariffari

Una struttura ha uno o più rate_plans, ognuno un modo di venderla con i suoi prezzi per notte e le sue regole:
  • meal_plan: none, breakfast, half_board, full_board oppure all_inclusive. Enumerazione aperta: accetta anche un valore che non conosci.
  • cancellation: refundable, free_until_days_before, penalty, penalty_percent e un text che Gridbeds genera da questi campi. Fanno fede i campi.
  • child_age_bands: le fasce d’età con cui il piano prezza i bambini.
  • lower_price_reasons: perché un ospite può pagare meno del prezzo che sommi.
Gridbeds non applica nessuna riduzione per la durata del soggiorno o per la prenotazione anticipata o all’ultimo momento. Una tariffa più bassa per un soggiorno più lungo o prenotato prima è un piano tariffario a sé, con i suoi prezzi per notte e le sue regole (min_stay, closed_to_arrival): offri ogni piano le cui regole ammettono il soggiorno, come fa il sito della struttura, e il più economico è il prezzo più basso che Gridbeds offre per quel soggiorno.

​
I prezzi di una notte

Ogni tariffa di una notte, in rates di una risposta di disponibilità, prezza tutto il gruppo:
  • I bambini per età. child_age_bands elenca le fasce del piano in ordine crescente, senza sovrapposizioni, ognuna {age_from, age_to} in anni compiuti da 0 a 17, estremi inclusi. Quando non è vuoto, chiedi all’ospite l’età di ogni bambino: un bambino la cui età non rientra in nessuna fascia non si può prenotare. Quando è vuoto, il piano prezza i bambini senza la loro età, con child_price.
  • I neonati. capacity.max_infants dice quanti neonati la struttura accoglie oltre a max_guests, in culla e senza occupare un letto. Un neonato è un ospite che la prenotazione dichiara come tale, di solito sotto i 2 anni; nella versione 1 la struttura non fissa un limite d’età.

​
Il prezzo di un soggiorno

Per un gruppo su un solo piano tariffario, il prezzo di un soggiorno è:
1

Ogni notte del soggiorno

Per ogni notte dall’arrivo fino alla partenza (esclusa): la voce di prices_by_occupancy per il numero di adulti, più per ogni bambino la voce di child_prices della sua fascia d’età (oppure child_price quando il piano non ha fasce), più infant_price per ogni neonato.
2

I costi pagati con la prenotazione

Poi ogni costo con included_in_price: false e payable_at: booking: una volta per per: stay, una volta per notte per per: night e una volta per ospite e per notte per per: guest_night. Nella versione 1 è il costo delle pulizie, una volta per soggiorno.
Questa somma è il prezzo del soggiorno che l’ospite prenota sul sito della struttura, IVA inclusa, qualunque parte ne chieda il piano tariffario come acconto. Non si aggiunge nient’altro e non si toglie niente. Quello che si paga in struttura si mostra accanto. Un costo con payable_at: property (nella versione 1, l’imposta di soggiorno, city_tax) si paga alla struttura durante il soggiorno e non fa parte di quel prezzo: il sito della struttura lo mostra accanto al prezzo, e così dovresti fare tu. Un costo con included_in_price: true è già nei prezzi per notte: mostralo e non aggiungere nulla. Gli addebiti che una struttura mette sul conto di un soggiorno per conto proprio durante il soggiorno (parcheggio, un resort fee, la colazione addebitata a notte) non sono pubblicati nella versione 1; non fanno parte nemmeno del prezzo sul sito della struttura, e si saldano in struttura.

​
Quando il preventivo della struttura è diverso

Il preventivo della struttura può differire dalla tua somma in quattro modi, e in nessun altro: Un’altra differenza resta finché il sito della struttura non chiederà l’età di ogni bambino e i neonati: il reindirizzamento porta solo il numero di adulti e di bambini (booking.url_template), quindi un gruppo con bambini su un piano che li prezza per fascia d’età lì viene prezzato senza le loro età, e i neonati del gruppo lì non vengono prezzati affatto. lower_price_reasons c’è sempre, ed è vuoto quando nessun ospite paga meno. Il suo unico valore oggi è promo_code: la struttura ha un codice promozionale che un ospite può ancora usare sul suo sito. Compare solo quando booking.method è redirect, perché solo un ospite mandato sul sito della struttura può digitarne uno. Di’ che il prezzo finale può essere più basso, e leggi allo stesso modo un motivo che non conosci. Un suo cambio è un property.updated con una versione più alta.

​
Costi aggiuntivi

fees elenca gli addebiti accanto ai prezzi per notte. La versione 1 pubblica cleaning e city_tax, ognuno al massimo una volta, e nessuno dei due porta il tuo ricarico. Ogni campo di un costo è sempre presente; uno che non si applica è null. Un costo delle pulizie ha sempre basis: fixed, un importo amount, per: stay e payable_at: booking:
Leggi prima basis. Un costo il cui basis non conosci lo mostri come pagabile in struttura quando payable_at è property, e non lo aggiungi mai al prezzo di un soggiorno.

​
L’imposta di soggiorno

L’imposta di soggiorno non viene mai omessa. Alcuni comuni la applicano come importo fisso per ospite e per notte, altri come percentuale del prezzo dell’alloggio, e gli importi cambiano per decisione locale. Ogni struttura dice in city_tax_status quale di tre casi è vero: Una struttura senza city_tax non vuol dire quindi mai che l’imposta non c’è, a meno che il suo city_tax_status sia none. Leggi uno stato che non conosci come undeclared. Un cambio è un property.updated con una versione più alta. Una city_tax si paga in struttura (payable_at: property) e non si aggiunge mai al prezzo di un soggiorno. Dice quello che si sa e niente di più:
  • basis: fixed, con un importo amount per ospite tassabile e per notte (per: guest_night). L’imposta di un soggiorno è amount × ospiti tassabili × notti, con le notti limitate a max_nights, arrotondata una sola volta all’unità minore della valuta. Gli ospiti tassabili sono gli adulti e i bambini, o solo gli adulti quando exempts_children è true, e mai i neonati. È il massimo che la struttura addebita: ogni altra esenzione che applica può solo abbassarlo. amount è l’aliquota in vigore alla data odierna della struttura; un soggiorno che inizia dopo l’entrata in vigore di una nuova aliquota paga quella nuova.
  • basis: percent, con percent_bp: una percentuale del prezzo dell’alloggio indicato da percent_of, per tutto il soggiorno (per: stay), o per le sue prime max_nights notti quando è impostato. La base è il prezzo dell’alloggio alle tariffe della struttura, senza il tuo ricarico e senza costi aggiuntivi, IVA esclusa o inclusa; i prezzi che ricevi includono l’IVA e il tuo ricarico, quindi la base non si può ricavare esattamente da questi. Gridbeds non calcola l’importo e non dovresti farlo neanche tu: mostra la percentuale come imposta locale da pagare in struttura. Le esenzioni da una percentuale non sono modellate: exempts_children è null, e la struttura applica le sue. Leggi un percent_of che non conosci come “il prezzo dell’alloggio”.
  • Un valore che non si conosce è null, e il costo resta nell’elenco. basis: fixed con amount: null, oppure basis: percent con percent_bp: null, dice che l’imposta esiste e come si calcola, ma non quanto è. basis: null, con per, amount e percent_bp null, dice solo che si applica un’imposta di soggiorno. Mostra un costo così come imposta locale da pagare in struttura, mai come zero.
Il minimo che una city_tax può dire: