Повідомлення про товари (itemDataNotification GS1 XML)

Тип повідомлення в сервісі: PRODAT

Матеріали:

Приклади:

Призначення

Документ Повідомлення про товари надає можливість передати дані про товари (специфікацію товарів), яку згодом покупець може використати у замовленнях.

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

Повідомлення про товари складається з заголовка SBDH та безпосередньо документа повідомлення про товари.

Базова структура повідомлення про товари
<?xml version="1.0" encoding="UTF-8"?>
<item_data_notification:itemDataNotificationMessage
    xmlns:item_data_notification="urn:gs1:ecom:item_data_notification:xsd:3"
    xmlns:sh="http://www.unece.org/cefact/namespaces/StandardBusinessDocumentHeader">

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

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

</item_data_notification:itemDataNotificationMessage>

Повний перелік обов’язкових до заповнення елементів можна передивитися в xsd схемі, вер. 3.6.0

Також можна скористатися зручним інтерактивним навігатором за схемою замовлення на сайті GS1.

Обов’язкові та рекомендовані елементи

В цьому розділі подаються обов’язкові елементи та приклади їхнього використання. Для отримання вичерпної та точної технічно інформації щодо структури варто скористатися відповідною XSD схемою, оскільки більшість елементів мають доволі глибоку ієрархію вкладень.

Режими відображення

  • 1..1 - обов’язкове використання елемента 1 раз

  • 1..* - елемент повинен використовуватися 1 або більше разів

  • 0..1 - елемент може бути відсутнім або використовуватися 1 раз

  • 0..* - елемент може бути відсутнім або використовуватися безліч разів

Послідовність використання наведених елементів має значення. Наприклад, якщо в схемі xsd вказано element1 і після нього element2, то повідомлення зі зміненою послідовністю на element2 і після нього element1 не пройде валідацію і сервіс поверне помилку.
Таб. 1. Елементи для заповнення в order
Елемент Режим Формат Опис

creationDateTime

1..1

xs:dateTime

Дата та час, коли документ замовлення було створено в системі відправника. Бажано слідувати формату: ISO 8601

documentStatusCode

1..1

Позначає документ як копію або оригінал. Для більшості випадків: ORIGINAL

Перелік значень:
ORIGINAL - оригінальне повідомлення.
COPY - копія оригінального документа надісланого відправником
ADDITIONAL_TRANSMISSION - повідомлення вже було надіслане іншим методом.

documentActionCode

0..1

Код необхідної дії над документом для отримувача.

ADD - створення нового документа
CHANGE_BY_REFRESH - заміна попереднього надісланого документа новим
DELETE - видалення попередньо надісланого документа

avpList

0..1

AttributeValuePairListType

Не стандартизована інформація, яку потрібно додатково передати у повідомлення.

itemDataNotificationIdentification

1..1

EntityIdentification

Унікальна ідентифікація для документа

dataSource

1..1

TransactionalParty

Відправник інформації про товар. Можна залишити пустим, якщо відправник в документі збігається з відправником повідомлення.

dataRecipient

1..1

TransactionalParty

Отримувач інформації про товар. Можна залишити пустим, якщо отримувач в документі збігається з отримувачем повідомлення.

itemDataNotificationLineItem

1..*

ItemDataNotificationLineItem

Перелік товарних позицій, що замовляються

Типи елементів

ItemDataNotificationLineItem

GS1 XML тип: item_data_notification:ItemDataNotificationLineItemType

Дозволяє подати інформацію про товар та його характеристики для покупця. Також додатково можна подавати цінову інформацію.

Таб. 2. Основні елементи ItemDataNotificationLineItem
Елемент Режим Формат Опис

lineItemNumber

1..1

xs:positiveInteger

Порядковий номер запису

tradeItemDescription

0..1

Description1000

Назва/опис товару.

brandName

0..1

xsd:string (80)

Назва бренду

parentLineItemNumber

0..1

xs:positiveInteger

Порядковий номер рядка, який містить батьківський елемент для поточного запису. Таким чином можна створювати підпорядкованість між товарами.

tradeItemIdentification

1..1

TradeItem

Відомості для ідентифікації товара