Функція 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\" не может совпадать с артикулом существующего товара" } ] } ] } }
0 Comments