Đăng đơn tự động và hàng loạt

Cần gì trước

• Plugin chính đã đăng nhập ViettelPost, đã khai kho và dịch vụ.
• Addon Đăng đơn tự động/hàng loạt đã cài và kích hoạt. Nó có mã bản quyền riêng — chưa kích hoạt thì tab chỉ hiện đúng ô nhập mã.

Xem video

Mở tab addon

Vào WooCommerce → ViettelPost, tab Cài đặt đăng đơn tự động/hàng loạt.

1. Cài đặt đăng đơn tự động/hàng loạt — tab thứ ba. Không thấy tab này nghĩa là addon chưa kích hoạt.
2. Kích hoạt tự động đăng đơn lên ViettelPost — công tắc chính, mặc định tắt. Không tích thì các điều kiện tự động nằm im; thao tác đăng hàng loạt vẫn dùng được.
3. Tự động khi nào? — danh sách điều kiện, xem mục kế tiếp.
4. Bật log — ghi lại dữ liệu gửi sang ViettelPost và câu trả lời của ViettelPost vào file vtp_auto_log.txt trong thư mục addon. Bật trong thời gian đầu để còn dò khi có đơn không tự đăng.

Đặt điều kiện tự động

1. Trạng thái đơn — mốc kích hoạt, ví dụ Khi đơn mới được tạo hoặc Khi đơn chuyển sang Đã hoàn thành.
2. Điều kiện thanh toán — Không quan tâm hình thức thanh toán, Chỉ khi thanh toán = COD, hoặc Chỉ khi thanh toán != COD. Đây là chỗ tách đơn COD khỏi đơn đã chuyển khoản.
3. Dòng thứ hai — mỗi dòng là một điều kiện độc lập; đơn thoả bất kỳ dòng nào là được đăng.

Thêm bằng nút + Thêm điều kiện, bỏ bằng nút Xóa ở cuối dòng.

Giá trị mặc định khi đăng tự động

Đăng tự động hay hàng loạt thì không ai ngồi điền khung tạo vận đơn. Addon lấy kho và dịch vụ từ dòng phí ship ViettelPost của đơn (kho đã tính phí, dịch vụ khách đã chọn lúc thanh toán). Các ô dưới đây chỉ để bù chỗ đơn còn thiếu.

1. Kho mặc định — đơn đã có kho từ dòng phí ship thì luôn đi theo kho đó (kho được chọn theo khu vực bán hàng lúc khách đặt). Ô này chỉ dùng cho đơn không có kho từ dòng phí ship, ví dụ đơn tạo tay trong trang quản trị. Để Tự động theo đơn hàng mà đơn không có kho thì addon báo lỗi không tìm thấy kho và không đăng — nên chọn sẵn một kho ở đây.
2. Dịch vụ mặc định — tương tự: đơn có dịch vụ khách chọn lúc thanh toán thì dùng dịch vụ đó. Ô này chỉ dùng cho đơn không có dịch vụ ViettelPost.
3. Ghi chú đơn hàng — lời nhắn cho bưu tá. Addon ghép ghi chú này với ghi chú của khách trong đơn (ghi chú cài đặt đứng trước), không thay thế. Để trống thì chỉ còn ghi chú của khách.
4. Trạng thái đơn sau khi đăng tự động — đăng xong thì chuyển đơn sang trạng thái nào. Mặc định là Đã đăng lên ViettelPost, trạng thái do addon thêm vào. Nhờ nó mà bạn nhìn danh sách đơn là biết cái nào đã gửi. Chọn Không chuyển trạng thái nếu không muốn đổi.
5. Khối lượng mặc định — tính bằng gram, mặc định 100. Chỉ dùng cho đơn đăng tự động/hàng loạt có tổng cân nặng bằng 0 (sản phẩm chưa khai cân nặng). Đặt sát thực tế: khai nhẹ quá thì ViettelPost cân lại và thu thêm cước.

Bấm Lưu thay đổi để ghi lại.

Đăng thành công thì khách nhận email báo mã vận đơn nếu bạn đã bật email ở plugin chính.

Đăng hàng loạt

Addon thêm hành động Đăng đơn lên ViettelPost vào danh sách đơn hàng (chạy được ở cả màn hình đơn mới HPOS lẫn màn hình cũ): tích nhiều đơn, chọn hành động đó rồi bấm Áp dụng. Đơn được xử lý chạy nền, nên chờ một lúc rồi tải lại danh sách. Hợp khi bạn gom đơn cả ngày rồi gửi một lượt cuối buổi, thay vì để tự động chạy từng đơn.

• Đăng hàng loạt dùng cùng các giá trị mặc định ở mục trên.
• Đơn đã có mã vận đơn thì addon bỏ qua, nên lỡ tích lại đơn đã gửi cũng không tạo vận đơn thứ hai.
• Có thêm hành động Chuyển sang trạng thái đã đăng lên ViettelPost để đánh dấu tay những đơn bạn đã gửi bằng cách khác.

Cách kiểm tra đã chạy đúng chưa

1. Bật Bật log, đặt một điều kiện dễ kiểm, ví dụ Khi đơn chuyển sang Đang xử lý.
2. Tạo một đơn thử rồi tự tay đổi trạng thái sang Đang xử lý.
3. Chờ vài giây rồi tải lại trang đơn — ô ViettelPost phải hiện mã đơn, ghi chú đơn có dòng Được đăng tự động lên ViettelPost, và trạng thái đơn đổi sang giá trị bạn đặt ở Trạng thái đơn sau khi đăng tự động.
4. Không thấy mã thì mở vtp_auto_log.txt trong thư mục addon. Có dòng mới nghĩa là addon đã gửi sang ViettelPost — đọc thông báo ViettelPost trả về trong đó. Không có dòng nào nghĩa là addon chưa tới bước gửi: điều kiện chưa khớp, hoặc đơn không lấy được kho.
5. Chạy ổn rồi thì tắt log — tắt là file log được xoá luôn.

Lỗi thường gặp

Tiếp theo: webhook và đồng bộ trạng thái.