DOCS

Ordremetafields

Ordremetafields

Få tilgang til Zonos-ordredata direkte fra dine Shopify-ordrer.

Zonos skriver ordredetaljer til Shopify-ordremetafields under zonos-navnerommet. Dette gir deg direkte tilgang til Zonos-ordre-ID-er, kostoppdelinger på varenivå og undertotaler for toll/avgifter/gebyrer uten å trenge å kalle Zonos API-en separat.

Disse metafields er tilgjengelige på alle Shopify-ordrer som behandles gjennom Zonos og kan nås via Shopify Admin API, Shopify Flow eller ethvert verktøy som leser ordremetafields.

Tilgjengelige metafields 

Zonos skriver tre metafields til hver Shopify-ordre, alle under zonos-navnerommet.

zonos_id

Den unike Zonos-ordre-ID-en som er knyttet til denne Shopify-ordren. Bruk denne ID-en til å slå opp hele ordren i Zonos Dashboard eller via Zonos API.

Eksempelverdi

order_19d69db6-450f-45a7-a4a1-c678c7d7dd90

zonos_subtotals

Et JSON-objekt som inneholder de aggregerte toll-, avgifts-, gebyr- og frakttotaler for ordren.

Eksempelverdi

{
  "duties": 0,
  "taxes": 400.39,
  "fees": -78.93,
  "shipping": 966.87
}
FeltBeskrivelse
dutiesTotalt tollbeløp for ordren.
taxesTotalt avgiftsbeløp for ordren.
feesTotale gebyrer for ordren. Negative verdier angir kreditter eller justeringer.
shippingTotale fraktkostnader for ordren.

zonos_items

En JSON-matrise som inneholder kostoppdelinger på varenivå. Hvert element inkluderer beløp både i kundens betalte valuta og butikkens basisvaluta.

Eksempelverdi

[
  {
    "amount": 830.53,
    "productId": "49380521509183",
    "currencyCode": "CAD",
    "paidAmount": {
      "amount": 830.53,
      "currencyCode": "CAD"
    },
    "shopAmount": {
      "amount": 606.85,
      "currencyCode": "USD"
    }
  }
]
FeltBeskrivelse
amountVarebeløp i kundens valuta.
productIdShopify-produkt-ID-en for denne varen.
currencyCodeValutaen kunden betalte i.
paidAmount.amountBeløpet kunden betalte for denne varen.
paidAmount.currencyCodeValuta for det betalte beløpet.
shopAmount.amountTilsvarende beløp i butikkens basisvaluta.
shopAmount.currencyCodeButikkens basisvalutakode.

Få tilgang til metafields 

Du kan få tilgang til disse metafields ved hjelp av enhver metode som støtter lesing av Shopify-ordremetafields:

  • Shopify Admin API (GraphQL eller REST)
  • Shopify Flow for automatisering av arbeidsflyter basert på Zonos-ordredata
  • Tredjepartsapper som leser ordremetafields (f.eks. rapporteringsverktøy, ERP-er)

Eksempel: Spørring via Shopify GraphQL API

Shopify GraphQL-spørring

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

Var denne siden nyttig?