工作原理
Zonos Collect 集成到您现有的着陆成本工作流程中。当您向 landedCostCalculateWorkflow 突变添加 quoteType: COLLECT 时，该请求的功能与标准着陆成本计算完全相同；它返回所有相同的数据，但另外触发 Collect 工作流。
过程很简单：在您的请求中指定 quoteType: COLLECT，系统会自动生成付款购物车，将购物车链接发送到目标方的电子邮件，并在付款完成后将报价转换为订单。
创建 Collect 报价
使用您已经熟悉的相同 GraphQL 工作流程，只需添加一个参数。将 quoteType: COLLECT 添加到您的 landedCostCalculateWorkflow 输入会触发整个 Collect 过程，同时保持所有现有功能。响应中的 links 字段返回结账会话 URL，您可以存储并使用该 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
在交货前从收货人处收取关税、税费和费用。