Khái niệm & luồng dữ liệu đặt vé

Các trường dữ liệu cơ bản #

Để tích hợp đúng, đối tác cần hiểu mối quan hệ giữa product, package, price_rules và lines khi tạo booking.

• Product: là sản phẩm vé tham quan.
• Package: là gói bán cụ thể của sản phẩm, dùng package_id để đặt vé.
• Price period: mỗi package có các khoảng giá theo thời gian.
• Price rule: mỗi khoảng giá có nhiều dòng giá (ví dụ người lớn/trẻ em), mỗi dòng có price_rule_id và price.
• Create booking: lấy package_id từ package và lấy price_rule_id từ price_rules, sau đó gửi vào mảng lines.
• Tổng tiền: hệ thống tự tính theo công thức sum(quantity * price) từ các dòng lines hợp lệ.

Luồng tích hợp khuyến nghị #

1. Gọi API lấy sản phẩm để chọn product_id.
2. Gọi API chi tiết sản phẩm (hoặc packages) để lấy package_id và price_rule_id.
3. Gọi API tạo booking với product_id, package_id, date, lines, contact.
4. Gọi API lấy chi tiết booking để theo dõi trạng thái.
5. Khi cần xuất vé, gọi API issue theo bookingCode.