Kết nối Viettel Post và cài đặt vận chuyển

Bài này giúp bạn chuẩn bị mọi thứ trước khi gửi đơn đầu tiên qua Viettel Post: kết nối tài khoản, địa chỉ lấy hàng của kho và cài đặt giao hàng của gian hàng. Làm xong, phiếu ở màn Gửi đơn qua hãng vận chuyển không còn bị khoá vì thiếu cài đặt.

Trước khi bắt đầu

• Kho gửi hàng đã được tạo ở Vận hành > Kho hàng & vị trí.
• Màn Vận chuyển > Hãng vận chuyển: chỉ quản trị viên gian hàng sửa được. Người khác chỉ xem; các nút xám kèm câu "Chỉ quản trị viên gian hàng mới được thêm, sửa hoặc xoay khoá cài đặt vận chuyển."
• Màn Vận chuyển > Địa chỉ lấy hàng: xem cần quyền xem kho, sửa cần quyền quản lý kho. Người chỉ có quyền xem thấy câu "Bạn chỉ có quyền xem. Sửa địa chỉ lấy hàng cần quyền ghi Kho."

Các bước cài đặt

Cài đặt trước khi gửi đơn đầu tiên qua Viettel Post Mở toàn màn hình

Đi theo hàng mũi tên đậm từ trái sang phải. Hàng dưới cùng là chỗ phiếu bị chặn nếu một bước chưa xong.

1. Quản trị VOMA bật kết nối Viettel Post cho gian hàng.
2. Quản trị viên gian hàng kiểm tra kết nối.
3. Người quản lý kho khai địa chỉ lấy hàng cho từng kho.
4. Quản trị viên gian hàng chọn cài đặt giao hàng và lưu.
5. Kho thử xem giá một phiếu ở màn Gửi đơn.

Bước 1. Kết nối Viettel Post bằng tài khoản đối tác của VOMA

VOMA là đối tác của Viettel Post. Gian hàng gửi đơn bằng tài khoản đối tác của VOMA, nên shop không phải nhập mật khẩu hay token Viettel Post.

• Việc bật kết nối này hiện chỉ quản trị VOMA làm được; màn hình của gian hàng không có lựa chọn tài khoản đối tác. Liên hệ quản trị VOMA và nêu tên gian hàng cần bật.
• Mỗi gian hàng có tối đa một tài khoản cho mỗi hãng trên môi trường đang chạy. Tài khoản dùng thật hiện Môi trường thật; tài khoản thử hiện Môi trường thử nghiệm, vận đơn tạo ở đó không có bưu tá thật đến lấy.

Bước 2. Kiểm tra kết nối

1. Vào Vận chuyển > Hãng vận chuyển, mở tab Tài khoản vận chuyển.
2. Tìm dòng Viettel Post. Cột Trạng thái phải là Đang hoạt động.
3. Bấm Kiểm tra kết nối.
4. Kiểm tra dòng Kiểm tra kết nối thành công. và giờ mới ở cột Kiểm tra gần nhất.

Với tài khoản đối tác của VOMA, hai chỗ sau là bình thường:

• Cột Thông tin đăng nhập hiện Chưa lưu thông tin đăng nhập, vì gian hàng không dùng token riêng.
• Dòng phương thức xác thực dưới tên hiển thị hiện Không rõ.

:::caution Không bấm Cập nhật tài khoản hay Xoá trên tài khoản do quản trị VOMA bật. Biểu mẫu cập nhật chỉ có cách Token tự tạo trên viettelpost.vn: lưu mà để trống token thì báo lỗi, còn dán token thì tài khoản chuyển sang tài khoản Viettel Post riêng của shop, và gian hàng không tự chuyển ngược lại được. Xoá tài khoản thì gian hàng không tạo được vận đơn mới cho tới khi quản trị VOMA bật lại kết nối.

Khi tài khoản Mất kết nối hoặc Kiểm tra kết nối không thành công, màn có thể nhắc "cần cập nhật lại token" hoặc "kiểm tra lại token". Với tài khoản đối tác, đừng làm theo lời nhắc đó: báo quản trị VOMA. :::

Nếu Trạng thái là Mất kết nối, bấm Kiểm tra kết nối lần nữa; vẫn không thành công thì báo quản trị VOMA (đừng cập nhật token, xem lưu ý trên). Trong lúc đó, phiếu ở màn Gửi đơn bị khoá với lý do "Chưa kết nối hãng vận chuyển." Nếu màn báo hãng tạm thời không phản hồi, trạng thái giữ nguyên; thử lại sau ít phút.

Nếu shop muốn dùng tài khoản Viettel Post riêng

Nút Thêm tài khoản hãng chỉ hiện khi gian hàng chưa có tài khoản Viettel Post. Biểu mẫu Thêm tài khoản Viettel Post dùng phương thức Token tự tạo trên viettelpost.vn, gồm các ô Tên hiển thị, Mã cửa hàng Viettel Post (tuỳ chọn) và Token đăng nhập Viettel Post. Cách này khác cách VOMA đang vận hành, nên chỉ làm khi quản trị VOMA yêu cầu:

• Tiền thu hộ về tài khoản Viettel Post của shop, không về tài khoản đối tác của VOMA.
• Token có hạn. Cột Thông tin đăng nhập hiện hạn dạng "Hạn đến …", "Sắp hết hạn: …" (còn từ 30 ngày trở xuống) hoặc "Đã hết hạn: …".
• VOMA chưa cấp địa chỉ nhận trạng thái riêng cho tài khoản này: tab Cấu hình webhook để trống, nên trạng thái vận đơn có thể không tự cập nhật về VOMA.

Bước 3. Khai địa chỉ lấy hàng cho từng kho

Bưu tá đến lấy hàng tại kho xuất phiếu. Khi báo giá và tạo vận đơn, VOMA gửi tên, số điện thoại và địa chỉ người gửi của kho sang Viettel Post; kho không cần đăng ký riêng với hãng.

1. Vào Vận chuyển > Địa chỉ lấy hàng.
2. Ở dòng kho gửi hàng, bấm Sửa địa chỉ.
3. Nhập Tên người gửi và Số điện thoại (10 chữ số, bắt đầu bằng 0).
4. Nhập Địa chỉ chi tiết: số nhà, tên đường, toà nhà.
5. Chọn Tỉnh/Thành phố, rồi chọn Phường/Xã theo địa giới mới. Xem Địa chỉ người nhận theo địa giới hành chính mới.
6. Bấm Lưu.
7. Kiểm tra cột Trạng thái chuyển thành Đã khai địa chỉ lấy hàng.

• Kho thiếu bất kỳ ô nào hiện Chưa khai địa chỉ lấy hàng. Phiếu của kho đó bị khoá ở màn Gửi đơn với lý do "Kho … chưa khai người gửi nên hãng chưa lấy hàng được ở đó.", kèm liên kết Khai địa chỉ lấy hàng.
• Kho đã tắt hiện thêm dòng Kho ngừng hoạt động.
• Địa chỉ lấy hàng mới chỉ áp cho vận đơn tạo sau khi lưu; vận đơn đã tạo giữ địa chỉ cũ.

Bước 4. Chọn cài đặt giao hàng

Vào Vận chuyển > Hãng vận chuyển, mở tab Giao hàng. Gian hàng chưa lưu lần nào thì các ô hiện sẵn giá trị mặc định nhưng chưa được lưu. Kiểm tra từng ô rồi bấm Lưu cài đặt giao hàng; màn báo Đã lưu cài đặt giao hàng.

Cách chọn mã dịch vụ xem ở Báo giá và chọn dịch vụ giao hàng.

Ngưỡng cảnh báo lệch cước

Khi Viettel Post báo cước mới cho một vận đơn (ví dụ sau khi cân lại), VOMA so với cước trước đó. VOMA lấy ngưỡng lớn hơn trong hai ngưỡng; phần lệch vượt ngưỡng đó thì trang chi tiết đơn hiện dòng "Cước thật lệch báo giá". Ví dụ cước 40.000đ, ngưỡng 10% là 4.000đ và ngưỡng tuyệt đối 5.000đ: VOMA chỉ cảnh báo khi lệch quá 5.000đ. Cảnh báo không đổi số tiền; số của hãng vẫn là số chốt.

Tab Cấu hình webhook

Webhook là đường Viettel Post báo trạng thái vận đơn về VOMA. Với tài khoản đối tác, quản trị VOMA cấu hình phần này ở cấp tài khoản đối tác; shop không phải dán địa chỉ hay khoá nào lên Viettel Post. Tab Cấu hình webhook chỉ liệt kê đầu nhận riêng của gian hàng, nên có thể hiện Chưa có đầu nhận webhook cho gian hàng; với tài khoản đối tác, đây không phải lỗi. Muốn xem bản tin hãng đã gửi về, mở Vận chuyển > Nhật ký webhook.

Bước 5. Thử xem giá một phiếu

1. Vào Vận chuyển > Gửi đơn qua hãng vận chuyển.
2. Kiểm tra cột Lý do chặn của một phiếu ghi Gửi được.
3. Tích phiếu đó, bấm Gửi hãng.
4. Chọn tỉnh, phường/xã nếu còn trống và nhập Khối lượng (gram).
5. Bấm Xem giá dịch vụ.
6. Kiểm tra mục Dịch vụ có giá và dịch vụ mặc định được chọn sẵn.

Xem giá không tạo vận đơn. Chưa muốn gửi thì đóng ngăn kéo, không bấm Tạo vận đơn.

Xong khi nào

• Dòng Viettel Post ở tab Tài khoản vận chuyển là Đang hoạt động và Kiểm tra kết nối báo thành công.
• Mọi kho gửi hàng có trạng thái Đã khai địa chỉ lấy hàng.
• Tab Giao hàng đã lưu, và mã dịch vụ mặc định có trong danh sách dịch vụ khi xem giá.
• Phiếu đã đóng gói ở màn Gửi đơn hiện Gửi được, trừ lý do riêng của đơn như chưa thanh toán.

Hay gặp

• Không thấy nút Thêm tài khoản hãng: gian hàng đã có tài khoản Viettel Post. Mỗi hãng chỉ có một tài khoản trên mỗi môi trường.
• Nút xám, không bấm được: tài khoản của bạn không phải quản trị viên gian hàng. Nhờ quản trị viên gian hàng làm.
• Phiếu bị khoá "Chưa kết nối hãng vận chuyển.": gian hàng chưa có tài khoản Viettel Post hoặc tài khoản đang Mất kết nối. Làm lại bước 2.
• Xem giá báo kho chưa khai địa chỉ lấy hàng: kho của phiếu còn thiếu tỉnh, phường/xã người gửi. Làm lại bước 3.
• Dịch vụ chọn sẵn không phải dịch vụ mong muốn: mã ở ô Mã dịch vụ mặc định (Viettel Post) không có trong báo giá của tuyến. Lấy mã đúng ở dòng Mã dịch vụ của một vận đơn đã tạo trong Vận chuyển > Tình trạng giao hàng, hoặc hỏi quản trị VOMA.

Bài liên quan

• Tổng quan vận chuyển trong VOMA
• Báo giá và chọn dịch vụ giao hàng
• Địa chỉ người nhận theo địa giới hành chính mới
• Tạo vận đơn
• Cảnh báo vận chuyển và cách xử lý
• Quản lý nhiều kho và điều chuyển hàng