Работа с XML-файлами в 1С:Предприятие — одна из самых востребованных задач при интеграции с внешними системами, обмене данными между базами или загрузке выписок из банков. Несмотря на кажущуюся сложность, разобрать XML в 1С можно даже без глубоких знаний программирования, если понимать основные принципы и использовать встроенные инструменты платформы.

В этой статье мы подробно разберём все этапы работы: от загрузки файла до извлечения нужных данных, рассмотрим типичные ошибки (например, Ошибка при чтении XML или Несоответствие структуры) и покажем готовые примеры кода для 1С 8.3. Особое внимание уделим практическим нюансам, которые экономят часы debugging’а: обработке пространств имён, валидации структуры и оптимизации производительности при работе с большими файлами.

Независимо от того, нужно ли вам разобрать выписку из Сбербанка, загрузить прайс-лист поставщика или интегрироваться с ГИС Меркурий, эта инструкция поможет избежать распространённых ошибок и ускорить разработку.

1. Подготовка: какие инструменты нужны для работы с XML в 1С

Прежде чем приступать к разбору XML, убедитесь, что в вашей конфигурации доступны необходимые объекты и библиотеки. В 1С:Предприятие 8.3 для работы с XML используются:

  • 📁 Объект ЧтениеXML — основной инструмент для посимвольного чтения файла. Подходит для обработки больших документов (от 10 МБ) без загрузки в память.
  • 🔄 Объект ЗаписьXML — используется для формирования XML (обратная задача). В этой статье не рассматривается, но полезно знать для двухстороннего обмена.
  • 📄 Объект DOMДокумент — загружает весь XML в память как дерево объектов. Удобен для небольших файлов (до 50 МБ), но может вызывать ошибки переполнения памяти.
  • 🔍 XDTO-пакеты — продвинутый механизм для работы со схемой XML (XSD). Требует предварительной настройки, но обеспечивает строгую типизацию данных.

Для большинства задач достаточно ЧтениеXML или DOMДокумент. Выбор зависит от размера файла и требований к производительности. Например, при разборе выписки из Тинькофф Банка (обычно до 1 МБ) удобнее использовать DOMДокумент, а для обработки прайс-листа с 50 000 позиций — ЧтениеXML.

⚠️ Внимание: Если вы работаете с XML, содержащим пространства имён (атрибуты вида xmlns:ns1="..."), использование DOMДокумент без учёта пространств имён приведёт к ошибкам доступа к узлам. В этом случае потребуется явное указание префиксов.
📊 Какой объект вы чаще используете для разбора XML в 1С?
ЧтениеXML
DOMДокумент
XDTO-пакеты
Другой вариант

2. Загрузка XML-файла в 1С: способы и типичные ошибки

Перед разбором XML его нужно загрузить в систему. В 1С есть несколько способов:

  1. Через диалог выбора файла — подходит для ручной загрузки: 
    ПутьКФайлу = ПолучитьИмяФайла("Выберите XML-файл", "", "XML-файлы|*.xml");

    Если ПутьКФайлу = "" Тогда
    

    Предупреждение("Файл не выбран!");
    

    Возврат;
    

    КонецЕсли;

  2. Из временного хранилища — если файл пришёл по почте или через HTTP-запрос: 
    ДвоичныеДанные = ПолучаемФайлИзВременногоХранилища(Идентификатор);

    ДвоичныеДанные.Записать(ПутьКФайлу);

  3. Прямо из строки — если XML пришёл в виде текста (например, из ответа веб-сервиса): 
    ТекстXML = ПолучаемXMLИзОтветаСервера();

    ЧтениеXML = Новый ЧтениеXML;
    

    ЧтениеXML.УстановитьСтроку(ТекстXML);

Самая распространённая ошибка на этом этапе — Ошибка при открытии файла. Она возникает, если:

  • 🔒 У пользователя нет прав на чтение файла (проверьте разрешения в ОС).
  • 📉 Файл повреждён или не является валидным XML (откройте его в блокноте и проверьте первую строку — должна быть декларация <?xml version="1.0"?>).
  • 🚫 Путь к файлу содержит кириллические символы без кодировки UTF-8 (используйте СокрЛП(ПутьКФайлу) для удаления пробелов).
ТекстXML = Строка(ДвоичныеДанные.ПолучитьТекст("windows-1251"));
-->

3. Разбор XML с помощью ЧтениеXML: пошаговая инструкция

Объект ЧтениеXML подходит для последовательного чтения XML-документа. Он не загружает файл целиком в память, что критично для больших файлов. Рассмотрим пример разбора выписки банка:

Процедура РазобратьXMLЧтение(ПутьКФайлу)

ЧтениеXML = Новый ЧтениеXML;


ЧтениеXML.ОткрытьФайл(ПутьКФайлу);



Пока ЧтениеXML.Прочитать() Цикл


ТипУзла = ЧтениеXML.ТипУзла;



Если ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда


ИмяЭлемента = ЧтениеXML.Имя;


Если ИмяЭлемента = "Документ" Тогда


// Обрабатываем начало документа


НомерДокумента = ЧтениеXML.ЗначениеАтрибута("Номер");


КонецЕсли;



Если ИмяЭлемента = "Сумма" Тогда


// Чтение значения элемента


ЧтениеXML.Прочитать();


Сумма = ЧтениеXML.Значение;


КонецЕсли;


КонецЕсли;



Если ТипУзла = ТипУзлаXML.КонецЭлемента Тогда


ИмяЭлемента = ЧтениеXML.Имя;


Если ИмяЭлемента = "Документ" Тогда


// Сохраняем данные в базу


СохранитьДокументВБазу(НомерДокумента, Сумма);


КонецЕсли;


КонецЕсли;


КонецЦикла;



ЧтениеXML.Закрыть();


КонецПроцедуры

Ключевые моменты:

  • 🔄 Цикл Пока ЧтениеXML.Прочитать() перемещает "курсор" по узлам XML.
  • 📌 ТипУзлаXML может быть: НачалоЭлемента, КонецЭлемента, Текст, Атрибут и др.
  • 🔍 Для чтения атрибутов используйте ЧтениеXML.ЗначениеАтрибута("ИмяАтрибута").
  • ⚡ Для чтения значения элемента после НачалоЭлемента нужно вызвать ЧтениеXML.Прочитать() ещё раз.

Убедиться, что файл существует и доступен для чтения|Проверьте кодировку файла (UTF-8 или Windows-1251)|Создайте обработчик для каждого типа узла (НачалоЭлемента, Текст и т.д.)|Подготовьте структуру для хранения извлечённых данных-->

4. Разбор XML с помощью DOMДокумент: когда и как использовать

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

Процедура РазобратьXMLDOM(ПутьКФайлу)

DOM = Новый DOMДокумент;


DOM.Загрузить(ПутьКФайлу);



// Получаем корневой элемент


Корень = DOM.ДокументЭлемент;



// Ищем все элементы "Товар"


СписокТоваров = Корень.ПолучитьЭлементыПоТегу("Товар");



Для Каждого Товар Из СписокТоваров Цикл


Артикул = Товар.ПолучитьАтрибут("Артикул");


Наименование = Товар.ПолучитьЭлементыПоТегу("Наименование").Узел(0).Текст;


Цена = Товар.ПолучитьЭлементыПоТегу("Цена").Узел(0).Текст;



// Сохраняем в справочник номенклатуры


СохранитьТоварВБазу(Артикул, Наименование, Цена);


КонецЦикла;


КонецПроцедуры

Преимущества DOMДокумент:

  • 🌳 Удобная навигация по дереву узлов (методы ПолучитьЭлементыПоТегу, РодительскийУзел).
  • 🔄 Возможность модифицировать XML и сохранять обратно (DOM.Сохранить()).
  • 📌 Поддержка XPath-запросов для сложных выборок (требует подключения библиотеки MSXML).
⚠️ Внимание: При работе с DOMДокумент в 1С:Предприятие 8.3.20+ может возникать ошибка "Недостаточно памяти" при загрузке файлов больше 50 МБ. В этом случае используйте ЧтениеXML или разбивайте файл на части.
Как ускорить разбор больших XML через DOMДокумент?

Используйте метод DOM.УстановитьАсинхронныйРежим(Истина) перед загрузкой файла. Это позволит не блокировать интерфейс 1С во время parsing’а. Однако учтите, что в асинхронном режиме нельзя сразу обращаться к узлам — нужно дождаться события ПриЗавершенииЗагрузки.

5. Работа с пространствами имён в XML

Многие XML-файлы (например, из ФНС, ГИС Меркурий или ЭДО-операторов) содержат пространства имён (namespaces). Их игнорирование приводит к ошибкам вида "Узел не найден". Рассмотрим, как правильно обрабатывать такой XML:

Пример файла с пространством имён:

<ns1:Документ xmlns:ns1="http://example.com/schema">

<ns1:Сумма>1000</ns1:Сумма>


</ns1:Документ>

Для работы с ним через DOMДокумент:

DOM = Новый DOMДокумент;

DOM.Загрузить(ПутьКФайлу);



// Регистрируем пространство имён


DOM.ПространстваИмен.Добавить("ns1", "http://example.com/schema");



// Ищем узел с учётом пространства имён


СуммаУзел = DOM.ДокументЭлемент.ПолучитьЭлементыПоТегуNS("http://example.com/schema", "Сумма").Узел(0);


Сумма = СуммаУзел.Текст;

Ключевые правила:

  • 🔖 Пространство имён обязательно регистрировать через DOM.ПространстваИмен.Добавить().
  • 🔍 Для поиска узлов используйте ПолучитьЭлементыПоТегуNS() вместо ПолучитьЭлементыПоТегу().
  • 📌 Префикс (ns1:) в коде указывать не нужно — только URI пространства имён.
Проблема Причина Решение
Ошибка "Узел не найден" Не зарегистрировано пространство имён Добавьте DOM.ПространстваИмен.Добавить()
Ошибка "Неверный формат XML" Файл содержит неэкранированные символы (<, >, &) Используйте СтрЗаменить() для экранирования
Медленный разбор больших файлов Используется DOMДокумент вместо ЧтениеXML Перепишите код с использованием ЧтениеXML
Не читаются атрибуты узлов Атрибуты относятся к пространству имён Используйте ПолучитьАтрибутNS()

6. Обработка ошибок и отладка разбора XML

Даже в правильно написанном коде могут возникать ошибки из-за несоответствия структуры XML ожиданиям. Рассмотрим типичные сценарии и способы их обработки:

1. Ошибка чтения файла:

Попытка

ЧтениеXML.ОткрытьФайл(ПутьКФайлу);


Исключение


Сообщить("Ошибка открытия файла: " + ОписаниеОшибки());


Возврат;


КонецПопытки;

2. Неожиданная структура XML:

Если ЧтениеXML.Имя <> "ОжидаемыйЭлемент" Тогда

ЗаписатьВЛог("Неверная структура XML: найден элемент " + ЧтениеXML.Имя);


Прервать;


КонецЕсли;

3. Пустые или некорректные значения:

Если НЕ ЗначениеЗаполнено(Сумма) Или НЕ Число(Сумма) Тогда

Сообщить("Ошибка: некорректное значение суммы - " + Сумма);


Продолжить;


КонецЕсли;

💡

Всегда проверяйте критичные данные на корректность после разбора XML. Например, если вы загружаете платежи из банка, убедитесь, что сумма — это число, а дата соответствует формату. Это предотвратит ошибки при записи в базу.

Для отладки используйте:

  • 📝 Журнал регистрации: записывайте ключевые события (начало/конец разбора, найденные узлы).
  • 🔍 Просмотр XML в браузере: откройте файл в Chrome или Notepad++ с подсветкой синтаксиса.
  • 🛠 Тестовые данные: перед обработкой реальных файлов протестируйте код на небольшом XML с известной структурой.

7. Оптимизация производительности при разборе больших XML

Если вам нужно разобрать XML размером от 100 МБ и более, стандартные методы могут работать слишком медленно или вызывать ошибки памяти. Вот способы оптимизации:

1. Используйте ЧтениеXML вместо DOMДокумент:

Как показано ранее, ЧтениеXML не загружает файл целиком, что критично для больших документов.

2. Разбивайте обработку на части:

Если XML содержит тысячи записей (например, прайс-лист), обрабатывайте их пакетами по 100–200 штук, с сохранением промежуточных результатов:

Счетчик = 0;

Пока ЧтениеXML.Прочитать() Цикл


// ... обработка узла ...


Счетчик = Счетчик + 1;


Если Счетчик >= 200 Тогда


СохранитьПакетДанных();


Счетчик = 0;


КонецЕсли;


КонецЦикла;

3. Отключайте ненужную валидацию:

По умолчанию 1С проверяет XML на валидность, что замедляет разбор. Если структура файла доверенная, отключите проверку:

ЧтениеXML.ОтключитьПроверку = Истина;

4. Используйте XDTO для сложных схем:

Если XML имеет жёсткую структуру (например, УПД или счета-фактуры в формате ФНС), настройте XDTO-пакет. Это ускорит разбор за счёт предварительного описания схемы.

⚠️ Внимание: При работе с очень большими XML (от 1 ГБ) рассмотрите возможность предварительной обработки файла внешними инструментами (например, Python или PowerShell), с последующей загрузкой результата в 1С. Это актуально для задач типа миграции данных или аналитики.

8. Примеры разбора реальных XML-файлов

Рассмотрим практические примеры разбора XML разных форматов.

Пример 1: Выписка из Сбербанка (формат 1С:Банк-Клиент)

Структура файла:

<Документ>

<Номер>12345</Номер>


<Дата>2026-05-20</Дата>


<Сумма>10000.00</Сумма>


<НазначениеПлатежа>Оплата по договору №5</НазначениеПлатежа>


</Документ>

Код для разбора:

Процедура РазобратьВыпискуСбербанка(ПутьКФайлу)

ЧтениеXML = Новый ЧтениеXML;


ЧтениеXML.ОткрытьФайл(ПутьКФайлу);



Пока ЧтениеXML.Прочитать() Цикл


Если ЧтениеXML.ТипУзла = ТипУзлаXML.НачалоЭлемента Тогда


Если ЧтениеXML.Имя = "Документ" Тогда


Номер = "";


Дата = "";


Сумма = 0;


КонецЕсли;


КонецЕсли;



Если ЧтениеXML.ТипУзла = ТипУзлаXML.Текст Тогда


ТекущийЭлемент = ЧтениеXML.ИмяРодителя;


Если ТекущийЭлемент = "Номер" Тогда Номер = ЧтениеXML.Значение; КонецЕсли;


Если ТекущийЭлемент = "Дата" Тогда Дата = ЧтениеXML.Значение; КонецЕсли;


Если ТекущийЭлемент = "Сумма" Тогда Сумма = Число(ЧтениеXML.Значение); КонецЕсли;


Если ТекущийЭлемент = "НазначениеПлатежа" Тогда


СохранитьПлатеж(Номер, Дата, Сумма, ЧтениеXML.Значение);


КонецЕсли;


КонецЕсли;


КонецЦикла;


ЧтениеXML.Закрыть();


КонецПроцедуры

Пример 2: Каталог товаров в формате CommerceML (1С:УТ)

Структура файла:

<КоммерческаяИнформация>

<Каталог>


<Товары>


<Товар>


<Ид>123</Ид>


<Наименование>Монитор 24"</Наименование>


<Цены>


<Цена>


<Представление>18000 руб.</Представление>


<Значение>18000</Значение>


</Цена>


</Цены>


</Товар>


</Товары>


</Каталог>


</КоммерческаяИнформация>

Код для разбора через DOMДокумент:

Процедура РазобратьCommerceML(ПутьКФайлу)

DOM = Новый DOMДокумент;


DOM.Загрузить(ПутьКФайлу);



Товары = DOM.ДокументЭлемент.ПолучитьЭлементыПоТегу("Товары").Узел(0).ПолучитьЭлементыПоТегу("Товар");



Для Каждого Товар Из Товары Цикл


Ид = Товар.ПолучитьЭлементыПоТегу("Ид").Узел(0).Текст;


Наименование = Товар.ПолучитьЭлементыПоТегу("Наименование").Узел(0).Текст;


Цена = Товар.ПолучитьЭлементыПоТегу("Значение").Узел(0).Текст;



СохранитьТоварВБазу(Ид, Наименование, Цена);


КонецЦикла;


КонецПроцедуры

FAQ: Частые вопросы по разбору XML в 1С

Как разобрать XML с вложенными пространствами имён?

Если XML содержит вложенные пространства имён (например, xmlns:ns1 внутри элемента с xmlns:ns2), зарегистрируйте их все через DOM.ПространстваИмен.Добавить(). При поиске узлов используйте полный URI пространства имён, а не префикс. Например:

DOM.ПространстваИмен.Добавить("ns1", "http://schema1");

DOM.ПространстваИмен.Добавить("ns2", "http://schema2");


Узел = DOM.ПолучитьЭлементыПоТегуNS("http://schema2", "Элемент");

Почему при разборе XML через DOMДокумент вылетает ошибка "Недостаточно памяти"?

Эта ошибка возникает, если:

  • Файл слишком большой (обычно >50 МБ). Решение: используйте ЧтениеXML.
  • В системе мало оперативной памяти. Решение: закройте другие приложения или увеличьте лимит памяти для 1С в параметрах запуска (/M).
  • XML содержит рекурсивные ссылки. Решение: проверьте файл на валидность через онлайн-валидатор.
Как преобразовать XML в JSON для дальнейшей обработки?

В 1С нет встроенного механизма конвертации XML в JSON, но можно:

  1. Разобрать XML в структуру данных 1С (массив или соответствие).
  2. Использовать функцию ЗаписатьJSON() для сохранения в JSON:
Данные = Новый Структура();

// ... заполняем данные из XML ...


ТекстJSON = ЗаписатьJSON(Данные);

Можно ли разобрать XML без программирования, через типовую обработку?

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

  • В 1С:Бухгалтерии: Банк и касса → Выписки → Загрузить из файла.
  • В 1С:УТ: Покупки → Поступление товаров → Загрузить из XML.

Если типовой механизм не подходит, используйте внешние обработки из каталога 1С:ИТС или Инфостарт.

Как проверить, что XML соответствует схеме XSD перед разбором?

Для валидации XML по схеме XSD в 1С:

  1. Загрузите XSD-схему через DOMДокумент.
  2. Используйте объект XDTOПакет для проверки:
XDTOПакет = XDTOФабрика.ПолучитьПакетПоСхеме(ПутьКXSD);

Если НЕ XDTOПакет.ПрочитатьXML(ПутьКXML) Тогда


Сообщить("XML не соответствует схеме!");


КонецЕсли;

Это актуально для обмена с госсистемами (например, ГИС Меркурий или Честный ЗНАК), где структура XML жёстко регламентирована.