Метаполя заказа

Zonos записывает сведения о заказе в метаполя заказов Shopify в пространстве имён zonos. Это дает вам прямой доступ к ID заказов Zonos, разбивкам затрат на уровне товара и промежуточным итогам по пошлинам/налогам/сборам без необходимости отдельного вызова API Zonos.

Эти метаполя доступны на каждом заказе Shopify, обработанном через Zonos, и к ним можно получить доступ через Shopify Admin API, Shopify Flow или любой инструмент, который читает метаполя заказов.

Доступные метаполя 

Zonos записывает три метаполя на каждый заказ Shopify, все в пространстве имён zonos.

zonos_id

Уникальный ID заказа Zonos, связанный с этим заказом Shopify. Используйте этот ID для поиска полного заказа в Zonos Dashboard или через API Zonos.

order_19d69db6-450f-45a7-a4a1-c678c7d7dd90

zonos_subtotals

Объект JSON, содержащий совокупные итоговые суммы по пошлинам, налогам, сборам и доставке за заказ.

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

zonos_items

Массив JSON, содержащий разбивки затрат на уровне товара. Каждый товар включает суммы как в валюте, которую платил клиент, так и в базовой валюте вашего магазина.

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

Доступ к метаполям 

Вы можете получить доступ к этим метаполям через любой метод, поддерживающий чтение метаполей заказов Shopify:

• Shopify Admin API (GraphQL или REST)
• Shopify Flow для автоматизации рабочих процессов на основе данных заказов Zonos
• Приложения третьих сторон, которые читают метаполя заказов (например, инструменты отчетности, ERP)

Пример: запрос через API GraphQL Shopify

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