DOCS
Collect•
首页物流提供商专用 Zonos Collect 入门指南

开始使用 Collect

在交货前从收货人处收取关税、税费和费用。

工作原理 

Zonos Collect 集成到您现有的着陆成本工作流程中。当您向 landedCostCalculateWorkflow 突变添加 quoteType: COLLECT 时，该请求的功能与标准着陆成本计算完全相同；它返回所有相同的数据，但另外触发 Collect 工作流。

过程很简单：在您的请求中指定 quoteType: COLLECT，系统会自动生成付款购物车，将购物车链接发送到目标方的电子邮件，并在付款完成后将报价转换为订单。

创建 Collect 报价 

使用您已经熟悉的相同 GraphQL 工作流程，只需添加一个参数。将 quoteType: COLLECT 添加到您的 landedCostCalculateWorkflow 输入会触发整个 Collect 过程，同时保持所有现有功能。响应中的 links 字段返回结账会话 URL，您可以存储并使用该 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 管理