Quy trình tạo booking (B2B / Agency)

Sơ đồ dưới đây mô tả quy trình đặt vé dành cho Đại lý/Đối tác sử dụng hạn mức công nợ.

Các bước chi tiết

Kiểm tra công nợ (Tùy chọn): Đại lý có thể gọi API /api/v1/debt-info để tự kiểm tra hạn mức còn lại. Đây là bước hỗ trợ đại lý chủ động quản lý dòng tiền. Xem chi tiết API.
Lấy danh sách vé: Gọi API /api/v1/sale-packages để lấy danh sách các dịch vụ và giá áp dụng riêng cho đại lý. Xem chi tiết API.
Tạo Booking nháp: Đại lý tạo một booking ở trạng thái chờ (BOOKING). Ở bước này, hệ thống sẽ tự động kiểm tra công nợ, nếu vượt quá hạn mức hoặc quá hạn thanh toán, hệ thống sẽ trả về lỗi và chặn không cho tạo booking. Xem chi tiết API.
Xác nhận đặt vé: Đại lý gọi API /api/v1/confirm-booking để chính thức chốt đơn hàng. Lúc này hệ thống sẽ thực hiện trừ hạn mức công nợ thực tế và trả về danh sách mã vé (QR Code). Xem chi tiết API.

Đại lý có thể chủ động hủy booking khi khách hàng thay đổi ý định hoặc khi booking đã hết hạn (timeout) mà chưa được xác nhận.

Hủy booking: Gọi API /api/v1/cancel-booking với booking_id và lý do hủy. Hệ thống sẽ giải phóng các chỗ đã giữ và cập nhật trạng thái đơn hàng về CANCEL. Xem chi tiết API.

Lưu ý

Đối với quy trình B2B, hệ thống Booking Engine sẽ tự động kiểm tra và chặn giao dịch nếu tài khoản đại lý không đủ điều kiện công nợ. Việc gọi API kiểm tra công nợ chỉ nhằm mục đích giúp đại lý tra cứu thủ công khi cần.
Booking nháp nếu không thực hiện Xác nhận trong vòng 60 phút sẽ tự động chuyển sang trạng thái BOOKING_TIMEOUT. :::