Boxberry — сеть пунктов выдачи и постаматов, популярная у интернет-магазинов за счёт удобной приёмки и наложенного платежа. Разберём, как подключить Boxberry к RetailCRM, настроить выбор ПВЗ в заказе, создавать посылки с трек-номерами и корректно отражать статусы доставки внутри CRM.
Подключение модуля Boxberry
Boxberry ставится как модуль доставки из Администрирование → Интеграция → Модули. Для авторизации нужен токен API — его выдают в личном кабинете Boxberry по действующему договору. Токен вносится в настройки модуля вместе с параметрами отправителя.
Что задаётся при подключении:
- Токен API — ключ доступа к методам Boxberry;
- Пункт приёма (ИНН/город отправителя) — откуда уходят посылки;
- Способ передачи — самопривоз в ПВЗ Boxberry или забор курьером;
- Тип оплаты доставки — за счёт магазина или получателя.
После сохранения в справочнике Настройки → Справочники → Типы доставки появляется тип «Boxberry», а в карточке заказа — блок с выбором способа выдачи и стоимости.
Выбор ПВЗ и постаматов в заказе
Список пунктов выдачи и постаматов подтягивается из API Boxberry по городу получателя. В карточке заказа оператор выбирает конкретную точку, а её код записывается в данные доставки и уходит в посылку при регистрации.
- В заказе указывается город доставки — RetailCRM запрашивает доступные ПВЗ.
- Оператор выбирает пункт из списка (адрес, режим работы, приём наложенного платежа, приём карт).
- Код ПВЗ сохраняется в поле доставки и используется при создании посылки.
Важно учитывать ограничения точки: не каждый ПВЗ принимает наложенный платёж или габаритные посылки. Эти признаки приходят вместе со списком пунктов, поэтому стоит фильтровать выдачу под условия конкретного заказа.
Создание посылки и трек-номер
Посылка создаётся из карточки заказа кнопкой «Создать отправление» или триггером при переходе в нужный статус. RetailCRM передаёт в Boxberry состав заказа, весогабариты, код ПВЗ и данные получателя, а в ответ получает трек-номер и ссылку на этикетку.
Минимальный набор данных для регистрации:
| Поле | Назначение |
|---|---|
| Код ПВЗ / адрес | Точка выдачи или адрес курьерской доставки |
| Вес и габариты | Расчёт тарифа и допустимость по точке |
| Сумма НП | Наложенный платёж при оплате получателем |
| Объявленная ценность | Страховая стоимость вложения |
Условно тело запроса к интеграции выглядит так:
{ "delivery": { "code": "boxberry", "data": { "pvzCode": "010", "weight": 900, "payment": 2490 } } }
Полученный трек-номер записывается в поле Трек-номер и подставляется в уведомление клиенту.
Статусы Boxberry в карточке заказа
RetailCRM опрашивает Boxberry по трек-номерам и нормализует статусы перевозчика во внутренние статусы доставки. Это позволяет строить триггеры и видеть реальную картину по всем посылкам в списке заказов.
- Посылка принята / загружена → «Отправлено»;
- В пути / на сортировке → «В пути»;
- Поступила в пункт выдачи → «Готово к выдаче»;
- Выдана получателю → «Доставлено»;
- Истёк срок хранения / отказ → «Возврат».
На статус «Готово к выдаче» удобно повесить триггер с уведомлением клиента и напоминанием о сроке хранения. На «Возврат» — задачу менеджеру, чтобы вовремя обработать несостоявшуюся выдачу и не потерять товар на складе Boxberry.
Наложенный платёж и сверка
Наложенный платёж — одна из причин выбора Boxberry. Сумма НП берётся из заказа и передаётся в посылку. После выдачи Boxberry перечисляет деньги на счёт магазина по реестру, а в RetailCRM этот факт удобно фиксировать через статус оплаты.
- В заказе выставлена оплата «При получении» — сумма НП попадает в отправление.
- Клиент оплачивает при выдаче в ПВЗ или курьеру.
- Boxberry формирует реестр перечислений — по нему сверяется поступление на счёт.
- В CRM заказ переводится в статус «Оплачен» вручную или интеграцией эквайринга/реестра.
Регулярная сверка реестра с заказами в RetailCRM помогает не терять недоплаты и вовремя видеть «зависшие» отправления с истекающим сроком хранения.
Типичные ошибки интеграции
Большинство отказов Boxberry связано с данными заказа. Ответ API виден в логе модуля.
| Симптом | Причина | Решение |
|---|---|---|
| Не создаётся посылка | Неверный или недоступный код ПВЗ | Обновить список ПВЗ по городу и перевыбрать точку |
| Ошибка авторизации | Просрочен/неверный токен | Обновить токен из кабинета Boxberry |
| Отклонён наложенный платёж | ПВЗ не принимает НП | Выбрать точку с поддержкой НП или курьера |
| Расхождение тарифа | Фактический вес больше заявленного | Нормализовать весогабариты при комплектации |
Отдельно стоит следить за актуальностью справочника ПВЗ: Boxberry периодически закрывает или переносит точки, поэтому список пунктов лучше не кэшировать надолго.
Итог
Интеграция Boxberry с RetailCRM даёт полный цикл прямо из карточки заказа: выбор ПВЗ или постамата, создание посылки с трек-номером, наложенный платёж и автоматические статусы доставки. Ключ к стабильности — актуальный токен, свежий справочник пунктов и корректные весогабариты.
Мы подключаем Boxberry, настраиваем маппинг статусов и триггеры уведомлений, а также выстраиваем сверку наложенных платежей с реестром. Если у вас несколько служб доставки, поможем сделать так, чтобы Boxberry предлагался клиенту там, где это выгоднее и удобнее, а операторы работали в одном окне CRM.
Частые вопросы
Что нужно для подключения Boxberry к RetailCRM?
Действующий договор с Boxberry и токен API из личного кабинета. Токен и параметры отправителя вносятся в настройки модуля доставки в RetailCRM.
Откуда берётся список ПВЗ в заказе?
RetailCRM запрашивает пункты выдачи и постаматы через API Boxberry по городу получателя. Оператор выбирает точку, и её код сохраняется в данных доставки заказа.
Почему посылка с наложенным платежом не создаётся?
Вероятно, выбранный ПВЗ не принимает наложенный платёж. Нужно выбрать точку с поддержкой НП или переключиться на курьерскую доставку до двери.
Как быстро обновляются статусы Boxberry в CRM?
Статусы приходят при плановом опросе трекинга, поэтому возможна задержка в несколько часов относительно системы Boxberry. Завершённые посылки из опроса исключаются.
Где взять трек-номер посылки?
Он приходит от Boxberry в момент создания отправления и записывается в поле «Трек-номер» заказа. Оттуда его можно подставить в уведомление клиенту.
Как сверять наложенные платежи?
Boxberry формирует реестр перечислений после выдачи посылок. Его сверяют с заказами в RetailCRM и переводят оплаченные заказы в статус «Оплачен».
Что делать с истёкшим сроком хранения?
Статус «Истёк срок хранения» нормализуется в «Возврат». На него удобно повесить триггер с задачей менеджеру, чтобы обработать возврат и вернуть товар на склад.
Нужно ли обновлять справочник ПВЗ вручную?
Список пунктов подтягивается из API динамически. Кэшировать его надолго не стоит, так как Boxberry периодически закрывает и переносит точки выдачи.
Поможем с настройкой и поддержкой RetailCRM
Поможем с настройкой, доработкой и поддержкой RetailCRM.