Hướng dẫn kết nối Viettel Post trên CMS
Hướng dẫn lấy token Viettel Post, cấu hình người gửi và địa chỉ lấy hàng, kiểm tra kết nối và thiết lập nhận trạng thái vận đơn trên CMS Dybi.
Kết nối Viettel Post giúp website sử dụng thông tin của cửa hàng để tính phí giao hàng và nhận cập nhật hành trình vận đơn. Bạn chỉ cần cấu hình một lần trong CMS, sau đó có thể thay địa chỉ lấy hàng hoặc cập nhật thông tin kết nối khi cần.
Chuẩn bị trước khi kết nối
- Tài khoản CMS có quyền vào Cấu hình và quyền quản lý sản phẩm. Nhóm Giao hàng chỉ xuất hiện khi tài khoản có quyền quản lý sản phẩm.
- Tài khoản Viettel Post được sử dụng cho kết nối tích hợp, hoặc token lấy từ mục Tham số bí mật của Viettel Post.
- Tên, số điện thoại người gửi và địa chỉ cửa hàng hoặc kho lấy hàng.
CMS có hai cách xác thực: Tài khoản và Token. Bạn chọn một cách phù hợp, không cần nhập cả hai. Nếu tài khoản dùng trên ứng dụng Viettel Post chưa được chấp nhận khi kết nối, hãy nhờ Viettel Post kiểm tra quyền sử dụng API Partner cho tài khoản đó. Bạn có thể xem thêm hướng dẫn tích hợp của Viettel Post.
Lấy token trên Viettel Post
Nếu chọn xác thực bằng Token, hãy lấy mã theo các bước sau:
- Đăng nhập website Viettel Post bằng tài khoản của cửa hàng.
- Mở Cấu hình tài khoản → Tham số bí mật → Quản lý token. Có thể vào trang cấu hình tài khoản sau khi đăng nhập.
- Chọn Thêm mới token, đặt tên dễ nhớ, chẳng hạn “Website cửa hàng”, rồi bấm Xác nhận.
- Chọn sao chép token và kênh nhận mã xác minh mà Viettel Post cung cấp.
- Nhập mã OTP để hoàn tất, sau đó dán token vừa sao chép vào CMS.
Đặt tên rồi xác nhận để tạo token. Nguồn: tài liệu xác thực của Viettel Post.
Token là thông tin bảo mật của tài khoản giao hàng. Chỉ dán mã vào ô Token trong CMS; không đưa mã vào nội dung website hoặc gửi kèm ảnh chụp công khai.
Nhập thông tin kết nối trong CMS
- Đăng nhập CMS của website cần cấu hình.
- Mở Cấu hình → Cấu hình kết nối → Giao hàng → Viettel Post.
- Bật Kết nối Viettel Post. Các thông tin cấu hình sẽ xuất hiện bên dưới.
- Tại Xác thực, chọn Token và dán mã đã lấy ở bước trên. Nếu sử dụng Tài khoản, nhập tài khoản và mật khẩu tích hợp Viettel Post.
Cấu hình Viettel Post trong nhóm Giao hàng. Khi đã lưu token, CMS chỉ hiển thị trạng thái đã lưu.
Chọn địa chỉ lấy hàng
Trong Thông tin lấy hàng, điền tên và số điện thoại của người bàn giao hàng cho bưu tá. Nếu để trống hai ô này, hệ thống dùng thông tin tương ứng của website.
Bạn có thể chọn một trong hai cách:
- Lấy hàng tại địa chỉ đang ghi trên website: giữ chọn Dùng địa chỉ trên website và kiểm tra địa chỉ đang hiển thị. Nếu thông tin chưa đúng, mở Thông tin web để cập nhật trước.
- Lấy hàng tại kho hoặc cửa hàng khác: bỏ chọn Dùng địa chỉ trên website → chọn Tỉnh/thành phố → chọn Phường/xã → nhập Địa chỉ chi tiết, gồm số nhà, tên đường hoặc thôn/ấp.
Danh sách tỉnh/thành phố và phường/xã trong cấu hình Viettel Post được tải từ hãng. Sau khi đổi tỉnh/thành phố, bạn cần chọn lại phường/xã. Hãy dùng địa chỉ nơi bưu tá đến nhận hàng để phí giao hàng được tính đúng điểm gửi.
Lưu và kiểm tra kết nối
- Bấm Lưu kết nối và chờ thông báo lưu thành công.
- Bấm Kiểm tra kết nối.
- Khi nhận thông báo Kết nối Viettel Post thành công, thông tin xác thực đã được hãng chấp nhận.
Nút Kiểm tra kết nối sử dụng cấu hình đã lưu. Vì vậy, nếu vừa sửa token, tài khoản hoặc địa chỉ, hãy lưu trước rồi mới kiểm tra. Thông báo lưu thành công chỉ xác nhận CMS đã lưu dữ liệu, chưa thay cho bước kiểm tra với hãng.
Với website đã có giỏ hàng và tính phí giao hàng, hãy thử chọn sản phẩm → mở giỏ hàng → chọn tỉnh/thành phố, phường/xã và nhập địa chỉ chi tiết → chọn Viettel Post. Khi đủ thông tin, hệ thống tự tính phí và cộng phí vào tổng thanh toán. Phí trên website được tạm tính với khối lượng 100 g; sau khi đóng hàng, nhân viên sẽ báo lại nếu phí thực tế thay đổi. Đơn đặt trên website vẫn cần nhân viên xác nhận trước khi tạo vận đơn trên App.
Nhận trạng thái vận đơn qua webhook
Webhook là đường nhận thông báo tự động khi hãng cập nhật hành trình giao hàng. Khi bật kết nối, CMS tự chuẩn bị URL webhook và Token webhook; bạn không phải tự nghĩ ra mã mới.
- Mở phần Webhook trong tab Viettel Post.
- Bấm Sao chép ở URL webhook và Token webhook.
- Cung cấp hai thông tin này cho đầu mối hỗ trợ tích hợp Viettel Post để thiết lập nơi gửi trạng thái cho đúng tài khoản giao hàng.
CMS hiển thị sẵn thông tin để sao chép, nhưng việc bật kết nối trong CMS chưa tự đăng ký địa chỉ nhận trạng thái với Viettel Post. Token webhook khác token dùng ở phần Xác thực: một mã bảo vệ thông báo gửi về website, mã còn lại dùng để kết nối tài khoản hãng.
Nếu cần đổi Token webhook, nhập mã từ 32 đến 200 ký tự, không có khoảng trắng → bấm Lưu kết nối → sao chép lại thông tin mới và cập nhật tương ứng phía hãng.
Theo tài liệu webhook Viettel Post, mỗi tài khoản chỉ cấu hình một địa chỉ nhận webhook. Nếu nhiều website dùng chung một tài khoản giao hàng, hãy trao đổi với bộ phận hỗ trợ Dybi trước khi thay URL đang sử dụng. Chỉ đặt cùng Token webhook ở các website chưa đủ để mọi website đều nhận được trạng thái.
Xử lý khi chưa kết nối được
- Không thấy nhóm Giao hàng: liên hệ người quản trị tài khoản → kiểm tra quyền Cấu hình và quản lý sản phẩm → đăng nhập lại CMS.
- Hãng báo sai tài khoản hoặc mật khẩu: mở lại tab Viettel Post → kiểm tra cách Xác thực đang chọn → nhập đúng thông tin tương ứng → lưu và kiểm tra lại. Nếu vẫn lỗi, nhờ Viettel Post kiểm tra tài khoản tích hợp.
- Token không được chấp nhận: kiểm tra đã lấy đúng mã ở Tham số bí mật → bấm Thay token trong CMS → dán lại mã, tránh khoảng trắng thừa → lưu và kiểm tra.
- Không chọn được tỉnh/thành phố hoặc phường/xã: bấm Tải lại danh mục nếu có → chọn tỉnh/thành phố trước → chọn lại phường/xã. Nếu danh sách vẫn chưa tải được, thử lại khi kết nối mạng ổn định.
- Địa chỉ lấy hàng bị báo thiếu: kiểm tra địa chỉ trên website nếu đang dùng địa chỉ chung; nếu dùng địa chỉ riêng, chọn đủ tỉnh/thành phố, phường/xã và nhập địa chỉ chi tiết.
- Vận đơn chưa có trạng thái mới: kiểm tra đúng mã vận đơn → kiểm tra thông tin webhook đã được thiết lập với hãng → nếu từng đổi token, bảo đảm phía hãng cũng dùng mã mới.
Thay thông tin hoặc tạm ngừng kết nối
Khi CMS báo Đã lưu token hoặc Đã lưu mật khẩu, bạn không cần nhập lại thông tin bảo mật chỉ để sửa địa chỉ. Muốn đổi thông tin xác thực, bấm Thay token hoặc Thay mật khẩu, nhập giá trị mới rồi lưu. Nếu đổi giữa Tài khoản và Token, cần nhập thông tin phù hợp với cách vừa chọn.
Để tạm ngừng dùng Viettel Post cho đơn mới, tắt Kết nối Viettel Post rồi bấm Lưu kết nối. Việc này không hủy các vận đơn đã gửi sang hãng. Nút Tải lại dùng để lấy lại cấu hình đã lưu và bỏ những thay đổi chưa lưu trên form.
Nếu cửa hàng dùng thêm GHTK, xem hướng dẫn kết nối Giao hàng tiết kiệm trên CMS Dybi.
