Как выгрузить документ из 1С 8 в формате XML

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

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

Какие способы выгрузки XML существуют в 1С 8

Платформа 1С:Предприятие 8 предоставляет несколько независимых механизмов формирования XML-файлов. Первый — универсальный обмен данными по правилам конвертации, который сохраняет объект вместе со ссылочной структурой и подходит для переноса между базами. Второй — выгрузка электронных документов (счета-фактуры, УПД, накладные) по утверждённым форматам через подсистему обмена электронными документами. Третий — программная сериализация объекта средствами встроенного языка.

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

Выгрузка документа через универсальный обмен данными

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

1. 1
   Откройте обработку «Универсальный обмен данными в формате XML» и перейдите на закладку «Выгрузка данных».
2. 2
   Укажите файл правил обмена (для обмена между одинаковыми конфигурациями подойдут правила, сформированные конвертацией данных; для идентичных баз часто используют выгрузку без конвертации).
3. 3
   Задайте имя и путь файла выгрузки, например C:\Exchange\document.xml.
4. 4
   На закладке «Выгружаемые данные» отметьте нужный вид документа и установите отбор по конкретному документу (по ссылке, номеру и дате).
5. 5
   Нажмите «Выгрузить данные» и дождитесь сообщения об окончании выгрузки.
6. 6
   Откройте полученный файл в текстовом редакторе и убедитесь, что в нём присутствуют данные документа.

При выгрузке обратите внимание на флажок «Выгружать при необходимости» для связанных объектов: он подтягивает в файл справочники, на которые ссылается документ (контрагента, договор, номенклатуру). Без этих данных документ в базе-приёмнике может загрузиться с пустыми или битными ссылками. Однако чем шире состав выгружаемых по ссылкам объектов, тем больше размер файла и время выгрузки.

Выгрузка электронного документа по формату (УПД, счёт-фактура, накладная)

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

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

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

Программная выгрузка документа в XML

Когда стандартные средства не дают нужной структуры, файл формируют кодом на встроенном языке. Два базовых подхода: сериализация объекта средствами XDTO или платформенной записью объекта, либо ручное формирование XML через объект ЗаписьXML с явным указанием элементов и атрибутов.

Запись = Новый ЗаписьXML;
Запись.ОткрытьФайл("C:\Exchange\doc.xml", "UTF-8");
Запись.ЗаписатьОбъявлениеXML();
Запись.ЗаписатьНачалоЭлемента("Документ");
Запись.ЗаписатьАтрибут("Номер", Строка(ДокументОбъект.Номер));
Запись.ЗаписатьАтрибут("Дата", XMLСтрока(ДокументОбъект.Дата));
Запись.ЗаписатьКонецЭлемента();
Запись.Закрыть();

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

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

Факт создания файла ещё не означает корректную выгрузку. Минимальная проверка: открыть XML в браузере или текстовом редакторе и убедиться, что файл начинается с объявления XML, содержит ожидаемые элементы и не обрывается на середине. Обрыв файла обычно говорит о прерывании выгрузки по ошибке.

Для файлов по форматам ФНС или банков проверку выполняют не только визуально, но и средствами приёмной стороны: тестовыми версиями программ, проверочными сервисами либо загрузкой в тестовый контур. Несоответствие версии формата — одна из самых частых причин отказа при загрузке внешнего XML.

Типичные ошибки и ограничения

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

Частые вопросы