Подключение ПЭК к магазину

ПЭК — это межтерминальная транспортная компания (LTL), а не курьерская служба, поэтому «коробочного» обработчика в 1С-Битрикс для неё нет. Подключение сводится к собственной службе доставки, которая обращается к API личного кабинета ПЭК и считает стоимость перевозки сборного груза по весу, объёму и паре городов.

Чем ПЭК отличается от курьерских служб

ПЭК возит сборные грузы между терминалами: клиент забирает заказ на терминале в своём городе либо заказывает довоз до адреса отдельной услугой. Это принципиально меняет логику расчёта по сравнению с СДЭК или курьером «до двери».

• Тариф зависит не только от веса, но и от объёма (плотности груза) — крупногабаритная лёгкая коробка считается по объёмному весу.
• Маршрут строится терминал-терминал, а адресный забор и доставка — это дополнительные платные услуги.
• В API оперируют не населёнными пунктами КЛАДР, а внутренними кодами филиалов ПЭК.

Доступ к API и авторизация

Расчётный API ПЭК открывается по заявке в личном кабинете kabinet.pecom.ru. После активации вы получаете пару учётных данных для авторизации.

Запросы уходят методом POST с телом в JSON на базовый адрес API калькулятора. Авторизация — HTTP Basic (логин:ключ в заголовке Authorization). Ключевой метод расчёта — calculator/calculate; справочник филиалов и городов отдаётся отдельными методами (branches/all, branches/find).

Создание собственной службы доставки

В Битрикс с версии модуля sale службы доставки — это классы-наследники Bitrix\Sale\Delivery\Services\Base с профилями (наследники Bitrix\Sale\Delivery\Services\Config). Обработчик регистрируется через событие onSaleDeliveryHandlersClassNamesBuildList.

1. В модуле (или в local/php_interface/init.php) подпишитесь на событие и верните путь к классу и его имя.
2. Опишите класс службы: в getClassTitle() и getClassDescription() — название «ПЭК», в getConfigStructure() — поля apiLogin и apiKey.
3. Реализуйте профиль с методом calculateConcrete(Shipment $shipment), который возвращает Bitrix\Sale\Delivery\CalculationResult.

Внутри calculateConcrete вы собираете параметры отправления из корзины и заказа, вызываете API ПЭК и кладёте цену в $result->setDeliveryPrice(). После установки службы она появится в Магазин → Настройки → Службы доставки как обычный способ доставки.

Формирование запроса на расчёт

Метод calculator/calculate ждёт города отправления и назначения (коды филиалов ПЭК) и список мест груза. Габариты берите из товаров: свойства веса и размеров ведите в каталоге, иначе расчёт вернёт объёмный вес по умолчанию и цена будет завышена.

• senderCityId / receiverCityId — коды филиалов ПЭК для города склада и города клиента;
• cargos — массив мест: length, width, height (в метрах) и weight (в кг) на каждое место;
• isOpenCarSender / isDayByDay и флаги допуслуг — забор от адреса, довоз до двери, страхование.

Город клиента определяйте по местоположению заказа: из $shipment получите свойство «Местоположение», по КЛАДР найдите название города и сопоставьте его с филиалом через branches/find. Результат сопоставления кэшируйте.

Сопоставление города клиента с филиалом

Самое хрупкое место интеграции — превратить произвольный адрес покупателя в код филиала ПЭК. Битрикс хранит местоположения в модуле sale (таблица местоположений и КЛАДР-коды), а ПЭК оперирует своим справочником.

• Один раз выгрузите справочник филиалов методом branches/all и сохраните в таблицу-справочник модуля или в HL-блок.
• Свяжите КЛАДР-код города Битрикса с branchId ПЭК — по названию города и региону.
• Для городов без прямого терминала используйте ближайший филиал плюс услугу довоза; помечайте такие направления отдельно.

Если сопоставление не найдено, не роняйте оформление заказа: верните из calculateConcrete результат с ошибкой ($result->addError()) и понятным текстом, чтобы Битрикс скрыл эту службу, а не показал нулевую цену.

Кэширование, таймауты и обработка ошибок

Расчёт дёргается на каждом шаге оформления и при пересчёте корзины — прямой вызов API на каждый чих замедлит checkout и упрётся в лимиты ПЭК.

• Кэшируйте ответ по ключу «города + суммарные габариты + набор услуг» через Bitrix\Main\Data\Cache на 10–30 минут.
• Ставьте таймаут HTTP-клиента (Bitrix\Main\Web\HttpClient) в 3–5 секунд, чтобы недоступность API не вешала корзину.
• Логируйте сырые запрос и ответ в файл или в журнал событий (AddEventToLog) — при спорах о цене это спасает.

Тестирование и запуск

Перед публикацией прогоните типовые сценарии на тестовых заказах, сверяя цену с калькулятором в личном кабинете ПЭК.

1. Город с прямым терминалом, лёгкий компактный груз — базовый тариф.
2. Крупногабаритный лёгкий товар — проверьте, что считается объёмный вес.
3. Город без терминала — доставка с довозом до адреса и корректной надбавкой.
4. Недоступность API (отключите ключ) — служба должна скрыться, а не показать 0 ₽.

Ограничьте службу разумными рамками через ограничения доставки Битрикса: по весу, по сумме заказа и по группам местоположений, чтобы ПЭК не предлагался там, где выгоднее курьер или самовывоз.

Итог

Подключение ПЭК к магазину на 1С-Битрикс — это не установка модуля, а интеграционная задача: собственная служба доставки на API личного кабинета, аккуратный сбор габаритов из каталога, сопоставление городов с филиалами и защита от сбоев кэшем, таймаутами и фолбэком. Сделанная один раз правильно, она годами считает сборные грузы без ручного вмешательства.

Если нужен рабочий обработчик под вашу конфигурацию каталога и склада, мы в B2Bsite проектируем и внедряем такие интеграции доставки под ключ и берём их на сопровождение — с логированием, мониторингом и обновлением справочников филиалов.