XML Специфікації
Зміст:
Товарне узгодження (AGREEM)
Примітка
При передаванні дублів позицій (позиції з однаковими значеннями штрихкоду <PRODUCT> + артикулу <PRODUCTIDBUYER>) документ не відправляється, а потрапляє в помилки.
Назва поля |
Тип 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 |
Число |
Оплата за активацію акції
|
COMPENSATION_PAYMENT |
O |
Число |
Оплата за компенсацію
|
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») |
Стан позиції
|
POSITIONACTION |
O (М - при DOCACTION = 1) |
Рядок («decline») |
Статус позиції при відхиленні AGREEM |
POSITION |
Товарні позиції (закінчення блоку) |
||
HEAD |
Закінчення основного блоку |
||
AGREEM |
Закінчення документа |
Товарна специфікація (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») |
Оплата за активаціїю акції:
|
ОплатаЗаКомпенсацію |
O |
Число («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 |
Завершення документу |
Електронна специфікація (PRODUCTLIST)
Назва поля |
Тип 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) |
Оплата за активацію акції. Допустимі значення:
|
COMPENSATION_PAYMENT |
О |
Число (1) |
Оплата за компенсацію
|
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) |
Можливі значення:
|
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 |
Закінчення документа |
Універсальний/неструктурований документ (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 |
Закінчення документа |
- 1
Під визначенням колонки Тип поля мається на увазі скорочене позначення:
M (mandatory) — обов’язкові до заповнення поля;
O (optional) — необов’язкові (опціональні) до заповнення поля.
- 2
Одиниці виміру: «г», «кг», «л», «м», «мм», «м2», «м3», «шт», «кор», «пач», «піддон», «пак», «штука дрібна», «uauzd_MIL», «пляш», «рул», «послуга», «uauzd_CMT», «грн», «ящ», «Пар», «год.», «пог.м», «компл», «Тонна», «Блок», «Набір», «паков», «банк», «од»