ラベル印刷を有効にする
以下の手順に従って、顧客があなたのプラットフォームから Zonos ラベルを取得できるようにします。
API資格情報を許可
The Zonos API は credentialToken でアクセス可能です。プラットフォームは、顧客が Zonos ダッシュボード からの credentialToken をあなたのプラットフォームに入力できるようにする必要があります。ここから、彼らに代わって Zonos へリクエストを行うことができます。
出荷を作成
label を取得するには、label が関連付けられる shipment を作成する必要があります。Zonos は、同じリクエスト内で shipments と labels を作成するワークフローでこのプロセスを管理します。このミューテーションを実行する際には、order に紐づく landedCost から使用される serviceLevel を使用するため、serviceLevel を渡す必要はありません。orderId には Zonos の注文ID、またはおそらくすでにシステムに存在するであろう accountOrderNumber を使用できます。
出荷とラベルが正常に作成された場合、ラベルは labelImage（BASE64_ENCODED_IMAGE）として返されるか、ラベルを取得できる url として返されます。
既存の注文の出荷を作成する場合で、アイテムや取引先の詳細を変更する必要がない場合にこのワークフローを使用します。追跡番号の任意指定、フルフィルメントセンター、サービスレベルの選択、宣言価額保険をサポートします。
ミューテーション
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
}
}
}
}
基本変数
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789abc"
}
}
フルフィルメントセンターを使用
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789def",
"fulfillmentCenter": "fulfillment_center_12345"
}
}
カスタムトラッキングを使用して
{
"input": {
"generateLabel": false,
"orderId": "order_12345678-1234-1234-1234-123456789ghi",
"trackingNumbers": ["tracking_example_1", "tracking_example_2"]
}
}
サービスレベル付き
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789jkl",
"serviceLevel": "dhl.express_example"
}
}
宣言された価値保険付き
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789mno",
"isDeclaredValue": true
}
}
宣言された価値
"isDeclaredValue": true を設定して、出荷のすべてのアイテムに対して宣言された価値の補償を有効にします。 Zonos は、注文に提出されたすべてのアイテムの完全な価値を自動的に請求します。商人はこの金額を変更することはできません。これは、輸送中の紛失、損傷、または盗難が発生した場合に、運送業者が受け入れる最大の責任を設定します。この機能は、UPS、FedEx、およびDHLの出荷のみでサポートされています。 Zonos は、宣言された価値を有効にすると、これらの運送業者へのAPI呼び出しに適切なパラメータを含めるなど、運送業者固有の実装を自動的に処理するため、異なる運送業者の要件を管理する必要はありません。
UPSの制限: UPSは、100-50,000 USDの間の価値のみをカバーし、宣言された価値をカートンレベルで処理します。複数カートンの出荷の場合、商人はカートンごとに補償を指定するために出荷を分割する必要があります。UPSは、ラベルと一緒に印刷する必要がある追加の保険フォームも生成します。
FedExおよびDHL: 追加の制限なしで出荷レベルで宣言された価値を処理します。
出荷を無効にする
顧客が shipment を無効にしたい場合、以下のミューテーションを使用することで、shipment に関連付けられたすべての labels を無効にすることができます。
リクエスト
mutation {
shipmentStatusUpdate(
input: {
shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"
status: VOIDED
note: "Voiding shipment"
}
) {
id
status
}
}
あなたのプラットフォームから出荷を作成
お客様があなたのプラットフォームから Zonos の出荷とラベルを作成できるようにします。
このガイドは、顧客のために Zonos 出荷作成機能を自分のプラットフォームに統合したい配送プラットフォーム開発者を対象に設計されています。すでに Zonos API を使用しており、既存の注文の出荷を作成するだけでよい場合は出荷作成ガイドをご覧ください。
国際配送をサポートする Zonos の顧客を対象とする配送プラットフォームで、出荷作成のために Zonos と統合することは最も重要な検討事項の1つとなるべきです。これにより、あなたのプラットフォームの既存機能を活用しつつ、出荷・ラベルの作成および関連する通関書類の作成を Zonos に任せることで、取引者と顧客への最もシームレスな体験を提供できます。
出荷を作成するために Zonos を使用する利点は次のとおりです：
このガイドでは、プラットフォームから出荷のために Zonos を呼び出せる完全なエンドツーエンド統合を実装する手順を詳しく解説します。