Tạo lô hàng thông qua API
Sau khi tính toán Landed Cost và tạo một đơn hàng, bạn có thể gửi số theo dõi và các chi tiết lô hàng khác cho Zonos thông qua API.
Sử dụng quy trình này khi bạn đang tạo lô hàng cho một đơn hàng hiện có và không cần sửa đổi chi tiết mục hoặc bên. Nó hỗ trợ số theo dõi tùy chọn, trung tâm thực hiện, lựa chọn mức dịch vụ và bảo hiểm giá trị được khai báo.
mutation CreateShipment($input: ShipmentCreateWorkflowInput!) { shipmentCreateWorkflow(input: $input) { id status trackingDetails { number } serviceLevel { id name carrier { id name } } shipmentCartons { id carton { id width length height weight items { item { id amount description } } } label { url trackingNumber id documentFiling } } }}Tùy chọn biến:
- Với Fulfillment Center: Thêm
"fulfillmentCenter": "fulfillment_center_12345"để chỉ định vị trí bắt nguồn - Với Custom Tracking: Đặt
"generateLabel": falsevà thêm"trackingNumbers": ["tracking_1", "tracking_2"] - Với Service Level: Thêm
"serviceLevel": "dhl.express_example"để chọn dịch vụ vận chuyển cụ thể - Với Declared Value Insurance: Thêm
"isDeclaredValue": trueđể bật bảo hiểm giá trị được khai báo
Giá trị được khai báo
Đặt "isDeclaredValue": true để bật bảo hiểm giá trị được khai báo cho tất cả các mục trong lô hàng của bạn. Zonos tự động khai báo giá trị đầy đủ của tất cả các mục được gửi trong đơn hàng; thương nhân không thể sửa đổi số tiền này. Điều này đặt trách nhiệm tối đa mà nhà vận chuyển sẽ chấp nhận trong trường hợp mất, hư hỏng hoặc trộm cắp trong quá trình vận chuyển. Tính năng này chỉ được hỗ trợ cho các lô hàng UPS, FedEx và DHL. Zonos tự động xử lý triển khai cụ thể của nhà vận chuyển khi bạn bật giá trị được khai báo, bao gồm các tham số thích hợp trong các lệnh gọi API của chúng tôi cho các nhà vận chuyển này, vì vậy bạn không cần phải quản lý các yêu cầu khác nhau của nhà vận chuyển.
Giới hạn của UPS: UPS chỉ bao gồm các giá trị từ 100,01-50.000 USD và xử lý giá trị được khai báo ở cấp độ thùng. Đối với các lô hàng đa thùng, thương nhân phải chia nhỏ lô hàng để chỉ định phạm vi bảo hiểm cho mỗi thùng. UPS cũng tạo ra một biểu mẫu bảo hiểm bổ sung (UPS Control Log) phải được in cùng với các nhãn cho các giá trị được khai báo trên 999 USD.
FedEx và DHL: Xử lý giá trị được khai báo ở cấp độ lô hàng mà không có hạn chế bổ sung.
Dịch vụ đặc biệt
Sử dụng specialServices trên một thùng để chỉ ra yêu cầu xử lý đặc biệt cho pin, khí lạnh, hàng hóa nguy hiểm hoặc yêu cầu chữ ký. Xem hướng dẫn dịch vụ đặc biệt để biết chi tiết và ví dụ đầy đủ.
Hủy lô hàng
Để hủy nhãn đã tạo, hãy sử dụng mutation sau để hủy lô hàng. Bất kỳ nhãn liên kết nào cũng sẽ bị hủy tự động. Lưu ý rằng sau khi lô hàng bị hủy, nó không thể được cập nhật hoặc khôi phục.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_12345678-1234-1234-1234-123456789stu" status: VOIDED note: "Voiding shipment" } ) { id status }}
Tạo lô hàng cho các đơn hàng hiện có
Tạo lô hàng và nhãn bằng Zonos API sau khi tính toán chi phí hạ cánh và tạo các đơn hàng.
GraphQL
Hướng dẫn này được thiết kế cho những người dùng đã tích hợp với Zonos API và cần tạo lô hàng cho các đơn hàng hiện có trong hệ thống của họ. Nếu bạn là nền tảng vận chuyển và muốn cung cấp khả năng tạo lô hàng Zonos cho khách hàng của bạn thay vào đó, hãy xem hướng dẫn Shipment API của chúng tôi.
Nếu bạn đã tích hợp với Zonos API và được phê duyệt để vận chuyển ngoài Dashboard, hãy sử dụng mutation
shipmentCreateWorkflowđể tạo lô hàng và cung cấp thông tin theo dõi. Những mutation này cũng cho phép bạn thông báo cho Zonos về các lô hàng nội địa đến các cơ sở giao hàng chéo.Lưu ý: Nếu bạn đang sử dụng ứng dụng Duty and Tax với nền tảng tự động đồng bộ hóa số theo dõi với Zonos, hoặc nếu bạn đang vận chuyển trực tiếp thông qua Dashboard, những mutation này là không cần thiết.