Как подгрузить файл XLS в 1С

Загрузка данных из файлов Excel — одна из самых частых задач при работе с 1С: перенос номенклатуры от поставщика, импорт контрагентов, загрузка цен, остатков или выписки. Способ зависит от конфигурации: в типовых решениях на БСП (Библиотека стандартных подсистем) уже есть встроенные инструменты, а в старых или самописных конфигурациях файл придётся читать программно через COM-объект Excel или через табличный документ.

Прежде чем начинать, важно понять, куда именно вы загружаете данные: в справочник (номенклатура, контрагенты), в табличную часть документа или в регистр сведений (например, цены). От этого зависит выбор инструмента и структура файла. Также уточните формат файла: старый XLS (Excel 97–2003) и современный XLSX обрабатываются по-разному — стандартный механизм чтения табличных документов в 1С понимает оба, а COM-подключение к Excel требует установленного Microsoft Office на компьютере или сервере.

Ниже разобраны основные способы: типовая загрузка из табличного документа, универсальная обработка «Загрузка данных из табличного документа», чтение через табличный документ в коде и COM-соединение с Excel. Для каждого указаны условия применения, ограничения и типичные ошибки.

Подготовка файла к загрузке

Большинство ошибок при загрузке возникает не из-за 1С, а из-за самого файла. Уберите объединённые ячейки, многострочные шапки, промежуточные итоги и пустые строки внутри данных — каждая строка файла должна соответствовать одной записи, а первая строка должна содержать заголовки колонок или сразу данные.

Проверьте типы данных в колонках: числа должны быть числами, а не текстом с пробелами и неразрывными пробелами; даты — реальными датами Excel, а не строками вида «01.03.24». Артикулы и коды, начинающиеся с нуля, наоборот, лучше сохранить как текст, иначе ведущие нули потеряются. Сохраните файл в формате XLSX или XLS и запомните, на каком листе находятся данные.

Способ 1. Типовая обработка «Загрузка данных из табличного документа»

В конфигурациях на БСП (Управление торговлей 11, ERP, Комплексная автоматизация, Бухгалтерия 3.0 с подключаемыми обработками) есть штатный инструмент. В 1С:Бухгалтерии загрузка номенклатуры и контрагентов доступна прямо из формы списка справочника по кнопке «Загрузить из файла» — система сама предложит сопоставить колонки.

Если такой кнопки нет, используйте универсальную внешнюю обработку «Загрузка данных из табличного документа» (она входит в состав дистрибутивов БСП и доступна на диске ИТС). Откройте её через «Файл → Открыть», выберите режим загрузки (в справочник, в табличную часть или в регистр сведений), укажите вид объекта и откройте ваш XLS-файл.

1. 1
   Откройте обработку и выберите режим: загрузка в справочник, табличную часть или регистр сведений
2. 2
   Укажите конкретный объект метаданных, например справочник «Номенклатура»
3. 3
   На вкладке «Табличный документ» откройте XLS-файл и проверьте, что данные отобразились корректно
4. 4
   На вкладке «Настройка» сопоставьте номера колонок файла реквизитам объекта; для ключевых полей отметьте «Поле поиска»
5. 5
   Нажмите «Загрузить» и дождитесь отчёта о результатах
6. 6
   Откройте справочник и проверьте несколько записей вручную

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

Способ 2. Чтение файла программно через табличный документ

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

ТабДок = Новый ТабличныйДокумент;
ТабДок.Прочитать("C:\Данные\прайс.xlsx", СпособЧтенияЗначенийТабличногоДокумента.Значение);
Построитель = Новый ПостроительЗапроса;
Построитель.ИсточникДанных = Новый ОписаниеИсточникаДанных(ТабДок.Область(1, 1, ТабДок.ВысотаТаблицы, ТабДок.ШиринаТаблицы));
Построитель.Выполнить();
Выборка = Построитель.Результат.Выбрать();
Пока Выборка.Следующий() Цикл
	// Выборка.Артикул, Выборка.Цена — дальше ваша логика записи
КонецЦикла;

При таком чтении заголовки колонок файла становятся именами колонок результата, поэтому в файле должна быть строка с уникальными названиями без спецсимволов. Если заголовков нет, область начинайте со строки данных и обращайтесь к ячейкам напрямую через ТабДок.Область("R" + НомерСтроки + "C" + НомерКолонки).Текст. Учтите, что метод Прочитать() загружает весь лист целиком — для файлов на десятки тысяч строк это может занять заметное время и память.

Способ 3. Чтение через COM-объект Excel

Классический способ для файловых баз и толстого клиента — подключение к установленному Excel через COM. Он позволяет читать форматирование, формулы и конкретные листы, но имеет жёсткое ограничение: Microsoft Office должен быть установлен на том компьютере, где выполняется код. На 64-разрядном сервере 1С без Office этот способ не сработает.

Попытка
	Excel = Новый COMОбъект("Excel.Application");
Исключение
	Сообщить("Excel не установлен: " + ОписаниеОшибки());
	Возврат;
КонецПопытки;
Книга = Excel.Workbooks.Open("C:\Данные\прайс.xls");
Лист = Книга.Worksheets(1);
Для Ном = 2 По Лист.UsedRange.Rows.Count Цикл
	Артикул = СокрЛП(Лист.Cells(НомерСтроки, 1).Value);
КонецЦикла;
Excel.Quit();

Обязательно завершайте работу вызовом Excel.Quit() и освобождением объекта, иначе в памяти останутся «висячие» процессы EXCEL.EXE, которые со временем блокируют файлы и съедают ресурсы сервера. В цикле чтения по COM каждый вызов ячейки — отдельное обращение к процессу Excel, поэтому большие файлы так читаются медленно: для объёмов более нескольких тысяч строк предпочтительнее способ с табличным документом.

Загрузка в документы и регистры: особенности

При загрузке в табличную часть документа (например, «Поступление товаров» из накладной поставщика) типовая обработка БСП позволяет выбрать существующий документ или создать новый. Ключевой момент — поиск номенклатуры: сопоставляйте строки по артикулу или штрихкоду, а не по наименованию, потому что наименования у поставщика и в вашей базе почти всегда отличаются.

При загрузке в регистры сведений (цены номенклатуры, штрихкоды) помните про измерения и периодичность. Для периодического регистра цен нужна корректная колонка с датой; для регистра штрихкодов — контроль уникальности, иначе загрузка упадёт на дублирующихся значениях. Если регистр подчинён регистратору (как цены в УТ 11, которые устанавливаются документом «Установка цен»), правильнее создавать документ-регистратор, а не писать в регистр напрямую.

Проверка результата и типичные ошибки

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

Часто задаваемые вопросы