APIを介して出荷を作成する
Landed Costを計算し、注文を作成した後、追跡番号やその他の出荷詳細をAPIを通じてZonosに送信できます。
既存の注文のために出荷を作成する際に、アイテムやパーティの詳細を変更する必要がない場合は、このワークフローを使用します。オプションの追跡番号、フルフィルメントセンター、サービスレベルの選択、宣言された価値の保険をサポートしています。
ミューテーション
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: 追加の制限なしで出荷レベルで宣言された価値を処理します。
出荷を無効にする
作成されたラベルをキャンセルするには、次のミューテーションを使用して出荷を無効にします。関連するラベルも自動的に無効になります。出荷が無効にされると、更新または復元することはできません。
ミューテーション
mutation {
shipmentStatusUpdate(
input: {
shipment: "shipment_12345678-1234-1234-1234-123456789stu"
status: VOIDED
note: "Voiding shipment"
}
) {
id
status
}
}
既存の注文のための出荷を作成する
Zonos APIを使用して、ランデッドコストを計算し、注文を作成した後に出荷とラベルを作成します。
GraphQL
このガイドは、Zonos APIにすでに統合されているユーザーを対象としており、システム内の既存の注文に対して出荷を作成する必要があります。もしあなたが出荷プラットフォームであり、顧客にZonosの出荷作成を提供したい場合は出荷APIガイドをご覧ください。
Zonos APIに統合されダッシュボードの外で出荷することが承認されている場合は、
shipmentCreateWorkflowミューテーションを使用して出荷を作成し、追跡情報を提供します。これらのミューテーションを使用すると、Zonosにクロスドッキング施設への国内出荷について通知することもできます。注意: 追跡番号をZonosに自動的に同期するプラットフォームとともに関税および税金アプリを使用している場合、またはダッシュボードを通じて直接出荷している場合は、これらのミューテーションは必要ありません。