Як підключити Al-Style за API: дві ціни в тенге, всі фото й ліміт запитів

Що вміє інтеграція з Al-Style

• Прайс без ручної розмітки — артикул, партномер, бренд, назва, категорія, дилерська й роздрібна ціна в тенге, наявність, штрихкод, гарантія, вага, опис і посилання на товар.
• Усі фото товару — не одне, а всі, що є в Al-Style.
• Тільки наявне або весь каталог — одним параметром.
• Завантаження в межах ліміту Al-Style — увесь каталог мінімумом запитів.

Загальна механіка готових інтеграцій — майстер, вікно параметрів доступу, розмітка колонок — у статті Як підключити постачальника за API. Тут тільки те, що стосується Al-Style.

Де це і хто має доступ

Меню

Довідники → Обробка прайс-листів → Список прайс-листів

Нове джерело

майстер нового джерела, крок «Звідки» → плитка «API» → «Al-Style»

Ключ і параметри

картка джерела, секція «Джерело» → «Налаштування параметрів API»

Право доступу

вікно «Список прайс-листів» плюс «Налаштування завантаження» і «…файл із прайс-листом»

Підготувати

ключ API (access-token) з B2B-порталу Al-Style

Де взяти ключ API Al-Style

Потрібен ключ API — access-token. Його видає B2B-портал Al-Style у розділі про API, після реєстрації дилером. Ключ вписується в «Пароль (токен)» вікна параметрів API; поле «Логін» для Al-Style не використовується.

Які параметри запиту Al-Style змінити

У майстрі нового джерела на кроці «Звідки» оберіть плитку «API» і «Al-Style» у списку. Адресу https://api.al-style.kz/api/, формат CSV, колонки, унікальний артикул і завантаження фото програма підставить сама (що саме вона робить). У вікні «Налаштування параметрів доступу до API» впишіть ключ у «Пароль (токен)».

У картці «Параметри запиту» один параметр — «Тільки товари в наявності»: 1 (за замовчуванням) — прайс без товарів, яких немає на складі; 0 — увесь каталог.

1

Тільки товари в наявності

1. 1 — прайс без товарів, яких немає на складі; 0 — увесь каталог.

Що приходить від Al-Style

Програма складає з відповіді API CSV-файл; перший рядок — заголовок, він у товари не потрапляє. Ціни в тенге, валюта KZT ставиться за кодом.

Інші колонки теж є у файлі, і будь-яку можна взяти вільним рядком секції «Колонки»:

• 6 — повна назва;
• 10 — новинка;
• 18 — уцінка;
• 22 і 23 — ціна зі знижкою та знижка;
• 24 — РРЦ Al-Style.

1

Артикул контрагента = 3, унікальність

2

Ціна = 7 (price1), KZT

3

Ціна РРЦ = 8 (price2), KZT

1. Колонка 3 — артикул Al-Style з прапором унікальності.
2. Колонка 7 — дилерська ціна, тенге.
3. Колонка 8 — роздрібна ціна, тенге.

Чому завантаження триває кілька хвилин

Al-Style дозволяє один запит до API раз на 5 секунд, а за запит віддає до 250 товарів. Програма спершу просить увесь каталог одним списком — це десятки запитів. Якщо сервіс віддає товари тільки по категоріях, програма сама переходить на обхід категорій, і тоді завантаження триває довше.

З тієї ж причини характеристики не завантажуються: Al-Style віддає їх тільки по одному товару, і для всього каталогу це години.

Як читається наявність Al-Style

Привʼязка бере наявність і кількість з колонки 9. Стандартні статуси розпізнають число від 1 як «В наявності», а позначки виду «>50» — як «В наявності» з кількістю 50 (наявність товару в прайсі постачальника).

Сценарії

Продавати за роздрібною ціною Al-Style

Що зробити. Нічого: роздрібна ціна вже стоїть у рядку «Ціна РРЦ» (колонка 8). Якщо ваша націнка рахується від РРЦ, налаштуйте її у вкладці «Націнка/Знижка» джерела.

Що вийде. На сайт іде ціна, близька до рекомендованої Al-Style, а дилерська ціна (колонка 7) лишається для розрахунку прибутку.

Показувати на сайті весь каталог, а не тільки наявне

Що зробити. У параметрах API поставте «Тільки товари в наявності» = 0.

Що вийде. У прайс потраплять і товари, яких зараз немає на складі Al-Style; стандартні статуси позначать їх як відсутні. Завантаження триватиме довше: товарів більше, а ліміт запитів той самий.

Оновлювати ціни щодня вночі

Що зробити. У розкладі джерела Al-Style задайте щоденне завантаження в нічний час (імпорт і розклад).

Що вийде. Через ліміт Al-Style завантаження триває кілька хвилин, і вночі воно не заважає роботі з каталогом.

Що робити, коли прайс Al-Style не приїхав

Чому прайс не оновився

Якщо ключ неправильний, Al-Style відмовляє, і в журналі зʼявиться «Помилка API постачальника: Al-Style categories: …» або «Al-Style elements: …» з текстом Al-Style. Якщо ключ не вписаний — «Al-Style: впишіть ключ API (access-token)…». Програма в такому разі не затирає прайс: ціни й наявність лишаються з попереднього завантаження (загальна механіка).

Часті запитання

У якій валюті ціни Al-Style?

У тенге. Привʼязка ставить валюту KZT за кодом для дилерської й роздрібної ціни.

Чи можна прискорити завантаження Al-Style?

Ні: ліміт задає Al-Style — один запит раз на 5 секунд. Залиште «Тільки товари в наявності» = 1 — товарів і запитів буде менше.

Чи можна завантажити характеристики з Al-Style?

Ні. Al-Style віддає їх тільки по одному товару, і з його лімітом це години для каталогу (чому).

Чому в прайсі Al-Style немає товарів, яких немає на складі?

Так задає «Тільки товари в наявності» = 1. Поставте 0, щоб отримувати увесь каталог; завантаження триватиме довше.

Чи можна відправити замовлення в Al-Style з Elbuz?

Ні. API Al-Style замовлень не приймає, замовлення оформлюють у B2B-порталі.

Суміжні теми

• Якщо потрібна загальна картина готових інтеграцій і вікна параметрів — Як підключити постачальника за API.
• Якщо прайс завантажився і треба налаштувати розклад та імпорт — імпорт прайсу.
• Якщо позначки «>50» треба читати інакше — наявність товару в прайсі постачальника.
• Якщо потрібні ще й характеристики від дистрибʼютора Казахстану — Як підключити прайс Comportal.