Скилл СДЭК в Aizor: как подключить и автоматизировать доставку
Содержание
Коротко. Скилл СДЭК подключает ИИ-агента Aizor к CDEK API v2: расчёт стоимости и сроков доставки, создание заказов, трекинг статусов, список пунктов выдачи и постаматов. Нужен договор со СДЭК и ключи интеграции: идентификатор аккаунта и пароль. Их присылают на почту, когда договор подписан, или создают в личном кабинете в разделе «Интеграция». Для проверки у СДЭК есть тестовая среда.
Что даёт скилл СДЭК в Aizor
По описанию команды Aizor, скилл умеет:
- считать стоимость и сроки доставки;
- создавать заказы на доставку;
- отслеживать статусы;
- выдавать список ПВЗ и постаматов.
Скилл подойдёт интернет-магазинам и мастерам, которые отправляют посылки через СДЭК. Агент заменяет ручной ввод адресов и параметров на личном сайте компании. Про приложение в целом читайте на странице «Что такое Aizor».
Что понадобится
- Договор со СДЭК. По документации, интеграция с информационной системой СДЭК начинается с заключения договора.
- Личный кабинет на сайте СДЭК (lk.cdek.ru).
- Приложение Aizor для macOS или Windows.
В документации выделено два типа заказов. Тип «интернет-магазин» доступен клиентам с договором «Интернет-магазин». Тип «доставка» может создать любой клиент с договором, но тарифы будут только для обычной доставки.
Нужен аккаунт Aizor? Скачивание бесплатное, промокод kalsin5 даёт −5% на каждое пополнение.
Открыть Aizor ↗Как получить ключ API: по шагам
- Заключите договор со СДЭК и дождитесь, пока он получит статус «Подписан».
- Проверьте почту: по документации, на неё автоматически приходит письмо с ключами доступа.
- Или войдите в личный кабинет, откройте раздел «Интеграция» и нажмите «Создать ключ».
- В этом разделе появятся идентификатор аккаунта и пароль. Сохраните их.
Эти данные используются так. Программа отправляет их в метод получения токена и получает токен по протоколу OAuth 2.0 (тип доступа client_credentials). По документации, токен действует 3600 секунд по умолчанию, то есть один час. После этого получают новый. Aizor делает это сам, вам достаточно один раз вставить данные.
Для проверки без риска используйте тестовую среду api.edu.cdek.ru. В документации СДЭК опубликована тестовая учётная запись. Заказы под ней не видны в личном кабинете и не обрабатываются. Скидки и наценки по договору для неё не действуют. Рабочая среда работает по адресу api.cdek.ru.
Затем установите скилл СДЭК из каталога скиллов в Aizor и вставьте идентификатор аккаунта и пароль в его настройки.
Проверка: первые запросы агенту
- «Покажи пункты выдачи СДЭК и постаматы в моём городе.» (только чтение)
- «Рассчитай стоимость и сроки доставки посылки из Уфы в Казань, вес 2 кг.» (только расчёт, без заказа)
- «Покажи статус заказа с номером ...» (только чтение)
- «Подготовь заказ на доставку по этим данным, но не создавай, пока я не подтвержу.»
Попробовать на своём кабинете. Aizor скачивается бесплатно, есть тариф со своими API-ключами. Промокод kalsin5 даёт скидку 5% на пополнение баланса.
Сценарии автоматизации
Расчёт доставки по запросу
Вы называете город и параметры посылки, агент возвращает доступные тарифы со стоимостью и сроками. Это удобно при общении с покупателем.
Создание заказа из переписки или таблицы
Агент берёт данные получателя и посылки из вашего сообщения или таблицы и готовит заказ в СДЭК. Включите ручное подтверждение: заказ создаётся только после вашего «да».
Контроль статусов по расписанию
Планировщик Aizor запускает агента каждое утро: он проверяет статусы заказов и сообщает о тех, что застряли или готовы к выдаче. Уведомления можно получать в Telegram.
Подбор пункта выдачи
Агент находит ближайшие ПВЗ и постаматы к адресу покупателя. В документации СДЭК рекомендует не хранить список офисов статично, а обновлять его раз в сутки: так он остаётся актуальным. Агент запрашивает его заново.
Частые ошибки
| Что видите | Причина | Что делать |
|---|---|---|
| Ошибка при получении токена (400) | Неверные идентификатор аккаунта или пароль | Сверьте данные с письмом или разделом «Интеграция» |
| Рабочие данные не подходят к тестовой среде | Тестовая и рабочая среды раздельные | Для теста используйте тестовую запись из документации, для боевой работы рабочие ключи |
| Заказ принят, но не создан | Метод работает асинхронно: статус ACCEPTED относится только к запросу | Проверьте статус заказа: SUCCESSFUL означает создание, INVALID означает ошибку в данных |
| Заказ нельзя изменить или удалить | Это возможно только пока заказ в статусе «Создан» | Обратитесь в СДЭК |
| Ссылка на печатную форму не открывается | Ссылка на квитанцию или ШК места действует 1 час | Запросите форму заново |
Безопасность
- Пароль интеграции равен ключу от вашего аккаунта: не пересылайте его в чатах и письмах.
- Создание и удаление заказов оставьте под ручным подтверждением, особенно если заказ с наложенным платежом.
- Для проверок сначала используйте тестовую среду.
- Если ключи могли утечь, в разделе «Интеграция» личного кабинета создайте новый ключ и замените его в скилле. Как именно отозвать старый, уточните у менеджера СДЭК: в документации это не описано.
- Если вы ведёте учёт склада, посмотрите скилл МойСклад. Условия Aizor описаны на странице тарифов.
Инструкция написана по официальной документации СДЭК (портал apidoc.cdek.ru, документация CDEK API v2), состояние на октябрь 2026 года. Интерфейс кабинета и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.
Читайте также
