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

Інтеграція поєднує CRM SalesDrive з обліковим контуром QUINCEFIN. Нові та змінені замовлення переходять у QUINCEFIN, а товари, ціни й фактичні залишки можна передавати у SalesDrive без ручного дублювання.

Профіль знаходиться в меню Налаштування → Інтеграції → CRM-системи → SalesDrive.

Що підтримується

З SalesDrive у QUINCEFIN:

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

З QUINCEFIN у SalesDrive:

• створення або оновлення товарів;
• передавання назви, опису, артикулу, штрихкоду, постачальника й категорії;
• передавання ціни за вибраним типом ціни;
• оновлення загального залишку або залишку конкретного складу SalesDrive.

Обмін замовленнями односторонній: SalesDrive → QUINCEFIN. Зміни замовлення, зроблені в QUINCEFIN, назад у SalesDrive не надсилаються.

Що потрібно перед початком

Підготуйте:

• доступ адміністратора до SalesDrive;
• API-ключ SalesDrive;
• піддомен кабінету — частину адреси перед .salesdrive.me;
• користувача QUINCEFIN з налаштованими параметрами за замовчуванням;
• папки для нових партнерів і товарів;
• склад і тип ціни для експорту;
• ID складу SalesDrive, якщо залишки потрібно вести по складах.

Наприклад, для адреси https://myshop.salesdrive.me/ у полі Акаунт (піддомен) потрібно вказати тільки myshop.

Створення API-ключа у SalesDrive

1. Увійдіть у кабінет SalesDrive.
2. Відкрийте Установки → Загальні налаштування і інтеграції → Інші сервіси → API.
3. Відкрийте розділ API-ключів і створіть новий ключ для QUINCEFIN.
4. Скопіюйте ключ у безпечне місце.

Пароль користувача SalesDrive не підходить для API. QUINCEFIN авторизується окремим API-ключем.

Довідкові матеріали SalesDrive: робота з API та опис API-методів.

Створення профілю в QUINCEFIN

1. Відкрийте Налаштування → Інтеграції → CRM-системи → SalesDrive.
2. Натисніть Створити.
3. Заповніть:
   • Профіль — зрозумілу назву підключення;
   • Акаунт (піддомен) — тільки піддомен SalesDrive без https:// і без .salesdrive.me;
   • API-ключ — ключ, створений у SalesDrive.
4. Натисніть Застосувати.
5. Натисніть Перевірити з’єднання.

Поля Webhook secret і Webhook URL формуються автоматично після першого збереження профілю.

Налаштування імпорту замовлень

На вкладці Замовлення заповніть:

• Період — інтервал для ручного імпорту;
• Користувач — відповідальний користувач, чиї налаштування застосовуються під час створення документів;
• Папка товарів — куди створювати нові товари із замовлень;
• Папка партнерів — куди створювати нових покупців;
• Автоматичний імпорт — увімкніть для перевірки змін кожні 5 хвилин;
• Перекриття, хв — повторне захоплення частини попереднього періоду, щоб не пропустити замовлення на межі синхронізації.

Рекомендоване перекриття — 5 хвилин. Допустиме значення — від 1 до 60 хвилин. Повторне отримання того самого замовлення не створює дубль: QUINCEFIN знаходить його за стабільним зовнішнім номером і оновлює непроведений документ.

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

Ручний імпорт

1. Виберіть період.
2. Збережіть зміни профілю.
3. Натисніть Імпорт.
4. Перевірте поле Останній обмін.
5. Відкрийте створені документи Замовлення покупця і перевірте покупця, товари, ціни, знижки, статус та доставку.

Автоматичний імпорт

Після увімкнення параметра Автоматичний імпорт QUINCEFIN перевіряє SalesDrive кожні 5 хвилин. Перший автоматичний запуск перевіряє останні 24 години, наступні — період від останньої успішної синхронізації з указаним перекриттям.

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

Webhook скорочує затримку між створенням або зміною замовлення у SalesDrive та його появою в QUINCEFIN.

1. Збережіть профіль SalesDrive у QUINCEFIN.
2. Скопіюйте сформований Webhook URL.
3. У SalesDrive відкрийте Установки → Загальні налаштування і інтеграції → Інші сервіси → Webhook.
4. Створіть webhook і вставте URL з профілю QUINCEFIN.
5. Увімкніть події створення нового замовлення та зміни статусу замовлення.
6. Збережіть webhook.
7. Створіть тестове замовлення або змініть його статус і перевірте результат у журналі обміну QUINCEFIN.

QUINCEFIN не довіряє даним замовлення безпосередньо з webhook. Після отримання події система повторно запитує актуальне замовлення через SalesDrive API і тільки потім оновлює документ.

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

Докладніше: Webhook у SalesDrive.

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

На вкладці Товари заповніть:

• Склад — склад QUINCEFIN, за яким розраховується залишок;
• Тип ціни — ціна, яка передається у SalesDrive;
• ID складу SalesDrive — заповнюється, якщо кількість потрібно оновлювати для конкретного складу SalesDrive;
• Групи товарів для експорту — папки каталогу, які потрібно передавати.

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

Перед першим експортом перевірте:

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

Експорт товарів

Кнопка Експортувати товари створює або оновлює товарні картки SalesDrive та передає ціну і залишок.

Експорт залишків

Кнопка Експортувати залишки оновлює тільки кількість. Назви, описи, ціни та інший товарний контент не змінюються.

Якщо вказано ID складу SalesDrive, кількість передається саме для цього складу. Якщо поле порожнє, оновлюється загальний залишок товару.

Як зіставляються дані

• замовлення — за внутрішнім зовнішнім номером, сформованим із форми та ID SalesDrive;
• товари під час імпорту — насамперед за артикулом SalesDrive;
• партнери — за назвою покупця;
• статуси — за назвами статусів SalesDrive;
• товари під час експорту — за стабільним внутрішнім кодом QUINCEFIN, артикулом або ID картки.

Якщо статусу замовлення ще немає в QUINCEFIN, система створює відповідну стадію документа Замовлення покупця.

Типові проблеми

Безпека

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

Пов’язана документація

• Інтеграції від QUINCEFIN
• Документ «Замовлення»