Настройка интеграции 1С: ЭДО, ЧЗ, документооборот

Настройка интеграции 1С: ЭДО, ЧЗ, документооборот

Коротко: Настройка интеграции 1С — это подключение внешних систем (ЭДО, Честный Знак, СБИС, 1С:Документооборот) к учётной базе через типовые механизмы или API. Базовое подключение ЭДО занимает 1-2 часа, бесшовная интеграция с Документооборотом — 3-5 часов, обмен с Честным Знаком через ИС МП — от 4 часов. В статье разбираем реальные настройки с кодом.

Главное об интеграции 1С за 30 секунд

  • ЭДО настраивается через сервис «1С-ЭДО» без внешних лицензий — регистрация оператора и обмен приглашениями с контрагентом.
  • Бесшовная интеграция с 1С:Документооборот позволяет работать с задачами и файлами ДО прямо из интерфейса УТ/ERP/Бухгалтерии.
  • Честный Знак подключается через ИС МП (Информационную систему маркировки) с настройкой обмена кодами GTIN и агрегации.
  • СБИС интегрируется через модуль обмена или REST API — актуально, если контрагенты используют оператора «Тензор».
  • Средняя стоимость первичной настройки у специалиста — от 5 000 до 25 000 ₽ в зависимости от сложности.

Что такое настройка интеграции 1С и зачем она нужна?

Под настройкой интеграции 1С понимают конфигурирование обмена данными между учётной базой и внешними сервисами: операторами электронного документооборота, государственными информационными системами (Честный Знак, ЕГАИС, Меркурий), системами документооборота и сторонними приложениями через API. Цель — исключить ручной ввод, ускорить обработку документов и обеспечить соответствие законодательству.

В типовых конфигурациях (1С:Бухгалтерия, УТ, ERP, УНФ, Комплексная автоматизация) большинство интеграций реализовано штатно и требует лишь корректной настройки. Для нестандартных случаев подключается разработчик, который дорабатывает обмен через веб-сервисы, HTTP-запросы или планы обмена.

Тип интеграцииМеханизмВремя настройкиНужна доработка?
1С-ЭДОТиповой сервис1-2 часаНет
Бесшовная с ДОБиблиотека БИД3-5 часовИногда
Честный Знак (ИС МП)Типовой + API4-8 часовЧасто
СБИСМодуль/REST API4-6 часовДа
Внешний APIHTTP-сервисыот 8 часовДа

Как настроить ЭДО в 1С?

Электронный документооборот — самая востребованная интеграция. В типовых конфигурациях используется встроенный сервис «1С-ЭДО», который не требует покупки отдельного клиента оператора.

Пошаговая настройка 1С-ЭДО

  1. Откройте раздел Администрирование → Обмен электронными документами и включите флаг «Электронные документы».
  2. Установите сертификат электронной подписи (КЭП) — раздел Настройки ЭП и шифрования.
  3. Создайте учётную запись ЭДО через мастер: Продажи → ЭДО → Настройки ЭДО → Создать.
  4. Отправьте приглашение контрагенту по его идентификатору участника ЭДО или ИНН.
  5. После принятия приглашения статус соединения станет «Присоединён» — можно обмениваться документами.

Программно проверить наличие активной настройки ЭДО для контрагента можно так:

// Проверяем, есть ли настройка ЭДО для контрагента
Функция ЕстьНастройкаЭДО(Контрагент, Организация) Экспорт

	Запрос = Новый Запрос;
	Запрос.Текст =
		"ВЫБРАТЬ
		|	НастройкиЭДО.Ссылка КАК Ссылка
		|ИЗ
		|	Справочник.НастройкиЭДО КАК НастройкиЭДО
		|ГДЕ
		|	НастройкиЭДО.Владелец = &Контрагент
		|	И НастройкиЭДО.Организация = &Организация
		|	И НЕ НастройкиЭДО.ПометкаУдаления";

	Запрос.УстановитьПараметр("Контрагент", Контрагент);
	Запрос.УстановитьПараметр("Организация", Организация);

	Результат = Запрос.Выполнить();

	Возврат НЕ Результат.Пустой();

КонецФункции

Для холдингов с несколькими юрлицами часто требуется межфирменный обмен. Об этом подробно рассказано в материале про настройку ЭДО для межфирменного документооборота в холдинге.

Как автоматизировать отправку документов ЭДО?

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

// Регламентное создание электронных документов по реализациям
Процедура СоздатьЭлектронныеДокументыПоРеализациям() Экспорт

	Запрос = Новый Запрос;
	Запрос.Текст =
		"ВЫБРАТЬ
		|	Реализация.Ссылка КАК Документ
		|ИЗ
		|	Документ.РеализацияТоваровУслуг КАК Реализация
		|ГДЕ
		|	Реализация.Проведен = ИСТИНА
		|	И Реализация.Дата >= &НачалоПериода";

	Запрос.УстановитьПараметр("НачалоПериода", НачалоДня(ТекущаяДата()));

	Выборка = Запрос.Выполнить().Выбрать();

	Пока Выборка.Следующий() Цикл

		// Проверяем настройку ЭДО перед отправкой
		Если ЕстьНастройкаЭДО(Выборка.Документ.Контрагент, Выборка.Документ.Организация) Тогда
			Попытка
				МодульЭДО = ОбщегоНазначения.ОбщийМодуль("ЭлектронныйДокументооборотСервер");
				МодульЭДО.СоздатьЭлектронныеДокументы(Выборка.Документ);
			Исключение
				ЗаписьЖурналаРегистрации("ЭДО.Отправка",
					УровеньЖурналаРегистрации.Ошибка, , ,
					ОписаниеОшибки());
			КонецПопытки;
		КонецЕсли;

	КонецЦикла;

КонецПроцедуры
Важно: имя общего модуля ЭДО зависит от версии библиотеки электронных документов (БЭД). В свежих релизах используется ЭлектронныйДокументооборот из состава БСП. Всегда сверяйтесь с документацией конкретной конфигурации.

Как настроить бесшовную интеграцию 1С с Документооборотом?

Бесшовная интеграция позволяет пользователям УТ, ERP или Бухгалтерии работать с задачами, процессами и файлами системы 1С:Документооборот, не покидая привычный интерфейс. Реализуется через библиотеку интеграции с документооборотом (БИД).

Порядок настройки бесшовной интеграции

  1. В базе-источнике (например, ERP) включите функцию Администрирование → Настройки интеграции → Интеграция с 1С:Документооборот.
  2. Укажите адрес публикации базы 1С:Документооборот (веб-сервис dm).
  3. Введите учётные данные пользователя ДО с правами на веб-сервисы.
  4. Настройте соответствие пользователей двух баз (маппинг).
  5. Проверьте соединение — при успехе появятся команды «Процессы и задачи», «Настройки интеграции с ДО».

Ключевой момент 1С настройки бесшовной интеграции — корректная публикация веб-сервиса Документооборота на веб-сервере (Apache или IIS). Без опубликованного ws-сервиса соединение работать не будет.

// Проверка доступности веб-сервиса Документооборота
Функция ПроверитьСоединениеСДокументооборотом(АдресСервиса, Логин, Пароль) Экспорт

	Определение = Новый WSОпределения(
		АдресСервиса + "/ws/DMService?wsdl",
		Логин,
		Пароль);

	Прокси = Новый WSПрокси(
		Определение,
		"http://www.1c.ru/SSL/Exchange",
		"DMService",
		"DMServiceSoap");

	Попытка
		// Вызываем тестовый метод сервиса
		Результат = Прокси.Ping();
		Возврат Истина;
	Исключение
		ЗаписьЖурналаРегистрации("Интеграция.ДО",
			УровеньЖурналаРегистрации.Ошибка, , ,
			ОписаниеОшибки());
		Возврат Ложь;
	КонецПопытки;

КонецФункции
При бесшовной интеграции обе конфигурации должны быть на совместимых версиях БСП. Расхождение более чем на одну мажорную версию часто приводит к ошибкам сериализации объектов.

Как настроить интеграцию 1С и Честный Знак?

Настройка интеграции 1С и Честный Знак нужна для работы с маркированной продукцией (обувь, табак, молочная продукция, лёгкая промышленность, парфюмерия и др.). Обмен идёт через ИС МП — информационную систему маркировки и прослеживаемости.

Настройка интеграции ИС МП в 1С

  1. Включите функциональность в разделе НСИ и администрирование → Маркировка → Интеграция с ИС МП.
  2. Укажите товарные группы, по которым ведётся маркировка (обувь, молоко, табак и т. д.).
  3. Настройте подключение к ЭДО — коды маркировки передаются через универсальный передаточный документ (УПД).
  4. Проверьте регистрацию организации в системе Честный Знак (ГИС МТ) через личный кабинет.
  5. Настройте обмен кодами: заказ КМ, ввод в оборот, вывод из оборота, агрегация в транспортные упаковки.

Ниже пример проверки статуса кода маркировки перед продажей через регистр сведений «КодыМаркировки»:

// Проверка статуса кода маркировки перед выбытием
Функция КодМаркировкиВОбороте(КодМаркировки) Экспорт

	Запрос = Новый Запрос;
	Запрос.Текст =
		"ВЫБРАТЬ
		|	Коды.Статус КАК Статус
		|ИЗ
		|	РегистрСведений.ШтрихкодыУпаковокИТоваров КАК Коды
		|ГДЕ
		|	Коды.МаркировкаТоваров = &КодМаркировки";

	Запрос.УстановитьПараметр("КодМаркировки", КодМаркировки);

	Выборка = Запрос.Выполнить().Выбрать();

	Если Выборка.Следующий() Тогда
		Возврат Выборка.Статус = Перечисления.СтатусыКодовМаркировки.ВОбороте;
	Иначе
		Возврат Ложь;
	КонецЕсли;

КонецФункции

Настройка маркировки часто пересекается с продажами на маркетплейсах. Полезные материалы: 7 мифов об интеграции 1С:Розница с маркетплейсами и топ навыков 1С-специалиста по интеграциям.

Названия регистров в примерах могут отличаться в зависимости от релиза конфигурации и товарной группы. Перед разработкой всегда проверяйте состав метаданных в конкретной базе.

Как настроить интеграцию 1С и СБИС?

СБИС — сервис оператора «Тензор». Если контрагенты подключены к нему, обмен возможен по роумингу через 1С-ЭДО либо напрямую через модуль СБИС или его REST API.

Два способа интеграции с СБИС

  • Через роуминг 1С-ЭДО — самый простой путь. Отправляете заявку на роуминг с оператором «Тензор», после активации документы ходят прозрачно.
  • Через плагин/модуль СБИС — устанавливается внешняя обработка или коннектор, который выгружает документы в СБИС и импортирует статусы.

Пример отправки HTTP-запроса к API СБИС для авторизации (упрощённо):

// Авторизация в API СБИС и получение токена сессии
Функция ПолучитьТокенСБИС(Логин, Пароль) Экспорт

	Соединение = Новый HTTPСоединение(
		"online.sbis.ru",
		443,
		,
		,
		,
		,
		Новый ЗащищенноеСоединениеOpenSSL());

	ТелоЗапроса = Новый Структура;
	ТелоЗапроса.Вставить("jsonrpc", "2.0");
	ТелоЗапроса.Вставить("method", "СБИС.Аутентифицировать");

	Параметры = Новый Структура;
	Параметры.Вставить("Логин", Логин);
	Параметры.Вставить("Пароль", Пароль);
	ТелоЗапроса.Вставить("params", Параметры);
	ТелоЗапроса.Вставить("id", 0);

	ЗаписьJSON = Новый ЗаписьJSON;
	ЗаписьJSON.УстановитьСтроку();
	ЗаписатьJSON(ЗаписьJSON, ТелоЗапроса);
	ТекстJSON = ЗаписьJSON.Закрыть();

	Запрос = Новый HTTPЗапрос("/service/");
	Запрос.Заголовки.Вставить("Content-Type", "application/json-rpc");
	Запрос.УстановитьТелоИзСтроки(ТекстJSON);

	Ответ = Соединение.ВызватьHTTPМетод("POST", Запрос);

	Если Ответ.КодСостояния = 200 Тогда
		ЧтениеJSON = Новый ЧтениеJSON;
		ЧтениеJSON.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку());
		СтруктураОтвета = ПрочитатьJSON(ЧтениеJSON);
		Возврат СтруктураОтвета.result;
	Иначе
		ВызватьИсключение "Ошибка авторизации СБИС: " + Ответ.КодСостояния;
	КонецЕсли;

КонецФункции

Коммерческую сторону интеграций через API мы разбирали в статье про стоимость и окупаемость интеграции ЭДО с маркетплейсами.

Как в 1С настроить декларацию по имуществу?

Отдельный частый вопрос — как в 1С настроить декларацию по имуществу организаций. Это не совсем интеграция, но напрямую связано с регламентированной отчётностью и обменом с ФНС.

  1. Заполните карточки основных средств: раздел ОС и НМА → Основные средства, укажите кадастровый номер и признак недвижимости.
  2. В настройках налогов и отчётов (Главное → Налоги и отчёты → Налог на имущество) задайте ставки, льготы и порядок уплаты по каждому региону.
  3. Убедитесь, что для объектов недвижимости указана налоговая база (среднегодовая или кадастровая стоимость).
  4. Сформируйте декларацию через Отчёты → Регламентированные отчёты → Налог на имущество.
  5. Отправьте отчёт напрямую в ФНС через сервис «1С-Отчётность» — это тоже интеграция с ГИС.

Если объектов много и часть облагается по кадастровой, а часть по среднегодовой стоимости, важно корректно заполнить разделы 2 и 2.1 декларации. Программные ошибки обычно связаны с отсутствием даты постановки на учёт или неверным ОКТМО.

Как настроить интеграцию в 1С:УНФ?

1С:УНФ (Управление нашей фирмой) — конфигурация для малого бизнеса. Настройка интеграции 1С:УНФ включает подключение ЭДО, эквайринга, маркетплейсов и банковских сервисов (DirectBank).

  • 1С-ЭДО — раздел Компания → Ещё → ЭДО, механизм тот же, что и в других типовых.
  • DirectBank — прямой обмен с банком без клиент-банка, настраивается в разделе Деньги → Банк.
  • Маркетплейсы — подключение через встроенные обработки обмена с Wildberries, Ozon, Яндекс.Маркет.
  • Честный Знак — для розницы с маркированным товаром через кассовое ПО.

УНФ хорошо подходит для сценария «всё в одной базе», но при масштабировании бизнеса нередко мигрируют на ERP с более гибкой архитектурой обмена. Для аналитики полезна грамотно настроенная управленческая отчётность в 1С.

Найдите специалиста для решения этой задачи на koderion.ru

Читайте также