Tổng hợp lỗi tạo vận đơn thường gặp và cách xử lý
Trong quá trình tạo vận đơn, bạn có thể gặp một số lỗi kỹ thuật khiến đơn hàng chưa thể chuyển sang nhà vận chuyển thành công.
Bài viết này giúp bạn nhận biết nguyên nhân lỗi, biết cách kiểm tra ở đâu và xử lý nhanh theo từng nhà vận chuyển, để việc giao hàng không bị gián đoạn.
Nội dung bài viết
- Nhà vận chuyển Giao Hàng Nhanh
- Nhà vận chuyển ViettelPost
- Nhà vận chuyển Ninja Van
- Nhà vận chuyển Ahamove
- Nhà vận chuyển Giao Hàng Tiết Kiệm (GHTK)
- Nhà vận chuyển Best Express
- Nhà vận chuyển VNPost
- Nhà vận chuyển J&T Express
Cách kiểm tra lỗi giao hàng
Để xem chi tiết lỗi giao hàng của một đơn, bạn vào chi tiết đơn hàng và kiểm tra tại mục Lịch sử.
Tại đây, hệ thống sẽ hiển thị thông báo lỗi tương ứng để bạn xác định nguyên nhân và chọn cách xử lý phù hợp.
Giao Hàng Nhanh (GHN)
| Lỗi | Nguyên nhân | Cách xử lý |
|---|---|---|
| corev2_tenant_order_create: Giá trị khai giá vượt quá mức cho phép: 5000000 | Đơn hàng có chọn bảo hiểm hàng hóa và tổng giá trị đơn vượt quá 5 triệu đồng. | Thực hiện Giao lại và bỏ chọn Bảo hiểm hàng hóa để tạo vận đơn lại. |
| Bạn không có quyền thực hiện thao tác. Vui lòng liên hệ chủ cửa hàng để được cấp quyền | Tài khoản GHN chưa thêm tài khoản Haravan hoặc đã xóa liên kết Haravan trên trang quản trị GHN. | Thêm lại tài khoản Haravan trên hệ thống GHN theo hướng dẫn kết nối vận chuyển. |
| Phone must be start by +84, 84, 0 | Số điện thoại người nhận sai định dạng. | Cập nhật lại số điện thoại để bắt đầu bằng +84, 84 hoặc 0. |
| Lỗi gọi API... context deadline exceeded | Hệ thống API của GHN đang tạm thời lỗi hoặc phản hồi chậm. | Chờ khoảng 10–20 phút rồi thử lại. Nếu vẫn lỗi, liên hệ Haravan để được hỗ trợ. |
| Không thể tạo đơn vì vượt quá số lượng cho phép, giới hạn 3 đơn | Tài khoản GHN của bạn chưa định danh. | Liên hệ GHN để hoàn tất định danh tài khoản. |
| Key: 'ShiipCreate.Content' Error... failed on the 'max' tag | Đơn hàng có quá nhiều sản phẩm, khiến nội dung gửi sang GHN vượt quá giới hạn ký tự. | Thực hiện Giao lại và chọn nhà vận chuyển khác. Sau đó tạo vận đơn trực tiếp trên trang GHN rồi cập nhật lại mã vận đơn vào Haravan. |
| Không tìm thấy bất kỳ gói giao hàng phù hợp với thông tin giao hàng | Địa chỉ người nhận thiếu phường/xã. | Vào phần Thông tin người mua, chỉnh sửa và bổ sung đầy đủ Phường/Xã. |
| master_data_validate_phone - số điện thoại ... không đúng | Số điện thoại tại địa chỉ lấy hàng đang sai. | Vào Cấu hình → Địa chỉ và kho hàng → chọn địa chỉ đang dùng → cập nhật lại số điện thoại → Lưu. |
| crm_weight_calculate - Weight failed on the 'required' tag | Bạn đang chọn gói chuyển phát chưa phù hợp với địa chỉ nhận hàng. | Thực hiện Giao lại và đổi sang gói chuyển phát thương mại điện tử. |
Lưu ý khi xử lý lỗi GHN
- Ưu tiên kiểm tra lại số điện thoại, địa chỉ nhận hàng và thông tin kho lấy hàng.
- Với các lỗi do hệ thống GHN phản hồi chậm, bạn nên thử lại sau một lúc trước khi đổi nhà vận chuyển.
- Với đơn có nhiều sản phẩm, nên kiểm tra trước khả năng tạo vận đơn trên GHN để tránh lỗi vượt giới hạn nội dung.
ViettelPost
| Lỗi | Nguyên nhân | Cách xử lý |
|---|---|---|
| Incorrect data: RECEIVER_WARD | Nhà vận chuyển chưa cập nhật hoặc chưa đồng bộ thông tin địa chỉ nhận hàng. | |
| MONEY_COLLECTION must be greater than 0 when using the XMG service | Giao hàng thất bại thu tiền chỉ hỗ trợ cho trường hợp đơn có thu COD. | Tạo lại vận đơn và không chọn option Giao hàng thất bại thu tiền với đơn KHÔNG thu COD |
Lưu ý khi xử lý lỗi ViettelPost
- Bạn nên kiểm tra lại phường/xã trong địa chỉ giao hàng.
- Nếu địa chỉ đã đúng nhưng vẫn lỗi, khả năng cao là dữ liệu phía nhà vận chuyển chưa cập nhật.
- Đảm bảo chỉ sử dụng dịch vụ Giao hàng thất bại thu tiền khi đơn hàng có thu COD.
Ninja Van
| Lỗi | Nguyên nhân | Cách xử lý |
|---|---|---|
| Tracking ID (xxx-yyy) has been used, please use a different tracking ID and try again | Vận đơn đã được tạo thành công bên Ninja Van, nhưng thông tin chưa phản hồi về Haravan nên hệ thống hiểu là chưa tạo thành công. Khi tạo lại sẽ bị báo trùng mã. | Đăng nhập hệ thống quản trị Ninja Van để hủy vận đơn đã tạo trước đó, sau đó quay lại Haravan và Giao lại. |
Lưu ý khi xử lý lỗi Ninja Van
- Đây thường là lỗi đồng bộ dữ liệu, không phải do bạn nhập sai thông tin.
- Trước khi tạo lại, nên kiểm tra trên trang quản trị Ninja Van xem vận đơn đã tồn tại hay chưa.
Ahamove
| Lỗi | Nguyên nhân | Cách xử lý |
|---|---|---|
| Tài khoản không đủ tiền hoặc không phải là tài khoản công nợ | Tài khoản Ahamove đang kết nối đã hết tiền hoặc không đúng loại tài khoản hỗ trợ giao hàng. | Kiểm tra lại tài khoản đang cấu hình trên Haravan có đúng với tài khoản Ahamove đang sử dụng hay không. Nếu đúng, hãy kiểm tra số dư tài khoản. |
Lưu ý khi xử lý lỗi Ahamove
- Nên đối chiếu lại thông tin tài khoản đã cấu hình.
- Nếu bạn dùng tài khoản trả trước, cần đảm bảo tài khoản còn đủ tiền để tạo chuyến.
Giao Hàng Tiết Kiệm (GHTK)
| Lỗi | Nguyên nhân | Cách xử lý |
|---|---|---|
| ERROR_HUB_CODE_NOT_EXISTED: Kho không tồn tại | Kho trên Haravan và kho trên hệ thống GHTK chưa được liên kết với nhau sau khi kết nối nhà vận chuyển. | Thực hiện liên kết kho giữa GHTK và Haravan theo đúng hướng dẫn cấu hình kho. |
Lưu ý khi xử lý lỗi GHTK
- Sau khi kết nối GHTK, bạn nên kiểm tra ngay phần kho hàng để đảm bảo hai bên đã liên kết đúng.
- Nếu có nhiều kho, cần chọn đúng kho đang dùng để giao hàng.
Best Express
| Lỗi | Nguyên nhân | Cách xử lý |
|---|---|---|
| [401] Invalid username or password | Tài khoản đang kết nối với Haravan là tài khoản đăng ký ban đầu, chưa được kích hoạt API. | Liên hệ bưu cục Best Express trong khu vực của bạn để được kích hoạt API. Sau khi được hỗ trợ, Best sẽ cung cấp tài khoản mới để kết nối lại trên Haravan. |
Lưu ý khi xử lý lỗi Best Express
- Không phải tài khoản đăng ký nào cũng dùng được để kết nối hệ thống.
- Bạn cần dùng đúng tài khoản đã được Best Express cấp quyền API.
VNPost
| Lỗi | Nguyên nhân | Cách xử lý |
|---|---|---|
| Không có quyền thực hiện tính cước cho đối tác | Bạn chưa cấp quyền cho Haravan truy cập tài khoản VNPost. | Vào trang quản trị VNPost → Cài đặt → Cài đặt tài khoản → Cấu hình đối tác → chọn Haravan → Lưu cấu hình. |
| Lỗi "status":422... "message":"Lỗi tính cước"... | Hệ thống không tính được cước, thường do khối lượng hàng hóa quá lớn hoặc nhập sai trọng lượng sản phẩm. | Có 2 cách xử lý: (1) Nếu nhập sai trọng lượng, chọn Giao lại và chỉnh lại cân nặng. (2) Nếu đơn thực sự quá nặng so với quy định, hãy chọn đơn vị vận chuyển khác phù hợp hơn. |
Lưu ý khi xử lý lỗi VNPost
- Bạn nên kiểm tra lại khối lượng sản phẩm trước khi tạo vận đơn.
- Trọng lượng nhập sai là nguyên nhân rất phổ biến làm hệ thống không tính được phí vận chuyển.
J&T Express
| Lỗi | Nguyên nhân | Cách xử lý |
|---|---|---|
| Lỗi B204 khi chuyển qua nhà vận chuyển | Khách hàng không sử dụng được phương thức thanh toán cuối tháng và chuyển sang COD. | Liên hệ J&T để bổ sung hoặc điều chỉnh hợp đồng. |
| Lỗi B501/B047/B051 | Địa chỉ gửi hàng không thuộc phạm vi chi nhánh J&T mà tài khoản của bạn đã đăng ký. | Liên hệ J&T để được kiểm tra và hỗ trợ theo phạm vi chi nhánh. |
| Lỗi B310 | Mã khách hàng J&T đã hết hạn. | Liên hệ J&T để gia hạn. |
| Lỗi B031 STOP | Khu vực giao/nhận đang tạm ngừng hoạt động. | Liên hệ J&T để kiểm tra tình trạng khu vực. |
| Customer is wrong | Hợp đồng giữa bạn và J&T đã hết hạn. | Liên hệ J&T để gia hạn hợp đồng. |
Lưu ý khi xử lý lỗi J&T
- Với J&T, nhiều lỗi liên quan đến phạm vi chi nhánh, thời hạn hợp đồng hoặc mã khách hàng.
- Nếu lỗi xuất hiện nhiều lần, bạn nên kiểm tra lại hợp đồng đang sử dụng với J&T.
Cách thao tác khi gặp lỗi tạo vận đơn
Khi tạo vận đơn không thành công, bạn nên xử lý theo thứ tự sau:
- Vào chi tiết đơn hàng và mở mục Lịch sử để xem nội dung lỗi.
- Xác định lỗi đang thuộc nhóm nào:
- Sai thông tin người nhận
- Sai thông tin kho lấy hàng
- Chưa cấp quyền hoặc chưa kết nối đúng tài khoản vận chuyển
- Tài khoản nhà vận chuyển hết hạn, hết tiền hoặc chưa định danh
- Lỗi tạm thời từ phía nhà vận chuyển
- Cập nhật lại thông tin nếu cần:
- Số điện thoại
- Phường/xã
- Khối lượng sản phẩm
- Kho lấy hàng
- Thực hiện lại thao tác Giao lại.
- Nếu vẫn không thành công, liên hệ nhà vận chuyển hoặc Haravan để được hỗ trợ.
Mẹo giúp hạn chế lỗi khi tạo vận đơn
- Luôn kiểm tra số điện thoại người nhận đúng định dạng.
- Đảm bảo địa chỉ có đủ tỉnh/thành, quận/huyện, phường/xã.
- Kiểm tra trước khối lượng sản phẩm và giá trị khai giá.
- Đảm bảo tài khoản nhà vận chuyển:
- Đã kết nối đúng
- Còn hiệu lực
- Có đủ quyền hoặc số dư cần thiết
- Sau khi kết nối nhà vận chuyển, nên kiểm tra lại kho hàng và quyền truy cập.