Дані товарів, що долучаються в Прайс-лист (об’єкт XPriceList)

JSON:

{
  "period": {
    "date_from": 0,
    "date_to": 0
  },
  "price": [
    {
      "category_name": "Чай",
      "children": [
        {
          "category_name": "Грінфілд",
          "children": [
            {
              "category_name": "Листовий ж/б",
              "children": [],
              "prods": [
                {
                  "regions": "Дніпропетровська,Харківська,Сумська,Полтавська",
                  "article": "6181",
                  "name": "Ж/Б Oriental Spirits 125гр.х14п.\"Грінфілд\" Укр",
                  "barcode": "4820022865830",
                  "producer_code": "BP0836",
                  "user_code": "902200010",
                  "unit_weight": "0.4",
                  "box_qty": "14",
                  "box_weight": "5.6",
                  "box_in_layer": "3",
                  "box_in_palette": "9",
                  "palette_weight": "99.18",
                  "unit_id": "8",
                  "stock_balance": "100",
                  "price_without_vat": "66.05",
                  "price_with_vat": "79.26",
                  "vat": "5",
                  "quota": "25",
                  "comment": "Коментар",
                  "is_new": true,
                  "is_promo": false,
                  "is_pickup": true
                }
              ]
            }
          ],
          "prods": []
        }
      ],
      "prods": []
    },
    {
      "category_name": "Кава",
      "children": [
        {
          "category_name": "Жокей",
          "children": [
            {
              "category_name": "Зернову",
              "children": [],
              "prods": [
                {
                  "regions": "Португалія",
                  "article": "7127",
                  "name": "\"Традиційний\"  400х12 зернова кава Жокей Укр",
                  "barcode": "4820022867421",
                  "producer_code": "BP0837",
                  "user_code": "901120000",
                  "unit_weight": "0.321",
                  "box_qty": "12",
                  "box_weight": "3.852",
                  "box_in_layer": "5",
                  "box_in_palette": "10",
                  "palette_weight": "25.75",
                  "unit_id": "8",
                  "stock_balance": "100",
                  "price_without_vat": "80.05",
                  "price_with_vat": "96.06",
                  "vat": "5",
                  "quota": "25",
                  "comment": "Коментар",
                  "is_new": false,
                  "is_promo": false,
                  "is_pickup": false
                },
                {
                  "regions": "Запорізька",
                  "article": "7115",
                  "name": "\"Класичний\"  250х16 зернова кава Жокей Укр",
                  "barcode": "4820022867438",
                  "producer_code": "BP0838",
                  "user_code": "901120000",
                  "unit_weight": "1.2",
                  "box_qty": "16",
                  "box_weight": "19.2",
                  "box_in_layer": "4",
                  "box_in_palette": "8",
                  "palette_weight": "78.65",
                  "unit_id": "8",
                  "stock_balance": "100",
                  "price_without_vat": "57.75",
                  "price_with_vat": "69.3",
                  "vat": "5",
                  "quota": "25",
                  "comment": "Коментар",
                  "is_new": false,
                  "is_promo": true,
                  "is_pickup": false
                }
              ]
            }
          ],
          "prods": []
        }
      ],
      "prods": []
    }
  ],
  "distributors": []
}

Таблиця 1 - Опис параметрів об’єкта XPriceList

Параметр	Тип 1	Формат	Опис
		Об’єкт XPriceList
currency	M	String	код валюти: UAH (за замовчуванням) EUR USD
vatIncluded	O	int	Ознака ціни в прайс-листі, за якою Продавець працює з Покупцем (якщо поле не передається, то за замовчуванням =1): 0 - без ПДВ; 1 - з ПДВ
period		XPriceListPeriod	об’єкт; період дії данних по товару
price	M	List<XPriceListElement>	масив об’єктів; дані товару Прайс-листа
distributors		List<XPriceListDistributor>	масив об’єктів; дані Покупців (Дистиб’юторів)

Таблиця 2 - Опис параметрів об’єкта XPriceListPeriod

Параметр	Формат	Опис
	Об’єкт XPriceListPeriod
date_from	long	період дії з
date_to	long	період дії по

Таблиця 3 - Опис параметрів об’єкта XPriceListElement

Параметр	Тип 1	Формат	Опис
		Об’єкт XPriceListElement
currency	M	String	код валюти: UAH (за замовчуванням) EUR USD
category_id	O	long	ідентифікатор для сервісу Маркет: лінійки/категорії/підкатегорії
category_name	M	String	назва: для сервісу Маркет: лінійки/категорії/підкатегорії
children	O/M	List<XPriceListElement>	масив об’єктів; для сервісу Маркет: дані категорії/підкатегорії
prods	M	List<XPriceListProduct>	масив об’єктів; дані товарів

Таблиця 4 - Опис параметрів об’єкта XPriceListDistributor

Параметр	Формат	Опис
	Об’єкт XPriceListDistributor
name	String	назва Покупця (Дистиб’ютора)
id	long	ідентифікатор Покупця (Дистиб’ютора)
gln	String	GLN Покупця (Дистиб’ютора)

Таблиця 5 - Опис параметрів об’єкта XPriceListProduct

Параметр	Тип 1	Формат	Опис
		Об’єкт XPriceListProduct
group_id		long	ідентифікатор групи
article	M	String	артикул
name	M	String	назва товару
barcode	M	String	штрихкод
user_code	O	String	код УКТ ЗЕД
unit_weight	O	String	вага одиниці товару, кг
box_qty	M	String	одиниць в коробці
box_weight	O	String	вага коробки, кг
box_in_layer	O	String	кількість коробок в шарі, шт.
box_in_palette	O	String	кількість коробок на палеті, шт.
palette_weight	O	String	вага палети, кг
producer_code	O	String	код Продавця (Виробника)
min_order_qty	O	float (10,3)	Мінімальна кількість замовлення
regions	M	String	областя/країни наявності товару (перелік назв через кому)
characteristics	O	Сharacteristics	об’єкт; додаткові характеристики продукта
id		long	ідентифікатор товарної позиції
date_created		long	дата створення запису про товар
date_changed		long	дата внесених змін в дані товару
producer_id		long	ідентифікатор Продавця (Виробника)
product_id		long	ідентифікатор товару
unit_id	O	long	ідентифікатор одиниці виміру; допустимі значення: 2 - кілограм; 8 - штука
price_without_vat	M	Double	ціна одиниці без ПДВ, грн
vat	O	int	ставка ПДВ, %
price_with_vat	O	Double	ціна одиниці з ПДВ, грн
price_discont	O	Double	ціна одиниці зі знижкою без ПДВ, грн
price_with_vat_discont	O	Double	ціна одиниці зі знижкою з ПДВ, грн
date_from		long	період дії з
date_to		long	період дії по
stock_balance	O	Double	залишок
comment	O	String	коментарі
quota	O	Double	квота на замовлення
multiplicity	O	int	кратність кількості в замовленні. Значення кратно якому має бути заповнена кількість замовленої позиції
is_promo	O	boolean	відмітка «Акція!»
is_new	O	boolean	відмітка «Новинка!»
is_public	O	boolean	відмітка «Публічна позиція!»
is_surcharge	O	boolean	відмітка «Надбавка!»
is_pickup	O	boolean	відмітка «Самовивіз!»
is_bestseller	O	boolean	відмітка «Хіт продажу!»
add_characteristics	O	String	характеристики

Таблиця 6 - Опис параметрів об’єкта Сharacteristics

Параметр	Тип 1	Формат	Опис
		Об’єкт Сharacteristics
recommended_order_pce	О	Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)	Рекомендоване замовлення, шт
recommended_order_box	О	Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)	Рекомендоване замовлення, ящ
secondary_sales	О	Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)	Вторинні продажі за 21 день, шт (у Покупця (Дистрибʼютора) по звітах. інформаційне)
average_sales	О	Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)	Середньомісячні вторинні продажі (середні за останні 3 місяці), шт (у Покупця (Дистрибʼютора) по звітах. інформаційне)
actual_qty_buyer	О	Число з плаваючою точкою (максимально: 10 знаків до крапки і 3 знака після крапки)	Залишок покупця, шт (у Покупця (Дистрибʼютора) по звітах. інформаційне)

1

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

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