Технічні бар'єри маркетплейсів: помилки API, ліміти FTP та статус «Видалений»

Посібник з діагностики та усунення проблем (Troubleshooting Guide)

Цей матеріал призначений для швидкого розв'язання найпоширеніших технічних проблем, що виникають під час синхронізації облікової системи з маркетплейсами (Prom.ua, Rozetka) та роботі з FTP-серверами.

Блок 1. Проблеми з API Prom.ua: помилки 401, Import forbidden та паралельні вивантаження

При роботі з маркетплейсом Prom.ua користувачі часто стикаються з блокуванням доступу до API. Це призводить до того, що замовлення не завантажуються, а товари не оновлюються на сайті.

Симптом 1. Помилка «401 Not Authenticated» або «Import forbidden»

Ознаки. Під час завантаження замовлень або вивантаження товарів програма видає повідомлення 401 Not Authenticated. Перевірте валідність API-ключа або Import forbidden. 

Причини:

1. Відсутній або прострочений API-ключ. Термін дії токена доступу в кабінеті Prom.ua закінчився, або ключ взагалі не вказано в налаштуваннях об'єкта синхронізації.

2. Недостатньо прав (Import forbidden). В особистому кабінеті продавця Prom.ua для активного токена встановлено права лише на «Читання», що забороняє програмі вносити зміни (записувати дані) на маркетплейс.

Рішення:

1. Перейдіть в особистий кабінет Prom.ua у розділ «Налаштування» → «Управління API-токенами».

2. Перевірте термін дії ключа. Якщо він закінчився, згенеруйте новий API-ключ.

3. Перевірте права доступу: у розділі «Продукти та групи» обов'язково змініть значення з «Читання» на «Читання та запис».

4. Скопіюйте новий токен, вставте його в налаштування об'єкта синхронізації в Торгсофт та повторіть вивантаження.

Симптом 2. Помилки «Too Many Requests» або «Bot protection»

Ознаки. Синхронізація переривається помилками Too Many Requests або Bot protection. 

Причина. Маркетплейс Prom.ua ввів нові обмеження (нововведення) щодо заборони паралельних вивантажень. Якщо ви одночасно запускаєте ручну синхронізацію під час роботи автоматичної, або у вас налаштовано кілька автоматичних завдань на один і той самий час (дублікати часу синхронізації), спрацьовує захист маркетплейсу, і з'єднання блокується. 

Рішення:

1. Проаналізуйте журнал синхронізації та перевірте розклад завдань.

2. Уникайте ручного запуску вивантаження, коли працює таймер автоматичної синхронізації.

3. Вимкніть синхронізацію товарів у низці паралельних автоматичних вивантажень або рознесіть їх у часі.

Блок 2. Вивантаження фотографій на FTP: формати, префікси та нестача місця

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

Симптом 1. Фотографії успішно вивантажені на FTP, але не відображаються на сайті

Причина. Неправильно налаштований FTP-сервер або відсутній HTTP-префікс. Сам по собі FTP-сервер лише зберігає файли. Щоб маркетплейс міг їх завантажити, FTP-сервер повинен працювати як Web-сервер (бути відкритим для доступу через інтернет), а посилання на фото мають бути прямими. 

Рішення:

1. Переконайтеся, що ваш FTP-сервер налаштований як Web-сервер.

2. У налаштуваннях об'єкта синхронізації обов'язково вкажіть Префікс посилання на фотографії (наприклад, http://ваший-домен.com/images/). Програма додасть ім'я файлу до цього префікса, утворивши пряме посилання для маркетплейса.

Симптом 2. Помилка «Transfer aborted. Input/output error» або обрив з'єднання

Ознаки. В журналі синхронізації з'являються помилки Помилка відправлення фото товару... Transfer aborted. Input/output error або Read timed out. 

Причина. Найпоширеніша причина — на хостингу (FTP-сервері) закінчилося вільне місце для вивантаження фотографій. Також завантаження може перериватися з боку самого FTP-сервера через ліміти на кількість файлів (inode) або тайм-аути з'єднання. 

Рішення:

1. Зверніться до адміністратора вашого FTP-хостингу або перевірте в панелі керування наявність вільного дискового простору.

2. Видаліть застарілі фотографії або змініть тарифний план хостингу на більший.

Симптом 3. Помилка завантаження зображень (непідтримуваний формат WebP)

Ознаки. При спробі додати або завантажити фото за посиланням виникає помилка Не вдалося завантажити зображення або Cannot create file. 

Причина. Зображення має сучасний формат .webp (навіть якщо в кінці посилання написано .jpeg чи .jpg, фактично файл може бути стиснутий у WebP). На даний момент програма не підтримує роботу з форматом .webp через обмеження системних компонентів. 

Рішення. Використовуйте стандартні формати зображень, такі як .jpg, .jpeg, .png або .bmp. Якщо ви завантажуєте фото з інтернету, попередньо конвертуйте файл WebP у JPEG або PNG.

Блок 3. Проблеми на Rozetka: статус «Видалений» через усічений прайс-лист

Маркетплейс Rozetka оновлює інформацію про ціни та наявність товарів на основі XML прайс-листа, який генерує облікова система.

Симптом. Тисячі товарів на Rozetka раптово отримали статус «Видалений»

Ознаки. Практично по всьому асортименту на маркетплейсі Rozetka.ua встановлено статус «Видалений». 

Причина. Збої під час автоматичного вивантаження. На FTP-сервер періодично вивантажується усічений (неповний) прайс-лист малого розміру, в якому відсутня більшість товарів. Якщо Rozetka зчитує такий файл, вона вважає, що товарів більше немає в наявності, і масово маркує їх як видалені. Найчастіше усічений файл формується через конфлікт паралельних процесів (наприклад, коли відбувається накладання ручного вивантаження на автоматичне, або збій на FTP під час перезапису файлу). 

Рішення:

1. Швидке відновлення. Проведіть ручну синхронізацію з Rozetka у програмі. Це згенерує повноцінний прайс-лист нормального розміру з усіма товарами та вивантажить його на FTP.

2. Під час наступного сеансу оновлення (Rozetka зчитує прайс-лист з інтервалом в одну годину) маркетплейс обробить повний файл, і всі товари повернуться в нормальний стан.

3. Профілактика. Перевірте налаштування завдань за розкладом. Уникайте запуску кількох синхронізацій з Rozetka одночасно, щоб система встигала коректно завершити формування XML-файлу.