Інтеграція з Хорошоп

Інтеграція з Хорошоп дозволяє вивантажувати товари зі Skynum в інтернет-магазин, оновлювати фото, ціни, залишки, характеристики, модифікації та завантажувати замовлення назад у Skynum.

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

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

У Хорошоп не підтримується синхронізація категорій через API. Категорії потрібно створювати та оновлювати вручну в Хорошоп перед вивантаженням товарів зі Skynum.

Коли потрібна інтеграція

Інтеграція підходить для двох сценаріїв:

• компанія вже веде облік у Skynum і запускає інтернет-магазин на Хорошоп;
• магазин на Хорошоп уже працює, а товари, залишки і замовлення потрібно перенести в облік Skynum.

Якщо товари вже є в Хорошоп, спочатку підготуйте каталог у Skynum. Для цього можна вивантажити товари з Хорошоп в Excel, привести таблицю до потрібної структури й імпортувати її в Товари → Картотека. Докладніше: Імпорт товарів.

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

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

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

порада

Для інтеграції краще використовувати окремого користувача Хорошоп, а не основний обліковий запис адміністратора магазину.

Категорії

Для Хорошоп категорії потрібно готувати вручну в самому магазині.

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

порада

Якщо ви тільки налаштовуєте інтеграцію, почніть з невеликої категорії товарів. Так легше перевірити, чи правильно товари потрапляють у підготовлену структуру Хорошоп.

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

У блоці Товари налаштовуються правила вивантаження товарів.

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

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

Після налаштування можна натиснути Вивантажити товари і перевірити результат у Хорошоп.

Інтервал синхронізації

У полі Інтервал синхронізації задається період автоматичного вивантаження товарів у хвилинах. Якщо автоматичне вивантаження не потрібне, поле можна залишити порожнім і запускати обмін вручну кнопкою Вивантажити товари.

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

У полі Ідентифікатор товара доступні:

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

Для модифікацій доступні:

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

Вибирайте ідентифікатор, який не змінюється під час роботи з каталогом. Якщо товар або модифікація буде зіставлена неправильно, синхронізація може оновити не ту позицію.

Для магазину, де товари вже існують, найважливіше підготувати однаковий ключ у Хорошоп і Skynum: наприклад, код або артикул. Для товарів з модифікаціями окремо перевірте Ідентифікатор модифікації.

Ціни і залишки

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

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

Прапорець Кількість залишків замість статусу наявності визначає, чи передавати точну кількість залишку, а не тільки ознаку наявності.

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

Поле Вивантажувати товари без залишків дозволяє передавати товари, яких зараз немає на складі. Це корисно, якщо магазин приймає попередні замовлення або показує ширший каталог, ніж поточний залишок.

Фото, кратність і типи товарів

Прапорець Вивантажувати фото товарів відповідає за передавання світлин з картки товару.

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

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

Поле Тільки товари з типами дозволяє обмежити вивантаження за типами позицій: Товар, Продукція, Послуга, Комплект.

API мапінг

На вкладці API мапінг зіставляються значення між Skynum і Хорошоп.

У перевіреному інтерфейсі є блоки:

• Статуси;
• Доставка;
• Оплата;
• Характеристики;
• Модифікації;
• Додаткові поля;
• Ціни;
• Групи контрагентів;
• Склади та магазини.

Ціни

Мапінг цін потрібен, якщо в Хорошоп використовуються кілька цін продажу, наприклад для B2B-магазину або різних груп покупців.

У такому сценарії кожній ціні Skynum потрібно вказати відповідний ідентифікатор ціни з Хорошоп.

Характеристики і модифікації

Мапінг характеристик потрібен, щоб властивості товарів зі Skynum правильно потрапляли у властивості Хорошоп.

Мапінг модифікацій використовується для товарів з розмірами, кольорами або іншими варіантами. Докладніше про облік таких товарів: Модифікації товарів.

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

У Хорошоп модифікації можуть бути повʼязані через батьківський товар. Якщо магазин уже має товари з модифікаціями, перевірте структуру каталогу до першого вивантаження зі Skynum, щоб не створити неправильні звʼязки.

Групи контрагентів

Мапінг груп контрагентів потрібен, якщо покупці в Хорошоп поділяються на групи, а в Skynum ці групи мають відповідати групам контрагентів.

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

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

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

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

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

Після імпорту замовлення стає замовленням покупця у Skynum.

Ігнорувати замовлення до дати

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

Резервування товарів

Якщо увімкнути Резервувати товари після завантаження замовлення, Skynum резервуватиме товари після імпорту замовлення. Для цього в інтеграції потрібно коректно вибрати Склад за замовчуванням.

Зовнішній номер

Прапорець Встановити зовнішній номер замовлення дозволяє зберігати номер замовлення з Хорошоп у документі Skynum.

Контрагент за замовчуванням

Поле Контрагент за замовчуванням використовується для ситуацій, коли замовлення не має повноцінно визначеного покупця. У перевіреній формі поруч доступна дія Створити контрагента.

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

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

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

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

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

Експорт статусів у Хорошоп

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

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

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

Якщо вибрано Тільки статус, статуси потрібно звірити на вкладці API мапінг.

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

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

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

Після першого налаштування перевірте:

• товари зʼявляються в Хорошоп;
• категорії підготовлені вручну;
• ціни і залишки правильні;
• тестове замовлення завантажується в Skynum;
• журнал не показує критичних помилок.

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

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

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

Підсумок

Інтеграція з Хорошоп потребує особливої уваги до категорій, ідентифікаторів і API-мапінгу. Спочатку підготуйте структуру магазину, потім налаштуйте товари, ціни, залишки, модифікації, групи контрагентів і перевірте обмін на невеликому наборі товарів.