Отдел сайта и маркетплейсов один из отделов вашей AI-корпорации

Интеграция с Prom.ua: Prom API без программиста

Интеграция с Prom.ua подключает ваш кабинет к Elbuz: заказы приходят через Prom API по токену в один список с заказами сайта и Rozetka, а товары, цены и наличие уходят на Prom XML-фидом из вашего каталога.

  • Prom API
  • Токен
  • XML-фид
  • YML
  • XLSX
  • Заказы
  • Статусы
  • ProSale
Отдел сайта и маркетплейсов Elbuz в разрезе: товары из каталога упаковываются в цветные фиды и по трубам идут к киоскам площадок, а заказы с них возвращаются в одну очередь

Что интеграция с Prom делает за продавца

Шесть дел, которые без неё делаются руками в кабинете 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.

Prom API: что он даёт и что Elbuz делает сам

Чтобы подключить Prom через API, писать код и нанимать фрилансера не нужно: запросы, лимиты и разбор ответов Elbuz берёт на себя.

Что открывает API Prom.ua

Prom.ua даёт программам доступ к кабинету компании: заказам, товарам и группам, клиентам и сообщениям. Программа обращается к нему с токеном, который продавец создаёт в своём кабинете. Описание методов — в документации API Prom.ua, но для работы через Elbuz читать её не обязательно.

Что Elbuz берёт на себя

Забирает заказы страницами в пределах лимитов Prom и помнит, на каком остановился, поэтому каждый прогон берёт только новые. Сводит статусы, виды оплаты и доставки, привязывает позиции к карточкам, заводит покупателей. Каталог тем временем идёт на Prom фидом по ссылке: так Prom обновляет тысячи товаров за раз.

Prom не присылает мгновенных уведомлений о новых заказах: Elbuz обращается сам, с той частотой, которую вы ставите в расписании шаблона.

Где взять токен Prom API

Токен — единственное, что Elbuz нужно от Prom. Его создаёт владелец компании или пользователь с ролью «Администратор».

  • Гдекабинет Prom«Настройки» → «Управление API-токенами» → «Создать токен»
  • Права«Заказы и сообщения»чтение — чтобы забирать заказы; чтение и запись — чтобы передавать статусы и отвечать покупателям
  • Срокдо одного годасрок задаёте вы; перед окончанием продлите токен или вставьте новый в шаблон

Токен открывает доступ к кабинету, поэтому храните его как пароль. Порядок и права устанавливает Prom, и они могут меняться. Пошаговое подключение — в справке по Prom (открывается в новой вкладке).

Как это работает: Prom — ещё один канал вашего каталога

Отдельная база товаров под Prom не нужна: он берёт товары из каталога, который вы уже ведёте для сайта и других маркетплейсов.

  1. Каталогтовары, цены и остатки от поставщиков и с вашего склада
  2. Шаблон PromXML-фид или XLSX: свой отбор товаров, правило цены и расписание
  3. Prom забираетфид по постоянной ссылке обновляет цены и наличие
  4. Заказы обратночерез API — в тот же список, что и заказы сайта

Тот же каталог наполняет ваш сайт, Rozetka, Эпицентр и товарные фиды для Google Shopping, Meta и TikTok.

Экраны Elbuz: каталог, шаблоны выгрузки и заказы

Те же окна работают со всеми маркетплейсами: карточка товара, шаблоны выгрузки и список заказов.

Карточка товара в Elbuz: название и описания на каждом языке, фото, производитель, категория и заполненность
Одна карточка товара — для Prom, сайта и других маркетплейсов
Шаблоны выгрузки в Elbuz: отдельный для каждого маркетплейса, фида и сайта
Шаблоны выгрузки: отдельный для каждого маркетплейса и фида
Список заказов в Elbuz: заказы маркетплейсов и сайта с плитками оплат и доставки
Заказы Prom, Rozetka и сайта в одном списке

Как подключить Prom к Elbuz

Два шаблона: выгрузка несёт каталог на Prom, загрузка забирает заказы. Оба настраиваются в окнах Elbuz.

  1. Каталогуже продаёте на Prom — загрузите его файл XLSX в Elbuz, группы станут категориями
  2. Фидсоздайте шаблон выгрузки «prom.ua (XML)» и вставьте его ссылку в кабинет Prom
  3. Токенвставьте токен в шаблон загрузки «Prom.ua (API)»
  4. Проверказапустите шаблон и сверьте несколько заказов с кабинетом Prom
  5. Расписаниефид и заказы обновляются дальше без вас

Несколько кабинетов Prom — несколько шаблонов, заказы всех ложатся в один список. Перенос данных из другой программы или сайта служба поддержки берёт на себя бесплатно. Все площадки — выгрузка товаров на маркетплейсы.

Вопросы об интеграции с Prom.ua

Пошаговое подключение — в справке по Prom.

Что такое Prom API?

Это официальный интерфейс 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?

Да. Каждый кабинет — отдельный шаблон со своим токеном и расписанием, а заказы всех ложатся в один список. Различает их колонка «Источник: название».

14 дней бесплатно

Подключите Prom к своему каталогу

Отдел сайта и маркетплейсов входит в вашу AI-корпорацию вместе со всеми остальными отделами. 50 € на балансе после регистрации и 14 дней, чтобы проверить интеграцию на своих товарах.

Попробовать бесплатно