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

> Більшість помилок товарного фіду дрібні: неекранований амперсанд, ціна «1,299.00», коди товарів, що змінюються з кожним вивантаженням. Розповідаємо, як їх знайти й виправити, поки покупці не отримали хибну відповідь.

Published: 2026-10-02 | Author: Vendigit
Canonical: https://vendigit.com/uk/journal/product-feed-errors

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

Якщо ви тільки знайомитеся з фідами, почніть зі статті [що таке YML-фід і як його вивантажити](/uk/journal/what-is-yml-product-feed).

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

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

Тепер той самий файл читає більше систем. Google Merchant Center, наприклад, обходить сторінки товарів і звіряє їх із фідом; якщо ціна не збігається, товари можуть відхилити, про це Google пише в довідці про [невідповідність ціни товару](https://support.google.com/merchants/answer/12159029). А консультант, який спілкується з вашими покупцями, бере дані з фіду напряму. Vendigit підставляє ціни в картки товарів просто з вашого фіду, а називати ціну, якої асистент там не знайшов, йому заборонено інструкцією. Саме тому фід має бути правильним. Вигадувати ціну асистенту заборонено, але й виправити ту, яку ви опублікували, він не може.

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

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

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

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

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

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

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

**Як виправити:** відкрийте посилання в приватному вікні браузера. Якщо ви не бачите XML (чи CSV, чи JSON), то й ніхто інший його не бачить. У Хорошоп, приміром, після зміни частини посилання на фід старе посилання перестає працювати, про це сказано в [довідці Хорошоп](https://help.horoshop.ua/uk/articles/2446965-%D1%82%D0%BE%D0%B2%D0%B0%D1%80%D0%BD%D1%96-%D1%84%D1%96%D0%B4%D0%B8-%D0%B4%D0%BB%D1%8F-%D0%B7%D0%BE%D0%B2%D0%BD%D1%96%D1%88%D0%BD%D1%96%D1%85-%D0%BC%D0%B0%D0%B9%D0%B4%D0%B0%D0%BD%D1%87%D0%B8%D0%BA%D1%96%D0%B2).

### 3. «Битий» XML

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

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

Ті самі правила є у [вимогах Rozetka до YML](https://sellerhelp.rozetka.com.ua/p185-pricelist-requirements.html): 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 характеристики обираються в налаштуваннях кожної категорії, див. [інструкцію Хорошоп](https://help.horoshop.ua/en/articles/4301171-product-feed-for-prom-ua).

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

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

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

- **Обрізаний.** Експорт не встиг сформуватися або віддав лише першу сторінку, і замість 4000 товарів у фіді раптом 400. Тут Vendigit вас підстраховує: якщо планова синхронізація скоротила б каталог зі 100+ товарів більш ніж удвічі, усі товари залишаються, прочитане зберігається, а синхронізація завершується помилкою з обома числами. Якщо каталог справді зменшився, натисніть **Синхронізувати** в кабінеті, і менший каталог буде прийнято.
- **Застарілий.** Файл є, але не перебудовується. Деякі платформи оновлюють фід лише за кнопкою або раз на добу, а завантажений вручну файл не змінюється, доки ви його не заміните. Як тримати свіжість під контролем, розповідаємо в статті [як часто оновлювати товарний фід](/uk/journal/product-feed-sync-frequency).

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

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

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

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

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

| Що перевірити | Як |
|---|---|
| Відкривається без входу | Приватне вікно браузера |
| XML коректний | Будь-який XML-валідатор |
| Коди стабільні | Порівняти два вивантаження з різницею в добу |
| Ціни — числа | Пошукати коми й слова всередині `<price>` |
| Наявність вказана | У кожного `offer` є `available` |
| Категорії зв'язані | Кожен `categoryId` існує |
| Характеристики є | Кількість `<param>` на товар |
| Фід повний | Кількість товарів збігається з адмінкою |

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

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

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

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

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

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

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

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

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

Чистий фід — найдешевше покращення для всіх каналів, які його читають. Якщо хочете побачити, що з вашого фіду отримають покупці, [почніть 14-денний безкоштовний період](https://app.vendigit.com/register). Картка не потрібна.
