К статье
Практический материал

Администрирование · 12 мин

Как загрузить XML-файл в 1С 8.3

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

XML — основной формат обмена данными между информационными базами 1С, а также между 1С и внешними системами: банками, ЭДО-операторами, сайтами, другими учётными программами. Задача «загрузить XML-файл» возникает при переносе справочников и документов между базами, при импорте выписок, при миграции с устаревших конфигураций и при восстановлении данных из выгрузок.

Способ загрузки зависит от того, как именно был сформирован файл. Выгрузка, созданная обработкой «Универсальный обмен данными в формате XML», загружается той же обработкой. Файл из плана обмена загружается через настройку синхронизации. Произвольный XML из сторонней системы потребует либо обработки с правилами конвертации, либо программной загрузки через встроенный язык.

Перед любыми манипуляциями сделайте резервную копию базы: загрузка изменяет данные, и откатить её штатными средствами нельзя. Для файловой базы достаточно скопировать каталог с файлом 1Cv8.1CD, для клиент-серверной — выполнить выгрузку через конфигуратор (Администрирование → Выгрузить информационную базу) или средствами СУБД.

Определяем, какой XML-файл нужно загрузить

Прежде чем выбирать инструмент, откройте файл в текстовом редакторе и посмотрите на его структуру. Первые строки обычно содержат корневой элемент, по которому можно понять происхождение файла. Это сэкономит время: не каждый XML можно загрузить «универсальной» обработкой.

Если корневой элемент содержит слова вроде «ФайлОбмена» или «V8Exch», файл создан типовой обработкой универсального обмена — загружайте его той же обработкой. Если видите «Message» с номером плана обмена — это сообщение синхронизации, его загружает механизм обмена данными. Файлы от банков и операторов ЭДО имеют собственные форматы (например, выписки в формате 1CClientBankExchange обычно вообще идут в текстовом виде, а не XML) и загружаются профильными средствами конфигурации.

Корневой элемент V8Exch/ФайлОбменаУниверсальная выгрузка

Загружайте обработкой «Универсальный обмен данными в формате XML»

Узел Message с номером обменаСообщение плана обмена

Загружайте через раздел синхронизации данных

Произвольная структура от сторонней системыВнешний формат

Нужны правила конвертации или программная загрузка

Загрузка через обработку «Универсальный обмен данными в формате XML»

Это самый распространённый сценарий переноса данных между базами на одинаковых или совместимых конфигурациях. Обработка входит в состав многих типовых решений, а актуальную версию можно взять из комплекта поставки конфигурации или с диска ИТС. Файл обработки называется примерно как «УниверсальныйОбменДаннымиXML.epf».

Откройте базу в режиме 1С:Предприятие под пользователем с полными правами. Далее: Файл → Открыть → укажите файл обработки. В открывшейся форме перейдите на закладку «Загрузка данных», в поле «Имя файла для загрузки» выберите ваш XML-файл и нажмите кнопку «Загрузить данные». Ход загрузки отображается индикатором, по завершении появится сообщение об окончании.

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

Порядок загрузки через универсальную обработку
  1. 1
    Сделайте резервную копию базы
  2. 2
    Откройте обработку: Файл → Открыть → УниверсальныйОбменДаннымиXML.epf
  3. 3
    Перейдите на закладку «Загрузка данных»
  4. 4
    Укажите путь к XML-файлу в поле «Имя файла для загрузки»
  5. 5
    Нажмите «Загрузить данные» и дождитесь завершения
  6. 6
    Проверьте загруженные данные в соответствующих списках справочников и документов

Загрузка через типовую синхронизацию данных (планы обмена)

Если XML-файл — это сообщение обмена между двумя типовыми базами (например, между «Бухгалтерией предприятия» и «Управлением торговлей»), загружать его нужно через встроенный механизм синхронизации. Ручная загрузка такого файла универсальной обработкой не сработает: структура сообщения другая.

Откройте раздел «Администрирование» → «Синхронизация данных» (в разных конфигурациях путь может отличаться: «НСИ и администрирование» → «Синхронизация данных»). Убедитесь, что включён флаг «Синхронизация данных», и выберите настроенный обмен. В форме обмена нажмите «Синхронизировать» или «Выполнить обмен данными», укажите файл сообщения, если обмен настроен через каталог или файл, и дождитесь выполнения.

При загрузке система проверит номер сообщения: если файл уже был загружен ранее, обмен пропустит его или выдаст предупреждение. Это защита от повторной загрузки, а не ошибка. Все коллизии и непринятые объекты фиксируются в регистрации результатов обмена — обязательно просмотрите этот журнал после загрузки.

Загрузка XML из сторонних систем: выписки, ЭДО, произвольные форматы

Банковские выписки, счета-фактуры от операторов ЭДО, каталоги товаров от поставщиков приходят в форматах, которые типовая универсальная обработка не поймёт. Для них используются профильные механизмы конфигурации: «Обмен с банками» для выписок, подсистема ЭДО для электронных документов, обработки загрузки прайсов для номенклатуры.

Например, для загрузки банковской выписки откройте журнал «Банковские выписки», нажмите «Загрузить» и укажите файл. Конфигурация сама определит формат, сопоставит контрагентов по ИНН и расчётным счетам и создаст документы. Для электронных документов откройте раздел ЭДО и выполните команду загрузки входящего документа из файла.

Когда нужна Конвертация данных

Если структура XML не совпадает ни с одним типовым форматом, потребуются правила обмена, созданные в конфигурации «Конвертация данных». Правила описывают, как узлы XML сопоставляются с объектами 1С: какие элементы становятся справочниками, какие — документами, как преобразуются реквизиты. Разработка правил — задача для специалиста, знакомого с этой конфигурацией.

Программная загрузка через встроенный язык

Разработчик может загрузить произвольный XML программно — через объекты ЧтениеXML, XDTO-пакеты или фабрику XDTO. Такой подход используют, когда формат фиксирован и загрузку нужно автоматизировать: например, ежедневный импорт каталога от поставщика по расписанию. Для разовой задачи ручная обработка обычно быстрее и безопаснее.

Сравнение способов загрузки XML

Универсальная обработка обмена

Подходит для выгрузок между базами 1С; не читает внешние форматы

Синхронизация данных

Подходит для штатного обмена между типовыми конфигурациями; требует настроенного плана обмена

Профильные обработки конфигурации

Подходят для банков, ЭДО, прайсов; ограничены конкретными форматами

Программная загрузка

Подходит для автоматизации нестандартных форматов; требует разработки и тестирования

Проверка результата после загрузки

Завершение загрузки без сообщений об ошибках ещё не гарантирует корректность данных. Обязательно выполните контрольные проверки, особенно если загружали документы, влияющие на учётные регистры.

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

Для документов, формирующих проводки, сверьте итоги: оборотно-сальдовую ведомость или отчёт по регистру до и после загрузки. Если загружали в копию базы, сравните итоги с базой-источником за тот же период. Расхождения указывают на потерянные объекты или ошибки правил.

Контрольные точки

Как проверить результат загрузки

Количество загруженных объектов
Норма

Совпадает с количеством в источнике

Тревожный признак

Часть объектов отсутствует или появились дубли

Состояние документов
Норма

Документы проведены, даты и суммы корректны

Тревожный признак

Документы не проведены, пустые реквизиты

Итоги по регистрам
Норма

Обороты совпадают с источником за период

Тревожный признак

Расхождения в суммах и остатках

Протокол загрузки
Норма

Нет ошибок и предупреждений

Тревожный признак

Есть записи об ошибках конвертации объектов

Типичные ошибки при загрузке и их устранение

Чаще всего загрузка прерывается сообщением «Ошибка формата потока» или «Ошибка разбора XML». Это означает, что файл повреждён, обрезан при копировании или сохранён не в той кодировке. Проверьте, что файл перекачан полностью (сравните размер с источником), и попробуйте открыть его в браузере — корректный XML отобразится в виде дерева.

Ошибка «Объект не найден» при загрузке документов говорит о том, что в базе-приёмнике отсутствуют связанные объекты: контрагенты, договоры, склады. Решение — сначала загрузить справочники, затем документы, либо выгружать данные со связанными объектами. В универсальной обработке для этого есть соответствующие настройки выгрузки.

Ещё одна частая проблема — дубли элементов справочников после повторной загрузки. Она возникает, когда поиск объектов настроен не по уникальному идентификатору, а по наименованию или коду, и эти поля различаются. Перед повторной загрузкой удалите некорректно созданные дубли и проверьте настройки поиска в правилах обмена.

Типичные ошибки
01
Загрузка без резервной копии — при ошибке правил данные приходится восстанавливать вручную
02
Загрузка сообщения плана обмена универсальной обработкой — файл не читается, время потрачено впустую
03
Игнорирование протокола ошибок — часть объектов молча не загружается
04
Повторная загрузка без очистки дублей — справочники задваиваются, отчёты искажаются
05
Загрузка документов без предварительной загрузки справочников — пустые ссылки и ошибки «Объект не найден»

Ограничения и меры безопасности

Загрузка больших файлов (сотни тысяч объектов) может занимать часы и требовать значительного объёма памяти. На файловых базах большие загрузки надёжнее выполнять монопольно, в нерабочее время. Если обработка позволяет, включайте режим отладки или транзакционную загрузку порциями — так проще локализовать сбой.

Учитывайте права доступа: пользователь, выполняющий загрузку, должен иметь права на создание и изменение всех загружаемых типов объектов. При загрузке под ограниченной учётной записью часть объектов не создастся, причём ошибки могут быть неочевидными. Также помните, что загружаемые документы могут изменить регламентированную отчётность — не загружайте документы в закрытые периоды без крайней необходимости.

Перед массовой загрузкой полезно сделать пробный прогон на маленькой выборке: выгрузите из источника 10–20 объектов, загрузите в копию базы и внимательно проверьте результат. Такой тест занимает минуты, но выявляет ошибки правил и настроек до того, как они затронут всю базу.
ПЗ
Практическое замечание

Частые вопросы о загрузке XML в 1С 8.3

Можно ли загрузить XML-файл без конфигуратора и дополнительных обработок?

Да, если файл соответствует типовому формату: синхронизация данных, обмен с банками и ЭДО работают штатно в режиме 1С:Предприятие. Для универсальной выгрузки достаточно открыть файл обработки через меню Файл → Открыть — изменять конфигурацию не требуется.

Что делать, если при загрузке появляется ошибка «Ошибка формата потока»?

Проверьте целостность файла: сравните его размер с оригиналом, перекачайте заново, откройте в браузере для проверки структуры. Если файл получен по почте или через мессенджер, убедитесь, что он не был сжат или изменён при передаче. Иногда помогает повторная выгрузка из базы-источника.

Как загрузить XML в базу с другой конфигурацией?

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

Можно ли отменить загрузку, если данные загрузились с ошибками?

Штатной кнопки «откатить загрузку» в 1С нет. Варианты: восстановить базу из резервной копии (самый надёжный способ), удалить загруженные объекты вручную или специальной обработкой, либо, если загрузка шла в одной транзакции и не завершилась, — изменения не зафиксируются. Именно поэтому копия перед загрузкой обязательна.

Почему после загрузки появились дубли контрагентов?

Поиск объектов при загрузке выполнялся не по уникальному идентификатору, а по реквизитам (ИНН, наименованию), которые в базах различаются. Удалите дубли, проверьте настройки поиска в правилах обмена и повторите загрузку. Для разовой чистки существуют типовые обработки поиска и удаления дублей.

Итог

Что важно запомнить

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