仕組み
Zonos Collectは、既存のlanded costワークフローに統合されます。quoteType: COLLECTをlandedCostCalculateWorkflowミューテーションに追加すると、リクエストは標準のlanded cost計算と同様に機能します。すべての同じデータが返されますが、さらにCollectワークフローがトリガーされます。
プロセスはシンプルです:リクエストにquoteType: COLLECTを指定すると、システムは自動的に支払いカートを生成し、カートリンクを宛先のメールに送信し、支払いが完了すると見積もりを注文に変換します。
Collect見積もりの作成
すでに慣れ親しんでいるGraphQLワークフローを使用し、1つのパラメータを追加するだけです。landedCostCalculateWorkflow入力にquoteType: COLLECTを追加すると、既存の機能を維持しながらCollectプロセス全体がトリガーされます。レスポンスのlinksフィールドにはcheckoutセッションのURLが返されるため、必要に応じて支払者とのフォローアップに使用できます。
ミューテーション
GraphQL
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
mutation {
webhookCreate(
input: {
status: ENABLED
type: ORDER_CREATED
url: "https://your.endpoint.com/zonos-webhooks"
}
) {
id
status
url
}
}
ペイロードにはタイプフィールドが含まれます。payload.type === "COLLECT"をチェックして、Collect注文のみを処理してください:
javascript
if (payload.type === 'COLLECT') {
}
ダッシュボード管理
見積もりと注文: Collect の見積もりと注文は、ダッシュボードに「COLLECT」バッジと共に表示されます。見積もりタイプでフィルタリングして、collect 特有の見積もりを表示および管理し、支払い状況を監視できます。
メールブランディング: ダッシュボード → 設定 → メールテンプレート の下で、Collect 支払いカートのメールブランディングを調整します。
Collectを始める
Collectを使用して、配送前に受取人から関税、税金、手数料を収集します。