DOCS

始める

Collectを始める

Collectを使用して、配送前に受取人から関税、税金、手数料を収集します。

仕組み 

Zonos Collectは、既存のlanded costワークフローに統合されます。quoteType: COLLECTlandedCostCalculateWorkflowミューテーションに追加すると、リクエストは標準のlanded cost計算と同様に機能します。すべての同じデータが返されますが、さらにCollectワークフローがトリガーされます。

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

Collect見積もりの作成 

すでに慣れ親しんでいるGraphQLワークフローを使用し、1つのパラメータを追加するだけです。landedCostCalculateWorkflow入力にquoteType: COLLECTを追加すると、既存の機能を維持しながらCollectプロセス全体がトリガーされます。レスポンスのlinksフィールドにはcheckoutセッションのURLが返されるため、必要に応じて支払者とのフォローアップに使用できます。

ミューテーション

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
mutation {
  partyCreateWorkflow(
    input: [
      {
        person: { companyName: "Acme Electronics" }
        location: {
          line1: "123 Commerce Blvd"
          locality: "San Francisco"
          administrativeAreaCode: "CA"
          postalCode: "94102"
          countryCode: US
        }
        type: ORIGIN
      }
      {
        person: {
          firstName: "Emma"
          lastName: "Thompson"
          email: "emma.thompson@example.co.uk"
        }
        location: {
          line1: "45 High Street"
          locality: "Manchester"
          administrativeAreaCode: "ENG"
          postalCode: "M1 1AA"
          countryCode: GB
        }
        type: DESTINATION
      }
    ]
  ) {
    type
    id
    organization
  }

  itemCreateWorkflow(
    input: [
      {
        amount: 149.99
        currencyCode: USD
        countryOfOrigin: CN
        quantity: 2
        productId: "WH-1000XM4"
        hsCode: "8518.30"
        description: "Wireless Noise Cancelling Headphones"
      }
    ]
  ) {
    id
    amount
    quantity
    description
  }

  cartonizeWorkflow {
    id
  }

  shipmentRatingCreateWorkflow(
    input: {
      serviceLevelCode: "fedex.international_priority"
      amount: 45.00
      currencyCode: USD
    }
  ) {
    id
    amount
  }

  landedCostCalculateWorkflow(
    input: {
      endUse: NOT_FOR_RESALE
      method: DDP
      tariffRate: ZONOS_PREFERRED
      quoteType: COLLECT
    }
  ) {
    id
    landedCostGuaranteeCode
    links {
      key
      url
    }
    amountSubtotals {
      duties
      fees
      taxes
      landedCostTotal
    }
    fees {
      amount
      currency
      type
      item {
        productId
      }
    }
  }
}

Webhooks

ORDER_CREATED ウェブフック を設定して、見積もりが注文に変わるとすぐに通知を受け取ります:

MUTATION

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
mutation {
  webhookCreate(
    input: {
      status: ENABLED
      type: ORDER_CREATED
      url: "https://your.endpoint.com/zonos-webhooks"
    }
  ) {
    id
    status
    url
  }
}

ペイロードにはタイプフィールドが含まれます。payload.type === "COLLECT"をチェックして、Collect注文のみを処理してください:

javascript

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

ダッシュボード管理 

見積もりと注文: Collect の見積もりと注文は、ダッシュボードに「COLLECT」バッジと共に表示されます。見積もりタイプでフィルタリングして、collect 特有の見積もりを表示および管理し、支払い状況を監視できます。

メールブランディング: ダッシュボード設定メールテンプレート の下で、Collect 支払いカートのメールブランディングを調整します。

受取人の体験 

Collect の見積もりを作成すると、お客様は安全な支払いリンクを含む自動メールを受け取ります。支払いカートは、関税、税金、手数料を完全に透明に表示しながら、製品価格は非公開のままにします。

支払いプロセス、サポートされている国と言語、カスタマイズオプションの詳細については受取人の体験ガイドをご覧ください。

このページは役に立ちましたか?