Mevcut meta alanlar
Zonos, her Shopify siparişine üç meta alanı yazıyor, hepsi zonos ad alanı altında.
zonos_id
Bu Shopify siparişine bağlı benzersiz Zonos sipariş kimliği. Bu kimliği kullanarak Zonos Dashboard'da veya Zonos API'si aracılığıyla tam siparişi arayabilirsiniz.
Örnek değer
order_19d69db6-450f-45a7-a4a1-c678c7d7dd90
zonos_subtotals
Siparişin toplam gümrük vergisi, vergi, ücret ve kargo toplamlarını içeren bir JSON nesnesi.
Örnek değer
{
"duties": 0,
"taxes": 400.39,
"fees": -78.93,
"shipping": 966.87
}
| Alan↕ | Açıklama↕ |
|---|---|
duties | Sipariş için toplam gümrük vergisi tutarı. |
taxes | Sipariş için toplam vergi tutarı. |
fees | Sipariş için toplam ücretler. Negatif değerler kredileri gösterir. |
shipping | Sipariş için toplam kargo maliyeti. |
zonos_items
Ürün seviyesi maliyet dökümlemelerini içeren bir JSON dizisi. Her ürün, hem müşterinin ödediği para biriminde hem de mağazanızın temel para biriminde tutarları içerir.
Örnek değer
[
{
"amount": 830.53,
"productId": "49380521509183",
"currencyCode": "CAD",
"paidAmount": {
"amount": 830.53,
"currencyCode": "CAD"
},
"shopAmount": {
"amount": 606.85,
"currencyCode": "USD"
}
}
]
| Alan↕ | Açıklama↕ |
|---|---|
amount | Müşterinin para birimindeki ürün tutarı. |
productId | Bu ürün için Shopify ürün kimliği. |
currencyCode | Müşterinin ödediği para biriminin kodu. |
paidAmount.amount | Müşterinin bu ürün için ödediği tutar. |
paidAmount.currencyCode | Ödenen tutarın para birimi. |
shopAmount.amount | Mağazanızın temel para birimindeki eşdeğer tutar. |
shopAmount.currencyCode | Mağazanızın temel para birimi kodu. |
Meta alanlara erişme
Bu meta alanlara, Shopify sipariş meta alanlarını okumayı destekleyen herhangi bir yöntem aracılığıyla erişebilirsiniz:
- Shopify Admin API'si (GraphQL veya REST)
- Shopify Flow, Zonos sipariş verilerine dayalı iş akışlarını otomatikleştirmek için
- Üçüncü taraf uygulamalar, sipariş meta alanlarını okuyan (örneğin, raporlama araçları, ERP'ler)
Örnek: Shopify GraphQL API'si aracılığıyla sorgu
Shopify GraphQL sorgusu
query OrderZonosMetafields($orderId: ID!) {
order(id: $orderId) {
metafields(namespace: "zonos", first: 10) {
edges {
node {
key
value
}
}
}
}
}
Sipariş meta alanları
Zonos sipariş verilerine doğrudan Shopify siparişlerinizden erişin.
Zonos, sipariş ayrıntılarını
zonosad alanı altındaki Shopify sipariş meta alanlarına yazar. Bu, Zonos API'sini ayrı ayrı çağırmaya gerek kalmadan Zonos sipariş kimliklerine, ürün seviyesi maliyet dökümlemelerine ve gümrük vergisi/vergi/ücret alt toplamlarına doğrudan erişmenizi sağlar.Bu meta alanlar, Zonos aracılığıyla işlenen her Shopify siparişinde mevcuttur ve Shopify Admin API'si, Shopify Flow veya sipariş meta alanlarını okuyan herhangi bir araç aracılığıyla erişilebilir.