Специфікації документів сервісу Маркет

Обмеження (LIMITS)
Прайс-лист (PRICAT)
Замовлення (ORDER)
Повідомлення про повернення (RETANN)

Обмеження (LIMITS)

Обмеження (LIMITS) на замовлення відправляється Продавцем (Виробником); в документі вказуються ціни та кількості по формуванню замовлення у вказаного Покупця (Дистриб’ютора).

Опис полів:

№ з/п	Параметр¹	Тип²	Формат	Опис
I	DISTRIBEX_LIMITS			Початок документа
1	HEAD			Початок основного блоку
1.1	SENDER	M	Число (13)	GLN Продавця (Виробника)
1.2	RECIPIENT	M	Число (13)	GLN Дистриб’ютора
1.3	LIMIT			Обмеження (початок блоку)
1.3.1	NAME	M	Рядок. Доступні значення: «min_sum_nds» - Мінімальна сума замовлення з ПДВ - float (10,4) «max_sum_nds» - Максимальна сума замовлення з ПДВ - float (10,4) «min_sum_without_nds» - Мінімальна сума замовлення без ПДВ - float (10,4) «max_sum_without_nds» - Максимальна сума замовлення без ПДВ - float (10,4) «credit_limit» - Кредитний ліміт - float (10,4) «max_weight» - Максимальна вага замовлення, кг - float (13,3) «max_pos_qty» - Макс. кіл-ть товарних позицій - число позитивне (10) «max_pack_qty» - Максимальна кількість коробок / ящиків - число позитивне (10) «max_pallet_qty» - Максимальна кількість палет - число позитивне (10) «multiplicity_packing» - Кратність коробці/ящику - 0-ні; 1-так «surcharge_rate» - Тариф для надбавки - float (10,2) «multiplicity_min_order_qty» - Кратність мін. кіл-ті одиниць - 0-ні, 1-так «balance_quota_control» - Контроль залишків та квот; 0-ні, 1-так. За balance_quota_control=0 Покупець може замовити більше встановленого залишку та/або квоти «max_return_days» - Макс. кіл-ть днів для повернення товару	Назва обмеження
1.3.2	VALUE	M	Число (формат залежить від NAME)	Значення обмеження

[1] - елементи структури мають наступний вигляд:

параметрЗіЗначенням;
об’єктЗПараметрами;
масивОб’єктів;
жовтим фоном виділяються комірки, в яких відбувались останні зміни

[2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:

M (mandatory) — обов’язкові до заповнення поля;
O (optional) — необов’язкові (опціональні) до заповнення поля.

XML приклад

<DISTRIBEX_LIMITS>
<HEAD>
   <SENDER>9876543210123</SENDER>
   <RECIPIENT>3210987654321</RECIPIENT>
   <LIMITS>
      <LIMIT>
         <NAME>min_sum_nds</NAME>
         <VALUE>2000.00</VALUE>
      </LIMIT>
      <LIMIT>
         <NAME>max_sum_nds</NAME>
         <VALUE>20000.00</VALUE>
      </LIMIT>
      <LIMIT>
         <NAME>credit_limit</NAME>
         <VALUE>100000.00</VALUE>
      </LIMIT>
      <LIMIT>
         <NAME>max_weight</NAME>
         <VALUE>500.000</VALUE>
      </LIMIT>
      <LIMIT>
         <NAME>max_pos_qty</NAME>
         <VALUE>300</VALUE>
      </LIMIT>
      <LIMIT>
         <NAME>max_pack_qty</NAME>
         <VALUE>350</VALUE>
      </LIMIT>
      <LIMIT>
         <NAME>max_pallet_qty</NAME>
         <VALUE>12</VALUE>
      </LIMIT>
      <LIMIT>
         <NAME>multiplicity_packing</NAME>
         <VALUE>0</VALUE>
      </LIMIT>
   </LIMITS>
</HEAD>
</DISTRIBEX_LIMITS>

Прайс-лист (PRICAT)

Прайс-лист (PRICAT) — електронний документ, що містить дані про товари/послуги (штрих-код, опис, ціну, ставку ПДВ) та використовується Продавцем (Виробником) для повідомлення про актуальні ціни або їх зміни.

Опис полів:

№ з/п	Параметр¹	Тип²	Формат	Опис
	PRICAT			Початок документа
1	ACTION	O	Число - «15», «16», «17», «18», «19»	Тип документа і вибір дії: 15 - прайс-лист для Distribution, 16 - масова очистка прайс-листа, 17 - прайс-лист з характеристиками товарної позиції, 18 - прайс-лист з цінами товарної позиції, 19 - запит прайс-листа на поточну дату
2	NUMBER	M	Рядок (16)	Номер документа
3	DATE	M	Дата (РРРР-ММ-ДД)	Дата документа
4	DATEFROM	M (O - при ACTION = 17)	Дата (РРРР-ММ-ДД)	Прайс-лист набрати чинності з дати
5	DATETO	M (O - при ACTION = 17)	Дата (РРРР-ММ-ДД)	Дата закінчення дії прайс-листа
6	SUPPLIER	M	Число (13)	GLN Продавця (Виробника)
7	BUYER	M (O - при ACTION = 17)	Число (13)	GLN Покупця (Дистриб’ютора)
8	SENDER	M	Число (13)	GLN відправника повідомлення
9	RECIPIENT	M (O - при ACTION = 17)	Число (13)	GLN одержувача повідомлення
10	VATINCLUDED	O	Число - «0» / «1»	Ознака ціни в прайс-листі, за якою Продавець працює з Покупцем (якщо поле не передається, то за замовчуванням =1): 0 - без ПДВ; 1 - з ПДВ
11	CATALOGUE			Каталог (початок блоку)
11.1	POSITION			Товарні позиції (початок блоку)
11.1.1	POSITIONNUMBER	O	Число позитивне	Номер товарної позиції (Порядковий номер товарної позиції в документі (1, 2, 3, 4 … n))
11.1.2	ACTION	O	Число - «2», «3», «4», «27», «29»	Необхідна дія: 2 - додавання нових позицій, 3 - видалення позицій, 4 - зміна даних по позиції
11.1.3	PRODUCTGROUP	M (O - при ACTION = 18)	Рядок (75)	Лінійка товарів
11.1.4	BRAND	M (O - при ACTION = 18 та Продавця (Виробника) ПП «СПС»)	Рядок (75)	Категорія товарів
11.1.5	SUBBRAND	M (O - при ACTION = 18 та Продавця (Виробника) ПП «СПС»)	Рядок (75)	Підкатегорія товарів
11.1.6	IDSUPPLIER	M	Рядок (20)	Артикул
11.1.7	PRODUCTNAME	M (O - при ACTION = 18)	Рядок (255)	Найменування
11.1.8	PRODUCT	M	Ціле позитивне число (20)	Штрих-код
11.1.9	MINORDERQUANTITY	O (M-для Розетка)	Число з плаваючою точкою (10,3)	Мінімальна кількість замовлення
11.1.10	IDPRODUCER	O	Рядок (8)	Код Виробника
11.1.11	IDNATIONAL	O	Ціле позитивне число (20)	Код товару за національним класифікатором (код УКТЗЕД)
11.1.12	UNITWEIGHT	O	Число з плаваючою точкою (максимально: 10 знаків до крапки та 3 знаки після крапки)	Вага одиниці (кг)
11.1.13	QUANTITYOFCUINTU	M (O - при ACTION = 18)	Число з плавачою точкою (максимально: 3 знаки до крапки та 3 знаки після крапки)	Фасування
11.1.14	SECONDARYSALES	О	Число з плаваючою точкою (максимально: 10 знаків до крапки та 3 знаки після крапки)	Вторинні продажі за 21 день, шт (у Покупця (Дистриб’ютора) по звітах. інформаційне)
11.1.15	AVERAGESALES	О	Число з плаваючою точкою (максимально: 10 знаків до крапки та 3 знаки після крапки)	Середньомісячні вторинні продажі (середні за останні 3 місяці), шт (у Покупця (Дистриб’ютора) по звітах. інформаційне)
11.1.16	ACTUALQUANTITYBUYER	О	Число з плаваючою точкою (максимально: 10 знаків до крапки та 3 знаки після крапки)	Залишок продавця
11.1.17	RECOMMENDEDORDERPCE	О	Число з плаваючою точкою (максимально: 10 знаків до крапки та 3 знаки після крапки)	Рекомендоване замовлення, шт
11.1.18	RECOMMENDEDORDERBOX	О	Число з плаваючою точкою (максимально: 10 знаків до крапки та 3 знаки після крапки)	Рекомендоване замовлення, кор/ящ
11.1.19	BOXWEIGHT	O	Число з плаваючою точкою (максимально: 10 знаків до крапки та 3 знаки після крапки)	Вага коробки / ящика кг.
11.1.20	BOXINLAYER	O	Ціле позитивне число (20)	Коробок в шарі (шт.)
11.1.21	BOXINPALLET	O	Ціле позитивне число (20)	Коробок на палеті (шт.)
11.1.22	PALLETWEIGHT	O	Число з плаваючою точкою (максимально: 10 знаків до крапки та 3 знаки після крапки)	Вага палети (кг)
11.1.23	UNIT	M (O - при ACTION=16/18/19 та Продавця (Виробника) ПП «СПС»)	Рядок (3)	Одиниця виміру
11.1.24	ACTUALQUANTITY	O	Число з плаваючою точкою (максимально: 10 знаків до крапки та 3 знаки після крапки)	Залишок по позиції
11.1.25	CURRENCY	M	Рядок (3)	Тризначний код валюти (UAH / USD / EUR)
11.1.26	UNITPRICE	M (O - при ACTION = 17 та Продавця (Виробника) ПП «СПС»)	Число з плаваючою точкою (максимально: 6 знаків до крапки та 6 знака після крапки)	Ціна за одиницю без ПДВ (грн)
11.1.27	PRICEWITHVAT	O(M - для Продавця (Виробника) ПП «СПС»)	Число з плаваючою точкою (максимально: 6 знаків до крапки та 6 знака після крапки)	Ціна за одиницю з ПДВ (грн) / Для Продавця (Виробника) ПП «СПС»: Ціна зі знижкою з ПДВ (грн/шт.)
11.1.28	UNITPRICEDISCONT	O	Число з плаваючою точкою (максимально: 6 знаків до крапки та 6 знака після крапки)	Ціна одиниці зі знижкою без ПДВ, грн
11.1.29	PRICEWITHVATDISCONT	O	Число з плаваючою точкою (максимально: 6 знаків до крапки і 6 знака після крапки)	Ціна одиниці зі знижкою з ПДВ, грн
11.1.30	TAXRATE	O	Ціле позитивне число - «20», «0», «7»	Ставка ПДВ,%
11.1.31	QUOTA	O	Число з плаваючою точкою (максимально: 10 знаків до крапки та 3 знаки після крапки)	Квота на замовлення
11.1.32	MULTIPLICITY	O	Число з плаваючою точкою (максимально: 10 знаків до крапки та 1 знак після крапки)	Кратність кількості в замовленні. Значення кратно якому має бути заповнена кількість замовленої позиції
11.1.33	INFO	O	Рядок (255)	Дод. інформація
11.1.34	NEWPOSITION	O	Число - «0», «1»	Новинка
11.1.35	PROMO	О	Число - «0», «1»	Акція
11.1.36	PUBLICPOSITION	O	Число	Публічна позиція
11.1.37	BESTSELLER	O	Число - «0», «1»	Хіт продажу
	POSITION			Товарні позиції (закінчення блоку)
	CATALOGUE			Каталог (закінчення блоку)
	PRICAT			Закінчення документа

[1] - елементи структури мають наступний вигляд:

параметрЗіЗначенням;
об’єктЗПараметрами;
масивОб’єктів;
жовтим фоном виділяються комірки, в яких відбувались останні зміни

[2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:

M (mandatory) — обов’язкові до заповнення поля;
O (optional) — необов’язкові (опціональні) до заповнення поля.

XML приклад

<PRICAT>
   <ACTION>15</ACTION>
   <NUMBER>10000</NUMBER>
   <DATE>2020-08-10</DATE>
   <DATEFROM>2020-08-10</DATEFROM>
   <DATETO>2020-12-31</DATETO>
   <SUPPLIER>9876543210123</SUPPLIER>
   <BUYER>3210987654321</BUYER>
   <SENDER>9876543210123</SENDER>
   <RECIPIENT>3210987654321</RECIPIENT>
   <VATINCLUDED>0</VATINCLUDED>
   <CATALOGUE>
      <POSITION>
         <POSITIONNUMBER>1</POSITIONNUMBER>
         <ACTION>2</ACTION>
      <PRODUCTGROUP>Чай</PRODUCTGROUP>
         <BRAND>Грінфілд </BRAND>
         <SUBBRAND>Листовий ж/б</SUBBRAND>
         <IDSUPPLIER>6183</IDSUPPLIER>
         <PRODUCTNAME>Ж/Б Royal Earl Grey 125гр.х14п.Грінфілд</PRODUCTNAME>
         <PRODUCT>4820022865816</PRODUCT>
         <IDNATIONAL>0902200010</IDNATIONAL>
         <UNITWEIGHT>0.550</UNITWEIGHT>
         <QUANTITYOFCUINTU>20</QUANTITYOFCUINTU>
         <BOXWEIGHT>10.000</BOXWEIGHT>
         <BOXINLAYER>3</BOXINLAYER>
         <BOXINPALLET>9</BOXINPALLET>
         <PALLETWEIGHT>100.255</PALLETWEIGHT>
         <UNIT>PCE</UNIT>
         <ACTUALQUANTITY>2500.0</ACTUALQUANTITY>
         <CURRENCY>UAH</CURRENCY>
         <UNITPRICE>50.00</UNITPRICE>
         <PRICEWITHVAT>60.00</PRICEWITHVAT>
         <TAXRATE>20</TAXRATE>
         <QUOTA>1000.0</QUOTA>
         <INFO>Тут можна написати коментарій</INFO>
         <NEWPOSITION>1</NEWPOSITION>
         <PROMO>0</PROMO>
      </POSITION>
   </CATALOGUE>
</PRICAT>

Замовлення (ORDER)

Замовлення (ORDER) — електронний документ замовлення на постачання, сформований Дистриб’ютором, що містить дані про товар (штрих-код, опис, кількість, ціну та інші параметри).

Опис полів:

№ з/п	Параметр¹	Тип²	Формат	Опис
	ORDER			Початок документа
1	DOCUMENTNAME	О	Число позитивне	Назва документа (220 - замовлення)
2	NUMBER	М	Рядок (50)	Номер замовлення
3	DATE	М	Дата (РРРР-ММ-ДД)	Дата документа
4	DELIVERYDATE	М	Дата (РРРР-ММ-ДД)	Дата постачання
5	CURRENCY	O	Рядок (3)	Тризначний код валюти (наприклад, UAH, RUB, USD, EUR, MDL, BYR)
6	PAYMENTMETHOD	O	Рядок (1)	Код способу оплати: 1 - Готівковий розрахунок 2 - Безготівковий розрахунок
7	ORDRTYPE	O	Рядок (1)	Код підтипу замовлення: 1 - Реалізація 2 - Відправка на відповідальне зберігання 3 - Зняття з відповідального зберігання
8	DOCTYPE	O	Рядок (1)	Тип документа: O - оригінал PO - попереднє замовлення R - заміна D - видалення
9	INFO	O	Рядок	Коментар
10	DISTRIBUTOR	М		Заповнюється лише для сервісу Маркет (Distribution): 1 - документ сервісу Маркет (Distribution)
11	HEAD			Початок основного блоку
11.1	SUPPLIER	M	Число (13)	GLN Продавця (Виробника)
11.2	BUYER	M	Число (13)	GLN Покупця (Дистриб’ютора)
11.3	DELIVERYPLACE	M	Число (13)	GLN місця доставлення
11.4	SENDER	M	Число (13)	GLN відправника повідомлення
11.5	SENDERNAME	O	Рядок (255)	Ім'я відправника
11.6	SENDERLASTNAME	O	Рядок (255)	Прізвище відправника
11.7	SENDERPHONE	O	Рядок (9)	Номер телефона відправника
11.8	RECIPIENT	M	Число (13)	GLN одержувача повідомлення
11.9	EDIINTERCHANGEID	O	Рядок (70)	Номер транзакції (підтягується з NUMBER)
11.10	DELIVERYTERMS	O	Число	Допустимі значення: 1 - Самовивіз; 2 - Доставлення транспортом Продавця (Виробника)
11.11	PAYMENTMETHOD	O	Число	Спосіб оплати: 1 - Готівковий розрахунок; 2 - Безготівковий розрахунок
11.12	POSITION			Товарні позиції (початок блоку)
11.12.1	POSITIONNUMBER	O	Число позитивне	Номер товарної позиції
11.12.2	PRODUCT	M	Число (8, 10, 14)	Штрихкод продукту
11.12.3	PRODUCTIDSUPPLIER	О	Рядок (16)	Артикул в БД
11.12.4	IDPRODUCER	O	Рядок (8)	Код Виробника
11.12.5	ORDEREDQUANTITY	M	Число позитивне	Замовлена кількість (к-сть одиниць)
11.12.6	ORDERUNIT	M	Рядок (3)	Одиниця виміру
11.12.7	ORDERPRICE	O/M	Число десяткове	Ціна продукту без ПДВ. Поле обов’язково заповнюється, якщо Продавець (Виробник) вказав обмеження Мінімальна сума замовлення без ПДВ та/або Максимальна сума замовлення без ПДВ
11.12.8	PRICEWITHVAT	O/M	Число десяткове	Ціна продукту з ПДВ. Поле обов’язково заповнюється, якщо Продавець (Виробник) вказав обмеження Мінімальна сума замовлення з ПДВ та/або Максимальна сума замовлення з ПДВ
11.12.9	VAT	O	Число десяткове	Ставка ПДВ,%
11.12.10	MAXIMUMORDERQUANTITY	O	Число з плаваючою точкою (максимально: 10 знаків до крапки та 3 знаки після крапки)	Квота на замовлення
11.12.11	CATEGORYNAME	O	Рядок (70)	Найменування лінійки товару
11.12.12	BRENDNAME	O	Рядок (70)	Найменування категорії товару
11.12.13	GROUPNAME			Найменування підкатегорії товару
11.12.14	NOVELTY	O		Новинка
11.12.15	COUNTPIECESINBOX	O	Число позитивне	Кількість одиниць в коробці
11.12.16	COUNTBOXESINLAYER	O	Число позитивне	Кількість коробок в шарі (в 1 рівні)
11.12.17	COUNTPERPALLET	O	Число позитивне	Кількість коробок на палеті
11.12.18	WEIGHT	O	Число десяткове	Вага коробки / ящика кг.
11.12.19	UNITWEIGHT	O	Число з плаваючою точкою (максимально: 10 знаків до крапки та 3 знаки після крапки)	Вага одиниці (кг)
11.12.20	PALLETS	O	Число позитивне	Кількість палет
11.12.21	BOXESCOUNT	O	Число позитивне	Кількість коробок
11.13	CHARACTERISTIC			Характеристики (початок блоку)
11.13.1	DESCRIPTION	О	Рядок (70)	Найменування/опис продукту
	CHARACTERISTIC			Характеристики (закінчення блоку)
	POSITION			Товарні позиції (закінчення блоку)
	HEAD			Закінчення основного блоку
	ORDER			Закінчення документа

[1] - елементи структури мають наступний вигляд:

параметрЗіЗначенням;
об’єктЗПараметрами;
масивОб’єктів;
жовтим фоном виділяються комірки, в яких відбувались останні зміни

[2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:

M (mandatory) — обов’язкові до заповнення поля;
O (optional) — необов’язкові (опціональні) до заповнення поля.

XML приклад

<ORDER>
    <DOCUMENTNAME>220</DOCUMENTNAME>
    <NUMBER>1000037</NUMBER>
    <DATE>2025-04-15</DATE>
    <DELIVERYDATE>2025-04-18</DELIVERYDATE>
    <CURRENCY>UAH</CURRENCY>
    <PAYMENTMETHOD>2</PAYMENTMETHOD>
    <DOCTYPE>O</DOCTYPE>
    <ORDRTYPE>1</ORDRTYPE>
    <INFO>Тестове замовлення</INFO
    <DISTRIBUTOR>1</DISTRIBUTOR>
    <HEAD>
        <SUPPLIER>9864232866251</SUPPLIER>
        <BUYER>9864232789253</BUYER>
        <DELIVERYPLACE>9864232789253</DELIVERYPLACE>
        <SENDER>9864232789253</SENDER>
        <RECIPIENT>9864232866251</RECIPIENT>
        <DELIVERYTERMS>2</DELIVERYTERMS>
        <SENDERNAME>Ім'я</SENDERNAME>
        <LASTNAME>Прізвище</LASTNAME>
        <PHONE>380111111111</PHONE>
        <EDIINTERCHANGEID>1000037</EDIINTERCHANGEID>
        <POSITION>
            <POSITIONNUMBER>1</POSITIONNUMBER>
            <PRODUCT>4802020202020</PRODUCT>
            <IDPRODUCER>430767</IDPRODUCER>
            <PRODUCTIDSUPPLIER>4802020202020</PRODUCTIDSUPPLIER>
            <ORDEREDQUANTITY>10.00</ORDEREDQUANTITY>
            <ORDERUNIT>PCE</ORDERUNIT>
            <ORDERPRICE>10.0</ORDERPRICE>
            <PRICEWITHVAT>12.0</PRICEWITHVAT>
            <VAT>20</VAT>
            <CATEGORYNAME>ТзОВ "Хлібодар"</CATEGORYNAME>
            <BRENDNAME>Румянець</BRENDNAME>
            <GROUPNAME>Хліб</GROUPNAME>
            <NOVELTY>0</NOVELTY>
            <COUNTPIECESINBOX>1</COUNTPIECESINBOX>
            <COUNTBOXESINLAYER>16</COUNTBOXESINLAYER>
            <COUNTPERPALLET>176</COUNTPERPALLET>
            <WEIGHT>1.819</WEIGHT>
            <UNITWEIGHT>0.3</UNITWEIGHT>
            <PALLETS>0.04</PALLETS>
            <BOXESCOUNT>10.00</BOXESCOUNT>
            <CHARACTERISTIC>
                <DESCRIPTION>Багет Французький УП</DESCRIPTION>
            </CHARACTERISTIC>
        </POSITION>
        <POSITION>
            <POSITIONNUMBER>2</POSITIONNUMBER>
            <PRODUCT>4801010101010</PRODUCT>
            <IDPRODUCER>430767</IDPRODUCER>
            <PRODUCTIDSUPPLIER>4801010101010</PRODUCTIDSUPPLIER>
            <ORDEREDQUANTITY>8.00</ORDEREDQUANTITY>
            <ORDERUNIT>PCE</ORDERUNIT>
            <ORDERPRICE>20.0</ORDERPRICE>
            <PRICEWITHVAT>24.0</PRICEWITHVAT>
            <VAT>20</VAT>
            <CATEGORYNAME>ТзОВ "Хлібодар"</CATEGORYNAME>
            <BRENDNAME>Румянець</BRENDNAME>
            <GROUPNAME>Хліб</GROUPNAME>
            <NOVELTY>0</NOVELTY>
            <COUNTPIECESINBOX>1</COUNTPIECESINBOX>
            <COUNTBOXESINLAYER>16</COUNTBOXESINLAYER>
            <COUNTPERPALLET>256</COUNTPERPALLET>
            <WEIGHT>1.555</WEIGHT>
            <UNITWEIGHT>0.35</UNITWEIGHT>
            <PALLETS>0.01</PALLETS>
            <BOXESCOUNT>8.00</BOXESCOUNT>
            <CHARACTERISTIC>
                <DESCRIPTION>Батон Багет УП</DESCRIPTION>
            </CHARACTERISTIC>
        </POSITION>
    </HEAD>
    <EXCHANGE_SCHEMA_TYPE>0</EXCHANGE_SCHEMA_TYPE>
</ORDER>

Повідомлення про повернення (RETANN)

Повідомлення про повернення (RETANN) використовується для повідомлення постачальника про товари, які не були прийняті і з якої причини.

Опис полів:

№ з/п	Параметр¹	Тип²	Формат	Опис
I	RETANN			Початок документа
1	NUMBER	M	Рядок (16)	Номер документа
2	ACTION	M	Число позитивне	9 - оригінал документа (дефолтне значення)
3	DATE	M	Дата (РРРР-ММ-ДД)	Дата документа
4	RETURNDATE	M	Дата (РРРР-ММ-ДД)	Дата повернення (відвантаження постачальнику)
5	INFO	O	Рядок (100)	Коментар
6	DISTRIBUTOR	M	Число позитивне	Заповнюється лише для сервісу Маркет (Distribution): * 1 - документ сервісу Маркет (Distribution)
7	HEAD			Початок основного блоку
7.1	SUPPLIER	M	Число (13)	GLN одержувача
7.2	BUYER	M	Число (13)	GLN відправника
7.3	DELIVERYPLACE	M	Число (13)	GLN місця повернення
7.4	SENDER	M	Число (13)	GLN відправника
7.5	RECIPIENT	M	Число (13)	GLN одержувача
7.6	POSITION			Товарні позиції (початок блоку)
7.6.1	POSITIONNUMBER	M	Число позитивне	Номер позиції
7.6.2	PRODUCT	M	Число (13)	Штрих-код продукту
7.6.3	PRODUCTIDSUPPLIER	O	Рядок (16)	Артикул
7.6.4	RETURNQUANTITY	M	Число десяткове	Повернена кількість
7.6.5	RETURNQUANTITYUNIT	O	Рядок (3)	Одиниця виміру
7.6.6	DESCRIPTION	O	Рядок (70)	Назва
7.6.7	ACTION			Дії (початок блоку)
7.6.7.1	CODE	O	Число (3)	Код дії: 4 - Пошкодження, 15 - Закінчився термін придатності, 12E - Товар буде повернений, 14E - Товар необхідно знищити, 15E - Товар буде відновлений
7.6.7.2	DESCRIPTION	O	Рядок (70)	Опис причини (пошкодження)

[1] - елементи структури мають наступний вигляд:

параметрЗіЗначенням;
об’єктЗПараметрами;
масивОб’єктів;
жовтим фоном виділяються комірки, в яких відбувались останні зміни

[2] - Під визначенням колонки Тип поля мається на увазі скорочене позначення:

M (mandatory) — обов’язкові до заповнення поля;
O (optional) — необов’язкові (опціональні) до заповнення поля.

XML приклад

<RETANN>
   <NUMBER>des_api_1</NUMBER>
   <ACTION>9</ACTION>
   <DATE>2023-02-17</DATE>
   <RETURNDATE>2023-03-06</RETURNDATE>
   <INFO>Додаткова інформація</INFO>
   <DISTRIBUTOR>1</DISTRIBUTOR>
   <HEAD>
      <SUPPLIER>9864065732181</SUPPLIER>
      <BUYER>9864065732211</BUYER>
      <DELIVERYPLACE>9864065732211</DELIVERYPLACE>
      <SENDER>9864065732181</SENDER>
      <RECIPIENT>9864065732211</RECIPIENT>
      <EDIINTERCHANGEID>test2</EDIINTERCHANGEID>
      <POSITION>
         <POSITIONNUMBER>1</POSITIONNUMBER>
         <PRODUCT>1472583690147</PRODUCT>
         <PRODUCTIDSUPPLIER>22222</PRODUCTIDSUPPLIER>
         <RETURNQUANTITY>3</RETURNQUANTITY>
         <RETURNQUANTITYUNIT>PCE</RETURNQUANTITYUNIT>
         <DESCRIPTION>drink1</DESCRIPTION>
         <ACTION>
            <CODE>12Е</CODE>
             <DESCRIPTION>пошкодження</DESCRIPTION>
         </ACTION>
      </POSITION>
   </HEAD>
</RETANN>