DOCS
Collect•
ホーム物流プロバイダー向け Zonos Collect 始めましょう

コレクトを始めましょう

配達前に荷受人から関税、税金、手数料を徴収します。

仕組み 

Zonos Collect は、既存の陸揚げコストのワークフローに統合されます。 quoteType: COLLECT を landedCostCalculateWorkflow ミューテーションに追加すると、リクエストは標準の上陸コスト計算と同じように機能します。すべて同じデータを返しますが、さらに収集ワークフローをトリガーします。

プロセスは簡単です。リクエストで quoteType: COLLECT を指定すると、システムは自動的に支払いカートを生成し、カートのリンクを宛先当事者の電子メールに送信し、支払いが完了すると見積を注文に変換します。

コレクト見積を作成する 

すでに使い慣れている GraphQL ワークフローをそのまま使用し、パラメーターを 1 つ追加するだけです。landedCostCalculateWorkflow 入力に quoteType: 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}

Webhook

見積が注文に変換されるとすぐに通知を受け取るには、ORDER_CREATED Webhook を設定します。

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

ペイロードには type フィールドが含まれます。コレクト注文のみを処理するには、payload.type === "COLLECT" をチェックします。

javascript

if (payload.type === '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
このページでは：