Prom Налаштування
Точка підключення до маркетплейса Prom.ua. Тут живуть ключ доступу, адреса API і відповіді на питання «що і звідки вигружати»: з якого складу брати залишки, з якого прейскуранта — ціни. Решта модуля — служби, які цим підключенням користуються.
Де шукати: Модулі → Prom → Налаштування → Prom Налаштування
Розбір на прикладі
- Токен — API-ключ вашого кабінету Prom (створюється в кабінеті продавця: Управління → API-токени). Токен — «лише для запису», як пароль: збережений токен вікно не показує — лише маску «••••••••» (набраний новий токен замінить старий, а стерта маска — видалить його); у базі він зашифрований. Без токена служби відмовляють: «Налаштування Prom не заповнені».
- Хост — адреса API маркетплейса:
my.prom.ua. Змінюється хіба що для регіональних клонів платформи (satu.kz, deal.by). - Порт — 443; можна не заповнювати, це значення система підставляє сама. Змінили хост чи порт, коли токен уже збережено, — наберіть токен знову, інакше збереження відмовить: «Збережений токен іде лише на збережений сервер. Для іншого сервера введіть токен». Порожній порт і 443 — та сама адреса.
- Склад — код складу, чиї залишки їдуть у Prom службою «Оновити баланс». Складів можна вказати кілька через кому — залишки додаються, а нове замовлення служба «Оновити замовлення» оформлює на перший.
- Прейскурант — звідки «Оновити ціни» бере ціну товару: рядок цього прейскуранта; якщо для товару рядка немає або ціна в ньому нульова — базова ціна з картки. Поле порожнє — служба бере рядок товару з БУДЬ-ЯКОГО прейскуранта, а якщо товар є в кількох, яка ціна поїде — не визначено; тому за кількох прейскурантів поле краще заповнити.
- Останнє оновлення — службова позначка: коли востаннє вигружались ціни. Ставиться службою автоматично, руками її чіпають лише щоб примусити повну вигрузку (очистити — і наступний запуск відправить усе).
Як інтеграція працює цілком
- Зв'язати каталоги — служба «Оновити ключі товарів»: артикул товару на Prom (sku) має дорівнювати коду товару в ERPJS; служба записує внутрішній ідентифікатор Prom у картку товару.
- Завантажити статуси — «Завантажити статуси» наповнює довідник «Prom Статуси».
- Регулярний обмін: «Оновити замовлення» тягне замовлення покупців (і створює клієнтів за правилами «Створення нових клієнтів»), «Оновити ціни» та «Оновити баланс» виштовхують ціни й залишки. Усі три ставляться на розклад кнопкою «За розкладом» у вікні служби.
Типові ситуації
Служба каже «Налаштування Prom не заповнені». Не заповнений токен або хост. Без складу «Оновити баланс» і «Оновити замовлення» відмовляють інакше — «Вкажіть склад у налаштуваннях Prom!». Це налаштування — перше, що перевіряють.
Ціни їдуть не ті. Подивіться поле «Прейскурант»: заповнене — ціна береться з нього, а для товарів, яких у прейскуранті немає, — базова з картки; порожнє — з будь-якого прейскуранта, де товар є (за кількох — який трапиться), і лише для товарів без рядків у прейскурантах — базова.
Треба перевигрузити всі ціни, а не лише змінені. Очистіть «Останнє оновлення» і запустіть «Оновити ціни» — служба вважатиме, що не вигружала нічого.