Интеграция с Prom.ua подключает ваш кабинет к Elbuz: заказы приходят через Prom API по токену в один список с заказами сайта и Rozetka, а товары, цены и наличие уходят на Prom XML-фидом из вашего каталога.
Шесть дел, которые без неё делаются руками в кабинете Prom или файлом Excel каждое утро.
Каталог XML-фидом
Elbuz собирает ваш каталог в фид формата Prom (YML) и кладёт его по постоянной ссылке, а Prom сам забирает его по расписанию. В фид идут название, описание, цена, фото, производитель и характеристики, а размеры и цвета складываются в одну карточку с выбором варианта. Данные товара ведутся один раз в каталоге товаров (PIM).
Файл XLSX без дублей
Для полного обмена со всеми колонками Prom тот же каталог выгружается файлом Excel в формате Prom: лист товаров и лист групп. В каждой строке стоит идентификатор товара, поэтому Prom обновляет существующие позиции, а не создаёт копии. Ключ в файле и в фиде одинаковый: каталог можно залить файлом, а дальше держать свежим фидом.
Цены с комиссией Prom
Шаблон выгрузки берёт своё поле цены или считает её формулой — например, базовая цена плюс наценка, покрывающая комиссию Prom по выбранному режиму ProSale. Цена на вашем сайте и на Rozetka остаётся своей. Правила наценки.
Наличие без ручных правок
Наличие считается по вашим складам и прайсам поставщиков, и каждый прогон собирает фид заново. Товар без остатка остаётся в фиде с пометкой «нет в наличии». Если ночью сломался прайс и наличие обвалилось, стоп-правило остановит выгрузку, и по ссылке останется вчерашний фид.
Заказы через API
Заказы Prom приходят по расписанию документом «Заказ покупателя» вместе с покупателем, доставкой, ТТН, оплатой, промокодом и комиссией Prom. Позиции находят свои карточки по коду товара, повторная загрузка дубля не создаёт. Дальше их обрабатывают рядом с заказами сайта и Rozetka — см. управление заказами.
Статусы и сообщения покупателей
Статусы заказа и оплаты Prom сводятся к вашим без настройки. Включите передачу статусов, и смена статуса в Elbuz уйдёт на Prom, а отмена — с причиной. Сообщения покупателей Prom становятся обращениями в службе поддержки, и ответ менеджера уходит обратно на Prom.
2
Prom API: что он даёт и что Elbuz делает сам
Чтобы подключить Prom через API, писать код и нанимать фрилансера не нужно: запросы, лимиты и разбор ответов Elbuz берёт на себя.
Что открывает API Prom.ua
Prom.ua даёт программам доступ к кабинету компании: заказам, товарам и группам, клиентам и сообщениям. Программа обращается к нему с токеном, который продавец создаёт в своём кабинете. Описание методов — в документации API Prom.ua, но для работы через Elbuz читать её не обязательно.
Что Elbuz берёт на себя
Забирает заказы страницами в пределах лимитов Prom и помнит, на каком остановился, поэтому каждый прогон берёт только новые. Сводит статусы, виды оплаты и доставки, привязывает позиции к карточкам, заводит покупателей. Каталог тем временем идёт на Prom фидом по ссылке: так Prom обновляет тысячи товаров за раз.
Prom не присылает мгновенных уведомлений о новых заказах: Elbuz обращается сам, с той частотой, которую вы ставите в расписании шаблона.
3
Где взять токен Prom API
Токен — единственное, что Elbuz нужно от Prom. Его создаёт владелец компании или пользователь с ролью «Администратор».
Права«Заказы и сообщения»чтение — чтобы забирать заказы; чтение и запись — чтобы передавать статусы и отвечать покупателям
Срокдо одного годасрок задаёте вы; перед окончанием продлите токен или вставьте новый в шаблон
Токен открывает доступ к кабинету, поэтому храните его как пароль. Порядок и права устанавливает Prom, и они могут меняться. Пошаговое подключение — в справке по Prom ↗ (открывается в новой вкладке).
4
Как это работает: Prom — ещё один канал вашего каталога
Отдельная база товаров под Prom не нужна: он берёт товары из каталога, который вы уже ведёте для сайта и других маркетплейсов.
Каталогтовары, цены и остатки от поставщиков и с вашего склада
Шаблон PromXML-фид или XLSX: свой отбор товаров, правило цены и расписание
Prom забираетфид по постоянной ссылке обновляет цены и наличие
Заказы обратночерез API — в тот же список, что и заказы сайта
Те же окна работают со всеми маркетплейсами: карточка товара, шаблоны выгрузки и список заказов.
Одна карточка товара — для Prom, сайта и других маркетплейсовШаблоны выгрузки: отдельный для каждого маркетплейса и фидаЗаказы Prom, Rozetka и сайта в одном списке
6
Как подключить Prom к Elbuz
Два шаблона: выгрузка несёт каталог на Prom, загрузка забирает заказы. Оба настраиваются в окнах Elbuz.
Каталогуже продаёте на Prom — загрузите его файл XLSX в Elbuz, группы станут категориями
Фидсоздайте шаблон выгрузки «prom.ua (XML)» и вставьте его ссылку в кабинет Prom
Токенвставьте токен в шаблон загрузки «Prom.ua (API)»
Проверказапустите шаблон и сверьте несколько заказов с кабинетом Prom
Расписаниефид и заказы обновляются дальше без вас
Несколько кабинетов Prom — несколько шаблонов, заказы всех ложатся в один список. Перенос данных из другой программы или сайта служба поддержки берёт на себя бесплатно. Все площадки — выгрузка товаров на маркетплейсы.
Это официальный интерфейс Prom.ua, через который программы работают с кабинетом компании: заказами, товарами, клиентами и сообщениями. Доступ открывает токен, созданный в кабинете. В Elbuz через него приходят заказы, сообщения покупателей и уходят обратно статусы, а каталог Prom забирает XML-фидом.
Как получить токен для API Prom.ua?
В кабинете Prom: «Настройки» → «Управление API-токенами» → «Создать токен», с правами на группу «Заказы и сообщения». Создаёт его владелец компании или администратор. Пошагово — в справке по Prom.
Нужен ли программист, чтобы подключить Prom через API?
Нет. В Elbuz уже есть готовые шаблоны: «Prom.ua (API)» для заказов и «prom.ua (XML)» для каталога. Вы вставляете токен, копируете ссылку на фид в кабинет Prom и ставите расписание.
Как выгрузить товары на Prom: XML или XLSX?
Для ежедневного обновления цен и наличия удобнее XML-фид: Prom сам забирает его по ссылке. Для полного обмена со всеми колонками Prom — файл XLSX. Идентификатор товара в них одинаковый, поэтому форматы можно совмещать. См. XML-фид для Prom и файл XLSX.
Не задвоит ли Prom товары после выгрузки из Elbuz?
Нет. Prom дублирует позиции, когда в файле нет идентификатора товара. Elbuz ставит его в каждую строку файла и в каждое предложение фида, поэтому Prom обновляет существующие позиции, а новые добавляет.
Меняется ли статус заказа на Prom, когда я обрабатываю его в Elbuz?
Да, если в «Обращениях» включён переключатель «Передавать статус заказа на маркетплейс» и ваш статус сопоставлен со статусом Prom. Из коробки он выключен. Изменения, сделанные в кабинете Prom, в уже загруженный заказ не возвращаются. См. действия AI с заказами.
Как заложить комиссию Prom и ProSale в цену?
Шаблон выгрузки Prom считает свою цену формулой — например, базовая цена плюс наценка, покрывающая комиссию выбранного режима ProSale, — и не меняет цену на сайте. См. правила наценки. Тарифы и режимы ProSale — в статье как продавать на Prom.ua, формулы с примерами — в статье как посчитать наценку.
Как быстро заказы Prom появляются в Elbuz?
При очередном запуске по расписанию: Prom не присылает мгновенных уведомлений, Elbuz обращается сам. Для активного магазина ставьте расписание чаще — лимиты Prom это позволяют.
Можно подключить несколько кабинетов Prom?
Да. Каждый кабинет — отдельный шаблон со своим токеном и расписанием, а заказы всех ложатся в один список. Различает их колонка «Источник: название».
Отдел сайта и маркетплейсов входит в вашу AI-корпорацию вместе со всеми остальными отделами. 50 € на балансе после регистрации и 14 дней, чтобы проверить интеграцию на своих товарах.