Orario fisso
Partenze esatte durante il giorno, come un tour alle 10:00 e un altro alle 15:00. Il cliente sceglie un orario preciso, non un intervallo.
Disponibilità
La disponibilità si calcola. Non si genera mai.
Niente pulsante "genera calendario" che qualcuno dimentica di premere, né migliaia di righe create per sicurezza. Ogni data che un cliente vede viene risolta al momento, a partire da regole, sia che tu chieda di domani o tra dieci anni.
- Al volo Ogni data viene calcolata al momento della richiesta, mai pre-generata
- 3 Modi di vendere il tempo: orario fisso, fascia oraria o giornata intera
- Il proprio fuso orario Il limite di prenotazione si calcola dove avviene l'esperienza, non sul server
Tre modi di vendere il tempo. Due modi di ripeterlo.
Un unico motore decide sia quando qualcuno entra sia con che frequenza si ripete, senza bisogno di una configurazione diversa per ogni caso.
Fascia oraria
Diverse finestre di arrivo al giorno, come "8:00-11:00" o "13:00-18:00". Il cliente sceglie la fascia, non un minuto esatto.
Giornata intera
Nessuna fascia oraria: il prodotto è aperto tutto il giorno, come un ingresso generale a un museo. Il cliente prenota la data, non un orario.
Ricorrente o date fisse
Un orario settimanale che si ripete senza fine, o un elenco breve di date esatte per un evento specifico, come un concerto.
Così si decide se una data è aperta
Cinque passaggi, esattamente in quest'ordine, ogni volta che qualcuno interroga il calendario.
- 1
Eccezione di calendario
C'è un'eccezione configurata per questo giorno esatto? Una chiusura puntuale o un orario speciale vincono sempre su qualsiasi regola ricorrente.
- 2
La regola ricorrente più specifica
Se non c'è eccezione, si cerca quale regola si applica a quel giorno della settimana. Se due regole si sovrappongono (una generale e una stagionale), vince la più specifica: quella con una propria data di inizio e fine.
- 3
Fasce orarie
La regola o l'eccezione restituisce i suoi orari, interpretati secondo la modalità di disponibilità dell'opzione: orario fisso, fascia o giornata intera.
- 4
Limite di prenotazione
Ogni fascia viene confrontata con il limite configurato, calcolato nel fuso orario del prodotto, mai in quello del server. Se quell'istante è già passato, la fascia smette di essere offerta anche se mancano ore a quell'orario locale.
- 5
Orizzonte di prenotazione
Se l'opzione ha un orizzonte di prenotazione (ad esempio 90 giorni), tutto ciò che supera quel limite non viene nemmeno calcolato.
Quello che vede il checkout è quello che vedi qui
La stessa richiesta che risolve il calendario risolve anche il prezzo finale, tasse incluse, e la capienza residua di ogni fascia. Non c'è un prezzo 'a partire da' non confermato a parte: è esattamente quello che usa il checkout per addebitare.
GET /api/v1/products/observation-deck/calendar
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
{
"date": "2026-08-14",
"is_open": true,
"min_price_display": "€42.00",
"slots": [
{
"start_time": "18:00",
"end_time": null,
"is_open": true,
"remaining_capacity": 12,
"min_price_display": "€42.00"
},
{
"start_time": "20:30",
"end_time": null,
"is_open": true,
"remaining_capacity": 4,
"min_price_display": "€48.00"
}
]
}200 Disponibilità risolta
Un concerto non può perdere il proprio giorno
Le date vengono sempre confrontate come testo di calendario ("2026-08-14"), mai come istanti assoluti. Confrontata come istante, un'opzione a "date fisse" (un concerto, per esempio) poteva smettere di risolversi come prenotabile proprio nel suo giorno esatto, a seconda di quale lato del fuso UTC si trovasse il prodotto. Abbiamo trovato quel caso, lo abbiamo documentato e chiuso con una batteria di test dedicata. Anche un prodotto senza fasce orarie (giornata intera) ha un vero limite di prenotazione: si ancora alla fine del giorno locale, non a un istante arbitrario.
Domande frequenti
Vince la più specifica. Se c'è una regola generale per ogni martedì e una stagionale che copre anche quel martedì con una propria data di inizio e fine, si applica quella stagionale. Le regole vengono ordinate per specificità prima di risolvere, quindi non importa quale sia stata creata prima.
Rispetto all'orario esatto della fascia, nel fuso orario proprio del prodotto. Una fascia delle 8:00 con due ore di anticipo smette di essere mostrata alle 6:01, calcolato dove avviene l'esperienza, non dove si trova il server. Per un prodotto senza fasce orarie, il limite si ancora alla fine del giorno locale.
No. Niente viene mai pre-generato o materializzato. Ogni richiesta calcola date e fasce al momento, a partire dalle regole ed eccezioni in vigore, così un orario configurato oggi funziona esattamente allo stesso modo tra dieci anni, senza alcuna manutenzione.
Sì. La stessa richiesta risolve il calendario, il prezzo finale con le tasse applicate e la capienza residua per fascia, usando il caso peggiore tra i tipi di biglietto che condividono la capienza. È esattamente quello che usa il checkout per addebitare, non una stima a parte.
Sì, con un'eccezione di calendario. Si può chiudere una data puntuale, come una festività, o darle un orario diverso, come un orario ridotto a Capodanno, senza modificare la regola ricorrente che governa il resto dell'anno.
Più prenotazioni. Più canali. La stessa calma.
Tiqory mantiene disponibilità, prezzi, pagamenti e accessi allineati mentre la tua operazione cresce. Dicci dove vuoi arrivare: ti mostriamo come farlo senza ricominciare da zero.