Оголошення OLX: завантаження й керування з Elbuz

36 хв

OLX — найбільший майданчик оголошень України й Польщі. Він влаштований інакше, ніж маркетплейс: тут немає спільних карток товарів і немає кошика — є оголошення, і покупець звертається до продавця напряму. Elbuz підключається до акаунта OLX, забирає оголошення в базовий каталог і керує ними: оновлює ціни, вмикає й вимикає за наявністю, публікує нові.

Загальний порядок для всіх API-джерел каталогу описано в огляді імпорту каталогу через API. Тут — про OLX і його особливості, яких досить багато.

Це головне, що варто зрозуміти до налаштування. У партнерському API OLX немає замовлень — є тільки оголошення й повідомлення покупців. Покупець пише або телефонує вам напряму, і жодного документа майданчик не створює. Тому підключення OLX в Elbuz — це керування вітриною, а не приймання замовлень. Якщо ввімкнути галочку завантаження замовлень, Elbuz не зламається: він просто напише в журнал, що замовлення через API не передаються, і піде далі.

Де це у програмі

У вікні завантаження створіть шаблон і оберіть тип «OLX». Файл не потрібен: підключення відбувається прив'язкою акаунта.

Картка «Підключення» форми налаштування шаблону OLX
1Регіон: ua або pl
2ID міста — для публікації
3Телефон для оголошень
  1. Регіон — вкажіть ua (Україна) або pl (Польща) залежно від акаунта OLX.
  2. ID міста (city_id) потрібен для публікації оголошень.
  3. Телефон для оголошень — контакт, який побачать покупці.

Як підключити: код прив'язки

Реєструвати застосунок в OLX не потрібно. У формі шаблону є картка встановлення застосунку: натискаєте «Підключити», підтверджуєте доступ до свого акаунта OLX і вводите короткий код прив'язки. Далі доступ продовжується автоматично — і це принципово саме для OLX, бо його доступ оновлюється щодня, і робити це руками означало б починати кожен ранок з налаштувань.

У картці «Підключення» три поля:

ПолеНавіщо
Регіонua (Україна) або pl (Польща). Визначає і майданчик, і валюту оголошень: гривня чи злотий
ID містаМісто, в якому публікуються оголошення. На завантаження не впливає ніяк: саму публікацію веде шаблон вивантаження і місто читає звідти
ТелефонКонтакт в оголошенні. Так само потрібен лише публікації й так само береться з шаблона вивантаження

Кнопка «Перевірити підключення» у відповідь покаже майданчик і назву вашого акаунта.

Як підключити крок за кроком

Створіть шаблон типу «OLX» і збережіть його — прив'язка працює вже для збереженого шаблону. Оберіть регіон, натисніть «Підключити», підтвердіть доступ до свого акаунта OLX і вставте у форму короткий код прив'язки. Перевірте результат кнопкою «Перевірити підключення»: у відповіді має бути майданчик і назва акаунта.

Якщо ви плануєте не лише забирати оголошення, а й публікувати нові, подбайте про місто й телефон у шаблоні вивантаження: у картці підключення там є поле «Версія API (параметри майданчика)», куди вони вписуються одним рядком. Без них публікація не почнеться, і про це буде рядок у журналі (докладніше — у розділі «Публікація нових оголошень»). Запустіть завантаження вручну й подивіться, що приїхало: оголошення мають лягти в каталог із цінами, описами й фотографіями. Далі поставте шаблон на розклад, а керування цінами й наявністю налаштуйте окремим шаблоном вивантаження.

Що приходить у каталог

Дані OLXПоле товару в Elbuz
заголовок оголошенняНазва
описОпис
цінаЦіна
стан оголошенняСтатус і наявність
категорія OLXКатегорія
параметри оголошенняХарактеристики
фотографіїФотографії (якщо ввімкнено галочку)

В OLX у товару немає кількості: оголошення або активне, або зняте. Тому Elbuz працює за простим правилом: активне оголошення — залишок 1, зняте — 0. У зворотний бік правило дзеркальне: якщо у вашому каталозі залишок більший за нуль, Elbuz активує оголошення, якщо нуль — знімає його. Саме так наявність з вашого складу перетворюється на видимість оголошення для покупців.

Що робить повторне завантаження з вашими правками

Повторний прогін шукає вже заведену картку за назвою. Іншого ключа немає: артикула виробника оголошення OLX не віддає, а номер оголошення при пошуку картки не використовується. Ключ рахується один раз, у момент створення картки, і далі не перераховується — звідси дві несиметричні ситуації.

Якщо ви перейменували товар у Elbuz, картка все одно знайдеться: пошук іде за тією назвою, під якою вона колись створилася. Наступний прогін поверне в неї заголовок оголошення, і жодного попередження при цьому не буде. Якщо ж заголовок змінили в кабінеті OLX, прогін цю картку не впізнає й заведе поруч другу, а стара лишиться з останніми відомими даними.

Правити заголовки оголошень в кабінеті OLX після того, як вони вже завантажені, — найдешевший спосіб отримати дублі в каталозі. Пошук за назвою більше не спрацьовує, і наступне завантаження заводить ще одну картку на той самий товар. Прив'язку до оголошення при цьому мають обидві картки: у вивантаженні одне й те саме оголошення оброблятиметься двічі, і в ньому втримається та ціна, яку записали останньою. Тому зайву картку варто прибрати одразу, а не відкладати.

Що прогін перезаписує у знайденій картці: назву, опис, ціну, кількість і ознаку «увімкнено/вимкнено» (обидві — за станом оголошення), а також повну назву категорії. Полів, яких в оголошенні OLX узагалі немає, — внутрішнього артикула, штрихкоду, тегів і старої ціни — прогін не чіпає: порожнє значення з оголошення не затирає те, що вже заповнено в картці.

Чого повторне завантаження не чіпає: фотографії й характеристики вже заведених карток — і те, й інше додається тільки в момент створення картки; і місце товару у вашому дереві категорій.

Закріпити картку цілком можна одним перемикачем — «Не оновлювати» в секції «Захист під час імпорту» картки товару; у сітці «Товари» це колонка «Не оновлювати (прапор)», за якою зручно і фільтрувати, і проставляти позначку прямо в сітці. Картка з нею прогоном не переписується взагалі: ні назва, ні опис, ні ціна, ні наявність. Якщо закріпити треба тільки ціну, вистачить сусіднього перемикача «Фіксована ціна»: ціну завантаження тоді не чіпає, а назву, опис і наявність бере з оголошення. Загальні правила захисту карток описані в огляді API-завантаження каталогу.

Секція «Захист під час імпорту» в картці товару
1Не оновлювати
2Фіксована ціна
  1. Не оновлювати — завантаження OLX пропускає картку повністю.
  2. Фіксована ціна — ціну з оголошення завантаження не запише.
нітакнітактакніОголошення з OLXУ каталозі є картказ такою назвою?Нова картказ характеристикамиГалочка «Фото»увімкнена?Фото з оголошеннядодаються до карткиКартка без фотоУ картці увімкнено«Не оновлювати»?Картка не змінюєтьсяПерезапис назви, описуй наявності, ціни — якщоне«Фіксована ціна»Фото й характеристикилишаються як були
Що повторне завантаження робить з однією карткою: ліва гілка — картка створюється вперше, і тільки тоді до неї потрапляють фото й характеристики. Права — картка вже є, і все вирішує перемикач «Не оновлювати».

Чия ціна виграє

У картці, заведеній з OLX, перемагає ціна з оголошення — і правила націнки цього не змінять. Правило націнки рахує продажну ціну від закупівельної, а в оголошенні OLX закупівельної ціни немає й узятися їй нема звідки. Товар без закупівельної ціни правило пропускає, скільки б разів ви його не запускали.

Зворотний випадок теж варто знати. Якщо закупівельна ціна в картці з'явилася з іншого боку — наприклад, картку знайшов прайс постачальника, — то наступний запуск націнки перерахує ціну від неї, і ціна з оголошення в картці не втримається. Врятує від цього той самий перемикач «Фіксована ціна»: правила націнки пропускають товари з ним, а також товари з позначкою «Не оновлювати».

Друга розвилка — два джерела на одну картку. Пошук іде за назвою, а не за майданчиком, тож картку з тим самим заголовком можуть писати й OLX, і інше підключення; у полі лишається значення того прогону, який завершився останнім (докладно — в огляді API-завантаження). Полів, яких в оголошенні немає, — артикула, штрихкоду, тегів, старої ціни — OLX не затирає: що записало туди сусіднє джерело, те й лишиться. Ціну від обох джерел закріплює «Фіксована ціна», а картку цілком — позначка «Не оновлювати», але вона закриває картку від усіх завантажень одразу, не лише від OLX.

А от характеристику, яку пишуть два джерела, ділити не доведеться: у вже наявної картки завантаження OLX характеристик не чіпає взагалі — воно додає їх лише тим карткам, які саме створює. Значення, записане іншим джерелом або руками, лишається як було.

І дрібниця, яка спантеличує при першому погляді в картку: характеристики з оголошення приходять зі службовим кодом параметра OLX замість людської назви. Це не помилка — саме за цими кодами програма потім шукає обов'язкові параметри категорії, коли публікує нові оголошення.

Категорії, які створює завантаження

Категорію товару завантаження бере з оголошення: воно питає в OLX назву категорії й шукає у вас категорію з такою самою назвою, а не знайшовши — створює нову. Це одна назва, а не повний шлях дерева OLX.

Якщо категорії в оголошенні немає, товар лягає в службову категорію «Товари - olx». Вона створюється вимкненою й без ознаки «Вивантажувати у файл (на сайт)», і в цього є практичний наслідок: доки товар лежить тільки в ній, зворотне вивантаження його не бере — ціна й наявність такого товару в OLX не оновлюватимуться, і в журналі про нього нічого не буде. Щоб він потрапив у вивантаження, перекладіть картку у свою категорію або ввімкніть службову й дозвольте їй вивантаження.

Переносити картки з такої категорії можна вільно: місце товару в дереві повторне завантаження не змінює. Зв'язок картки з оголошенням від переносу теж не рветься — він живе окремим рядком прив'язки, а не в категорії й не в характеристиках. У бічній панелі відомостей товару цей рядок видно як «ID olx #…» з номером оголошення.

Одне «але». Зіставлення з категорією OLX, без якого не публікуються нові оголошення, зберігається саме у вашій категорії. Перенесли товар у категорію, якій категорію OLX не зіставлено, — публікувати нові оголошення для нього прогін перестане й порахує його серед пропущених. На вже створені оголошення це не впливає: їхні ціна й наявність оновлюються по прив'язці.

Характеристики теж можна видаляти — зв'язок оголошення вони не тримають. Але з них збираються обов'язкові параметри категорії при публікації, тож видалена характеристика відгукнеться саме там: товар перестане публікуватися й потрапить у рядок журналу про брак обов'язкових полів.

Ціни й наявність назад в OLX

Зворотний напрямок — окремий шаблон вивантаження типу «OLX». По кожному пов'язаному оголошенню Elbuz робить дві речі. Ціна: читає оголошення, порівнює з вашою ціною і, якщо вона змінилася, відправляє оголошення назад цілком — OLX приймає оголошення повністю, а не частинами, тому Elbuz дбайливо переносить усе інше без змін. Наявність: вмикає або знімає оголошення за залишком.

нітакнітактактактакнінінітакніТовар пройшов відбіршаблонуЄ прив'язкадо оголошення?«Публікувати новітовари» увімкнено?У чергу публікаціїПропуск без рядка вжурналіЦіна товарубільша за нуль?Оголошеннявдалося прочитати?Ціна в оголошенніінша?Оголошеннявідправляєтьсяз новою ціноюЗалишокбільший за нуль?Команда вмиканняКоманда зняття
Шлях одного товару у вивантаженні. Ціна проходить три перевірки й може тихо не відправитися, а команда вмикання чи зняття йде по кожному прив'язаному оголошенню в будь-якому разі.

У журналі кожні 50 оброблених оголошень з'являється рядок «OLX: оброблено оголошень: …», а наприкінці — підсумок «OLX: ціни та наявність оновлено, оголошень: … (помилок: …)». У числі помилок рахуються лише відмови на зміні ціни. Якщо 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.

нітакнітакнітакнітакнітакТовари без прив'язкиУ шаблоні вказаноID міста й телефон?Рядок у журналіжодного оголошенняКатегорії товарузіставлено категорію OLX?Пропусквидно лише в підсумкуОпис від80 символів?Пропускрядок у журналіЄ всі обов'язковіпараметри категорії?Пропускперелік у журналіOLX прийнявоголошення?Червоний рядоктовар без прив'язкиПрив'язка й«Вивантажено»обмежене чекає пакета
Перша перевірка — місто й телефон — зупиняє публікацію для всіх товарів одразу. Решта перевірок діють на кожен товар окремо, і пропуск через незіставлену категорію видно лише в підсумковому рядку.

Кількість безкоштовних оголошень в OLX обмежена, і коли ліміт вичерпано, майданчик приймає оголошення зі статусом «обмежене»: воно створене, але не показується, доки не куплено пакет. Elbuz такі оголошення не оплачує — він створює зв'язок із товаром, пише в журнал окремий рядок про кожне таке оголошення з порадою активувати його пакетом у кабінеті OLX, а наприкінці — скільки їх усього. Далі рішення за вами: купити пакет у кабінеті або зменшити кількість публікацій.

Обов'язкові параметри: як їх заповнити

Це найчастіша причина, чому оголошення не публікуються. У кожної кінцевої категорії OLX є свій набір обов'язкових параметрів — стан, розмір, марка тощо. Elbuz бере їх з характеристик товару, зіставляючи за назвою або кодом параметра, а для параметрів зі списком значень ще й підбирає правильний варіант зі списку. Якщо потрібної характеристики у товару немає, оголошення пропускається, а в журналі перелічується, чого саме забракло — до восьми назв у рядку.

Починайте з однієї категорії. Опублікуйте кілька товарів, подивіться в журнал, які параметри OLX вимагає саме для неї, і заведіть ці характеристики у своєму каталозі з такими самими назвами. Далі та сама категорія публікуватиметься без пропусків, і можна братися за наступну.

Якщо прогін обірвався посередині

Завантаження не чекає кінця прогону, щоб почати писати в каталог. Оголошення приходять із OLX сторінками по 100, а в базовий каталог лягають пачками по 500 позицій, щойно пачка набереться. Якщо OLX посеред гортання відповів помилкою, прочитане не губиться: Elbuz дописує в каталог усе, що встиг отримати, навіть неповну пачку, і тільки потім завершує прогін з помилкою. Старими лишаються лише ті оголошення, до яких черга не дійшла.

такнітакнітакніЗапуск завантаженняЗапит сторінкизі 100 оголошеньOLX відповівпомилкою?Рядок у журналігортання зупиненоПрочитане дописуєтьсяв каталогПрогін завершено зпомилкоюОголошення йдуть у пачкукожні 500 пишуться вкаталогНатиснутозупинку?Решта пачкипишеться в каталогНа сторінці100 оголошень?Каталог завантажено
Цикл завантаження: сторінки по 100 оголошень, запис у каталог пачками по 500. Помилка OLX зупиняє гортання, але все вже прочитане дописується в каталог. Зупинка з журналу дає дочитати поточну сторінку й записати її.

Повтор після обриву безпечний. Картки шукаються за назвою, тож прогін перезапише ті самі позиції й добере ті, до яких не дійшов; дублів не буде — доки заголовки оголошень у кабінеті OLX ті самі, що й були.

З публікацією історія інша, бо там кожне оголошення — окрема відправка. Зв'язок «товар — оголошення» записується одразу на відповідь OLX із номером, по кожному товару окремо. Тому обрив лишає вже створені оголошення створеними й прив'язаними, а решту — незробленою; повторний прогін дожене решту й не спробує опублікувати вдруге те, що вже прив'язане.

Єдина неприємна щілина тут така: прив'язка пишеться тільки на отриману відповідь. Якщо з'єднання обірвалося саме в момент відправлення, оголошення на майданчику може бути вже створене, а прив'язки в Elbuz не буде — і наступний прогін опублікує його ще раз. Якщо ж OLX відповів помилкою, у журналі буде червоний рядок «OLX: помилка публікації оголошення» з назвою товару й текстом причини від самого майданчика, а товар лишиться неприв'язаним і піде на наступну спробу.

Якщо запустили не те

Перше — знайти, що саме зроблено. Точний список опублікованого лежить у журналі прогону: на кожне оголошення там стоїть рядок із назвою товару, а для звичайних — ще й із номером оголошення (у рядку про «обмежене» номера немає, його видно в картці товару). Журнали минулих прогонів відкриває кнопка «Історія запусків» у шапці картки шаблону. У самій картці товару опубліковане видно одразу: у бічній панелі відомостей з'являється рядок «ID olx #…» з номером оголошення, а в шапці картки — кнопка «На сайті», яка веде просто на оголошення (посилання зберігається тільки для тих оголошень, які створив Elbuz; у завантажених з OLX його немає).

Друге — прибрати. Знімати оголошення Elbuz уміє тільки через наявність: поставте нульовий залишок товарам, які опинилися на OLX помилково, і повторіть вивантаження — на кожне прив'язане оголошення піде команда зняття, і воно перестане показуватися покупцям. Видалити оголошення з OLX програма не вміє взагалі: у коннекторі немає такої команди, видаляти доведеться в кабінеті OLX.

Видалити товар у Elbuz — не те саме, що прибрати оголошення. Разом із карткою зникає рядок прив'язки, а оголошення на OLX лишається висіти як було, і керувати ним із Elbuz уже нічим. Якщо потім завести цей товар знову і ввімкнути «Публікувати нові товари», прогін опублікує друге оголошення поруч зі старим. Тому порядок такий: спершу зняти оголошення нульовим залишком, і тільки потім видаляти картки.

Третє — повернути ціни. Зіпсовані вивантаженням ціни на OLX лікуються тим самим вивантаженням: виправте ціну в каталозі й запустіть шаблон ще раз. Прогін порівнює свою ціну з тією, що стоїть в оголошенні, і відправляє оголошення лише тоді, коли цифри розійшлися; решта оголошення при цьому збирається з того, що зараз лежить на OLX, тож текст, фотографії й параметри не постраждають.

А от ціни в каталозі, зіпсовані помилковим завантаженням, масово повернути нема чим: журналу правок товару в програмі немає. Що зачепив прогін, видно відбором у сітці «Товари» за колонкою «Дата оновлення», а що він створив — за колонкою «Джерело: назва»; попередню ціну по одному товару можна подивитися в блоці «Історія ціни товару», якщо ведення історії цін увімкнене. Порядок дій тут спільний для всіх API-підключень і розібраний в огляді завантаження каталогу через API.

Скільки оголошень іде за один прогін

Стелі на кількість немає: скільки оголошень в акаунті, стільки й приїде. Завантаження забирає їх сторінками по 100 і пише в каталог пачками по 500. Вивантаження бере рівно ті товари, які пройшли відбір шаблону, — без обмеження згори. Виняток один: у демонстраційному акаунті вивантаження бере не більше 100 товарів за прогін.

Головна витрата прогону — звернення до майданчика, і їх можна порахувати заздалегідь. На одне оголошення у вивантаженні припадає до трьох звернень: прочитати оголошення, записати нову ціну (тільки якщо вона відрізняється) і команда вмикання або зняття. На публікацію одного товару — два: запит обов'язкових параметрів його категорії й створення оголошення. Завантаження обходиться одним зверненням на сторінку зі ста оголошень плюс по одному на кожну категорію оголошення, яка трапилася в прогоні вперше.

Одного звернення програма чекає до 120 секунд, на встановлення з'єднання дає 30. Якщо OLX відповідає «забагато запитів», програма пробує ще раз — усього до трьох спроб, із паузами дві, чотири й шість секунд, — і лише після цього звернення вважається невдалим: завантаження каталогу на цьому зупиняється з помилкою в журналі.

Вікно можна закривати: журнал прогону ведеться в Центрі операцій, і стежити за ним можна з будь-якого місця програми. Зупинка з журналу діє на прогони OLX по-різному. Завантаження дочитує поточну сторінку оголошень, записує її в каталог і наступної вже не бере. Вивантаження й публікація позначку зупинки не перевіряють, тож робота там іде до кінця списку.

Сценарії

Оголошення OLX мають лежати в каталозі разом з іншими товарами

Налаштування: у вікні завантаження шаблон типу «OLX», акаунт підключено кнопкою «Підключити» й кодом прив'язки, у виборі даних увімкнено «Товари» і, якщо потрібні знімки, «Фото».

Що вийде: кожне оголошення стає карткою в базовому каталозі. Активне оголошення дає залишок 1, зняте — 0. На кожному прогоні назва, опис і ціна картки повертаються до того, що стоїть в оголошенні. Чого не буде: замовлень — навіть з увімкненою галочкою «Замовлення» прогін лише напише в журнал, що OLX їх не передає. Фото й характеристики приходять тільки в нову картку, і пізніші зміни фото в оголошенні в уже заведену картку не потраплять.

Товар закінчився на складі — оголошення має зникнути з OLX

Налаштування: окремий шаблон вивантаження типу «OLX» з увімкненою галочкою «Товари», «Публікувати нові товари» вимкнено.

Що вийде: по кожному прив'язаному оголошенню йде команда за залишком — більший за нуль вмикає оголошення, нуль знімає його. Ціна відправляється лише тоді, коли вона більша за нуль і відрізняється від тієї, що в оголошенні. Чого не буде: товари без прив'язки до оголошення прогін пропускає, нових оголошень не з'явиться, і рядка в журналі про такі товари не буде. Видаляти оголошення прогін теж не вміє — тільки знімати.

Ціни й описи ведете в Elbuz, і завантаження не повинно їх затирати

Налаштування: у картці товару перемикач «Не оновлювати» в секції «Захист під час імпорту». Для ціни в самому OLX — шаблон вивантаження з галочкою «Товари».

Що вийде: завантаження OLX таку картку не переписує — ні назву, ні опис, ні ціну, ні наявність, і характеристик теж не чіпає. Прив'язка до оголошення при цьому лишається, тож вивантаження відправить в оголошення вашу ціну, якщо вона відрізняється. Чого не буде: захисту лише від OLX — «Не оновлювати» закриває картку від усіх завантажень. Якщо закріпити треба тільки ціну, вистачить перемикача «Фіксована ціна»: ціну завантаження тоді не чіпає, а назву й опис бере з оголошення.

Часті труднощі

Перша — прив'язка не спрацювала: код прив'язки живе недовго, тож вставляйте його одразу після отримання. Перевірка підключення має відповісти майданчиком і назвою акаунта.

Друга — оголошення не вмикається чи не вимикається. Часто це не помилка, а вже потрібний стан: якщо оголошення й так активне, повторна команда нічого не змінює. Відмови OLX на такі команди зібрані в один помаранчевий рядок після підсумку вивантаження — «OLX: майданчик відхилив команди активації/деактивації: …» з кількістю й першою відмовою. Якщо причина в ній інша, ніж уже потрібний статус (модерація, ліміт), розбиратися з оголошенням доведеться в кабінеті OLX.

Третя — ціна не оновилася. Elbuz змінює ціну лише тоді, коли вона реально відрізняється від тієї, що стоїть в оголошенні. Якщо цифри збігаються, запит не відправляється зовсім — і це правильно, бо кожна зайва зміна оголошення на OLX ні до чого.

Навіщо вести OLX з Elbuz

Оголошення легко завести й важко підтримувати: ціни змінюються, товар закінчується, а знімати оголошення руками ніколи. Через це на OLX годинами висять пропозиції, яких уже немає, — і замість продажу продавець отримує дзвінок із розчаруванням. Коли вітрина OLX зв'язана з каталогом, наявність і ціна оновлюються самі: товар закінчився — оголошення зникло, з'явився — повернулося. А каталог при цьому лишається спільним з іншими каналами, тож вести окремий список «що в мене на OLX» більше не потрібно.

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

Чому з OLX не приходять замовлення?

Тому що їх немає в API: OLX — майданчик оголошень, покупець зв'язується з продавцем напряму, а документ замовлення майданчик не створює. Elbuz керує вітриною OLX — оголошеннями, цінами й наявністю. Якщо галочку завантаження замовлень увімкнено, у журналі просто з'явиться відповідне пояснення.

Як передається наявність, якщо в оголошенні немає кількості?

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

Чому оголошення не публікується?

Найчастіше через вимоги OLX: опис коротший за 80 символів, не зіставлена кінцева категорія або не вистачає обов'язкових параметрів категорії. Усі три випадки Elbuz пише в журнал із назвою товару й переліком того, чого бракує.

Що означає «обмежене» оголошення?

Що вичерпано ліміт безкоштовних публікацій: оголошення створене, але не показується, доки не куплено пакет у кабінеті OLX. Elbuz пакети не купує — він лише повідомляє в журналі про кожне таке оголошення й наприкінці пише, скільки їх усього.

Що обрати в полі «Регіон»?

ua для України, pl для Польщі. Це визначає і майданчик, з яким працює Elbuz, і валюту оголошень — гривню або злотий. Акаунт OLX підключається один на весь обліковий запис Elbuz, і всі шаблони OLX працюють саме з ним, тому регіон має відповідати країні цього акаунта.

Чи затре повторне завантаження мої правки в картці?

Так: назву, опис, ціну й наявність наступний прогін поверне до того, що стоїть в оголошенні. Внутрішній артикул, штрихкод, теги й стару ціну він не чіпає — цих полів в оголошенні OLX немає, і порожнє значення заповнене не затирає. Фото й характеристики вже заведених карток теж лишаються як були. Щоб закріпити картку цілком, поставте в ній перемикач «Не оновлювати» в секції «Захист під час імпорту»; щоб закріпити тільки ціну — «Фіксована ціна».

Як зняти оголошення, опубліковані помилково?

Поставте цим товарам нульовий залишок і повторіть вивантаження — на кожне прив'язане оголошення піде команда зняття. Видаляти оголошення Elbuz не вміє, це робиться в кабінеті OLX. Список опублікованого є в журналі прогону: там на кожне оголошення стоїть рядок із назвою товару, а для звичайних — ще й із номером оголошення.

Чи була стаття корисною?