Elbuz підключається до акаунта OLX, забирає оголошення в базовий каталог і далі сам оновлює на OLX ціни, знімає й повертає оголошення за наявністю та публікує нові.
Коли це знадобиться:
- Товар закінчився на складі — оголошення зникає з OLX, з'явився — повертається.
- Змінили ціну в каталозі — вивантаження відправить її в оголошення.
- Оголошення вже висять на OLX — вони стають картками каталогу разом із фото й параметрами.
- Треба виставити нові товари — програма публікує оголошення й прив'язує їх до карток.
З чого почати: прив'яжіть акаунт OLX у шаблоні «OLX» вікна «Завантаження даних».
Що вміє підключення OLX
- Завантаження оголошень — назва, опис, ціна, категорія, параметри й фото лягають у картку, стан оголошення стає наявністю.
- Ціни й наявність назад — змінена ціна йде в оголошення, нульовий залишок знімає його, ненульовий — вмикає.
- Публікація — товари без оголошення виставляються на OLX з обов'язковими параметрами категорії.
- Захист правок — перемикачі «Не оновлювати» й «Фіксована ціна» в картці.
У партнерському API OLX немає замовлень — лише оголошення й повідомлення покупців. Покупець пише або телефонує вам напряму, документа майданчик не створює. Увімкнена галочка завантаження замовлень нічого не зламає: Elbuz напише в журнал, що замовлення через API не передаються.
Де це і хто має доступ
- Меню
- Операції → Завантаження даних → шаблон типу «OLX»
- Ціни, наявність, публікація
- Операції → Вивантаження даних → шаблон типу «OLX»
- Право доступу
- вікна «Завантаження» і «Вивантаження» у «Правах груп»
- Підготувати
- вхід в акаунт OLX; для публікації — ID міста й телефон
1
Кнопка «Підключити»2
Код прив’язки та «Прив’язати магазин»- «Підключити» — відкриває вхід в OLX; після дозволу доступу з’явиться код прив’язки.
- Поле «Код прив’язки» і кнопка «Прив’язати магазин» — сюди вводять код, отриманий від OLX.
Що потрібно від OLX
Реєструвати застосунок в OLX не потрібно: досить підтвердити доступ до акаунта й ввести короткий код прив'язки. Доступ OLX оновлюється щодня, і Elbuz продовжує його сам.
- «Регіон» у картці «Підключення» —
ua(Україна) абоpl(Польща). Визначає майданчик для входу й валюту оголошень: гривня чи злотий. - Прив'язка одна на акаунт: підключили OLX у шаблоні завантаження — шаблон вивантаження працює з тим самим доступом, і навпаки. Кнопка «Підключити» й поле коду є в обох.
- Місто й телефон потрібні лише публікації й задаються в шаблоні вивантаження (публікація).
Як підключити крок за кроком
- Створіть шаблон типу «OLX» і збережіть його — прив'язка працює для збереженого шаблону.
- Впишіть у поле «Регіон» ua або pl.
- Натисніть «Підключити», підтвердіть доступ в OLX і одразу вставте код прив'язки — він живе недовго.
- Натисніть «Перевірити підключення»: у відповіді мають бути майданчик і назва акаунта.
- Запустіть завантаження вручну й перевірте, що оголошення лягли в каталог із цінами, описами й фото.
- Поставте шаблон на розклад, а ціни й наявність налаштуйте окремим шаблоном вивантаження.
Що переноситься в картку
| Дані OLX | Поле товару в Elbuz |
|---|---|
| заголовок оголошення | Назва |
| опис | Опис |
| ціна | Ціна |
| стан оголошення | Статус і наявність |
| категорія OLX | Категорія |
| параметри оголошення | Характеристики |
| фотографії | Фотографії (якщо ввімкнено галочку) |
В OLX у товару немає кількості: оголошення активне або зняте. Активне дає залишок 1, зняте — 0. У зворотний бік так само: залишок більший за нуль активує оголошення, нуль — знімає.
Характеристики з оголошення приходять зі службовим кодом параметра OLX замість людської назви. Це не помилка: за цими кодами програма шукає обов'язкові параметри категорії під час публікації.
Категорії, які створює завантаження
Завантаження питає в OLX назву категорії оголошення й шукає у вас категорію з такою самою назвою, а не знайшовши — створює. Це одна назва, а не повний шлях дерева OLX. Загальний порядок — службові категорії й бренди.
Оголошення без категорії лягає в службову «Товари - olx» — вимкнену й без «Вивантажувати у файл (на сайт)». Доки товар лежить тільки в ній, вивантаження його не бере: ціна й наявність на OLX не оновлюються, і в журналі про нього нічого немає. Перекладіть картку у свою категорію або ввімкніть службовій вивантаження.
- Переносити картки можна: повторне завантаження місця в дереві не змінює, а зв'язок з оголошенням живе окремо — у бічній панелі товару рядок «ID olx #…».
- Зіставлення з категорією OLX зберігається у вашій категорії. Перенесли товар у категорію без зіставлення — нові оголошення для нього не публікуються; вже створені оновлюються далі.
- Характеристики видаляти можна, але з них збираються обов'язкові параметри: товар без потрібної перестане публікуватися.
Що робить повторне завантаження з вашими правками
Повторний прогін шукає картку за назвою: артикула оголошення OLX не віддає, а номер оголошення для пошуку не використовується. Ключ рахується один раз, під час створення картки.
- Перейменували товар у Elbuz — картка знайдеться за початковою назвою, і прогін мовчки поверне їй заголовок оголошення.
- Змінили заголовок у кабінеті OLX — прогін заведе поруч другу картку, стара лишиться з останніми даними.
Правка заголовків уже завантажених оголошень у кабінеті OLX дає дублі. Прив'язку до оголошення мають обидві картки, тож вивантаження обробить оголошення двічі, і втримається остання записана ціна. Зайву картку прибирайте одразу.
| Поле картки | Що робить прогін |
|---|---|
| Назва, опис, ціна, кількість, «увімкнено/вимкнено», повна назва категорії | перезаписує з оголошення |
| Внутрішній артикул, штрихкод, теги, стара ціна | не чіпає — цих полів в оголошенні немає |
| Фото й характеристики | додає лише в момент створення картки |
| Місце в дереві категорій | не змінює |
Закріпити картку цілком — перемикач «Не оновлювати» в секції «Захист під час імпорту»; у сітці «Товари» це колонка «Не оновлювати (прапор)». Тільки ціну — «Фіксована ціна»: назву, опис і наявність прогін далі бере з оголошення. «Не оновлювати» закриває картку від усіх завантажень, не лише від OLX. Загальні правила — як закріпити своє значення.
1
Не оновлювати2
Фіксована ціна- Не оновлювати — завантаження OLX пропускає картку повністю.
- Фіксована ціна — ціну з оголошення завантаження не запише.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Чия ціна виграє
- Правила націнки картку з OLX пропускають: вони рахують ціну від закупівельної, а в оголошенні її немає. Ціна з оголошення перемагає.
- Закупівельна ціна прийшла з іншого джерела (наприклад, картку знайшов прайс постачальника) — наступна націнка перерахує ціну від неї. Втримати ціну оголошення допоможе «Фіксована ціна»: націнка пропускає товари з нею і з «Не оновлювати».
- Два джерела на одну картку — пошук іде за назвою, тож у полі лишається значення прогону, що завершився останнім. Артикул, штрихкод, теги й стару ціну, записані іншим джерелом, OLX не затирає. Характеристик наявної картки OLX не чіпає взагалі.
Як оновлювати ціни й наявність на OLX
Зворотний напрямок — окремий шаблон вивантаження типу «OLX». По кожному прив'язаному оголошенню Elbuz робить дві речі:
- Ціна — читає оголошення й, якщо ціна змінилася, відправляє оголошення цілком: OLX приймає його лише повністю, тож решта переноситься без змін.
- Наявність — вмикає або знімає оголошення за залишком.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Журнал пише «OLX: оброблено оголошень: …» кожні 50 оголошень і наприкінці «OLX: ціни та наявність оновлено, оголошень: … (помилок: …)». Помилки тут — лише відмови на зміні ціни; число оголошень показує, скільки їх перебрано, а не змінено.
Відмови на вмиканні чи знятті зібрані в помаранчевий рядок «OLX: майданчик відхилив команди активації/деактивації: …» з кількістю й першою відмовою (товар, команда, причина). Часто це лише означає, що оголошення вже було в потрібному стані.
Ціна не відправляється, коли вона нульова або коли оголошення не вдалося прочитати — тоді прогін іде далі без запису в журнал, а команда вмикання чи зняття виконується однаково.
Як публікувати нові оголошення
Публікацію вмикає позначка «Публікувати нові товари» в шаблоні вивантаження. Без неї товари без прив'язки мовчки пропускаються. Вимоги OLX до оголошення:
| Вимога OLX | Що це означає для каталогу |
|---|---|
| Заголовок від 16 до 150 символів | Надто коротку назву Elbuz добиває до мінімуму сам — дописує номер категорії й крапки, тож такий заголовок краще виправити в картці. Довший за 150 символів обрізається |
| Опис від 80 символів | Товар із коротким описом пропускається, про це буде запис у журналі. Опис береться з картки без розмітки й обрізається на 9000 символах |
| Кінцева категорія OLX | Має бути зіставлена для категорії товару, інакше пропуск |
| Обов'язкові параметри категорії | Беруться з характеристик товару за назвою; якщо чогось бракує — пропуск із переліком у журналі |
| Місто й телефон | Вписуються в шаблоні вивантаження в поле «Версія API (параметри майданчика)» одним рядком: регіон, ID міста, телефон через вертикальну риску — наприклад ua|1|380501234567 |
Без міста чи телефону журнал пише «OLX: не вказано ID міста (city_id) або телефон — публікація неможлива. Заповніть їх у шаблоні», і нових оголошень не буде. Ціни й наявність прив'язаних оголошень при цьому оновлюються як звичайно.
По кожному товару програма питає в OLX обов'язкові параметри категорії, збирає оголошення — заголовок, опис, ціну у валюті регіону, до восьми фото — і відправляє. Отримавши номер, одразу записує зв'язок «товар — оголошення» і ставить товару позначку «Вивантажено».
- Рядок на кожне оголошення: «OLX: опубліковано оголошення «назва» (ID …)».
- Наприкінці — скільки опубліковано, пропущено й чекає платного пакета.
- Нові оголошення проходять модерацію OLX.
- Початок або кінець
- Розвилка: далі шлях залежить від відповіді
Коли ліміт безкоштовних оголошень вичерпано, OLX приймає оголошення як «обмежене»: створене, але не показується без пакета. Elbuz такі оголошення не оплачує — прив'язує до товару й пише рядок «OLX: «назва» створено, але потребує платного пакета…» з порадою активувати його в кабінеті OLX.
Обов'язкові параметри: як їх заповнити
Це найчастіша причина, чому оголошення не публікуються. У кожної кінцевої категорії OLX свій набір обов'язкових параметрів — стан, розмір, марка тощо. Elbuz бере їх з характеристик товару за назвою або кодом параметра, а для списків підбирає варіант зі списку. Бракує характеристики — оголошення пропускається, журнал перелічує до восьми відсутніх назв.
Почніть з однієї категорії: опублікуйте кілька товарів, подивіться в журналі, які параметри вимагає OLX, і заведіть ці характеристики з такими самими назвами. Далі категорія публікуватиметься без пропусків.
Розклад і обсяг прогону
Шаблони завантаження й вивантаження ставлять на розклад окремо — як працює розклад API-джерел.
- Стелі немає. Завантаження забирає оголошення сторінками по 100 і пише в каталог пачками по 500. Вивантаження бере всі товари, що пройшли відбір шаблону; у демонстраційному акаунті — не більше 100 за прогін.
- Звернення до майданчика: у вивантаженні до трьох на оголошення (прочитати, записати ціну, якщо змінилася, увімкнути чи зняти); на публікацію товару — два; у завантаженні — одне на сторінку плюс одне на кожну нову категорію.
- Очікування: до 120 секунд на звернення, 30 на з'єднання. На «забагато запитів» — до трьох спроб із паузами дві, чотири й шість секунд; далі завантаження зупиняється з помилкою.
- Зупинка з журналу: завантаження дочитує й записує поточну сторінку; вивантаження й публікація її не перевіряють і йдуть до кінця списку.
Журнал ведеться в Центрі операцій, вікно можна закрити.
Сценарії
Оголошення OLX мають лежати в каталозі разом з іншими товарами
Налаштування: шаблон завантаження «OLX», акаунт прив'язано, у виборі даних увімкнено «Товари» і, якщо потрібні знімки, «Фото».
Що вийде: кожне оголошення стає карткою, активне — із залишком 1, зняте — з 0. Кожен прогін повертає назву, опис і ціну з оголошення. Пізніші зміни фото в оголошенні в уже заведену картку не потраплять.
Товар закінчився на складі — оголошення має зникнути з OLX
Налаштування: шаблон вивантаження «OLX» з галочкою «Товари», «Публікувати нові товари» вимкнено.
Що вийде: залишок більший за нуль вмикає оголошення, нуль знімає. Ціна йде, лише коли вона більша за нуль і відрізняється від оголошення. Товари без прив'язки пропускаються, видаляти оголошення прогін не вміє — тільки знімати.
Ціни й описи ведете в Elbuz, і завантаження не повинно їх затирати
Налаштування: «Не оновлювати» в секції «Захист під час імпорту» картки; для ціни на OLX — шаблон вивантаження з галочкою «Товари».
Що вийде: завантаження OLX картку не переписує, а вивантаження відправить в оголошення вашу ціну. Закріпити лише ціну — «Фіксована ціна».
Що робити, коли OLX працює не так
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| Прив'язка не спрацювала | Код прив'язки живе недовго | Отримайте код заново й вставте одразу (як підключити) |
| «OLX: майданчик відхилив команди активації/деактивації: …» | Найчастіше оголошення вже в потрібному стані; інакше — модерація чи ліміт | Подивіться першу відмову в рядку; модерацію й ліміт розбирайте в кабінеті OLX |
| Ціна на OLX не оновилася | Ціна збігається з оголошенням, нульова або оголошення не прочиталося | Перевірте ціну в картці (ціни й наявність) |
| Товар ніяк не потрапляє у вивантаження | Лежить тільки в службовій «Товари - olx» без вивантаження | Перекладіть у свою категорію (категорії) |
| Оголошення не публікується | Короткий опис, не зіставлена категорія, бракує параметрів або міста й телефону | Дивіться рядок журналу з назвою товару (вимоги OLX) |
| У каталозі дві картки одного оголошення | Заголовок змінили в кабінеті OLX після завантаження | Видаліть зайву картку (повторне завантаження) |
| Прогін обірвався з помилкою | OLX відповів помилкою або «забагато запитів» тричі поспіль | Запустіть ще раз (обрив прогону) |
Якщо прогін обірвався посередині
Загальні правила — в огляді. Специфіка OLX:
- Завантаження на помилці OLX дописує в каталог усе прочитане, навіть неповну пачку. Старими лишаються оголошення, до яких черга не дійшла. Повтор безпечний, доки заголовки в кабінеті OLX не змінювали.
- Публікація записує прив'язку на кожну відповідь OLX із номером, тож повтор дожене решту й не опублікує прив'язане вдруге.
- Обрив у мить відправлення — оголошення на OLX може вже існувати без прив'язки в Elbuz, і наступний прогін опублікує його ще раз. Відповідь із помилкою дає червоний рядок «OLX: помилка публікації оголошення» з причиною; товар піде на наступну спробу.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Якщо запустили не те
- Знайдіть опубліковане. Журнал прогону (минулі — кнопка «Історія запусків» у шапці шаблону) має рядок на кожне оголошення. У картці товару — рядок «ID olx #…» і кнопка «На сайті», що веде на оголошення; посилання є лише в оголошень, створених Elbuz.
- Зніміть оголошення нульовим залишком і повторіть вивантаження. Видаляти оголошення Elbuz не вміє — це робиться в кабінеті OLX.
- Ціни на OLX виправте в каталозі й запустіть вивантаження ще раз — піде лише змінене, текст, фото й параметри не постраждають.
- Ціни в каталозі після помилкового завантаження масово не повернути. Зачеплене видно за «Датою оновлення», створене — за «Джерело: назва», попередню ціну — в «Історії ціни товару», якщо її ведення ввімкнене (загальний порядок відкату).
Видалити товар у Elbuz — не те саме, що прибрати оголошення. Разом із карткою зникає прив'язка, а оголошення на OLX лишається, і керувати ним уже нічим. Заведете товар знову з «Публікувати нові товари» — з'явиться друге оголошення. Спершу зніміть оголошення нульовим залишком, потім видаляйте картки.
Часті запитання
Чому з OLX не приходять замовлення?
Їх немає в API OLX: покупець зв'язується з продавцем напряму, документа майданчик не створює. Elbuz керує оголошеннями, цінами й наявністю.
Як передається наявність, якщо в оголошенні немає кількості?
Через видимість: залишок більший за нуль — оголошення активне, нуль — зняте. Назад активне оголошення приходить із залишком 1, зняте — з нулем.
Що означає «обмежене» оголошення?
Вичерпано ліміт безкоштовних публікацій: оголошення створене, але не показується, доки не куплено пакет у кабінеті OLX. Elbuz пакети не купує, лише повідомляє в журналі.
Що обрати в полі «Регіон»?
ua для України, pl для Польщі — від цього залежать майданчик і валюта. Регіон має відповідати країні підключеного акаунта OLX.
Як зняти оголошення, опубліковані помилково?
Поставте товарам нульовий залишок і повторіть вивантаження. Видаляти оголошення доведеться в кабінеті OLX (порядок дій).
Чи можна підключити два акаунти OLX?
Ні: прив'язка одна на обліковий запис Elbuz, і всі шаблони OLX працюють з тим самим акаунтом.
Суміжні теми
- Якщо потрібна загальна картина API-підключень — завантаження каталогу через API.
- Якщо імпорт затирає ваші правки й треба зрозуміти чому — огляд завантаження даних.
- Якщо поряд з OLX продаєте на Prom — замовлення з Prom.ua.