DOCS
Collect•
首頁為物流供應商而設 Zonos Collect 開始使用

開始使用 Collect

在交付前從收貨人收取關稅、稅款和費用。

如何運作 

Zonos Collect 整合到您現有的 Landed Cost 工作流程中。當您將 quoteType: COLLECT 加入到您的 landedCostCalculateWorkflow 變動中，請求的功能與標準 Landed Cost 計算相同；它返回所有相同的數據，但另外觸發 Collect 工作流程。

流程很簡單：在您的請求中指定 quoteType: COLLECT，系統會自動生成支付購物車，將購物車連結發送到目的地方的電子郵件，並在支付完成後將報價轉換為訂單。

建立 Collect 報價 

使用您已經熟悉的相同 GraphQL 工作流程，只需添加一個參數。將 quoteType: COLLECT 添加到您的 landedCostCalculateWorkflow 輸入會觸發整個 Collect 流程，同時保持所有現有功能。響應中的 links 欄位返回結賬會話 URL，您可以存儲並用於根據需要與收款人進行後續跟進。

1mutation CollectQuote(
2$parties: [PartyCreateWorkflowInput!]!
3$items: [ItemCreateWorkflowInput!]!
4$shipmentRating: ShipmentRatingCreateWorkflowInput!
5$landedCost: LandedCostCalculateWorkflowInput!
6) {
7 partyCreateWorkflow(input: $parties) {
8 type
9 id
10 organization
11 }
12 
13 itemCreateWorkflow(input: $items) {
14 id
15 amount
16 quantity
17 description
18 }
19 
20 cartonizeWorkflow {
21 id
22 }
23 
24 shipmentRatingCreateWorkflow(input: $shipmentRating) {
25 id
26 amount
27 }
28 
29 landedCostCalculateWorkflow(input: $landedCost) {
30 id
31 landedCostGuaranteeCode
32 links {
33 key
34 url
35 }
36 amountSubtotals {
37 duties
38 fees
39 taxes
40 landedCostTotal
41 }
42 fees {
43 amount
44 currency
45 type
46 item {
47 productId
48 }
49 }
50 }
51}

Webhooks

配置一個 ORDER_CREATED webhook 以便在任何報價轉換為訂單時立即收到通知：

1mutation CreateOrderWebhook($input: WebhookCreateInput!) {
2 webhookCreate(input: $input) {
3 id
4 status
5 url
6 }
7}

有效內容將包括一個類型欄位。檢查 payload.type === "COLLECT" 以僅處理 Collect 訂單：

javascript

if (payload.type === 'COLLECT') {
}

Dashboard 管理 

報價和訂單：Collect 報價和訂單在 Dashboard 中顯示 "COLLECT" 徽章。您可以按報價類型篩選以查看和管理特定於收集的報價並監控支付狀態。

電子郵件品牌：在 Dashboard → 設定 → 電子郵件範本 下調整 Collect 支付購物車的電子郵件品牌

收貨人體驗 

當您建立 Collect 報價時，您的客戶會收到一封自動化電子郵件，其中包含安全支付連結。支付購物車以完全透明的方式顯示關稅、稅款和費用，同時保持您的產品價格私密。

有關支付流程、支持的國家和語言以及自訂選項的完整詳情，請參閱 收貨人體驗指南。

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

ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentRatingCreateWorkflowInput WebhookCreateInput

MUTATIONS

cartonizeWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentRatingCreateWorkflow webhookCreate

這個頁面有幫助嗎？

獲取支持·法律文件·© 2026 Zonos
在此頁面：
  • 開始使用 Collect
  • 建立 Collect 報價
  • Dashboard 管理