Помилки товарного фіду: 14 типових проблем і як їх виправити

Помилки товарного фіду рідко бувають драматичними. Фід зазвичай не зникає, просто в ньому з'являється одна неправильна ціна, товар без позначки наявності або категорія, що ні на що не посилається. Маркетплейс такі товари відхилить. AI-консультант, який відповідає з фіду, повторить те, що там написано. У цій статті ми зібрали проблеми, які трапляються найчастіше, згрупували їх за тим, як вони проявляються, і до кожної додали спосіб виправлення.

Якщо ви тільки знайомитеся з фідами, почніть зі статті що таке YML-фід і як його вивантажити.

Чому якість фіду тепер важить більше

Раніше фід читали маркетплейс і пара сервісів порівняння цін. Помилки ловили їхні валідатори, і ви бачили відхилені товари у звіті раз на тиждень.

Тепер той самий файл читає більше систем. Google Merchant Center, наприклад, обходить сторінки товарів і звіряє їх із фідом; якщо ціна не збігається, товари можуть відхилити, про це Google пише в довідці про невідповідність ціни товару. А консультант, який спілкується з вашими покупцями, бере дані з фіду напряму. Vendigit підставляє ціни в картки товарів просто з вашого фіду, а називати ціну, якої асистент там не знайшов, йому заборонено інструкцією. Саме тому фід має бути правильним. Вигадувати ціну асистенту заборонено, але й виправити ту, яку ви опублікували, він не може.

Помилки товарного фіду, через які він не завантажується

Це «гучні» помилки: синхронізація падає, і кабінет показує причину.

1. Посилання не на вашому домені

Vendigit читає фід лише з підтвердженого домену магазину або його піддоменів. Посилання на Google Диск, тестовий сайт чи чужий домен не приймається.

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

2. Посилання віддає помилку, сторінку входу або порожнечу

Фід відповідає кодом 403 чи 404, перекидає на форму входу або повертає порожню відповідь. Типові причини: експорт закритий паролем, захисний плагін блокує невідомих відвідувачів, посилання перегенерували і старе перестало працювати, або експорт доступний лише на платному тарифі (у Prom, наприклад, експорт товарів є на платних пакетах).

Як виправити: відкрийте посилання в приватному вікні браузера. Якщо ви не бачите XML (чи CSV, чи JSON), то й ніхто інший його не бачить. У Хорошоп, приміром, після зміни частини посилання на фід старе посилання перестає працювати, про це сказано в довідці Хорошоп.

3. «Битий» XML

Один неекранований символ ламає весь файл. Найчастіше винні:

• голий & у назві: Сіль & Перець замість Сіль & Перець;
• < чи > в описі без CDATA;
• невидимі керівні символи, скопійовані з таблиці постачальника;
• файл, у заголовку якого UTF-8, а збережений він у Windows-1251. Таке часто трапляється з вивантаженнями з облікових програм.

Ті самі правила є у вимогах Rozetka до YML: UTF-8, без керівних символів, спецсимволи екрановані, HTML в описах загорнутий у <![CDATA[ ]]>.

Як виправити: перевірте файл будь-яким XML-валідатором і виправте рядок, на який він вкаже. Якщо проблема в тексті конкретного товару, правте товар в адмінці, а не у файлі, інакше наступне вивантаження поверне помилку.

4. У файлі немає товарів

XML коректний, але повторюваних записів товарів немає: ні <offer>, ні <item>, ні <entry>. Зазвичай експорт повернув сторінку налаштувань, один службовий запис або порожній каталог, бо фільтр відсік усе. Для CSV це файл із заголовком і без рядків.

Як виправити: перевірте фільтри й вибір товарів в експорті. На деяких платформах товар треба окремо позначити для вивантаження. У Хорошоп, наприклад, для фідів маркетплейсів у картці товару ставиться позначка «Завантажувати на маркетплейси».

5. CSV не читається

CSV має містити рядок заголовків і хоча б один рядок товару. Дуже старі формати, де рядки закінчуються лише символом повернення каретки (варіант «CSV (Macintosh)» у деяких версіях Excel), не підтримуються.

Як виправити: зберігайте як «CSV UTF-8» із заголовками.

6. Файл завеликий

Фід за посиланням — до 128 МБ (JSON — до 24 МБ), завантажений файл — до 20 МБ.

Як виправити: приберіть зайве, наприклад довгі HTML-описи з вбудованими стилями, або віддавайте фід за посиланням замість завантаження.

Помилки, з якими фід завантажується, але відповіді неправильні

Ці помилки тихіші й тому гірші. Синхронізація проходить, а покупці отримують неповні або хибні відповіді.

7. Товари без коду чи назви

Товару потрібні щонайменше ідентифікатор і назва. Записи без них пропускаються. Якщо в третини каталогу немає назви основною мовою, третина каталогу невидима.

Як виправити: заповніть назви основною мовою фіду. Якщо продаєте українською і російською, перевірте, що основне поле name не порожнє.

8. Коди товарів змінюються між вивантаженнями

За id будь-який сервіс впізнає «той самий товар, що й учора». Якщо експорт нумерує товари за порядком або складає код із назви, кожна правка дає новий код. Для читача фіду старий товар зникає, а новий з'являється, і все, що було прив'язано до старого, втрачається.

Як виправити: використовуйте як id номер товару в базі або артикул. Rozetka вимагає того самого: id не можна змінювати після того, як товар розміщено.

9. Дублікати кодів

Два варіанти товару вивантажено з однаковим id. Залишиться лише один, другий буде проігноровано.

Як виправити: дайте кожному варіанту власний код (наприклад, DX450-25 і DX450-5), а спільний код моделі тримайте в окремому полі.

10. Ціни в неправильному форматі

1299, 1299.00 і навіть 1 299,00 читаються нормально. А от 1,299.00, де кома відділяє тисячі, а крапка копійки, надійно прочитати не можна. «Ціна за запитом» — взагалі не число. Товар без ціни в каталозі залишиться, але асистент не назве ціну, якої не має.

Як виправити: вивантажуйте ціни простим числом, а валюту окремим полем (<currencyId>UAH</currencyId>).

11. Наявність не вказана або вказана по-своєму

Наявність розпізнається з available="true", в наявності, немає в наявності, in stock, out of stock, передзамовлення та поширених варіантів. Усе інше, як-от «2–3 дні» чи «уточнюйте», вважається невідомим. Якщо поля наявності немає, але є кількість, додатна кількість означає «є в наявності».

Як виправити: завжди вивантажуйте явну позначку наявності. Терміни доставки винесіть в окреме поле або на сторінку «Доставка».

12. Категорії, що ні на що не посилаються

У YML <categoryId> кожного товару має збігатися з <category id="…"> у блоці <categories>. Якщо експорт цей блок пропускає або категорію видалили, товари випадають із дерева. Тоді асистенту складніше відповісти на «що у вас є з фарб для дерева?».

Як виправити: вивантажуйте повне дерево категорій з parentId для підкатегорій.

13. Бідні характеристики

У фіді є назви й ціни, але немає тегів param або все звалено в один довгий опис. Кабінет Vendigit про це попереджає: «Цей фід не описує свої товари характеристиками». А покупці питають про розмір, об'єм, матеріал, сумісність. Без характеристик асистенту менше з чим працювати.

Як виправити: увімкніть вивантаження характеристик. У Хорошоп для експорту на Prom характеристики обираються в налаштуваннях кожної категорії, див. інструкцію Хорошоп.

Помилки самого вивантаження

14. Обрізаний або застарілий фід

Дві пов'язані проблеми:

• Обрізаний. Експорт не встиг сформуватися або віддав лише першу сторінку, і замість 4000 товарів у фіді раптом 400. Тут Vendigit вас підстраховує: якщо планова синхронізація скоротила б каталог зі 100+ товарів більш ніж удвічі, усі товари залишаються, прочитане зберігається, а синхронізація завершується помилкою з обома числами. Якщо каталог справді зменшився, натисніть Синхронізувати в кабінеті, і менший каталог буде прийнято.
• Застарілий. Файл є, але не перебудовується. Деякі платформи оновлюють фід лише за кнопкою або раз на добу, а завантажений вручну файл не змінюється, доки ви його не заміните. Як тримати свіжість під контролем, розповідаємо в статті як часто оновлювати товарний фід.

Як Vendigit показує проблему з фідом

У кожного фіду є статус: «Очікує», «Синхронізується», «Синхронізовано», «Помилка» або «Скасовано». Коли синхронізація падає, кабінет показує причину, а далі:

• товари з останньої вдалої синхронізації залишаються, і асистент продовжує відповідати;
• фід за посиланням автоматично пробує завантажитися знову приблизно за годину;
• повільну синхронізацію можна скасувати, прочитані товари збережуться;
• синхронізація, що зависла на 30 хвилин, вважається втраченою, і її можна перезапустити.

Ліміти тарифу — не помилка, але легко сплутати: Starter індексує до 10 000 товарів на магазин, Growth — 15 000, Business — 50 000. Якщо товарів більше, кабінет покаже, скільки з них потрапляє в пошук, і ви отримаєте лист.

Перевірка фіду за п'ять хвилин

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

Якщо у фіді помилка в ціні, асистент назве покупцю неправильну ціну?

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

Синхронізація впала. Асистент перестав працювати?

Ні. Товари з останньої вдалої синхронізації залишаються, і асистент відповідає з них. Vendigit повторить спробу приблизно за годину, а після виправлення причини можна натиснути «Синхронізувати» самому.

Чи треба налаштовувати зіставлення полів вручну?

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

Як дізнатися, які товари пропущено?

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