Boxberry — сеть пунктов выдачи для интернет-магазинов с удобным API, и её интеграция с RetailCRM переносит расчёт тарифов, выбор ПВЗ и создание посылок прямо в карточку заказа. Разберём, где взять токен, как настроить модуль и что учесть при выборе пунктов выдачи и наложенном платеже.
Что умеет модуль
Интеграция с Boxberry работает через официальный API службы по токену доступа. Модуль встраивает в заказ блок доставки и убирает необходимость заходить в личный кабинет Boxberry для оформления посылок.
- расчёт стоимости и срока доставки до пункта выдачи или курьером;
- выбор ПВЗ из актуального списка пунктов с адресами и режимом работы;
- создание посылки (отправления) и получение трек-номера;
- поддержка наложенного платежа и объявленной ценности;
- синхронизация статусов и печать этикеток.
Администрирование → Интеграция → Модули → Boxberry. Для работы достаточно одного токена API — отдельные логин и пароль от кабинета в CRM не передаются.Где взять токен API
Boxberry авторизует запросы по одному ключу — токену интеграции. Он выдаётся в личном кабинете после заключения договора.
- Заключите договор с Boxberry и получите доступ в личный кабинет.
- В разделе настроек / интеграций найдите токен API (ключ доступа).
- Уточните согласованные тарифы и подключённые услуги (наложенный платёж, страхование).
Настройка модуля
После активации модуля и ввода токена задаются параметры отправителя и правила расчёта. Основные поля:
| Параметр | Назначение |
|---|---|
| Токен API | авторизация запросов к Boxberry |
| Город и пункт отгрузки | откуда посылки уходят в сеть Boxberry |
| Вес и габариты по умолчанию | значения для расчёта, если не заданы в товаре |
| Услуги | наложенный платёж, страхование, примерка |
Модуль создаёт тип доставки «Boxberry» в Справочники → Типы доставки. Свяжите его со способами доставки магазина и, при необходимости, разделите доставку до ПВЗ и курьерскую как отдельные тарифы.
Расчёт тарифа и выбор ПВЗ
При выборе Boxberry в заказе RetailCRM запрашивает у API стоимость и срок по адресу получателя, весу и габаритам. Для доставки до пункта выдачи оператор выбирает конкретный ПВЗ.
- список пунктов показывает адрес, режим работы и признак приёма наложенного платежа;
- не каждый ПВЗ принимает наложенный платёж или крупногабарит — это видно в карточке пункта;
- выбранный пункт сохраняется в заказе и передаётся в посылку.
Создание посылок и трек-номера
Отправление создаётся из блока доставки заказа. RetailCRM передаёт в Boxberry состав, габариты, ПВЗ назначения и сумму наложенного платежа, а в ответ получает трек-номер и данные для печати этикетки.
Статусы посылки («Принято», «В пути», «Поступило в пункт выдачи», «Выдано») подтягиваются автоматически. На них навешивают триггеры: при поступлении в ПВЗ — уведомлять клиента, при выдаче — закрывать заказ, при возврате — ставить задачу оператору.
Автоматизация отгрузки
Как и с другими службами, ручное создание посылок оправдано на старте, а при потоке заказов включают автоматику RetailCRM:
- триггер создаёт посылку Boxberry при переходе заказа в статус «Готов к отгрузке»;
- после получения трека клиенту уходит уведомление со ссылкой на отслеживание;
- этикетки печатаются пакетно для всех отправлений дня.
Такой конвейер снимает с менеджера рутину и исключает расхождения между тем, что собрано на складе, и тем, что заведено в Boxberry.
Итог
Подключение Boxberry к RetailCRM — это один токен API, настроенный тип доставки, корректные габариты и правильные коды ПВЗ. После настройки расчёт, выбор пункта выдачи, создание посылок и трекинг выполняются из заказа, а печать этикеток идёт пакетно.
Мы настроим модуль Boxberry под ваш договор и товарную линейку, проверим сопоставление пунктов выдачи и выстроим автоматическое создание посылок, чтобы отгрузка не отнимала время операторов.
Частые вопросы
Что нужно для подключения Boxberry?
Договор с Boxberry, доступ в личный кабинет и токен API. Логин и пароль от кабинета в CRM вводить не нужно — авторизация идёт по токену.
Где найти токен API Boxberry?
В личном кабинете Boxberry, в разделе настроек или интеграций. При компрометации ключ можно перевыпустить там же.
Можно ли выбрать пункт выдачи в заказе?
Да, оператор выбирает ПВЗ из актуального списка с адресами и режимом работы. Пункт передаётся в создаваемую посылку.
Все ли ПВЗ принимают наложенный платёж?
Нет, приём наложенного платежа и крупногабарита зависит от конкретного пункта. Это видно в карточке ПВЗ при выборе.
Почему возникает ошибка «пункт не найден»?
Обычно код выбранного клиентом пункта не совпадает с кодом в справочнике Boxberry. Нужно проверить сопоставление кодов ПВЗ.
Обновляются ли статусы автоматически?
Да, статусы посылки подтягиваются из Boxberry. На них можно вешать триггеры для уведомлений и смены статуса заказа.
Что делать при превышении габаритов?
Boxberry ограничивает вес и сумму измерений для доставки до ПВЗ. При превышении посылка уходит в курьерский тариф или отклоняется.
Поможем с настройкой и поддержкой RetailCRM
Поможем с настройкой, доработкой и поддержкой RetailCRM.