DOCS
Landed Cost•
ホーム物流プロバイダー向け Landed Cost 配送を作成

既存注文の配送を作成

landed costを計算し、注文を作成した後、Zonos APIで配送とラベルを作成します。

GraphQL

本ガイドは、Zonos API と統合済みで、システム内の既存注文向けに配送を作成する必要があるユーザー向けです。配送プラットフォームで顧客に Zonos 配送作成を提供したい場合は、Shipment API ガイドを参照してください。

Zonos APIと統合済みで、Dashboard外での発送が承認されている場合は、shipmentCreateWorkflow mutationを使用して配送を作成し、追跡情報を提供します。これらのmutationでは、クロスドッキング施設への国内配送についてZonosに通知することもできます。

注: 追跡番号をZonosに自動的に同期するプラットフォームでDuty and Taxアプリを使用している場合、または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はまた、999米ドルを超える申告価格の場合、ラベルと一緒に印刷する必要がある追加の保険フォーム（UPS Control Log）を生成します。

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 経由で配送を作成