DHL Express Shipping - Tích hợp DHL REST API

Điểm chính

• • Tích hợp DHL REST API hiện đại với hiệu suất cao

• • Tính phí vận chuyển tự động dựa trên trọng lượng và địa chỉ

• • Tạo vận đơn DHL trực tiếp từ phiếu xuất kho

• • In nhãn vận chuyển định dạng PDF hoặc thermal (8x4, 6x4)

• • Theo dõi trạng thái vận đơn qua tracking number

• • Tạo nhãn hoàn trả cho khách hàng (tự động hoặc thủ công)

• • Hỗ trợ khai báo hải quan cho hàng quốc tế

• • Tính bảo hiểm vận chuyển tự động

Phân quyền sử dụng

Các bước thực hiện

• 1. Vào Inventory → Configuration → Delivery → Shipping Methods

• 2. Nhấn New và điền: Shipping Method (tên), Provider (DHL), Delivery Product

• 3. Tab DHL Configuration - Thông tin xác thực: DHL API Key, DHL API Secret, DHL Account Number

• 4. Cấu hình khu vực: Region (AP cho Việt Nam, AM cho Mỹ, EU cho châu Âu)

• 5. Chọn DHL Product: D - Express Worldwide (phổ biến nhất)

• 6. Cấu hình kiện hàng: DHLxw Package Type (DHL Box), Unit System (Metric cho kg/cm)

• 7. Cấu hình nhãn: Label Image Format (PDF), Label Template (8X4_A4_PDF)

• 8. Tùy chọn: Dutiable Material (hàng quốc tế), Duties paid by, Return label on delivery

Điểm chính

• • Yếu tố ảnh hưởng: Trọng lượng tổng, địa chỉ gửi/nhận, loại sản phẩm DHL, khai báo hải quan, bảo hiểm

• • Lưu ý: Sản phẩm phải có weight > 0, địa chỉ đầy đủ (street, city, zip, country, phone)

Các bước thực hiện

• 1. Tạo đơn hàng mới: Sales → Orders → New

• 2. Thêm sản phẩm vào đơn hàng

• 3. Chọn địa chỉ giao hàng (Delivery Address)

• 4. Nhấn Add Shipping

• 5. Chọn phương thức DHL

• 6. Nhấn Get Rate → hệ thống tự động tính phí

Điểm chính

• • Thông tin gửi DHL: Người gửi (warehouse), người nhận (customer), danh sách kiện hàng, trọng lượng/kích thước, giá trị hàng hóa, khai báo hải quan

• • Kết quả: Tracking number, nhãn vận chuyển PDF, tài liệu hải quan (nếu có)

Các bước thực hiện

• 1. Xác nhận đơn hàng → tạo phiếu xuất kho (Delivery Order)

• 2. Mở phiếu xuất kho

• 3. Kiểm tra: Địa chỉ giao hàng đầy đủ, trọng lượng chính xác, Carrier = DHL

• 4. Nhấn Validate để xác nhận xuất kho

• 5. Hệ thống tự động: Gọi DHL API, tạo tracking number, tải nhãn, đính kèm vào chatter

Các bước thực hiện

• 1. Mở phiếu xuất kho đã validate

• 2. Vào tab Chatter (phía dưới form)

• 3. Tìm attachment: LabelShipping-DHL-[tracking_number].pdf

• 4. Nhấn vào file để xem hoặc tải về

• 5. In nhãn trên giấy A4 hoặc máy in thermal

Định dạng nhãn

Điểm chính

• • Xem tracking: Trường Tracking Reference trên Delivery Order, tab Delivery của Sales Order

• • Theo dõi trực tuyến: Nhấn nút Tracking hoặc truy cập http://www.dhl.com/en/express/tracking.html?AWB=[tracking_number]

• • Trạng thái: Shipment information received, Picked up, In transit, Out for delivery, Delivered, Exception

Điểm chính

• • Tự động: Bật Return label on delivery trong cấu hình, nhãn tự động tạo khi validate phiếu xuất kho

• • Thủ công: Tạo phiếu nhập kho (Return) từ đơn hàng, chọn DHL làm carrier, validate phiếu nhập kho

• • File nhãn: LabelReturn-DHL-[tracking_number].pdf

• • Lưu ý: Nhãn hoàn trả có service code PV (Proof of Value), không tự động pickup, khách hàng mang đến điểm DHL

Điểm chính

• • DHL REST API không hỗ trợ hủy vận đơn hoàn toàn

• • Khi nhấn Cancel: Tracking number bị xóa khỏi Odoo, carrier price reset về 0

• • Cách xử lý: Liên hệ trực tiếp DHL qua hotline/portal, cung cấp tracking number, yêu cầu hủy pickup/void shipment

• • Sau khi DHL xác nhận, xóa tracking number trong Odoo

Điểm chính

• • Chuẩn bị: Kiểm tra trọng lượng chính xác, cập nhật kích thước package type, địa chỉ đầy đủ, số điện thoại liên hệ

• • Tối ưu chi phí: Chọn đúng sản phẩm DHL (Express 12:00 rẻ hơn Express 9:00), đóng gói gọn nhẹ, package type phù hợp, bảo hiểm chỉ cho hàng giá trị cao

• • Hàng quốc tế: Bật Dutiable Material, điền đầy đủ HS Code, chọn Incoterm phù hợp, kiểm tra tài liệu hải quan

• • Quản lý nhãn: Lưu template phù hợp với máy in, in thử trước khi gửi thực tế, backup file PDF, máy in thermal cho khối lượng lớn

Lỗi và giải pháp