Перейти до основного вмісту

Інтеграція з Prom

Інтеграція з Prom дозволяє передавати товари, залишки і ціни з Skynum у Prom, а також завантажувати замовлення з Prom у Skynum для подальшої роботи менеджера.

Інтеграція створюється в Налаштування → Інтеграції → Інтернет-магазини.

попередження

Перед масовою синхронізацією перевірте ідентифікатор товарів. Якщо Skynum і Prom не зможуть однозначно зіставити товари, можуть зʼявитися дублікати або оновлення піде не в ті позиції.

Що синхронізується​

Інтеграція може працювати з двома блоками:

  • Товари — передавання товарів, цін, залишків, категорій, фото і модифікацій у Prom;
  • Замовлення — завантаження замовлень з Prom у Skynum; якщо поле Експорт замовлень має значення Тільки статус, Skynum передає зміни статусів назад у Prom.

У картці інтеграції є вкладки Налаштування інтеграції, API мапінг і Журнал синхронізації.

Підготовка в Prom​

У кабінеті Prom відкрийте розділ керування API-токенами і створіть новий токен для Skynum.

Після створення скопіюйте токен. Він потрібен для підключення в Skynum.

Як створити інтеграцію​

  1. Відкрийте Налаштування → Інтеграції → Інтернет-магазини.
  2. Натисніть Додати інтеграцію.
  3. Виберіть Пром.
  4. Заповніть Назва магазину.
  5. Вставте токен у поле Токен.
  6. Збережіть інтеграцію.
  7. Натисніть Перевірити підключення.

У списку інтеграцій для інтернет-магазинів видно Назва магазину, Сервіс і Інтеграція активна.

Синхронізація товарів​

У блоці Товари увімкніть Синхронізація товарів активна і налаштуйте правила вивантаження.

Основні налаштування товарів:

  • Ідентифікатор товара — визначає, за яким полем Skynum зіставляє товар із товаром Prom;
  • Ідентифікатор модифікації — визначає ключ зіставлення для варіантів товару;
  • Вивантажувати категорії — керує передаванням категорій у Prom;
  • Тип ціни товарів — вибирає ціну Skynum, яка передається в маркетплейс;
  • Вивантажувати товари без залишків — дозволяє передавати позиції, яких зараз немає на складі;
  • Назва модифікацій — визначає, як називати варіанти товарів;
  • Виключити категорії — не вивантажує товари з вибраних категорій;
  • Тільки товари з категорії — обмежує вивантаження вибраною категорією;
  • Тільки залишки по складах — передає залишки тільки з вибраних складів.

Ідентифікатор товара​

Поле Ідентифікатор товара визначає, за яким значенням Skynum буде зіставляти товар з Prom.

У формі доступні варіанти:

  • Внутрішній ID;
  • Зовнішній ID;
  • Код;
  • Артикул.

Якщо товари вже є в Skynum, але їх ще немає в Prom, найпростішим варіантом є Внутрішній ID.

Якщо товари вже є в Prom, потрібно підготувати однаковий ключ для синхронізації: наприклад, код, артикул або зовнішній ID.

Товари вже є в Prom​

Якщо каталог уже створений у Prom, підготуйте поле, за яким товари будуть зіставлятися.

У Prom для цього можна експортувати товари в Excel, заповнити ідентифікатор товару, а потім імпортувати файл назад у Prom. Після цього в Skynum потрібно вибрати той самий тип ідентифікатора.

порада

Якщо ви не впевнені, який ідентифікатор вибрати для чинного каталогу Prom, спочатку протестуйте інтеграцію на невеликій категорії товарів.

Категорії​

Поле Вивантажувати категорії визначає, чи передавати категорії в Prom.

У формі доступні варіанти:

  • Ні;
  • За назвою;
  • За зовнішнім ID.

Якщо категорії в Prom уже налаштовані вручну і мають іншу структуру, не вмикайте їх вивантаження без перевірки.

Тип ціни товарів​

У полі Тип ціни товарів вибирається ціна, яку Skynum передаватиме в Prom.

Це може бути системна або додаткова ціна компанії. Якщо для Prom використовується окремий прайс, створіть додаткову ціну і виберіть її в інтеграції.

Залишки і склади​

Поля Вивантажувати товари без залишків і Тільки залишки по складах визначають, які залишки потраплять у Prom.

Якщо в Prom має продаватися тільки товар з конкретного складу або магазину, виберіть потрібний склад у налаштуванні залишків.

Модифікації​

Для товарів з модифікаціями перевірте Ідентифікатор модифікації і Назва модифікацій.

У полі Назва модифікацій доступні варіанти:

  • Товар з модифікацією;
  • Дублювати назву товара;
  • Не передавати назву.

Після цього перейдіть на вкладку API мапінг і зіставте характеристики або модифікації, які мають передаватися в Prom.

Посилання для імпорту в Prom​

Після налаштування товарів Skynum генерує посилання на файл для Prom.

Це посилання копіюють у кабінет Prom у сценарії імпорту товарів з файлу на сервері. У Prom можна вибрати, які дані оновлювати. Для більшості сценаріїв достатньо оновлювати наявність і кількість.

Після запуску імпорту дочекайтеся завершення обробки в Prom і перевірте помилки. Якщо Prom показує помилки по товарах, виправте їх і запустіть імпорт ще раз.

Синхронізація замовлень​

У блоці Замовлення налаштовується завантаження замовлень з Prom у Skynum.

Основні налаштування замовлень:

  • Синхронізація замовлень активна — вмикає завантаження замовлень з Prom;
  • Інтервал синхронізації — задає період автоматичного завантаження замовлень;
  • Резервувати товари після створення замовлення — резервує товари після імпорту замовлення;
  • Імпортувати повторно змінені замовлення — дозволяє повторно оновлювати замовлення, які змінилися в Prom;
  • Спосіб оновлення замовлень — визначає, які дані Skynum оновлює при повторному імпорті;
  • Заборонити оновлення замовлень у статусі — захищає вибрані статуси від змін через інтеграцію;
  • Створити пов'язаний платіж на суму оплати — вмикає створення окремого платежу за переданою сумою оплати;
  • Фіскалізація платежу — запускає фіскалізацію автоматично створеного платежу;
  • ПРРО для фіскалізації — визначає фіскальний сервіс для автоматичного чека;
  • Експорт замовлень — визначає, чи передавати зміни зі Skynum назад у Prom;
  • Склад за замовчуванням — використовується для резервування та обліку товарів із замовлення;
  • Канал продажів — позначає джерело продажу в аналітиці;
  • Група контрагента — задає групу для нових покупців.

Резерв після завантаження​

Якщо увімкнути Резервувати товари після створення замовлення, Skynum резервуватиме товари після імпорту замовлення з Prom.

Це зручно, коли менеджер має одразу бачити, що товар уже очікує конкретного покупця.

Оплата і фіскалізація​

Для автоматичної оплати замовлень у блоці Замовлення увімкніть Створити пов'язаний платіж на суму оплати. Коли Prom передає суму оплати, а зовнішній спосіб оплати зіставлений зі способом оплати Skynum на вкладці API мапінг, Skynum створює пов'язаний платіж до замовлення.

Для автофіскалізації увімкніть Фіскалізація платежу і виберіть ПРРО для фіскалізації. Після створення платежу Skynum запускає фіскалізацію цього платежу. Спосіб оплати Skynum має бути пов'язаний із касою або банківським рахунком.

Докладніше:

Повторне оновлення замовлень​

Параметр Імпортувати повторно змінені замовлення потрібен, якщо після першого імпорту замовлення в Prom можуть змінюватися статус або інші дані.

У полі Спосіб оновлення замовлень доступні варіанти:

  • Не оновлювати;
  • Тільки статус;
  • Оновити заповнені;
  • Повністю оновити.

Вибирайте режим обережно. Повне оновлення може змінити більше даних у замовленні, ніж потрібно менеджеру.

Експорт замовлень​

Поле Експорт замовлень визначає, чи передавати зміни з Skynum назад у Prom.

Доступні варіанти:

  • Ні;
  • Тільки статус.

Якщо вибрати Тільки статус, зміна статусу в Skynum передається в Prom згідно з API-мапінгом статусів.

API мапінг​

На вкладці API мапінг зіставляються значення Skynum і Prom.

Для товарів зіставляються характеристики і модифікації. Для замовлень особливо важливе зіставлення статусів.

попередження

Не дублюйте відповідність статусів. Один статус Prom має відповідати одному статусу Skynum. Непотрібні статуси краще залишити порожніми, ніж зіставити неправильно.

Журнал синхронізації​

Вкладка Журнал синхронізації допомагає перевірити, чи завершилася синхронізація успішно і чи є помилки.

Після першого налаштування обовʼязково перевірте журнал і сам каталог у Prom: товари, залишки, ціни, фото і модифікації.

Загальний порядок перевірки описаний у статті Перевірка синхронізації інтеграцій. Якщо причина помилки неочевидна, використовуйте типові помилки інтеграцій як чеклист діагностики.

Коротка перевірка​

  • токен Prom створений і вставлений у Skynum;
  • підключення перевірене;
  • вибраний правильний ідентифікатор товарів;
  • каталог Prom підготовлений, якщо товари вже були в Prom;
  • ціна для Prom вибрана правильно;
  • категорії і склади не вивантажують зайві товари;
  • API-мапінг характеристик, модифікацій, статусів і оплат перевірений;
  • перший імпорт у Prom завершився без критичних помилок;
  • тестове замовлення з Prom завантажується в Skynum.

Підсумок​

Інтеграція з Prom складається з двох частин: вивантаження товарів і завантаження замовлень. Найважливіше рішення — правильно вибрати ідентифікатор товарів, тому що саме від нього залежить, чи буде синхронізація оновлювати правильні позиції.

Останнє оновлення