Помилки завантаження XML-прайсу
Support EVA.UA
Останнє оновлення 9 днів тому
Коли система EVA Marketplace не може завантажити або зчитати ваш XML-файл з переліком товарів, у кабінеті продавця з'являється повідомлення про помилку. Ця стаття допоможе зрозуміти, що означає кожне повідомлення, чому воно виникає та які кроки зроблять успішним наступний імпорт.
Важливо: ці помилки стосуються етапу завантаження файлу за посиланням (доступність, з'єднання, формат, розмір). Помилки валідації вмісту фіда (некоректні поля товару, відсутні обов'язкові атрибути тощо) описані в окремій статті — Підготовка прайс-листу XML.
1. IP-адреси та User-Agent EVA для білого списку (whitelist)
Якщо ваш сервер, хостинг, CDN або WAF обмежує доступ за IP-адресою чи User-Agent (файрвол, захист від ботів, rate limiting) — додайте наведені нижче значення в білий список, дозволивши доступ до XML-фіда та фото товарів без обмежень.
IP-адреси:
Це найчастіша причина помилок "Помилка з'єднання":403 Заборонено та 429 Забагато запитів, описаних нижче.
Якщо ваш сервер, хостинг, CDN або WAF обмежує доступ за IP-адресою чи User-Agent (файрвол, захист від ботів, rate limiting) — додайте наведені нижче значення в білий список, дозволивши доступ до XML-фіда та фото товарів без обмежень.
IP-адреси:
138.197.179.150
User-Agent:
- Для завантаження XML-фіда: EvaMerchantBot/1.0
- Для завантаження фото товарів: стандартний Mozilla-рядок (браузерний User-Agent, не бот)
Це найчастіша причина помилок "Помилка з'єднання":403 Заборонено та 429 Забагато запитів, описаних нижче.
2. Файл недоступний за посиланням
Ці помилки виникають, коли система EVA взагалі не змогла "достукатись" до вашого сервера за вказаною URL-адресою фіда.
| Текст помилки в кабінеті | Що це означає | Що робити |
| Помилка з'єднання | Сервер, на якому розміщено XML-файл, не відповідає на запити EVA. Причина — сервер вимкнено, недоступний, або мережеве обладнання файрвол, проксі) блокує з'єднання. | Перевірте, чи сервер/хостинг працює. Додайте IP-адреси та User-Agent EVA до білого списку (див. розділ 1 вище). Спробуйте відкрити посилання з іншого пристрою/мережі. |
| Перевищено час очікування запиту | Сервер почав відповідати, але робив це занадто довго — запит "обірвався" за таймаутом. Зазвичай через повільну генерацію файлу, велике навантаження на хостинг або занадто великий файл. | Перевірте швидкість віддачі файлу вашим сервером. Якщо фід генерується "на льоту" при кожному запиті — перейдіть на кешування готового статичного файлу. Розгляньте більш потужний хостинг. |
| Файл не вдалося завантажити через помилку (недійсна URL-адреса) | URL-адреса фіда має неправильний формат (наприклад, зайві символи, відсутній протокол http(s)://, помилка в написанні). | Перевірте посилання, вказане в налаштуваннях фіда в кабінеті мерчанта. Скопіюйте його в браузер і переконайтесь, що воно відкриває файл напряму. |
| Файл не вдалося завантажити через помилку (занадто багато переадресацій) | Посилання веде через довгий ланцюжок переадресацій (301/302) або зациклюється саме на себе. | Надайте пряме посилання на файл без проміжних редиректів. Перевірте налаштування вашого CMS/CDN на предмет зайвих правил перенаправлення. |
| Загальна помилка завантаження файлу | Виникла інша мережева проблема, що не підпадає під перелічені вище випадки. | Спробуйте повторити імпорт пізніше. Якщо помилка повторюється — зверніться в підтримку EVA з часом спроби та посиланням на фід. |
3. Сервер відхилив запит (HTTP-помилки)
Ці помилки виникають, коли сервер відповів, але повідомив, що не може або не хоче віддати файл.
| Текст помилки в кабінеті | Що це означає | Що робити |
| 400 Неправильний запит | Сервер не зрозумів запит у тому вигляді, в якому його надіслала EVA. | Зверніться до вашого IT-адміністратора/хостинг-провайдера — потрібна перевірка налаштувань сервера. |
| 401 Доступ обмежено | Файл захищено логіном/паролем (Basic Auth) або токеном доступу. Система EVA завантажує фід без авторизації. | Зробіть посилання на XML-файл публічно доступним, без вимоги логіна/пароля. |
| 403 Заборонено | Сервер бачить запит, але відмовляє в доступі. Часто — блокування за User-Agent, IP-адресою або правилами захисту від ботів (наприклад, Cloudflare, WAF). | Додайте IP-адреси та User-Agent EVA до білого списку (див. розділ 1 вище). Додайте виняток у налаштуваннях захисту сервера, вимкніть блокування ботів для цього конкретного файлу. |
| 404 Ресурс не знайдено | За вказаною адресою немає файлу — його могли перейменувати, перемістити або видалити. | Перевірте актуальність посилання в кабінеті мерчанта, оновіть його за потреби. |
| 429 Забагато запитів | Сервер, де розміщено фід, обмежує кількість запитів за проміжок часу (rate limiting) і тимчасово відмовляє в доступі, бо EVA звернулась занадто часто. | Додайте IP-адреси та User-Agent EVA до білого списку (див. розділ 1 вище), щоб зняти обмеження саме для наших запитів. Якщо обмеження налаштовує хостинг-провайдер — зверніться до нього. |
| Помилка сервера (HTTP 500–504) | Сервер, де розміщено фід, тимчасово недоступний, перевантажений або "впав" під час обробки запиту. | Зверніться до вашого хостинг-провайдера/IT-відділу. Якщо файл генерується динамічно — перевірте логи сервера на момент помилки. |
| HTTP response code: {код} | Сервер повернув код, що не входить у типові сценарії вище. | Передайте отриманий код у підтримку EVA — допоможемо визначити причину. |
4. Проблеми з самим файлом
Ці помилки виникають вже після того, як файл успішно завантажено, — на етапі його обробки.
| Текст помилки в кабінеті | Що це означає | Що робити |
| Неможливо декодувати вміст XML-файлу за допомогою UTF-8 | XML-файл збережено не в кодуванні UTF-8 (наприклад, Windows-1251 або ISO-8859-1), тому система не може коректно прочитати текст (особливо кирилицю). | Перезбережіть/перегенеруйте файл у кодуванні UTF-8. Переконайтесь, що в самому XML вказано <?xml version="1.0" encoding="UTF-8"?> і це відповідає реальному кодуванню файлу. |
| Розмір файлу не повинен перевищувати 300 МБ. | Файл більший за дозволений максимальний розмір для завантаження за посиланням — 300 МБ. | Приберіть зайві/застарілі товари з фіда. Оптимізуйте занадто великі описи товарів. Використовуйте виключно ті атрибути та значення, які є в Довіднику EVA (зайві/нестандартні поля збільшують розмір файлу). |
⚠️ Не розбивайте один фід на кілька XML-файлів і не завантажуйте їх частинами. Кожен імпорт повністю замінює попередній перелік товарів: усе, чого немає в поточному XML-файлі, система вважає видаленим з асортименту. Якщо вивантажити лише частину товарів окремим файлом — решта (та, що не увійшла до цього файлу) буде знята з публікації як відсутня у фіді.
5. Невідома помилка
Якщо в кабінеті з'явився текст помилки, якого немає в таблицях вище — це нетипова, необроблена ситуація (система показує технічний опис помилки як є).
Що робити: зробіть скріншот повідомлення, зафіксуйте приблизний час спроби імпорту та зверніться в підтримку EVA. Технічна команда зможе подивитись деталі за ID імпорту.
Загальні рекомендації, щоб уникати помилок імпорту
Якщо в кабінеті з'явився текст помилки, якого немає в таблицях вище — це нетипова, необроблена ситуація (система показує технічний опис помилки як є).
Що робити: зробіть скріншот повідомлення, зафіксуйте приблизний час спроби імпорту та зверніться в підтримку EVA. Технічна команда зможе подивитись деталі за ID імпорту.
Загальні рекомендації, щоб уникати помилок імпорту
- Розмістіть XML-файл на стабільному хостингу з достатньою пропускною здатністю.
- Уникайте генерації фіда "на льоту" при кожному запиті — кешуйте готовий файл і оновлюйте за розкладом.
- Не захищайте посилання на фід паролем чи авторизацією.
- Перевіряйте, що посилання не змінюється без оновлення в кабінеті мерчанта.
- Кодування файлу — завжди UTF-8.
- Розмір файлу не повинен перевищувати 300 МБ. Якщо файл наближається до ліміту — прибирайте застарілі товари, оптимізуйте великі описи та використовуйте лише атрибути з Довідника EVA. Не діліть фід на кілька файлів для окремого завантаження: усе, чого немає в поточному XML, система знімає з публікації як видалене.
Коли звертатись у підтримку EVA
Якщо ви перевірили рекомендації вище, а помилка повторюється — напишіть у підтримку EVA Marketplace Help-Bot, розділ «Технічні питання» вказавши:
- точний текст помилки з кабінету мерчанта;
- посилання на XML-фід;
- приблизний час останньої спроби імпорту.