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


Товарне узгодження (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 - змінити промо ціну-Комбо (Зниження ціни + Компенсація)

DOCACTION

М

Число (1)

ознака документа (0 - за замовчуванням; 1 - документ AGREEM з відхиленими позиціями)

CONTRACTNUMBER_MARKETING

O

Число

Номер маркетингового договору

CONTRACTDATE_MARKETING

O

Дата (РРРР-ММ-ДД)

Дата маркетингового договору

ACTION_NAME

O

Рядок (255)

Назва акції

ACTION_ACTIVATION_PAYMENT

O

Число

Оплата за активацію акції

  • 1 - Безкоштовно

  • 2 - З маркетингового бюджету

  • 3 - Окремий рахунок

COMPENSATION_PAYMENT

O

Число

Оплата за компенсацію

  • 1 - З маркетингового бюджету

  • 2 - Окремий рахунок

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

М

Число (4-10)

Код УКТ ЗЕД

POSITIONIDBUYER

М

Рядок (10)

id товарної позиції

DESCRIPTION

M

Рядок (50)

Найменування

PRICEWITHOUTVAT

М

Ціна без ПДВ

PRICEWITHVAT

M

Ціна з ПДВ

PRICEWITHOUTVAT_CHNG

О

Нова ціна без ПДВ

PRICEWITHVAT_CHNG

M

Нова ціна з ПДВ

DIFFPRICE

M

% зміни ціни

DISCOUNTPRICEWITHOUTVAT

O

Ціна зі знижкою без ПДВ

DISCOUNTPRICEWITHVAT

O

Ціна зі знижкою з ПДВ

DISCOUNTVAL

O

% знижки

DISCOUNTPRICEWITHOUTVAT_CHNG

O

Нова ціна зі знижкою без ПДВ

DISCOUNTPRICEWITHVAT_CHNG

O

Нова ціна зі знижкою з ПДВ

DIFFDISCOUNTPRICE

O

% зміни ціни зі знижкою

DISCOUNTVAL_CHNG

O

% нової знижки

PROMO

O

промоціна без ПДВ

PROMOWITHVAT

O

промоціна з ПДВ

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)

Одиниці виміру

POSITION

Товарні позиції (закінчення блоку)

HEAD

Закінчення основного блоку

AGREEM

Закінчення документа

Приклад AGREEM


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

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

Назва поля

Тип 1

Формат

Опис

ЕлектроннийДокумент

М

Початок документу

Заголовок

М

Кількість входжень вузла: Min = 1; Max = 1

Заголовок (початок блоку)

НомерДокументу

М

Рядок (16)

Номер документу

ТипДокументу

М

Рядок (50)

Тип документу: Товарна специфікація

КодТипуДокументу

М

«008»

Допустиме значення: 008 => Товарна специфікація

ДатаДокументу

М

Дата (РРРР-ММ-ДД)

Дата складання документу

ТермінДії

М

Кількість входжень вузла: Min = 0; Max = 1

Термін, на період якого документ вважається чинним (початок блоку)

Початок

М

Дата (РРРР-ММ-ДД)

Дата початку дії документу

Кінець

М

Дата (РРРР-ММ-ДД)

Дата закінчення терміну дії документу

ТермінДії

Термін, на період якого документ вважається чинним (завершення блоку)

ТермінПідпису

М

Кількість входжень вузла: Min = 0; Max = 1

Термін підписання (початок блоку)

Початок

М

Дата (РРРР-ММ-ДД)

Дата початку періода підписання

Кінець

М

Дата (РРРР-ММ-ДД)

Дата закінчення періода підписання

ТермінПідпису

Термін підписання (завершення блоку)

МісцеСкладання

О

Рядок (255)

Місце укладання документу

ДокПідстава

М

Кількість входжень вузла: Min = 0; Max = 10

Документ-підстава (початок блоку)

НомерДокументу

М

Рядок (30)

Номер документу-підстави

ТипДокументу

М

Рядок (50)

Тип документу: Договір

КодТипуДокументу

М

«001»

Допустиме значення: 001 => Договір

ДатаДокументу

М

Дата (РРРР-ММ-ДД)

Дата складання документу

ДокПідстава

Документ-підстава (завершення блоку)

НомерТовУзгодження

М

Рядок (15)

Номер товарного узгодження

ДатаТовУзгодження

М

Дата (РРРР-ММ-ДД)

Дата товарного узгодження

НомерКонтракту

М

Рядок (20)

Номер контракту

ДатаКонтракту

М

Дата (РРРР-ММ-ДД)

Дата контракту

НомерМаркетингДоговору

O

Рядок (16)

Номер маркетингового договору

ДатаМаркетингДоговору

O

Дата (РРРР-ММ-ДД)

Дата маркетингового договору

НазваАкції

O

Рядок (255)

Назва акції

ОплатаЗаАктиваціюАкції

O

Число («1» / «2» / «3»)

Оплата за активаціїю акції:

  • 1 - «Безкоштовно»,

  • 2 - «З маркетингового бюджету»,

  • 3 - «Окремий рахунок»

ОплатаЗаКомпенсацію

O

Число («1» / «2»)

Оплата за компенсацию:

  • 1 - «З маркетингового бюджету»,

  • 2 - «Окремий рахунок»

Заголовок

M

Заголовок (завершення блоку)

Сторони

M

Мількість входжень вузла: Min = 1; Max = 1

Сторони, між якими укладено документ (початок блоку)

Контрагент

М

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача

СтатусКонтрагента

М

Рядок (30)

Допустиме значення: Продавець

ВидОсоби

М

Рядок (20)

Допустимі значення:

  • Юридична

  • Фізична

НазваКонтрагента

М

Рядок (50)

Назва контрагента

КодКонтрагента

М

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

М

Рядок (12)

Індивідуальний податковий номер контрагента

СвідоцтвоПДВ

O

Рядок (30)

Номер свідоцтва ПДВ

МФО

O

Рядок (30)

Номер МФО

Поточний рахунок

O

Рядок (30)

Номер поточного рахунку

IBAN

О

Рядок (34)

IBAN (міжнародний номер банківського рахунку; використовується при міжнародних розрахунках)

Телефон

О

Рядок (20)

Телефон

GLN

M

Число (13)

Глобальний номер розташування (GLN) контрагента

ВідповідальнаОсоба

О

Рядок (255)

Відповідальна особа (ПІБ, контакти постачальника)

Контрагент

Контрагент (завершення блоку)

Контрагент

М

Кількість входжень вузла: Min = 2; Max = 10

Контрагент (початок блоку). Першим вказується блок відправника, другим – отримувача

СтатусКонтрагента

М

Рядок (30)

Допустиме значення: Покупець

ВидОсоби

М

Рядок (20)

Допустимі значення:

  • Юридична

  • Фізична

НазваКонтрагента

М

Рядок (50)

Назва контрагента

КодКонтрагента

М

Рядок (8)

Значенням елемента є код платника згідно з ЄДРПОУ (Реєстраційний (обліковий) номер з Тимчасового реєстру ДПА України) або реєстраційний номер облікової картки платника (номер паспорта, записаний як послідовність двох великих літер української абетки та шести цифр)

ІПН

М

Рядок (12)

Індивідуальний податковий номер контрагента

СвідоцтвоПДВ

O

Рядок (30)

Номер свідоцтва ПДВ

МФО

O

Рядок (30)

Номер МФО

Поточний рахунок

O

Рядок (30)

Номер поточного рахунку

IBAN

О

Рядок (34)

IBAN (міжнародний номер банківського рахунку; використовується при міжнародних розрахунках)

Телефон

О

Рядок (20)

Телефон

GLN

M

Число (13)

Глобальний номер розташування (GLN) контрагента

Контрагент

Контрагент (завершення блоку)

Сторони

Сторони, між якими укладено документ (завершення блоку)

Параметри

О

Параметри (початок блоку). Тег передбачає довільне значення; використовується для передачі додаткової інформації, що не входить до специфікації

Параметр (<Параметр ІД=«1» назва=«GLN контракту»>9864119011415</Параметр>)

O

Рядок (50)

Максимальна кількість тегів – 99. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю.

Параметри

Параметри (завершення блоку)

Таблиця

О

Кількіть входжень вузла: Min = 0; Max = 1

Таблиця (початок блоку)

Рядок

M

Кількість входжень вузла: Min = 1;Max = 9999

Рядок (початок блоку). У кожного наступного блоку ідентифікатор (ІД) збільшується на одиницю

НомПоз

М

Число (3)

Номер позиції

Штрихкод

О

Число (13)

Максимальна кількість тегів – 99. У кожного наступного тега ідентифікатор (ІД) збільшується на одиницю.

АртикулПокупця

О

Рядок (10)

Артикул покупця

АртикулПродавця

О

Рядок (10)

Артикул продавця

КодУКТЗЕД

О

Число (4-10)

Код УКТ ЗЕД

Найменування

М

Рядок (50)

Найменування товарної позиції

ОдиницяВиміру

О

Рядок (10)

Одиниці виміру 2

ПДВ

О

Ставка податку на додану вартість

СтараЦіна

Стара ціна (початок блоку)

ЦінаБезПДВ

M

Ціна без ПДВ

ЦінаЗПДВ

M

Ціна з ПДВ

ЦінаЗіЗнижкоюБезПДВ

О

Ціна зі знижкою без ПДВ

ЦінаЗіЗнижкоюЗПДВ

О

Ціна зі знижкою з ПДВ

СтараЦіна

Стара ціна (завершення блоку)

ЦінаРегулярна

Регулярна ціна (початок блоку)

ЦінаБезПДВ

О

Ціна без ПДВ

ЦінаЗПДВ

О

Ціна з ПДВ

ЦінаЗіЗнижкоюБезПДВ

О

Ціна зі знижкою без ПДВ

ЦінаЗіЗнижкоюЗПДВ

О

Ціна зі знижкою з ПДВ

ЦінаРегулярна

Регулярна ціна (завершення блоку)

ПромоЦіна

Промо ціна (початок блоку)

ЦінаБезПДВ

О

Промо ціна без ПДВ

ЦінаЗПДВ

О

Промо ціна з ПДВ

ПромоЦіна

Промо ціна (завершення блоку)

КількістьПромо

О

Кількість SKU за промо ціною

ПроцентКомпенсації

О

Число (6,2)

Процент компенсації

СумаЗаАктиваціюАкції

О

Число (6,4)

Сума за активацію акції

РекомендованаРоздрібнаЦінаЗПДВ

О

Число (6,4)

Рекомендована роздрібна ціна з ПДВ

Рядок

Рядок (завершення блоку)

Таблиця

Таблиця (завершення блоку)

ЕлектроннийДокумент

О

Завершення документу

Приклад 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)

Термін подачі на розгляд

AGREEMENTNUMBER

О

Число (3)

Допустима кількість погоджень

DISCOUNTWORKSTATUS

M

0,1

Робота з ціною зі знижкою: 0 - ні, 1 - так

PROLONGATIONCONTRACT

O

Число

Автоматична пролонгація контракту: 0 - ні, 1 - так

HEAD

M

Початок основного блоку

BUYER

M

Число (13)

GLN покупця

SUPPLIER

M

Число (13)

GLN продавця

RECIPIENT

M

Число (13)

GLN одержувача

SENDER

M

Число (13)

GLN відправника

POSITION

М

Товарні позиції (початок блоку)

POSITIONNUMBER

М

Число ціле позитивне

Номер товарної позиції

ACTION

O

Число (4, 2, 27)

Можливі значення:

  • 4 - видалення товарної позиції,

  • 2 або 27 - введення або оновлення товарної позиції

PRODUCT

M

Число (13)

Штрихкод продукту

PRODUCTIDBUYER

M

Рядок (15)

Внутрішній номер в БД

DESCRIPTION

M

Рядок (255)

Опис продукту

UCCFEA

M

Число (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)

Одиниці виміру

POSITION

Товарні позиції (закінчення блоку)

HEAD

Закінчення основного блоку

PRODUCTLIST

Закінчення документа

Приклад PRODUCTLIST


1

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

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

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

2

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