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ält↕ | Beskrivning↕ |
|---|---|
duties | Totalt tullbelopp för ordern. |
taxes | Totalt skattebelopp för ordern. |
fees | Totala avgifter för ordern. Negativa värden anger krediter eller justeringar. |
shipping | Total 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ält↕ | Beskrivning↕ |
|---|---|
amount | Artikelbelopp i kundens valuta. |
productId | Shopify-produkt-ID för denna artikel. |
currencyCode | Valutan som kunden betalade i. |
paidAmount.amount | Beloppet kunden betalade för denna artikel. |
paidAmount.currencyCode | Valuta för det betalda beloppet. |
shopAmount.amount | Motsvarande belopp i er butiks basvaluta. |
shopAmount.currencyCode | Er 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
}
}
}
}
}
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.