Интеграция СДЭК в 1С:Управление нашей фирмой 3.0.13: пошаговая инструкция по подключению и работе
Полная пошаговая инструкция по интеграции СДЭК в 1С:УНФ 3.0.13+. Узнайте, как подключить службу через 1С:Доставка и Бизнес-сеть, оформить отправку из документа и автоматизировать логистику. Решения для типичных ошибок.
Интеграция службы доставки СДЭК в 1С:Управление нашей фирмой (версия 3.0.13 и выше) позволяет оформлять отправки прямо из документов "Заказ покупателя", "Расходная накладная" или "Заказ-наряд". Для работы требуется активированный сервис "1С:Доставка" и подключение к "1С:Бизнес-сети", который выступает универсальным посредником между программой и внешними сервисами, включая СДЭК. Это стандартный поддерживаемый способ интеграции, который избавляет от необходимости настраивать прямое API-подключение вручную.
После настройки вы сможете автоматически создавать заказы в СДЭК из 1С, выбирать тарифы с расчетом стоимости в реальном времени, формировать этикетки и отслеживать статусы доставки. Инструкция охватывает все этапы: от проверки технических условий до решения типичных проблем. Информация актуальна для версий 1С:УНФ 3.0.13 и выше.
Что дает интеграция СДЭК с 1С:УНФ и какие условия нужны
Интеграция службы доставки СДЭК с 1С:Управление нашей фирмой автоматизирует ключевые логистические процессы. Вы оформляете отправки напрямую из документов "Заказ покупателя", "Расходная накладная" или "Заказ-наряд" через сервис "1С:Доставка". Система автоматически передает данные в СДЭК, рассчитывает доступные тарифы с ценами и сроками, формирует файлы для печати этикеток и квитанций. Статусы доставки обновляются в 1С, что дает полный контроль над отправками без переключения между системами.
Для подключения службы СДЭК необходимы три условия:
- Версия конфигурации 1С:Управление нашей фирмой не ниже 3.0.13.
- Активный сервис "1С:Доставка". Этот сервис часто входит в подписки ИТС или приобретается отдельно.
- Подключение к "1С:Бизнес-сети" как к единой точке интеграции с внешними сервисами.
Интеграция происходит через официальное API СДЭК, но вся настройка выполняется внутри интерфейса 1С через "Бизнес-сеть". Это гарантирует совместимость и упрощает обновления.
Зачем нужен сервис "1С:Бизнес-сеть" для подключения СДЭК
"1С:Бизнес-сеть" выступает универсальным посредником (агрегатором) между программой 1С и множеством внешних сервисов, включая СДЭК. Принцип работы аналогичен тому, как маркетплейс Авито работает с разными службами доставки: продавец взаимодействует не напрямую с базой данных СДЭК, а через единый интерфейс площадки.
Использование "Бизнес-сети" решает несколько задач:
- Избавляет от необходимости настраивать прямое API-подключение к каждой службе доставки вручную.
- Обеспечивает стандартный, поддерживаемый компанией 1С способ интеграции.
- Повышает надежность подключения, так как обновления и исправления реализуются централизованно.
- Упрощает добавление новых служб доставки в будущем.
Для авторизации в настройках потребуются учетные данные от личного кабинета СДЭК. Данные передаются защищенным способом через интерфейс "1С:Бизнес-сети".
Пошаговая настройка СДЭК в 1С:Управление нашей фирмой
Настройка интеграции состоит из пяти последовательных шагов. Выполняйте их по порядку, предварительно убедившись, что сервис "1С:Доставка" активен в вашей программе.
- Проверка и активация сервиса "1С:Доставка". Перейдите в раздел "Администрирование" → "Доставка товаров". Убедитесь, что сервис "1С:Доставка" активен. Если нет, активируйте его согласно условиям вашей подписки ИТС.
- Переход в раздел настройки служб доставки. В том же разделе "Администрирование" → "Доставка товаров" найдите и откройте настройки служб доставки.
- Добавление новой службы. Нажмите кнопку "Добавить" или "Создать" и выберите "СДЭК" из списка доступных служб доставки. Если СДЭК отсутствует в списке, возможно, требуется обновление конфигурации до актуального релиза.
- Авторизация. В открывшейся форме появится окно авторизации "1С:Бизнес-сети". Введите логин и пароль от вашего личного кабинета в службе СДЭК. Это не данные от 1С. После успешного ввода система установит защищенное соединение.
- Настройка параметров по умолчанию. Заполните базовые параметры: выберите склад-отправитель (его адрес будет использоваться по умолчанию), укажите типовые габариты и вес упаковки, при необходимости настройте опции страхования. Рекомендуем включить опцию предварительного расчета тарифов.
После выполнения этих шагов служба СДЭК появится в списке доступных для оформления доставки из документов.
Где найти настройки и как пройти авторизацию
Критичные первые шаги сосредоточены в конкретном пути меню: "Главное меню" → "Администрирование" → "Настройки программы" → "Доставка товаров".
В этом разделе находится общая активация сервиса "1С:Доставка" и кнопка перехода к настройкам конкретных служб. После нажатия "Добавить службу" и выбора "СДЭК" откроется стандартное для "1С:Бизнес-сети" окно авторизации. В него нужно ввести логин и пароль от личного кабинета клиента на сайте cdek.ru. Убедитесь, что аккаунт СДЭК активен и имеет права на создание заказов через API. Данные передаются по защищенному протоколу. Если служба СДЭК не отображается в списке для выбора, проверьте актуальность релиза конфигурации 1С:УНФ.
Настройка параметров отправителя и правил расчета
Корректность базовых данных напрямую влияет на точность расчета стоимости и создание накладных. После авторизации заполните:
- Склад-отправитель. Выберите из справочника "Склады" основной пункт отправки. Адрес этого склада будет подставляться в заказы по умолчанию.
- Типовые габариты и вес упаковки. Укажите усредненные значения (например, 30x30x20 см, вес 1 кг). Эти параметры используются для предварительного расчета, если в документе не указаны точные данные. Точный расчет, аналогичный требованиям при отправке через Авито Доставку, важен для избежания доплат.
- Опция "Рассчитывать тарифы при оформлении". Рекомендуем включить эту опцию. Тогда при оформлении доставки система сразу запросит у СДЭК актуальные тарифы.
Эти настройки можно переопределить в каждом конкретном заказе на доставку.
Как оформить и передать заказ в доставку СДЭК из документа
Рабочий процесс начинается после создания документа "Заказ покупателя" или "Расходная накладная". В заполненном и проведенном документе найдите и нажмите кнопку "Оформить доставку" или аналогичную (например, в панели действий документа).
Далее выполните пять действий:
- В открывшейся форме оформления доставки выберите службу "СДЭК" из списка.
- Проверьте и при необходимости отредактируйте адрес получения. Обязательно заполненный индекс повышает точность расчета.
- Укажите параметры груза: вес и габариты. Если оставить поля пустыми, система использует значения по умолчанию из настроек службы.
- Система автоматически запросит через "Бизнес-сеть" у СДЭК доступные тарифы (эконом, стандарт, экспресс) с ценами и сроками доставки. Выберите подходящий вариант.
- Нажмите кнопку "Создать заказ" или "Отправить".
После этого в системе СДЭК автоматически создается заявка на доставку. В 1С документу присваивается уникальный номер заказа СДЭК и начальный статус (например, "Создан"). В истории документа или в отдельном журнале доставок становятся доступны файлы для печати: транспортная этикетка и квитанция.
Для массовой работы с отправками используйте возможности новых релизов 1С, которые часто включают улучшения интерфейса для подобных операций.
Выбор тарифа и формирование данных для этикетки
В форме оформления доставки отображается список тарифов СДЭК с расчетом в реальном времени через API. Вы видите название тарифа ("Экономичная", "Стандарт", "Экспресс"), стоимость доставки и ориентировочный срок. Расчет учитывает города отправителя и получателя, вес, габариты и выбранные опции (например, страхование).
Рекомендуем всегда проверять итоговую сумму перед подтверждением, особенно при нестандартных габаритах или весе. После нажатия "Создать заказ" система формирует два ключевых файла:
- Транспортная этикетка (наклейка на груз) с штрихкодом и трек-номером.
- Квитанция (накладная) для передачи курьеру.
Файлы обычно сохраняются в формате PDF. Найти их можно в истории изменений документа, к которому привязана доставка, или в отчете "Журнал заказов на доставку" (раздел "Доставка").
Отслеживание статуса доставки в 1С
Статусы отправки отображаются непосредственно в 1С. Их можно увидеть в форме документа, из которого создавалась доставка, или в общем журнале заказов на доставку. Типичная цепочка статусов: "Создан", "Передан в службу доставки", "В пути", "Доставлен", "Получен".
Механизм обновления работает так: программа 1С периодически (например, раз в несколько часов) опрашивает через "Бизнес-сеть" статусы заказов у СДЭК. Поэтому возможна задержка в обновлении информации на 2-4 часа относительно сайта СДЭК. Это нормально и связано с пакетной, а не реальном временной синхронизацией, аналогично принципам интеграции других внешних сервисов.
Для получения самой актуальной информации используйте трек-номер, который также отображается в 1С, на официальном сайте tracking.cdek.ru или в мобильном приложении СДЭК.
Типичные проблемы при подключении и использовании: решения
Большинство проблем при интеграции решается проверкой нескольких ключевых параметров. Перед первой отправкой реального заказа сделайте тестовый на небольшой вес, чтобы убедиться в работоспособности всей цепочки.
Распространенные проблемы и способы их решения:
- "Служба СДЭК недоступна для выбора в настройках или при оформлении". Проверьте активацию сервиса "1С:Доставка" в разделе "Администрирование" → "Доставка товаров". Убедитесь, что конфигурация обновлена до версии, поддерживающей интеграцию со СДЭК (3.0.13 и выше).
- "Ошибка авторизации" при подключении. Перепроверьте логин и пароль от личного кабинета СДЭК. Убедитесь, что аккаунт активен и не заблокирован. Попробуйте войти с этими данными на сайте cdek.ru.
- "Не рассчитываются тарифы" при оформлении. Проверьте заполнение обязательных полей: город отправителя, город получателя, вес и габариты груза. Убедитесь, что между выбранными городами СДЭК осуществляет доставку.
- "Статусы заказов не обновляются". Напомните о цикле опроса статусов (задержка до нескольких часов). Для оперативного контроля используйте трек-номер на сайте СДЭК.
- "Заказ создан в 1С, но не появляется в личном кабинете СДЭК". Выполните диагностический чек-лист из следующего подраздела.
Если вы настраиваете логистику для товаров, подлежащих обязательной маркировке, убедитесь, что складской учет и документооборот в 1С подготовлены к новым требованиям.
Что проверить, если заказ не создается в СДЭК
Если после нажатия "Создать заказ" в 1С отправка не появляется в личном кабинете СДЭК, выполните пошаговый чек-лист:
- Проверьте интернет-соединение на компьютере с 1С. Программа должна иметь доступ к внешним ресурсам через "Бизнес-сеть".
- Убедитесь, что в личном кабинете СДЭК не исчерпан лимит на создание заказов через API, нет технических ограничений или задолженности.
- Проверьте корректность и полноту адресных данных покупателя. Особое внимание уделите индексу - он обязателен для корректной обработки. Город и улица должны быть указаны без сокращений, понятных системе СДЭК.
- Убедитесь, что вес и габариты не выходят за пределы, принимаемые СДЭК для выбранного тарифа (например, максимальный вес, сумма трех измерений).
- Если все предыдущие пункты в порядке, попробуйте перезапустить программу 1С и повторить попытку создания заказа.
Если проблема сохраняется, проверьте настройки электронного документооборота, так как сбои в смежных процессах могут влиять на интеграции. Обзор решений для автоматизации документооборота поможет выявить возможные конфликты настроек.