Отправляйте в Hopi товары,
которые стоит показывать.

Hopi — турецкое мобильное приложение лояльности и кешбэка, у которого более 12,6 млн участников и партнёрства с более чем 250 брендами в сферах моды, продуктов питания, общепита, путешествий, технологий и других. Покупатели получают Paracık — бонусную валюту Hopi, где 1 Paracık равен 1 турецкой лире, — каждый раз, когда совершают покупку у бренда-партнёра и показывают QR-код Hopi на кассе в магазине или при онлайн-оплате. Накопленные Paracık можно потратить на будущие покупки у любого бренда-партнёра без минимальной суммы корзины, пока они не сгорят в конце календарного месяца, в котором исполняется год с момента их начисления.

В 2021 году Hopi также запустила Hopishop — маркетплейс внутри приложения, где бренды-партнёры напрямую размещают товары для просмотра и покупки; по структуре он похож на другие турецкие маркетплейсы, такие как Trendyol или Hepsiburada. Это различие важно для управления фидами: основная механика лояльности Hopi работает на интеграции кодов на уровне транзакций, а не на товарном каталоге, тогда как Hopishop — та часть экосистемы, которая действительно использует структурированные товарные данные.

Для брендов, продающих через Hopishop, чистый и актуальный товарный фид определяет, видны ли товары вообще участникам приложения, просматривающим акции и предложения, и точны ли цены, остатки и данные о вариантах в момент покупки. Поскольку листинги Hopishop находятся внутри приложения, которое миллионы людей и так открывают, чтобы проверить предложения кешбэка, синхронизация товарных данных снижает вероятность поступления заказов на отсутствующие товары, товары с неверной ценой или неправильной категорией, — а такие проблемы быстро всплывают на маркетплейсе, где автоматическое выставление счетов и создание отгрузочных этикеток завязаны на данные заказов.

Стоит чётко обозначить различие, которое сбивает с толку многих продавцов: подключение к «Hopi» для кешбэк-кампаний — это не та же интеграция, что подключение товарного фида к Hopishop. Собственная документация Hopi описывает партнёрство с брендами как процесс интеграции кодов: команда Hopi, команда бренда и поставщики POS-, e-commerce- и ERP-систем бренда согласованно встраивают код кампании в процесс оформления заказа, чтобы Paracık корректно начислялись и списывались. Учёт продаж по этим кампаниям ведётся через отчётность в партнёрском стиле и ссылки с UTM-метками, а не через товарный каталог.

1. Если ваша цель — запуск кешбэк- или скидочных кампаний через приложение Hopi, вам нужна описанная выше интеграция кодов на уровне оформления заказа — она согласуется непосредственно с партнёрской командой Hopi и вашим поставщиком POS/e-commerce, а не через фид.
2. Если ваша цель — размещать и продавать товары внутри Hopishop, это интеграция, для которой важен фид, и она работает как стандартная загрузка товаров на маркетплейс.

Feedance применим во втором случае. Если вы не уверены, что относится к вашему бизнесу, задайте этот вопрос своему менеджеру Hopi до начала любой работы с фидом.

Hopi не опубликовала общедоступную спецификацию фида для самостоятельной настройки (для Hopishop не найдено ни открытой XML/JSON-схемы, ни портала для разработчиков, ни документации по полям — ни на турецком, ни на английском). На практике, судя по руководствам по панели продавца и документации сторонних интеграторов, продавцы подключаются к Hopishop одним из нескольких способов:

1. Ручное или массовое управление товарами в панели продавца Hopishop, включая загружаемые файлы-шаблоны для массового создания товаров, обновления цен и остатков.
2. Интеграция через e-commerce- или ERP-платформы, у которых уже есть коннектор Hopishop (интеграторы приводят в пример Ticimax, T-Soft и StockMount), — они выполняют сопоставление категорий и передачу товаров от имени продавца.
3. Генерация XML из ERP для Hopishop собственными силами, как это реализовано в независимо опубликованных инструментах интеграции, которые сопоставляют товары между ERP-системой и Hopishop перед их отправкой.

Учётные данные API (токен доступа) для Hopishop выдаёт непосредственно служба поддержки продавцов Hopishop, а не открытая самостоятельная регистрация. Поскольку опубликованной спецификации, на которую можно уверенно опираться, нет, практичный подход — уточнить текущие требования к полям и способ передачи у вашего контактного лица в Hopishop, а затем сопоставить исходный каталог с этим форматом. Именно такую работу по сопоставлению Feedance и выполняет, когда целевые поля известны.

Hopi не опубликовала официальную спецификацию фида на уровне атрибутов. Приведённые ниже атрибуты взяты из подробного стороннего разбора форм создания отдельного товара и массовой загрузки в реальной панели продавца Hopishop, а не из официального документа Hopi для разработчиков, — рассматривайте их как надёжную отправную точку, а не как гарантированно актуальную спецификацию, и сверьтесь со своей панелью продавца перед сопоставлением фида.

Поскольку Hopishop не предлагает открытого, единообразно задокументированного формата фида, подключение через Feedance — это процесс согласования и сопоставления, а не шаблон «в один клик»:

1. Подтвердите статус своего аккаунта продавца в Hopishop и получите текущий способ передачи и учётные данные непосредственно у службы поддержки продавцов Hopishop.
2. Определите текущие обязательные поля и формат передачи (шаблон загрузки в панели, формат ERP-коннектора или XML) для вашего аккаунта, поскольку в публичной документации это не стандартизировано.
3. Подключите мастер-каталог товаров — из витрины, ERP или существующего фида — к Feedance как единый источник достоверных данных.
4. Сопоставьте поля каталога с атрибутами, которые сейчас ожидает Hopishop (название, категория, код товара, штрихкод, бренд, данные вариантов, цена, НДС, остаток, транспортная компания, срок доставки, изображения), с учётом требований панели, подтверждённых на шаге 2.
5. Сформируйте выгрузку в формате, который фактически принимает ваше подключение к Hopishop, и проверьте небольшую партию листингов, прежде чем отправлять весь каталог.
6. Автоматизируйте регулярные обновления, чтобы изменения цен и остатков на вашей стороне попадали в Hopishop без повторных ручных загрузок.

Hopi не опубликовала обязательную или рекомендуемую частоту обновления для Hopishop. Сторонние интеграторы описывают, что остатки «поддерживаются в актуальном состоянии» через подключённые учётные/ERP-системы, а продажи передаются обратно ежедневно, — это говорит о том, что как минимум ежедневная синхронизация является стандартной практикой среди продавцов, использующих автоматические коннекторы. Согласно общей практике электронной коммерции, цены и остатки нужно синхронизировать не реже раза в день, а для быстро продающихся товаров или товаров с ограниченным запасом — в идеале почти в реальном времени, поскольку листинг на маркетплейсе с неверным наличием или ценой напрямую грозит отменами заказов и нагрузкой на поддержку.

Публично задокументированного перечня сообщений об ошибках или кодов отклонения Hopishop, характерных для Hopi, найти не удалось. Приведённые ниже проблемы — это общие закономерности интеграции с маркетплейсами, отмеченные турецкими e-commerce-интеграторами, которые работают с Hopishop и аналогичными маркетплейсами. Используйте их как чек-лист, а не как проверенные тексты ошибок Hopi:

1. Несоответствие категорий: товары, сопоставленные с неправильной или неподдерживаемой категорией Hopishop, часто называют причиной сбоев размещения и сопоставления при настройке интеграции.
2. Отсутствие обязательных полей: листинги без обязательного поля, например штрихкода, ставки НДС, транспортной компании или срока доставки, как правило, отклоняются или остаются незавершёнными в панели продавца.
3. Пробелы в данных вариантов: вариантные товары без изображений, цены или остатка для каждого варианта часто некорректно отображаются в листингах с вариантами.
4. Устаревшие учётные данные: поскольку доступ к API Hopishop выдаётся вручную службой поддержки продавцов, а не в режиме самообслуживания, истёкшие или неправильно настроенные токены доступа — регулярное препятствие для интеграции, о котором сообщают сторонние коннекторы.

Если вы столкнулись с сообщением об ошибке, не описанным здесь, надёжнее всего уточнить его значение непосредственно у службы поддержки продавцов Hopishop, поскольку Hopi не публикует общедоступный справочник кодов ошибок.

Это общие рекомендации по фидам для маркетплейсов, а не требования, специфичные для Hopi:

1. Делайте названия товаров понятными и насыщенными атрибутами (бренд, модель, ключевая характеристика), а не рекламными, поскольку поиск и размещение по категориям на маркетплейсах обычно отдают предпочтение описательным названиям, а не маркетинговым текстам.
2. Назначайте наиболее точную подходящую категорию, а не широкую родительскую, чтобы сократить ошибки размещения и сопоставления, которые интеграторы неизменно называют главной причиной проблем при загрузке на маркетплейсы.
3. Сохраняйте значения штрихкода и кода товара стабильными и уникальными при обновлениях — именно по этим ключам большинство инструментов массового обновления и интеграторов сопоставляют ваши существующие листинги.
4. Синхронизируйте остатки и цены не реже раза в день, а для ограниченных или быстро продающихся запасов — чаще, чтобы избежать заказов на отсутствующие товары.
5. Передавайте полные данные на уровне вариантов (изображения, цена, остаток) для каждого сочетания размера и цвета, а не только для родительского товара, поскольку неполные варианты — частая причина проблем с отображением листингов.

Hopi и Hopishop — это одно и то же?
Нет. Hopi — приложение лояльности и кешбэка, построенное вокруг бонусов Paracık и кодов кампаний брендов; Hopishop — функция маркетплейса внутри приложения Hopi, запущенная в 2021 году, где бренды-партнёры напрямую размещают и продают товары. Управление фидами относится к Hopishop, а не к механике кешбэк-кампаний Hopi.

Публикует ли Hopi общедоступный API товарных фидов?
Подтвердить это не удалось. Для Hopishop нет публичного портала для разработчиков или открытой спецификации фида; учётные данные и детали интеграции предоставляет непосредственно служба поддержки продавцов Hopishop, а многие продавцы интегрируются через e-commerce- или ERP-платформы, у которых уже есть коннектор Hopishop.

Нужна ли зарегистрированная компания, чтобы продавать на Hopishop?
Да — как и другие турецкие маркетплейсы, Hopishop требует компанию, зарегистрированную в налоговых органах и способную выставлять счета; по данным руководств для продавцов, опубликованных сторонними интеграторами, само открытие магазина бесплатно.

Может ли Feedance автоматически сформировать готовый для Hopishop фид без какой-либо настройки?
Не «из коробки», поскольку у Hopishop нет фиксированной публичной спецификации. Feedance может сопоставить и автоматизировать фид после того, как вы уточните текущие требования к полям и способу передачи у службы поддержки продавцов Hopishop, а затем поддерживать синхронизацию этого фида.

Что важнее всего исправить перед подключением фида Hopishop?
Прежде всего правильно настройте сопоставление категорий. Неправильное назначение категорий в документации интеграторов чаще всего называют причиной проблем с листингами на маркетплейсах, и оно влияет на всё последующее — видимость, позиции в поиске и наборы обязательных атрибутов.

Hopi — турецкое мобильное приложение программы лояльности и кешбэка. Участники получают Paracık — бонусную валюту Hopi — при покупках у партнёрских брендов в магазинах или онлайн и могут тратить её на последующие покупки у любого партнёрского бренда. Приложение работает с брендами из сфер моды, продуктов, общественного питания, путешествий, технологий и других отраслей.

Hopi также ведёт Hopishop — маркетплейс внутри приложения, где партнёрские бренды размещают товары, которые участники могут просматривать и покупать. Именно эта часть Hopi использует товарные данные. Участие в кешбэк-кампаниях Hopi — отдельная интеграция, которая связывает системы оформления заказа и кассовые системы бренда с Hopi, и товарный фид для неё не нужен.

Hopi не публиковал открытую спецификацию фида для Hopishop. Продавцы обычно управляют товарами через панель продавца Hopishop с шаблонами массовой загрузки, через платформы электронной коммерции или ERP, предлагающие коннектор для Hopishop, либо через индивидуальные XML-интеграции, согласованные со службой поддержки Hopishop, которая также предоставляет учётные данные для API.

Для продавцов на Hopishop точные товарные данные обеспечивают надёжность магазина в приложении. Правильные названия товаров, категории, штрихкоды, данные о бренде и вариантах, изображения, цены и остатки помогают участникам находить товары и сокращают количество заказов на товары, которых нет в наличии или у которых указана неверная цена.