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»)

підтип документа (дія)

  • 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)

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

<Штрихкод ІД=«1»>6908876610177</Штрихкод>

O

Рядок (13)

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

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

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», «грн», «ящ», «Пар», «год.», «пог.м», «компл», «Тонна», «Блок», «Набір», «паков», «банк», «од»