Skip to main content

Об’єкт XPriceList

Опис параметрів обʼєкта

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

Параметр

Тип 1

Формат

Опис

 

identificationОб’єкт XPriceList

 

currency

M

stringString

Найменуваннякод вантажувалюти:

    UAH (за замовчуванням)

    EUR

    USD

    vatIncluded

    O

    int

    Ознака ціни в прайс-листі, за якою Продавець працює з Покупцем (якщо поле не передається, то за замовчуванням =1):

      0 - без ПДВ;

      1 - з ПДВ

      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

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

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

                JSON:
                {
                  "vatIncluded": "0",
                  "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": []
                    }
                  ]
                }