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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

У перевіреній формі є поля:

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

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

Поле Ідентифікатор товара визначає, за яким значенням 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.

У перевіреній формі є:

• Синхронізація замовлень активна;
• Інтервал синхронізації;
• Резервувати товари після завантаження замовлення;
• Імпортувати повторно змінені замовлення;
• Спосіб оновлення замовлень;
• Заборонити оновлення замовлень у статусі;
• Спосіб автоматичної оплати виконаних замовлень;
• Експорт замовлень;
• Склад за замовчуванням;
• Канал продажів;
• Група контрагента.

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

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

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

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

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

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

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

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

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

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

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

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

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

API мапінг

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

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

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

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

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

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

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

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

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

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

Підсумок

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