СберЛогистика подключается к 1С-Битрикс как внешняя служба доставки: расчёт тарифов, карта ПВЗ и постаматов, создание заказов и трек-номеров идут через её API. Разберём подключение по трём уровням — сайт, CRM и учётная система.
Способы подключения
В коробке 1С-Битрикс готового обработчика СберЛогистики нет, поэтому используют один из трёх путей. Выбор зависит от того, где рождается заказ и насколько глубоко нужна автоматизация.
| Способ | Когда подходит | Что даёт |
|---|---|---|
| Готовый модуль из Маркетплейса | Типовой интернет-магазин | Расчёт, ПВЗ, накладные «из коробки» |
| Кастомный обработчик | Нестандартная логика тарифов | Полный контроль над расчётом |
| Обмен через CRM/1С | Заказы ведутся в учётной системе | Накладные создаются на стороне учёта |
Технически интеграция всегда сводится к вызовам REST API СберЛогистики: авторизация, расчёт, справочник точек, создание отправления, статусы.
Доступ к API и договор
Перед разработкой нужен договор со СберЛогистикой и доступ в личный кабинет, где выдаются реквизиты для API. Обычно это логин, пароль или токен и идентификатор договора, по которому тарифицируются отправления.
- Тестовый контур для отладки без реальных отправлений.
- Боевые ключи, которые хранят в настройках модуля, а не в коде.
- Номер договора и склад отправителя по умолчанию.
.settings.php вне репозитория. Не коммитьте боевые токены в систему контроля версий.Расчёт тарифов на сайте
На витрине СберЛогистика подключается как профиль службы доставки. При оформлении Битрикс вызывает метод calculate(), который отправляет в API вес, габариты, город отправителя и получателя и тип доставки (до двери, до ПВЗ, постамат).
- Собираем параметры отправления из корзины.
- Запрашиваем тариф и срок у API.
- Возвращаем в
CalculationResultцену и срок доставки.
Результат стоит кэшировать на несколько минут, чтобы не дёргать API на каждое изменение корзины. Обязательно предусмотрите fallback-тариф на случай недоступности сервиса.
ПВЗ и постаматы на карте
СберЛогистика отдаёт справочник пунктов выдачи и постаматов через API. Есть два подхода к их отображению.
- Онлайн-запрос — точки подгружаются под выбранный город при оформлении. Всегда актуально, но зависит от скорости API.
- Импорт в Highload-блок — справочник выгружается по расписанию (агент или cron) и хранится локально. Карта работает быстрее и не зависит от доступности API в момент оформления.
Для витрины удобно показывать точки на карте (2ГИС или Яндекс) с фильтром по типу «ПВЗ / постамат» и режиму работы. Выбранная точка сохраняется в свойстве заказа и потом уходит в накладную.
Накладные и трекинг
После оформления заказ передаётся в СберЛогистику вызовом создания отправления. В ответ приходит номер заказа и трек-номер, которые сохраняются в свойствах заказа Битрикса.
- Печать этикетки/наклейки — из PDF, который отдаёт API.
- Статусы отправления — по расписанию опросом API или через вебхуки, если они доступны по договору.
- Трек-номер показывается покупателю в личном кабинете и в письмах.
Связка с CRM и 1С
Если заказы ведутся в CRM Битрикс24 или в 1С, накладные логично создавать там, где менеджер обрабатывает заказ. Схема обмена такая: заказ с сайта уходит в учётную систему, оттуда по кнопке или автоматически создаётся отправление СберЛогистики, а трек-номер возвращается на сайт.
- Единый источник статусов оплаты и отгрузки — учётная система.
- Меньше дублей: накладная создаётся один раз.
- Обратная передача трека на сайт для информирования клиента.
Такой обмен строят на REST Битрикса и API СберЛогистики, с логированием и контролем ошибок, чтобы не терять отправления.
Итог
Подключение СберЛогистики к 1С-Битрикс — это расчёт тарифов на витрине, актуальный справочник ПВЗ и постаматов, автосоздание накладных с трек-номерами и аккуратная связка с CRM или 1С. Ключевые нюансы — кэш расчёта, fallback, идемпотентность создания отправлений и надёжное хранение ключей API.
Мы в B2Bsite подключаем СберЛогистику под конкретную схему продаж: где считается тариф, где создаётся накладная и как статусы возвращаются клиенту. Настраиваем обмен так, чтобы он не создавал дублей и переживал сбои API.
Частые вопросы
Есть ли у Битрикса встроенный модуль СберЛогистики?
В коробке — нет. Используют готовый модуль из Маркетплейса, кастомный обработчик или обмен через CRM/1С. Все варианты работают через REST API СберЛогистики.
Что нужно для доступа к API?
Договор со СберЛогистикой и реквизиты из личного кабинета — токен или логин/пароль и номер договора. Обычно есть тестовый контур для отладки.
Как показать пункты выдачи на сайте?
Справочник ПВЗ и постаматов берётся из API. Точки либо подгружаются онлайн под город, либо импортируются в Highload-блок по расписанию для скорости.
Можно ли печатать этикетки?
Да, API отдаёт печатную форму накладной в PDF после создания отправления. Её выводят на печать прямо из карточки заказа.
Как обновляются статусы доставки?
Опросом API по расписанию через агент или cron, а при поддержке — через вебхуки. Статус и трек-номер сохраняются в свойствах заказа.
Где создавать накладную — на сайте или в 1С?
Там, где менеджер реально обрабатывает заказ. Если продажи ведутся в CRM или 1С, логичнее создавать отправление там, а трек возвращать на сайт.
Как избежать задвоения отправлений?
Перед вызовом создания проверяйте, нет ли уже сохранённого трек-номера у заказа. Это обеспечивает идемпотентность и защищает от дублей.
Нужно ли кэшировать расчёт тарифа?
Да, чтобы не обращаться к API на каждое изменение корзины. Кэш на несколько минут по службе, весу и городу заметно ускоряет оформление.
Поможем с настройкой и поддержкой Интеграции и связки систем
Поможем с настройкой, доработкой и поддержкой Интеграции и связки систем.