Giao hàng tận nơi
Tính năng này có trên gói Pro và Enterprise.
Các đơn vị vận chuyển hỗ trợ
XCaphe tích hợp 7 đơn vị vận chuyển. So sánh phí và tạo vận đơn trực tiếp từ dashboard:
| Đơn vị | Loại | Phạm vi | Ước tính phí | Trạng thái |
|---|---|---|---|---|
| Ahamove | Giao nhanh 2h/4h | Nội thành TP.HCM, HN | ✅ Có (GPS) | ✅ Hỗ trợ |
| GHN | Tiêu chuẩn | Toàn quốc | ✅ Có (district/ward) | ✅ Hỗ trợ |
| Grab Express | Giao tức thì | Nội thành | Cần GPS | ✅ Hỗ trợ |
| Xanh SM | Giao xanh | Nội thành | Cần GPS | ✅ Hỗ trợ |
| Be Delivery | Giao tức thì | Nội thành | — | ✅ Hỗ trợ |
| J&T Express | Tiêu chuẩn | Toàn quốc | — | ✅ Hỗ trợ |
| Viettel Post | Tiêu chuẩn | Toàn quốc | ✅ Có | ✅ Hỗ trợ |
Ahamove là lựa chọn tối ưu cho quán café — giao nhanh trong 2 giờ, phủ rộng nội thành. GHN phù hợp cho giao tiêu chuẩn toàn quốc (1–3 ngày).
Cấu hình đơn vị vận chuyển
Thêm provider
Vào Cài đặt → Giao hàng → + Thêm đơn vị, chọn nhà vận chuyển.
Nhập thông tin xác thực
| Trường | Mô tả |
|---|---|
| API Key | Lấy từ partner.ahamove.com (opens in a new tab) |
| Số điện thoại | SĐT đăng ký tài khoản Ahamove |
| Service ID | SGN-BIKE (TP.HCM) hoặc HAN-BIKE (Hà Nội) |
Lưu ý về GPS: Ahamove cần tọa độ lat/lng để định tuyến. Nhập tọa độ quán vào Thông tin người gửi.
Nhập thông tin người gửi
Địa chỉ lấy hàng (địa chỉ quán), tên và SĐT liên hệ.
Kích hoạt provider
Bật Kích hoạt → nhấn Lưu cấu hình.
So sánh phí tự động
Trước khi tạo vận đơn, XCaphe gọi API của tất cả provider đang kích hoạt cùng lúc (parallel) và hiển thị bảng so sánh:
Ví dụ: Địa chỉ nhận: Q.3, TP.HCM | Cân nặng: 500g
| Đơn vị | Phí | Thời gian giao dự kiến | Trạng thái |
|---|---|---|---|
| 🏆 Ahamove Bike | 25.000₫ | ~45 phút | ✅ Khả dụng |
| GHN | 30.000₫ | 1–2 ngày | ✅ Khả dụng |
| Viettel Post | 28.000₫ | 1–3 ngày | ✅ Khả dụng |
| Grab Express | Cần GPS | — | ❌ Không hỗ trợ |
Tự động chọn rẻ nhất
Dùng Auto-shipment để XCaphe tự so sánh và tạo vận đơn với nhà vận chuyển rẻ nhất có sẵn:
- Mở đơn hàng → nhấn Giao hàng tự động
- XCaphe so sánh tất cả provider kích hoạt
- Chọn và tạo vận đơn với đơn vị rẻ nhất
- Mã vận đơn hiển thị ngay lập tức
Có thể dùng dry-run để xem kết quả so sánh mà không tạo vận đơn thực. Hữu ích để kiểm tra trước khi quyết định.
Tạo vận đơn thủ công
Mở đơn hàng
Vào Đơn hàng → chọn đơn cần giao.
Tạo vận đơn
Nhấn + Tạo vận đơn → điền thông tin người nhận:
- Họ tên, số điện thoại
- Địa chỉ đầy đủ (số nhà, đường, quận/huyện)
- Cân nặng ước tính (gram)
- COD nếu khách chưa thanh toán
Chọn đơn vị
Xem bảng so sánh phí → chọn đơn vị mong muốn → Xác nhận tạo vận đơn.
Theo dõi
Mã vận đơn được tạo, trạng thái tự động cập nhật qua webhook:
| Trạng thái | Ý nghĩa |
|---|---|
pending | Chờ shipper lấy hàng |
picking | Shipper đang đến lấy |
delivering | Đang giao đến khách |
delivered | Giao thành công |
failed | Giao thất bại, cần xử lý |
returned | Đang hoàn hàng về quán |
Webhook từ đơn vị vận chuyển
Mỗi đơn vị vận chuyển cần được cấu hình webhook để tự động cập nhật trạng thái:
| Đơn vị | Webhook URL |
|---|---|
| Ahamove | https://api.xcaphe.vn/delivery/webhook/ahamove?orgId=ORG_ID_CỦA_BẠN |
| GHN | https://api.xcaphe.vn/delivery/webhook/ghn?orgId=ORG_ID_CỦA_BẠN |
| Viettel Post | https://api.xcaphe.vn/delivery/webhook/viettel_post?orgId=ORG_ID_CỦA_BẠN |
Lấy Organization ID của bạn: Vào Cài đặt → Webhooks → Organization Identifier trong XCaphe dashboard, copy giá trị này vào URL trên.
XCaphe verify chữ ký webhook (HMAC-SHA256 với Ahamove, token header với GHN) trước khi cập nhật trạng thái.
Câu hỏi thường gặp
Q: Ahamove báo lỗi "cần tọa độ GPS"?
Ahamove sử dụng GPS để định tuyến thay vì mã quận/phường. Vào Cài đặt → Giao hàng → Ahamove → Thông tin người gửi và nhập tọa độ lat/lng của quán (lấy từ Google Maps).
Q: Có thể dùng COD với Ahamove không?
Có. Nhập số tiền COD khi tạo vận đơn. Ahamove thu tiền mặt và chuyển về cho quán theo lịch thanh toán định kỳ.
Q: Huỷ vận đơn được không?
Được, nếu đơn chưa ở trạng thái delivering. Vào đơn hàng → tab Vận đơn → nhấn Huỷ vận đơn.
Q: Một đơn hàng có thể tạo nhiều vận đơn không?
Có. Nếu giao lần đầu thất bại, có thể tạo vận đơn mới (với cùng hoặc khác đơn vị). Lịch sử vận đơn được giữ nguyên.