Skip to main content

Товарне узгодження (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 - Окремий рахунок

  • 4 - Компенсаційний бюджет

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 (М - при 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>