Интеграция СДЭК API с RetailCRM через REST API
Если функционала готового модуля недостаточно, вы можете интегрировать СДЭК API с RetailCRM напрямую через REST. Это даёт полный контроль над данными и гибкость.
Сравнение
| Критерий | По теме страницы | Готовый модуль СДЭК |
|---|---|---|
| Гибкость | Полная: любые сценарии | Ограниченная функционалом модуля |
| Сложность настройки | Требуется разработчик | Установка за 10 минут |
| Обновления | Самостоятельное сопровождение | Автоматические обновления модуля |
| Затраты времени | 10–20 часов на разработку | 1–2 часа на настройку |
Как это работает
В ЛК СДЭК (lk.cdek.ru/integration) создайте client_id и client_secret.
Напишите функцию, которая запрашивает токен и кэширует его до истечения срока.
Создайте скрипт, который принимает параметры заказа и вызывает calculator/tariff.
По нажатию кнопки в RetailCRM отправляйте запрос на создание заказа и сохраняйте номер СДЭК.
Подробно
Базовая настройка интеграции
Получите client_id и client_secret в личном кабинете СДЭК. Для получения токена отправьте POST /v2/oauth/token с параметрами. Токен действует 3600 секунд — обязательно кэшируйте его. Настройте HTTP-клиент в RetailCRM (создайте дополнительный модуль или используйте HTTP-действия).
Реализация ключевых методов API
Для расчёта стоимости: передайте адрес отправления и получения, вес, габариты. Пример ответа: {'total_sum': 170, 'delivery_time': 24}. Для создания заказа: заполните поля получателя, адрес, список товаров с их стоимостью. Для отслеживания: запрашивайте статус по номеру СДЭК. Обрабатывайте ошибки: 400 — неверные данные, 429 — превышение лимита (повторить с задержкой).
Словарь терминов
Отзывы
Интегрировал СДЭК напрямую с RetailCRM за пару дней. Документация чёткая, песочница помогла отладить всё до боя.
Благодаря REST API смогла добавить свой логистический сценарий, которого не было в готовом модуле. Работает отлично.
Частые вопросы
Какой язык лучше использовать для интеграции?
PHP, Python, JavaScript — любой, поддерживаемый RetailCRM и вашим сервером.
Как часто нужно обновлять токен?
Раз в час, по истечении 3600 секунд.
Что делать при ошибке 429?
Добавьте задержку в 1–2 секунды и повторите запрос.
Интегрируйте СДЭК напрямую с RetailCRM за 2 дня — получите полный контроль над доставкой.
