UPS Shipping - Tích hợp UPS REST API

Điểm chính

• • Tích hợp UPS REST API mới nhất với hiệu suất cao

• • Tính phí vận chuyển tự động trên đơn bán hàng

• • Tạo lô hàng và in nhãn vận chuyển UPS

• • Tạo nhãn trả hàng tự động hoặc thủ công

• • Theo dõi lô hàng trực tuyến real-time

• • Hỗ trợ COD (thu tiền khi giao hàng)

• • Hỗ trợ giao hàng thứ 7

• • Xuất hóa đơn tài khoản UPS của khách hàng

• • Tạo hóa đơn thương mại quốc tế tự động

Phân quyền sử dụng

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

• 1. Tạo tài khoản trên ups.com: Đăng ký tài khoản doanh nghiệp, lấy Số tài khoản UPS (Account Number)

• 2. Tạo ứng dụng trên developer.ups.com: Đăng nhập, vào Apps và tạo ứng dụng mới

• 3. Điền thông tin: Tên ứng dụng, Callback URL (địa chỉ Odoo), chọn API: Authorization, Address validation, Locator, Paperless Documents, Shipping and Rating

• 4. Chấp nhận điều khoản và lưu

• 5. Lấy Client ID và Client Secret từ ứng dụng vừa tạo

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 (UPS), Company

• 3. Tab UPS Configuration - Thông tin xác thực: UPS Account Number, UPS Client ID, UPS Client Secret

• 4. Cấu hình dịch vụ: UPS Service Type (Ground, Next Day, 2nd Day, v.v.)

• 5. Chọn UPS Package Type (loại kiện hàng mặc định)

• 6. Cấu hình đơn vị: Package Weight Unit (Pounds/Kilograms), Package Size Unit (Inches/Centimeters)

• 7. Chọn Label Format: PDF, ZPL, EPL, SPL

• 8. Nhấn Save và kiểm tra kết nối bằng đơn hàng test

Điểm chính

• • Điều kiện: Địa chỉ công ty đầy đủ (city, country, phone, street, ZIP, state nếu US/CA/IE), địa chỉ kho đầy đủ, địa chỉ khách hàng đầy đủ, tất cả sản phẩm có trọng lượng

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

• 1. Vào Sales → Orders → Quotations

• 2. Tạo hoặc mở đơn hàng

• 3. Điền đầy đủ: Khách hàng, địa chỉ giao hàng, sản phẩm và số lượng

• 4. Nhấn Add Shipping

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

• 6. Hệ thống tự động: Gọi UPS API, thêm dòng phí vận chuyển, hiển thị giá theo đơn vị tiền tệ

Điểm chính

• • Thông tin trên nhãn: Mã vạch tracking, địa chỉ gửi/nhận, loại dịch vụ, trọng lượng, mã tham chiếu

• • In nhãn: Nhãn lưu dạng file đính kèm trong chatter (LabelUPS.pdf), tải xuống và in

• • Hóa đơn thương mại: Với lô hàng quốc tế, tự động tạo Commercial Invoice (UPSCommercialInvoice.pdf)

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

• 1. Xác nhận đơn hàng (Confirm Sale Order)

• 2. Vào Inventory → Operations → Transfers

• 3. Mở phiếu xuất kho (Delivery Order) tương ứng

• 4. Xác nhận số lượng và đóng gói (Validate)

• 5. Nhấn Send to Shipper

• 6. Hệ thống tự động: Gọi UPS Shipping API, tạo lô hàng, tải nhãn, gắn nhãn vào chatter, cập nhật tracking number

Điểm chính

• • Thủ công: Mở phiếu xuất kho đã gửi → Nhấn Return → Tạo return picking → Xác nhận → Nhấn Get Return Label

• • Tự động: Bật Return Label on Delivery trong cấu hình, nhãn trả hàng tự động tạo khi gửi lô hàng

• • Lưu ý: Địa chỉ gửi/nhận đảo ngược, Duty payment luôn là RECIPIENT, mô tả có tiền tố "return"

Điểm chính

• • Xem số theo dõi: Trường Tracking Reference trên delivery order, nếu nhiều kiện thì nối bằng dấu +

• • Theo dõi trực tuyến: Nhấn Track the shipment hoặc link tracking, mở trang UPS tracking

• • URL: http://wwwapps.ups.com/WebTracking/track?track=yes&trackNums=[TRACKING_NUMBER]

Điểm chính

• • Điều kiện: Chỉ hủy được lô hàng chưa được UPS lấy hàng

• • Sau khi hủy: Có thể sửa thông tin và nhấn Send to Shipper lại

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

• 1. Mở phiếu xuất kho đã gửi

• 2. Nhấn Cancel Shipment

• 3. Xác nhận hủy

• 4. Hệ thống: Gọi UPS Void API, xóa tracking number, đặt lại giá về 0, ghi log: "Shipment #[tracking] has been cancelled"

Điểm chính

• • Sử dụng: Tạo đơn hàng với UPS có Bill My Account, trường UPS account number xuất hiện, nhập số tài khoản UPS khách hàng

• • Khi tính phí: Giá hiển thị 0 (khách hàng tự trả), dòng vận chuyển: "[UPS] UPS Billing will remain to the customer"

• • Khi tạo lô hàng: UPS xuất hóa đơn trực tiếp cho tài khoản khách hàng

• • Lưu số tài khoản: Vào Contacts → Customers → Tab Sales & Purchase → Điền UPS Account Number

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

• 1. Vào phương thức vận chuyển UPS

• 2. Tab UPS Configuration → Options

• 3. Bật Bill My Account

• 4. Lưu

Điểm chính

• • Saturday Delivery: Bật để giao hàng thứ 7 (không khả dụng với Ground, Standard, v.v.), phí cao hơn

• • COD (Cash on Delivery): Bật Cash on Delivery, chọn COD Funding Option (Check/MoneyOrder), UPS thu tiền khi giao, chỉ cho phép payment provider COD

• • Require Signature: Bật để yêu cầu người nhận ký tên khi giao, tăng độ an toàn cho hàng giá trị cao

• • Duties Payment: Chọn Sender (người gửi trả) hoặc Recipient (người nhận trả) cho lô hàng quốc tế

• • Shipping Insurance: Tab Pricing → Điền Shipping Insurance (%), giá trị bảo hiểm = tổng giá trị sản phẩm × %

Lỗi và giải pháp

Điểm chính

• • Chuẩn bị dữ liệu: Cập nhật đầy đủ địa chỉ công ty và kho, nhập trọng lượng cho tất cả sản phẩm, chuẩn hóa số điện thoại (ít nhất 10 chữ số)

• • Tối ưu chi phí: So sánh loại dịch vụ (Ground rẻ hơn Express), sử dụng Bill My Account cho khách hàng lớn, đóng gói hợp lý để giảm kích thước

• • Quản lý vận chuyển: Bật Return Label on Delivery cho sản phẩm dễ trả (thời trang, điện tử), sử dụng Require Signature cho hàng giá trị cao, theo dõi tracking thường xuyên

• • Vận chuyển quốc tế: Điền đầy đủ HS Code cho sản phẩm, chọn đúng Duties Payment, kiểm tra giới hạn trọng lượng của từng dịch vụ

• • Xử lý lỗi: Kiểm tra log trong chatter, liên hệ UPS support nếu lỗi liên quan tài khoản, sử dụng môi trường test khi thử nghiệm