Товарне узгодження (AGREEM)
Товарне узгодження (AGREEM) щодо зміни цін формується постачальником на підставі специфікації та відправляється в торговельну мережу
При передаванні дублів позицій (позиції з однаковими значеннями штрих-коду <PRODUCT> + артикулу <PRODUCTIDBUYER>) документ не відправляється, а потрапляє в помилки.
Опис полів:
| № з/п | Параметр1 | Тип2 | Формат | Опис |
| I | AGREEM | М | Початок документа | |
| 1 | NUMBER | М | Рядок (16) | Номер документа |
| 2 | DATE | М | Дата (РРРР-ММ-ДД) | Дата документа |
| 3 | CONTRACTNUMBER | М | Рядок (20) | Номер контракту |
| 4 | CONTRACTEXPIRYDATE | М | Дата (РРРР-ММ-ДД) | Дата закінчення дії контракту |
| 5 | CAMPAIGNNUMBER | М | Рядок (20) | Номер договору |
| 6 | CAMPAIGNDATE | М | Дата (РРРР-ММ-ДД) | Дата договору |
| 7 | CAMPAIGN_GLN | M | Число (13) | GLN контракту |
| 8 | DOCSTARTDATE | М | Дата (РРРР-ММ-ДД) | Дата початку дії нової ціни |
| 9 | DOCENDDATE | М | Дата (РРРР-ММ-ДД) | Дата закінчення дії нової ціни |
| 10 | PRICETYPE | М | Рядок («regular» / «promo» / «promo_compensation» / «promo_combo») | підтип документа (дія) regular - змінити регулярну ціну promo - змінити промо ціну-Зниження ціни promo_compensation - змінити промо ціну-Компенсація promo_combo - змінити промо ціну-Комбо (Зниження ціни + Компенсація) |
| 11 | DOCACTION | М | Число (1) | ознака документа (0 - за замовчуванням; 1 - документ AGREEM з відхиленими позиціями) |
| 12 | CONTRACTNUMBER_MARKETING | O | Число | Номер маркетингового договору |
| 13 | CONTRACTDATE_MARKETING | O | Дата (РРРР-ММ-ДД) | Дата маркетингового договору |
| 14 | ACTION_NAME | O | Рядок (255) | Назва акції |
| 15 | ACTION_ACTIVATION_PAYMENT | O | Число | Оплата за активацію акції 1 - Безкоштовно 2 - З маркетингового бюджету 3 - Окремий рахунок |
| 16 | COMPENSATION_PAYMENT | O | Число | Оплата за компенсацію 1 - З маркетингового бюджету 2 - Окремий рахунок |
| 17 | REASON_REJECTION | O/M | Рядок (500) | Причина відхилення. Обов’язково передається при відхиленні документа чи його позицій (DOCACTION = 1) |
| 18 | HEAD | Початок основного блоку | ||
| 18.1 | SUPPLIER | M | Число (13) | GLN продавця |
| 18.2 | BUYER | M | Число (13) | GLN покупця |
| 18.3 | RECIPIENT | M | Число (13) | GLN одержувача |
| 18.4 | SENDER | M | Число (13) | GLN відправника |
| 18.5 | ATTACHMENT | O | Рядок | Вкладення (назва файлу) |
| 18.6 | RESPONSIBLE_OFFICER | O | Рядок (255) | Відповідальний співробітник (ПІП; контакти) |
| 18.7 | POSITION | Товарні позиції (початок блоку) | ||
| 18.7.1 | POSITIONNUMBER | М | Число позитивне (3) | Номер позиції в документі |
| 18.7.2 | PRODUCT | M | Число (13) | Штрихкод продукту |
| 18.7.3 | PRODUCTIDBUYER | М | Рядок (10) | Артикул покупця |
| 18.7.4 | UCCFEA | O/M | Число (4-10) | Код УКТ ЗЕД. За запитом мережі поле може бути обов’язковим (в випадку наявності цього поля в PRODUCTLIST) |
| 18.7.5 | POSITIONIDBUYER | O | Рядок (10) | id товарної позиції |
| 18.7.6 | DESCRIPTION | M | Рядок (50) | Найменування |
| 18.7.7 | PRICEWITHOUTVAT | М | Decimal (#.00) | Ціна без ПДВ |
| 18.7.8 | PRICEWITHVAT | M | Decimal (#.00) | Ціна з ПДВ |
| 18.7.9 | PRICEWITHOUTVAT_CHNG | О | Decimal (#.00) | Нова ціна без ПДВ |
| 18.7.10 | PRICEWITHVAT_CHNG | M | Decimal (#.00) | Нова ціна з ПДВ |
| 18.7.11 | DIFFPRICE | M | Decimal (#.00) | % зміни ціни |
| 18.7.12 | DISCOUNTPRICEWITHOUTVAT | O | Decimal (#.00) | Ціна зі знижкою без ПДВ |
| 18.7.13 | DISCOUNTPRICEWITHVAT | O | Decimal (#.00) | Ціна зі знижкою з ПДВ |
| 18.7.14 | DISCOUNTVAL | O | Decimal (#.00) | % знижки |
| 18.7.15 | DISCOUNTPRICEWITHOUTVAT_CHNG | O | Decimal (#.00) | Нова ціна зі знижкою без ПДВ |
| 18.7.16 | DISCOUNTPRICEWITHVAT_CHNG | O | Decimal (#.00) | Нова ціна зі знижкою з ПДВ |
| 18.7.17 | DIFFDISCOUNTPRICE | O | Decimal (#.00) | % зміни ціни зі знижкою |
| 18.7.18 | DISCOUNTVAL_CHNG | O | Decimal (#.00) | % нової знижки |
| 18.7.19 | PROMO | O | Decimal (#.00) | промоціна без ПДВ |
| 18.7.20 | PROMOWITHVAT | O | Decimal (#.00) | промоціна з ПДВ |
| 18.7.21 | PROMODISCOUNT | O | Число | % промознижки |
| 18.7.22 | PROMOQUANTITY | O | Число (10,3) | Кількість промо |
| 18.7.23 | COMPENSATION_PERCENTAGE | O | Число (6,2) | % компенсації |
| 18.7.24 | ACTION_ACTIVATION_AMOUNT | O | Число (6,4) | Сума за активацію акції |
| 18.7.25 | PROMOPRICEWITHVAT_RECOMMEND | O | Число (6,4) | Рекомендована роздрібна ціна з ПДВ |
| 18.7.26 | VAT | O | Число («20» / «7» / «0») | Ставка ПДВ,% |
| 18.7.27 | UNIT | O | Рядок (3) | Одиниці виміру |
| 18.7.28 | STATE | O | Число («-1» / «0» / «1») | Стан позиції -1 - статус відсутній 0 - позиція відхилена 1 - позиція прийнята |
| 18.7.29 | POSITIONACTION | O/М | Рядок («decline») | Статус позиції при відхиленні AGREEM. Обов’язково передається при відхиленні документа чи його позицій (DOCACTION = 1) |
- [1] - елементи структури мають наступний вигляд:
-
-
параметрЗіЗначенням;
-
об’єктЗПараметрами;
-
масивОб’єктів;
-
жовтим фоном виділяються комірки, в яких відбувались останні зміни
-
- [2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:
-
-
-
M (mandatory) — обов’язкові до заповнення поля;
-
O (optional) — необов’язкові (опціональні) до заповнення поля.
-
-
XML приклад
-
<?xml version="1.0" encoding="utf-8"?> <AGREEM> <NUMBER>100000027</NUMBER> <DATE>2020-03-23</DATE> <CONTRACTNUMBER>4600000011</CONTRACTNUMBER> <CONTRACTEXPIRYDATE>2023-12-31</CONTRACTEXPIRYDATE> <CAMPAIGNNUMBER>19000000016</CAMPAIGNNUMBER> <CAMPAIGNDATE>2016-07-01</CAMPAIGNDATE> <CAMPAIGN_GLN>9800000000088</CAMPAIGN_GLN> <DOCSTARTDATE>2020-03-26</DOCSTARTDATE> <DOCENDDATE>2023-12-31</DOCENDDATE> <PRICETYPE>regular</PRICETYPE> <DOCACTION>0</DOCACTION> <CONTRACTDATE_MARKETING>2023-12-31</CONTRACTDATE_MARKETING> <ACTION_NAME>Двотижнева акція</ACTION_NAME> <ACTION_ACTIVATION_PAYMENT>1</ACTION_ACTIVATION_PAYMENT> <COMPENSATION_PAYMENT>1</COMPENSATION_PAYMENT> <REASON_REJECTION>1</REASON_REJECTION> <HEAD> <BUYER>9800000002688</BUYER> <SUPPLIER>4800000006563</SUPPLIER> <RECIPIENT>9860000000688</RECIPIENT> <SENDER>4800000006563</SENDER> <ATTACHMENT>Назва файлу</ATTACHMENT> <RESPONSIBLE_OFFICER>Іванов Іван Іванович</RESPONSIBLE_OFFICER> <POSITION> <POSITIONNUMBER>00070</POSITIONNUMBER> <PRODUCT>4800000000868</PRODUCT> <PRODUCTIDBUYER>200006</PRODUCTIDBUYER> <UCCFEA>3400000000</UCCFEA> <POSITIONIDBUYER>00000</POSITIONIDBUYER> <DESCRIPTION>Засіб для прочищення труб Крот Turbo 50г</DESCRIPTION> <PRICEWITHOUTVAT>1.45</PRICEWITHOUTVAT> <PRICEWITHVAT>1.94</PRICEWITHVAT> <PRICEWITHOUTVAT_CHNG>1.00</PRICEWITHOUTVAT_CHNG> <PRICEWITHVAT_CHNG>1.60</PRICEWITHVAT_CHNG> <DIFFPRICE>1.38</DIFFPRICE> <DISCOUNTPRICEWITHOUTVAT>0.00</DISCOUNTPRICEWITHOUTVAT> <DISCOUNTPRICEWITHVAT>0.00</DISCOUNTPRICEWITHVAT> <DISCOUNTVAL>0.00</DISCOUNTVAL> <DISCOUNTPRICEWITHOUTVAT_CHNG>0.00</DISCOUNTPRICEWITHOUTVAT_CHNG> <DISCOUNTPRICEWITHVAT_CHNG>0.00</DISCOUNTPRICEWITHVAT_CHNG> <DIFFDISCOUNTPRICE>0.00</DIFFDISCOUNTPRICE> <DISCOUNTVAL_CHNG>100.00</DISCOUNTVAL_CHNG> <PROMO>10.20</PROMO> <PROMOWITHVAT>10.30</PROMOWITHVAT> <PROMODISCOUNT>10</PROMODISCOUNT> <PROMOQUANTITY>10</PROMOQUANTITY> <COMPENSATION_PERCENTAGE>2</COMPENSATION_PERCENTAGE> <ACTION_ACTIVATION_AMOUNT>6</ACTION_ACTIVATION_AMOUNT> <PROMOPRICEWITHVAT_RECOMMEND>6</PROMOPRICEWITHVAT_RECOMMEND> <VAT>20</VAT> <UNIT>PCE</UNIT> <STATE>1</STATE> <POSITIONACTION>decline</POSITIONACTION> </POSITION> </HEAD> </AGREEM>
No comments to display
No comments to display