Интеграция СДЭК с 1С автоматизирует создание накладных, передачу заказов курьерам и получение трек-номеров без ручного ввода. Поддерживаются конфигурации УТ 11, КА 2, ERP 2, Розница 3, Бухгалтерия 3. Разбираем подключение для каждой конфигурации, настройку API и работу с закрывающими документами.
Поддерживаемые конфигурации 1С
СДЭК официально интегрируется с пятью популярными конфигурациями 1С. Для каждой есть готовая типовая обработка, которая ставится на пустую базу за 10 минут.
1С: Управление торговлей 11
Основная конфигурация для интернет-магазинов и оптовой торговли. Обработка СДЭК встраивается в раздел «Продажи» и работает с документами «Заказ клиента» и «Реализация товаров». При создании заказа автоматически рассчитывается стоимость доставки и формируется накладная.
1С: Комплексная автоматизация 2
Для компаний, которые ведут в одной базе и торговлю и производство и бухучёт. Обработка работает аналогично УТ 11, плюс автоматически отражает закрывающие документы СДЭК в учёте без двойного ввода.
1С: ERP 2
Для крупных компаний с регламентированным учётом и сложной структурой. Интеграция СДЭК работает на уровне отдельного функционального блока «Логистика» с расширенной аналитикой по перевозчикам.
1С: Розница 3
Для розничных сетей с физическими точками продаж. СДЭК встраивается в кассовый сценарий: при оформлении заказа на доставку через РМК сразу создаётся накладная и печатается этикетка с трек-номером.
1С: Бухгалтерия 3
Минимальная интеграция для тех, кто работает с СДЭК редко и не нуждается в автоматизации. Обработка тянет в учёт только закрывающие документы: УПД, акты, счета-фактуры. Заказы создаются вручную через личный кабинет СДЭК.
Способы интеграции
Существуют три варианта интеграции, каждый под свой уровень технической готовности команды.
- Типовая обработка — готовый файл .epf, который ставится через «Открыть обработку». Подходит для большинства бизнесов
- Расширение конфигурации — обработка устанавливается как полноценное расширение и не требует обновлений при выходе новых релизов 1С
- Самописная интеграция через REST API — для уникальных бизнес-процессов, требует разработчика 1С
Шаг 1: получение доступа к API СДЭК
До начала работы в 1С нужно получить два значения из личного кабинета СДЭК: идентификатор клиента (Client ID) и секретный ключ (Client Secret). Они находятся в разделе «Интеграции» в личном кабинете.
Никогда не используйте боевые ключи API на тестовых базах 1С. СДЭК выдаёт отдельные тестовые credentials для отладки. Все накладные, созданные с боевыми ключами на тестовой базе, попадут в реальную обработку и могут привести к недоразумениям с курьерами.
Дмитрий Соколов, технический интегратор
Шаг 2: установка обработки в 1С
Файл типовой обработки скачивается из личного кабинета СДЭК или с сайта 1С: ИТС. Установка через стандартный механизм «Файл — Открыть» в режиме «Конфигуратор».
- Открыть базу 1С в режиме предприятия
- Перейти в раздел «Администрирование — Печатные формы, отчёты и обработки»
- Нажать «Дополнительные обработки» и добавить файл .epf СДЭК
- Указать раздел отображения (для УТ 11 это «Продажи»)
- Сохранить и перезапустить базу
Шаг 3: настройка подключения к API
После установки обработка появляется в выбранном разделе. Первый запуск открывает форму настройки подключения. Здесь вводятся Client ID и Client Secret, проверяется соединение и выбираются параметры интеграции.
Основные параметры для УТ 11
- Город отправителя по умолчанию — основной склад магазина
- Тариф по умолчанию — Посылка Магистральный или Экспресс
- Тип печатной формы — формат А4 или этикетка 100×150
- Учётная политика — НДС в стоимости доставки или отдельно
- Статусы заказов — соответствие статусов СДЭК и 1С
- Уведомления клиенту — отправлять СМС или email
Шаг 4: первый тестовый заказ
После настройки нужно создать тестовый заказ. Это покажет, всё ли корректно настроено и где могут быть проблемы.
В документе «Заказ клиента» появляется новое поле «Доставка СДЭК». При его заполнении автоматически появляются дополнительные поля: тариф, ПВЗ или адрес получателя, объявленная ценность, наложенный платёж. После сохранения заказа в фоне создаётся накладная в СДЭК и в документ возвращается трек-номер.
Работа с накладными
Из карточки заказа в 1С печатается этикетка СДЭК со штрихкодом, адресом получателя и трек-номером. Этикетка крепится на короб, и груз готов к передаче курьеру или сдаче в ПВЗ. Статусы обновляются в 1С автоматически каждые 30 минут или по вебхуку при подключении расширенной интеграции.
Массовое создание накладных
Если в магазине ежедневно много отправлений, через обработку можно выделить группу заказов клиента и создать накладные пакетом. Это занимает 30 секунд для 100 заказов вместо часа ручной работы.
API endpoints для разработчиков
Для самописной интеграции через REST API СДЭК предоставляет несколько ключевых endpoints. Полная документация доступна на сайте для подключённых клиентов.
| Endpoint | Назначение |
|---|---|
POST /v2/orders |
Создание накладной |
GET /v2/orders/{uuid} |
Получение статуса заказа |
POST /v2/calculator/tariff |
Расчёт стоимости доставки |
GET /v2/deliverypoints |
Список ПВЗ по городу |
POST /v2/intakes |
Заявка на забор курьером |
POST /v2/webhooks |
Подписка на изменения статусов |
Авторизация через OAuth 2.0 с токеном, действительным 1 час. После истечения токен обновляется автоматически. Лимит запросов 100 в секунду для договорных клиентов, для розничных 10 в секунду.
Вебхуки для мгновенных обновлений
По умолчанию обработка тянет статусы заказов по расписанию каждые 30 минут. Это нормально для большинства магазинов, но если важно показывать клиенту статус мгновенно, подключаются вебхуки. СДЭК сам отправляет POST-запрос на ваш сервер при каждом изменении статуса заказа.
Какие события поддерживают вебхуки
- Заказ создан и принят системой
- Груз принят на отправку в ПВЗ или у курьера
- Груз в пути между городами
- Груз доставлен в город получателя
- Груз готов к выдаче в ПВЗ
- Груз выдан получателю
- Груз возвращён отправителю
Закрывающие документы
Раз в месяц обработка автоматически тянет в 1С закрывающие документы СДЭК: УПД, акты выполненных работ, счета-фактуры. Документы появляются в разделе «Покупки» как поступления услуг от поставщика. Бухгалтер видит их в стандартном списке и проводит обычным порядком.
Для договорных клиентов документы формируются раз в месяц на общую сумму всех отправлений. Для розничных тарифов каждое отправление формирует отдельный документ, что усложняет учёт.