Prom Настройки

Точка подключения к маркетплейсу Prom.ua. Здесь живут ключ доступа, адрес API и ответы на вопрос «что и откуда выгружать»: с какого склада брать остатки, из какого прейскуранта — цены. Остальной модуль — службы, которые этим подключением пользуются.

Где искать: Модули → Prom → Настройки → Prom Настройки

Разбор на примере

• Токен — API-ключ вашего кабинета Prom (создаётся в кабинете продавца: Управление → API-токены). Токен — «только для записи», как пароль: сохранённый токен окно не показывает — только маску «••••••••» (набранный новый токен заменит старый, а стёртая маска — удалит его); в базе он зашифрован. Без токена службы отказывают: «Настройки Prom не заполнены».
• Хост — адрес API маркетплейса: my.prom.ua. Меняется разве что для региональных клонов платформы (satu.kz, deal.by).
• Порт — 443; можно не заполнять, это значение система подставляет сама. Изменили хост или порт, когда токен уже сохранён, — наберите токен заново, иначе сохранение откажет: «Сохранённый токен отправляется только на сохранённый сервер. Для другого сервера введите токен». Пустой порт и 443 — один и тот же адрес.
• Склад — код склада, чьи остатки едут в Prom службой «Обновить баланс». Складов можно указать несколько через запятую — остатки складываются, а новый заказ служба «Обновить заказы» оформляет на первый.
• Прейскурант — откуда «Обновить цены» берёт цену товара: строка этого прейскуранта; если для товара строки нет или цена в ней нулевая — базовая цена из карточки. Поле пустое — служба берёт строку товара из ЛЮБОГО прейскуранта, а если товар есть в нескольких, какая цена уедет — не определено; поэтому при нескольких прейскурантах поле лучше заполнить.
• Последнее обновление — служебная отметка: когда в последний раз выгружались цены. Ставится службой автоматически; руками её трогают только чтобы принудить полную выгрузку (очистить — и следующий запуск отправит всё).

Как интеграция работает целиком

1. Сшить каталоги — служба «Обновить ключи товаров»: артикул товара на Prom (sku) должен равняться коду товара в ERPJS; служба записывает внутренний идентификатор Prom в карточку товара.
2. Загрузить статусы — «Загрузить статусы» наполняет справочник «Prom Статусы».
3. Регулярный обмен: «Обновить заказы» тянет заказы покупателей (и создаёт клиентов по правилам «Создания новых клиентов»), «Обновить цены» и «Обновить баланс» выталкивают цены и остатки. Все три ставятся на расписание кнопкой «По расписанию» в окне службы.

Типичные ситуации

Служба говорит «Настройки Prom не заполнены». Не заполнен токен или хост. Без склада «Обновить баланс» и «Обновить заказы» отказывают иначе — «Укажите склад в настройках Prom!». Эта настройка — первое, что проверяют.

Цены едут не те. Посмотрите поле «Прейскурант»: заполнено — цена берётся из него, а для товаров, которых в прейскуранте нет, — базовая из карточки; пустое — из любого прейскуранта, где товар есть (при нескольких — какой попадётся), и лишь для товаров без строк в прейскурантах — базовая.

Надо перевыгрузить все цены, а не только изменённые. Очистите «Последнее обновление» и запустите «Обновить цены» — служба посчитает, что не выгружала ничего.