運作方式
Zonos Collect 整合到您現有的到岸成本工作流程中。當您在 landedCostCalculateWorkflow 變異中新增 quoteType: COLLECT 時,請求的功能與標準到岸成本計算相同;它會傳回相同的所有資料,但還會額外觸發 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」徽章。您可以按報價類型篩選以檢視和管理特定的 Collect 報價並監控付款狀態。
電子郵件品牌:在 Dashboard → Settings → Email Templates 下調整 Collect 付款購物車的電子郵件品牌
GraphQL API ReferenceTypes, inputs, and operations used in this guide
開始使用 Collect
在交付前從收貨人收取關稅、稅金和費用。