Скачать в PDF

Формат обмена с линией «GPS-XML–Каталог»

Формат GPS-XML предназначен для взаимодействия между системой EnkodeTrack и производственной линией. Обмен осуществляется посредством XML-файлов.

1. Структура каталогов

Каталог отправки заданий: IN/

Файлы в данном каталоге содержат запросы на создание заданий, выполнение операций маркировки и упаковку продукции. Примеры файлов:

• IN_MARK_<UUID>.xml: Файл задания на маркировку продукции.

Каталог приёма результатов: OUT/

Файлы в данном каталоге представляют собой ответы от производственной линии на отправленные задания. Они включают отчётность о выполненных операциях, упаковке и агрегатировании. Примеры файлов:

• OUT_AGGREGATION_LVL0_<UUID>.xml: Отчёт о первичной упаковке продукции
• OUT_AGGREGATION_LVL1_<UUID>.xml: Отчёт о вторичной упаковке продукции (например, укладка первичной продукции в короб)
• OUT_AGGREGATION_LVL2_<UUID>.xml: Отчёт о третичной упаковке продукции (например, укладка коробок на паллеты)

2. Форматы именования файлов

Все файлы имеют структуру имени вида <PREFIX>_<UUID>.xml, где:

• PREFIX: Префикс файла, определяющий тип операции (MARK, AGGREGATION.)
• UUID: Уникальный идентификатор задания, обеспечивающий однозначную связь запросов и ответов

Примеры префиксов:

• IN_MARK: Создание задания на маркировку
• OUT_AGGREGATION_LVL0: Упаковка уровня 0 (первичная упаковка)
• OUT_AGGREGATION_LVL1: Агрегирование уровня 2 (вторичная упаковка)

3 Файл задания на маркировку (IN_MARK_<UUID>.xml)

<?xml version="1.0" encoding="UTF-8"?>  
<root xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

Общий заголовок документа: Форматирует версию XML (version) и кодировку файла (encoding). Пространства имен xs и xsi используются для поддержки схемы XSD и экземпляров XML соответственно.

Элемент <document_id>:

Тип данных: UUID

Описание: Уникальный идентификатор документа в виде UUID v4. Пример значения: 3a3845c8-6eba-11f0-9a0e-6805caf3bcb1

Элемент <gitin>:

Тип данных: GTIN-код (Global Trade Item Number)

Описание: Код GTIN товара (глобальная идентификационная метка), состоящий из 14 цифр. Пример значения: 04620131970032

Элемент <data>:

Тип данных: дата

Описание: Дата производства продукта в формате ДД.ММ.ГГГГ. Пример значения: 01.08.2025

Элемент **<product>:

Тип данных: строка:

писание: Название производимого продукта. Пример значения: Сыр Чедер — ЭНКОД ТЕХНО

Элемент <line>:

Тип данных: целое число

Описание: Номер производственной линии, на которой изготовлен продукт. Пример значения: 1

Элемент <batch>:

Тип данных: целое число

Описание: Идентификационный номер партии продукции. Пример значения: 281

Элемент <lot>:

Тип данных: целое число

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

Элемент <expirationdate>:

Тип данных: дата

Описание: Срок годности продукта в формате ДД.ММ.ГГГГ.

Пример значения: 30.10.2025

Элемент <ineusedate>:

Тип данных: дата

Описание: Дата ввода продукта в эксплуатацию или начало срока хранения в формате ДД.ММ.ГГГГ. Пример значения: 01.08.2025

Элемент <labels>:

Тип данных: массив строковых значений внутри CDATA-разметки

Описание: Список уникальных маркировочных этикеток (DataMatrix-кодов). Пример значения:

<label><![CDATA[0104620131970032215!!w!(93dGVz]]></label>

Элемент <box_labels>:

Тип данных: массив строковых значений внутри CDATA-разметки

Описание: Массив уникальных упаковочных этикеток (GS1 AI-01). Пример значения:

<label><![CDATA[184144632300005449]]></label>

Элемент <pallet_labels>:

Тип данных: массив строковых значений внутри CDATA-разметки

Описание: Массив уникальных паллетных этикеток (GS1 AI-01). Пример значения:

<label><![CDATA[284144632300005453]]></label>

Пример файла IN_MARK_3a3845c8-6eba-11f0-9a0e-6805caf3bcb1.xml

<root xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <document_id>3a3845c8-6eba-11f0-9a0e-6805caf3bcb1</document_id>
    <gitin>04620131970032</gitin>
    <data>01.08.2025</data>
    <product>Сыр Чедер - ЭНКОД ТЕХНО</product>
    <line>1</line>
    <batch>281</batch>
    <lot>100</lot>
    <expirationdate>30.10.2025</expirationdate>
    <ineusedate>01.08.2025</ineusedate>
    <labels>
        <label><![CDATA[0104620131970032215!!w!(93dGVz]]> </label>
        <label><![CDATA[0104620131970032215!%LPw93dGVz]]> </label>
        <label><![CDATA[0104620131970032215!%nDC93dGVz]]> </label>
        <label><![CDATA[0104620131970032215'!)xc93dGVz]]> </label>
        <label><![CDATA[0104620131970032215!*"tE93dGVz]]> </label>
    </labels>
    <box_labels>
        <label><![CDATA[184144632300005449]]> </label>
    </box_labels>
    <pallet_labels>
        <label><![CDATA[284144632300005453]]> </label>
    </pallet_labels>
</root>

4. Формат описания XML файла ответа

4.1. Уровень агрегации потребительская упаковка

• OUT_AGGREGATION_LVL0_3a3845c8-6eba-11f0-9a0e-6805caf3bcb1.xml

Описание элементов:

1. Заголовок XML: <?xml version="1.0" encoding="utf-8"?>
   • Стандартная декларация XML-версии и кодировки UTF-8.
2. Корневой элемент <Document>
   • Главный контейнер для всего содержимого документа.
3. Элемент <document_id>:
   • Тип данных: UUID.
   • Содержит уникальный идентификатор документа.
4. Элемент <gitin>:
   • Тип данных: GTIN (14 цифр).
   • Представляет собой глобальную торговую идентификационную метку, уникальную для каждого вида товара.
5. Элемент <data>:
   • Тип данных: дата.
   • Отображает дату формирования документа или отправления заказа в формате ДД.ММ.ГГГГ.
6. Элемент <batch>:
   • Тип данных: число.
   • Определяет номер партии продукции, связанной с данным документом.
7. Элемент <lot>:
   • Тип данных: строка.
   • Может содержать серийный номер партии.
8. Элементы <cis>:
   • Каждый элемент содержит строку в формате CDATA. Внутри него указывается уникальный маркировочный код продукции.

Пример файла XML

<?xml version="1.0" encoding="utf-8"?>
<Document>
    <document_id>3a3845c8-6eba-11f0-9a0e-6805caf3bcb1</document_id>
    <gitin>04620131970032</gitin>
    <data>30.01.2025</data>
    <batch>281</batch>
    <lot>01.02.2025</lot>
    <cis><![CDATA[0104620131970032215!!w!(93dGVz]]></cis>
    <cis><![CDATA[0104620131970032215!%LPw93dGVz]]></cis>
    <cis><![CDATA[0104620131970032215!%nDC93dGVz]]></cis>
    <cis><![CDATA[0104620131970032215'!)xc93dGVz]]></cis>
    <cis><![CDATA[0104620131970032215!*"tE93dGVz]]></cis>
</Document>

4.2. Уровень агрегации упаковка или паллет

• OUT_AGGREGATION_LVL1_3a3845c8-6eba-11f0-9a0e-6805caf3bcb1.xml (упаковка)
• OUT_AGGREGATION_LVL2_3a3845c8-6eba-11f0-9a0e-6805caf3bcb1.xml (паллет)

Описание элементов:

1. Корневой элемент <Document>
   • Это основной контейнер для всей структуры XML-данных.
2. Элемент <document_id>
   • Тип данных: UUID
   • Предназначение: Уникальный идентификатор документа,.
3. Элемент <gitin>
   • Тип данных: GTIN (14 цифр)
   • Предназначение: Глобальный идентификатор торговой позиции, представляющий стандартный международный код для уникальной идентификации продукции.
4. Элемент <data>
   • Тип данных: дата
   • Предназначение: Дата формирования документа в формате DD.MM.YYYY,
5. Элемент <batch>
   • Тип данных: числовое значение
   • Предназначение: Идентификатор задания.
6. Элемент <lot>
   • Тип данных: строка или числовой идентификатор
   • Предназначение: номер партии.
7. Элемент <pack_content>
   • Тип данных: контейнер
   • Предназначение: Контейнер для группы элементов, содержащих информацию о единицах упакованной продукции. Повторяется столько раз, сколько имеется отдельных позиций.
8. Элемент <pack_code>
   • Атрибут capacity: Вес или объем упаковки (необязательно).
   • Тип данных: текстовое поле в формате CDATA
   • Предназначение: Уникальный код упаковки, использующийся для идентификации контейнера или коробки.
9. Элемент <cis>
   • Атрибут capacity: Аналогично атрибуту в <pack_code>, вес или объем продукции (необязательно).
   • Тип данных: текстовое поле в формате CDATA
   • Предназначение: Индивидуальные маркировочные коды, присвоенные отдельным единицам продукции внутри упаковки.

Пример файла:

• OUT_AGGREGATION_LVL1_3a3845c8-6eba-11f0-9a0e-6805caf3bcb1.xml (упаковка)
• OUT_AGGREGATION_LVL2_3a3845c8-6eba-11f0-9a0e-6805caf3bcb1.xml (паллет)

<?xml version="1.0" encoding="utf-8"?>
<Document>
    <document_id>3a3845c8-6eba-11f0-9a0e-6805caf3bcb1</document_id>
    <gitin>04620131970032</gitin>
    <data>06.08.2025</data>
    <batch>281</batch>
    <lot>8</lot>
    <pack_content>
        <pack_code capacity="14.846"><![CDATA[184144632300005449]]></pack_code>
        <cis capacity="14.846"><![CDATA[0104620131970032215!!w!(93dGVz]]></cis>
    </pack_content>
    <pack_content>
        <pack_code capacity="14.436"><![CDATA[184144632300005449]]></pack_code>
        <cis capacity="14.436"><![CDATA[0104620131970032215!%nDC93dGVz]]></cis>
    </pack_content>
</Document>