DOCS

Ordermetafält

Ordermetafält

Få tillgång till Zonos-orderdata direkt från era Shopify-ordrar.

Zonos skriver orderdetaljer till Shopify-ordermetafält under namnutrymmet zonos. Det ger er direkt tillgång till Zonos order-ID:n, kostnadsuppdelningar på artikelnivå och delsummor för tull/skatt/avgifter utan att behöva anropa Zonos API separat.

Dessa metafält finns på varje Shopify-order som bearbetas via Zonos och kan nås via Shopify Admin API, Shopify Flow eller valfritt verktyg som läser ordermetafält.

Tillgängliga metafält 

Zonos skriver tre metafält till varje Shopify-order, alla under namnutrymmet zonos.

zonos_id

Det unika Zonos order-ID som är kopplat till denna Shopify-order. Använd detta ID för att slå upp den fullständiga ordern i Zonos Dashboard eller via Zonos API.

Exempelvärde

order_19d69db6-450f-45a7-a4a1-c678c7d7dd90

zonos_subtotals

Ett JSON-objekt som innehåller aggregerade totalsummor för tull, skatt, avgifter och frakt för ordern.

Exempelvärde

{
  "duties": 0,
  "taxes": 400.39,
  "fees": -78.93,
  "shipping": 966.87
}
FältBeskrivning
dutiesTotalt tullbelopp för ordern.
taxesTotalt skattebelopp för ordern.
feesTotala avgifter för ordern. Negativa värden anger krediter eller justeringar.
shippingTotal fraktkostnad för ordern.

zonos_items

En JSON-array som innehåller kostnadsuppdelningar på artikelnivå. Varje artikel inkluderar belopp i både kundens betalda valuta och er butiks basvaluta.

Exempelvärde

[
  {
    "amount": 830.53,
    "productId": "49380521509183",
    "currencyCode": "CAD",
    "paidAmount": {
      "amount": 830.53,
      "currencyCode": "CAD"
    },
    "shopAmount": {
      "amount": 606.85,
      "currencyCode": "USD"
    }
  }
]
FältBeskrivning
amountArtikelbelopp i kundens valuta.
productIdShopify-produkt-ID för denna artikel.
currencyCodeValutan som kunden betalade i.
paidAmount.amountBeloppet kunden betalade för denna artikel.
paidAmount.currencyCodeValuta för det betalda beloppet.
shopAmount.amountMotsvarande belopp i er butiks basvaluta.
shopAmount.currencyCodeEr butiks basvalutakod.

Åtkomst till metafält 

Ni kan komma åt dessa metafält via valfri metod som stöder läsning av Shopify-ordermetafält:

  • Shopify Admin API (GraphQL eller REST)
  • Shopify Flow för att automatisera arbetsflöden baserat på Zonos-orderdata
  • Tredjepartsappar som läser ordermetafält (t.ex. rapporteringsverktyg, ERP:er)

Exempel: Fråga via Shopify GraphQL API

Shopify GraphQL-fråga

query OrderZonosMetafields($orderId: ID!) {
  order(id: $orderId) {
    metafields(namespace: "zonos", first: 10) {
      edges {
        node {
          key
          value
        }
      }
    }
  }
}
Boka en demo

Var den här sidan till hjälp?