Скачать в PDF

АЛЬБИГА–XML–Каталог

Формат АЛЬБИГА-XML предназначен для взаимодействия между системой Encode Track и производственной линией АЛЬБИГА.

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

Каждый L 2 имеет две сетевые папки:

• Receive — прием файлов от L3.
• Send — отправка файлов в L3.

L3 обращается к папкам по пути IP-адрес\имя папки. Каждый L 2 имеет свои собственные папки.

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

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

Префикс	Что означает	Направление
IN_MARK_	Производственное задание	L3 → L 2
IN_PRINT_	Задание на печать	L3 → L 2
REPORT_IN_MARK_	Репорт о приеме производственного задания	L 2 → L3
REPORT_IN_PRINT_	Репорт о приеме задания на печать	L 2 → L3
OUT_AGGREGATION_LVL0_	Отчет о сериализации	L 2 → L3
OUT_AGGREGATION_LVL1_	Отчет об агрегации в короб	L 2 → L3
OUT_AGGREGATION_LVL2_	Отчет об агрегации в паллету	L 2 → L3
REPORT_OUT_AGGREGATION_LVL0_	Репорт о приеме отчета	L3 → L 2

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.

Элемент <document_id>:

• Тип данных: UUID.
• Описание: уникальный идентификатор документа.
• Пример значения: 1aa008cf-581a-11f0-8448-3cecef8bbb44

Элемент <gitin>:

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

Элемент <data>:

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

Элемент <DateProd>:

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

Элемент <DateExp>:

• Тип данных: дата.
• Описание: срок годности продукции.
• Пример значения: 04.07.28

Элемент <batch>:

• Тип данных: строка.
• Описание: номер партии.
• Пример значения: 04.07.25

Элемент <product>:

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

Элемент <line>:

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

Элемент <NumLayer>:

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

Элемент <Layer>:

• Тип данных: целое число.
• Описание: номер слоя. Опциональный.
• Пример значения: 2

Элемент <NumKit>:

• Тип данных: целое число.
• Описание: количество наборов. Опциональный.
• Пример значения: 0

Элемент <Kit>:

• Тип данных: целое число.
• Описание: номер набора. Опциональный.
• Пример значения: 0

Элемент <labels>:

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

Элемент <box_labels>:

• Тип данных: массив строковых значений внутри CDATA-разметки.
• Описание: массив кодов коробов (SSCC).
• Может быть пустым.

Элемент <pallet_labels>:

• Тип данных: массив строковых значений внутри CDATA-разметки.
• Описание: массив кодов паллет (SSCC).
• Может быть пустым.

Элемент <KIGU_labels>:

• Тип данных: массив строковых значений внутри CDATA-разметки.
• Описание: массив КИГУ-кодов. Опциональный.
• Может быть пустым.

Пример файла

<?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>1aa008cf-581a-11f0-8448-3cecef8bbb44</document_id>
    <gitin>04603320390322</gitin>
    <data>04.07.25</data>
    <DateProd>04.07.25</DateProd>
    <DateExp>04.07.28</DateExp>
    <batch>04.07.25</batch>
    <product>Продукт описание</product>
    <line>2</line>
    <NumLayer>1</NumLayer>
    <Layer>2</Layer>
    <NumKit>0</NumKit>
    <Kit>0</Kit>
    <labels>
        <label><![CDATA[010460084060518021YlhDPGhrF'vOm93JCdS]]></label>
        <label><![CDATA[010460084060518021yjdZjuXIwFOG:935rWa]]></label>
        <label><![CDATA[010460084060518021gAPvq=CX*ogrC93WmNW]]></label>
    </labels>
    <box_labels>
        <label><![CDATA[00177076553960200772]]></label>
        <label><![CDATA[00177076553960200789]]></label>
        <label><![CDATA[00177076553960200796]]></label>
    </box_labels>
    <pallet_labels>
        <label><![CDATA[00246070779100091991]]></label>
        <label><![CDATA[00246070779100091908]]></label>
    </pallet_labels>
    <KIGU_labels/>
</root>

3. Файл задания на печать

Задание на печать отвязано от производственных заданий. В нем содержатся коды, которые можно распечатать заранее и использовать в производстве.

Формат имени файла: IN_PRINT_<ID>.xml

Идентификатор: print_id (PJ...).

Структура: аналогична IN_MARK_, но без line, batch, DateProd, DateExp и параметров агрегации.

Пример файла

<?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">
    <print_id>PJ0000000005</print_id>
    <gitin>04600840605098</gitin>
    <data>20.07.21</data>
    <product>Молоко, 2,5% ультрапастеризованное</product>
    <labels>
        <label><![CDATA[0104600840605098215_v&gf930ddd]]></label>
        ...
    </labels>
    <box_labels>
        <label><![CDATA[00146070779100091990]]></label>
        ...
    </box_labels>
    <pallet_labels>
        <label><![CDATA[00246070779100091990]]></label>
        ...
    </pallet_labels>
</root>

4. Файл ответа о приеме задания

Формируется в папке Send после парсинга нового производственного задания.

Формат имени файла: REPORT_IN_MARK_<UUID>.xml.

Элементы:

• <document_id> — идентификатор задания.
• <data> — дата формирования.
• <report> — статус: Ok или Err.
• <report_comment> — описание ошибки (если есть).

Пример:

Пример файла

<?xml version="1.0" encoding="utf-8"?>
<root xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <document_id>50b82083-c20e-11eb-bba3-a71066b870fd</document_id>
    <data>12.07.2021</data>
    <report>Ok</report>
    <report_comment></report_comment>
</root>

Аналогично формируется REPORT_IN_PRINT_ — но с print_id вместо document_id.

5. Файл отчета

Формат имени файла: OUT_AGGREGATION_LVL0/1/2_<UUID>.xml.

Идентификатор LVLX в имени файла показывает уровень группировки:

• LVL0 — сериализация.
• LVL1 — короб.
• LVL2 — паллета.

Элементы:

• <document_id> — идентификатор задания.
• <gitin> — GTIN продукции.
• <data> — дата формирования.
• <batch> — номер партии.
• <pack_context> — контейнер для группы кодов. Может повторяться.
• <pack_code> — код упаковки:
• - — для LVL0.
• 001... — для LVL1 (короб).
• 002... — для LVL2 (паллета).
• <cis> — вложенные коды:
• Для LVL0 — потребительские коды.
• Для LVL1 — потребительские коды.
• Для LVL2 — коды коробов.

Примеры:

LVL0

<?xml version="1.0" encoding="utf-8"?>
<Document>
  <document_id>50b82083-c20e-11eb-bba3-a71066b870fd</document_id>
  <gitin>04600840605098</gitin>
  <data>12.07.2021</data>
  <batch>17</batch>
  <pack_context>
   <pack_code>-</pack_code>
   <cis><![CDATA[0104600840605098215_":fR93NVwE]]></cis>
   ...
  </pack_context>
</Document>

LVL1

<?xml version="1.0" encoding="utf-8"?>
<Document>
  <document_id>88c15406-e46b-11eb-acda-f0b4d22cba82</document_id>
  <gitin>04600840605098</gitin>
  <data>14.04.2022</data>
  <batch>16</batch>
  <pack_context>
   <pack_code>00100000000000000000</pack_code>
   <cis><![CDATA[01123456789012342100001993ABCD]]></cis>
   ...
  </pack_context>
</Document>

LVL2

<?xml version="1.0" encoding="utf-8"?>
<Document>
  <document_id>88c15406-e46b-11eb-acda-f0b4d22cba82</document_id>
  <gitin>04600840605098</gitin>
  <data>14.04.2022</data>
  <batch>16</batch>
  <pack_context>
   <pack_code>00200000000000000000</pack_code>
   <cis>00100000000000000000</cis>
   <cis>00100000000000000001</cis>
   ...
  </pack_context>
</Document>

6. Файл ответа о приеме отчета

Формат имени файла: REPORT_OUT_AGGREGATION_LVL0_<UUID>.xml.

Формируется в папке Receive при обработке отчета о нанесении.

Элементы:

• <document_id> — идентификатор отчета.
• <data> — дата формирования.
• <report> — статус: ОК или Err.
• <report_comment> — описание ошибки.

Пример файла ```xml

66c15406-e46b-11eb-acda-f0b4d22cba82 05.06.2021 ОК