작동 방식
Zonos Collect는 기존 landed cost workflow에 통합됩니다. landedCostCalculateWorkflow mutation에 quoteType: COLLECT를 추가하면 standard landed cost calculation과 동일하게 작동하며 동일한 data를 반환하지만 Collect workflow도 trigger합니다.
process는 simple합니다: request에 quoteType: COLLECT를 specify하면 system이 payment cart를 자동 생성하고 destination party email로 cart link를 send하며 payment 완료 시 quote를 order로 convert합니다.
Collect quote 생성
이미 familiar한 GraphQL workflow에 parameter 하나만 추가합니다. landedCostCalculateWorkflow input에 quoteType: COLLECT를 추가하면 기존 functionality를 유지하면서 Collect process 전체를 trigger합니다. response links field는 checkout session URL을 반환하며 payee follow-up에 store하여 사용할 수 있습니다.
mutation CollectQuote($parties: [PartyCreateWorkflowInput!]!$items: [ItemCreateWorkflowInput!]!$shipmentRating: ShipmentRatingCreateWorkflowInput!$landedCost: LandedCostCalculateWorkflowInput!) { partyCreateWorkflow(input: $parties) { type id organization } itemCreateWorkflow(input: $items) { id amount quantity description } cartonizeWorkflow { id } shipmentRatingCreateWorkflow(input: $shipmentRating) { id amount } landedCostCalculateWorkflow(input: $landedCost) { id landedCostGuaranteeCode links { key url } amountSubtotals { duties fees taxes landedCostTotal } fees { amount currency type item { productId } } }}Webhook
quote가 order로 convert되면 notification을 받도록 ORDER_CREATED webhook을 configure합니다:
mutation CreateOrderWebhook($input: WebhookCreateInput!) { webhookCreate(input: $input) { id status url }}payload에 type field가 포함됩니다. Collect order만 처리하려면 payload.type === "COLLECT"를 확인합니다:
javascript
if (payload.type === 'COLLECT') {
}
Dashboard management
Quote 및 order: Collect quote 및 order는 Dashboard에 „COLLECT" badge로 표시됩니다. quote type으로 filter하여 collect-specific quote를 view/manage하고 payment status를 monitor할 수 있습니다.
Email branding: Dashboard → Settings → Email Templates에서 Collect payment cart email branding을 adjust합니다
Consignee experience
Collect quote를 생성하면 customer는 secure payment link가 포함된 automated email을 받습니다. payment cart는 product pricing을 private로 유지하면서 duty, tax, fee를 full transparency로 표시합니다.
payment process, 지원 country 및 language, customization option에 대한 complete detail은 Consignee experience guide를 참조하세요.
Collect 시작하기
delivery 전 consignee로부터 duty, tax, fee를 수금합니다.