Лайфхак: подключаем свою службу доставки

Опубликовано 21.01.2025 16:30 в разделе Кейсы

Вашей службы доставки нет в списке AlterCPA Moe? Подключите её сами: встроенная служба умеет отправлять заказы, отслеживать посылки и печатать документы через три ссылки на ваш собственный обработчик. Код самой CRM для этого трогать не нужно.

В чём суть?

Служба доставки типа «Встроенная» задумывалась как заглушка для курьеров, которых вы обслуживаете вручную. Но в её настройках есть три поля для ссылок. Если за этими ссылками живёт ваш обработчик, заглушка работает как настоящая интеграция: заказы уходят в службу, статусы возвращаются, документы печатаются. Хаков доставки в бесплатной AlterCPA Moe нет, зато трёх ссылок вполне достаточно.

Обработчики можно написать на любом языке и разместить на своём хостинге. Правда, поднять их придётся самим: нужен тот, кто умеет принять запрос и ответить в формате JSON.

Три ссылки

Откройте в управлении компанией настройки доставки и добавьте службу с типом «Встроенная». В ней три поля:

• URL трекинга — получает трек-код посылки и отдаёт историю её статусов;
• URL отправки — получает данные заказа, создаёт посылку и отвечает трек-кодом;
• URL документов — отдаёт ссылку на готовый файл с этикетками и документами.

В ссылках работают макросы: {track} или {code} подставляет трек-код, {order} — идентификатор заказа в CRM, {track:xxx} — параметр трекинга xxx, полученный при отправке. Например, ссылка трекинга может выглядеть так: https://your-logistics.example/track?code={track}.

Что включить

• «Служба доставки активна» — без этой галочки служба недоступна при работе с заказами;
• «Использовать службу доставки по умолчанию для поступающих лидов» — служба будет назначаться всем новым лидам;
• «Автоматически менять статус заказа при отслеживании доставки» — статусы transfer, delivered, paid и return из ответа вашего обработчика сами переведут заказ в «В пути», «Доставлен», «Оплачен» и «Возврат»;
• «Включить автоматическую отправку заказов в службу доставки» — укажите статусы «На отправку», «Успех» и «Ошибка».

Статусы посылок CRM опрашивает сама, дважды в день, а оператор может обновить историю вручную со страницы заказа; оттуда же заказ уходит в службу по кнопке. Документы печатаются по одному заказу или массово. Зависшие в одном статусе посылки можно отдавать на обзвон блоком «Автоматическое планирование звонков», время в нём задаётся в часах.

Важно!

• Автоматику отправки можно настроить только после того, как указана ссылка отправки. Пока служба не активна, туда можно вписать любую заглушку, сохранить, вернуться и настроить остальное.
• Цена и себестоимость доставки фиксированные: динамического расчёта цен у встроенной службы нет. Процент РКО в себестоимости считается от цены заказа для покупателя, а не от себестоимости.
• Ответ на отправку должен содержать трек-код: по нему CRM следит за посылкой и печатает документы.
• Статус ошибки не должен совпадать со статусом отправки. Для ошибок удобно завести отдельный вложенный статус: тащить их сразу в возврат сомнительно.

Полная схема ответов и примеры обработчиков на PHP — в статье «Создаём простую логистическую службу». Три ссылки на стороннем хостинге — и скромная заглушка внезапно становится полноценной логистикой.