Metafield degli ordini

Zonos scrive i dettagli dell'ordine nei metafield degli ordini Shopify sotto il namespace zonos. In questo modo ha accesso diretto agli ID ordine Zonos, alle ripartizioni dei costi a livello articolo e ai subtotali di dazi/imposte/commissioni senza dover chiamare separatamente l'API Zonos.

Questi metafield sono disponibili su ogni ordine Shopify elaborato tramite Zonos e possono essere consultati tramite Shopify Admin API, Shopify Flow o qualsiasi strumento che legge i metafield degli ordini.

Metafield disponibili 

Zonos scrive tre metafield su ogni ordine Shopify, tutti sotto il namespace zonos.

zonos_id

L'ID ordine Zonos univoco collegato a questo ordine Shopify. Utilizzi questo ID per consultare l'ordine completo in Zonos Dashboard o tramite l'API Zonos.

order_19d69db6-450f-45a7-a4a1-c678c7d7dd90

zonos_subtotals

Un oggetto JSON contenente i totali aggregati di dazi, imposte, commissioni e spedizione per l'ordine.

{
  "duties": 0,
  "taxes": 400.39,
  "fees": -78.93,
  "shipping": 966.87
}

zonos_items

Un array JSON contenente ripartizioni dei costi a livello articolo. Ogni articolo include importi sia nella valuta pagata dal cliente sia nella valuta base del negozio.

[
  {
    "amount": 830.53,
    "productId": "49380521509183",
    "currencyCode": "CAD",
    "paidAmount": {
      "amount": 830.53,
      "currencyCode": "CAD"
    },
    "shopAmount": {
      "amount": 606.85,
      "currencyCode": "USD"
    }
  }
]

Accedere ai metafield 

Può accedere a questi metafield tramite qualsiasi metodo che supporti la lettura dei metafield degli ordini Shopify:

• Shopify Admin API (GraphQL o REST)
• Shopify Flow per automatizzare i flussi di lavoro in base ai dati degli ordini Zonos
• App di terze parti che leggono i metafield degli ordini (ad es. strumenti di reporting, ERP)

Esempio: query tramite Shopify GraphQL API

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