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

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

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

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

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

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

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

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

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


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

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

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

Обмін товарами під час інтеграції відбувається тільки у тому разі, якщо у обліковій системі в картках товарів обрано вид - Товар або Набір.
З іншими видами товарів (Продукція та SKU) поки що обмін не відбувається.

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

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

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

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

Підключення

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

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

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

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

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

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

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

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

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

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

Замовлення

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

Товари

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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


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




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




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




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

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

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

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



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


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



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

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

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

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

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

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