Товарне узгодження (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») |
підтип документа (дія)
|
11 |
DOCACTION |
М |
Число (1) |
ознака документа (0 - за замовчуванням; 1 - документ AGREEM з відхиленими позиціями) |
12 |
CONTRACTNUMBER_MARKETING |
O |
Число |
Номер маркетингового договору |
13 |
CONTRACTDATE_MARKETING |
O |
Дата (РРРР-ММ-ДД) |
Дата маркетингового договору |
14 |
ACTION_NAME |
O |
Рядок (255) |
Назва акції |
15 |
ACTION_ACTIVATION_PAYMENT |
O |
Число |
Оплата за активацію акції
|
16 |
COMPENSATION_PAYMENT |
O |
Число |
Оплата за компенсацію
|
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») |
Стан позиції
|
18.7.29 |
POSITIONACTION |
O (М - при DOCACTION = 1) |
Рядок («decline») |
Статус позиції при відхиленні AGREEM |
|
POSITION |
Товарні позиції (закінчення блоку) |
||
|
HEAD |
Закінчення основного блоку |
||
|
AGREEM |
Закінчення документа |
- [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