XML Специфікації

Зміст:

• XML Специфікації

  • Товарне узгодження (AGREEM)

  • Товарна специфікація (COMDOC_008)

  • Електронна специфікація (PRODUCTLIST)

  • Універсальний/неструктурований документ (CONDRA)

---

Товарне узгодження (AGREEM)

Примітка

При передаванні дублів позицій (позиції з однаковими значеннями штрихкоду <PRODUCT> + артикулу <PRODUCTIDBUYER>) документ не відправляється, а потрапляє в помилки.

Товарне узгодження (AGREEM) щодо зміни цін формується постачальником на підставі специфікації і відправляється в торговельну мережу

Назва поля	Тип 1	Формат	Опис
AGREEM	М		Початок документа
NUMBER	М	Рядок (16)	Номер документа
DATE	М	Дата (РРРР-ММ-ДД)	Дата документа
CONTRACTNUMBER	М	Рядок (20)	Номер контракту
CONTRACTEXPIRYDATE	М	Дата (РРРР-ММ-ДД)	Дата закінчення дії контракту
CAMPAIGNNUMBER	М	Рядок (20)	Номер договору
CAMPAIGNDATE	М	Дата (РРРР-ММ-ДД)	Дата договору
CAMPAIGN_GLN	M	Число (13)	GLN контракту
DOCSTARTDATE	М	Дата (РРРР-ММ-ДД)	Дата початку дії нової ціни
DOCENDDATE	М	Дата (РРРР-ММ-ДД)	Дата закінчення дії нової ціни
PRICETYPE	М	Рядок («regular» / «promo» / «promo_compensation» / «promo_combo»)	підтип документа (дія) regular - змінити регулярну ціну promo - змінити промо ціну-Зниження ціни promo_compensation - змінити промо ціну-Компенсація promo_combo - змінити промо ціну-Комбо (Зниження ціни + Компенсація)
DOCACTION	М	Число (1)	ознака документа (0 - за замовчуванням; 1 - документ AGREEM з відхиленими позиціями)
CONTRACTNUMBER_MARKETING	O	Число	Номер маркетингового договору
CONTRACTDATE_MARKETING	O	Дата (РРРР-ММ-ДД)	Дата маркетингового договору
ACTION_NAME	O	Рядок (255)	Назва акції
ACTION_ACTIVATION_PAYMENT	O	Число	Оплата за активацію акції 1 - Безкоштовно 2 - З маркетингового бюджету 3 - Окремий рахунок 4 - Компенсаційний бюджет
COMPENSATION_PAYMENT	O	Число	Оплата за компенсацію 1 - З маркетингового бюджету 2 - Окремий рахунок
REASON_REJECTION	O/M	Рядок (500)	Причина відхилення. Обов’язково передається при відхиленні документа чи його позицій (DOCACTION = 1)
HEAD			Початок основного блоку
SUPPLIER	M	Число (13)	GLN продавця
BUYER	M	Число (13)	GLN покупця
RECIPIENT	M	Число (13)	GLN одержувача
SENDER	M	Число (13)	GLN відправника
ATTACHMENT	O	Рядок	Вкладення (назва файлу)
RESPONSIBLE_OFFICER	O	Рядок (255)	Відповідальний співробітник (ПІП; контакти)
POSITION			Товарні позиції (початок блоку)
POSITIONNUMBER	М	Число позитивне (3)	Номер позиції в документі
PRODUCT	M	Число (13)	Штрихкод продукту
PRODUCTIDBUYER	М	Рядок (10)	Артикул покупця
UCCFEA	O/M	Число (4-10)	Код УКТ ЗЕД. За запитом мережі поле може бути обов’язковим (в випадку наявності цього поля в PRODUCTLIST)
POSITIONIDBUYER	O	Рядок (10)	id товарної позиції
DESCRIPTION	M	Рядок (50)	Найменування
PRICEWITHOUTVAT	М	Decimal (#.00)	Ціна без ПДВ
PRICEWITHVAT	M	Decimal (#.00)	Ціна з ПДВ
PRICEWITHOUTVAT_CHNG	О	Decimal (#.00)	Нова ціна без ПДВ
PRICEWITHVAT_CHNG	M	Decimal (#.00)	Нова ціна з ПДВ
DIFFPRICE	M	Decimal (#.00)	% зміни ціни
DISCOUNTPRICEWITHOUTVAT	O	Decimal (#.00)	Ціна зі знижкою без ПДВ
DISCOUNTPRICEWITHVAT	O	Decimal (#.00)	Ціна зі знижкою з ПДВ
DISCOUNTVAL	O	Decimal (#.00)	% знижки
DISCOUNTPRICEWITHOUTVAT_CHNG	O	Decimal (#.00)	Нова ціна зі знижкою без ПДВ
DISCOUNTPRICEWITHVAT_CHNG	O	Decimal (#.00)	Нова ціна зі знижкою з ПДВ
DIFFDISCOUNTPRICE	O	Decimal (#.00)	% зміни ціни зі знижкою
DISCOUNTVAL_CHNG	O	Decimal (#.00)	% нової знижки
PROMO	O	Decimal (#.00)	промоціна без ПДВ
PROMOWITHVAT	O	Decimal (#.00)	промоціна з ПДВ
PROMODISCOUNT	O	Число	% промознижки
PROMOQUANTITY	O	Число (10,3)	Кількість промо
COMPENSATION_PERCENTAGE	O	Число (6,2)	% компенсації
ACTION_ACTIVATION_AMOUNT	O	Число (6,4)	Сума за активацію акції
PROMOPRICEWITHVAT_RECOMMEND	O	Число (6,4)	Рекомендована роздрібна ціна з ПДВ
VAT	O	Число («20» / «7» / «0»)	Ставка ПДВ,%
UNIT	O	Рядок (3)	Одиниці виміру
STATE	O	Число («-1» / «0» / «1»)	Стан позиції -1 - статус відсутній 0 - позиція відхилена 1 - позиція прийнята
POSITIONACTION	O (М - при DOCACTION = 1)	Рядок («decline»)	Статус позиції при відхиленні AGREEM
POSITION			Товарні позиції (закінчення блоку)
HEAD			Закінчення основного блоку
AGREEM			Закінчення документа

Приклад AGREEM

---

Товарна специфікація (COMDOC_008)

Товарна специфікація (COMDOC_008)

Назва поля	Тип 1	Формат	Опис
ЕлектроннийДокумент	M		Початок документу
Заголовок	M	Кількість входжень вузла: Min = 1; Max = 1	Заголовок (початок блоку)
НомерДокументу	M	Рядок (16)	Номер документу
ТипДокументу	M	Рядок (50)	Тип документу: Товарна специфікація
КодТипуДокументу	M	«008»	Допустиме значення: 008 => Товарна специфікація
ДатаДокументу	M	Дата (РРРР-ММ-ДД)	Дата складання документу
ТермінДії	M	Кількість входжень вузла: Min = 0; Max = 1	Термін, на період якого документ вважається чинним (початок блоку)
Початок	M	Дата (РРРР-ММ-ДД)	Дата початку дії документу
Кінець	M	Дата (РРРР-ММ-ДД)	Дата закінчення терміну дії документу
ТермінДії			Термін, на період якого документ вважається чинним (завершення блоку)
ТермінПідпису	M	Кількість входжень вузла: Min = 0; Max = 1	Термін підписання (початок блоку)
Початок	M	Дата (РРРР-ММ-ДД)	Дата початку періода підписання
Кінець	M	Дата (РРРР-ММ-ДД)	Дата закінчення періода підписання
ТермінПідпису			Термін підписання (завершення блоку)
МісцеСкладання	O	Рядок (255)	Місце укладання документу
ДокПідстава	M	Кількість входжень вузла: Min = 0; Max = 10	Документ-підстава (початок блоку)
НомерДокументу	M	Рядок (30)	Номер документу-підстави
ТипДокументу	M	Рядок (50)	Тип документу: Договір
КодТипуДокументу	M	«001»	Допустиме значення: 001 => Договір
ДатаДокументу	M	Дата (РРРР-ММ-ДД)	Дата складання документу
ДокПідстава			Документ-підстава (завершення блоку)
НомерТовУзгодження	M	Рядок (15)	Номер товарного узгодження
ДатаТовУзгодження	M	Дата (РРРР-ММ-ДД)	Дата товарного узгодження
НомерКонтракту	M	Рядок (20)	Номер контракту
ДатаКонтракту	M	Дата (РРРР-ММ-ДД)	Дата контракту
НомерМаркетингДоговору	O	Рядок (16)	Номер маркетингового договору
ДатаМаркетингДоговору	O	Дата (РРРР-ММ-ДД)	Дата маркетингового договору
НазваАкції	O	Рядок (255)	Назва акції
ОплатаЗаАктиваціюАкції	O	Число («1» / «2» / «3»)	Оплата за активаціїю акції: 1 - «Безкоштовно», 2 - «З маркетингового бюджету», 3 - «Окремий рахунок» 4 - «Компенсаційний бюджет»
ОплатаЗаКомпенсацію	O	Число («1» / «2»)	Оплата за компенсацию: 1 - «З маркетингового бюджету», 2 - «Окремий рахунок»
Заголовок	M		Заголовок (завершення блоку)
Сторони	M	Мількість входжень вузла: Min = 1; Max = 1	Сторони, між якими укладено документ (початок блоку)
Контрагент	M	Кількість входжень вузла: Min = 2; Max = 10	Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача
СтатусКонтрагента	M	Рядок (30)	Допустиме значення: Продавець
ВидОсоби	M	Рядок (20)	Допустимі значення: Юридична Фізична
НазваКонтрагента	M	Рядок (50)	Назва контрагента
КодКонтрагента	M	Рядок (8)	Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)
ІПН	M	Рядок (12)	Індивідуальний податковий номер контрагента
СвідоцтвоПДВ	O	Рядок (30)	Номер свідоцтва ПДВ
МФО	O	Рядок (30)	Номер МФО
Поточний рахунок	O	Рядок (30)	Номер поточного рахунку
IBAN	O	Рядок (34)	IBAN (міжнародний номер банківського рахунку; використовується при міжнародних розрахунках)
Телефон	O	Рядок (20)	Телефон
GLN	M	Число (13)	Глобальний номер розташування (GLN) контрагента
КонтактнаОсоба	O	Рядок (255)	Відповідальна особа (ПІБ, контакти постачальника)
Контрагент			Контрагент (завершення блоку)
Контрагент	M	Кількість входжень вузла: Min = 2; Max = 10	Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача
СтатусКонтрагента	M	Рядок (30)	Допустиме значення: Покупець
ВидОсоби	M	Рядок (20)	Допустимі значення: Юридична Фізична
НазваКонтрагента	M	Рядок (50)	Назва контрагента
КодКонтрагента	M	Рядок (8)	Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)
ІПН	M	Рядок (12)	Індивідуальний податковий номер контрагента
СвідоцтвоПДВ	O	Рядок (30)	Номер свідоцтва ПДВ
МФО	O	Рядок (30)	Номер МФО
Поточний рахунок	O	Рядок (30)	Номер поточного рахунку
IBAN	O	Рядок (34)	IBAN (міжнародний номер банківського рахунку; використовується при міжнародних розрахунках)
Телефон	O	Рядок (20)	Телефон
GLN	M	Число (13)	Глобальний номер розташування (GLN) контрагента
Контрагент			Контрагент (завершення блоку)
Сторони			Сторони, між якими укладено документ (завершення блоку)
Параметри	O		Параметри (початок блоку). Тег передбачає довільне значення; використовується для передачі додаткової інформації, що не входить до специфікації
Параметр (<Параметр ІД=«1» назва=«GLN контракту»>9864119011415</Параметр>)	O	Рядок (50)	Максимальна кількість тегів – 99. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю.
Параметри			Параметри (завершення блоку)
Таблиця	O	Кількість входжень вузла: Min = 0; Max = 1	Таблиця (початок блоку)
Рядок	M	Кількість входжень вузла: Min = 1;Max = 9999	Рядок (початок блоку). У кожного наступного блоку ідентифікатор (ІД) збільшується на одиницю
НомПоз	M	Число (3)	Номер позиції
Штрихкод	O	Рядок (13)	Максимальна кількість тегів – 99. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю.
АртикулПокупця	O	Рядок (10)	Артикул покупця
АртикулПродавця	O	Рядок (10)	Артикул продавця
КодУКТЗЕД	O	Число (4-10)	Код УКТ ЗЕД
Найменування	M	Рядок (50)	Найменування товарної позиції
ОдиницяВиміру	O	Рядок (10)	Одиниці виміру 2
ПДВ	O	Decimal (#.00)	Ставка податку на додану вартість
СтараЦіна			Стара ціна (початок блоку)
ЦінаБезПДВ	M	Decimal (#.00)	Ціна без ПДВ
ЦінаЗПДВ	M	Decimal (#.00)	Ціна з ПДВ
ЦінаЗіЗнижкоюБезПДВ	O	Decimal (#.00)	Ціна зі знижкою без ПДВ
ЦінаЗіЗнижкоюЗПДВ	O	Decimal (#.00)	Ціна зі знижкою з ПДВ
СтараЦіна			Стара ціна (завершення блоку)
ЦінаРегулярна			Регулярна ціна (початок блоку)
ЦінаБезПДВ	O	Decimal (#.00)	Ціна без ПДВ
ЦінаЗПДВ	O	Decimal (#.00)	Ціна з ПДВ
ЦінаЗіЗнижкоюБезПДВ	O	Decimal (#.00)	Ціна зі знижкою без ПДВ
ЦінаЗіЗнижкоюЗПДВ	O	Decimal (#.00)	Ціна зі знижкою з ПДВ
ЦінаРегулярна			Регулярна ціна (завершення блоку)
ПромоЦіна			Промо ціна (початок блоку)
ЦінаБезПДВ	O	Decimal (#.00)	Промо ціна без ПДВ
ЦінаЗПДВ	O	Decimal (#.00)	Промо ціна з ПДВ
ПромоЦіна			Промо ціна (завершення блоку)
КількістьПромо	O	Число ціле позитивне	Кількість SKU за промо ціною
ПроцентКомпенсації	O	Число (6,2)	Процент компенсації
СумаЗаАктиваціюАкції	O	Число (6,4)	Сума за активацію акції
РекомендованаРоздрібнаЦінаЗПДВ	O	Число (6,4)	Рекомендована роздрібна ціна з ПДВ
Рядок			Рядок (завершення блоку)
Таблиця			Таблиця (завершення блоку)
ЕлектроннийДокумент	O		Завершення документу

Приклад COMDOC_008

---

Електронна специфікація (PRODUCTLIST)

PRODUCTLIST - узгоджене між контрагентами в паперовому вигляді доповнення до договору поставки (Специфікація). Документ призначений для підтримки покупцем на платформі EDIN актуального асортименту, для зміни і узгодження цін. Документ необхідний для оптимізації / автоматизації процесу узгодження цін між ТМ і постачальником

Назва поля	Тип 1	Формат	Опис
PRODUCTLIST	M		Початок документа
NUMBER	M	Рядок (16)	Номер документа
DATE	M	Дата (РРРР-ММ-ДД)	Дата документа
CONTRACTNUMBER	M	Рядок (50)	Номер контракту
CONTRACTDESCRIPTION	O	Рядок (70)	Опис контракту
CONTRACTEXPIRYDATE	M	Дата (РРРР-ММ-ДД)	Дата закінчення дії контракту/специфікації
CONTRACTGLN	M	Число (13)	GLN контракту
CAMPAIGNNUMBER	M	Рядок (20)	Номер договору
CAMPAIGNDATE	M	Дата (РРРР-ММ-ДД)	Дата договору
REVIEWDEADLINE	О	Число (3)	Термін подачі на розгляд
PROMO_REVIEWDEADLINE	О	Число (3)	Термін подачі на розгляд (промо)
AGREEMENTNUMBER	О	Число (3)	Допустима кількість погоджень
DISCOUNTWORKSTATUS	M	0,1	Робота з ціною зі знижкою: 0 - ні, 1 - так
PROLONGATIONCONTRACT	O	Число	Автоматична пролонгація контракту: 0 - ні, 1 - так
REGIONID	O	Рядок (100)	код регіону
CONTRACTNUMBER_MARKETING	О	Рядок (16)	Номер маркетингового договору
CONTRACTDATE_MARKETING	О	Дата (РРРР-ММ-ДД)	Дата маркетингового договору
ACTION_NAME	О	Рядок (255)	Назва акції
ACTION_ACTIVATION_PAYMENT	О	Число (1)	Оплата за активацію акції. Допустимі значення: 1 - Безкоштовно 2 - З маркетингового бюджету 3 - Окремий рахунок 4 - Компенсаційний бюджет
COMPENSATION_PAYMENT	О	Число (1)	Оплата за компенсацію 1 - З маркетингового бюджету 2 - Окремий рахунок
HEAD	M		Початок основного блоку
BUYER	M	Число (13)	GLN покупця
SUPPLIER	M	Число (13)	GLN продавця
RECIPIENT	M	Число (13)	GLN одержувача
SENDER	M	Число (13)	GLN відправника
RESPONSIBLE_OFFICER	О	Рядок (255)	Відповідальний співробітник (ПІБ, контакти постачальника)
POSITION	М		Товарні позиції (початок блоку)
POSITIONNUMBER	М	Число ціле позитивне	Номер товарної позиції
ACTION	O	Число (4, 2, 27)	Можливі значення: 4 - видалення товарної позиції, 2 або 27 - введення або оновлення товарної позиції
PRODUCT	M	Число (13)	Штрихкод продукту
PRODUCTIDBUYER	M	Рядок (15)	Внутрішній номер в БД
DESCRIPTION	M	Рядок (255)	Опис продукту
UCCFEA	O	Число (4-10)	Код УКТ ЗЕД
DISCOUNTPRICE	O	Число десяткове (10,4)	Ціна зі знижкою без ПДВ
DISCOUNTPRICEWITHVAT	О	Число десяткове (10,4)	Ціна зі знижкою з ПДВ
DISCOUNTDATEFROM	O	Дата (РРРР-ММ-ДД)	Початок дії ціни зі знижкою
DISCOUNTDATETO	O	Дата (РРРР-ММ-ДД)	Закінчення дії ціни зі знижкою
PRICE	M	Число десяткове (10,4)	Ціна без ПДВ
PRICEWITHVAT	O	Число десяткове (10,4)	Ціна з ПДВ
PRICEDATEFROM	O	Дата (РРРР-ММ-ДД)	Початок дії ціни
PRICEDATETO	O	Дата (РРРР-ММ-ДД)	Закінчення дії ціни
PROMO	O	Число десяткове (10,4)	Промо ціна без ПДВ
PROMOWITHVAT	O	Число десяткове (10,4)	Промо ціна з ПДВ
PROMODATEFROM	O	Дата (РРРР-ММ-ДД)	Початок дії промо ціни
PROMODATETO	O	Дата (РРРР-ММ-ДД)	Закінчення дії промо ціни
PROMOQUANTITY	O	Число десяткове (10,3)	Кількість товару
VAT	M	Число («20» / «7» / «0»)	Ставка ПДВ,%
UNIT	M	Рядок (3)	Одиниці виміру
COMPENSATION_PERCENTAGE	О	Позитивне число з плаваючою точкою (6 знаків до коми, 2 знака після коми)	% компенсації
ACTION_ACTIVATION_AMOUNT	О	Позитивне число з плаваючою точкою (6 знаків до коми, 4 знака після коми)	Сума за активацію акції
PROMOPRICEWITHVAT_RECOMMEND	О	Позитивне число з плаваючою точкою (6 знаків до коми, 4 знака після коми)	Рекомендована роздрібна ціна з ПДВ
POSITION			Товарні позиції (закінчення блоку)
HEAD			Закінчення основного блоку
PRODUCTLIST			Закінчення документа

Приклад PRODUCTLIST

---

Універсальний/неструктурований документ (CONDRA)

CONDRA - універсальний/неструктурований документ, що формується на стороні Мережі при відправці Постачальником вкладених файлів (додавання обгрунтування до узгодження чи коментарів до нього)

НАЗВА ПОЛЯ	Тип 1	Формат	Опис
CONDRA			Початок документа
DATE	O	Дата (РРРР-ММ-ДД)	Дата відправки вкладення в AGREEM чи до коментаря цього документа
NUMBERDOCTO	O	Рядок (16)	Номер AGREEM
DATEDOCTO	O	Дата (РРРР-ММ-ДД)	Дата AGREEM
CONTRACTNUMBER	О	Рядок (16)	Номер специфікації (CONTRACTNUMBER в AGREEM)
COMPNUMBER	O	Рядок (1000)	Номер договору (CAMPAIGNNUMBER в AGREEM)
HEAD			Початок основного блоку
SENDER	M	Число (13)	GLN відправника AGREEM
RECIPIENT	M	Число (13)	GLN одержувача AGREEM
TYPE	M	Число	Тип. За замовчуванням = 5
CONTENT			Вкладення (початок блоку)
FILENAME	M	Рядок (70)	Назва файлу
CONTENT			Вкладення (закінчення блоку)
HEAD			Закінчення основного блоку
CONDRA			Закінчення документа

Приклад CONDRA

---

1

Під визначенням колонки Тип поля мається на увазі скорочене позначення:

• M (mandatory) — обов’язкові до заповнення поля;

• O (optional) — необов’язкові (опціональні) до заповнення поля.

2

Одиниці виміру: «г», «кг», «л», «м», «мм», «м2», «м3», «шт», «кор», «пач», «піддон», «пак», «штука дрібна», «uauzd_MIL», «пляш», «рул», «послуга», «uauzd_CMT», «грн», «ящ», «Пар», «год.», «пог.м», «компл», «Тонна», «Блок», «Набір», «паков», «банк», «од»