Покупатель дошёл до оформления заказа, выбрал «доставка в пункт выдачи» — и застрял: пунктов не видно, стоимость не считается, а после оформления менеджер вручную вбивает данные в личный кабинет службы и перепечатывает трек в письмо. Каждый такой заказ отнимает время склада и множит ошибки. А ведь Boxberry умеет отдавать и карту пунктов, и расчёт, и трек-номера через API — нужно только правильно всё связать.
Это практический how-to по интеграции доставки Boxberry с магазином на 1С-Битрикс: разберём способы интеграции, расчёт тарифа, выбор ПВЗ на карте, создание отправлений, статусы и трек-номера, наложенный платёж и связку с 1С. Если не хотите собирать это самостоятельно, мы закрываем задачу услугой интеграции с DPD, Boxberry и Почтой России.
Коротко
- Три пути: модуль службы доставки, свой обработчик под API Boxberry или интеграция через RetailCRM.
- Точный расчёт стоимости начинается с заполненных весогабаритов товаров — без них тариф всегда мимо.
- Выбор ПВЗ выводят на карте, код пункта сохраняют в заказе и используют при создании отправления.
- Создание отправлений, этикетки и статусы автоматизируют через API и синхронизируют с обменом заказов в 1С.
Зачем интегрировать Boxberry
Boxberry — одна из популярных служб доставки с широкой сетью пунктов выдачи, и для многих магазинов это ключевой канал последней мили. Ручная работа с ней — расчёт «на глаз», занесение отправлений в личном кабинете, копирование трек-номеров — быстро превращается в узкое место, когда заказов становится много.
Полноценная интеграция снимает эту рутину: покупатель видит точную стоимость и выбирает удобный пункт прямо на сайте, склад формирует отправления и печатает этикетки в пару кликов, а клиент сам отслеживает посылку по треку. Это одновременно повышает конверсию оформления (прозрачная доставка не отпугивает) и разгружает операционную команду. Дальше — как это собрать.
Три способа интеграции
Прежде чем настраивать, выберите подход — от него зависят и сроки, и гибкость.
| Способ | Плюсы | Минусы / когда выбрать |
|---|---|---|
| Модуль из маркетплейса | Быстро подключить, готовое решение | Меньше гибкости; для типовых сценариев |
| Свой обработчик под API | Полный контроль над логикой и расчётом | Нужна разработка; для нестандартных требований |
| Через RetailCRM | Логистика в единой системе обработки заказов | Если заказами уже управляет CRM |
Модуль службы доставки — самый быстрый старт, но его гибкость ограничена. Собственный обработчик даёт полный контроль над расчётом и созданием отправлений — про риски и правила разработки расширений мы писали в статье про разработку модулей для маркетплейса Битрикс. Если же заказами и логистикой у вас управляет RetailCRM, логично вести доставку там — это закрывает услуга интеграции со службами доставки в RetailCRM.
Подготовка: весогабариты и данные
Самая недооценённая часть — подготовка данных. Boxberry считает стоимость по весу и габаритам, поэтому без порядка в характеристиках товаров любой расчёт будет врать.
- Вес каждого товара. Заполненное свойство веса — обязательное условие корректного тарифа.
- Габариты. Длина, ширина, высота для расчёта объёмного веса, который часто и определяет цену.
- Адрес отправления. Точка, откуда едет посылка, влияет на стоимость и сроки.
- Категория и ценность. Объявленная ценность и особенности товара для страхования и наложенного платежа.
Весогабариты обычно приходят на сайт вместе с данными о товаре из учётной системы. Если они не заполнены, расчёт идёт по значениям по умолчанию и расходится с фактом, а магазин либо теряет на доставке, либо отпугивает завышенной ценой. Поэтому наведение порядка в характеристиках — реальный первый шаг интеграции, а не формальность.
Шаг 1. Ключи API и настройка обработчика
Техническая часть начинается с доступа к API и заведения службы доставки в магазине.
- Получите ключ API. В личном кабинете Boxberry выпустите токен доступа к API — он понадобится для всех запросов.
- Храните ключ безопасно. Не в коде и не в открытом виде — в защищённых настройках; доступ к API логируйте.
- Заведите службу доставки. В модуле «Интернет-магазин» создайте службу Boxberry с нужными профилями (ПВЗ, курьер).
- Настройте профили доставки. Отдельные профили под доставку до пункта выдачи и курьером — с разной логикой расчёта.
- Проверьте соединение. Тестовым запросом убедитесь, что API отвечает и ключ рабочий.
Шаг 2. Расчёт стоимости доставки
Расчёт — это то, что покупатель видит в оформлении, и он должен быть точным и быстрым. Обработчик собирает параметры и запрашивает у API Boxberry стоимость.
- Собрать параметры. Вес и габариты корзины, точка отправления, выбранный ПВЗ или адрес назначения, ценность.
- Запросить тариф. Обработчик обращается к API расчёта и получает стоимость и срок.
- Учесть тип доставки. До пункта выдачи и курьером считаются по-разному — покажите оба варианта, если оба доступны.
- Кэшировать разумно. Одинаковые запросы кэшируют на короткое время, чтобы не дёргать API на каждый пересчёт корзины.
Отдельно продумайте поведение при недоступности API: если служба не ответила, покупатель не должен видеть ошибку без объяснения. Разумно показать резервный вариант или сообщение и не блокировать оформление. Сравнение Boxberry с другими службами по расчёту и сценариям мы разбирали в статье про доставку СДЭК и Boxberry.
Шаг 3. Выбор пункта выдачи на карте
Для доставки до ПВЗ ключевой элемент — удобный выбор пункта. Список пунктов Boxberry выводят на интерактивной карте прямо в оформлении.
- Получите список ПВЗ. Через API запросите пункты, отфильтрованные по городу покупателя, а не всю страну разом.
- Выведите на карте. Виджет или своя реализация с точками, адресами, режимом работы и условиями пункта.
- Сохраните код пункта. Выбранный ПВЗ сохраняется в заказе и используется при расчёте и создании отправления.
- Кэшируйте и обновляйте. Пункты открываются и закрываются, поэтому список кэшируют с обновлением, а не грузят каждый раз.
Производительность здесь важна: если карта грузит тысячи точек на каждом шаге, оформление тормозит и конверсия падает. Фильтрация по городу и кэширование списка — обязательные приёмы. Технические детали кэша и данных в Битрикс мы разбираем в статье про D7 ORM.
Шаг 4. Создание отправлений и этикеток
Здесь интеграция начинает экономить время склада. Вместо ручного занесения в личный кабинет отправление формируется по заказу через API.
- Формирование отправления. По данным заказа (адрес/ПВЗ, весогабариты, ценность, наложенный платёж) создаётся посылка в Boxberry.
- Получение трек-номера. API возвращает трек, который сохраняется в заказе.
- Печать этикетки. Этикетка формируется автоматически — без перепечатывания вручную.
- Привязка к статусу. Создание отправления обычно вешают на смену статуса заказа, например «передан в доставку».
Автоматизация создания отправлений — главный операционный выигрыш интеграции: поток заказов обрабатывается быстрее и без ошибок ручного ввода. Важно только надёжно обрабатывать сбои API, чтобы неудачное создание не терялось молча.
Шаг 5. Статусы и трек-номера
После отправки покупатель хочет знать, где посылка. Интеграция подтягивает статусы Boxberry и показывает их клиенту.
- Запрос статуса. По трек-номеру периодически запрашивается актуальный статус через API.
- Обновление агентом. Регулярный агент 1С-Битрикс опрашивает статусы активных отправлений и обновляет заказы.
- Сопоставление статусов. Статусы Boxberry сопоставляются с внутренними статусами заказа, чтобы клиент видел понятную картину.
- Показ покупателю. Трек со ссылкой на отслеживание и статус — в личном кабинете и письмах.
Регулярное обновление статусов заметно снижает нагрузку на поддержку: клиент сам видит движение посылки и реже пишет «когда приедет». Если Boxberry поддерживает уведомления через вебхуки, их использование надёжнее опроса — про безопасную работу с вебхуками мы писали в статье про REST, вебхуки и безопасность.
Наложенный платёж и ценность
Отдельного внимания требует денежная часть — наложенный платёж и объявленная ценность. Ошибки здесь бьют по деньгам напрямую.
- Объявленная ценность. Передаётся при создании отправления, влияет на страхование; вычисляется из суммы заказа.
- Наложенный платёж. Если покупатель платит при получении, сумма НП должна точно совпадать с суммой к оплате.
- Способ оплаты. Логика НП зависит от выбранного способа оплаты — предоплата исключает наложенный платёж.
- Сверка сумм. Расхождения между заказом и НП недопустимы — иначе претензии и разбирательства.
Логику наложенного платежа тестируют особенно тщательно на реальных сценариях: предоплата, оплата при получении, частичная оплата. Деньги не прощают приблизительности.
Связка с 1С и обменом заказов
В большинстве магазинов заказы уходят в 1С обменом, и там ведётся отгрузка. Данные Boxberry не должны теряться на этом стыке.
- Сохранение данных в заказе. Выбранный ПВЗ, трек-номер, стоимость доставки хранятся в свойствах заказа и передаются в 1С.
- Полная картина у менеджера. В 1С видно, куда и как едет заказ, без похода в личный кабинет службы.
- Кто создаёт отправление. Если посылки формируются и из 1С, и с сайта, договоритесь, какая система главная, чтобы не задвоить.
- Согласованность статусов. Статус доставки синхронизируется, чтобы сайт и 1С не противоречили друг другу.
Задвоение создания отправлений между сайтом и 1С — типичная и болезненная ошибка: один заказ уезжает дважды. Чёткое разграничение ответственности систем снимает эту проблему. Как связать сайт и учётную систему без потери данных, помогает аудит и оптимизация обмена с 1С, а надёжность выкладок изменений — процесс из статьи про CI/CD и деплой.
Частые ошибки
- Пустые весогабариты. Расчёт по умолчанию расходится с фактом — теряете деньги или отпугиваете ценой.
- Список ПВЗ без кэша. Тысячи точек грузятся на каждом шаге, оформление тормозит.
- Неверное сопоставление статусов. Клиент видит непонятные или неправильные состояния посылки.
- Расхождение наложенного платежа. Сумма НП не совпадает с заказом — деньги и претензии.
- Задвоение отправлений. Сайт и 1С оба создают посылку — заказ уезжает дважды.
- Нет обработки сбоев API. Служба недоступна, а покупатель видит голую ошибку или не может оформить.
- Ключ API в открытом виде. Токен в коде или без защиты — риск компрометации.
Чек-лист внедрения
- Данные готовы. Вес и габариты товаров заполнены, адрес отправления и ценность настроены.
- Ключ API защищён. Токен в безопасном хранилище, доступ логируется.
- Служба заведена. Профили доставки до ПВЗ и курьером настроены, соединение проверено.
- Расчёт точный. Стоимость считается по весогабаритам, есть обработка недоступности API.
- Карта ПВЗ работает. Пункты фильтруются по городу, кэшируются, код сохраняется в заказе.
- Отправления автоматизированы. Посылки и этикетки формируются по API, трек сохраняется.
- Статусы обновляются. Агент опрашивает статусы, клиент видит трек и состояние.
- Деньги сходятся. Наложенный платёж и ценность сверены с заказом.
- 1С синхронизирована. Данные доставки в заказе, отправления не задваиваются.
Вывод
Интеграция Boxberry с 1С-Битрикс — это не про «поставить модуль», а про сквозной процесс: от точного расчёта в корзине и выбора пункта на карте до автосоздания отправлений, трек-номеров и синхронизации с 1С. Каждый из этих кусков экономит либо конверсию, либо время склада, а вместе они убирают ручную рутину, которая душит рост при увеличении заказов.
Начинайте с фундамента — весогабаритов и данных, без них расчёт всегда мимо. Выберите подход под свои объёмы, аккуратно закройте безопасность ключей, продумайте сбои API и разграничьте с 1С, кто создаёт отправления. Тогда доставка Boxberry из источника ошибок и ручной работы превратится в прозрачный сервис, который нравится и покупателю, и вашей команде.
