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
}
| Felt↕ | Beskrivelse↕ |
|---|---|
duties | Samlet toldbeløb for ordren. |
taxes | Samlet skattebeløb for ordren. |
fees | Samlede gebyrer for ordren. Negative værdier angiver kreditter eller justeringer. |
shipping | Samlet 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"
}
}
]
| Felt↕ | Beskrivelse↕ |
|---|---|
amount | Varebeløb i kundens valuta. |
productId | Shopify-produkt-ID for denne vare. |
currencyCode | Valutaen kunden betalte i. |
paidAmount.amount | Beløbet kunden betalte for denne vare. |
paidAmount.currencyCode | Valuta for det betalte beløb. |
shopAmount.amount | Tilsvarende beløb i din shops basisvaluta. |
shopAmount.currencyCode | Din 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
}
}
}
}
}
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.