> Усі статті WIKI Helomi: /wiki/llms.txt

# OLX

Інтеграція з OLX через Partner API приносить переписки з покупцями в «Переписки», дає створити угоду з розмови «OLX Доставки» і оновлювати оголошення й ціни зі складу. Окремого списку замовлень Partner API OLX не віддає, тому угода з'являється з переписки, а не опитуванням, як у Prom чи Rozetka.

## Можливості
- Підключення акаунта OLX через Partner API; токен оновлюється сам, картка показує, скільки днів він ще дійсний.
- Переписки з покупцями — у «Переписках»; стан полера видно в картці.
- Угода з переписки: ім'я й телефон покупця, оголошення, товар за артикулом; повторно з тієї самої розмови угода не дублюється.
- Джерело, відповідальний, чати й оператори, автоматична ТТН на етапах, зв'язок товарів.
- Оновлення оголошень і цін зі складу.

## 1. Налаштування
Підключає адміністратор. Дорога: «Налаштування» → «Інтеграції» → вкладка «Маркетплейси» → картка «OLX» → «Підключення».

1. Ключі застосунку OLX Partner API: «Client ID» і «Client secret» → «Ввести» → «Зберегти ключ». Їх видає OLX, коли ви реєструєте застосунок у партнерській програмі.
2. Сам акаунт OLX підключається кнопкою «Підключити OLX» у «Переписках» → «Стан каналів» (вхід в OLX і дозвіл доступу).
3. «Перевірити» читає профіль: успіх — «акаунт: <ім'я>»; якщо OLX не підключено — підказка, куди натиснути.
4. «Стан роботи»: «Підключення OLX» (підключено / не підключено), «Акаунт», «Токен дійсний ще N дн.», «Полер «Переписок»».

Кількох акаунтів OLX поки нема — одна картка на організацію.

## 2. Угода з переписки OLX
Угоду створює менеджер з розмови «OLX Доставки» в «Переписках». CRM бере ім'я й телефон покупця, оголошення (назву, ціну) і шукає товар: за артикулом, потім за додатковим полем товару «Оголошення на ОЛХ», потім за списком оголошень ШІ Віки; не знайшла — вільна позиція з назвою оголошення. В угоді з'являються поля `olx_order_id` (за ним повтор не дублюється), `olx_advert_id`, `olx_conversation_id`.

Де саме кнопка створення угоди в «Переписках» —.

## 3. Налаштування продажів OLX
Вкладка «Налаштування продажів»: «Основне» («Увімкнути інтеграцію», «Джерело угод», «Відповідальний»), «Нові замовлення» («Автоприйняття», «Зв'язувати товари по»), «Чати» («Чати про товари», «Чати про замовлення», «Оператори», «Відкрити переписки →»), «Автоматична відправка ТТН». «Пов'язаних статусів» нема: статусів замовлень API OLX не віддає. Унизу — «Зберегти».

## 4. Оголошення і ціни
«Підключення» → «Стан роботи» → «Оновлення товарів»: автоматично чи вручну оновлюються оголошення зі складу; «Оновити зараз». Ціни оголошень веде ШІ Віка.

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

**«Виставити на OLX»** (програма Віки): вибрані оголошення, які OLX вимкнув (закінчився ліміт, термін, не оплачено), Віка вмикає знову. Спершу розрахунок без витрат: які оголошення можна увімкнути (на модерації, заблоковані тощо — пропускаються з поясненням), скільки слотів уже є в куплених пакетах, що докупити — найдешевша комбінація з живого прайсу OLX (пакети від 3 і окремі розміщення: 4 оголошення — пакет на 3 + 1 окремо, а не два пакети), сума, баланс рахунку OLX і чого не вистачає. Ціну окремого розміщення OLX наперед не каже: поки її не знаємо — оцінка «≈» (половина пакета на 3), після першої покупки в категорії — точна. Купити й увімкнути може лише власник або адміністратор: сума має збігтися з підтвердженою, за раз — не більше 20 000 грн; гроші справжні. Кожен прогін — у журналі (що куплено, що увімкнено, що не вдалося); прогін, обірваний рестартом, позначається «перервано — перевірте кабінет OLX».

## 5. Блок «OLX» в угоді
У картці угоди з джерелом OLX є блок «OLX (<джерело>)» з даними, що прийшли з переписки (`olx_*`); чого нема — «…». ID показується без посилання: окремої сторінки замовлення в кабінеті OLX Partner API не дає. «?» у заголовку блоку відкриває цю статтю у шторці.

## Фінанси каналу: нарахування, комісія, виплата (16.10)
Гроші ОЛХ у «Фінансах» — правило каналу у «Фінанси → Звірка» → рядок «ОЛХ» (кожен акаунт — своє правило; типово вимкнено). Увімкнене правило в момент «гроші наші» (при замовленні, коли угода виграна чи на вибраних етапах) проводить дохід угоди в транзитний гаманець «Транзит · ОЛХ» (угода стає «сплаченою») і комісію майданчика витратою по угоді; угода скасована — сторно. Заготовка комісії: 20 грн + 3 % від суми угоди лише при оплаті через ОЛХ Доставку (поле «Спосіб оплати» містить «ОЛХ дост…», служба доставки ОЛХ або checkbox UAPay); комісію, яку надсилає ШІ Едуард, проведено одразу точною сумою, а табличка комісій ОЛХ Марії вже не просить «записати витратою». Виплата ОЛХ на рахунок — правило імпорту «Виплата каналу» або кнопка у «Вхідних»: переказ, а не другий дохід; баланс транзитного гаманця — скільки ОЛХ ще винен. Докладно — стаття «Фінанси», розділ 7а.

З 20.10 увімкнено: «Транзит · ОЛХ». Угоду ОЛХ Доставки, яку ШІ Едуард заводить через Telegram (джерело угоди «ОЛХ»), «Фінанси» вважають каналом ОЛХ. Дохід — коли угода виграна, лише при ОЛХ Доставці; комісія — точна від Едуарда або 20 грн + 3 %, одразу при замовленні з того самого транзиту. Виплата «ЮАПЕЙ» («…OLX.1» — це ОЛХ Доставка, не Prom) — переказ із транзиту сам.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «OLX не підключено — «Переписки» → «Стан каналів» → «Підключити OLX»» | Акаунт OLX не авторизовано | Підключіть у «Переписках» |
| «не задано (у картці чи .env): OLX_PARTNER_CLIENT_ID, OLX_PARTNER_CLIENT_SECRET» | Ключі застосунку не введено | Введіть «Client ID» і «Client secret» |
| «OLX не віддав профіль» | OLX відповів без даних | Перепідключіть OLX і перевірте знову |
| «Полер «Переписок»: помилка …» | Збій отримання переписок | Подивіться текст помилки, перепідключіть OLX |

## Для ШІ-співробітників
5`). ШІ бачить угоди з OLX у «Угодах» (`deals_list`, `deals_get`): джерело і поля `olx_order_id`, `olx_advert_id`, `olx_conversation_id`. Статтю ШІ читає інструментом `help("int-olx")`.

## Додаткова інформація
- Пов'язані статті: [Переписки](chats.md), [Угоди](deals.md), [Склад і товари](products.md).