Feed Bridge — фід Епіцентру з YML і варіанти для Google Merchant

Feed Bridge — сервіс CatCode, який бере фід вашого магазину за посиланням і віддає перетворений за постійним посиланням. Нічого не встановлюєте: це для магазинів на Хорошопі, Prom та інших платформах, куди свій модуль не поставиш, а фід є.

Два режими: YML → XML Епіцентру (без рівня shop, з кодами категорій і характеристик) і фід Google Merchant / Meta з варіантами — додаємо g:item_group_id, g:size і g:color, щоб розміри й кольори одного товару склеїлись в одну картку замість дублів.

Перевірити можна безкоштовно. Без ліцензії створюєте один тестовий міст: звіт по всьому фіду і тестовий файл на перші 20 товарів. Постійне посилання, оновлення за розкладом і до 2 мостів — з ліцензією або 7-денним тріалом.

Що ви отримуєте

• Постійне посилання на готовий фід — вставляєте його в кабінет маркетплейсу чи Merchant Center один раз, далі файл оновлюється за розкладом.
• Звіт по кожному оновленню: скільки товарів пройшло, які відхилено і чому (немає фото, не зіставлена категорія, невідоме значення характеристики, повтор id) і що записано із зауваженнями — наприклад, штрихкод з неправильною контрольною цифрою.
• Захист від битого фіду: якщо ваш фід обірвався, віддав 404, дав порожній результат або кількість товарів впала нижче 30% від попереднього оновлення — лишається попередня версія, а у звіті видно помилку.
• Без зайвої роботи: якщо ваш сервер віддає ETag або Last-Modified і фід не змінився, готовий файл не перебудовується.

Як це працює — крок за кроком

1. Входите на catcode.com.ua і відкриваєте Мій акаунт → Feed Bridge.
2. Створюєте міст: режим, посилання на свій фід; для Google — за бажанням другий фід того ж магазину з варіантами (YML або фід Facebook), для Епіцентру — за бажанням токен API.
3. Перша конвертація стартує протягом хвилини. Дивитесь звіт і тестовий файл.
4. Для Епіцентру зіставляєте категорії, а за потреби — характеристики й значення на вкладці «Відповідність».
5. Вмикаєте тріал або ліцензію — міст отримує постійне посилання, яке вставляєте в кабінет Епіцентру чи Merchant Center.
6. Далі фід оновлюється сам кожні 6, 12 або 24 години; «Оновити зараз» — не частіше ніж раз на 2 хвилини.

Режим «YML → Епіцентр»

• Готовий файл — за інструкцією Епіцентру з XML-імпорту: yml_catalog → offers без рівня shop, category з кодом, attribute_set, param з paramcode і valuecode.
• Фото через «, », назва українською до 150 символів, опис у CDATA лише з дозволеними тегами (p, br, b, ul, li, table, tr, td): script, style та інші теги вирізаються.
• Наявність — in_stock, under_the_order або out_of_stock; що робити з порожнім available, обираєте в налаштуваннях моста.
• Ціни в іншій валюті перераховуються за курсом із самого фіду; немає курсу — товар потрапляє у звіт з причиною.
• З токеном API Епіцентру завантажуємо довідник (категорії, набори характеристик, коди значень) і зіставляємо характеристики за назвою автоматично.
• Без токена коди категорій і характеристик вписуєте вручну, характеристики йдуть текстом без кодів значень.

Режим «Google Merchant / Meta»

• На вході — ваш фід Google Merchant або Meta (RSS чи Atom з атрибутами g:). Решта фіду копіюється як є, змінюються лише атрибути варіантів.
• Групу, розмір і колір беремо з другого фіду того ж магазину (зіставлення за id, потім за посиланням, потім за артикулом), з однакового посилання на сторінку товару (опція) або з різниці в назвах — «… 38» / «… 39», кольори українською, російською й англійською.
• Значення, які вже є у вашому фіді, не перезаписуємо, якщо ви цього не ввімкнули.
• Значення приводимо до вимог Google: item_group_id до 50 символів, колір — до трьох через «/», без «див. фото» і цифр.

Що під капотом

• Фід читається потоково, тож пам’ять не росте з розміром каталогу: на тестовому стенді 30 000 товарів (близько 19 МБ YML) перетворювались за 1,5–2 секунди.
• Готовий файл віддається як статичний файл — Google, Meta чи Епіцентр забирають його без навантаження на PHP. Новий файл підміняє старий одним кроком, тож маркетплейс не отримає недописаний фід.
• Зовнішні сутності XML не розгортаються, адреси локальної мережі як джерело відхиляються.
• Кожен клієнт бачить лише свої мости; посилання на готовий фід містить випадковий 32-символьний ключ.
• Завантажені джерела й тестові файли зберігаються поза публічною частиною сервера.

Як підключити

1. Увійдіть або зареєструйтесь на catcode.com.ua.
2. Відкрийте Мій акаунт → Feed Bridge і створіть міст.
3. Перевірте звіт, потім натисніть «Спробувати 7 днів безкоштовно» або придбайте ліцензію.
4. Скопіюйте посилання на готовий фід у кабінет Епіцентру чи Merchant Center.

Що перевірено, а що ні

• Перевірено: конвертація реальних фідів наших демо-магазинів (OpenCart з модулем Market Feeds — 23 товари, WooCommerce — 41 товар з варіантами) і віддача готового фіду з catcode.com.ua; захист від битого, порожнього й неповного фіду; ліміти; закінчення й продовження ліцензії.
• Ще не перевірено: імпорт готового файлу в реальний кабінет продавця Епіцентру і завантаження довідника з живим токеном (запити до API Епіцентру повторюють наш модуль Епіцентру для WooCommerce, перевірений на живому кабінеті), а також діагностика фіду з варіантами в Google Merchant Center. Підключаєте першими — напишіть нам, перевіримо разом.