Імпорт комплектів товарів

Функція productSet/import (http://<DOMAIN>/api/productSet/import/)

Параметри:

  • token - ключ авторизації отриманий через функцію auth
  • items[] - список комплектів
    • items[i].article - артикул комплекту (обов'язковий параметр). Повинен бути унікальним у межах комплектів і товарів
    • items[i].title - назва комплекту. За замовчуванням - "Разом дешевше"
    • items[i].discountPercent - відносна знижка на комплект відносно початкової вартості
    • items[i].initialPrice - початкова вартість комплекту. Якщо не задана, то підсумовується вартість усіх товарів комплекту
    • items[i].discountedPrice - вартість комплекту з урахуванням знижки. Якщо не задана, то буде розрахована автоматично щодо параметрів "initialPrice" і "discountPercent"
    • items[i].currency - ISO код валюти комплекту
    • items[i].enabled - увімкнення комплекту (boolean)
    • items[i].sortOrder - порядок відображення комплекту. Чим нижче значення, тим вищий пріоритет
    • items[i].products[] - список артикулів товарів, які формують комплект. Не менше двох і, за замовчуванням, не більше п'яти товарів (налаштування можна змінити)
      • items[i].products[n] - артикул товару в комплекті


Відповідь:

  • status - статус виконання функції
    • OK - усі комплекти товарів успішно додано/оновлено
    • WARNING - один або кілька комплектів товарів не були додані/оновлені
  • response.log - журнал виконання функції за кожним записом
    • response.log[i].article - артикул комплекту
    • response.log[i]['info'][n].code - статус оновлення запису (див. таблицю кодів нижче)
    • response.log[i]['info'][n].message - пояснення до коду


Коди журналу імпорту комплектів

КодОпис
0Комплект імпортований
1Параметр "discountPercent" має бути цілим числом у межах від 0 до 100
2Параметр "initialPrice" має бути дробним числом, вищим за 0
3Параметр "discountedPrice" має бути дробним числом, вищим за 0
4

Кількість товарів у комплекті має бути в межах від 2 до "максимально допустимої кількості налаштованого на сайті"

5Товари в комплекті не можуть повторюватись
101Параметр "article" обовʼязковий до заповнення
102Артикул комплекту не може повторювати артикул існуючого товару
103Параметр "products" обовʼязковий до заповнення
104Товар з визначеним артикулом не знайдений
105Для одного з товарів комплекту не вказаний артикул
106Валюта не знайдена
400«The payload is not JSON». Запит складений невірно
1000Один з товарів має некоректний тип обʼєкту
2000Невідома помилка

Приклад запиту на адресу (http://<DOMAIN>/api/productSet/import/)

Пример запроса на адрес (http://<DOMAIN>/api/productSet/import/):
{  
    "token": "24a75d0678c49a34030e35baeb376ff3",
    "items":[  
        {  
            "article":"PRODUCT_SET_ARTICLE",
            "title":"PRODUCT_SET_TITLE",
            "discountPercent":5,
            "initialPrice":150,
            "discountedPrice":100,
            "currency":"UAH",
            "enabled":true,
            "sortOrder":1,
            "products":[  
                "2317217",
                "MB829",
                "MD810"
            ]
        },
        {  
            "article":"2317217",
            "title":"PRODUCT_SET_TITLE",
            "discountPercent":5,
            "initialPrice":150,
            "discountedPrice":100,
            "currency":"USD",
            "enabled":false,
            "sortOrder":2,
            "products":[  
                "2317217",
                "MB829",
                "MD810",
                "MGR32",
                "MGTR2",
                "MD565"
            ]
        }
    ]
}

Приклад відповіді на запит

{  
    "status":"WARNING",
    "response":{  
        "log":[  
            {  
                "article":"PRODUCT_SET_ARTICLE",
                "info":[  
                    {  
                        "code":0,
                        "message":"Комплект обновлён"
                    }
                ]
            },
            {  
                "article":"2317217",
                "info":[  
                    {  
                        "code":102,
                        "message":"Артикул комплекта \"2317217\" не может совпадать с артикулом существующего товара"
                    }
                ]
            }
        ]
    }
}