DOCS

Metafield pesanan

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.

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
}
FieldDeskripsi
dutiesTotal jumlah bea cukai untuk pesanan.
taxesTotal jumlah pajak untuk pesanan.
feesTotal biaya untuk pesanan. Nilai negatif menunjukkan kredit atau penyesuaian.
shippingTotal 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"
    }
  }
]
FieldDeskripsi
amountJumlah item dalam mata uang pelanggan.
productIdID produk Shopify untuk item ini.
currencyCodeMata uang yang dibayarkan pelanggan.
paidAmount.amountJumlah yang dibayarkan pelanggan untuk item ini.
paidAmount.currencyCodeMata uang dari jumlah yang dibayarkan.
shopAmount.amountJumlah setara dalam mata uang dasar toko Anda.
shopAmount.currencyCodeKode 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
        }
      }
    }
  }
}
Pesan demo

Apakah halaman ini bermanfaat?