Изменение правил универсального обмена в 1С: от теории к практике

Универсальный формат обмена 1С:EnterpriseData стал стандартом де-факто для интеграции между системами на платформе 1С и внешними сервисами. Однако даже готовые правила обмена редко покрывают все бизнес-процессы компании без доработок. Изменение этих правил — задача, с которой рано или поздно сталкивается каждый специалист по 1С, будь то настройка выгрузки дополнительных реквизитов, фильтрация данных или адаптация под специфические форматы контрагентов.

В этой статье мы разберём не только техническую сторону редактирования правил обмена (через конфигуратор и внешние обработки), но и типичные сценарии, где требуется их модификация. Особое внимание уделим практическим примерам — от простой корректировки соответствий полей до сложных трансформаций данных с использованием XDTO и XSLT. Если вы ранее работали только со стандартными обменами через ПланыОбмена, материал поможет перейти на более гибкий уровень настройки.

Что такое универсальный формат обмена и когда его менять

Универсальный формат обмена (EnterpriseData) — это XML-структура, описывающая данные 1С в стандартном виде, понятном для других систем. Его ключевое преимущество перед классическими обменами через ПланыОбмена — независимость от конкретных конфигураций. Например, выгрузка номенклатуры из 1С:УТ 11 в 1С:БП 3.0 или во внешнюю CRM будет использовать один и тот же формат, но с разными правилами трансформации.

Изменять правила обмена приходится в следующих случаях:

• 🔄 Добавление новых полей. Например, в стандартной выгрузке товаров отсутствует реквизит "Сертификат соответствия", но он критичен для вашего бизнес-процесса.
• 🧹 Фильтрация данных. Нужно выгружать только активные номенклатурные позиции или контрагентов с определённым типом.
• 🔗 Сопоставление с внешними системами. Внешняя CRM ожидает поле "CustomerID" вместо стандартного "Код" из 1С.
• 📊 Трансформация данных. Преобразование дат в другой формат, объединение нескольких полей в одно или расчёт производных значений.
• ⚡ Оптимизация производительности. Исключение ненужных объектов из обмена для ускорения процесса.

⚠️ Внимание: Правила обмена в формате EnterpriseData могут различаться в зависимости от версии платформы 1С (8.3.20+ рекомендуется для полной поддержки всех возможностей). Перед началом работ проверьте совместимость в официальном реестре релизов.

Если ваша задача — одноразовая выгрузка данных, возможно, проще использовать ВыгрузкаДанныхXML или Запрос.Выгрузить(). Но для регулярных обменов с внешними системами (например, с МойСклад, Битрикс24 или OZON) универсальный формат остаётся оптимальным решением.

Способы изменения правил обмена: сравнение подходов

Существует три основных способа модификации правил обмена. Выбор зависит от задачи, квалификации специалиста и требований к поддерживаемости:

Например, если вам нужно добавить в выгрузку товаров поле "ВесБрутто", достаточно отредактировать правила в конфигураторе. А если требуется преобразовать иерархию номенклатуры в плоский список с путь вида "Категория → Подкатегория → Товар" — тут не обойтись без XSLT-трансформации.

Пошаговая инструкция: редактирование правил в конфигураторе

Рассмотрим самый распространённый сценарий — добавление нового поля в правила обмена через конфигуратор. Для примера возьмём выгрузку справочника "Номенклатура" и добавим в неё реквизит "АртикулПоставщика".

Шаг 1. Откройте правила обмена

Перейдите в конфигуратор, найдите объект ПравилаОбменаДанными.ИмяВашегоОбмена (обычно он находится в ветке "Общие → ПравилаОбменаДанными"). Откройте его на редактирование.

Шаг 2. Найдите узел для модификации

В дереве правил разверните ветку Справочники → Номенклатура. Здесь вы увидите список полей, которые выгружаются по умолчанию (например, Код, Наименование, Артикул).

Шаг 3. Добавьте новое поле

Кликните правой кнопкой по узлу Номенклатура и выберите Добавить → Поле. В открывшейся форме:

• Укажите Имя: АртикулПоставщика
• Выберите Тип значения: Строка
• В поле Источник укажите путь к реквизиту: Объект.АртикулПоставщика
• Отметьте флаг Выгружать если пустое, если нужно передавать поле даже при отсутствии значения.

Шаг 4. Сохраните и протестируйте

Сохраните изменения (Ctrl+S) и выполните тестовую выгрузку через Операции → Тестирование и исправление. Проверьте полученный XML-файл — в нём должно появиться новое поле:

<Номенклатура>
<Код>00000001</Код>
<Наименование>Стул офисный</Наименование>
<АртикулПоставщика>CHAIR-123</АртикулПоставщика>
</Номенклатура>

Дублирующиеся имена полей отсутствуют|

Тип данных поля соответствует источнику|

Поле добавлено в нужный узел (например, не в "Реквизиты", а в корень объекта)|

Указан корректный путь к источнику (проверьте через точку останова)-->

Если поле не появилось в выгрузке, проверьте:

• 🔍 Права доступа к реквизиту АртикулПоставщика (он должен быть доступен для чтения в правилах обмена).
• 📌 Наличие значения в тестовых данных (если поле пустое и флаг Выгружать если пустое не установлен, оно не попадёт в XML).
• 🔄 Версию правил обмена (в некоторых конфигурациях требуется обновление через Поддержка → Обновить конфигурацию).

Работа с XDTO: когда стандартных правил недостаточно

Если вам нужно не просто добавить поле, а преобразовать данные (например, объединить несколько полей, изменить формат даты или добавить вычисляемые значения), потребуется использовать XDTO-пакеты. Этот подход более сложный, но даёт полный контроль над структурой выгружаемых данных.

Пример задачи: при выгрузке документов "РеализацияТоваровУслуг" нужно добавить поле "СуммаНДСВключенно", которого нет в стандартной конфигурации, но оно рассчитывается как СуммаДокумента * СтавкаНДС / (1 + СтавкаНДС).

Шаги для создания XDTO-пакета:

1. Создайте новый XDTO-пакет
   

   В конфигураторе перейдите в Общие → XDTO-пакеты и добавьте новый объект. Укажите пространство имён (например, http://yourcompany.ru/ED1).

2. Опишите структуру данных
   

   Добавьте тип РеализацияТоваровУслуг и внутри него поле СуммаНДСВключенно с типом decimal.

3. Настройте связь с правилами обмена
   

   В правилах обмена укажите, что для документа "РеализацияТоваровУслуг" используется ваш XDTO-пакет вместо стандартного.

4. Реализуйте логику заполнения
   

   В модуле правил обмена добавьте обработчик ПриЗаписиОбъекта, где рассчитайте значение поля:

   Процедура ПриЗаписиОбъекта(Объект, Данные)
   Если ТипЗнч(Объект) = Тип("ДокументОбъект.РеализацияТоваровУслуг") Тогда
   СтавкаНДС = Объект.СтавкаНДС / 100;
   Данные.СуммаНДСВключенно = Окр(Объект.СуммаДокумента * СтавкаНДС / (1 + СтавкаНДС), 2);
   КонецЕсли;
   КонецПроцедуры

Важно: при использовании XDTO изменяется структура XML, поэтому внешняя система должна быть готова принимать данные в новом формате. Например, если ранее поле суммы НДС называлось <СуммаНДС>, а теперь <СуммаНДСВключенно>, потребуется обновить обработчик на стороне получателя.

Типичные ошибки и как их избежать

Даже опытные разработчики сталкиваются с проблемами при изменении правил обмена. Вот наиболее распространённые ошибки и способы их решения:

1. Циклические ссылки в данных

Симптом: при выгрузке возникает ошибка "Обнаружен цикл в графе объектов". Это происходит, когда два объекта ссылаются друг на друга (например, документ ссылается на контрагента, а контрагент — на этот же документ через историю изменений).

Решение: в правилах обмена установите ограничение на глубину выгрузки связанных объектов или исключите проблемные ссылки через параметр МаксимальнаяГлубина = 1.

2. Несовпадение типов данных

Симптом: внешняя система выдаёт ошибку при разборе XML, например "Ожидался тип Date, получен String". Это типично при выгрузке дат в нестандартном формате.

Решение: в правилах обмена явно укажите формат даты через атрибут ФорматДаты="ДФ=yyyy-MM-dd" или преобразуйте значение в обработчике ПриЗаписиОбъекта.

3. Потеря данных при обмене

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

Решение: проверьте:

• 📋 Флаги ВыгружатьЕслиПустое и ТолькоНеПомеченныеНаУдаление.
• 🔍 Права доступа к реквизитам (в правилах обмена может быть установлен фильтр по ролям).
• 📊 Наличие обработчика ПередЗаписьюОбъекта, который может отменять выгрузку.

4. Ошибки валидации XML

Симптом: при загрузке XML во внешнюю систему появляется сообщение о некорректной структуре (например, "Элемент 'Номенклатура' не закрыт").

Решение: проверьте XML на валидность с помощью онлайн-сервисов вроде XML Validation. Частая причина — неверное экранирование символов (например, & должно быть заменено на &).

⚠️ Внимание: При изменении правил обмена в типовых конфигурациях (например, 1С:ERP или 1С:УТ 11) всегда создавайте расширение вместо прямого редактирования объектов. Это сохранит возможность обновления конфигурации без потери ваших доработок.

Оптимизация правил обмена: советы для крупных баз

Если вы работаете с большими объёмами данных (десятки тысяч номенклатурных позиций или документов), стандартные правила обмена могут работать медленно. Вот несколько способов ускорить процесс:

1. Пакетная выгрузка

Вместо выгрузки всех объектов за раз разбивайте их на пакеты по 100–500 записей. Это снизит нагрузку на сервер и позволит возобновить обмен с последней успешной партии при сбое. В правилах обмена это настраивается через параметр РазмерПакетов.

2. Выборочная выгрузка полей

Исключите из обмена поля, которые не используются внешней системой. Например, если в справочнике "Контрагенты" 50 реквизитов, а нужны только 5 — оставьте только их. Это сократит размер XML и время обработки.

3. Кэширование часто используемых данных

Если в правилах обмена есть сложные расчёты (например, остатки товаров на складах), кэшируйте их результаты в временных таблицах. Пример:

Перем мТоварыОстатки;

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

4. Асинхронный обмен

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

Примеры реальных доработок: кейсы из практики

Разберём несколько практических задач, с которыми сталкиваются компании при настройке обмена.

Кейс 1: Выгрузка дополнительных реквизитов в МойСклад

1. В правилах обмена добавьте новые поля СтранаПроисхождения и Сертификат.
2. Настройте соответствие типов: в МойСклад эти поля ожидаются как строки.
3. Проверьте, что реквизиты заполнены в 1С (используйте отчёт АнализЗаполненностиРеквизитов).

Процедура ПриЗаписиОбъекта(Объект, Данные)
Если ТипЗнч(Объект) = Тип("СправочникОбъект.Контрагенты") Тогда
Адрес = СтрШаблон("%1, %2, %3",
Объект.АдресУлица,
Объект.АдресДом,
Объект.АдресГород);
Данные.АдресПолный = Адрес;
КонецЕсли;
КонецПроцедуры

Процедура ПриОтбореОбъекта(Объект, Отбор)
Если ТипЗнч(Объект) = Тип("ДокументОбъект.ЗаказПокупателя") Тогда
Отбор.Вставить("Статус", Объект.Статус = Перечисление.СтатусыЗаказов.Подтвержден);
КонецЕсли;
КонецПроцедуры

XML = Новый ЧтениеXML;
XML.ОткрытьФайл("C:\temp\export.xml");
JSON = Новый ЗаписьJSON;
JSON.ОткрытьФайл("C:\temp\export.json");
// Далее рекурсивный обход XML и запись в JSON
// (реализация зависит от структуры данных)