Pola metadanych zamówienia

Zonos zapisuje szczegóły zamówienia do pól metadanych zamówień Shopify w przestrzeni nazw zonos. To daje ci bezpośredni dostęp do identyfikatorów zamówień Zonos, zestawień kosztów na poziomie przedmiotu oraz sum cła/podatku/opłaty bez potrzeby oddzielnego wywoływania interfejsu API Zonos.

Te pola metadanych są dostępne na każdym zamówieniu Shopify przetwarzanym przez Zonos i można uzyskać do nich dostęp za pośrednictwem interfejsu API administracyjnego Shopify, Shopify Flow lub dowolnego narzędzia, które odczytuje pola metadanych zamówienia.

Dostępne pola metadanych 

Zonos zapisuje trzy pola metadanych do każdego zamówienia Shopify, wszystkie w przestrzeni nazw zonos.

zonos_id

Unikatowy identyfikator zamówienia Zonos połączony z tym zamówieniem Shopify. Użyj tego identyfikatora, aby znaleźć pełne zamówienie w Zonos Dashboard lub za pośrednictwem interfejsu API Zonos.

order_19d69db6-450f-45a7-a4a1-c678c7d7dd90

zonos_subtotals

Obiekt JSON zawierający zagregowane sumy cła, podatku, opłaty i wysyłki dla zamówienia.

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

zonos_items

Tablica JSON zawierająca zestawienia kosztów na poziomie przedmiotu. Każdy przedmiot zawiera kwoty zarówno w walucie zapłaconej przez klienta, jak i w walucie bazowej sklepu.

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

Uzyskiwanie dostępu do pól metadanych 

Możesz uzyskać dostęp do tych pól metadanych za pośrednictwem dowolnej metody, która obsługuje odczytywanie pól metadanych zamówień Shopify:

• Interfejs API administracyjny Shopify (GraphQL lub REST)
• Shopify Flow do automatyzacji przepływów pracy na podstawie danych zamówienia Zonos
• Aplikacje firm trzecich, które odczytują pola metadanych zamówień (np. narzędzia raportowania, systemy ERP)

Przykład: Zapytanie za pośrednictwem interfejsu API GraphQL Shopify

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