Các metafield có sẵn
Zonos ghi ba metafield vào mỗi đơn hàng Shopify, tất cả đều nằm dưới không gian tên zonos.
zonos_id
ID đơn hàng Zonos duy nhất được liên kết với đơn hàng Shopify này. Sử dụng ID này để tra cứu toàn bộ đơn hàng trong Zonos Dashboard hoặc qua API Zonos.
Giá trị ví dụ
order_19d69db6-450f-45a7-a4a1-c678c7d7dd90
zonos_subtotals
Một đối tượng JSON chứa tổng cộng thuế quan, thuế, phí và chi phí vận chuyển của đơn hàng.
Giá trị ví dụ
{
"duties": 0,
"taxes": 400.39,
"fees": -78.93,
"shipping": 966.87
}
| Trường↕ | Mô tả↕ |
|---|---|
duties | Tổng số thuế quan cho đơn hàng. |
taxes | Tổng số thuế cho đơn hàng. |
fees | Tổng phí cho đơn hàng. Giá trị âm biểu thị tín dụng hoặc điều chỉnh. |
shipping | Tổng chi phí vận chuyển cho đơn hàng. |
zonos_items
Một mảng JSON chứa chi tiết chi phí từng mục. Mỗi mục bao gồm các khoản tiền cả trong tiền tệ mà khách hàng thanh toán và tiền tệ cơ sở của cửa hàng bạn.
Giá trị ví dụ
[
{
"amount": 830.53,
"productId": "49380521509183",
"currencyCode": "CAD",
"paidAmount": {
"amount": 830.53,
"currencyCode": "CAD"
},
"shopAmount": {
"amount": 606.85,
"currencyCode": "USD"
}
}
]
| Trường↕ | Mô tả↕ |
|---|---|
amount | Số tiền mục trong tiền tệ của khách hàng. |
productId | ID sản phẩm Shopify cho mục này. |
currencyCode | Tiền tệ mà khách hàng thanh toán. |
paidAmount.amount | Số tiền khách hàng thanh toán cho mục này. |
paidAmount.currencyCode | Tiền tệ của số tiền thanh toán. |
shopAmount.amount | Số tiền tương đương trong tiền tệ cơ sở của cửa hàng bạn. |
shopAmount.currencyCode | Mã tiền tệ cơ sở của cửa hàng bạn. |
Truy cập metafield
Bạn có thể truy cập các metafield này thông qua bất kỳ phương pháp nào hỗ trợ đọc các metafield đơn hàng Shopify:
- API Quản trị Shopify (GraphQL hoặc REST)
- Shopify Flow để tự động hóa quy trình công việc dựa trên dữ liệu đơn hàng Zonos
- Ứng dụng của bên thứ ba đọc các metafield đơn hàng (ví dụ: công cụ báo cáo, ERP)
Ví dụ: Truy vấn qua API GraphQL của Shopify
Truy vấn GraphQL của Shopify
query OrderZonosMetafields($orderId: ID!) {
order(id: $orderId) {
metafields(namespace: "zonos", first: 10) {
edges {
node {
key
value
}
}
}
}
}
Các metafield đơn hàng
Truy cập dữ liệu đơn hàng Zonos trực tiếp từ đơn hàng Shopify của bạn.
Zonos ghi chi tiết đơn hàng vào các metafield đơn hàng Shopify dưới không gian tên
zonos. Điều này cho phép bạn truy cập trực tiếp các ID đơn hàng Zonos, chi tiết chi phí từng mục và tổng cộng thuế quan/thuế/phí mà không cần gọi API Zonos riêng biệt.Các metafield này có sẵn trên mọi đơn hàng Shopify được xử lý qua Zonos và có thể được truy cập qua API Quản trị Shopify, Shopify Flow hoặc bất kỳ công cụ nào đọc các metafield đơn hàng.