Integrační formát

Formát Superhostem ICS

Importujte rezervace a blokace dostupnosti z externího systému. Každá událost potřebuje stabilní externí ID a data. Rezervace vyžadují kontaktní údaje hosta; blokace je nepotřebují.

Tento formát slouží k importu vašich ICS dat rezervací do Superhostem, včetně externích ID, kontaktních údajů hosta, termínů, počtu hostů a volitelné ceny rezervace.

Superhostem ICS je autoritativní zdroj dat. Když se změní událost se stejným externím ID, Superhostem aktualizuje existující rezervaci. Když je událost označená jako smazaná, Superhostem rezervaci stornuje bez hard delete. Externí ID se nesmí nikdy znovu použít.

Kompletní iCalendar příklad

BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Your System//Superhostem ICS 2.0//EN
X-SUPERHOSTEM-FORMAT:2
BEGIN:VEVENT
UID:booking-123@example.com
X-SUPERHOSTEM-EXTERNAL-ID:booking-123
X-SUPERHOSTEM-SOURCE:Booking.com
DTSTART;VALUE=DATE:20260901
DTEND;VALUE=DATE:20260905
SUMMARY:Jane Doe
DESCRIPTION:External ID: booking-123\nPrimary guest name: Jane Doe\nPrimary guest email: jane@example.com\nPrimary guest phone: +420777111222\nGuests: 2\nTotal price: 12500\nCurrency: CZK
END:VEVENT
END:VCALENDAR

Povinná pole události

UID: Platné iCalendar UID.
X-SUPERHOSTEM-EXTERNAL-ID: Jedinečné stabilní ID události pro rezervace i blokace. Nikdy jej nepoužívejte znovu. Podporován je i starší alias SUPERHOSTEM-EXTERNAL-ID.
DTSTART;VALUE=DATE: Datum příjezdu ve formátu YYYYMMDD. Pokud místo VALUE=DATE posíláte DATE-TIME, přidejte buď UTC koncovku Z, nebo TZID, například DTSTART;TZID=Europe/Prague:20260901T150000.
DTEND;VALUE=DATE: Datum odjezdu ve formátu YYYYMMDD. Pokud místo VALUE=DATE posíláte DATE-TIME, přidejte buď UTC koncovku Z, nebo TZID, například DTEND;TZID=Europe/Prague:20260905T100000.
SUMMARY: Krátký lidsky čitelný název. Superhostem pro data rezervace používá primární jméno hosta z DESCRIPTION.

Pole v DESCRIPTION

Primary guest name: Povinné jméno hlavního hosta u rezervací; u blokací není povinné.
Primary guest email: Povinný e-mail hlavního hosta pro převzetí rezervace a registraci; u blokací není povinný.
Primary guest phone: Volitelný telefon primárního hosta.
Guests: Volitelné kladné celé číslo.
Total price: Volitelná celková cena rezervace jako číslo.
Currency: Volitelný ISO kód měny. Pokud je vyplněná Total price, výchozí hodnota je CZK.
Status: deleted: Volitelný marker smazání. Ponechte stejné externí ID a nastavte Status: deleted, Status: cancelled, Deleted: true, Cancelled: true nebo Canceled: true. Rezervace se v Superhostem stornuje bez hard delete.

Aktuální profil: X-SUPERHOSTEM-FORMAT:2. Podporovány zůstávají i zdroje verze 1. iCalendar VERSION zůstává 2.0.

Blokace dostupnosti

Použijte X-SUPERHOSTEM-TYPE:BLOCK se stabilním externím ID a platnými daty. Jméno ani e-mail hosta nejsou povinné. DTEND je výlučný konec: 1.–4. prosince blokuje noci 1., 2. a 3. prosince. Rozpoznáváme i starší události s externím ID začínajícím block- a Guests: 0, včetně aliasu SUPERHOSTEM-EXTERNAL-ID. Blokace ukládáme odděleně od rezervací a nespouštějí registraci hostů, e-maily ani kódy chytrých zámků. Úspěšná synchronizace odstraní blokace chybějící ve zdroji; Status: deleted odstraní jednotlivou blokaci. Kalendář v administraci je zobrazuje; export iCal je zahrne pouze při zapnutí Zahrnout blokované termíny.

Původní zdroj rezervace

U každé rezervace můžete zadat X-SUPERHOSTEM-SOURCE:Airbnb nebo X-SUPERHOSTEM-SOURCE:Booking.com. Podporovány jsou i řádky Source: nebo Portal: v DESCRIPTION. Airbnb, Booking.com a e-chalupy používají označení své platformy; jiné názvy zdrojů zachováme. Bez zdroje je rezervace označena Superhostem. Kalendář zůstává propojený přes Superhostem ICS bez ohledu na původní platformu.

Blokace dostupnosti

BEGIN:VEVENT
UID:block-123@example.com
X-SUPERHOSTEM-EXTERNAL-ID:block-123
X-SUPERHOSTEM-TYPE:BLOCK
DTSTART;VALUE=DATE:20281201
DTEND;VALUE=DATE:20281204
SUMMARY:Soukromá blokace
DESCRIPTION:External ID: block-123\nGuests: 0
STATUS:CONFIRMED
END:VEVENT

Plain text příklad DESCRIPTION

External ID: booking-123
Primary guest name: Jane Doe
Primary guest email: jane@example.com
Primary guest phone: +420777111222
Guests: 2
Total price: 12500
Currency: CZK

Kompletní iCalendar příklad

BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Your System//Superhostem ICS 2.0//EN
X-SUPERHOSTEM-FORMAT:2
BEGIN:VEVENT
UID:booking-123@example.com
X-SUPERHOSTEM-EXTERNAL-ID:booking-123
X-SUPERHOSTEM-SOURCE:Booking.com
DTSTART;VALUE=DATE:20260901
DTEND;VALUE=DATE:20260905
SUMMARY:Jane Doe
DESCRIPTION:External ID: booking-123\nPrimary guest name: Jane Doe\nPrimary guest email: jane@example.com\nPrimary guest phone: +420777111222\nGuests: 2\nTotal price: 12500\nCurrency: CZK
END:VEVENT
END:VCALENDAR

Příklad DESCRIPTION pro smazanou rezervaci

External ID: booking-123
Status: deleted