Ця стаття також доступна на:

Автоматична передача вашого каталогу в Pricer24: загальні принципи та вимоги

Ця стаття описує, як налаштувати автоматичну передачу вашого каталогу товарів у Pricer24, які протоколи підтримуються та як працює механізм оновлення даних.

Для чого потрібен фід каталогу

Фід каталогу — це файл із переліком ваших товарів, категорій, цін, наявності та характеристик.
На основі цього файлу Pricer24 формує та регулярно оновлює ваш асортимент у системі (зокрема, в модулі «Товари»).

Усі аналітичні звіти, порівняння з конкурентами та правила ціноутворення базуються на даних вашого фіду.

Способи передачі та формати

Ви надаєте посилання (URL) на файл фіду, а сервер Pricer24 регулярно завантажує його за цим посиланням за узгодженим розкладом (наприклад, кожні кілька годин або раз на добу).

Протоколи передачі:

HTTPS / HTTP (рекомендовано)
HTTPS + Basic Authentication (з логіном та паролем у запиті)
HTTPS з обмеженням доступу за IP-адресою (IP Whitelist для серверів Pricer24)
FTP / SFTP

Підтримувані формати:

JSON — наш основний рекомендований формат. Детальні вимоги дивіться у статті ТЗ на розробку JSON-фіду каталогу.
Hotline XML — стандартний формат прайс-листів Hotline.
YML (Prom.ua / Rozetka XML) — стандартні товарні фіди маркетплейсів.
CSV / Excel — для невеликих каталогів або специфічних облікових систем.

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

Загальні принципи синхронізації

Повнота каталогу: кожен файл фіду має містити повний і актуальний перелік товарів на момент генерації.
Автоматичний Diff: після кожного завантаження Pricer24 автоматично порівнює новий файл із попереднім станом і оновлює лише змінені параметри (ціну, наявність, нові характеристики).
Стиснення: для каталогів обсягом понад 10 000 товарів рекомендовано використовувати gzip-стиснення (передавати файл із розширенням .json.gz або з заголовком Content-Encoding: gzip). Ліміт розміру файлу відсутній.
Актуальність: активними в системі вважаються лише ті товари, які присутні у фіді на момент останнього завантаження. Товари, що зникли з фіду, автоматично переходять у статус архівних.

Правило унікальності та незмінності ID

Кожен товар, категорія та тип ціни мають свій унікальний ідентифікатор id. Це ключове поле, за яким Pricer24 ідентифікує сутність у системі.

id має залишатися незмінним протягом усього часу роботи з Pricer24.

Як система обробляє різні випадки:

Оновлення параметрів існуючого товару:

Якщо запис із таким id уже є в Pricer24, система оновить його назву, ціни, наявність, характеристики чи посилання. Всі зіставлення (матчинг) цього товару з пропозиціями конкурентів повністю зберігаються.
Наприклад:
id = 100 | Purina Pro Adult turkey 85g → id = 100 | Корм для котів Purina Pro з індичкою 85г
(товар оновлюється, зв'язки з конкурентами не порушуються).

Додавання нового товару:

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

Зміна ID у того ж самого товару:

Якщо у товару змінився id (наприклад, був id = 122, а став id = 133 для того самого iPhone), Pricer24 сприйме старий товар як видалений, а новий — як абсолютно новий товар.

Це призведе до:

Повної втрати зіставлень (матчингу) з товарами конкурентів.
Утворення дублів товару в системі.
Необхідності повторного ручного зіставлення, що тягне за собою додаткові часові та фінансові витрати.

Що далі

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

Оновлено: 04/11/2026

Чи була ця стаття корисною?

Дякуємо!