• Интеграции · 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, таблица соответствия полей и, если разработка действительно нужна, оценка по этапам со сроком.

Из измеренных кейсовВнутренний стенд на каталоге 14 тыс

Смотреть кейсы
  • Ответ в течение 2 часов
  • Без обязательств
  • Работаем по договору

Прайса на сайте нет намеренно: объём той же работы у двух клиентов отличается в разы, и цифра «от» в этом случае ничего не объясняет. Сначала бесплатный аудит — считаем ваши страницы, дубли и скорость, — потом называем сумму и срок и фиксируем их в договоре.