Boxberry — сеть пунктов выдачи, которую покупатели выбирают за удобные ПВЗ и примерку. Интеграция с 1С-Битрикс тут проще, чем у Почты: всё крутится вокруг одного API-эндпоинта и токена. Разбираем, как встроить виджет пунктов, расчёт и автоматическое создание посылок.
Устройство API Boxberry
У Boxberry лаконичный API: один эндпоинт и параметр method, который выбирает операцию. Авторизация — по токену из личного кабинета, он передаётся в каждом запросе.
https://api.boxberry.ru/json.php?token=ВАШ_ТОКЕН&method=ListPoints
- ListCities / ListPoints — города и пункты выдачи с координатами и параметрами.
- DeliveryCalculation — расчёт стоимости и срока доставки.
- ParselCreate — создание посылки и получение трек-номера.
- ParselSend — формирование акта приёма-передачи по отправленным посылкам.
- ListStatuses — история статусов по трек-номеру.
Модуль или прямая интеграция
В Битриксе есть два пути. Первый — официальный модуль Boxberry из Маркетплейса: он регистрирует службу доставки, добавляет виджет ПВЗ и создаёт посылки из административной части. Второй — прямая интеграция по API, когда мы пишем свой обработчик доставки на базе модуля sale.
| Критерий | Модуль из Маркетплейса | Прямая интеграция |
|---|---|---|
| Скорость запуска | Высокая | Средняя |
| Гибкость логики | Ограниченная | Полная |
| Кастомный чекаут | Сложно | Штатно |
| Связка с 1С и CRM | Через доработки | Из коробки проекта |
Для типового магазина берём модуль, для нестандартного оформления и высоких оборотов — прямую интеграцию.
Виджет ПВЗ на карте
Boxberry предоставляет готовый JS-виджет выбора пункта на карте. Он встраивается в шаг доставки и по клику возвращает код ПВЗ, адрес, режим работы и признаки — приём наличных, оплата картой, наличие примерки.
- Подключаем скрипт виджета на страницу оформления.
- Инициализируем его для города получателя.
- По выбору пункта записываем код в скрытое поле и в свойство заказа
BOXBERRY_POINT. - Пересчитываем стоимость доставки под выбранный пункт.
Расчёт стоимости
Метод DeliveryCalculation принимает код целевого ПВЗ (или город для курьерской доставки), вес, объявленную стоимость и признак наложенного платежа. Возвращает стоимость доставки, срок и, при необходимости, разбивку по услугам.
- Передавайте реальный вес из каталога — пустые значения ломают расчёт.
- Учитывайте платную и бесплатную доставку от суммы заказа: порог задаётся в правилах.
- Кэшируйте результаты по ключу «пункт + вес», чтобы не дёргать API на каждый пересчёт корзины.
Для курьерской доставки Boxberry расчёт идёт по коду города и почтовому индексу — тогда виджет ПВЗ не нужен, а адрес собирается из полей заказа.
Создание посылок и трек-номера
После оплаты заказ превращается в посылку методом ParselCreate. В запросе уходят состав заказа, габариты, код целевого ПВЗ и данные получателя, а в ответе приходит трек-номер и ссылка на этикетку. Трек сохраняется в свойство заказа.
В конце дня отправленные посылки объединяются методом ParselSend — формируется акт приёма-передачи для курьера Boxberry. Это заменяет ручное оформление и снижает риск ошибок в адресах.
| Операция | Метод | Результат |
|---|---|---|
| Создать посылку | ParselCreate | Трек-номер, этикетка |
| Сдать посылки | ParselSend | Акт приёма-передачи |
| Проверить статус | ListStatuses | История операций |
Статусы и синхронизация
Boxberry отдаёт историю статусов по трек-номеру методом ListStatuses. Отдельного вебхука на смену статуса нет, поэтому в Битриксе заводится агент, который периодически опрашивает активные трек-номера и обновляет статусы заказов.
- Сопоставьте статусы Boxberry со статусами заказа в вашей воронке.
- Уведомляйте клиента, когда посылка прибыла в пункт выдачи.
- Прекращайте опрос после вручения или возврата, чтобы не тратить лимиты.
Итог
Интеграция Boxberry с 1С-Битрикс строится вокруг единого API по токену: виджет ПВЗ на карте, расчёт методом DeliveryCalculation, создание посылок через ParselCreate и обновление статусов агентом. Для типового магазина хватает официального модуля, для кастомного чекаута и высоких оборотов надёжнее прямая интеграция.
Мы в B2Bsite подключаем Boxberry с фильтрацией пунктов по габаритам, корректным расчётом по реальному весу, автоматическим созданием посылок и печатью этикеток. При необходимости объединяем Boxberry с другими службами в едином окне доставки и связываем с 1С и CRM.
Частые вопросы
Что нужно для подключения Boxberry к Битриксу?
Токен доступа из личного кабинета Boxberry и настроенная служба доставки в модуле sale. Расчёт и виджет ПВЗ можно поднять сразу, а для создания посылок нужен боевой токен с соответствующими правами и договор.
Как работает выбор пункта выдачи?
Boxberry предоставляет JS-виджет карты ПВЗ. Он встраивается в шаг доставки, по клику возвращает код пункта, который сохраняется в свойство заказа и используется при создании посылки.
Можно ли обойтись без модуля из Маркетплейса?
Да. У Boxberry простой API с единым эндпоинтом, поэтому прямая интеграция через собственный обработчик доставки — рабочий вариант для кастомного чекаута и высоких оборотов.
Как автоматически создавать посылки?
Обработчик отправляет заказ методом ParselCreate, получает трек-номер и ссылку на этикетку, а в конце дня формирует акт приёма-передачи методом ParselSend. Ручной ввод в личном кабинете не требуется.
Есть ли у Boxberry вебхуки статусов?
Отдельного вебхука на смену статуса нет. Статусы получают методом ListStatuses, а в Битриксе заводят агент, который периодически опрашивает активные трек-номера и обновляет заказы.
Поддерживается ли крупногабаритная доставка?
Да, но не все пункты выдачи принимают крупногабарит. При выборе ПВЗ нужно фильтровать пункты по параметрам посылки, чтобы клиент не выбрал пункт, который не примет его заказ.
Работает ли наложенный платёж?
Да. Признак наложенного платежа передаётся при расчёте и создании посылки. Комиссию за приём и перевод средств стоит учитывать при формировании итоговой стоимости доставки.
Поможем с настройкой и поддержкой Интеграции и связки систем
Поможем с настройкой, доработкой и поддержкой Интеграции и связки систем.