DHL Delivery (Legacy) - Tích hợp vận chuyển DHL
Tích hợp DHL Express với SOAP API cho vận chuyển quốc tế
Module DHL Delivery tích hợp với dịch vụ DHL Express, cho phép tính phí vận chuyển tự động từ API DHL, tạo vận đơn và in nhãn giao hàng, theo dõi kiện hàng qua mã tracking, tạo nhãn hoàn trả cho khách hàng và khai báo hải quan cho hàng xuất khẩu.
Đây là phiên bản DHL Legacy sử dụng SOAP API. DHL cũng có phiên bản REST API mới hơn trong module delivery_dhl_rest.
Tính năng chính
Điểm chính
• Tính phí vận chuyển tự động từ API DHL dựa trên trọng lượng và địa chỉ
• Tạo vận đơn và in nhãn giao hàng với nhiều định dạng (PDF, EPL2, ZPL2)
• Theo dõi kiện hàng qua tracking number với link trực tiếp DHL
• Tạo nhãn hoàn trả tự động hoặc thủ công
• Khai báo hải quan tự động cho hàng xuất khẩu
• Hỗ trợ nhiều sản phẩm DHL (Express Worldwide, Express 9:00, Express 12:00, Domestic Express)
• Xử lý nhiều định dạng nhãn cho máy in khác nhau
• Hủy vận đơn khi cần thiết
Nhóm người dùng
Phân quyền sử dụng
| Nhóm | Vai trò chính |
|---|---|
| Nhân viên bán hàng | Tính phí vận chuyển trên báo giá/đơn hàng |
| Nhân viên kho | Tạo vận đơn, in nhãn, đóng gói kiện hàng |
| Quản lý logistics | Cấu hình phương thức giao hàng, theo dõi chi phí |
Bảng tra cứu thuật ngữ EN/VI
| Fields | Trường dữ liệu | Description |
|---|---|---|
| DHL SiteID | DHL SiteID | Mã định danh tài khoản |
| DHL Password | Mật khẩu DHL | Mật khẩu API |
| DHL Account Number | Số tài khoản DHL | Số tài khoản thanh toán |
| Package Dimension Unit | Đơn vị kích thước kiện hàng | Centimeters hoặc Inches |
| Package Weight Unit | Đơn vị trọng lượng kiện hàng | Kilograms hoặc Pounds |
| Region | Khu vực | Asia Pacific, America, Europe |
| DHL Product | Sản phẩm DHL | D - Express Worldwide, E - Express 9:00, N - Domestic Express |
| Dutiable Material | Hàng hóa chịu thuế | Hàng có tính thuế |
| Duty Payment | Thanh toán thuế | Sender hoặc Recipient |
| Label Image Format | Định dạng ảnh nhãn | PDF, EPL2, ZPL2 |
| Label Template | Mẫu nhãn | 8X4_A4_PDF, 8X4_thermal |
Cấu hình tài khoản DHL
Để sử dụng module, cần đăng ký tài khoản DHL và lấy thông tin xác thực:
Các bước thực hiện
1. Liên hệ DHL Express để đăng ký tài khoản doanh nghiệp
2. Nhận thông tin: Site ID (mã định danh), Password (mật khẩu API), Account Number (số tài khoản)
3. Yêu cầu DHL kích hoạt quyền truy cập XML API
4. Vào Inventory → Configuration → Delivery → Shipping Methods
5. Tạo phương thức mới, chọn Provider = DHL (Legacy)
6. Tab DHL Configuration: Nhập Site ID, Password, Account Number
7. Chọn Region (AP cho Việt Nam, AM cho Mỹ, EU cho châu Âu)
8. Cấu hình đơn vị: Package Dimension Unit (Centimeters/Inches), Package Weight Unit (Kilograms/Pounds)
Cấu hình phương thức giao hàng
Các bước cấu hình chi tiết:
Các bước thực hiện
1. Chọn DHL Product: D - Express Worldwide (phổ biến nhất), E - Express 9:00, N - Domestic Express, P - Express Worldwide, T - Express 12:00
2. Cấu hình nhãn: Label Image Format (PDF cho máy in thường, EPL2/ZPL2 cho máy in nhiệt)
3. Chọn Label Template: 8X4_A4_PDF (nhãn 8x4 inch trên A4), 6X4_PDF, 8X4_thermal (máy in Zebra/Eltron)
4. Tùy chọn hàng hóa chịu thuế: Tích Dutiable Material nếu gửi hàng quốc tế có thuế
5. Chọn Duty Payment: Sender (người gửi trả) hoặc Recipient (người nhận trả)
6. Cấu hình giá: Để trống để dùng giá thực tế từ DHL, hoặc thêm Fixed Price phụ thu
Tính phí vận chuyển trên đơn hàng
Quy trình tính phí từ Sale Order:
Điểm chính
• Giá cước phụ thuộc: Trọng lượng tổng, kích thước kiện hàng, địa chỉ gửi/nhận, loại dịch vụ, hàng hóa có chịu thuế
Các bước thực hiện
1. Tạo hoặc mở Sale Order
2. Điền đầy đủ: Khách hàng với địa chỉ giao hàng, sản phẩm và số lượng, trọng lượng sản phẩm (bắt buộc)
3. Nhấn Add Shipping
4. Chọn DHL Express từ danh sách
5. Nhấn Get Rate để lấy giá từ DHL
6. Hệ thống hiển thị phí vận chuyển
7. Nhấn Add để thêm vào đơn hàng
Tạo vận đơn và in nhãn
Quy trình tạo vận đơn:
Các bước thực hiện
1. Từ Sale Order, nhấn Delivery để mở phiếu xuất kho
2. Hoặc vào Inventory → Operations → Transfers
3. Kiểm tra: Địa chỉ giao hàng đầy đủ (đường, thành phố, mã bưu điện, quốc gia), số điện thoại người nhận, trọng lượng kiện hàng
4. Nhấn Validate để xác nhận xuất kho
5. Nhấn Send to Shipper để tạo vận đơn DHL
6. Hệ thống hiển thị Tracking Number (mã vận đơn)
7. Nhấn Print Label để tải nhãn PDF
8. In nhãn và dán lên kiện hàng
Theo dõi kiện hàng
Tracking number và theo dõi trên DHL:
Điểm chính
• Xem tracking: Trường Carrier Tracking Ref trên phiếu xuất kho
• Theo dõi trực tuyến: Nhấn Tracking trên phiếu xuất kho hoặc truy cập https://www.dhl.com/tracking
• Nhập mã vận đơn để xem trạng thái
Hủy vận đơn
Khi nào và cách hủy vận đơn:
Điểm chính
• Khi cần hủy: Khách hàng hủy đơn, thông tin giao hàng sai, cần tạo lại với thông tin mới
• Quy trình: Mở phiếu xuất kho có vận đơn DHL → Nhấn Cancel Shipment → Xác nhận hủy
• Lưu ý: Chỉ hủy được vận đơn chưa được DHL lấy hàng, sau khi hủy có thể tạo vận đơn mới
Tạo nhãn hoàn trả
Quy trình tạo return label:
Điểm chính
• Khi cần: Khách hàng muốn trả hàng, hàng giao không thành công cần gửi lại
• Cách tạo: Mở phiếu xuất kho đã có vận đơn → Nhấn Return Label → In nhãn và gửi cho khách hàng
• Nhãn hoàn trả có địa chỉ gửi/nhận đảo ngược
Khai báo hải quan
Yêu cầu khi gửi hàng quốc tế (xuất khẩu):
Các bước thực hiện
1. Vào Inventory → Products → Products
2. Mở sản phẩm cần xuất khẩu
3. Tab Inventory: Điền HS Code (mã hải quan), Country of Origin (nước xuất xứ), Weight (trọng lượng)
4. Khi tạo vận đơn DHL cho hàng quốc tế: Tích Dutiable Material trên phương thức giao hàng
5. Hệ thống tự động gửi thông tin hải quan: Mô tả hàng hóa, giá trị, trọng lượng, nước xuất xứ
Xử lý lỗi thường gặp
Lỗi và giải pháp
| Lỗi | Nguyên nhân | Giải pháp |
|---|---|---|
| Invalid Site ID or Password | Thông tin đăng nhập sai | Kiểm tra Site ID và Password, đảm bảo đã kích hoạt XML API |
| Missing required field: Phone | Thiếu số điện thoại | Điền số điện thoại người nhận |
| Invalid postal code | Mã bưu điện không hợp lệ | Kiểm tra và sửa mã bưu điện, đảm bảo đúng định dạng |
| Package weight exceeds limit | Trọng lượng vượt quá giới hạn | Chia nhỏ thành nhiều kiện hoặc chọn DHL Freight |
| Shipment already exists | Vận đơn đã tồn tại | Kiểm tra vận đơn, hủy vận đơn cũ nếu cần tạo mới |
Mẹo sử dụng thực tế
Điểm chính
• Tối ưu chi phí: Nhập đầy đủ kích thước kiện hàng (DHL tính theo trọng lượng thể tích), chọn đúng loại dịch vụ (Express nhanh nhưng đắt, Economy rẻ hơn), gộp nhiều đơn trong một kiện
• Đảm bảo giao hàng: Kiểm tra địa chỉ kỹ (địa chỉ sai là nguyên nhân chính thất bại), điền số điện thoại (DHL cần liên hệ người nhận), khai báo hải quan đầy đủ
• Quản lý nhãn: Sử dụng máy in nhiệt (nhanh hơn và tiết kiệm), lưu trữ file PDF nhãn để in lại, in dự phòng 1-2 nhãn
• Theo dõi: Cập nhật tracking thường xuyên, thông báo mã tracking cho khách hàng ngay, xử lý nhanh khi có vấn đề