Cài đặt ban đầu cho EzyDelivery
Back to ezydeliveryBài viết này hướng dẫn các bước cấu hình bắt buộc sau khi cài plugin EzyDelivery (cùng với plugin Ecommerce) để hệ thống có thể nhập mã vận đơn, phân chia mã đơn và in tem.
Các bước cần làm theo đúng thứ tự dưới đây, vì bước sau phụ thuộc vào dữ liệu của bước trước:
- Tạo quốc gia (tối thiểu 2 quốc gia)
- Kích hoạt tiền tệ
- Tạo cửa hàng mặc định
- Tạo kho chứa
- Nhập người nhận giả (fake user)
- Cấu hình EzyDelivery (quốc gia đầu vào, tiền tệ mặc định, kho nhận hàng, khổ giấy in, ...)
Tạo quốc gia
Vào Thương mại điện tử → Các quốc gia (
/ecommerce/countries).EzyDelivery cần ít nhất 2 quốc gia:
| Vai trò | Ví dụ | Dùng để làm gì |
|---|---|---|
| Quốc gia đầu vào | Trung Quốc | Nơi hàng được gửi đi. Các kho của cửa hàng mặc định nằm ở quốc gia này sẽ được dùng làm kho xuất phát cho mã vận đơn nhập vào. |
| Quốc gia nhận | Việt Nam | Nơi hàng được giao đến. Kho nhận hàng mặc định nằm ở quốc gia này. |
Với quốc gia nhận (Việt Nam), nên tạo đầy đủ đơn vị hành chính (tỉnh/thành phố, quận/huyện, phường/xã) ngay trên trang quốc gia để địa chỉ khách hàng và địa chỉ kho được chọn chính xác.
Kích hoạt tiền tệ
Vào Thương mại điện tử → Các loại tiền (
/ecommerce/currencies).- Kích hoạt ít nhất một loại tiền tệ, nếu chưa có hệ thống sẽ hiển thị nhắc nhở và nhiều trang không dùng được.
- Nên kích hoạt cả tiền tệ của quốc gia đầu vào (ví dụ
CNY) lẫn tiền tệ của quốc gia nhận (ví dụVND). - Đánh dấu một tiền tệ làm mặc định cho hệ thống (thường là
VND).
Tiền tệ dùng cho giá hàng khi nhập mã vận đơn sẽ được chọn riêng ở bước 6.
Tạo cửa hàng mặc định
Vào Thương mại điện tử → Các cửa hàng → Thêm mới (
/ecommerce/shops/add).EzyDelivery làm việc trên cửa hàng mặc định. Cửa hàng mặc định được xác định theo thứ tự ưu tiên:
- Cửa hàng được cấu hình làm mặc định trong cài đặt Ecommerce (nếu có).
- Cửa hàng có tên (name) là
defaultvà đang ở trạng thái ACTIVATED. - Cửa hàng đầu tiên đang ở trạng thái ACTIVATED.
Cách đơn giản nhất: tạo một cửa hàng với tên
default và chuyển trạng thái sang ACTIVATED.
Tạo kho chứa
Vào Thương mại điện tử → Các kho chứa → Thêm mới (
/ecommerce/warehouses/add) và tạo kho thuộc cửa hàng mặc định ở bước 3:- Kho đầu vào: ít nhất 1 kho đặt tại quốc gia đầu vào (ví dụ kho Quảng Châu, kho Bằng Tường). Khi nhập mã vận đơn mà không chỉ định kho, hệ thống sẽ chọn ngẫu nhiên một trong các kho này làm kho xuất phát.
- Kho nhận hàng: ít nhất 1 kho đặt tại quốc gia nhận (ví dụ kho Hà Nội). Kho này sẽ được chọn làm Kho nhận hàng mặc định ở bước 6.
Lưu ý: chỉ các kho của cửa hàng mặc định mới xuất hiện trong danh sách chọn ở trang cài đặt EzyDelivery. Danh sách kho đầu vào được hệ thống tự làm mới khoảng mỗi 5 giây, không cần khởi động lại.
Nhập người nhận giả (fake user)
Khi nhập mã vận đơn chưa có thông tin người nhận, EzyDelivery sẽ lấy ngẫu nhiên một người dùng có quyền
fake_receiver để làm người nhận tạm thời. Vì vậy hệ thống cần có sẵn một danh sách người dùng giả.- Tải tập tin mẫu gồm 500 người dùng giả: <https://ezyplatform.com/api/v1/media/fake-users-500.csv>
- Vào trang Người dùng trong trang quản trị (
/users). - Ở ô Hành động hàng loạt, chọn Nhập nhiều người dùng từ tập tin rồi bấm áp dụng.
- Bấm Chọn tập tin CSV, chọn tập tin vừa tải về và kiểm tra bảng xem trước.
- Bấm Gửi để nhập.
Tập tin CSV có các cột:
#, Username, Display name, Email, Phone, Password, Website, Roles, Address. Ví dụ:
#,Username,Display name,Email,Phone,Password,Website,Roles,Address
1,hieupg1430,Phạm Gia Hiếu,phamhieu1989@gmail.com,0901970653,password123,,fake_receiver,"284 Hồ Nghinh, Phường An Hải Bắc, Sơn Trà, Đà Nẵng"
Nếu bạn tự chuẩn bị danh sách riêng, hãy giữ đúng cấu trúc trên và bắt buộc điền
fake_receiver ở cột Roles. Người dùng không có quyền này sẽ không được dùng làm người nhận giả.Một số điểm cần biết:
- Quyền
fake_receiver(Fake Receiver) được plugin EzyDelivery tự tạo khi khởi động, bạn không cần tạo thủ công. - Người dùng có quyền
fake_receiversẽ không xuất hiện trong danh sách khách hàng của EzyDelivery và không nhận thông báo công nợ qua OA. - Danh sách người nhận giả được hệ thống tự làm mới khoảng mỗi 5 giây sau khi có người dùng mới được gán quyền này.
- Địa chỉ của người nhận giả được lấy từ dữ liệu địa chỉ khách hàng (plugin EzyCRM). Nếu không có, địa chỉ sẽ hiển thị là
UNKNOWN.
Cấu hình EzyDelivery
Vào Quản lý vận chuyển → Cài đặt (
/ezydelivery/settings).Nhập mã vận đơn
| Trường | Giá trị gợi ý | Ghi chú |
|---|---|---|
| Mã tiền tệ mặc định | CNY | Bắt buộc. Phải là một tiền tệ đã kích hoạt ở bước 2. Dùng làm tiền tệ cho giá hàng khi nhập mã vận đơn. |
| Khoảng giá đầu vào ngẫu nhiên | 5, 200 | Bắt buộc. Gồm đúng 2 số dương (nhỏ nhất, lớn nhất), tính theo tiền tệ mặc định ở trên. |
| Trọng lượng sản phẩm tối đa (KG) | 30 | Phải lớn hơn 0. |
| Trọng lượng được nhập tối đa (KG) | 30 | |
| Quốc gia đầu vào | Trung Quốc | Bắt buộc. Chọn quốc gia đầu vào đã tạo ở bước 1. |
| Kích thước tem in (cm) | 10x15 | Khổ tem dán lên kiện hàng, định dạng rộngxcao. |
| Thời gian vận chuyển dự kiến (Ngày) | 7 | Không được âm. |
| Các trạng thái bao hàng được phép cập nhật | Tùy nghiệp vụ | Tích chọn các trạng thái mà nhân viên được phép cập nhật cho bao hàng. |
| Mẫu tên tập tin các mã vận đơn khai báo hải quan | Ví dụ ma-van-don-hai-quan | Bắt buộc. |
| Mẫu tên tập tin các bao hàng khai báo hải quan | Ví dụ bao-hang-hai-quan | Bắt buộc. |
| Mẫu tên tập tin các khách hàng phân chia mã đơn | Ví dụ khach-hang-phan-chia-ma-don | |
| Mẫu tên tập tin các mã vận đơn của khách hàng | Ví dụ ma-van-don-khach-hang |
Bấm Lưu sau khi điền xong.
Phân chia mã đơn
| Trường | Giá trị gợi ý | Ghi chú |
|---|---|---|
| Trình thêm thông báo có phần hàng mới | Bấm Bắt đầu | Bật để hệ thống gửi thông báo khi có đơn hàng mới. |
| Loại giao diện quản trị | Tùy chọn | Giao diện dùng trên trang phân chia mã đơn. |
| Thời gian trễ thông báo có đơn hàng mới | 60 | Tính bằng giây. |
| Kho nhận hàng mặc định | Kho Hà Nội | Chọn kho đặt tại quốc gia nhận đã tạo ở bước 4. |
| Tên sản phẩm mặc định | Ví dụ Hàng hóa | Dùng khi đơn hàng chưa có tên sản phẩm. |
| Đơn giá vận chuyển mặc định / 1kg | Ví dụ 30000 | Áp dụng cho khách hàng chưa có đơn giá riêng. |
| Người trả phí vận chuyển mặc định | Người gửi hoặc người nhận | |
| Kích thước giấy in (cm) | 21x29.7 | Khổ giấy khi in danh sách mã vận đơn, danh sách khách hàng. 21x29.7 là khổ A4, định dạng rộngxcao. |
| Thời gian giao hàng dự kiến (Ngày) | 3 | |
| Các phương thức vận chuyển có sẵn | Ví dụ Đường bộ, Đường biển | |
| Thông báo khi cập nhật cân nặng / đơn giá | Tùy chọn | Gửi thông báo cho khách hàng khi cân nặng hoặc đơn giá thay đổi. |
| Câu lệnh theo dõi vận đơn | Tùy chọn | |
| Các nhóm trạng thái vận đơn người dùng có thể tìm kiếm | Ví dụ AT_INBOUND_WAREHOUSE, ALREADY_AT_DOMESTIC_WAREHOUSE |
Bấm Lưu sau khi điền xong.
Các phần còn lại (không bắt buộc)
- Cài đặt phương tiện: các trạng thái xe chi tiết, tên nhóm media phương tiện (ví dụ
CO, Invoice). - Dịch vụ theo dõi vận đơn bên ngoài: mẫu đường dẫn theo dõi, ví dụ
https://tracking.com?id=. - Hoa hồng cho cộng tác viên và Kế toán: bật các trình tính hoa hồng, cập nhật công nợ, ghi sổ cái khi cần.
Kiểm tra lại
Sau khi hoàn tất, hãy đảm bảo:
- [ ] Có ít nhất 2 quốc gia: 1 quốc gia đầu vào và 1 quốc gia nhận.
- [ ] Có ít nhất 1 tiền tệ đã kích hoạt, và Mã tiền tệ mặc định trong cài đặt EzyDelivery trỏ đúng tiền tệ đó.
- [ ] Có cửa hàng mặc định đang ở trạng thái ACTIVATED.
- [ ] Cửa hàng mặc định có ít nhất 1 kho ở quốc gia đầu vào và 1 kho ở quốc gia nhận.
- [ ] Đã chọn Quốc gia đầu vào và Kho nhận hàng mặc định trong cài đặt EzyDelivery.
- [ ] Đã nhập danh sách người dùng giả có quyền
fake_receiver. - [ ] Đã khai báo Kích thước tem in (ví dụ
10x15) và Kích thước giấy in (ví dụ21x29.7).
Đến đây bạn có thể bắt đầu nhập mã vận đơn và phân chia mã đơn cho khách hàng.