如何運作
Zonos Collect 整合到您現有的著陸成本工作流程中。當您將 quoteType: COLLECT 加入到您的 landedCostCalculateWorkflow 變動中,請求的功能與標準著陸成本計算相同;它返回所有相同的數據,但另外觸發 Collect 工作流程。
流程很簡單:在您的請求中指定 quoteType: COLLECT,系統會自動生成支付購物車,將購物車連結發送到目的地方的電子郵件,並在支付完成後將報價轉換為訂單。
建立 Collect 報價
使用您已經熟悉的相同 GraphQL 工作流程,只需添加一個參數。將 quoteType: COLLECT 添加到您的 landedCostCalculateWorkflow 輸入會觸發整個 Collect 流程,同時保持所有現有功能。響應中的 links 欄位返回結賬會話 URL,您可以存儲並用於根據需要與收款人進行後續跟進。
1
mutation CollectQuote(2
$parties: [PartyCreateWorkflowInput!]!3
$items: [ItemCreateWorkflowInput!]!4
$shipmentRating: ShipmentRatingCreateWorkflowInput!5
$landedCost: LandedCostCalculateWorkflowInput!6
) {7
partyCreateWorkflow(input: $parties) {8
type9
id10
organization11
}12
13
itemCreateWorkflow(input: $items) {14
id15
amount16
quantity17
description18
}19
20
cartonizeWorkflow {21
id22
}23
24
shipmentRatingCreateWorkflow(input: $shipmentRating) {25
id26
amount27
}28
29
landedCostCalculateWorkflow(input: $landedCost) {30
id31
landedCostGuaranteeCode32
links {33
key34
url35
}36
amountSubtotals {37
duties38
fees39
taxes40
landedCostTotal41
}42
fees {43
amount44
currency45
type46
item {47
productId48
}49
}50
}51
}Webhooks
配置一個 ORDER_CREATED webhook 以便在任何報價轉換為訂單時立即收到通知:
1
mutation CreateOrderWebhook($input: WebhookCreateInput!) {2
webhookCreate(input: $input) {3
id4
status5
url6
}7
}有效內容將包括一個類型欄位。檢查 payload.type === "COLLECT" 以僅處理 Collect 訂單:
javascript
if (payload.type === 'COLLECT') {
}
Dashboard 管理
報價和訂單:Collect 報價和訂單在 Dashboard 中顯示 "COLLECT" 徽章。您可以按報價類型篩選以查看和管理特定於收集的報價並監控支付狀態。
電子郵件品牌:在 Dashboard → 設定 → 電子郵件範本 下調整 Collect 支付購物車的電子郵件品牌
GraphQL API ReferenceTypes, inputs, and operations used in this guide
開始使用 Collect
在交付前從收貨人收取關稅、稅款和費用。