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

Другое · 6 мин

Как создать XML-файл для 1С

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

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

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

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

Когда XML-файл нужен для 1С

Файл нужен, когда данные поступают из интернет-магазина, логистической службы или сторонней программы, а в 1С нет прямого подключения. Также XML применяется для выгрузки отчётов, прайсов и каталогов в системы контрагентов.

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

Структура и кодировка: что проверять перед созданием

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

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

Выгрузка из 1С против создания вручную

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

Способы создания файла: вручную, из 1С, внешней программой

Создать файл можно в текстовом редакторе, сохранив с нужной кодировкой и расширением xml. Важно не использовать форматированный редактор, который добавляет скрытую разметку.

Из 1С файл формирует механизм обмена данными или отчёт, настроенный под схему контрагента. Это предпочтительный способ для регулярных выгрузок, так как программа сама следит за порядком элементов.

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

Порядок действий
  1. 1
    Уточните схему и кодировку приёмной базы
  2. 2
    Соберите необходимые реквизиты
  3. 3
    Сформируйте файл в подходящем редакторе или через 1С
  4. 4
    Проверьте файл на копии базы
  5. 5
    Загрузите в рабочую базу после резервного копирования
СпособКогда подходитОграничение
Вручную в текстовом редактореРазовый файл, проверка структурыЛегко допустить опечатку, не масштабируется
Встроенная выгрузка из 1СРегулярный обмен по схеме конфигурацииТребует доступа к настройкам обмена
Внешняя программа или скриптСбор данных из нескольких источниковНужна настройка генерации и передачи файла

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

Пошаговая проверка перед загрузкой в 1С

Сначала откройте файл на копии базы или в тестовой компании. Запустите импорт по инструкции конфигурации и посмотрите отчёт о загрузке: сколько объектов обработано, а сколько отклонено.

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

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

Отчёт об импорте
Норма

Ошибок разбора нет, данные добавлены

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

Есть отклонённые строки или сообщения о кодировке

Справочники после загрузки
Норма

Нет дублей и некорректных значений

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

Появились пустые или искажённые реквизиты

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

Ограничения, риски и альтернативы

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

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

Не загружайте проверяемый файл напрямую в рабочую базу без резервной копии. Ошибка в импорте может изменить остатки, цены или контрагентов, и восстановление потребует времени.

Типичные ошибки
01
Неверная кодировка или наличие BOM ломает кириллицу и разбор файла
02
Отсутствие обязательных реквизитов или нарушение порядка элементов приводит к отказу импорта

Частые ошибки и как их исправить

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

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

Итог

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

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

Как узнать, какая кодировка нужна для 1С?

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

Мож