Формат обміну GS1 XML

Основні відомості

GS1 XML (https://www.gs1.org/standards/edi/gs1-xml) є міжнародним стандартом для електронного обміну даними (EDI), який використовується багатьма провідними компаніями світу.

Цей формат дозволяє організаціям обмінюватися бізнес-інформацією в структурованому та стандартизованому вигляді, використовуючи загальноприйняті глобальні ідентифікатори.

GS1 XML використовує XML (Extensible Markup Language) для кодування документів, що забезпечують надійність, ефективність та прозорість при виконанні таких операцій, як управління запасами, замовлення, доставка товарів тощо.

В даний момент Edibox підтримує наступні види документів GS1 XML:

  1. Замовлення

  2. Відповідь на замовлення

  3. Повідомлення про товари

Структура повідомлень

Повідомлення створюються у форматі XML та мають ієрархічну структуру з декількома обов’язковими компонентами.

Кожен з різних типів повідомлень має унікальний кореневий тег, який дозволяє розрізняти ці повідомлення, наприклад, orderMessage, orderResponseMessage.

Кожне повідомлення має 2 обов’язкових елементи першого рівня:

  1. Бізнес заголовок: Small Business Document Header (SBDH): документація

  2. Безпосередньо саме повідомлення.

Графічна схема повідомлення
Рис. 1. Графічна схема повідомлення
Спрощена XML структура замовлення
<?xml version="1.0" encoding="UTF-8"?>
<order:orderMessage
    xmlns:order="urn:gs1:ecom:order:xsd:3"
    xmlns:sh="http://www.unece.org/cefact/namespaces/StandardBusinessDocumentHeader">

    <sh:StandardBusinessDocumentHeader>
        <!-- Елементи заголовка  -->
    </sh:StandardBusinessDocumentHeader>

    <order>
        <!-- Елементи замовлення  -->
    </order>
</order:orderMessage>

Стандартний бізнес заголовок

Кожне повідомлення повинне містити стандартний заголовок (SBDH: Small Business Document Header), який описує усю необхідну інформацію для цього повідомлення.

Приклад мінімально достатнього заголовка
<sh:StandardBusinessDocumentHeader>
    <!--  Завжди 1.0  -->
    <sh:HeaderVersion>1.0</sh:HeaderVersion>

    <sh:Sender>
        <!--  Authority завжди GS1  -->
        <sh:Identifier Authority="GS1">123456789</sh:Identifier>
    </sh:Sender>
    <sh:Receiver>
        <!--  Authority завжди GS1  -->
        <sh:Identifier Authority="GS1">987654321</sh:Identifier>
    </sh:Receiver>

    <sh:DocumentIdentification>
        <!--  Завжди GS1  -->
        <sh:Standard>GS1</sh:Standard>
        <sh:TypeVersion>3.6.0</sh:TypeVersion>
        <!-- Ідентифікатор повідомлення -->
        <sh:InstanceIdentifier>MSG-100002</sh:InstanceIdentifier>
        <sh:Type/>
        <sh:CreationDateAndTime>2006-01-10T12:00:01.000-05:00</sh:CreationDateAndTime>
    </sh:DocumentIdentification>
</sh:StandardBusinessDocumentHeader>

Sender (відправник) та Receiver (отримувач) повинні бути зареєстрованими в сервісі Edibox, інакше повідомлення не буде створено.

Елемент Identifier завжди повинен містити GS1 як значення атрибута Authority, а безпосереднє значення елемента Identifier - це GLN код відповідного партнера.

Ідентифікація відправника та отримувача виконується саме за GLN кодом.

Більше інформації про стандартний заголовок можна отримати на відповідній сторінці присвяченій SBDH.