До основного вмісту
0x0дебаг даних
Перевірити прайс

прайси → фіди

YML для Prom.ua: імпорт падає на дрібницях

Prom читає YML-фід рядок за рядком: одна ціна з пробілом або порожній тег — і товар не з'являється. Збираємо фід так, щоб імпорт проходив з першого разу.

Перевірити прайс

від 990 грн · перші 50 рядків безкоштовно

було → стало

Що змінюється у файлі

data x-ray · diff1 файл → 1 фід
0x0 дебаг даних: рядок з багом у валідний рядок
булоXLSX постачальника
prom_export.xlsx

1841;Кабель USB-C;1 299;+
1841;Кабель USB-C;1 299;+
фото: cdn/1.jpg
сталоprom.yml
prom.yml  ✓ valid

<offer id="1841" available="true">
  <price>1299</price>
  <currencyId>UAH</currencyId>
  <picture>https://cdn/1.jpg</picture>
</offer>

1 товар · 0 дублів

дані вигадані · показано структуру, не реальний прайс

YML для Prom.ua — це структурований файл каталогу, який площадка читає під час імпорту. Помилка в одному тегу зазвичай не ламає весь файл: товар просто не оновлюється або зникає з вибірки. Саме тому важливо бачити не «імпорт пройшов», а які рядки площадка прийняла.

Структура файлу

<yml_catalog date="2026-11-04 12:00">
  <shop>
    <name>Ваш магазин</name>
    <company>Ваш магазин</company>
    <url>https://example.com</url>
    <currencies>
      <currency id="UAH" rate="1"/>
    </currencies>
    <categories>
      <category id="1001">Інструмент</category>
    </categories>
    <offers>
      <offer id="1841" available="true">
        <price>1299</price>
        <currencyId>UAH</currencyId>
        <categoryId>1001</categoryId>
        <picture>https://cdn.example.com/1.jpg</picture>
        <vendor>Brand</vendor>
        <vendorCode>SKU-1841</vendorCode>
        <name>Кабель USB-C</name>
        <description>Опис товару</description>
      </offer>
    </offers>
  </shop>
</yml_catalog>

id і available — атрибути офера. Артикул передається тегом vendorCode, категорія — categoryId, валюта — currencyId.

Поля офера

Поле Що містить Вимога
id Ідентифікатор товару унікальний у межах фіду
available Наявність true або false
name Назва непорожній текст
price Ціна число більше нуля, без пробілів і «грн»
currencyId Валюта UAH, EUR або USD у нашому конвертері
categoryId Категорія id з довідника категорій Prom
picture Фото абсолютний URL; поле необов'язкове
vendor Бренд текст
vendorCode Артикул унікальний разом з id; до 25 символів, літери, цифри, пробіл і - _ . /
description Опис непорожній текст

У довідці Prom вимога до <price> описана разом зі <oldprice>. Наш конвертер вважає ціну обов'язковою завжди, бо без неї пропозиція некоректна. Для нестандартних типів фіду уточніть це правило в підтримці Prom.

Prom приймає більше валют, ніж наш конвертер. Зараз ми підтримуємо UAH, EUR, USD; інші коди потребують окремого курсу й перевірки.

Типові помилки

  • Порожня ціна або ціна з комою замість крапки — офер не оновлюється.
  • Дубль id або vendorCode — незрозуміло, який товар головний.
  • Категорія categoryId не з довідника Prom — товар не потрапляє в потрібний розділ.
  • Бита або відносна адреса фото. Для Prom фото необов'язкове: ми залишаємо товар у фіді, але попереджаємо про проблему.
  • Опис або назва зі службовими позначками, які площадка сприймає як частину тексту.

Що робимо з прайсом

  1. Розбираємо колонки постачальника й зіставляємо їх із полями YML.
  2. Перевіряємо обов'язкові поля, числа, валюти, категорії та дублі.
  3. Рядки з помилками виключаємо. Рядки з попередженнями залишаємо, якщо площадка дозволяє поле не передавати.
  4. Збираємо YML і звіт: які товари увійшли, які виключені, що саме виправлено.

faq

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

Скільки коштує YML для Prom.ua?

Від 990 грн за типовий прайс. Перші 50 рядків перевіряємо безкоштовно. Оплата — після того, як ви побачили результат.

У мене кілька постачальників і різні колонки — впораєтесь?

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

Чи можна оновлювати фід регулярно?

Так, повторна збірка з нового прайсу — окрема послуга. Формат передачі й розклад узгоджуємо під ваш процес.

Ви гарантуєте, що товари з'являться на площадці?

Ми відповідаємо за валідність файлу й коректність даних. Модерацію та правила площадки контролює сама площадка.

Чим YML відрізняється від звичайного XML?

Структурою й набором тегів, які очікує конкретна площадка. Для Prom важливі vendorCode , currencyId , categoryId та коректний available ; «просто XML» із тими самими даними може не пройти імпорт.

Чи можна залишити товар без фото?

Так, для Prom picture необов'язкове. Але якщо посилання є і воно некоректне, ми попереджаємо: площадка може показати товар без зображення або відхилити оновлення.

Що буде з товаром, якого немає в наявності?

Ми не видаляємо його з фіда. Передаємо available=false , щоб зберегти історію товару й позиції в каталозі; рішення про приховування ухвалює налаштування магазину. Джерело вимог: довідка Prom.ua про імпорт XML/YML.

наступний крок

Надішліть прайс — повернемо розбір перших 50 рядків

Площадка, формат і дедлайн — одним повідомленням. Файл може бути «брудним», саме для цього ми й потрібні.