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

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

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

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

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

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

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

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

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

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

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

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

порада

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

Категорії

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

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

порада

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

API мапінг

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

На вкладці є блоки мапінгу:

• Статуси — зіставлення статусів Хорошоп зі статусами замовлень Skynum;
• Доставка — зіставлення способів доставки з довідником доставок Skynum;
• Оплата — зіставлення способів оплати з довідником оплат Skynum;
• Характеристики — зіставлення властивостей товарів;
• Модифікації — зіставлення властивостей варіантів товару;
• Додаткові поля — передавання додаткових даних з магазину;
• Ціни — зіставлення цін Хорошоп із цінами Skynum;
• Групи контрагентів — зіставлення груп покупців;
• Склади та магазини — зіставлення складських або магазинних значень, якщо вони використовуються в інтеграції.

Ціни

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Докладніше:

• Оплачені замовлення з інтернет-магазинів і автофіскалізація;
• Способи оплати;
• Налаштування фіскального сервісу.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Підсумок

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