Easypost Shipping
Tích hợp đa nhà vận chuyển qua Easypost
Module Easypost Shipping tích hợp Odoo với dịch vụ vận chuyển Easypost, cho phép kết nối với nhiều đơn vị vận chuyển (FedEx, UPS, USPS, DHL, v.v.) qua một tài khoản Easypost duy nhất.
Tính phí vận chuyển tự động, tạo nhãn vận chuyển, theo dõi lô hàng theo thời gian thực, tạo nhãn trả hàng và quản lý bảo hiểm hàng hóa.
Lợi ích chính
Điểm chính
• Tiết kiệm thời gian: Không cần đăng nhập nhiều trang web của đơn vị vận chuyển
• So sánh giá: Xem giá của nhiều đơn vị vận chuyển cùng lúc
• Tự động hóa: Tạo nhãn và theo dõi tự động từ phiếu xuất kho
• Linh hoạt: Hỗ trợ nhiều loại kiện hàng và cấp độ dịch vụ
• Bảo hiểm: Quản lý bảo hiểm hàng hóa tích hợp
• Trả hàng: Tạo nhãn trả hàng dễ dàng
Thuật ngữ chính
| Fields | Trường dữ liệu | Description |
|---|---|---|
| Carrier | Đơn vị vận chuyển | Nhà cung cấp dịch vụ vận chuyển (FedEx, UPS, USPS, DHL) |
| Carrier Prefix | Tiền tố đơn vị vận chuyển | Mã định danh ngắn của carrier |
| Default Package Type | Loại kiện hàng mặc định | Loại kiện hàng được sử dụng mặc định |
| Default Service Level | Cấp độ dịch vụ mặc định | Dịch vụ vận chuyển mặc định (Express, Ground, v.v.) |
| Production API Key | Khoá API production | API key cho môi trường thực tế |
| Test API Key | Khoá API kiểm thử | API key cho môi trường test |
| Label Format | Định dạng nhãn | Định dạng file nhãn (PDF, PNG, ZPL, EPL2) |
| Insurance fee rate (USD) | Mức phí bảo hiểm (USD) | Tỷ lệ phí bảo hiểm |
Cấu hình tài khoản Easypost
Trước tiên, bạn cần đăng ký tài khoản Easypost và lấy API Keys để tích hợp với Odoo.
Các bước thực hiện
1. Truy cập https://www.easypost.com và nhấn Sign up để tạo tài khoản mới
2. Hoàn tất quy trình đăng ký và xác thực email
3. Đăng nhập vào Dashboard của Easypost
4. Nhấn vào mũi tên cạnh tên người dùng, chọn API Keys
5. Sao chép Test API Key (dùng để kiểm thử) và Production API Key (dùng cho môi trường thực tế)
6. Vào Carrier Accounts, thêm tài khoản của các đơn vị vận chuyển bạn muốn sử dụng (FedEx, UPS, USPS, DHL)
7. Nhập thông tin đăng nhập của từng đơn vị vận chuyển
Thiết lập phương thức vận chuyển
Sau khi có API Keys, tạo phương thức vận chuyển Easypost trong Odoo.
Các bước thực hiện
1. Vào Inventory → Configuration → Shipping Methods
2. Nhấn New để tạo mới
3. Điền Shipping Method (ví dụ: "Easypost FedEx"), chọn Provider = Easypost, chọn Company
4. Nhấn Save
5. Trong tab Easypost Configuration, dán Test API Key và Production API Key
6. Nhấn Save
7. Nhấn nút Load your Easypost carrier accounts
8. Hệ thống hiển thị danh sách các đơn vị vận chuyển đã cấu hình trong Easypost
9. Chọn đơn vị vận chuyển bạn muốn sử dụng (ví dụ: FedEx, UPS)
10. Nhấn Select
Cấu hình loại kiện hàng và dịch vụ
Hệ thống tự động tải danh sách loại kiện hàng và cấp độ dịch vụ sau khi chọn carrier.
Điểm chính
• Default Package Type: Chọn loại kiện hàng phù hợp (FedEx Envelope, FedEx Box, UPS Letter, USPS Flat Rate Envelope, v.v.)
• Vào Inventory → Configuration → Package Types để xem/chỉnh sửa kích thước kiện hàng
• Default Service Level (tùy chọn): Chọn dịch vụ (FEDEX_GROUND, FEDEX_2_DAY, UPS Ground, USPS Priority)
• Nếu không chọn: Hệ thống tự động chọn dịch vụ rẻ nhất có sẵn
• Label Format: Chọn PDF (máy in thông thường), PNG (hình ảnh), ZPL (máy in Zebra), EPL2 (máy in cũ)
• Test Mode: Bật để sử dụng Test API Key, tắt để dùng Production API Key
Tính phí vận chuyển trên đơn bán hàng
Để tính phí chính xác, đảm bảo sản phẩm có trọng lượng, địa chỉ giao hàng đầy đủ và loại kiện hàng mặc định đã được cấu hình.
Các bước thực hiện
1. Tạo hoặc mở đơn bán hàng (Sale Order)
2. Điền đầy đủ thông tin: khách hàng với địa chỉ giao hàng, sản phẩm với trọng lượng
3. Chuyển sang tab Other Info
4. Trong trường Delivery Method, chọn phương thức Easypost đã cấu hình
5. Nhấn nút Set price hoặc Get Rate
6. Hệ thống gọi API Easypost để lấy giá vận chuyển
7. Tự động thêm dòng phí vận chuyển vào đơn hàng
8. Giá hiển thị theo đơn vị tiền tệ của đơn hàng
Thông tin cần thiết để tính phí
Required Information
| Thông tin | Vị trí kiểm tra |
|---|---|
| Trọng lượng sản phẩm | Product → Inventory tab → Weight |
| Địa chỉ giao hàng đầy đủ | Customer → Addresses → Delivery Address |
| Địa chỉ kho xuất hàng | Warehouse → Address |
| Loại kiện hàng | Delivery Method → Default Package Type |
Tạo nhãn vận chuyển
Sau khi xác nhận đơn hàng và validate phiếu xuất kho, bạn có thể tạo nhãn vận chuyển.
Các bước thực hiện
1. Xác nhận đơn bán hàng để tạo phiếu xuất kho (Delivery Order)
2. Mở phiếu xuất kho
3. Kiểm tra trường Carrier đã được điền (phương thức Easypost)
4. Nhấn Validate để xác nhận xuất hàng
5. Sau khi validate, nhấn nút Send to Shipper
6. Hệ thống gọi API Easypost để tạo lô hàng (shipment)
7. Mua nhãn vận chuyển với giá đã chọn
8. Tải nhãn vận chuyển về và đính kèm vào phiếu xuất kho
9. Ghi lại số theo dõi (tracking number)
10. Gửi thông báo vào chatter
Xem và in nhãn vận chuyển
Điểm chính
• Trong phiếu xuất kho, cuộn xuống phần Chatter (bên dưới)
• Tìm thông báo "Shipment created into Easypost"
• Nhấn vào file đính kèm (ví dụ: Label-TRACKING123.pdf)
• In nhãn và dán lên kiện hàng
• Nếu có nhiều kiện hàng, sẽ có nhiều file nhãn tương ứng
• Sử dụng Put in Pack để tạo nhiều kiện, mỗi kiện sẽ có nhãn riêng
Theo dõi lô hàng
Số theo dõi và link theo dõi được tự động ghi vào phiếu xuất kho và có thể chia sẻ với khách hàng.
Điểm chính
• Mở phiếu xuất kho và xem trường Tracking Reference (Số theo dõi)
• Nếu có nhiều kiện, số theo dõi sẽ được phân cách bằng dấu "+"
• Nhấn vào nút Tracking trên phiếu xuất kho
• Hệ thống mở trang theo dõi của Easypost
• Khách hàng có thể theo dõi trạng thái lô hàng theo thời gian thực
• Số theo dõi tự động gửi qua email xác nhận giao hàng (nếu đã cấu hình email template)
Tạo nhãn trả hàng
Easypost hỗ trợ tạo nhãn trả hàng tự động hoặc thủ công khi khách hàng cần trả hàng.
Điểm chính
• Thủ công: Mở phiếu xuất kho đã giao hàng, nhấn Return, chọn sản phẩm cần trả, xác nhận tạo phiếu trả hàng, nhấn Send to Shipper
• Tự động: Bật tùy chọn Return Label on Delivery trong Delivery Method → Configuration
• Khi tạo nhãn giao hàng, hệ thống sẽ tự động tạo thêm nhãn trả hàng
• Cả hai nhãn đều được đính kèm vào phiếu xuất kho
• Lợi ích: Khách hàng có sẵn nhãn trả hàng trong kiện hàng, dễ dàng trả hàng nếu cần
Quản lý bảo hiểm hàng hóa
Easypost cho phép bảo hiểm hàng hóa với phí được tính tự động dựa trên giá trị đơn hàng.
Các bước thực hiện
1. Vào Delivery Method → Configuration
2. Tìm trường Shipping Insurance (Bảo hiểm vận chuyển)
3. Nhập phần trăm giá trị cần bảo hiểm (ví dụ: 100 = bảo hiểm 100% giá trị hàng)
4. Nhấn Save
5. Nhấn nút Load Insurance Fees (nếu có) để tự động lấy mức phí bảo hiểm từ tài khoản Easypost
6. Hệ thống lưu Insurance fee rate (tỷ lệ phí) và Insurance fee minimum (phí tối thiểu)
7. Khi tính phí vận chuyển hoặc tạo nhãn, hệ thống tự động tính giá trị bảo hiểm và cộng phí bảo hiểm
Xử lý lỗi thường gặp
Common Errors
| Lỗi | Nguyên nhân | Giải pháp |
|---|---|---|
| Production key required | Chưa nhập Production API Key | Vào Delivery Method, nhập Production API Key, lưu lại và thử lại |
| Weight is missing | Sản phẩm chưa có trọng lượng | Vào Product → Inventory tab, nhập Weight, lưu lại và tính phí lại |
| Package type not configured | Loại kiện hàng không phù hợp với carrier | Chọn loại kiện hàng phù hợp với carrier hoặc nhập kích thước tùy chỉnh |
| No carrier linked | Chưa cấu hình tài khoản carrier trong Easypost | Đăng nhập Easypost Dashboard, vào Carrier Accounts, thêm ít nhất một carrier |
| No rate available | Dịch vụ không khả dụng cho tuyến đường này | Xóa Default Service Level để hệ thống tự chọn, hoặc chọn dịch vụ khác |
| Easypost do not provide shipments | Dữ liệu đơn hàng thiếu hoặc không hợp lệ | Bật Log XML để xem chi tiết, kiểm tra địa chỉ đầy đủ, trọng lượng > 0, loại kiện hàng phù hợp |
| Cannot cancel Easypost shipping | Easypost API không hỗ trợ hủy lô hàng | Liên hệ trực tiếp với đơn vị vận chuyển hoặc đăng nhập Easypost Dashboard để xử lý |
Mẹo sử dụng thực tế
Điểm chính
• Tối ưu chi phí: Không chọn Default Service Level để hệ thống tự động chọn dịch vụ rẻ nhất, sử dụng kiện hàng chuẩn (Flat Rate Box), cân đo chính xác
• Quản lý nhiều carrier: Tạo nhiều phương thức Easypost, mỗi phương thức cho một carrier, đặt tên rõ ràng (Easypost - FedEx Ground, Easypost - UPS 2-Day)
• Kiểm thử: Luôn kiểm thử với Test API Key trước, tạo vài đơn hàng thử nghiệm, kiểm tra nhãn in ra đúng định dạng, chuyển sang Production API Key khi sẵn sàng
• Vận chuyển quốc tế: Đảm bảo sản phẩm có HS Code (mã hải quan), điền đầy đủ Country of Origin (nước xuất xứ), Easypost tự động tạo commercial invoice