Kā sinhronizēt savu rezervāciju kalendāru ar Airbnb un Booking.com, izmantojot iCal

Dubulto rezervāciju problēma

Ja Jūsu naktsmītne ir publicēta vairākās platformās, visticamāk, esat piedzīvojis dubulto rezervāciju murgu. Viens viesis rezervē Airbnb, kamēr otrs rezervē tos pašus datumus Booking.com. Risinājums? iCal sinhronizācija.

iCal (iCalendar) ir universāls kalendāra formāts (.ics faili), ko tādas platformas kā Airbnb un Booking.com izmanto pieejamības datu apmaiņai. Izveidojot un importējot šīs kalendāra plūsmas, visas platformas saglabājas sinhronas — divos virzienos.

Kā mēs to izveidojām

Eksportējiet savas rezervācijas kā iCal plūsmu

Mūsu sistēma katrai naktsmītnei piedāvā .ics galapunktu. Tas ģenerē standarta VCALENDAR ar VEVENT ierakstiem katrai apstiprinātai rezervācijai — izmantojot DTSTART un DTEND kā VALUE=DATE ar SUMMARY “Booked”. Airbnb un Booking.com abonē šo URL un periodiski iegūst Jūsu pieejamības datus.

Importējiet kalendārus no Airbnb un Booking.com

Abas platformas savās īpašuma iestatījumos piedāvā iCal eksporta URL. Mēs izveidojām pielāgotu iCal parsētāju — ārēja bibliotēka nav nepieciešama —, kas apstrādā rindu atritināšanu, abus DATE un DATE-TIME formātus un uzticami izņem VEVENT datus.

Mūsu funkcija syncCalendar() iegūst katru plūsmu un veic rezervāciju upsert: izveido jaunas, atjaunina mainītos datumus, atjauno atceltas rezervācijas, kas parādās atkal, un atzīmē izņemtos notikumus kā atceltus. Tas nodrošina, ka Jūsu vietējā pieejamība vienmēr atspoguļo realitāti.

Automatizējiet sinhronizāciju ar cron darbiem

Mēs darbinām Vercel Cron uzdevumu ik pēc 15 minūtēm, kas izsauc mūsu /api/cron/sync-calendars galapunktu (aizsargāts ar CRON_SECRET bearer marķieri). Tas apstrādā visus iespējotos kalendārus ar paralēlisma ierobežojumu 5, lai nepārslogotu ārējos API. Panelis arī piedāvā manuālu pogu “Sinhronizēt tagad” atsvaidzināšanai pēc pieprasījuma.

Sekojiet sinhronizācijas statusam katram kalendāram

Katrs ārējais kalendārs tiek glabāts tabulā ical_calendars, kas seko platformai (Airbnb, Booking.com vai cits), plūsmas URL, pēdējās sinhronizācijas laika zīmogam, sinhronizācijas statusam un kļūdām. Tas padara sinhronizācijas problēmu atrašanu administratora panelī viegli paveicamu.

Galvenie apsvērumi

Pārklāšanās apstrāde: parsējot ārējās plūsmas, pārbaudiet daļējus pārklājumus, ne tikai precīzas datumu sakritības
Laika joslas apziņa: pirms pieejamības salīdzināšanas datumus normalizējiet uz UTC
Upsert loģika: ne tikai izveidojiet rezervācijas, bet arī korekti apstrādājiet atjauninājumus un atcelšanas
Kļūdu izturība: katram kalendāram reģistrējiet sinhronizācijas kļūdas un atkārtojiet nākamajā intervālā, nevis cietot klusu kļūmi

Info

iCal sinhronizācija nenotiek reāllaikā — vienmēr pastāv īss logs, kurā teorētiski iespējamas dubultās rezervācijas. Lielākajai daļai īpašumu 15 minūšu sinhronizācijas intervāls šo risku samazina līdz gandrīz nullei. Augsta pieprasījuma īpašumiem apsveriet iCal kombinēšanu ar kanālu pārvaldnieku API.

Rezultāts

Ar divvirzienu iCal sinhronizāciju, kas darbojas ik pēc 15 minūtēm, mūsu klienti redz precīzu pieejamību savā vietnē, Airbnb un Booking.com — un dubultās rezervācijas ir pagātne.