Модуль «Возвратная накладная СДЭК» для RetailCRM
Описание модуля «Возвратная накладная СДЭК» для RetailCRM
«Возвратная накладная СДЭК» — модуль для RetailCRM, который автоматизирует оформление возвратов через СДЭК. Когда покупатель хочет вернуть товар, модуль по сигналу из CRM сам создаёт возвратную накладную СДЭК — отправителем становится покупатель, получателем — ваш склад приёма возвратов — и записывает трек-номер прямо в карточку заказа. Дальше модуль сам следит за посылкой и обновляет статус возврата в заказе, пока склад её не примет. Менеджеру не нужно ни вручную заводить заявку в личном кабинете СДЭК, ни ходить туда за статусом.
Как это работает
- Сигнал из CRM: в RetailCRM срабатывает триггер (например, при переводе заказа в статус «Возврат») и отправляет модулю номер заказа.
- Сбор данных: модуль получает заказ из RetailCRM — данные покупателя, город, состав.
- Создание накладной СДЭК: формируется возвратный заказ в СДЭК по вашему тарифу и габаритам; отправитель — покупатель и его город, получатель — склад из настроек.
- Трек-номер в заказе: присвоенный номер накладной СДЭК автоматически записывается в пользовательское поле заказа RetailCRM.
- Отслеживание статуса: каждые 6 часов модуль спрашивает СДЭК, где посылка, и обновляет статус возврата в карточке заказа — пока склад её не примет.
Основные возможности модуля
1. Автоматическое создание возвратной накладной СДЭК
- Без ручной работы: заявка на возврат в СДЭК создаётся по API автоматически, без входа в личный кабинет курьерской службы.
- Реальный номер накладной: модуль дожидается присвоения трек-номера СДЭК и возвращает его в CRM.
2. Правильное направление возврата
- Отправитель — покупатель: имя, телефон и город берутся из заказа RetailCRM.
- Получатель — ваш склад: компания, контактное лицо, телефон, город и адрес приёма возвратов задаются в настройках.
3. Трек-номер возврата в карточке заказа
- Всё в одном месте: номер накладной пишется в указанное вами пользовательское поле заказа — менеджер видит его прямо в RetailCRM.
- Ничего не теряется: отслеживание возврата не требует переключения между системами.
4. Автоматическое отслеживание статуса возврата
- Обновление каждые 6 часов: модуль сам опрашивает СДЭК по всем незавершённым возвратам и пишет текущий статус в справочное поле заказа. Менеджеру не нужно заходить в личный кабинет СДЭК и пробивать трек-номера руками.
- Понятные статусы вместо кодов перевозчика: у СДЭК около полутора сотен служебных состояний. Модуль сворачивает их в шесть понятных: «Создан, ожидает сдачи», «Сдан покупателем», «В пути», «Прибыл в город склада», «Вручен складу», «Проблема / не доставлен».
- Отслеживание останавливается само: как только склад принял посылку («Вручен складу») или СДЭК отклонил заказ, возврат снимается с наблюдения и больше не опрашивается.
- Настройка в один клик: справочник статусов и поле заказа создаются кнопкой прямо из настроек модуля — вручную заводить их не нужно.
5. Отдельные настройки и доступы СДЭК для каждого магазина
- Мультимагазинность: если в аккаунте RetailCRM несколько магазинов (сайтов), для каждого задаются свои параметры возврата и свой договор СДЭК (client_id / client_secret).
- Изоляция: возвраты каждого магазина уезжают на свой склад по своему тарифу.
6. Копирование настроек между магазинами
- Быстрый старт: настроив один магазин, скопируйте конфигурацию в остальные одной кнопкой — с доступами СДЭК или без них.
7. Гибкие параметры СДЭК
- Тариф и тип заказа: задаются под ваш процесс возвратов.
- Габариты и вес по умолчанию, интервалы забора: подставляются в накладную автоматически.
- Продавец, валюты, коэффициент страховки: настраиваются в один экран.
8. Журнал операций
- Полная история: каждая попытка создания возврата фиксируется — успех с номером накладной или ошибка с понятным описанием.
- Текущий статус в журнале: рядом с накладной видно, где сейчас посылка и когда модуль последний раз проверял её в СДЭК.
- Прозрачная диагностика: видно, по какому заказу и магазину прошла операция.
Какую пользу приносит модуль
- Экономит время менеджеров: возврат оформляется автоматически, без ручного заведения заявок в СДЭК и без ручной проверки трек-номеров.
- Убирает ошибки: адрес склада, тариф и габариты берутся из настроек, а не вводятся руками каждый раз.
- Видно этап каждого возврата: прямо в списке заказов можно отфильтровать те, что покупатель ещё не сдал, и те, что уже приехали на склад.
- Единый процесс: все возвраты идут по одному сценарию для всех магазинов.
- Прозрачность: трек-номер и статус в заказе плюс журнал операций дают полный контроль.
Что нужно для работы
- Аккаунт RetailCRM и API-ключ с правами на заказы, справочники, пользовательские поля и интеграцию.
- Договор со СДЭК и доступы к API СДЭК (client_id и client_secret).
- Пользовательские поля заказа: для записи трек-номера возврата и для кода города СДЭК покупателя.
- Справочное поле заказа для статуса возврата — создаётся кнопкой из настроек модуля.
Установка и подключение «Возвратная накладная СДЭК» для RetailCRM
Настройка модуля занимает несколько шагов: подключить аккаунт, задать параметры возврата для каждого магазина, создать пользовательские поля заказа и настроить триггер в RetailCRM. Ниже — порядок действий.
Шаг 1. Подключение модуля
Подключение выполняется вручную — по адресу CRM и API-ключу (быстрое подключение не используется).
- Создайте в RetailCRM API-ключ: Администрирование → Интеграция → Ключи доступа к API.
- Включите права: Заказы (
order_read,order_write), Справочники (reference_read), Пользовательские поля (custom_fields_read), Интеграция (integration_write). - Откройте страницу модуля, введите адрес вашей RetailCRM и созданный ключ, нажмите «Подключить модуль». Модуль зарегистрируется в вашей CRM.
Шаг 2. Пользовательские поля заказа
Создайте в RetailCRM два пользовательских поля заказа (Администрирование → Пользовательские поля → Заказы):
- Поле для трек-номера возврата — сюда модуль записывает номер накладной СДЭК (по умолчанию символьный код
return_tracking). - Поле кода города СДЭК покупателя — отсюда модуль берёт код города отправителя-покупателя (по умолчанию
cdek_city_code).
Третье поле — статус возврата — создавать руками не нужно: его вместе со справочником заводит кнопка в настройках модуля (см. Шаг 4).
Шаг 3. Настройка магазина
В разделе «Настройки возврата» выберите магазин (сайт RetailCRM) и заполните параметры. Настройки задаются отдельно для каждого магазина.
Возврат включён для магазина. Переключатель вверху страницы определяет, участвует ли выбранный магазин в автоматическом создании возвратов. Если он включён — по этому магазину накладные СДЭК создаются; если выключен — запросы на возврат по нему не обрабатываются, а его настройки при этом сохраняются. Так можно временно приостановить возвраты по конкретному магазину или, когда магазинов несколько, включить оформление возвратов только для нужных.
- Параметры возвратного заказа СДЭК: тип заказа, код тарифа, коэффициент страховки, продавец, валюты.
- Доступы СДЭК: client_id и client_secret вашего договора СДЭК. Флажок «Тестовый контур» — только для отладочных доступов
api.edu.cdek.ru; для боевых доступов он должен быть выключен. - Склад получателя (куда едет возврат): компания, контактное лицо, телефон, код города СДЭК, город и полный адрес приёма возвратов.
- Габариты по умолчанию и забор: вес, длина, ширина, высота, интервал забора.
- Коды полей и статус позиций: символьные коды полей из Шага 2 и, при необходимости, статус позиций, попадающих в возврат.
Копирование настроек. Настроив один магазин, нажмите «Скопировать настройки», чтобы перенести конфигурацию в другие магазины — с доступами СДЭК или без них.
Шаг 4. Отслеживание статуса возврата
Модуль умеет не только создавать накладную, но и следить за посылкой: каждые 6 часов он опрашивает СДЭК по всем незавершённым возвратам и обновляет статус в карточке заказа.
Включение. В блоке «RetailCRM: коды полей» задайте символьный код поля статуса (по умолчанию return_status) и нажмите «Создать справочник и поле в CRM». Модуль сам заведёт в вашей CRM справочник статусов и привязанное к нему поле заказа, а затем пропишет его код во все настроенные магазины. Повторное нажатие безопасно — существующие элементы справочника и уже созданное поле не изменяются.
created, handed_over и т. д.), иначе статус не запишется.Какие бывают статусы. У СДЭК около полутора сотен служебных состояний. Модуль сворачивает их в шесть понятных:
| Статус в заказе | Что это значит |
|---|---|
|
Создан, ожидает сдачи |
Накладная оформлена, но покупатель ещё не сдал посылку в ПВЗ. |
|
Сдан покупателем |
Посылка принята на складе СДЭК — возврат поехал. |
|
В пути |
Посылка едет между городами и складами перевозчика. |
|
Прибыл в город склада |
Посылка в городе вашего склада возвратов, осталась выдача. |
|
Вручен складу |
Склад принял возврат. Финальный статус — отслеживание прекращается. |
|
Проблема / не доставлен |
СДЭК отклонил заказ или посылка не была доставлена. Тоже финал. |
Когда отслеживание прекращается. Как только склад принял возврат («Вручен складу») или СДЭК отклонил заказ, статус становится финальным и модуль больше не опрашивает эту накладную.
Шаг 5. Триггер в RetailCRM
На странице «Подключение» модуль показывает персональный webhook-URL. Создайте в RetailCRM триггер, который вызывает этот URL.
- Событие: например, перевод заказа в статус «Возврат».
- Действие: HTTP-запрос (метод POST) на webhook-URL модуля.
- Тело запроса: номер заказа и код сайта (магазина). Код сайта можно не передавать — тогда магазин определится из самого заказа.
Шаг 6. Проверка
- Переведите тестовый заказ в статус возврата — модуль создаст накладную СДЭК и запишет трек-номер в поле заказа.
- Результат каждой операции виден в разделе «Логи и история»: успех с номером накладной или ошибка с описанием.
- Там же, в колонке «Статус возврата», видно текущее состояние посылки и время последней проверки в СДЭК. Значок обновления рядом со статусом означает, что возврат ещё отслеживается.
- Первый статус появится в течение шести часов после создания накладной — по расписанию опроса.
Частые вопросы о «Возвратная накладная СДЭК» для RetailCRM
Нужен ли отдельный договор со СДЭК?
Да. Модуль работает через API СДЭК, поэтому нужен действующий договор со СДЭК и доступы к API (client_id и client_secret). Их вы указываете в настройках магазина.
Можно ли подключить несколько магазинов с разными договорами СДЭК?
Да. Для каждого магазина (сайта RetailCRM) задаются свои параметры возврата и свои доступы СДЭК. Настройки одного магазина можно скопировать в другие одной кнопкой.
Куда попадает трек-номер возврата?
Номер накладной СДЭК автоматически записывается в указанное вами пользовательское поле заказа RetailCRM — менеджер видит его прямо в карточке заказа.
Как запускается создание возврата?
Создание накладной инициирует триггер в RetailCRM: при нужном событии (например, статус «Возврат») он отправляет модулю номер заказа, а модуль создаёт возвратную накладную в СДЭК.
Как модуль отслеживает статус возврата?
После создания накладной модуль каждые 6 часов сам опрашивает СДЭК и записывает текущее состояние посылки в справочное поле заказа: «Создан, ожидает сдачи», «Сдан покупателем», «В пути», «Прибыл в город склада», «Вручен складу» или «Проблема / не доставлен». Заходить в личный кабинет СДЭК и пробивать трек-номера вручную не нужно. Как только склад принял возврат, отслеживание прекращается автоматически.
Поддержка модуля «Возвратная накладная СДЭК» для RetailCRM
Проконсультируем, поможем настроить модуль и решить вопросы по работе. При необходимости — делаем видеосозвоны.
Telegram
mail@studia-crm.ru 
Max