Elbuz сам забирає прайс al-style kz через API дистрибʼютора al-style.kz — дилерську й роздрібну ціну в тенге, наявність, бренд, штрихкод, гарантію, вагу, опис і всі фото товару.
Коли це знадобиться:
- Маєте ключ API з B2B-порталу Al-Style — колонки, валюта й унікальний артикул ставляться самі.
- Продаєте за роздрібною ціною Al-Style — вона приходить окремо від дилерської.
- Потрібні всі фото товару — приходять усі, а не одне.
- Завантаження триває кілька хвилин — так працює ліміт Al-Style, програма робить якомога менше запитів.
З чого почати: візьміть ключ API в B2B-порталі Al-Style.
Що вміє інтеграція з 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/, формат , колонки, унікальний артикул і завантаження фото програма підставить сама (що саме вона робить). У вікні «Налаштування параметрів доступу до API» впишіть ключ у «Пароль (токен)».
У картці «Параметри запиту» один параметр — «Тільки товари в наявності»: 1 (за замовчуванням) — прайс без товарів, яких немає на складі; 0 — увесь каталог.
1
Тільки товари в наявності- 1 — прайс без товарів, яких немає на складі; 0 — увесь каталог.
Що приходить від Al-Style
Програма складає з відповіді API CSV-файл; перший рядок — заголовок, він у товари не потрапляє. Ціни в тенге, валюта KZT ставиться за кодом.
| Колонка | Що в ній | Поле в Elbuz |
|---|---|---|
| 1, 2 | назва й код категорії Al-Style | категорія з прайсу |
| 3 | артикул Al-Style | «Артикул контрагента» з прапором «Враховувати унікальність»; за ним привʼязуються фото |
| 4 | бренд | «Виробник» |
| 5 | назва | «Найменування» |
| 7 | дилерська ціна, тенге | «Ціна» |
| 8 | роздрібна ціна, тенге | «Ціна РРЦ» |
| 9 | наявність | «Статус наявності (з прайсу)» і «Кількість» |
| 13, 14, 15 | вага, гарантія, модель | «Вага», «Гарантія», «Модель» |
| 16, 17 | посилання на товар, штрихкод | «Посилання на товар (URL)», «Штрихкод EAN» |
| 20 | опис | «Опис короткий» |
| 21 | партномер | «Артикул виробника» |
Інші колонки теж є у файлі, і будь-яку можна взяти вільним рядком секції «Колонки»:
- 6 — повна назва;
- 10 — новинка;
- 18 — уцінка;
- 22 і 23 — ціна зі знижкою та знижка;
- 24 — РРЦ Al-Style.
1
Артикул контрагента = 3, унікальність2
Ціна = 7 (price1), KZT3
Ціна РРЦ = 8 (price2), KZT- Колонка 3 — артикул Al-Style з прапором унікальності.
- Колонка 7 — дилерська ціна, тенге.
- Колонка 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)…». Програма в такому разі не затирає прайс: ціни й наявність лишаються з попереднього завантаження (загальна механіка).
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Помилка API постачальника: Al-Style categories: …» | Неправильний або застарілий ключ | Взяти новий ключ у B2B-порталі Al-Style (де взяти) |
| «Не заповнені адреси колонок… "Враховувати унікальність"» на старому джерелі | Старі версії привʼязки не ставили прапор унікальності | Поставити «Враховувати унікальність» у рядку «Артикул контрагента» (адреса 3) |
| У товарів одне фото або жодного | Старі версії брали фото однією колонкою | Завантажити прайс ще раз — з цією версією приходять усі фото |
Часті запитання
У якій валюті ціни 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.