DOCS

Ordre-metafields

Ordre-metafields

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

Zonos skriver ordredetaljer til Shopify-ordre-metafields under zonos-navnerummet. Det giver dig direkte adgang til Zonos-ordre-ID'er, omkostningsopdelinger på vareniveau og subtotaler for told/skat/gebyr uden at skulle kalde Zonos API separat.

Disse metafields er tilgængelige på alle Shopify-ordrer behandlet gennem Zonos og kan tilgås via Shopify Admin API, Shopify Flow eller ethvert værktøj, der læser ordre-metafields.

Tilgængelige metafields 

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

zonos_id

Det unikke Zonos-ordre-ID knyttet til denne Shopify-ordre. Brug dette ID til at slå den fulde ordre op i Zonos Dashboard eller via Zonos API.

Eksempelværdi

order_19d69db6-450f-45a7-a4a1-c678c7d7dd90

zonos_subtotals

Et JSON-objekt med de aggregerede told-, skatte-, gebyr- og fragttotaler for ordren.

Eksempelværdi

{
  "duties": 0,
  "taxes": 400.39,
  "fees": -78.93,
  "shipping": 966.87
}
FeltBeskrivelse
dutiesSamlet toldbeløb for ordren.
taxesSamlet skattebeløb for ordren.
feesSamlede gebyrer for ordren. Negative værdier angiver kreditter eller justeringer.
shippingSamlet fragtomkostning for ordren.

zonos_items

Et JSON-array med omkostningsopdelinger på vareniveau. Hver vare inkluderer beløb i både kundens betalte valuta og din shops basisvaluta.

Eksempelværdi

[
  {
    "amount": 830.53,
    "productId": "49380521509183",
    "currencyCode": "CAD",
    "paidAmount": {
      "amount": 830.53,
      "currencyCode": "CAD"
    },
    "shopAmount": {
      "amount": 606.85,
      "currencyCode": "USD"
    }
  }
]
FeltBeskrivelse
amountVarebeløb i kundens valuta.
productIdShopify-produkt-ID for denne vare.
currencyCodeValutaen kunden betalte i.
paidAmount.amountBeløbet kunden betalte for denne vare.
paidAmount.currencyCodeValuta for det betalte beløb.
shopAmount.amountTilsvarende beløb i din shops basisvaluta.
shopAmount.currencyCodeDin shops basisvalutakode.

Adgang til metafields 

Du kan tilgå disse metafields via enhver metode, der understøtter læsning af Shopify-ordre-metafields:

  • Shopify Admin API (GraphQL eller REST)
  • Shopify Flow til automatisering af workflows baseret på Zonos-ordredata
  • Tredjepartsapps, der læser ordre-metafields (f.eks. rapporteringsværktøjer, ERP'er)

Eksempel: Forespørgsel via Shopify GraphQL API

Shopify GraphQL-forespørgsel

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

Var denne side nyttig?