Інтеграція з сайтами на Horoshop.ua (Хорошоп)

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

У цьому розділі можливо налаштувати обмін даними між вашим сайтом на Horoshop та обліковою системою Quincefin.

Зверніть увагу, що інтеграція можлива не у всіх тарифах Horoshop.

Для використання інтеграції в акаунті Хорошоп повинен бути підключений тариф Pro або b2b та включена передача даних через API. Тариф Basic та Standard приєднати неможливо, оскільки в них не дозволено використання API.

З сайту в облікову систему можна передавати наступні дані:

Замовлення покупців.
Статуси замовлень
Джерела

Картки товарів
Бренди

Картки нових партнерів (замовників)
Телефон
Електронна пошта
Коментар

А з Quincefin можна передавати на сайт таку інформацію:

Списки товарів
Ціни
Кількість актуальних залишків на складі

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

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

Додаткові налаштування обміну для товарів з іншими видами не потрібні.

Налаштування інтеграції

Для обміну інформацією з сайтом потрібно створити профіль з параметрами інтеграції.
Такий профіль знаходиться в меню Налаштування/Інтеграції/Інтернет-магазини.

Картка параметрів інтеграції розділена за вкладками:

Підключення
Замовлення
Товари
Типи цін

Підключення

На цій вкладці треба вказати основні параметри підключення облікової системи до сайту.

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

Магазин - Мається на увазі магазин в Хорошопі. Оскільки там можна в одному обліковому записі мати декілька магазинів з різними URL. В Quincefin треба створити картку магазину і обрати її зі списку.

ВАЖЛИВО. Якщо маєте декілька сайтів на Хорошоп - зверніться в підтримку Quincefin для активації і налаштування коректної передачі даних між різними магазинами(сайтами) та обліковою системою.

Логін - це логін входу для адміністратора сайту (рекомендується на стороні сайту мати окремого користувача для налаштування інтеграції)

Пароль - тут зазначити пароль для входу в адмін-панель сайту

Домен - обов’язково має починатись з протоколу http чи https, а наприкінці треба прибрати символ /.
Тільки у такому форматі домену, налаштування спрацюють.

Наприклад, правильний вигляд домену: https://shop.horoshop.ua

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

Наступні кроки можна виконати тільки після збереження профілю.

Замовлення

На цій вкладці треба зазначити умови імпорту замовлень з сайту в облікову систему.

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

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

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

Користувач - це користувач Quincefin, параметри якого будуть приймати участь в формуванні документу Замовлення - Склад, Сегмент діяльності, Тип цін.

Імпортувати структуру каталогу - встановити, якщо потрібно переносити з сайту нові товари у списки Quincefin. Папки і підпапки у Квінсфін мають відповідати розділам і підрозділам сайту.

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

Завантажувати джерело з utm_source - встановити, щоб в замовленнях відображалось джерело надходження.

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

Записувати товари в папку - обрати папку, у якій будуть створюватись нові товари. Папку треба обрати, якщо не обрано варіант "Імпортувати структуру каталогу"

Записувати партнерів в папку - обрати папку, до якої додаватимуться нові партнери.

Коментар до замовлення - тут можна додати текст, який буде додаватись у всіх замовленнях, перенесених з Хорошоп.

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

Після внесення всіх налаштувань передачі даних, їх необхідно спочатку Застосувати, а потім - натиснути на кнопку Експорт.

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

Після того, як всі кроки налаштування виконано, для оновлення замовлень між сайтом та обліковою системою, достатньо буде зайти до цього профілю і натиснути на кнопку Експорт

Товари

На цій вкладці треба вказати умови перенесення карток товарів з Quincefin на Хорошоп.

З карток товарів передаються наступні дані:
Назва товару

Назва товару Quincefin передається до картки товару Хорошоп лише в поле "Назва UA".

Артикул
Батьківська папка
Ціна
Зображення
Залишки
Валюта ціни товару

Зверніть увагу, що кожна картка товару на Horoshop.ua підтримує тільки одну валюту. Тобто валюта обирається для окремого товару, а не для типу цін, як в обліковій системі.

Дозволені типи файлів для зображення товару:
jpeg
png
gif

Критичним значенням на сайтах Хорошоп є Артикули товарів. Якщо у картках товарів облікової системи немає артикулів - вони не можуть передаватись до сайту.

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

Налаштування експорту товарів

Експорт в кореневу папку - цей прапорець треба встановити, якщо потрібно розмістити нові товари у головний розділ (Без прив’язки до підрозділів)

Якщо прапорець встановлено, то експортуються всі товари, у яких розташування товару в каталозі Квінсфін повністю відповідає розташуванню в каталозі Хорошоп.

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

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

З урахуванням резервування товарів

Склад - ця графа відображається тільки, якщо треба передавати залишки на сайт.
Треба обрати, з якого складу системи треба експортувати дані.
Можна обрати декілька складів.
Якщо не обрати склад, то дані будуть передаватись з усіх складів.

Тип роздрібної ціни - слід обрати, якому типу цін облікової системи відповідає роздрібна ціна сайту.
Роздрібна ціна - це основна ціна, що є на сайтах Хорошоп і створена за замовчуванням.
Якщо не було створено додаткових цін, то це буде єдина ціна товарів, що відображається на сайті.

Відправляти в Хорошоп дозволяє визначити які товари буде передано до Хорошоп після натискання кнопки "Експорт":
- Усі продукти - буде експортовано усі товари, для котрих налаштовано каталоги з довідниками Хорошоп,
- Змінені після останнього обміну - буде експортовано лише товари, в котрі було внесено зміни після останнього обміну з Хорошоп, включно з новими товарами.

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

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

Під час передачі товарів до сайту на Хорошоп, вони не будуть відразу опубліковані. Для того, щоб опублікувати перенесені картки товарів, потрібно встановити прапорець у полі “Відображати” у створених картках товарів на сайті.

Залишки та прайс

На цій вкладці можна зробити експорт залишків та прайсу товарів з Quincefin на Хорошоп.

Тільки активні товари - цей прапорець треба встановити, якщо потрібно оновлювати залишки або прайс лише у активних товарів.

Створювання "старої" ціни:
Не створювати
Формувати, якщо ціна змінилась - після оновлення прайсу новою ціною старі значення типу "Ціна" перейдуть до типу "Стара ціна".
Брати з прайсу "старої" ціни - до типу "Стара ціна" у Хорошоп можна передати окремі значення

Прайс для старої ціни - доступно лише, якщо в параметрі Створювання "старої" ціни обрано опцію Брати з прайсу "старої" ціни.

Завантаження залишків - передає залишки товарів до Хорошоп.

Завантаження прайсу - передає прайс товарів до Хорошоп з врахуванням обраних вище параметрів.

Типи цін. Тільки для клієнтів b2b

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

Навпроти відповідного типу цін облікової системи, треба встановити ID типу ціни Хорошоп.

Цей ID можна отримати наступним чином:

Перейти до налаштувань сайту в розділ “Клієнти”

Обрати розділ “Типи цін”

Тут у рядку потрібної ціни (Окрім основної роздрібної ціни) натиснути на кнопку “Редагувати”.


Таким чином, відкривається картка типу цін, де можна редагувати назву.




Тепер потрібно у URL сторінки знайти надпис id= .
Саме це числове значення, що зазначено після знаку = потрібно записати у колонку ID типу ціни Хорошоп.




Тепер це числове значення треба внести до таблиці типів цін в налаштування.




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

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

Налаштування SKU

У цьому розділі треба співставити характеристики SKU товарів Quincefin з модифікаціями Хорошопу.



На сайті Хорошоп мають бути створені каталоги.
Для роботи із SKU, на сайті мають бути створені довідники, еквівалентні SKU у системі.


Ці довідники мають бути підключені до шаблону для каталогів.
З нашого боку має бути налаштування SKU на закладці "Налаштування СКУ", де дані у колонку "Значення в Хорошоп"
береться з Довідників хорошопу. Це є номер модифікації, який треба записати у Quincefin



У налаштуваннях SKU спочатку ліворуч навпроти характеристик SKU треба обрати, яка модифікація сайту буде відповідати цій SKU.
Вибір модифікації відкривається подвійним кліком по рядку.

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

Налаштування каталогів

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

Щоб завантаження проходило коректно, треба на вкладці "Товари" встановити позначку "Експорт в кореневу папку"

Оновлено: 16/11/2024