Формат інтеграції
Формат Superhostem ICS
Використовуйте цей профіль iCalendar, коли зовнішній системі потрібно імпортувати бронювання безпосередньо в Superhostem. Він суворіший за звичайні календарі блокування, тому що кожна подія повинна мати стабільний зовнішній ID бронювання і контактні дані гостя.
Цей формат використовується для імпорту ваших ICS-даних бронювань у Superhostem, включно із зовнішніми ID, контактними даними гостя, датами, кількістю гостей і необов'язковою ціною бронювання.
Superhostem ICS є авторитетним джерелом даних. Коли подія з тим самим external ID змінюється, Superhostem оновлює наявне бронювання. Коли подію позначено як видалену, Superhostem м'яко скасовує бронювання. External ID не можна використовувати повторно.
Повний приклад iCalendar
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Your System//Superhostem ICS 1.0//EN
X-SUPERHOSTEM-FORMAT:1
BEGIN:VEVENT
UID:booking-123@example.com
X-SUPERHOSTEM-EXTERNAL-ID:booking-123
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Обов'язкові поля події
- UID
- Дійсний iCalendar UID.
- X-SUPERHOSTEM-EXTERNAL-ID
- Обов'язковий унікальний ID бронювання. Він має бути стабільним між синхронізаціями та унікальним у межах feed.
- DTSTART;VALUE=DATE
- Дата заїзду у форматі YYYYMMDD. Якщо надсилаєте DATE-TIME замість VALUE=DATE, додайте суфікс UTC Z або TZID, наприклад DTSTART;TZID=Europe/Prague:20260901T150000.
- DTEND;VALUE=DATE
- Дата виїзду у форматі YYYYMMDD. Якщо надсилаєте DATE-TIME замість VALUE=DATE, додайте суфікс UTC Z або TZID, наприклад DTEND;TZID=Europe/Prague:20260905T100000.
- SUMMARY
- Коротка зрозуміла назва. Superhostem використовує ім'я основного гостя з DESCRIPTION для даних бронювання.
Поля в DESCRIPTION
- Primary guest name
- Обов'язкове ім'я основного гостя.
- Primary guest email
- Обов'язковий email основного гостя для процесів підтвердження та реєстрації.
- Primary guest phone
- Необов'язковий телефон основного гостя.
- Guests
- Необов'язкове додатне ціле число.
- Total price
- Необов'язкова загальна ціна бронювання як число.
- Currency
- Необов'язковий ISO-код валюти. За замовчуванням CZK, якщо вказано Total price.
- Status: deleted
- Необов'язковий маркер видалення. Залиште той самий external ID і встановіть Status: deleted, Status: cancelled, Deleted: true, Cancelled: true або Canceled: true, щоб м'яко скасувати бронювання в Superhostem.
Приклад 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Повний приклад iCalendar
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Your System//Superhostem ICS 1.0//EN
X-SUPERHOSTEM-FORMAT:1
BEGIN:VEVENT
UID:booking-123@example.com
X-SUPERHOSTEM-EXTERNAL-ID:booking-123
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Приклад DESCRIPTION для видаленого бронювання
External ID: booking-123
Status: deleted