Как получить справочник из 1С: все способы от выгрузки до программного доступа

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

В этой статье мы разберем все актуальные способы получения справочников из 1С — от ручных методов через интерфейс программы до автоматизированных решений с использованием встроенного языка и REST API. Особое внимание уделим нюансам для разных версий платформы (1С:Предприятие 8.3 и 7.7), а также типичным ошибкам, которые возникают при выгрузке данных. Если вам нужно не просто посмотреть справочник, а экспортировать его для дальнейшей обработки — здесь вы найдете пошаговые инструкции с примерами кода и скриншотами.

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

1. Получение справочника через интерфейс 1С (ручные методы)

Самый простой способ — использовать встроенные инструменты 1С:Предприятие. Он подходит для разовых задач и не требует знаний программирования. Рассмотрим два основных варианта: просмотр непосредственно в базе и выгрузка в Excel/PDF.

Чтобы открыть справочник в интерфейсе программы:

• 📌 Перейдите в раздел меню, соответствующий нужному справочнику (например, Справочники → Номенклатура или Справочники → Контрагенты).
• 🔍 Используйте поле поиска вверху списка, если справочник содержит тысячи записей.
• 📄 Для просмотра детальной информации дважды кликните по строке или нажмите Enter.

Если требуется выгрузить данные в файл:

1. Откройте нужный справочник (например, Справочники → Организации).
2. Нажмите кнопку Ещё (или Действия в старых версиях) → Вывести список.
3. В открывшемся окне выберите формат: Excel, PDF, HTML или TXT.
4. Укажите путь для сохранения файла и нажмите Сохранить.

Ограничения ручного метода:

• ⚠️ Выгружаются только видимые в интерфейсе поля (скрытые реквизиты не экспортируются).
• ⚠️ В больших справочниках (более 10 000 записей) выгрузка может занять несколько минут.
• ⚠️ Нет возможности автоматизировать процесс — каждый раз приходится повторять действия вручную.

2. Выгрузка справочника через «Универсальный отчет»

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

Инструкция по настройке отчета:

1. Перейдите в Отчеты → Универсальный отчет (в некоторых конфигурациях путь может отличаться, например, Сервис → Универсальные отчеты).
2. В поле Объект выберите нужный справочник (например, Справочник.Номенклатура).
3. На вкладке Поля отметьте галочками все необходимые колонки (название, артикул, группа, цены и т.д.).
4. Примените фильтры, если нужно выгрузить только часть данных (например, номенклатуру определенной группы).
5. Нажмите Сформировать, затем Вывести в Excel или другой формат.

Пример фильтра для выгрузки только активной номенклатуры:

ПометкаУдаления = Ложь И ЭтоГруппа = Ложь

Преимущества универсального отчета:

• 🔹 Гибкая настройка состава данных (можно добавить даже расчетные поля).
• 🔹 Возможность сохранять шаблоны отчетов для повторного использования.
• 🔹 Поддержка выгрузки в Excel, ODS, XML и другие форматы.

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

Уточнить состав полей (включить все необходимые реквизиты)

Применить фильтры (например, по дате создания или группе)

Выбрать формат выгрузки (Excel рекомендуется для дальнейшей обработки)

-->

3. Программная выгрузка справочника (1С:Предприятие 8.3)

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

Пример кода для выгрузки справочника Номенклатура в файл CSV:

// Получаем данные справочника
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Номенклатура.Ссылка КАК Ссылка,
| Номенклатура.Наименование КАК Наименование,
| Номенклатура.Артикул КАК Артикул,
| Номенклатура.Группа КАК Группа
|ИЗ
| Справочник.Номенклатура КАК Номенклатура
|ГДЕ
| НЕ Номенклатура.ЭтоГруппа
| И НЕ Номенклатура.ПометкаУдаления";

Результат = Запрос.Выполнить;
Выборка = Результат.Выбрать;

// Создаем файл CSV
ИмяФайла ="C:\Temp\Номенклатура.csv";
Текст = Новый ЗаписьТекста(ИмяФайла, КодировкаТекста.UTF8, Истина);

// Записываем заголовки
Текст.ЗаписатьСтроку("Ссылка;Наименование;Артикул;Группа");

// Записываем данные
Пока Выборка.Следующий Цикл
Текст.ЗаписатьСтроку(СтрШаблон("%1;%2;%3;%4",
Выборка.Ссылка.УникальныйИдентификатор,
Выборка.Наименование,
Выборка.Артикул,
Выборка.Группа.Наименование));
КонецЦикла;

Текст.Закрыть;
Сообщить("Выгрузка завершена:" + ИмяФайла);

Где разместить этот код:

• 🖥️ В конфигураторе: создайте внешнюю обработку или добавьте код в модуль объекта.
• 📄 В пользовательском режиме: используйте Отладчик (клавиша F5 в конфигураторе) или создайте Внешнюю обработку и подключите ее через Файл → Открыть.

Важно: при выгрузке больших справочников (более 50 000 записей) разбейте запрос на части с помощью параметра ПАКЕТНЫЙ или используйте Позиционирование, чтобы избежать таймаута.

4. Обмен данными через XML (универсальный формат)

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

Пошаговая инструкция:

1. Откройте конфигуратор (1С:Предприятие в режиме Конфигуратор).
2. Перейдите в Администрирование → Обмен данными → Универсальный обмен данными в формате XML.
3. Нажмите Выгрузить данные и выберите нужный справочник (например, Контрагенты).
4. Укажите путь для сохранения файла (расширение .xml).
5. Запустите выгрузку кнопкой Выполнить.

Пример структуры полученного XML-файла для справочника Контрагенты:

<?xml version="1.0" encoding="utf-8"?>
<Документ>
<Контрагенты>
<Контрагент Ссылка="123e4567-e89b-12d3-a456-426614174000">
<Наименование>ООО"Ромашка"</Наименование>
<ИНН>7701234567</ИНН>
<КПП>770101001</КПП>
</Контрагент>
<!-- Другие записи -->
</Контрагенты>
</Документ>

Преимущества выгрузки в XML:

5. Автоматизированный обмен через REST API (для 1С:Предприятие 8.3.20+)

С появлением REST API в 1С:Предприятие 8.3.20 появилась возможность получать данные справочников по HTTP-запросам. Это удобно для интеграции с веб-сервисами, CRM-системами или мобильными приложениями.

Пример запроса для получения списка номенклатуры:

GET /hs/exchange/rest/Справочник_Номенклатура?$top=100
Host: ваш-сервер:порт
Authorization: Basic base64-кодированный-логин-пароль

Ответ сервера будет в формате JSON:

{
"value": [
{
"Ref_Key":"123e4567-e89b-12d3-a456-426614174000",
"DeletionMark": false,
"Description":"Стул офисный'Эрго'",
"Article":"ART-001",
"Parent_Key":"00000000-0000-0000-0000-000000000000"
},
// Другие записи
]
}

Как настроить REST-сервис в 1С:

1. В конфигураторе откройте Администрирование → Публикация на веб-сервере.
2. Установите флажок Опубликовать REST-сервис и укажите путь (например, /hs/exchange/rest).
3. Настройте аутентификацию (обычно используется Basic Auth или OAuth 2.0).
4. Перезапустите веб-сервер (Apache или IIS).

Пример скрипта на Python для автоматической выгрузки справочника через REST API:

import requests
import base64

Кодируем логин и пароль
auth = base64.b64encode(b"admin:password").decode("ascii")

Запрашиваем данные
url ="http://localhost:8080/hs/exchange/rest/Справочник_Контрагенты"
headers = {"Authorization": f"Basic {auth}"}
response = requests.get(url, headers=headers)

Сохраняем в файл
with open("контрагенты.json","w", encoding="utf-8") as f:
f.write(response.text)

6. Выгрузка через внешние обработки и расширения

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

• 📊 Выгрузка справочника с дополнительными расчетными полями.
• 🔄 Синхронизация с Google Sheets или Yandex Диском.
• 📦 Архивация данных с историей изменений.

Где взять готовые решения:

Пример подключения внешней обработки:

1. Скачайте файл обработки (расширение .epf или .erf).
2. В 1С перейдите в Файл → Открыть и выберите скачанный файл.
3. Следуйте инструкциям обработки (обычно нужно указать справочник и путь для сохранения).

7. Особенности работы со справочниками в 1С:Предприятие 7.7

Если вы работаете со старой версией 1С:Предприятие 7.7, то многие современные методы (например, REST API или универсальный отчет) недоступны. Однако есть альтернативные способы:

Способы выгрузки в 1С 7.7:

• 📑 Текстовый файл (TXT/CSV): через встроенный механизм Выгрузка данных в меню Сервис.
• 📥 DBF-файлы: используйте обработку ВыгрузкаВDBF.ert (поставляется с дистрибутивом).
• 🔌 COM-соединение: для автоматизации из внешних программ (например, VBA в Excel).

Процедура ВыгрузитьВDBF
Если Не ВыбратьСправочник("Номенклатура",, Спр) Тогда
Прервать;
КонецЕсли;

ИмяФайла ="C:\Temp\Номенклатура.dbf";
Если ВыгрузитьДанные(Спр, ИмяФайла) = 1 Тогда
Сообщить("Выгрузка завершена:" + ИмяФайла);
Иначе
Сообщить("Ошибка выгрузки!");
КонецЕсли;
КонецПроцедуры

Запрос.ПакетныйРежим = Истина;

Текст = Новый ЗаписьТекста(ИмяФайла, КодировкаТекста.UTF8);

ВЫБРАТЬ
ЖурналДокументов.Дата,
ЖурналДокументов.Пользователь,
ЖурналДокументов.Событие,
ЖурналДокументов.ПредставлениеОбъекта
ИЗ
РегистрСведений.ЖурналРегистрации КАК ЖурналДокументов
ГДЕ
ЖурналДокументов.Объект = ВЫБРАТЬ Справочник.Номенклатура.Ссылка

Картинка = Выборка.Картинка.Получить;
Картинка.Записать("C:\Temp\image.jpg");

Таблица = ПолучитьДанныеИзExcel("C:\Temp\цены.xlsx");
Для Каждого Строка Из Таблица Цикл
Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию(Строка.Наименование);
Если Номенклатура <> Неопределено Тогда
Номенклатура.Цена = Строка.Цена;
Номенклатура.Записать;
КонецЕсли;
КонецЦикла;