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

JSON:

{
  "distributors": [
    {
      "gln": "9864065732327",
      "id": 13200793,
      "name": "Dist_Test_1"
    },
    {
      "gln": "9864065732334",
      "id": 13200795,
      "name": "Dist_Test_2"
    }
  ],
  "period": {
    "date_from": 1588626000,
    "date_to": 1598821200
  },
  "price": [
    {
      "category_name": "Кухня",
      "children": [
        {
          "category_name": "Кастрюлі",
          "children": [
            {
              "category_name": "Емальовані",
              "children": [],
              "prods": [
                {
                  "article": 2222,
                  "barcode": "4800000000001",
                  "box_in_layer": 25,
                  "box_in_palette": 50,
                  "box_qty": 100,
                  "box_weight": 199,
                  "comment": "супер",
                  "is_new": true,
                  "is_promo": true,
                  "is_public": false,
                  "name": "\"Кастрюля\"  квадратна унікальна",
                  "palette_weight": 100,
                  "price_with_vat": 80,
                  "price_without_vat": 100500,
                  "quota": 550,
                  "stock_balance": 250,
                  "unit_id": 8,
                  "unit_weight": 1.99,
                  "user_code": 900000001,
                  "vat": 5
                }
              ]
            }
          ],
          "prods": []
        }
      ],
      "prods": []
    }
  ]
}

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