Metafield yang tersedia
Zonos menulis tiga metafield ke setiap pesanan Shopify, semuanya di bawah namespace zonos.
zonos_id
ID pesanan Zonos unik yang terhubung ke pesanan Shopify ini. Gunakan ID ini untuk mencari pesanan lengkap di Zonos Dashboard atau melalui Zonos API.
Nilai contoh
order_19d69db6-450f-45a7-a4a1-c678c7d7dd90
zonos_subtotals
Objek JSON yang berisi total bea cukai, pajak, biaya, dan pengiriman yang dikumpulkan untuk pesanan.
Nilai contoh
{
"duties": 0,
"taxes": 400.39,
"fees": -78.93,
"shipping": 966.87
}
| Field↕ | Deskripsi↕ |
|---|---|
duties | Total jumlah bea cukai untuk pesanan. |
taxes | Total jumlah pajak untuk pesanan. |
fees | Total biaya untuk pesanan. Nilai negatif menunjukkan kredit atau penyesuaian. |
shipping | Total biaya pengiriman untuk pesanan. |
zonos_items
Larik JSON yang berisi rincian biaya tingkat item. Setiap item mencakup jumlah dalam mata uang yang dibayarkan pelanggan dan mata uang dasar toko Anda.
Nilai contoh
[
{
"amount": 830.53,
"productId": "49380521509183",
"currencyCode": "CAD",
"paidAmount": {
"amount": 830.53,
"currencyCode": "CAD"
},
"shopAmount": {
"amount": 606.85,
"currencyCode": "USD"
}
}
]
| Field↕ | Deskripsi↕ |
|---|---|
amount | Jumlah item dalam mata uang pelanggan. |
productId | ID produk Shopify untuk item ini. |
currencyCode | Mata uang yang dibayarkan pelanggan. |
paidAmount.amount | Jumlah yang dibayarkan pelanggan untuk item ini. |
paidAmount.currencyCode | Mata uang dari jumlah yang dibayarkan. |
shopAmount.amount | Jumlah setara dalam mata uang dasar toko Anda. |
shopAmount.currencyCode | Kode mata uang dasar toko Anda. |
Mengakses metafield
Anda dapat mengakses metafield ini melalui metode apa pun yang mendukung pembacaan metafield pesanan Shopify:
- Shopify Admin API (GraphQL atau REST)
- Shopify Flow untuk mengotomatisasi alur kerja berdasarkan data pesanan Zonos
- Aplikasi pihak ketiga yang membaca metafield pesanan (misalnya, alat pelaporan, ERP)
Contoh: Kueri melalui Shopify GraphQL API
Kueri GraphQL Shopify
query OrderZonosMetafields($orderId: ID!) {
order(id: $orderId) {
metafields(namespace: "zonos", first: 10) {
edges {
node {
key
value
}
}
}
}
}
Metafield pesanan
Akses data pesanan Zonos langsung dari pesanan Shopify Anda.
Zonos menulis detail pesanan ke metafield pesanan Shopify di bawah namespace
zonos. Ini memberi Anda akses langsung ke ID pesanan Zonos, rincian biaya tingkat item, dan subtotal bea cukai/pajak/biaya tanpa perlu memanggil Zonos API secara terpisah.Metafield ini tersedia di setiap pesanan Shopify yang diproses melalui Zonos dan dapat diakses melalui Shopify Admin API, Shopify Flow, atau alat apa pun yang membaca metafield pesanan.