Landed Cost•

Trang chủCho các nhà cung cấp logistics Landed Cost Tích hợp vận chuyển nền tảng

Tạo lô hàng từ nền tảng của bạn

Cho phép khách hàng tạo lô hàng Zonos và nhãn từ nền tảng của bạn.

Hướng dẫn này được thiết kế cho các nhà phát triển nền tảng vận chuyển muốn tích hợp khả năng tạo lô hàng Zonos vào nền tảng của họ cho khách hàng của họ. Nếu bạn đã sử dụng Zonos API và thay vào đó chỉ cần tạo lô hàng cho các đơn hàng hiện có, hãy xem hướng dẫn tạo lô hàng của chúng tôi.

Nếu bạn là nền tảng vận chuyển hỗ trợ khách hàng Zonos vận chuyển quốc tế, việc tích hợp với Zonos để tạo lô hàng nên là một ưu tiên hàng đầu. Điều này sẽ cho phép bạn cung cấp trải nghiệm liền mạch nhất cho thương nhân của bạn và khách hàng của họ bằng cách tận dụng các tính năng hiện có của nền tảng của bạn trong khi để Zonos quản lý việc tạo lô hàng, nhãn và tài liệu hải quan hỗ trợ.

Ưu điểm của việc sử dụng Zonos để tạo lô hàng bao gồm:

Hóa đơn bên thứ ba cho các khoản thuế và phí - Chúng tôi sẽ đảm bảo rằng số tài khoản nhà cung cấp dịch vụ vận chuyển của bạn hoặc thương nhân được sử dụng cho phí vận chuyển trong khi các hóa đơn cho các khoản thuế và phí đến Zonos.
Tính linh hoạt - Thay vì thực hiện công việc phát triển để đảm bảo rằng bạn có thể tạo nhãn tuân thủ với nền tảng của mình, hãy tích hợp với API của chúng tôi và để Zonos quản lý sự tuân thủ biên giới thay đổi liên tục.
Tài liệu hải quan chính xác - Khi bạn sử dụng Zonos để tạo nhãn, chúng tôi đảm bảo rằng các chi tiết đúng được chuyển đến nhà cung cấp dịch vụ để đảm bảo rằng gói hàng qua được hải quan nhanh chóng.

Hướng dẫn này sẽ hướng dẫn bạn qua các bước để thực hiện một tích hợp đầu cuối hoàn chỉnh sẽ cho phép bạn gọi Zonos cho các lô hàng từ nền tảng của bạn.

Bật in nhãn

Làm theo các bước dưới đây để cho phép khách hàng của bạn truy xuất nhãn Zonos từ nền tảng của bạn.

Cho phép thông tin xác thực API

Tạo một lô hàng

Để truy xuất một label, bạn cần tạo một shipment mà label sẽ được liên kết. Zonos quản lý quy trình này bằng một quy trình làm việc tạo shipments và labels trong cùng một yêu cầu. Khi thực hiện phép biến đổi này, bạn không cần phải chuyển serviceLevel vì chúng tôi sẽ sử dụng serviceLevel được sử dụng từ landedCost được liên kết với order. Đối với orderId, bạn có thể sử dụng ID đơn hàng Zonos hoặc accountOrderNumber có thể đã có trong hệ thống của bạn.

Khi một lô hàng và nhãn được tạo thành công, chúng tôi sẽ trả lại nhãn dưới dạng labelImage đó là BASE64_ENCODED_IMAGE, hoặc dưới dạng url nơi có thể tìm nạp nhãn.

Sử dụng quy trình làm việc này khi bạn tạo một lô hàng cho một đơn hàng hiện có và không cần sửa đổi các chi tiết mục hoặc bên. Nó hỗ trợ các số theo dõi, trung tâm hoàn tất đơn hàng, lựa chọn mức dịch vụ và bảo hiểm giá trị khai báo tùy chọn.

Thương nhân Shopify

Shopify chuyển giá trị null cho person trong bên xuất xứ. Do đó, chỉ riêng orderId sẽ không hoạt động đối với các thương nhân Shopify — hãy sử dụng tab Tạo lô hàng nâng cao thay vào đó, đồng thời cung cấp các chi tiết bên đầy đủ bao gồm person.

1mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {

2 shipmentCreateWorkflow(input: $input) {

3 id

4 status

5 trackingDetails {

6 number

7 }

8 serviceLevel {

9 id

10 name

11 carrier {

12 id

13 name

14 }

15 }

16 shipmentCartons {

17 id

18 carton {

19 id

20 width

21 length

22 height

23 weight

24 items {

25 item {

26 id

27 amount

28 description

32 label

33 url

34 trackingNumber

35 id

36 documentFiling

Tùy chọn biến:

Với trung tâm hoàn tất đơn hàng: Thêm "fulfillmentCenter": "fulfillment_center_12345" để chỉ định vị trí xuất xứ
Với theo dõi tùy chỉnh: Đặt "generateLabel": false và thêm "trackingNumbers": ["tracking_1", "tracking_2"]
Với mức dịch vụ: Thêm "serviceLevel": "dhl.express_example" để chọn một dịch vụ nhà cung cấp cụ thể
Với bảo hiểm giá trị khai báo: Thêm "isDeclaredValue": true để bật phạm vi bảo hiểm giá trị khai báo
Với dịch vụ đặc biệt: Xem hướng dẫn dịch vụ đặc biệt về pin, nước đá khô, hàng nguy hiểm và tùy chọn chữ ký.

Giá trị khai báo

Đặt "isDeclaredValue": true để bật phạm vi bảo hiểm giá trị khai báo cho tất cả các mục trong lô hàng của bạn. Zonos tự động yêu cầu toàn bộ giá trị 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 pháp lý tối đa mà nhà cung cấp dịch vụ sẽ chấp nhận trong trường hợp mất 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ý việc triển khai dành riêng cho nhà cung cấp dịch vụ khi bạn bật giá trị khai báo, bao gồm các tham số thích hợp trong các cuộc gọi API của chúng tôi cho các nhà cung cấp dịch vụ 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à cung cấp dịch vụ.

Giới hạn UPS: UPS chỉ bao gồm các giá trị từ 100-50,000 USD và xử lý giá trị khai báo ở cấp thùng. Đối với các lô hàng có nhiều thùng, thương nhân phải chia tách lô hàng để chỉ định phạm vi bảo hiểm cho mỗi thùng. UPS cũng tạo một mẫu bảo hiểm bổ sung phải được in cùng với các nhãn.

FedEx và DHL: Xử lý giá trị 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ỉ định các yêu cầu xử lý đặc biệt cho pin, nước đá khô, hàng nguy hiểm hoặc yêu cầu chữ ký. Xem hướng dẫn dịch vụ đặc biệt để biết đầy đủ chi tiết và ví dụ.

ShipStation UPS Unlock: Lô hàng nhiều kiện không được hỗ trợ. Khi một đơn hàng được vận chuyển trong nhiều hộp, trường tham chiếu được nhân đôi, gây ra lỗi khớp số đơn hàng trên backend. Các thương nhân cần lô hàng nhiều kiện nên tạo nhãn trong Bảng điều khiển Zonos thay vào đó. Lô hàng hộp đơn không bị ảnh hưởng.

Hủy một lô hàng

GraphQL API ReferenceTypes, inputs, and operations used in this guide

INPUTS

CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput

MUTATIONS

cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate

Đặt lịch demo

Tạo lô hàng từ nền tảng của bạn

Bật in nhãn

Cho phép thông tin xác thực API

Tạo một lô hàng

Hủy một lô hàng

Trang này có hữu ích không?