Документ відвантаження (despatchAdvice GS1 XML)

Тип повідомлення EDI: DESADV

Тип повідомлення GS1 XML: despatchAdvice

Матеріали:

Приклади:

Призначення

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

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

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

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

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

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

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

    <despatchAdvice>
        <!-- Елементи замовлення  -->
    </despatchAdvice>
</despatch_advice:despatchAdviceMessage>

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

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

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

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

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

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

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

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

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

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

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

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

despatchAdviceIdentification

1..1

EntityIdentification

Ідентифікація документа Повідомлення про відвантаження