Скачать в PDF

Квантрон–XML–Каталог

1. Структура каталогов и формат именования файлов

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

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

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

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

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

OUT_AGGREGATION_LVL0_<UUID>.xml — отчет о первичной упаковке продукции.

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

• PREFIX — префикс файла, определяющий тип операции.
• UUID — уникальный идентификатор задания, обеспечивающий однозначную связь запросов и ответов.

Примеры префиксов: * IN_MARK — создание задания на маркировку. * OUT_AGGREGATION_LVL0 — отчет о первичной упаковке.

2. Файл задания

Формат имени файла: 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.
• Пример значения: 02bf7221-c0ae-11f1-aa4f-1402ec40f15f

Элемент <gitin>:

• Тип данных: GTIN-код (Global Trade Item Number).
• Описание: код GTIN товара, состоящий из 14 цифр.
• Пример значения: 04620131971695

Элемент <data>:

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

Элемент <date_prod>:

• Тип данных: дата.
• Описание: дата производства продукции в формате ДД.ММ.ГГГГ.
• Пример значения: 05.10.2026

Элемент <date_exp>:

• Тип данных: дата.
• Описание: срок годности продукции в формате ДД.ММ.ГГГГ.
• Пример значения: 04.11.2026

Элемент <task>:

• Тип данных: целое число.
• Описание: номер задания в учетной системе L3.
• Пример значения: 133

Элемент <batch>:

• Тип данных: целое число.
• Описание: номер партии продукции. Может быть пустым.

Элемент <internal_lot>:

• Тип данных: строка.
• Описание: внутренний номер партии. Может быть пустым.

Элемент <labels>:

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

  <label><![CDATA[0104620131971695215S/VOq93dGVz]]></label>
  

Пример файла

<?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">
    <document_id>02bf7221-c0ae-11f1-aa4f-1402ec40f15f</document_id>
    <gitin>04620131971695</gitin>
    <data>05.10.2026</data>
    <date_prod>05.10.2026</date_prod>
    <date_exp>04.11.2026</date_exp>
    <task>133</task>
    <batch/>
    <internal_lot/>
    <labels>
        <label><![CDATA[0104620131971695215S/VOq93dGVz]]></label>
        <label><![CDATA[0104620131971695215Q0LaF93dGVz]]></label>
        <label><![CDATA[0104620131971695215Wct6P93dGVz]]></label>
        <label><![CDATA[0104620131971695215JzIqt93dGVz]]></label>
        <label><![CDATA[0104620131971695215cQCjA93dGVz]]></label>
        <label><![CDATA[0104620131971695215g*VJN93dGVz]]></label>
        <label><![CDATA[0104620131971695215C2RQ=93dGVz]]></label>
        <label><![CDATA[0104620131971695215lr+._93dGVz]]></label>
        <label><![CDATA[0104620131971695215Q";5T93dGVz]]></label>
        <label><![CDATA[0104620131971695215tGhQW93dGVz]]></label>
    </labels>
</root>