1. Nhân viên tạo đơn giao hàng trong EzyDelivery với phương thức giao hàng Chuyển phát nhanh và chọn dịch vụ Viettel Post.
2. EzyDelivery gửi đơn sang Viettel Post, tự chọn gói cước rẻ nhất phù hợp, nhận về mã vận đơn Viettel Post và in tem.
3. Trong quá trình giao, Viettel Post gọi lại (webhook) về hệ thống, EzyDelivery cập nhật trạng thái đơn theo thời gian thực.

Chuẩn bị

Hai dịch vụ Viettel Post trong EzyDelivery

Cấu hình dịch vụ Viettel Post

• Nếu đúng: lưu thành công, token đăng nhập được lưu vào ô Khoá bí mật (hiển thị dạng ẩn).
• Nếu sai: hiện lỗi ở ô Tên đăng nhập và Mật khẩu, kiểm tra lại thông tin tài khoản và Đường dẫn API dịch vụ.

Về token đăng nhập

• Hãy dùng cách đăng nhập bằng tên đăng nhập + mật khẩu. Nếu chỉ nhập Khoá bí mật (token lấy từ trang đối tác Viettel Post), hệ thống không tự gia hạn được khi token hết hạn.
• Khi đổi mật khẩu tài khoản Viettel Post, nhớ cập nhật lại mật khẩu ở trang này.
• Khi sửa các ô khác, cứ để nguyên ô Mật khẩu và Khoá bí mật đang hiển thị dạng ẩn, hệ thống sẽ giữ giá trị cũ.

Đặt làm dịch vụ mặc định (tuỳ chọn)

Ánh xạ tiền tố đơn vị hành chính

[
  { "type": "PROVINCE", "prefix": "T." },
  { "type": "CITY", "prefix": "TP." },
  { "type": "DISTRICT_IN_CITY", "prefix": "Q." },
  { "type": "DISTRICT_IN_PROVINCE", "prefix": "H." },
  { "type": "TOWN_IN_PROVINCE", "prefix": "TX." },
  { "type": "WARD", "prefix": "X." },
  { "type": "WARD_IN_CITY", "prefix": "P." },
  { "type": "TOWN", "prefix": "TT." }
]

• type: loại đơn vị hành chính, khớp với loại bạn chọn khi tạo tỉnh/thành phố, quận/huyện, phường/xã trên trang quốc gia.
• prefix: tiền tố được thêm trước tên đơn vị khi gửi sang Viettel Post. Ví dụ phường Bến Nghé có loại WARD_IN_CITY sẽ thành P. Bến Nghé.

Cấu hình webhook trên Viettel Post

• Đường dẫn trên thuộc trang web (web plugin), không phải trang quản trị. Tên miền phải truy cập được từ Internet và nên dùng https.
• Mỗi lần nhận webhook, EzyDelivery kiểm tra token Viettel Post gửi kèm. Token không khớp Khoá máy khách sẽ bị từ chối với lỗi Token: invalid.
• EzyDelivery chỉ chấp nhận cập nhật cho đơn mà nó đã tạo và có mã vận đơn khớp với mã Viettel Post gửi về. Các đơn tạo trực tiếp trên trang Viettel Post sẽ bị bỏ qua (trả về deliveryOrder: notFound).

Tạo đơn giao hàng qua Viettel Post

1. Vào Các yêu cầu giao hàng (/ezydelivery/shipping-requests) và mở yêu cầu cần giao.
2. Bấm Tạo vận đơn, kiểm tra Tổng số cân (kg).
3. Ở ô Dịch vụ vận chuyển, chọn Viettel Post (chỉ hiện khi phương thức giao hàng là chuyển phát nhanh).
4. Bấm Tạo hoặc Tạo và hoàn thành.

• Thành công: đơn chuyển sang trạng thái Đã gửi yêu cầu, mã vận đơn Viettel Post được lưu làm mã vận đơn của đơn, và tem được in ngay. Các thông tin cước Viettel Post trả về (tổng cước, phí thu hộ, VAT, thời gian giao dự kiến, ...) được lưu kèm đơn.
• Thất bại: đơn chuyển sang trạng thái Gửi yêu cầu thất bại, nội dung lỗi Viettel Post trả về được lưu vào đơn để xem lại. Sau khi sửa nguyên nhân có thể gửi lại.

Cập nhật trạng thái đơn

https://viettelpost.com.vn/thong-tin-don-hang?peopleTracking=sender&orderNumber=<mã-vận-đơn>

Xử lý sự cố thường gặp