СДЭК: подключение к CRM

Договор

На стороне СДЭК (cdek.ru/ru/contract):

1. Заполните заявку на договор для e-com.
2. СДЭК отправит менеджера, подпишите бумаги.
3. После договора получите доступ в кабинет lk.cdek.ru.

API-доступ

1. В кабинете → Интеграция → API.
2. Создайте учётку:

- account (Client ID) - secure (Client Secret)

1. Доступы тестовые (для интеграции) и боевые (после готовности).

Подключение в CRMservice

1. Настройки → Интеграции → Доставка → СДЭК.
2. Вставьте account и secure.
3. Выберите режим — Тест / Бой.
4. Сохранить.

Склады отправки

1. Настройки → Склады в CRM.
2. Для каждого склада укажите код ПВЗ СДЭК (например MSK1, SPB2).
3. Без этого СДЭК не знает, откуда забирать посылки.

Создание накладной из заказа

1. Откройте заказ → Действия → Создать накладную → СДЭК.
2. Выберите тариф (Посылка склад-склад, Посылка дверь-дверь, Магистральный экспресс…).
3. CRM посчитает стоимость на основе адреса + габаритов + веса.
4. Подтвердите → СДЭК создаст накладную, вернёт трек-номер.

Вебхук статусов

В CRM вебхук регистрируется автоматически при подключении. СДЭК присылает события:

• ORDER_REGISTERED — накладная создана
• ACCEPTED_BY_COURIER — курьер забрал
• RECEIVED_AT_PVZ — приехал в ПВЗ назначения
• DELIVERED — выдан клиенту

Статус заказа в CRM обновляется автоматически.

Возможные проблемы

• «Тариф недоступен для города» — не все ПВЗ принимают все типы посылок. См. Калькулятор СДЭК.
• «Не получается отменить накладную» — после ACCEPTED_BY_COURIER отмена платная. До приёма — бесплатна.
• «Габариты не подходят» — СДЭК максимум 31.5 кг × 1500 мм по длине. Для крупного — Деловые Линии.