DOCS
Collect•
首頁為物流供應商提供的解決方案 Zonos Collect 開始使用

開始使用 Collect

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

運作方式 

Zonos Collect 整合到您現有的到岸成本工作流程中。當您在 landedCostCalculateWorkflow 變異中新增 quoteType: COLLECT 時，請求的功能與標準到岸成本計算相同；它會傳回相同的所有資料，但還會額外觸發 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」徽章。您可以按報價類型篩選以檢視和管理特定的 Collect 報價並監控付款狀態。

電子郵件品牌：在 Dashboard → Settings → Email Templates 下調整 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 管理