• Інтеграції · SalesDrive /handler/

Інтеграція інтернет-магазину з SalesDrive

Замовлення з сайту стає заявкою в SalesDrive з товарами, доставкою й UTM-мітками, а статус і ТТН повертаються на сайт. Для OpenCart, WooCommerce і Хорошопу в самого SalesDrive є модулі, тож нашої роботи там часто не треба. Беремося там, де модуля немає або він не бачить ваших полів: самописний сайт, Next.js, перероблений чекаут. Інтеграцій із SalesDrive для клієнтів ми ще не робили — будуємо обмін під вашу задачу за офіційною документацією API.

Подивитись, як це працює
Вартість
після безкоштовного аудиту
Гарантія
30 днів після підписання акта
Як замовлення потрапляє в CRM
запитом до /handler/ вашого акаунта, із зовнішнім номером і UTM-мітками
після безкоштовного аудиту
Вартість
Гарантія

днів після підписання акта

запитом до /handler/ вашого акаунта, із зовнішнім номером і UTM-мітками
Як замовлення потрапляє в CRM
статус і ТТН — вебхуком при створенні заявки або зміні статусу
Що повертається на сайт
місто, відділення й адресу Нової Пошти та Укрпошти в уже створеній заявці
Чого API не змінює
Ліміт на список заявок

запитів за хвилину, 100 за годину, 1000 за добу

Строк робіт

робочих днів після розбору

Кому підходить

Ситуації, у яких ця послуга дає результат

Сценарій 1 із 4

Сайт самописний або на Next.js — модуля під нього немає

SalesDrive публікує модулі для популярних платформ, а для решти лишає API. Тоді замовлення треба віддавати в заявку самим: зібрати товари, доставку, оплату й мітки в той формат, який чекає CRM, і не загубити їх при збої.

Розберемо вашу ситуацію на безкоштовному аудиті
Що входить

Повний перелік робіт і того, що ви отримуєте на виході

  • Передача замовлення в заявку SalesDrive: товари, оплата, спосіб доставки, коментар — менеджер нічого не переносить руками
  • Зовнішній номер замовлення в кожній заявці: перед повтором після збою сайт звіряється зі списком заявок, тому друга заявка на те саме замовлення не з'являється
  • UTM-мітки й адреса сторінки, з якої прийшло замовлення, — у полях заявки
  • Дані доставки окремим блоком потрібного перевізника: Нова Пошта, Укрпошта, Meest чи Rozetka Delivery
  • Номер заявки SalesDrive, збережений на боці сайту, — видно, яке замовлення куди пішло
  • Приймач вебхука SalesDrive: статус і ТТН повертаються на сайт, у кабінет покупця або в лист
  • Зведення за розкладом через список заявок у межах лімітів SalesDrive — ловить вебхук, що не дійшов
  • Залишки з YML-експорту SalesDrive на сайт за розкладом, з прив'язкою за артикулом чи id
  • Черга з повторними спробами й журнал передач: видно, що пішло, що відповіла CRM і що повторити
  • Перевірка на живому замовленні разом із вашим менеджером і коротка інструкція
  • Гарантія 30 календарних днів на виконані роботи
Коли ця послуга не підходить

Що не входить у роботу — щоб не було сюрпризів на здачі

  • Тариф і ліцензії SalesDrive — договір із ними ваш
  • Налаштування воронки, статусів, прав менеджерів і автозавдань усередині SalesDrive
  • Підключення маркетплейсів, для яких у SalesDrive є вбудована інтеграція
  • Перенесення історії клієнтів і замовлень зі старої CRM — окрема послуга
  • Налаштування телефонії

Безкоштовний розбір: модуль SalesDrive чи власний обмін

Спершу з'ясовуємо, чи потрібна тут розробка взагалі. Для OpenCart, WooCommerce і Хорошопу SalesDrive має власні модулі, і часто досить поставити їх і налаштувати. Писати код є сенс лише там, де модуль не бачить ваших полів або модуля під вашу платформу немає.

Що ми міряємо

  • Платформа і наявність модуляOpenCart (версії від 1.5 до 4.0 за описом SalesDrive), WooCommerce, Хорошоп — модуль є. Самописний сайт, Next.js, сильно перероблений чекаут — його немає або він передасть не все.
  • Поля чекауту проти полів заявкиПорівнюємо, що збирає ваш кошик, з тим, що приймає заявка SalesDrive: товари, оплата, доставка, коментар, UTM-мітки, сторінка, з якої прийшло замовлення.
  • Служби доставкиНова Пошта, Укрпошта, Meest і Rozetka Delivery передаються окремими блоками даних. Дивимось, у якому вигляді сайт зберігає місто й відділення: назвою чи ідентифікатором перевізника.
  • Що має повертатись на сайтСтатус замовлення, ТТН, залишки. Кожен зворотний потік — окремий сценарій, і не кожному магазину він потрібен.
  • Прив'язка товарівЗа артикулом чи за id, як поводяться опції й варіації. Без цього залишки з CRM лягають не на ті картки.

Що ви отримуєте

  • Висновок: ставити модуль SalesDrive чи будувати власний обмін — із причиною.
  • Таблицю відповідності полів чекауту полям заявки SalesDrive.
  • Перелік зворотних потоків, які варто вмикати, і тих, що можна пропустити.
  • Оцінку робіт зі строком, якщо розробка справді потрібна.

Строк: 2–3 робочих дні

Чому це безкоштовно

Бо часто відповідь звучить як «поставте модуль SalesDrive і налаштуйте статуси» — і краще дізнатись це до того, як платити за код.

Що далі

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

Коротка форма: контакт і адреса сайту

Працюємо офіційно

Договір, акт і рахунок — на кожен проєкт, а не тільки на великий. Без документів у вас немає ні прав на роботу, ні підстави провести витрати.

Нам довіряють6 брендів

Нам довіряють: Kvant Energy, GYPSUN, Naturel Cosmetics, Pancer Protection, LUGI, BeeTech

Умови, зафіксовані письмово8 пунктів
  • 01

    Договір, акт і гарантія 30 днів

    На кожен проєкт письмовий договір: обсяг, строки, сума, порядок приймання. Після здачі — акт і рахунок, а далі 30 календарних днів гарантії: помилки з нашої вини усуваємо безоплатно. Усне з дзвінка дублюємо письмово того ж дня.

  • 02

    ФОП і безготівковий розрахунок

    Виконавець — зареєстрований ФОП. Оплата на рахунок із закривними документами.

  • 03

    Права й доступи — ваші

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

  • 04

    Портал клієнта замість переписки

    На час роботи ви отримуєте доступ до порталу: договори, рахунки, акти й стан проєкту в одному місці.

  • 05

    Сайти в дев'яти країнах

    Наші сайти працюють у дев'яти країнах: крім України — Польща, Німеччина, Австрія, Англія, Норвегія, Болгарія, Молдова, Іспанія.

  • 06

    Цифри, які можна перевірити

    Кожен кейс у портфоліо — з посиланням на живий сайт і технічним виміром.

  • 07

    Спершу аудит, потім сума

    Прайсу на сайті немає навмисно: обсяг тієї самої роботи у двох клієнтів відрізняється в рази.

  • 08

    Кажемо «ні», коли не впевнені

    Якщо задача не наша або строк нереальний — скажемо одразу.

  • 01

    Договір, акт і гарантія 30 днів

    На кожен проєкт письмовий договір: обсяг, строки, сума, порядок приймання. Після здачі — акт і рахунок, а далі 30 календарних днів гарантії: помилки з нашої вини усуваємо безоплатно. Усне з дзвінка дублюємо письмово того ж дня.

  • 02

    ФОП і безготівковий розрахунок

    Виконавець — зареєстрований ФОП. Оплата на рахунок із закривними документами.

  • 03

    Права й доступи — ваші

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

  • 04

    Портал клієнта замість переписки

    На час роботи ви отримуєте доступ до порталу: договори, рахунки, акти й стан проєкту в одному місці.

  • 05

    Сайти в дев'яти країнах

    Наші сайти працюють у дев'яти країнах: крім України — Польща, Німеччина, Австрія, Англія, Норвегія, Болгарія, Молдова, Іспанія.

  • 06

    Цифри, які можна перевірити

    Кожен кейс у портфоліо — з посиланням на живий сайт і технічним виміром.

  • 07

    Спершу аудит, потім сума

    Прайсу на сайті немає навмисно: обсяг тієї самої роботи у двох клієнтів відрізняється в рази.

  • 08

    Кажемо «ні», коли не впевнені

    Якщо задача не наша або строк нереальний — скажемо одразу.

NDA підписуємо на запит. Після завершення співпраці наші доступи до ваших сервісів видаляємо самі.

Що впливає на вартість

Чому дві однакові на вигляд задачі рахуються по-різному

  • Модуль чи власний обмінЯкщо модуль SalesDrive бере на себе замовлення, а доробити треба два нестандартні поля, робота вимірюється днями. Якщо модуля під платформу немає, передачу, зворотний потік і залишки будуємо з нуля — це верхня межа строку.
  • Скільки служб доставкиКожен перевізник у заявці SalesDrive — окремий блок зі своїми полями. Для Нової Пошти важливо, як сайт зберігає місто й відділення: ідентифікатор перевізника передається надійніше за назву, а назву доводиться узгоджувати з форматом, який чекає CRM.
  • Зворотний потікПрийом вебхука, збереження статусу й ТТН, показ покупцю і зведення за розкладом — окремий етап. Не потрібен — випадає з кошторису повністю.
  • Залишки й прив'язка товарівКаталог без артикулів або з опціями, де кожна комбінація — окремий залишок, вимагає спершу навести лад у прив'язці. Інакше YML-файл із CRM оновлює не ті картки.
  • Кілька сайтів в одному акаунтіКожен сайт отримує свою ознаку в заявці й свій вебхук з умовою. Роботи додається небагато, але її треба закласти до старту.
Етапи роботи

Прозорі етапи з погодженням на кожному кроці

Загальний строк:4–12 днів

  1. Розбір: модуль чи розробка

    2–3 робочих дні, до кошторису

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

  2. Ключ API, довідники, таблиця полів

    1–2 робочих дні

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

  3. Передача замовлень

    1–3 робочих дні

    Оформлене замовлення спершу пишеться в базу сайту, потім фоном іде в SalesDrive із зовнішнім номером, мітками й доставкою. Номер заявки, який повертає CRM, зберігаємо на сайті.

  4. Вебхук і зворотний потік

    0–3 робочих дні — вмикається за потреби

    Приймач повідомлень SalesDrive про нову заявку й зміну статусу: оновлює замовлення, кладе ТТН у кабінет чи лист. Раз на кілька хвилин сайт звіряє останні заявки через список, щоб не пропустити вебхук, що не дійшов.

  5. Залишки з YML

    0–2 робочих дні — вмикається за потреби

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

  6. Живе замовлення, журнал, передача

    2 робочих дні

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

Не знайшли свій випадок?

Опишіть, як це влаштовано у вас, — відповімо, чи підходить «Інтеграція SalesDrive» і що це означає у вашій ситуації. Без брифу й без дзвінка: одне питання, одна відповідь.

Технології та інтеграції

На чому будуємо і з чим це з'єднується

Стек

  • SalesDrive /handler/ — створення заявки з товарами, доставкою, мітками й зовнішнім номером. Межа: повний перелік параметрів видно лише в кабінеті акаунта.
  • /api/order/update/ — статус, менеджер, ТТН, товари. Межа: місто, відділення й адреса Нової Пошти та Укрпошти так не оновлюються.
  • Вебхуки SalesDrive — POST JSON при створенні чи зміні статусу. Межа: підпис і повторна доставка не описані.
  • /api/order/list/ — зведення пропущеного. Межа: 10 запитів за хвилину, 100 за годину, 1000 за добу.
  • YML-експорт товарів — залишки для сайту. Межа: між двома завантаженнями файлу залишок може відставати.
  • OpenCart 3 і 4, WooCommerce, Next.js — наш бік. Межа: на Next.js і самописних сайтах модуля немає.
  • Черга й журнал передач. Межа: у журналі персональні дані, строк зберігання обмежений.

Інтеграції

  • SalesDrive
  • Нова Пошта
  • Укрпошта
  • Meest
  • Rozetka Delivery
Власний обмін через API проти готового модуля SalesDrive

Чим цей варіант відрізняється від альтернативи

Коли підходитьсамописний сайт, Next.js, чекаут із нестандартними полями, кілька сайтів з окремою логікою
Стартрозробка на 4–12 робочих днів після розбору
Нестандартні полякожне поле чекауту зіставлене з полем заявки
Збій на боці CRMзамовлення лежить у базі сайту, черга повторює спробу, помилка видна в журналі
Хто підтримуєми — після оновлень платформи чи API перевіряємо обмін
Кейси

Задачі та результат у цифрах — усі показники зняті нашим виміром

власний преміум-шаблон і набір модулів для OpenCart 4 з адаптацією під український ринок

Задача
Зробити так, щоб магазин на OpenCart 4 з великим каталогом відкривався швидко й із коробки вмів те, що в Україні потрібно завжди: Нову Пошту з накладними, українські платіжки, нормальний пошук і структуровані дані — замість того щоб щоразу збирати це з чужих модулів різної якості.
Рішення
Шаблон для OpenCart 4.1+ на PHP 8.1+ з власним шаром кешування (APCu для об'єктного кешу, OPcache з JIT, nginx fastcgi_cache, прогрів топових категорій за розкладом) і виправленням N+1 у категоріях, де нативний OpenCart робив по 200+ запитів COUNT. Поверх — Theme Engine з 10 готовими пресетами дизайну і 200+ налаштувань, пошук на FULLTEXT із синонімами й автодоповненням, повідомлення про появу товару з відновленням через email і SMS, відгуки з розміткою AggregateRating, набір схем JSON-LD (Organization, WebSite, Product, Breadcrumb, Article, FAQ), український шар: Нова Пошта з автоматичними накладними, реєстрами й вебхуками, Укрпошта, LiqPay, monobank, WayForPay. Окремо — сторінка трекінгу замовлення й друкований рахунок, захищений токеном. Постачається п'ятьма архівами: повний інсталятор, тема для маркетплейсу і три самостійні модулі.
Результат
Внутрішній стенд на каталозі 14 тис. товарів: нативний OpenCart 4 віддає холодну категорію за 8–17 секунд, з нашим шаблоном — 0,18 с з кешу і 0,8 с без нього, тобто в 30–95 разів швидше. У кодовій базі 8 157 файлів PHP, 718 шаблонів Twig і 726 файлів JavaScript; у переліку можливостей 167 пунктів у 16 розділах. Версія 1.1.0, продукт готується до запуску й публічно ще не виходив.
Що потрібно від вас

Без цього не почнемо — краще підготувати заздалегідь

  1. Адміністратор SalesDrive з вашого боку: створює ключ API й додає вебхук, ми ключ не генеруємо.
  2. Доступи до сайту й адмінки з правом ставити доробки.
  3. Перелік статусів SalesDrive, які покупець має бачити на сайті, і тих, що лишаються внутрішніми.
  4. Служби доставки, якими відправляєте, і приклад замовлення на кожну.
  5. Правило прив'язки товарів: артикул чи id; як оформлені опції.
  6. Чи працюють в одному акаунті SalesDrive кілька сайтів.

Якщо чогось із цього немає — скажіть, підкажемо, як зібрати або зробимо самі окремою задачею.

Часті питання

Те, що питають найчастіше — з конкретними відповідями

У SalesDrive є модуль для OpenCart. Навіщо тоді розробка?

Часто вона й не потрібна. За описом самого SalesDrive, модуль для OpenCart і ocStore підтримує версії від 1.5 до 4.0, передає замовлення, UTM-мітки, забирає залишки й оновлює статус на сайті, коли його змінили в CRM. Схожі модулі є для WooCommerce, а Хорошоп підключається прямо в налаштуваннях. Розробка потрібна, коли модуля під платформу немає або чекаут перероблений так, що модуль його не бачить. На розборі кажемо, який із двох випадків ваш.

Ви вже інтегрували магазини з SalesDrive?

Ні, для клієнтів — ще ні, і видавати це за досвід не будемо. Спираємось на офіційну документацію API SalesDrive та на свою роботу з тим, що в обміні найважче: накладними й вебхуками Нової Пошти у власному шаблоні для OpenCart 4. Кейс нижче про це, а не про SalesDrive. Сусідня сторінка про KeyCRM описує той самий підхід для іншої CRM.

Як не створити дві заявки на одне замовлення?

Кожна заявка несе зовнішній номер — номер замовлення на сайті, а при створенні ми просимо SalesDrive повернути номер заявки й зберігаємо його поруч із замовленням. Найризиковіший випадок — коли заявку створено, а відповідь загубилась: сайт не створює заявку повторно наосліп, спершу шукає замовлення серед останніх заявок у списку. Знайшов — далі лише оновлює заявку, за номером або за зовнішнім номером, як дозволяє API. Так видно, яке замовлення вже в CRM, а яке ще в черзі.

Покупець змінив відділення після оформлення. Сайт це оновить у CRM?

Ні, і це межа самого SalesDrive: через API не можна змінити місто, відділення й адресу Нової Пошти та Укрпошти в уже створеній заявці. Статус, менеджера, ТТН і товари змінити можна. Тому зміну адреси після оформлення робить менеджер у CRM, а сайт лише показує покупцю, що запит прийнято. Ми прямо пишемо це в інструкції, щоб ніхто не чекав автоматики там, де її немає.

Як номер ТТН потрапляє на сайт?

Вебхуком: SalesDrive надсилає POST із даними заявки, коли вона створена або змінила статус, і дозволяє обрати, у яких статусах надсилати. Документація не описує ні підпису повідомлення, ні повторної доставки, тому приймач перевіряє секрет в адресі, не змінює замовлення двічі, а сайт раз на кілька хвилин звіряє останні заявки через список. Список обмежений десятьма запитами за хвилину, тож звіряємо пачками.

А залишки на сайті оновлюватимуться з SalesDrive?

Так, через YML-експорт товарів: його вмикають у налаштуваннях SalesDrive, файл оновлюється сам, а сайт забирає його за розкладом. Між двома завантаженнями файлу залишок на сайті може відставати, тому частоту підбираємо під ваш обіг. Найчастіша проблема тут не в обміні, а в прив'язці: якщо в частини товарів немає артикулів або опції не розкладені окремими позиціями, залишок ляже не на ту картку.

Скільки коштує сам SalesDrive?

Тариф SalesDrive встановлює сам сервіс, і договір на нього ви укладаєте напряму з ним, без нас. Актуальні умови дивіться на salesdrive.ua. Ми рахуємо лише свою роботу з обміну, і суму називаємо після безкоштовного розбору.

Від чого залежить строк — 4 чи 12 днів?

Від етапів, які потрібні саме вам. Обов'язкових три: ключ API й таблиця полів (1–2 дні), передача замовлень (1–3 дні) і перевірка на живому замовленні (2 дні) — разом 4–7 робочих днів. Вебхук зі статусами й ТТН додає до 3 днів, залишки з YML — до 2, і кожен із них вмикається лише за потреби; з усіма етапами виходить 12. Розбір до цього строку не входить: він окремий, 2–3 дні й безкоштовний.

Напишіть, на чому зроблений сайт і що має ходити між ним і SalesDrive.

У відповідь — висновок, чи досить модуля SalesDrive, таблиця відповідності полів і, якщо розробка справді потрібна, оцінка по етапах зі строком.

Дивитись кейси
  • Відповідь протягом 2 годин
  • Без зобов’язань
  • Працюємо за договором

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