Интеграция 1С с СДЭК 2026: заказы, треки и статусы через API v2.0

Интеграция 1С с СДЭК нужна не для красивой кнопки в документе, а для устранения ручного участка: менеджер не должен копировать адрес, телефон, вес, ПВЗ и трек-номер между 1С и личным кабинетом СДЭК. Рабочий сценарий выглядит так: документ в 1С проходит локальную проверку, 1С получает OAuth-токен, отправляет заказ в POST /v2/orders, сохраняет uuid, после обработки забирает cdek_number, печатает PDF-этикетку и обновляет статус доставки.

Эта статья для владельцев интернет-магазинов, руководителей склада и 1С-разработчиков, которым нужно понять, где чаще всего ломается обмен 1С - СДЭК. Ниже не обзор "всех возможностей API", а практическая карта рисков: авторизация, разные среды, тарифы, ПВЗ, асинхронная обработка заказов и печатные формы.

Ключевые факты по СДЭК API v2.0

• Авторизация выполняется через OAuth 2.0: POST на /v2/oauth/token, grant_type=client_credentials, client_id, client_secret, тип запроса x-www-form-urlencoded.
• Ответ авторизации содержит access_token, token_type, expires_in; в документации указан типовой срок жизни токена 3600 секунд, поэтому токен нужно кэшировать в 1С и обновлять до истечения срока.
• Тестовая среда и боевая среда разные: https://api.edu.cdek.ru/v2/ и https://api.cdek.ru/v2/. Ключи, заказы, ПВЗ и справочники нельзя смешивать между средами.
• При создании заказа СДЭК возвращает идентификатор сущности entity.uuid. Номер накладной cdek_number относится к информации о заказе и может появиться после обработки заявки.
• Для получения информации по заказу используются варианты поиска по uuid, cdek_number или номеру заказа интернет-магазина (im_number/внутренний номер, зависит от реализации).
• Для ПВЗ в API используется /v2/deliverypoints; на стороне 1С важно хранить не только текст адреса, но и код ПВЗ, город СДЭК и признаки выдачи/приёма.
• Для печатных форм используется отдельный сценарий: сначала создаётся задача на печать, затем нужно дождаться готовности PDF. Получать PDF сразу после создания задачи рискованно.

Что стоит автоматизировать в 1С

Синхрон1С подключает такой обмен под конкретную конфигурацию 1С и договор СДЭК. Стоимость внедрения для этого сценария - 30 000 ₽ за проект: разбор текущего процесса, настройка обмена, обработка ошибок и проверка на тестовой или боевой среде.

Практическая диагностика перед внедрением

Перед тем как писать код обмена, я проверяю не "есть ли API-ключ", а весь путь заказа. В нашем разборе таких интеграций это экономит больше времени, чем попытки отлавливать ошибку уже в обработке проведения документа.

1. Проверить пару сред. Тестовый токен должен успешно получаться на api.edu.cdek.ru, боевой - на api.cdek.ru. Если тестовый ключ подставили в боевой URL, 1С обычно покажет только 401/invalid client, а причина будет неочевидна менеджеру.
2. Сделать минимальный заказ без лишних полей. Сначала отправить один простой заказ: один получатель, один грузомест, один тариф, один город. Только после этого добавлять наложенный платёж, страховку, комментарии, допуслуги и печать.
3. Сохранить uuid отдельно от cdek_number. В регистре обмена нужны минимум: номер документа 1С, uuid СДЭК, cdek_number, текущий статус, дата последнего запроса, текст последней ошибки.
4. Проверить тариф на методе создания заказа, а не только в калькуляторе. Тариф может считаться, но не проходить регистрацию заказа из-за режима доставки, договора, города или ПВЗ.
5. Проверить справочник ПВЗ в той же среде. Нельзя взять код ПВЗ из боевой среды и тестировать его в edu: набор пунктов и городов может отличаться.
6. Сделать повторный запуск обмена. Интеграция должна быть идемпотентной: если первый запрос создал заказ, а 1С получила таймаут, повтор не должен создавать дубль без проверки сохранённого uuid или внутреннего номера.
7. Проверить печать не сразу после POST. Для PDF-форм нужен цикл ожидания статуса готовности. В интерфейсе 1С кнопка печати должна быть заблокирована, пока печатная форма не готова.

Таблица рисков и диагностики

Важный нюанс по тарифам 136/137/138/139 и 480/481/482/483

В старых инструкциях и карточках интеграций часто встречаются коды 136, 137, 138, 139 для тарифов "Посылка". В справочниках также встречаются 480, 481, 482, 483 для экспресс-режимов дверь/склад. Практический вывод простой: нельзя зашивать код тарифа в модуле 1С только потому, что он "однажды посчитался" в калькуляторе.

Для внедрения я фиксирую в настройках 1С не только число тарифа, но и человекочитаемый режим:

После этого каждый тариф проверяется двумя запросами: расчёт стоимости и регистрация тестового заказа. Если договор СДЭК ограничивает конкретный тариф или город, это всплывает до запуска менеджеров в работу.

Архитектура обмена в 1С

Минимальный устойчивый контур состоит из 5 частей:

1. Регистр настроек СДЭК. Организация, среда, client_id, client_secret, город отправки, ПВЗ отправки, режим печати, список разрешённых тарифов.
2. Регистр токенов. Токен, время получения, expires_in, организация, среда. Токен обновляется заранее, а не при первой ошибке 401.
3. Регистр заказов СДЭК. Документ 1С, uuid, cdek_number, статус, дата последней синхронизации, последняя ошибка.
4. Очередь обмена. Создание заказа, получение номера, печать, отмена, обновление статуса. Очередь нужна, чтобы пережить таймауты и временные 5xx от API.
5. Журнал диагностики. Метод, URL без секретов, HTTP-код, короткий ответ API, пользователь, документ 1С. Без этого любая ошибка превращается в "СДЭК не работает".

Как подключаем в Синхрон1С

Шаг 1. Вы присылаете конфигурацию 1С, описание процесса доставки, договор/среду СДЭК и список тарифов, которые реально используются на складе.

Шаг 2. Мы настраиваем обмен: авторизация, создание заказа, хранение uuid, получение cdek_number, расчёт тарифа, проверка ПВЗ, печать PDF и статусы.

Шаг 3. Проводим контрольные заказы: простой заказ, заказ на ПВЗ, заказ дверь-дверь, заказ с наложенным платежом или объявленной стоимостью, если это нужно бизнесу.

Синхрон1С помогает связать документы 1С с заказами СДЭК через API v2.0 и оставить менеджеру только проверку спорных случаев.

FAQ

Можно ли сделать интеграцию без доработки конфигурации 1С? Иногда да, если конфигурация типовая и достаточно внешней обработки. Но для надёжного хранения uuid, статусов, ошибок и настроек по организациям обычно нужен небольшой регистр или расширение.

Почему заказ создан, но трек-номер ещё пустой? Потому что создание заказа и появление cdek_number не всегда один синхронный шаг. Сначала сохраняйте uuid, затем запрашивайте информацию по заказу или ждите статус через вебхук.

Что лучше: вебхуки или опрос API по расписанию? Вебхуки быстрее, но требуют доступного endpoint и журнала приёма. Для склада я обычно оставляю оба механизма: вебхуки для оперативности и регламентный опрос как страховку.

Можно ли подключить несколько юридических лиц? Да. Каждой организации нужна своя пара ключей и своя настройка среды/договора. Общий токен на все организации лучше не использовать.

Как не создать дубль заказа при сбое сети? Сохранять uuid сразу после ответа СДЭК, использовать внутренний номер заказа и перед повторным POST проверять, не был ли заказ уже создан.

Сколько занимает внедрение? Если процесс доставки простой и есть доступы, базовый сценарий можно поднять быстро. На сроки сильнее всего влияют нестандартные тарифы, несколько организаций, наложенный платёж, возвраты и требования к печатным формам.

Смотрите также

• Интеграция с маркетплейсами 1С: Озон, Wildberries, Авито
• Автоматическая выгрузка из 1С по расписанию
• Интеграция 1С с Почтой России
• Экспорт из 1С в Авито: синхронизация товаров
• Интеграция 1С и МойСклад: синхронизация остатков и документов

Стоимость интеграции 1С - СДЭК через Синхрон1С - 30 000 ₽ за проект. Напишите в Telegram: @onoutnoxon, кратко опишите конфигурацию 1С, тарифы СДЭК и текущую боль: ручной ввод, ошибки ПВЗ, печать, статусы или дубли заказов.

Подробнее о продукте: Синхрон1С.

Источники:

• Авторизация OAuth 2.0 в API СДЭК: https://api-docs.cdek.ru/29923918.html
• Получение информации о заказе и поле cdek_number: https://api-docs.cdek.ru/29923926.html
• Калькулятор по коду тарифа: https://api-docs.cdek.ru/63345430.html
• Калькулятор по доступным тарифам и перечень кодов: https://api-docs.cdek.ru/63345519.html
• Зеркало документации СДЭК API v2.0 по авторизации и заказам: https://geekdaxue.co/read/cdek@api2/auth и https://geekdaxue.co/read/cdek@api2/order-info
• Справочник тарифов с ссылкой на актуальное приложение СДЭК: https://help.megagroup.ru/tarify-sdek
• PHP SDK как технический референс по методам createOrder, getOrderInfoByUuid, getOrderInfoByCdekNumber, печати и вебхукам: https://github.com/AntistressStore/cdek-sdk-v2
• Packagist-страница SDK для проверки актуальности пакета и состава методов: https://packagist.org/packages/antistress-store/cdek-sdk-v2

Для статьи использован AI-ассистент для структурирования, но фактические утверждения перепроверены по документации СДЭК, зеркалу API-документации, справочнику тарифов и SDK. Неподтверждённые проценты, обещания "за 15 минут" и категоричные утверждения про страховку/габариты убраны. Финальную редактуру выполнил Александр Руин. Обновлено: 2026-05-04.