Если вы директор офиса СДЭК-франчайзи, эта статья — про то, как CRM подключается к вашим привычным системам СДЭК без ежедневного копирования Excel. Если вы IT-специалист или интегратор — в конце есть техническая сводка.
Коротко: BIT CRM уже умеет забирать данные из Superset (детализация по заказам) и из ЭК5 (сводный profit и статусы доставки). Один логин СДЭК — и оба источника доступны из CRM. Это работает в production на crm.bit22.ru — в нашем собственном офисе.
О чём речь простыми словами
У франчайзи СДЭК обычно три «точки входа» в цифровую экосистему:
- ЭК5 — личный кабинет партнёра: биллинг, заказы, статусы, касса на ПВЗ.
- Superset — аналитика и отчёты Big Data: детализация выручки по каждому заказу (раньше — выгрузка в Excel).
- Своя CRM — продажи, сопровождение клиентов, зарплата, план/факт.
Без интеграции сотрудники ходят по кругу: Superset → Excel → загрузка в CRM → снова ЭК5 за статусом. С интеграцией — кнопка в CRM, и данные подтягиваются сами. Подробный сценарий «как было / как стало» — в статье про биллинг без Excel.
Один пароль вместо трёх (SSO)
SSO (Single Sign-On) — это «единый вход». Сотрудник один раз вводит логин и пароль СДЭК (через Keycloak), и CRM получает доступ и к Superset, и к gateway ЭК5. Не нужно хранить отдельные пароли к каждому сервису и не нужно каждый день логиниться в три окна.
Настройка — в профиле пользователя CRM, раздел «СДЭК Superset». Сессия хранится зашифрованно; при истечении CRM попросит войти снова.
Два потока данных — зачем оба
| Откуда | Что попадает в CRM | Зачем офису |
|---|---|---|
| Superset | Каждый заказ: номер, дата доставки, billing, себестоимость, договор, маршрут, B2B/C2C | Журнал заказов, мотивация менеджеров, сверка с планом |
| ЭК5 (gateway) | Сводный profit по периоду; история статусов доставки по заказу | План/факт по выручке; статус «Вручено» без захода в личный кабинет |
Superset даёт детализацию — «кто и сколько заработал на каком заказе». ЭК5 даёт агрегат — «сколько profit начислил биллинг за месяц» и актуальный статус доставки. Вместе это закрывает и ежедневную работу менеджера, и ежемесячную сверку директора.
Что ещё подключено
- CDEK API v2 — калькулятор доставки, справочник городов и ПВЗ, оформление заказа. Опционально: публичный виджет на сайте партнёра.
- Импорт из Excel — оставили для переходного периода, если офис ещё не настроил SSO. Пути: загрузка биллинга и импорт клиентов из реестра франчайзи.
Что это даёт бизнесу
- Финансист не тратит утро на выгрузку из Superset — минуты вместо цепочки Excel.
- Менеджер по сопровождению видит статус доставки в CRM, а не в отдельной вкладке ЭК5.
- Директор видит план/факт в одном дашборде: billing из Superset + profit из ЭК5.
- Для IT: интеграции документированы, есть миграции БД и разграничение прав (RBAC) — не «скрипт на коленке».
Для IT-директора и интегратора: техническая сводка
Ниже — то, что обычно спрашивают на техвстрече.
Superset CDEK
superset.cdek.ru — OAuth SSO, chart API, фильтры по юрлицу. Автоимпорт в таблицу orders. Настройки — в админке CRM (superset_settings, мультитенант по legal_entity). Дашборд 243, чарт 7694 «Детализация по заказам».
ЭК5 Gateway
gateway.cdek.ru — OAuth PKCE, endpoint accruals-summary (Profit), order history (статусы). Единая cookie-сессия с Superset через Keycloak SSO. История статусов — до 28+ событий на заказ в ek5_status_history.
SSO Keycloak
Один логин пользователя CRM → доступ к Superset + ЭК5. Сессионные cookies хранятся зашифрованно, повторная авторизация при истечении.
CDEK API v2
Калькулятор, города, ПВЗ, заказы — опциональный публичный виджет (cdekCalculatorEnabled).
Legacy и миграция
Excel import (/billing/upload) и franchise import (/clients/import-cdek-franch) — для перехода с ручных процессов.
Как это собирается в продукт для партнёра — в статье про модули и white-label. Обзор всей серии — лендинг CRM для офиса СДЭК-франчайзи.
Франчайзи СДЭК: нефискальная печать на кассах АТОЛ требует актуальной прошивки (ИТС Connect). Мы сами партнёры франшизы и знаем ЭК5 — обновление «под ключ» с минимальным участием собственника. Напишите в TechSpot или оформите на marketbit.ru — от 5 500 ₽.