Prom.ua

Дополнение Prom.ua связывает ваш магазин с Prom в обе стороны. Магазин сам собирает файл товаров в формате Prom и обновляет его по расписанию, а Prom забирает файл по постоянной ссылке. Заказы с Prom появляются в разделе «Заказы» рядом с заказами с сайта, по цене Prom и с отложенным под них остатком.

Когда вы принимаете, отменяете или отправляете заказ, Prom сам узнаёт его статус и номер накладной. Продали товар на сайте, и примерно через минуту Prom видит новый остаток. Если покупатель оплатил заказ через Prom, Prom получает ссылку на чек вашей кассы, а возврат денег магазин отправляет на Prom сам.

На этой странице весь путь по шагам: от установки дополнения до первого принятого заказа. Общее устройство раздела описано на странице Как устроен раздел «Маркетплейсы».

Что понадобится#

• Кабинет компании на Prom. Ключ API в нём может создать владелец компании или пользователь с ролью администратора.
• Курс гривны, если основная валюта магазина другая. Prom принимает цены и присылает заказы в гривнах. Добавьте гривну в «Настройки» → «Основные настройки» → «Валюты», иначе файл не соберётся и заказы не примутся.
• Настроенная строка планировщика. Файл, заказы и остатки магазин обрабатывает по расписанию, см. Обслуживание.

Шаг 1. Установите дополнение#

Откройте «Настройки» → «Платформа» → «Установка и обновления» и установите дополнение Prom.ua. После этого в разделе «Маркетплейсы» главного меню появится пункт Prom.ua. Нажмите на него, чтобы открыть экран площадки.

У Prom на экране пять вкладок: «Товары», «Категории», «Отбор и цены», «Заказы» и «Подключение». Вкладки «Параметры» у Prom нет: характеристики уходят на Prom названием и значением, и сопоставлять их с чем-либо не нужно.

Шаг 2. Заполните вкладку «Подключение»#

Во вкладке три поля:

• «Название магазина в файле». Если оставить его пустым, берётся название из основных настроек магазина;
• «Компания» — название вашей компании, например ТОВ «Мій магазин»;
• «Ключ API Prom». Он нужен только для заказов и остатков: с ним магазин забирает заказы Prom, сообщает Prom их статус и номер накладной и обновляет остаток после продажи. Для выгрузки товаров ключ не нужен. Как создать ключ, написано ниже.

Нажмите «Сохранить». После сохранения ключ в поле не показывается. Чтобы заменить его, впишите новый. Пустое поле оставляет прежний ключ.

Ниже на той же вкладке стоит справочник категорий Prom. Нажмите «Загрузить справочник»: Prom отдаёт его без ключа. Рядом появится, сколько категорий в справочнике и когда он обновлялся. Свежую версию вы забираете кнопкой «Обновить справочник».

Как создать ключ API в кабинете Prom#

Названия пунктов ниже даны так, как они написаны в украинском интерфейсе кабинета Prom.

1. В кабинете компании откройте «Налаштування» → «Управління API-токенами» и нажмите «Створити токен».
2. Название ключа можно не указывать, Prom придумает его сам.
3. В поле «Дійсний до» выберите срок действия. Prom разрешает от одного дня до одного года.
4. В блоке доступа поставьте «читання та запис» для двух групп: «Замовлення і повідомлення» и «Продукти та групи». Первая нужна, чтобы забирать заказы и сообщать Prom их статус, накладную, чек и возврат. Вторая нужна, чтобы обновлять на Prom остаток сразу после продажи. С доступом «тільки читання» магазин заказы увидит, но изменить на Prom ничего не сможет.
5. Сохраните ключ, откройте его просмотр, скопируйте и вставьте в поле «Ключ API Prom» в магазине.

Срок действия ключа ограничен. За 30 и за 7 дней до его окончания Prom присылает напоминание в кабинет. Продлите срок в том же разделе кабинета Prom: ключ при этом не меняется. Если срок истёк, магазин перестанет забирать заказы и покажет причину «Prom не принял ключ API».

Шаг 3. Настройте выгрузку во вкладке «Отбор и цены»#

Здесь вы решаете, какие товары уходят на Prom и по какой цене. Все правила подробно описаны на странице Отбор товаров и цена на площадке, а ниже — коротко о каждом поле. Правила подействуют со следующей сборкой файла после того, как вы нажмёте «Сохранить».

Блок «Выгрузка»#

• «Название выгрузки» видно только вам: так вы отличаете выгрузки одной площадки.
• «Языки» — на каких языках названия, описания и характеристики уходят на Prom. Если ничего не выбрано, уходят все языки магазина.

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

Блок «Какие товары уходят»#

На Prom уходят только опубликованные товары.

• «Товары» — «Весь каталог» или «Только выбранные категории». Для второго варианта появится поле «Категории», вложенные категории входят сами.
• «Кроме категорий» — категории, которые выгружать не нужно.
• «Только бренды» и «Кроме брендов» — отбор по бренду. Пустое поле означает все бренды.
• «Только с метками» и «Кроме меток» — отбор по меткам товаров.
• «Цена от» и «Цена до» — отбор по цене в магазине, ещё до наценки для Prom.
• «Только товары в наличии». Без этой галочки товар без остатка уходит на Prom с отметкой «нет в наличии», и его карточка на Prom сохраняется. Если в настройках складов разрешён заказ, когда товара нет, такой товар уходит на Prom как товар под заказ.

Блок «Цена на площадке»#

Отправная точка — цена, по которой товар продаётся в магазине, вместе с акциями каталога. На Prom цены уходят в гривнах.

• «Наценка, %» — процент к цене. Отрицательный процент даёт скидку.
• «Наценка, сумма» — сумма в основной валюте магазина, которая прибавляется к каждой позиции.
• «Своя наценка по цене» — свой процент для разных цен. Строки вы добавляете кнопкой «Добавить диапазон», например «от 0 — 20 %» и «от 1000 — 10 %».
• «Округление» — «Не округлять», «До гривны», «Вверх до десятков» или «Вверх на девятку (…9)». Под полями видно, во что превратится цена 1000.
• «Передавать старую цену». Если у товара в магазине есть цена до скидки, Prom покажет скидку.

Блок «Что уходит о товаре»#

• «Описание» — «Полное описание» или «Не передавать».
• «Фото, не больше». Prom всё равно возьмёт не больше 10 фото на позицию.
• «Остаток для товаров без учёта» — какое число отправлять, если остаток артикула не ведётся. Prom принимает только целое число, поэтому дробный остаток уходит округлённым вниз.
• «Ссылки ведут на витрину» — поле видно, если витрин больше одной.
• «Характеристики» — какие характеристики уходят на Prom. Пустое поле означает все видимые характеристики товара. На одну позицию уходит не больше 100 характеристик. Бренд уходит отдельно, как бренд товара.

Кроме этого, в файл попадают артикул, штрихкод, вес и размеры артикула, а также минимальное количество для заказа, если оно у товара целое и больше одного. Артикулы одного товара уходят на Prom отдельными позициями одной группы. Если в кабинете Prom подключено дополнение «Різновиди», Prom покажет их разновидностями одного товара, а без него — отдельными товарами.

Блок «Как часто обновлять файл»#

В поле «Пересобирать» выберите, как часто магазин собирает файл заново: «Каждый час» или раз в 2, 4, 6, 12 или 24 часа. Prom забирает файл по своему расписанию, о нём написано в шаге 6.

Несколько выгрузок#

У Prom может быть несколько выгрузок, и у каждой свой файл и своя ссылка. Например, вы можете выгружать на Prom основной каталог и отдельный файл распродажи с другой наценкой. Кнопка «Новая выгрузка» над сводкой заводит ещё одну. В окне вы задаёте «Название выгрузки» и можете отметить «Взять правила из «…»»: отбор, цены, тексты и языки скопируются, а ссылка будет своя. Новая выгрузка создаётся выключенной.

У каждой выгрузки свои правила, языки, расписание и переключатель «Выгружать на площадку». Подключение, справочник Prom, привязки категорий и решения по отдельным товарам общие для всех выгрузок. Выгрузку, которая больше не нужна, удаляет кнопка «Удалить выгрузку» в блоке «Выгрузка».

Шаг 4. Привяжите категории во вкладке «Категории»#

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

Слева перечислены ваши категории, справа у каждой поле выбора категории Prom. Искать в справочнике можно по названию или номеру категории Prom. Вложенная категория без своего выбора уходит туда же, куда родительская, поэтому обычно достаточно выбрать категории верхнего уровня. Где название вашей категории совпало с категорией Prom, магазин предлагает пару: примите её кнопкой «Выбрать» или все сразу кнопкой «Выбрать все предложенные». Выбор сохраняется сразу.

Если Prom убрал из справочника категорию, которую вы выбрали, рядом появится надпись «Площадка убрала эту категорию из справочника — выберите другую». Пока вы не выберете замену, товары уходят на Prom без категории, с замечанием. Подробнее о привязке см. Категории и параметры площадки.

Шаг 5. Включите выгрузку и соберите файл#

1. В шапке экрана включите переключатель «Выгружать на площадку».
2. Нажмите «Собрать сейчас», чтобы не ждать расписания.
3. Когда файл соберётся, в сводке появятся «Позиций в файле», «Товаров», «Не прошли» и «С замечаниями».
4. Скопируйте «Ссылку для площадки» кнопкой рядом с ней.

Пока выгрузка выключена или файл ни разу не собирался, ссылка не открывается. Ссылка не меняется, сколько бы раз файл ни пересобирался.

Шаг 6. Вставьте ссылку в кабинете Prom#

Названия пунктов ниже даны так, как они написаны в украинском интерфейсе кабинета Prom.

1. В кабинете компании откройте «Товари та послуги» → «Імпорт».
2. В блоке «Спосіб імпорту» выберите «Посилання» и вставьте ссылку из магазина.
3. Откройте настройки импорта. В блоке «Інформація, яку потрібно оновити» оставьте отмеченными поля, которые должен обновлять ваш магазин.
4. В блоке «Статус товарів, яких немає в файлі» выберите, что Prom делает с товарами, которых больше нет в файле: «Залишити без змін», «Немає в наявності», «Приховані» или «Видалені». Учтите, что товар пропадает из файла, если вы исключили его правилами отбора или выбрали для него «Не выгружать».
5. Нажмите «Почати імпорт», а затем «Продовжити імпорт».

После первого импорта Prom обновляет товары по ссылке сам. По справке Prom, цену, наличие, количество и скидку он обновляет раз в 4 часа с 6:00 до 22:00, а остальные поля и новые товары — раз в сутки ночью. Поэтому новый товар появляется на Prom не сразу, даже если магазин собирает файл каждый час. Остаток после продажи магазин сообщает Prom сразу, не дожидаясь импорта, см. шаг 8.

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

Если у вас несколько выгрузок, каждую вставляйте отдельной ссылкой. По справке Prom, в импорт можно добавить до четырёх ссылок кнопкой «Додати посилання», и Prom загружает их по очереди.

Шаг 7. Проверьте товары во вкладке «Товары»#

Здесь видно, какие товары ушли на Prom, а какие нет и почему. Над списком собраны причины с числом товаров у каждой, а нажатие на причину оставляет в списке только эти товары. Список можно искать по названию или артикулу и отбирать по категории и состоянию: «На площадке», «Не прошли», «С замечаниями», «Нет в наличии или вне цены», «Выгружаются всегда», «Не выгружаются» и «Не выбраны правилами».

Справа у каждого товара есть выбор: «По правилам», «Выгружать всегда» или «Не выгружать». Решение можно принять сразу для нескольких товаров, если отметить их галочками.

Нажмите на товар, чтобы открыть его экран. Там можно задать для Prom своё «Название» (до 255 символов) и «Описание» на каждом языке магазина. Пустое поле означает текст из карточки товара. В блоке «Артикулы на площадке» видно, под каким номером каждый артикул уходит в файл и лежит ли он сейчас во включённом файле: «На площадке» или «Не в файле». Если товар уже продавался на Prom до подключения магазина, впишите его номер на Prom в поле «Номер товара у площадки»: тогда заказы Prom с этим товаром найдут ваш артикул.

Почему товар не ушёл#

Товар не проходит, и в файл его позиция не попадает, по таким причинам:

• «Нет названия»;
• «Нет цены»;
• «Нет фото».

Товар уходит с замечанием, которое стоит исправить:

• «Название длиннее 255 символов — на Prom оно ушло обрезанным». Сократите название или задайте для Prom своё на экране товара;
• «Артикул длиннее 25 символов — товар ушёл без артикула». Prom не принимает длинные артикулы, поэтому магазин отправляет товар без него;
• «Есть название на украинском, но нет описания — Prom не обновит перевод, пока не будет и того и другого». Добавьте описание на украинском в карточке товара или на его экране во вкладке «Товары»;
• «Не указан бренд — Prom хуже показывает такие товары в поиске»;
• «Площадка убрала категорию из своего справочника — выберите для категории магазина другую во вкладке «Категории»».

Товар отсеян правилами и в файл не попадает:

• «Нет в наличии, а выгружаются только товары в наличии»;
• «Цена вне диапазона, заданного для выгрузки».

Список причин относится к последней удачной сборке выгрузки. Исправьте товар, и он уйдёт со следующей сборкой. Чтобы не ждать, нажмите «Собрать сейчас».

Шаг 8. Включите приём заказов во вкладке «Заказы»#

Для заказов нужен ключ API из шага 2. Пока ключа нет, во вкладке видно напоминание «Чтобы принимать заказы, укажите ключ доступа к площадке во вкладке «Подключение»».

Блок «Приём заказов»#

• «Принимать заказы с площадки». При первом включении магазин заберёт заказы за последние сутки. Дальше он проверяет Prom каждые пять минут. Если вы выключали приём и включили снова, магазин тоже заберёт заказы только за последние сутки: более старые вы уже обработали в кабинете Prom.
• Кнопка «Забрать сейчас» проверяет заказы сразу, новые появятся примерно через минуту. Рядом видно, когда заказы проверялись в последний раз и не было ли ошибки.
• «Сразу обновлять остаток на площадке» включено по умолчанию. Продали товар на сайте или на другой площадке, и примерно через минуту Prom видит новый остаток. Так товар, которого уже нет, не купят второй раз. Рядом видно, когда остатки отправлялись в последний раз. Обновляются только позиции, которые есть во включённой выгрузке. Если Prom не нашёл у себя каких-то позиций, они появятся на нём со следующим импортом файла.

Блок «Каким появляется заказ»#

• «Статус нового заказа». Пустое поле означает тот же статус, что у заказа с сайта.
• «Способ оплаты», под которым заказ виден в магазине. Название оплаты с Prom всё равно сохраняется в заказе.
• «Витрина», с данными которой печатаются документы и уходят письма. Поле видно, если витрин больше одной.
• «Способ доставки для перевозчиков площадки» — ваш способ доставки для каждого перевозчика Prom: «Нова Пошта», «Укрпошта», «Meest» и «Остальные способы площадки». Если для Новой почты выбран ваш способ «Нова Пошта», заказ ложится на него вместе с отделением, и накладная выпускается из карточки заказа, как обычно.
• «Отправлять покупателям уведомления магазина» по умолчанию выключено. Prom сам пишет покупателю о заказе, а письма магазина с другим номером заказа его только запутают. Сотрудники получают уведомления о заказах с Prom как обычно.

Блок «Статусы заказа»#

«Что сообщать площадке». Для каждого статуса магазина можно выбрать статус Prom. Когда заказ в магазине переходит в этот статус, Prom получает выбранный. Пока вы ничего не меняли, действует такое соответствие:

• «В обработке» сообщается как «Принят»;
• «Доставлен» сообщается как «Выполнен»;
• «Отменён» сообщается как «Отменён».

Prom считает заказ необработанным, пока его не приняли, поэтому статус «Принят» стоит сообщать. Кроме этих статусов Prom принимает «Оплачен». Если ключ уже указан, в списке будут и собственные статусы вашей компании на Prom.

«Причина отмены для площадки». Prom требует причину, когда магазин отменяет заказ. Выберите одну из причин Prom: «Нет в наличии», «По просьбе покупателя», «Дубль заказа», «Неверный телефон», «Оплата не поступила», «Нет нужного варианта товара» или «Другая причина». Если причину не выбрать, Prom получит «Другая причина» с пояснением для покупателя «Замовлення скасовано магазином». Магазин не подставляет за вас «Нет в наличии», потому что эта причина влияет на рейтинг продавца.

«Что принимать с площадки». Когда заказ на Prom переходит в выбранный статус, заказ в магазине переходит в ваш статус. По умолчанию отмена на Prom отменяет заказ в магазине. Если ваша схема статусов такой переход не разрешает, например заказ уже выполнен, заказ в магазине остаётся как был. Заказ, который отменили на Prom раньше, чем магазин его увидел, в магазине не создаётся вовсе.

Нажмите «Сохранить» внизу вкладки.

Блок «Последние заказы с площадки»#

Внизу вкладки показаны последние заказы с Prom: номер в магазине и на Prom, покупатель, сумма и статус в магазине и на Prom. Нажмите на номер, чтобы открыть заказ.

Каким приходит заказ с Prom#

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

Позиции заказа магазин узнаёт по номеру позиции из файла и связывает их с вашими артикулами. Под заказ откладывается остаток, как у заказа с сайта. Позиция, которую узнать не удалось, остаётся в заказе с названием и ценой Prom. Если сумма в магазине не сошлась с суммой на Prom, в истории заказа появится запись об этом. Проверьте состав такого заказа до оплаты.

Магазин ищет покупателя по телефону. Если такой номер уже есть у покупателя без личного кабинета, заказ ложится в его карточку. Номер, который принадлежит личному кабинету, к заказу с Prom не привязывается: Prom этот телефон не подтверждал. Комментарий покупателя и адрес доставки сохраняются в заказе.

Накладная, оплата, чек и возврат#

Накладная. Как только вы выпустите накладную Новой почты, Укрпошты или Meest по заказу с Prom, её номер уйдёт на Prom сам. Если номер накладной появился на самом Prom, он попадёт в заказ магазина.

Оплата. Если покупатель оплатил заказ через Prom, заказ в магазине становится оплаченным с пометкой «Покупатель оплатил заказ на площадке».

Чек. Когда ваша касса выпускает чек по заказу, оплаченному через Prom, Prom получает ссылку на этот чек.

Возврат. Деньги, заплаченные через Prom, возвращает Prom, а не касса магазина. Когда вы нажимаете «Вернуть деньги» в таком заказе, панель напоминает, что переводить деньги вручную не нужно, а магазин сам отправляет возврат на Prom. Если деньги вернул сам Prom, в истории заказа появится запись «Площадка вернула покупателю деньги за этот заказ».

Изменения, которые пришли с Prom, обратно на Prom не отправляются.

Где видны заказы с Prom#

Prom — такой же канал продаж, как витрина. В разделе «Заказы» слева, в группе «Каналы продаж», Prom.ua стоит своей строкой с числом своих заказов. Нажмите на неё, и список покажет только заказы с Prom. На сводке в блоке «Каналы продаж» Prom тоже стоит отдельно, со своей выручкой и долей.

В карточке заказа в строке «Канал продаж» стоит Prom.ua, а в строке «На площадке» — номер заказа в кабинете Prom. Если Prom не принял последнее изменение заказа (статус, накладную или чек), там же появится предупреждение с причиной, которую назвал Prom.

Частые проблемы#

Ссылка на файл не открывается. Выгрузка выключена или файл ещё ни разу не собирался. Включите «Выгружать на площадку» и нажмите «Собрать сейчас».

Файл не собирается: «Площадки принимают цены в гривнах, а у магазина основная валюта другая и курса гривны нет». Добавьте гривну с курсом в «Настройки» → «Основные настройки» → «Валюты» и соберите файл снова.

«Prom не отдал справочник категорий». Prom временно не ответил. Попробуйте загрузить справочник через несколько минут.

Товара нет на Prom. Найдите его во вкладке «Товары». Если он среди «Не прошли», исправьте причину. Если он среди «Не выбраны правилами» или «Нет в наличии или вне цены», поменяйте правила отбора или выберите для него «Выгружать всегда». Если товар есть в файле, а на Prom его нет, дождитесь ночного импорта Prom: новые товары Prom создаёт раз в сутки. Отчёт об импорте виден в кабинете Prom.

Цена или наличие на Prom старые. Prom забирает файл раз в 4 часа днём, поэтому изменения доходят не сразу. Остаток после продажи уходит быстрее, если включено «Сразу обновлять остаток на площадке».

«Чтобы принимать заказы Prom, укажите ключ API Prom во вкладке «Подключение»». Ключ не указан. Создайте его по шагу 2.

«Prom не принял ключ API. Проверьте его во вкладке «Подключение», срок его действия и доступ ключа к заказам и к товарам». Ключ вставлен с ошибкой, удалён в кабинете Prom или у него истёк срок. Проверьте ключ в разделе «Управління API-токенами» кабинета Prom, продлите срок или создайте новый и вставьте его заново. Если заказы приходят, а эта причина стоит рядом с «Сразу обновлять остаток на площадке», ключу не хватает доступа «читання та запис» к группе «Продукти та групи».

«Prom не ответил. Попробуйте ещё раз через несколько минут». Prom временно недоступен. Магазин сам повторит проверку заказов через пять минут, а отправку остатков через минуту.

Заказы не приходят: «Площадки принимают цены в гривнах…». У магазина нет курса гривны. Добавьте гривну в настройках валют, и заказы за пропущенное время придут со следующей проверкой.

Заказ помечен «Не принят — магазин пробует снова». Магазин не смог принять этот заказ три проверки подряд. Причина видна рядом с заказом в списке последних заказов. Остальные заказы при этом принимаются, а этот магазин пробует снова при каждой проверке, пока не примет.

«С прошлой проверки на Prom изменилось больше 20 000 заказов, и магазин не может принять их за раз. Напишите в поддержку CartiX». Такое бывает, если приём заказов долго не работал, а на Prom за это время накопилось очень много заказов. Сами по себе они в магазин не придут: напишите в поддержку CartiX, и вам помогут их забрать.

«Prom не сменил статус заказа» или «Prom ответил: …». Prom отказался принять новый статус. Чаще всего заказ уже закрыт на Prom или такой переход Prom не разрешает. Проверьте заказ в кабинете Prom.

«Prom не принял номер накладной». Проверьте номер накладной в карточке заказа. Номер уходит на Prom, только если доставка заказа идёт Новой почтой, Укрпоштой или Meest.

«Prom не принял ссылку на чек» или «Prom не провёл возврат денег покупателю». Откройте заказ в кабинете Prom и проверьте его оплату. Ссылку на чек и возврат магазин отправляет только по заказам, которые покупатель оплатил через Prom.

Заказ удалён в магазине. Prom его не возвращает: в списке последних заказов он помечен «Удалён в магазине».