Как работают ключи метаданных
Каждый товар в заказе может содержать один или несколько записей метаданных — ключ и значение. Ваша платформа отправляет их в Zonos при создании заказа. По умолчанию Zonos сохраняет эти метаданные, но не отображает их в разбивке заказа.
Когда вы добавляете ключ на странице настроек, Zonos ищет этот ключ для каждого товара в заказе и отображает соответствующее значение как дополнительную строку под товаром.
- Несколько значений для одного ключа объединяются запятой — например,
красный, большой. - Товары без этого ключа просто не показывают строку, поэтому детали заказа остаются чистыми.
- Ключи настраиваются на уровне организации. Каждый пользователь в вашей организации видит одни и те же строки метаданных.
Когда использовать это
Общие случаи использования:
- Гравировка или персонализация — отображайте ключ
engraving-text, чтобы склад знал, что заказ требует пользовательской работы перед отправкой. - Подарочные заказы — отображайте ключ
gift-messageилиgift-wrap, чтобы упаковщики могли включить нужный вкладыш. - Подписки или лояльность — отображайте ключ
subscription-idилиloyalty-tierдля контекста поддержки и выполнения заказов. - Пользовательские поля платформы — любое поле уровня товара, которое отправляет ваша платформа и которое ваша команда должна видеть в заказе.
Добавить ключ метаданных
- Перейдите в Dashboard -> Settings -> Orders -> Preferences.
- В поле Metadata keys введите точное имя ключа, который отправляет ваша платформа (например,
engraving-text). - Нажмите Add.
Ключ будет немедленно применён ко всем страницам деталей заказа. Откройте любое разбивку заказа, чтобы подтвердить, что новая строка появляется под каждым товаром, содержащим эти метаданные.

Имена ключей чувствительны к регистру и должны точно совпадать с тем, что отправляет ваша платформа. Если вы не уверены в точном ключе, проверьте сырые метаданные недавнего заказа или спросите у вашего разработчика.
Удалить ключ метаданных
- Перейдите в Dashboard -> Settings -> Orders -> Preferences.
- Найдите ключ, который хотите удалить, в списке.
- Нажмите значок корзины в правой части строки.
Строка перестанет отображаться в разбивке заказа для новых и существующих заказов.
Решение проблем
Строка не отображается на странице деталей заказа.
- Убедитесь, что имя ключа совпадает точно, включая регистр и любые дефисы или подчёркивания (
engraving-text— это не то же самое, чтоEngraving_Text). - Убедитесь, что товар в заказе действительно имеет эти метаданные. Старые заказы, созданные до того, как ваша платформа начала отправлять ключ, не будут его иметь.
Строка отображается, но пуста.
- Платформа отправила ключ с пустым значением. Проверьте интеграцию на стороне платформы, чтобы убедиться, что значение заполняется.
Ключ отображается на некоторых товарах, но не на других.
- Это ожидается — метаданные привязаны к товару, а не к заказу. Строка будет отображаться только на товарах, для которых платформа отправила ключ.
Настройки заказов
Отображение метаданных платформы для каждого товара в заказе.
Когда ваша платформа электронной коммерции отправляет дополнительную информацию с каждым заказом — например, заметку о гравировке, подарочное сообщение или идентификатор подписки — Zonos получает её как метаданные. Страница настроек заказов позволяет выбрать, какие ключи метаданных должны отображаться для каждого товара в разбивке заказа, чтобы ваша команда выполнения заказов могла видеть, что нужно делать с первого взгляда, без необходимости открывать исходную платформу.