Landed Cost•

プラットフォームから配送を作成

顧客が自社のプラットフォームから Zonos の配送とラベルを作成できるようにします。

本ガイドは、顧客向けに Zonos の配送作成機能を自社プラットフォームへ統合したい配送プラットフォーム開発者を対象としています。すでに Zonos API を利用しており、既存注文向けに配送を作成するだけで良い場合は、配送作成ガイドを参照してください。

国際配送を行う Zonos の顧客をサポートする配送プラットフォームである場合、配送作成における Zonos との統合は最優先事項として検討する価値があります。これにより、自社プラットフォームの既存機能を活用しつつ、配送、ラベル、および関連する通関書類の作成を Zonos に任せることで、マーチャントとその顧客に最もシームレスな体験を提供できます。

Zonos を利用して配送を作成する利点は次のとおりです:

関税・税金の第三者請求 - 配送料にはお客様またはマーチャントのキャリアアカウント番号が使用され、関税・税金の請求は Zonos 宛てとなるようにします。
柔軟性 - 自社プラットフォームでコンプライアンスに準拠したラベルを生成するための開発作業を行う代わりに、当社の API と統合し、変化し続ける越境コンプライアンス対応は Zonos にお任せください。
正確な通関書類 - Zonos を使用してラベルを生成すると、荷物が迅速に通関できるよう、正しい詳細情報がキャリアに渡されるようにします。

本ガイドでは、自社プラットフォームから Zonos を呼び出して配送を作成できるようにするための、エンドツーエンドの統合を実装する手順を説明します。

ラベル印刷を有効化

顧客が自社プラットフォームから Zonos のラベルを取得できるようにするには、以下の手順に従ってください。

API 認証情報を許可

配送を作成

label を取得するには、その label が関連付けられる shipment を作成する必要があります。Zonos では、同じリクエスト内で shipments と labels を作成するワークフローによってこの処理を行います。この mutation を実行する際、serviceLevel を渡す必要はありません。order に紐づく landedCost で使用された serviceLevel が使用されるためです。orderId には、Zonos の注文 ID か、既にシステムに存在している可能性が高い accountOrderNumber を使用できます。

配送とラベルの作成が成功すると、ラベルは BASE64_ENCODED_IMAGE である labelImage として、またはラベルを取得できる url として返されます。

既存注文の配送を作成し、品目や当事者の詳細を変更する必要がない場合に、このワークフローを使用します。オプションの追跡番号、フルフィルメントセンター、サービスレベルの選択、申告価格保険をサポートします。

Shopify マーチャント

Shopify は発送元当事者の person に null 値を渡します。そのため、Shopify のマーチャントでは orderId だけでは機能しません — 代わりに 高度な配送作成 タブを使用し、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

29 }

30 }

31 }

32 label {

33 url

34 trackingNumber

35 id

36 documentFiling

37 }

38 }

39 }

変数オプション:

フルフィルメントセンターを使用する場合: 発送元の場所を指定するには "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〜50,000 米ドルの値のみをカバーし、カートンレベルで申告価格を処理します。複数カートンの配送では、マーチャントはカートンごとにカバレッジを指定するために配送を分割する必要があります。UPS はまた、ラベルと一緒に印刷する必要がある追加の保険フォームを生成します。

FedEx と DHL：追加の制限なしに、配送レベルで申告価格を処理します。

特殊サービス

カートンで specialServices を使用すると、バッテリー、ドライアイス、危険物、署名要件などの特別な取り扱い要件を指定できます。詳細と例については、特殊サービスガイドを参照してください。

ShipStation UPS Unlock：複数個口配送はサポートされていません。注文が複数の箱で発送される場合、参照フィールドが重複し、バックエンドでの注文番号のマッチングが失敗します。複数個口配送が必要なマーチャントは、代わりに Zonos Dashboard でラベルを作成してください。単一の箱での配送には影響ありません。

配送を無効化

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

INPUTS

CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput

MUTATIONS

cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate

デモを予約する

プラットフォームから配送を作成

ラベル印刷を有効化

API 認証情報を許可

配送を作成

配送を無効化

このページは役に立ちましたか？