Quản lý hãng xe
Trang này dành cho tổng đài viên CS thiết lập hãng xe — các hãng taxi, hãng xe (hoặc chi nhánh của hãng) dùng để đặt chuyến trong CS Dispatch Portal. Bạn dùng chính tài khoản quản trị hệ thống đang dùng cho portal.
Hãng xe quyết định chuyến được đặt và thanh toán thế nào: giá có biết trước hay không, hệ thống có tự đặt qua API hay không, hãng chạy những loại xe nào, và phục vụ ở đâu.
1. Mở danh sách hãng
Ở màn hình Yêu cầu đặt xe, bấm Hãng xe (góc trên bên phải). Bảng hãng hiển thị:
- N hãng · N đang hoạt động ở đầu bảng.
- Ô tìm kiếm — tên, mã, liên hệ hoặc merchant.
- Bộ lọc: Tất cả, Đang hoạt động, Ngừng hoạt động.
Mỗi dòng hãng hiển thị cách tính giá (Trả sau · đồng hồ hoặc Trả trước), nhãn API Xanh SM khi hãng đặt qua API, Ngừng hoạt động khi hãng đã tắt, thông tin liên hệ, và merchant XPay đã gắn — hoặc "Chưa gắn merchant XPay, cần gắn trước khi sửa hãng".
Bấm vào một dòng để sửa hãng, hoặc bấm Thêm hãng để tạo mới.
2. Thêm hãng
Merchant XPay (bắt buộc, chọn trước tiên)
Hãng nào cũng phải gắn với một merchant XPay:
- Với hãng Trả sau · đồng hồ, sub-account của merchant chính là tài xế — dùng để gửi cuốc cho tài xế XPay và kiểm tra tài xế khi đặt xe.
- Với hãng Trả trước, chuyến CS hoàn tất được trả cho merchant này.
Tìm theo tên, email hoặc SĐT, hoặc dán ID merchant. Merchant bị tạm khoá có nhãn Tạm khoá. Chọn merchant sẽ tự điền Tên hãng và Mã hãng — cả hai vẫn sửa được. Nếu merchant đang là đội tài xế của một hãng khác, form sẽ báo là hãng nào.
Thông tin hãng
| Trường | Quy định |
|---|---|
| Tên hãng | Bắt buộc (VD: Mai Linh Quận 1) |
| Mã hãng | Bắt buộc. 2–64 ký tự: chữ thường, số, _ hoặc -, bắt đầu bằng chữ hoặc số. Không được trùng. Không đổi được sau khi tạo. |
Cách tính giá
| Lựa chọn | Ý nghĩa |
|---|---|
| Trả sau · đồng hồ | Tính theo đồng hồ sau chuyến (Mai Linh): không nhập giá khi đặt, gửi cuốc được cho tài xế XPay. Đây là mặc định. |
| Trả trước | Hãng báo giá trước (Xanh SM, Be): nhập giá mua và giá bán khi đặt xe. |
Cách đặt xe
| Lựa chọn | Ý nghĩa |
|---|---|
| Đặt tay | CS đặt trên app hãng hoặc gọi hotline, rồi nhập xe. Đây là mặc định. |
| API Xanh SM | Hệ thống đặt thẳng trên tài khoản Xanh SM doanh nghiệp và tự theo dõi chuyến. Xem §4. |
Phạm vi phục vụ
| Trường | Quy định |
|---|---|
| Loại xe | Chọn trong 4, 6, 7, 9, 16, 29, 45 chỗ. Không chọn loại nào = nhận mọi loại xe. |
| Khu vực phục vụ | Nhập mã khu vực rồi bấm Enter (VD: hcm). Để trống = phục vụ mọi khu vực. Các mã hãng khác đang dùng hiện ở mục Đang dùng: — bấm để thêm nhanh. |
Liên hệ
Người liên hệ, SĐT liên hệ, Email liên hệ — đều không bắt buộc, nhưng nếu nhập thì phải đúng định dạng.
Vận hành
| Trường | Quy định |
|---|---|
| Độ ưu tiên | Số nguyên từ 0 đến 10000 (mặc định 100). Số nhỏ được thử trước. |
| Trạng thái | Đang hoạt động hoặc Ngừng hoạt động. Hãng ngừng hoạt động không hiện khi đặt xe. |
| Ghi chú nội bộ | Không bắt buộc (VD: Hợp đồng HD-2026-014, gọi trước 30 phút) |
Bấm Tạo hãng. Hãng đang hoạt động hiện ngay ở bước chọn hãng khi đặt xe.
3. Sửa hãng
Bấm vào hãng trong danh sách, sửa thông tin cần thiết rồi bấm Lưu thay đổi.
- Thay đổi áp dụng cho các lần đặt xe sau, không đổi cuốc đã gửi.
- Mã hãng không đổi được.
- Đổi Cách tính giá sẽ hiện cảnh báo: các bước đặt xe với hãng này sẽ thay đổi từ lần sau.
- Hãng tạo từ trước khi bắt buộc gắn merchant phải chọn merchant thì mới lưu được thay đổi.
4. Thiết lập API Xanh SM
Hãng dùng API Xanh SM phải có đăng nhập còn hiệu lực thì mới đặt xe được.
- Tạo hãng ở trạng thái Ngừng hoạt động với Cách đặt xe = API Xanh SM. (Tạo ở trạng thái Đang hoạt động sẽ bị từ chối.)
- Mở lại hãng từ danh sách. Ô Đăng nhập Xanh SM lúc này hiện trạng thái: Chưa đăng nhập, Đã đăng nhập hoặc Hết phiên.
- Đăng nhập
booking.greensm.combằng OTP, lấy access_token và refresh_token của phiên đó. - Dán cả hai vào form rồi bấm Lưu đăng nhập (Thay đăng nhập nếu đã có). Token được mã hoá khi lưu và không hiện lại.
- Chuyển Trạng thái = Đang hoạt động rồi bấm Lưu thay đổi.
Nếu Xanh SM ngắt phiên, ô đăng nhập hiện Hết phiên kèm lý do Xanh SM trả về — đăng nhập lại và thay token mới.
Cấu hình Xanh SM
Bỏ trống ô nào thì dùng mặc định của hệ thống.
| Cấu hình | Ý nghĩa | Mặc định |
|---|---|---|
| Loại xe được đặt (số chỗ → service_id) | Dịch vụ Xanh SM được đặt cho từng số chỗ, VD: 4 → 1128, 6 → 2274. Mỗi số chỗ chỉ một dòng. | Mọi dịch vụ ô tô, không bao giờ đặt xe máy |
| Chờ tài xế tối đa (giây) | Quá thời gian chưa có tài xế thì huỷ trên Xanh SM | 300 |
| Quãng đường tối đa (km) | Điểm đón và điểm trả xa hơn mức này (đường chim bay) thì coi là hiểu sai địa chỉ | 100 |
| Ngôn ngữ | vi hoặc en | vi khi tạo hãng mới |
| Thêm bảo hiểm chuyến | Tick để thêm bảo hiểm chuyến | Đã tick khi tạo hãng mới |
| Tâm tìm địa chỉ theo khu vực | Khu vực, vĩ độ, kinh độ — dùng khi ticket không có toạ độ | hcm và hn |
5. Thông báo thường gặp
| Thông báo | Cần làm |
|---|---|
| Chọn merchant XPay của hãng. | Hãng nào cũng phải có merchant |
| Mã này đã có hãng khác dùng. | Chọn mã khác |
| Hãng API Xanh SM phải tạo ở trạng thái Ngừng, đăng nhập xong mới bật. | Chọn Trạng thái = Ngừng hoạt động khi tạo |
| Lưu đăng nhập Xanh SM trước khi chuyển hãng sang API. | Lưu token trước (§4) |
| Merchant đang … , chọn merchant đang hoạt động. | Merchant đang bị tạm khoá hoặc ngừng hoạt động |
| Máy chủ chưa cấu hình khoá mã hoá đăng nhập. Báo kỹ thuật. | Lỗi hệ thống — báo kỹ thuật |
Liên quan
- CS Dispatch Portal — Hướng dẫn cho tổng đài viên — cách dùng hãng xe khi đặt chuyến.
- Thêm merchant mới — cách onboard merchant XPay mà hãng xe gắn vào.