DOCS
Collect•
Trang chủCho các nhà cung cấp logistics Zonos Collect Bắt đầu

Bắt đầu với Collect

Thu thập thuế, phí và các khoản phí từ người nhận trước khi giao hàng.

Nó hoạt động như thế nào 

Zonos Collect tích hợp vào quy trình Landed cost đã có của bạn. Khi bạn thêm quoteType: COLLECT vào mutation landedCostCalculateWorkflow, yêu cầu hoạt động giống hệt như một phép tính Landed cost tiêu chuẩn; nó trả về tất cả dữ liệu giống nhau, nhưng ngoài ra kích hoạt quy trình Collect.

Quy trình rất đơn giản: chỉ định quoteType: COLLECT trong yêu cầu của bạn, và hệ thống tự động tạo giỏ hàng, gửi liên kết giỏ hàng đến email của bên nhận, và chuyển đổi báo giá thành đơn hàng sau khi thanh toán hoàn tất.

Tạo báo giá Collect 

Sử dụng cùng một quy trình GraphQL mà bạn đã quen thuộc, chỉ cần thêm một tham số. Thêm quoteType: COLLECT vào đầu vào landedCostCalculateWorkflow của bạn kích hoạt toàn bộ quy trình Collect trong khi duy trì tất cả chức năng hiện có. Trường links trong phản hồi trả về URL phiên làm việc thanh toán, mà bạn có thể lưu trữ và sử dụng để theo dõi người thanh toán khi cần.

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}

Webhooks

Cấu hình một ORDER_CREATED webhook để được thông báo ngay khi bất kỳ báo giá nào chuyển đổi thành đơn hàng:

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

Payload sẽ bao gồm một trường loại. Kiểm tra payload.type === "COLLECT" để xử lý chỉ các đơn hàng Collect:

javascript

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

Quản lý Dashboard 

Báo giá và đơn hàng: Báo giá và đơn hàng Collect hiển thị với huy hiệu "COLLECT" trong Dashboard. Bạn có thể lọc theo loại báo giá để xem và quản lý báo giá dành riêng cho Collect và giám sát trạng thái thanh toán.

Xây dựng thương hiệu email: Điều chỉnh xây dựng thương hiệu email cho giỏ hàng thanh toán Collect trong Dashboard → Cài đặt → Mẫu Email

Trải nghiệm của người nhận 

Khi bạn tạo báo giá Collect, khách hàng của bạn sẽ nhận được email tự động với liên kết thanh toán an toàn. Giỏ hàng thanh toán hiển thị thuế, phí và các khoản phí với tính minh bạch đầy đủ trong khi giữ riêng tư giá sản phẩm của bạn.

Để biết chi tiết đầy đủ về quy trình thanh toán, các quốc gia và ngôn ngữ được hỗ trợ, và các tùy chọn tùy chỉnh, hãy xem hướng dẫn trải nghiệm người nhận.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentRatingCreateWorkflowInput WebhookCreateInput

MUTATIONS

cartonizeWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentRatingCreateWorkflow webhookCreate

Trang này có hữu ích không?

Nhận hỗ trợ·Tài liệu pháp lý·© 2026 Zonos
Trên trang này:
  • Bắt đầu với Collect
  • Nó hoạt động như thế nào
  • Tạo báo giá Collect
  • Quản lý Dashboard
  • Trải nghiệm của người nhận