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

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

В этой статье разберём все актуальные способы создания документов через код: от классического встроенного языка до современных HTTP-сервисов и REST API. Особое внимание уделим типичным ошибкам, которые приводят к падению производительности или потере данных. Материал будет полезен как начинающим программистам 1С, так и опытным специалистам, ищущим оптимальные решения для конкретных задач.

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

1. Классический способ: встроенный язык 1С

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

• 📌 Создание нового объекта документа через Документы.ИмяДокумента.СоздатьДокумент()
• 🔧 Заполнение реквизитов и табличных частей
• 💾 Сохранение документа с проверкой заполнения (Записать() или Провести())
• 🔄 Обработка возможных ошибок (например, блокировка данных)

Пример кода для создания документа РеализацияТоваровУслуг:

Док = Документы.РеализацияТоваровУслуг.СоздатьДокумент();
Док.Дата = ТекущаяДата();
Док.Контрагент = Справочники.Контрагенты.НайтиПоНаименованию("ООО Ромашка");
Док.Склад = Справочники.Склады.ОсновнойСклад;

// Заполняем табличную часть "Товары"
СтрокаТоваров = Док.Товары.Добавить();
СтрокаТоваров.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Стул офисный");
СтрокаТоваров.Количество = 5;
СтрокаТоваров.Цена = 2500;
СтрокаТоваров.Сумма = СтрокаТоваров.Количество * СтрокаТоваров.Цена;

// Проверяем и проводим документ
Если Док.Провести() Тогда
Сообщить("Документ №" + Док.Номер + " успешно создан и проведён!");
Иначе
Сообщить("Ошибка при проведении: " + ОписаниеОшибки());
КонецЕсли;

⚠️ Внимание: При массовом создании документов (более 100 штук) всегда используйте НачатьТранзакцию() и ЗафиксироватьТранзакцию(), чтобы избежать блокировок базы данных. Иначе пользователи могут столкнуться с ошибками типа "Объект заблокирован другим пользователем".

Этот метод универсален, но имеет ограничения:

• ⏳ Работает только внутри сеанса 1С (не подходит для внешних систем)
• 🔒 Требует прав на создание и изменение документов
• 📊 Может тормозить при обработке больших объёмов данных (решение — пакетная обработка)

2. HTTP-сервисы: интеграция с внешними системами

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

Алгоритм настройки:

1. Создать HTTP-сервис в конфигураторе (Общие → HTTP-сервисы → Добавить)
2. Определить методы (например, СоздатьДокумент) и их параметры
3. Реализовать логику создания документа внутри метода
4. Опубликовать сервис на веб-сервере (Apache, IIS или встроенном веб-сервере 1С)

Пример метода HTTP-сервиса для создания Заказа покупателя:

Функция СоздатьЗаказПокупателя(Запрос) Экспорт
Параметры = JSON.Прочитать(Запрос.ТелоКакСтроку());

Док = Документы.ЗаказПокупателя.СоздатьДокумент();
Док.Дата = Параметры.Дата;
Док.Контрагент = Справочники.Контрагенты.НайтиПоКоду(Параметры.КодКонтрагента);

Для Каждого Товар Из Параметры.Товары Цикл
Строка = Док.Товары.Добавить();
Строка.Номенклатура = Справочники.Номенклатура.НайтиПоКоду(Товар.Код);
Строка.Количество = Товар.Количество;
КонецЦикла;

Док.Записать();
Возврат JSON.Записать(Док.Ссылка.УникальныйИдентификатор());
КонецФункции

Преимущества HTTP-сервисов:

• 🌐 Кросс-платформенность (работает с любыми системами, поддерживающими HTTP)
• 🔐 Возможность настройки аутентификации (Basic Auth, OAuth 2.0)
• 📦 Поддержка формата JSON, удобного для веб-приложений

⚠️ Внимание: При публикации HTTP-сервиса на веб-сервере убедитесь, что порт (обычно 80 или 443) открыт в брандмауэре. Также рекомендуется использовать HTTPS для защиты передаваемых данных (особенно если передаются пароли или финансовая информация).

3. REST API: современный подход к интеграции

Начиная с версии 1С:Предприятие 8.3.15, платформа поддерживает REST-интерфейсы — более гибкую альтернативу HTTP-сервисам. Они позволяют создавать документ через стандартные POST-запросы с передачей данных в формате JSON.

Основные отличия от HTTP-сервисов:

• 📍 Единая точка входа (/hs/rest/) для всех методов
• 🔄 Автоматическая сериализация/десериализация объектов
• 🛡️ Встроенная поддержка OAuth 2.0 для аутентификации
• 📊 Возможность генерации OpenAPI-спецификации (Swagger)

Пример запроса на создание документа ПоступлениеТоваров:

POST /hs/rest/ПоступлениеТоваров HTTP/1.1
Host: your-1c-server.ru
Content-Type: application/json
Authorization: Bearer ваш_токен

{
"Дата": "2026-05-20",
"Контрагент": {
"Ref": "7a1d4e8f-2c3b-4d5e-8f9a-1b2c3d4e5f6a"
},
"Склад": {
"Ref": "3b4c5d6e-7f8a-1b2c-3d4e-5f6a7b8c9d0e"
},
"Товары": [
{
"Номенклатура": {
"Ref": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d"
},
"Количество": 10,
"Цена": 1200.50
}
]
}

Для настройки REST-интерфейса в конфигураторе:

1. Перейдите в Общие → REST-интерфейсы → Добавить
2. Укажите имя интерфейса (например, ДокументыПоступления)
3. Создайте метод Post с параметром Тело типа Структура
4. Реализуйте логику создания документа в обработчике метода

⚠️ Внимание: При использовании REST API в облачных решениях (например, 1С:Fresh) учитывайте ограничения на количество запросов в минуту. Превышение лимита приводит к блокировке на 5–10 минут.

Установить последнюю версию платформы 1С (не ниже 8.3.15)

Настроить аутентификацию (OAuth 2.0 или Basic Auth)

Проверить открытие порта 443 для HTTPS

Сгенерировать SSL-сертификат для домена

Тестовый запрос через Postman-->

4. COM-соединение: работа с 1С из внешних приложений

Для интеграции с Windows-приложениями (например, написанными на C# или VBA) часто используется COM-соединение. Этот метод позволяет управлять 1С как внешним объектом через интерфейс V83.ComConnector.

Пример на C# для создания документа СчётНаОплатуПокупателю:

using V83;

var comConnector = new COMConnector();
dynamic app = comConnector.Connect("File=C:\\Bases\\Trade;Usr=Администратор;Pwd=12345");

// Создаём документ
dynamic doc = app.Documents.СчётНаОплатуПокупателю.CreateDocument();
doc.Дата = DateTime.Now;
doc.Контрагент = app.Catalogs.Контрагенты.FindByName("ООО Весна");

// Добавляем товар
dynamic item = doc.Товары.Add();
item.Номенклатура = app.Catalogs.Номенклатура.FindByName("Стол письменный");
item.Количество = 2;
item.Цена = 5000;

// Сохраняем и проводим
doc.Write();
doc.Post();

comConnector.Disconnect();

Преимущества COM-соединения:

• 🖥️ Полный контроль над сеансом 1С из внешней программы
• 🔄 Возможность работы с любыми объектами конфигурации
• 📂 Поддержка как файлового, так и клиент-серверного вариантов

Недостатки:

• 🪲 Нестабильность при длительных сеансах (может "зависнуть")
• 🐢 Медленнее, чем HTTP-сервисы или REST API
• 🔒 Требует установки 1С:Предприятие на машине с внешним приложением

Для отладки COM-соединений полезно использовать утилиту OLEView (входит в состав Windows SDK), которая позволяет просматривать доступные методы и свойства объектов 1С.

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

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

• 📄 XML (стандартные обработки 1С для обмена)
• 📱 JSON (удобен для веб-приложений)
• 🗃️ CSV/XLSX (для массовой загрузки из таблиц)

Пример загрузки документа ПриходныйКассовыйОрдер из JSON:

Процедура ЗагрузитьПриходныйОрдер(JSONСтрока)
Данные = JSON.Прочитать(JSONСтрока);
Док = Документы.ПриходныйКассовыйОрдер.СоздатьДокумент();

Док.Дата = Данные.Дата;
Док.Сумма = Данные.Сумма;
Док.Контрагент = Справочники.Контрагенты.НайтиПоНаименованию(Данные.Контрагент);
Док.СтатьяДвиженияДенежныхСредств = Справочники.СтатьиДвиженияДенежныхСредств.ПрочиеПоступления;

Док.Записать();
Док.Провести();
КонецПроцедуры

Для массовой загрузки рекомендуется:

• 📊 Использовать пакетную обработку (по 50–100 документов за раз)
• 🔄 Проверять дубли по уникальным реквизитам (например, номер + дата)
• 📌 Вести лог загрузки с указанием успешных и ошибочных записей

⚠️ Внимание: При импорте данных из XLSX всегда проверяйте формат ячеек. Например, даты в Excel могут интерпретироваться как числа (например, 44197 вместо 01.01.2021), что приведёт к ошибкам при загрузке в 1С.

6. Типовые ошибки и их решения

При программном создании документов разработчики часто сталкиваются с одними и теми же проблемами. Рассмотрим наиболее распространённые:

• 🔴 "Объект не найден" — возникает при попытке обратиться к несуществующему справочнику или документу. Решение: всегда проверяйте существование объекта через Справочники.Имя.НайтиПо...().
• 🔴 "Документ не проведён" — обычно связано с незаполненными обязательными реквизитами. Используйте Док.ЗаполнитьОбязательныеРеквизиты() перед проведением.
• 🔴 "Нарушение прав доступа" — проверьте права пользователя в ролях (Администрирование → Пользователи).
• 🔴 "Блокировка данных" — возникает при одновременном изменении одного объекта. Решение: используйте транзакции или повторы attempts.

Пример обработки ошибки блокировки:

Попытка
Док.Провести();
Исключение
Если Найти(ОписаниеОшибки(), "блокировка") > 0 Тогда
Пауза(1000); // Ждём 1 секунду
Попытка
Док.Провести();
Исключение
ЗаписатьЖурналРегистрации("Ошибка", УровеньЖурналаРегистрации.Ошибка,, ОписаниеОшибки());
КонецПопытки;
Иначе
ЗаписатьЖурналРегистрации("Ошибка", УровеньЖурналаРегистрации.Ошибка,, ОписаниеОшибки());
КонецЕсли;
КонецПопытки;

Для диагностики сложных ошибок полезно:

• 🔍 Включить режим отладки в конфигураторе (Сервис → Параметры → Отладка)
• 📝 Вести журнал регистрации (Администрирование → Журнал регистрации)
• 🛠️ Использовать точки останова в критичных местах кода

7. Оптимизация производительности

При массовом создании документов (тысячи записей) важно оптимизировать код, чтобы избежать зависаний и перегрузки сервера. Основные приёмы:

• 🚀 Пакетная обработка: разбивайте данные на порции по 100–200 документов.
• 🔄 Отключение проверок: временно отключайте регламентные задания и триггеры.
• 🗃️ Кэширование справочников: загружайте часто используемые справочники в память заранее.
• 📊 Минимизация транзакций: проводите документы пачками, а не по одному.

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

// 1. Кэшируем справочники
Контрагенты = Новый Соответствие();
Для Каждого Контрагент Из Справочники.Контрагенты Цикл
Контрагенты.Вставить(Контрагент.Наименование, Контрагент.Ссылка);
КонецЦикла;

// 2. Отключаем проверки
НачатьТранзакцию();
ПараметрыЗаписи = Новый ПараметрыЗаписиДокумента();
ПараметрыЗаписи.ПроверятьЗаполнение = Ложь;
ПараметрыЗаписи.ЗаписыватьДвижения = Ложь;

// 3. Массовое создание документов
Для Каждого Данные Из МассивДанных Цикл
Док = Документы.ЗаказПокупателя.СоздатьДокумент();
Док.Дата = Данные.Дата;
Док.Контрагент = Контрагенты[Данные.Контрагент];
Док.Записать(ПараметрыЗаписи);
КонецЦикла;

// 4. Проводим пакетом
Для Каждого Док Из Документы.ЗаказПокупателя.НайтиПомеченные() Цикл
Док.Провести();
КонецЦикла;
ЗафиксироватьТранзакцию();

Дополнительные советы по оптимизации:

• 📉 Избегайте вложенных циклов при заполнении табличных частей.
• 🗑️ Удаляйте ненужные объекты из памяти с помощью ОчиститьЗначение().
• 📈 Используйте фоновые задания для длительных операций.

⚠️ Внимание: При работе с большими объёмами данных (более 10 000 документов) рассмотрите возможность использования 1С:EDT (Eclipse Development Tools) для распараллеливания задач. Это инструмент для промышленной разработки, поддерживающий многопоточность.

FAQ: Частые вопросы по программному созданию документов

Док.Номер = Документы.ИмяДокумента.ПолучитьНовыйНомер(Док.Дата);

Док.Номер = Документы.ИмяДокумента.ПолучитьНовыйНомер();

Док.Дата = '2026-01-15'; // Дата в прошлом
Док.Записать();
Док.Провести(РежимПроведенияДокумента.Оперативный);

Если НЕ Док.Ссылка.Пустая() И Док.Проведен() Тогда
Сообщить("Документ успешно создан и проведён!");
Иначе
Сообщить("Ошибка: " + ОписаниеОшибки());
КонецЕсли;

POST /hs/mobile/create_document
Headers:
Authorization: Bearer ваш_токен
Content-Type: application/json

Body:
{
"type": "SalesOrder",
"date": "2026-05-20",
"customer": "ИП Иванов",
"items": [
{
"product": "Ноутбук",
"quantity": 1,
"price": 50000
}
]
}

ПараметрыПроведения = Новый ПараметрыПроведенияДокумента();
ПараметрыПроведения.РежимПроведения = РежимПроведенияДокумента.Оперативный;
ПараметрыПроведения.ВозвращатьДвижения = Истина;
Результат = Док.Провести(ПараметрыПроведения);
Если НЕ Результат Тогда
Сообщить("Ошибка проведения: " + Док.ПолноеПредставлениеДвижений());
КонецЕсли;