Блог

Как узнать названия полей Честного знака для печати PDF

При создании собственного шаблона этикетки для Честного знака часто возникает главный вопрос: как называются поля, которые система передает в Jasper-шаблон, и какие значения в них находятся?

Например, в стандартной этикетке может быть только Data Matrix, хотя в данных товара дополнительно присутствуют наименование, модель, бренд, размер, цвет и другие характеристики. Чтобы использовать их в своем шаблоне и затем формировать PDF, нужно знать технические названия этих полей.

В EasyJasper это теперь можно определить автоматически. Достаточно получить в СУЗ один код маркировки в формате EPS и загрузить полученный ZIP в функцию «Магия макета». EasyJasper прочитает данные Честного знака, покажет найденные поля, их русские названия и примеры значений, после чего нужные поля можно сразу добавить в JRXML-шаблон.

Что понадобится

Перед началом у вас должны быть:

• зарегистрированный товар в «Честном знаке»;
• GTIN товара;
• доступ к Станции управления заказами (СУЗ);
• возможность заказать код маркировки для этого товара;
• шаблон JRXML, который вы хотите доработать в EasyJasper.

Если код маркировки уже заказан и заказ находится в статусе «Доступен», можно сразу перейти к разделу «Получаем один код в EPS».

---

Шаг 1. Откройте Станцию управления заказами

Войдите в личный кабинет системы маркировки «Честный знак» и перейдите в Станцию управления заказами (СУЗ).

Именно через СУЗ выполняется заказ и получение кодов маркировки.

Если у вас еще нет заказа, откройте:

Управление заказами → Заказы → Создать

---

Шаг 2. Создайте заказ на один код маркировки

На первом шаге заказа укажите необходимые параметры для вашего товара.

В зависимости от товарной группы набор полей может немного отличаться. Обычно требуется указать:

• товарную группу;
• способ выпуска товара в оборот;
• другие параметры заказа, предусмотренные выбранной товарной группой.

После заполнения общих данных перейдите к товарам.

На шаге «Товары» укажите GTIN нужного товара.

В поле количества кодов укажите:

Количество КМ: 1

То есть для проверки EasyJasper достаточно заказать всего один код маркировки.

Также потребуется указать способ формирования серийного номера. В большинстве обычных случаев используется автоматическое формирование.

Сохраните и отправьте заказ.

> Один код нужно заказывать именно для того товара, шаблон которого вы собираетесь создавать. Набор доступных полей может отличаться для разных товарных групп и товаров.

---

Шаг 3. Дождитесь готовности кода

После обработки заказа он появится среди активных заказов СУЗ.

Для получения файла код должен быть доступен для печати. В актуальном интерфейсе «Честного знака» необходимо открыть:

Заказы → Активные

Найдите заказ со статусом:

«Доступен»

Откройте его, нажав на идентификатор заказа.

Официальная инструкция «Честного знака» также указывает именно этот путь: активный заказ со статусом «Доступен» → раздел «Товары» → печать.

---

Шаг 4. Откройте печать кодов

В открытом заказе перейдите в раздел:

Товары

Найдите нужный товар и нажмите значок печати.

Откроется окно получения кодов маркировки.

---

Шаг 5. Выберите формат EPS

В поле «Формат» выберите:

EPS

Для EasyJasper в данном случае нужен именно EPS, а не PDF.

«Честный знак» позволяет получать коды через веб-интерфейс СУЗ в двух графических форматах:

• PDF;
• EPS.

Для EPS допускается выгрузка до 2000 кодов в одном файле, но для создания и проверки шаблона нам достаточно одного.

---

Шаг 6. Укажите количество — 1

В поле «Количество КМ» укажите:

1

Нажмите кнопку «Печать».

СУЗ создаст задачу на подготовку файла. После завершения формирования файл будет автоматически скачан на компьютер.

Не пугайтесь названия кнопки «Печать»: фактически при выборе EPS система сначала формирует файл, который можно сохранить на компьютере.

---

Шаг 7. Не распаковывайте ZIP

Для работы функции «Магия макета» используйте ZIP-файл, полученный от «Честного знака».

Распаковывать его перед загрузкой в EasyJasper не требуется.

Внутри выгрузки находятся данные, необходимые для работы с полученным кодом. EasyJasper анализирует файл attributes.json и определяет, какие сведения о товаре присутствуют в выгрузке.

Например, в зависимости от товарной группы там могут присутствовать:

• наименование товара;
• модель;
• бренд;
• цвет;
• размер;
• состав;
• страна производства;
• GTIN;
• другие характеристики товара.

Фактический список зависит от товарной группы и данных карточки товара.

---

Как загрузить ZIP Честного знака в EasyJasper

Теперь можно использовать полученный файл для создания шаблона.

Шаг 8. Откройте шаблон в EasyJasper

Откройте EasyJasper и загрузите существующий файл:

JRXML

или откройте шаблон, который уже редактируете.

Желательно использовать шаблон именно той товарной группы, для которой был получен тестовый код.

---

Шаг 9. Откройте «Магию макета»

В редакторе откройте:

Магия макета

и выберите функцию загрузки данных из ZIP «Честного знака».

Загрузите ZIP-файл, который получили на предыдущих шагах.

---

Шаг 10. Посмотрите, какие поля передает Честный знак

EasyJasper прочитает данные из attributes.json и покажет найденные поля.

Для удобства отображаются:

• название поля;
• понятное название на русском языке;
• пример реального значения из загруженного файла.

Например, вместо необходимости вручную выяснять, существует ли поле model, вы сразу можете увидеть:

Модель — Игрушка развивающая ABC-123

Это позволяет понять, какие данные действительно доступны вашему Jasper-шаблону.

---

Шаг 11. Выберите нужные поля

Отметьте характеристики, которые хотите вывести на этикетке.

Например:

• Наименование;
• Бренд;
• Модель;
• Размер;
• Цвет;
• Состав;
• Страна производства.

Не обязательно добавлять все найденные поля. Выберите только те, которые должны присутствовать на вашей этикетке.

---

Шаг 12. Добавьте поля на этикетку

Нажмите добавление выбранных полей.

EasyJasper создаст соответствующие элементы шаблона.

После этого их можно редактировать как обычные элементы:

• перемещать;
• изменять размер;
• менять шрифт;
• устанавливать выравнивание;
• добавлять подписи;
• располагать рядом с Data Matrix и другими элементами.

При необходимости можно использовать найденные поля и в более сложных выражениях Jasper.

---

Шаг 13. Настройте внешний вид этикетки

После добавления полей расположите их на этикетке.

Например:

Наименование: Игрушка развивающая Модель: ABC-123 Цвет: Красный Страна: Россия

Можно добавлять статические подписи или выводить только само значение.

Проверьте, чтобы длинные значения помещались в отведенную область. Особенно это важно для наименования товара, состава и других текстовых характеристик.

---

Шаг 14. Проверьте шаблон

После настройки выполните предпросмотр шаблона в EasyJasper.

Проверьте:

• положение всех элементов;
• размеры текста;
• отсутствие наложения полей;
• размер Data Matrix;
• отображение длинных значений;
• общий размер этикетки.

После проверки шаблон можно экспортировать в нужном формате.

Если вы только начинаете работу с пользовательскими этикетками, посмотрите базовую инструкцию: как подготовить шаблон этикетки Jasper для Честного знака. В ней отдельно разобраны файлы .jasper и .jrxml, загрузка в СУЗ и проверка готового макета.

---

Что в итоге дает эта функция

Раньше для создания пользовательского шаблона приходилось самостоятельно выяснять, какие поля передает «Честный знак», искать их технические названия и вручную добавлять соответствующие выражения в JRXML.

Теперь процесс выглядит гораздо проще:

получить один код EPS в Честном знаке → загрузить ZIP в EasyJasper → посмотреть реальные поля товара → выбрать нужные → добавить их в шаблон.

Это особенно полезно при работе с новой товарной группой, когда заранее неизвестно, какие характеристики доступны для использования в пользовательской этикетке.

---

Важно: PDF для этого не подходит

Если ваша цель — определить поля товара для «Магии макета», при получении тестового кода выбирайте:

EPS

а не PDF.

PDF предназначен прежде всего для готовой печати этикеток. Для анализа данных товара EasyJasper использует содержимое ZIP-выгрузки EPS.

---

Не нужно получать много кодов

Для создания шаблона нет необходимости выгружать большой заказ.

Для проверки достаточно:

1 товар → 1 код маркировки → EPS

После того как вы определили необходимые поля и подготовили JRXML-шаблон, этот же шаблон можно использовать уже для обычной печати кодов соответствующего товара.

---

FAQ

Можно ли скачать один код маркировки в EPS?

Да. При формировании файла в СУЗ можно указать количество кодов маркировки — 1. Этого достаточно, чтобы проверить данные товара и подготовить шаблон в EasyJasper.

Где скачать EPS в Честном знаке?

Откройте СУЗ, перейдите в активный заказ со статусом «Доступен», откройте товары, нажмите печать и выберите формат EPS.

Нужно ли распаковывать ZIP перед загрузкой в EasyJasper?

Нет. ZIP-файл можно загрузить непосредственно в «Магию макета». EasyJasper сам прочитает необходимые данные из attributes.json.

Зачем EasyJasper нужен ZIP из Честного знака?

В ZIP содержатся данные, которые помогают определить доступные поля товара. EasyJasper показывает их названия и примеры значений, после чего выбранные поля можно добавить в JRXML-шаблон.

Какие поля можно получить из Честного знака?

Набор зависит от товарной группы и карточки товара. Это могут быть наименование, модель, бренд, цвет, размер, состав, страна производства и другие характеристики.

Подойдет ли PDF вместо EPS?

Для функции «Магия макета» рекомендуется использовать ZIP, полученный при выгрузке в EPS. PDF предназначен прежде всего для готовой печати.

Нужно ли заказывать новый код специально для EasyJasper?

Не обязательно. Если у вас уже есть подходящий активный заказ и возможность получить из него EPS, можно использовать его. Для тестирования достаточно одного кода.

Изменяет ли EasyJasper сами коды маркировки?

Нет. EasyJasper использует данные выгрузки для подготовки шаблона и работы с полями товара. Сам код маркировки не изменяется.

---

Краткая инструкция

1. Войдите в «Честный знак».
2. Откройте СУЗ.
3. Создайте заказ на нужный GTIN, если его еще нет.
4. Укажите количество КМ — 1.
5. Дождитесь статуса заказа «Доступен».
6. Откройте Заказы → Активные → нужный заказ → Товары.
7. Нажмите значок печати.
8. Выберите формат EPS.
9. Укажите количество 1.
10. Нажмите «Печать».
11. Сохраните полученный ZIP-файл.
12. Откройте JRXML в EasyJasper.
13. Запустите «Магию макета».
14. Загрузите ZIP «Честного знака».
15. Выберите найденные поля.
16. Добавьте их на этикетку и настройте расположение.
17. Проверьте шаблон и экспортируйте JRXML/Jasper.

Готово — теперь шаблон использует реальные поля, которые «Честный знак» передает для вашего товара.