Подключение СберЛогистики

СберЛогистика закрывает сразу курьерскую доставку, пункты выдачи и постаматы, поэтому её удобно подключать как единую службу в 1С-Битрикс. Разберём, что нужно для интеграции, как добавить обработчик доставки, настроить тарифы и передавать заказы без ручного ввода.

Что даёт СберЛогистика магазину

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

Технически подключение сводится к тому, что в разделе Магазин → Настройки → Службы доставки появляется новая служба, которая на этапе оформления заказа обращается к API СберЛогистики, рассчитывает стоимость и срок, а после оформления передаёт отправление в личный кабинет оператора.

Способы подключения

К 1С-Битрикс СберЛогистику подключают тремя основными путями. Выбор зависит от редакции магазина, объёма заказов и того, нужен ли вам единый интерфейс для нескольких перевозчиков.

Для большинства магазинов рациональнее начать с проверенного модуля Маркетплейса, а к собственному обработчику переходить, когда стандартной логики перестаёт хватать — например, при сложных зонах, надбавках или объединении с самовывозом.

Что подготовить до настройки

API СберЛогистики закрыто авторизацией, поэтому интеграция начинается не в админке Битрикс, а в личном кабинете оператора. До настройки соберите доступы и параметры отгрузки.

• Договор и учётная запись в личном кабинете СберЛогистики — без действующего договора боевой API работать не будет.
• Токен (ключ) API и данные авторизации — их выдают в кабинете или через менеджера; храните их в защищённом месте, не в коде публично.
• Адрес и параметры склада отправки — город, индекс, контактное лицо: они подставляются как точка забора.
• Тестовый контур (если оператор его предоставляет) — чтобы проверить расчёт и создание отправлений до приёма реальных заказов.

Установка модуля и обработчик доставки

Модуль ставится стандартно: Marketplace → Установить решение либо загрузкой архива, после чего он появляется в списке установленных модулей в Настройки → Настройки продукта → Модули. Перед установкой сделайте резервную копию и проверьте совместимость с вашей версией главного модуля и модуля sale.

После установки новую службу добавляют в разделе /bitrix/admin/sale_delivery_service_list.php кнопкой «Добавить обработчик». В карточке службы указывают:

1. токен и параметры авторизации из личного кабинета;
2. адрес и реквизиты склада отправки;
3. режим работы — боевой или тестовый;
4. какие профили включить (курьер, ПВЗ, постамат).

Профили, тарифы и ограничения

Внутри службы СберЛогистики каждый сценарий — это отдельный профиль: курьер до двери, выдача в ПВЗ, постамат. Профиль может считать тариф автоматически по API либо перекрываться вашими правилами наценки.

Ключевые узлы настройки:

• Расчёт стоимости — по данным API или с фиксированной надбавкой/скидкой поверх тарифа оператора;
• Ограничения (restrictions) — по весу, сумме заказа, местоположению и способу оплаты; именно ими вы скрываете профиль там, где он неприменим;
• Наценка на доставку — если хотите закладывать упаковку или частично субсидировать доставку;
• Сроки — их обычно берут из ответа API и показывают покупателю в корзине.

Ограничения удобно комбинировать с местоположениями: привяжите профиль ПВЗ к городам присутствия сети, а курьера — к зонам, где оператор реально возит. Тогда покупатель не увидит недоступный способ и не столкнётся с ошибкой на оплате.

Пункты выдачи и постаматы на карте

Главная ценность профилей ПВЗ и постаматов — выбор точки на карте прямо в оформлении заказа. Модуль запрашивает у API список пунктов по городу и отдаёт их компоненту оформления sale.order.ajax, где покупатель выбирает удобный адрес.

Чтобы карта работала предсказуемо, проверьте три вещи:

• корректное определение местоположения покупателя — от него зависит выборка ПВЗ;
• актуальность справочника пунктов: список обновляют по расписанию (агентом или cron), а не жёстко «зашивают»;
• сохранение выбранного пункта в свойствах заказа, чтобы адрес выдачи ушёл в личный кабинет вместе с отправлением.

Передача заказов и статусы

Полноценная интеграция не заканчивается расчётом. После оформления заказа модуль должен создавать отправление в СберЛогистике по API, получать трек-номер и печатать этикетку, а затем подтягивать статусы обратно в магазин.

Обычно это работает так:

1. заказ переходит в нужный статус — например, «Оплачен» или «Готов к отгрузке»;
2. по событию или агенту магазин отправляет данные отправления в API и сохраняет трек-номер в заказе;
3. менеджер печатает этикетку и формирует акт приёма-передачи;
4. статусы доставки периодически синхронизируются, а трек показывается покупателю.

Итог

Подключение СберЛогистики к 1С-Битрикс — это последовательность из четырёх шагов: договор и токен в личном кабинете, установка модуля, добавление обработчика доставки с профилями курьера, ПВЗ и постаматов, и настройка передачи заказов со статусами. Отдельного внимания требуют заполненные вес и габариты, актуальный справочник ПВЗ и ограничения по местоположениям.

Если нужна нестандартная логика тарифов, объединение с другими перевозчиками или собственный обработчик через REST API, мы в B2Bsite подключаем службы доставки и настраиваем обмен заказами так, чтобы менеджер не вводил данные вручную. Поможем и с поддержкой уже работающей интеграции, когда меняется API оператора.