DOCS
Landed Cost•
首页物流提供商专用 落地成本 创建发货单

为现有订单创建发货单

使用 Zonos API 在计算 Landed Cost 和创建订单后创建发货单和标签。

GraphQL

本指南适用于已与 Zonos API 集成的用户，他们需要为其系统中的现有订单创建发货单。如果您是运输平台并想向客户提供 Zonos 发货单创建服务，请参阅我们的 Shipment API 指南。

如果您已与 Zonos API 集成并获得批准可以 在 Dashboard 之外进行发货，请使用 shipmentCreateWorkflow mutation 创建发货单并提供追踪信息。这些 mutation 还允许您告知 Zonos 关于运往转运设施的国内发货。

注意： 如果您使用的是带有自动同步追踪号到 Zonos 的平台的税费 app，或者直接通过 Dashboard 发货，则不需要这些 mutation。

通过 API 创建发货单 

在计算 Landed Cost 并创建订单后，您可以通过 API 将追踪号和其他发货详情发送到 Zonos。

当您为现有订单创建发货单且无需修改物品或各方信息时使用此工作流。它支持可选的追踪号、履行中心、服务级别选择和声明价值保险。

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
29 }
30 }
31 }
32 label {
33 url
34 trackingNumber
35 id
36 documentFiling
37 }
38 }
39 }
40}

变量选项：

  • 使用履行中心： 添加 "fulfillmentCenter": "fulfillment_center_12345" 来指定源位置
  • 使用自定义追踪： 设置 "generateLabel": false 并添加 "trackingNumbers": ["tracking_1", "tracking_2"]
  • 使用服务级别： 添加 "serviceLevel": "dhl.express_example" 来选择特定的运载商服务
  • 使用声明价值保险： 添加 "isDeclaredValue": true 来启用声明价值覆盖

声明价值

设置 "isDeclaredValue": true 为发货单中的所有物品启用声明价值覆盖。Zonos 自动申报订单中提交的所有物品的全部价值；商户无法修改此金额。这设置了在运输过程中发生丢失、损坏或盗窃时运载商将接受的最大责任。此功能仅支持 UPS、FedEx 和 DHL 发货。Zonos 在您启用声明价值时自动处理特定于运载商的实现，包括对这些运载商的 API 调用中的适当参数，因此您不需要管理不同的运载商要求。

UPS 限制：UPS 仅覆盖 100.01-50,000 美元之间的价值，并在纸箱级别处理声明价值。对于多纸箱发货，商户必须拆分发货以指定每个纸箱的覆盖。UPS 还会生成额外的保险表格（UPS 控制日志），该表格必须与标签一起打印，用于超过 999 美元的声明价值。

FedEx 和 DHL：在发货级别处理声明价值，没有其他限制。

特殊服务

在纸箱上使用 specialServices 来指示电池、干冰、危险品或签名要求的特殊处理要求。有关完整详情和示例，请参阅 特殊服务指南。

撤销发货单 

要取消创建的标签，使用以下 mutation 来撤销发货单。任何关联的标签也将自动撤销。请注意，一旦发货单被撤销，就无法更新或恢复。

1mutation {
2 shipmentStatusUpdate(
3 input: {
4 shipment: "shipment_12345678-1234-1234-1234-123456789stu"
5 status: VOIDED
6 note: "Voiding shipment"
7 }
8 ) {
9 id
10 status
11 }
12}
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput

MUTATIONS

cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate

这个页面有帮助吗？

获取支持·法律文件·© 2026 Zonos
在此页面：
  • 通过 API 创建发货单