Định dạng tích hợp

Định dạng Superhostem ICS

Dùng hồ sơ iCalendar này khi hệ thống bên ngoài cần nhập đặt phòng trực tiếp vào Superhostem. Định dạng này chặt chẽ hơn lịch chặn thông thường vì mỗi sự kiện phải có ID đặt phòng bên ngoài ổn định và thông tin liên hệ của khách.

Định dạng này dùng để nhập dữ liệu đặt phòng ICS của bạn vào Superhostem, bao gồm ID bên ngoài, thông tin liên hệ của khách, ngày lưu trú, số khách và giá đặt phòng tùy chọn.

Superhostem ICS là nguồn dữ liệu có thẩm quyền. Khi sự kiện có cùng external ID thay đổi, Superhostem cập nhật đặt phòng hiện có. Khi sự kiện được đánh dấu đã xóa, Superhostem hủy mềm đặt phòng. Không bao giờ được tái sử dụng external ID.

Ví dụ iCalendar đầy đủ

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

Trường sự kiện bắt buộc

UID: UID iCalendar hợp lệ.
X-SUPERHOSTEM-EXTERNAL-ID: ID đặt phòng duy nhất bắt buộc. ID phải ổn định giữa các lần đồng bộ và duy nhất trong feed.
DTSTART;VALUE=DATE: Ngày nhận phòng theo định dạng YYYYMMDD. Nếu gửi DATE-TIME thay vì VALUE=DATE, hãy thêm hậu tố UTC Z hoặc TZID, ví dụ DTSTART;TZID=Europe/Prague:20260901T150000.
DTEND;VALUE=DATE: Ngày trả phòng theo định dạng YYYYMMDD. Nếu gửi DATE-TIME thay vì VALUE=DATE, hãy thêm hậu tố UTC Z hoặc TZID, ví dụ DTEND;TZID=Europe/Prague:20260905T100000.
SUMMARY: Tiêu đề ngắn dễ đọc. Superhostem dùng tên khách chính từ DESCRIPTION cho dữ liệu đặt phòng.

Trường trong DESCRIPTION

Primary guest name: Tên khách chính bắt buộc.
Primary guest email: Email khách chính bắt buộc cho quy trình nhận đặt phòng và đăng ký.
Primary guest phone: Số điện thoại khách chính tùy chọn.
Guests: Số nguyên dương tùy chọn.
Total price: Tổng giá đặt phòng tùy chọn dưới dạng số.
Currency: Mã tiền tệ ISO tùy chọn. Mặc định là CZK khi có Total price.
Status: deleted: Dấu xóa tùy chọn. Giữ nguyên external ID và đặt Status: deleted, Status: cancelled, Deleted: true, Cancelled: true hoặc Canceled: true để hủy mềm đặt phòng trong Superhostem.

Ví dụ DESCRIPTION dạng văn bản thuần

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

Ví dụ iCalendar đầy đủ

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

Ví dụ DESCRIPTION cho đặt phòng đã xóa

External ID: booking-123
Status: deleted