Дані товарів, що долучаються в Прайс-лист (об’єкт 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

period

XPriceListPeriod

об’єкт; період дії данних по товару

price

M

List<XPriceListElement>

масив об’єктів; дані товару Прайс-листа

distributors

List<XPriceListDistributor>

масив об’єктів; дані Покупців (Дистиб’юторів)

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

Параметр

Тип 1

Формат

Опис

Об’єкт 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

Параметр

Тип 1

Формат

Опис

Об’єкт 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

ціна одиниці з ПДВ, грн

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

відмітка «Хіт продажу!»

Таблиця 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) — необов’язкові (опціональні) до заповнення поля.