DOCS

Sipariş meta alanları

Sipariş meta alanları

Zonos sipariş verilerine doğrudan Shopify siparişlerinizden erişin.

Zonos, sipariş ayrıntılarını zonos ad 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.

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
}
AlanAçıklama
dutiesSipariş için toplam gümrük vergisi tutarı.
taxesSipariş için toplam vergi tutarı.
feesSipariş için toplam ücretler. Negatif değerler kredileri gösterir.
shippingSipariş 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"
    }
  }
]
AlanAçıklama
amountMüşterinin para birimindeki ürün tutarı.
productIdBu ürün için Shopify ürün kimliği.
currencyCodeMüşterinin ödediği para biriminin kodu.
paidAmount.amountMüşterinin bu ürün için ödediği tutar.
paidAmount.currencyCodeÖdenen tutarın para birimi.
shopAmount.amountMağazanızın temel para birimindeki eşdeğer tutar.
shopAmount.currencyCodeMağ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
        }
      }
    }
  }
}

Bu sayfa faydalı mıydı?