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

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

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

1. Базовый метод: Записать() и ЗаписатьСПроведением()

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

Основные методы:

📝 Записать() — сохраняет документ в базе без проведения. Подходит для черновиков или документов, которые требуют ручной доработки.
⚡ ЗаписатьСПроведением() — сохраняет и сразу проводит документ, формируя движения по регистрам. Используется чаще всего.
🔄 Провести() — только проводит уже сохранённый документ (без записи).

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

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

⚠️ Внимание: Метод ЗаписатьСПроведением() может вызвать ошибку, если в документе не заполнены обязательные реквизиты (например, Организация или Склад). Всегда проверяйте заполненность перед записью!

2. Объектная модель записи (XDM)

Для сложных сценариев, где нужно контролировать каждый этап записи, используется объектная модель XDM (eXtended Data Model). Она позволяет:

🔧 Разделять запись и проведение на отдельные шаги
📊 Контролировать формирование движений по регистрам
🔄 Откатывать изменения при ошибках

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

ДокОбъект = Документы.РеализацияТоваровУслуг.СоздатьДокумент();
ЗаписьXDM = ДокОбъект.ПолучитьОбъектЗаписи();

Если Не ЗаписьXDM.ПроверитьЗаполнение() Тогда
Сообщить("Не заполнены обязательные реквизиты!");
Возврат;
КонецЕсли;

ЗаписьXDM.Записать();
ЗаписьXDM.Провести();

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

💡

Используйте XDM, если вам нужно логировать этапы записи документа или обрабатывать ошибки на уровне отдельных движений по регистрам.

3. Запись документов в транзакции

При массовой записи документов (например, при загрузке из Excel или интеграции с CRM) критически важно обеспечить целостность данных. Для этого используются транзакции — механизм, который гарантирует, что либо все документы запишутся корректно, либо не запишется ни один.

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

НачатьТранзакцию();

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

ЗафиксироватьТранзакцию();
Исключение
ОтменитьТранзакцию();
Сообщить("Ошибка при записи: " + ОписаниеОшибки());
КонецПопытки;

⚠️ Внимание: Длинные транзакции (более 1000 документов) могут блокировать базу данных для других пользователей. Разбивайте пакеты на части по 200-300 документов.

Метод записи	Когда использовать	Преимущества	Недостатки
`Записать()`	Простые документы без движений	Максимальная простота	Не контролирует проводки
`ЗаписатьСПроведением()`	Стандартные документы с движениями	Автоматическое проведение	Может падать при ошибках в движениях
Объектная модель (XDM)	Сложная логика записи	Гибкий контроль каждого этапа	Более громоздкий код
Транзакционная запись	Пакетная обработка документов	Гарантия целостности данных	Может блокировать базу

4. Запись документов через API (REST, HTTP-сервисы)

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

🌐 HTTPСервис — для создания собственных веб-сервисов
🔌 WSСсылка — для работы с SOAP
📡 ИнтернетПочта — для обмена через email (устаревший метод)

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

Процедура ОбработатьЗапрос(Запрос) Экспорт
Если Запрос.Метод = "POST" Тогда
Данные = JSON.Прочитать(Запрос.Тело);
Док = Документы.ЗаказПокупателя.СоздатьДокумент();
Док.Номер = Данные.Номер;
Док.Дата = Данные.Дата;
Док.ЗаписатьСПроведением();
Возврат "OK";
КонецЕсли;
КонецПроцедуры

⚠️ Внимание: При работе с API всегда проверяйте права доступа! Используйте механизм ПользователиИнтернетПодключения, чтобы ограничить доступ к сервису.

Как защитить HTTP-сервис от несанкционированного доступа?

Для защиты HTTP-сервиса в 1С настройте аутентификацию через заголовки или токены. В модуле сервиса добавьте проверку:

Если Не Запрос.Заголовки.Найти("Authorization") = "Bearer ВашСекретныйТокен" Тогда
Возврат "403 Forbidden";
КонецЕсли;

Также ограничьте IP-адреса в настройках веб-сервера (Apache/Nginx).

5. Особенности записи документов с проводками

Документы, формирующие движения по регистрам (например, "Реализация товаров" или "Поступление на расчётный счёт"), требуют особого подхода. При их записи 1С автоматически:

📈 Проверяет корректность проводок (дебет = кредит)
🔢 Контролирует остатки по счетам
📝 Фиксирует изменения в регистрах накопления

Типичные ошибки при работе с проводками:

Несовпадение сумм в табличной части и шапке документа.
Отсутствие обязательных аналитик (например, СтатьяДвиженияДенежныхСредств).
Попытка провести документ с отрицательными остатками.

Чтобы избежать проблем, используйте ПроверитьЗаполнение() перед записью:

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

Заполнены все обязательные реквизиты|Суммы в табличной части совпадают с итогом|Есть остатки по счетам (для расходных документов)|Указаны все аналитики (статьи ДДС, подразделения)|Правильно заполнена валюта и курс (для валютных документов)-->

6. Массовая запись документов: оптимизация производительности

При записи сотен или тысяч документов (например, при миграции данных) стандартные методы могут работать слишком медленно. Для ускорения процесса:

⚡ Отключите проверку прав доступа: УстановитьПривилегированныйРежим(Истина);
📉 Отключите автоматическое проведение: сначала запишите все документы, затем проводите пакетом.
🔄 Используйте ОбменДанными.Загрузка для импорта из XML/JSON.

Пример оптимизированной массовой записи:

УстановитьПривилегированныйРежим(Истина);

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

// Проведение пакетом
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Ссылка ИЗ Документ.СчетФактураВыданный ГДЕ Проведен = ЛОЖЬ";
Результат = Запрос.Выполнить();

Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
Док = Выборка.Ссылка.ПолучитьОбъект();
Док.Провести();
КонецЦикла;

Такой подход ускоряет запись в 3-5 раз по сравнению со стандартным ЗаписатьСПроведением() для каждого документа.

💡

При массовой записи всегда делите процесс на этапы: 1) Запись документов, 2) Проведение, 3) Обновление связей. Это снижает нагрузку на базу и уменьшает риск ошибок.

7. Типичные ошибки и их решения

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

Ошибка	Причина	Решение
`Ошибка блокировки`	Документ заблокирован другим пользователем	Используйте `Попытка...Исключение` с повторным выполнением
`Недостаточно прав`	У пользователя нет прав на запись	Запускайте код в привилегированном режиме или настройте роли
`Нарушение уникальности номера`	Повторяющийся номер документа	Используйте `ПолучитьНовыйНомер()` или автонумерацию
`Ошибка проводок`	Несовпадение дебет/кредит	Проверяйте суммы перед записью с помощью `ПроверитьЗаполнение()`

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

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

ДокРеализация = Документы.РеализацияТоваровУслуг.СоздатьДокумент();
ДокРеализация.Записать();

ДокСчетФактура = Документы.СчетФактураВыданный.СоздатьДокумент();
ДокСчетФактура.Основание = ДокРеализация.Ссылка; // Устанавливаем связь!
ДокСчетФактура.ЗаписатьСПроведением();

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

Как записать документ без изменения даты и времени?

По умолчанию при программной записи документа поле Дата устанавливается в текущую дату. Чтобы сохранить оригинальную дату, явно укажите её перед записью:

Док.Дата = ИсходнаяДата; // Например, "01.01.2023 10:00:00"
Док.Записать();

Для точного контроля времени используйте Док.Время = ИсходноеВремя;.

Можно ли записать документ в закрытый период?

Да, но для этого нужно:

Иметь права на редактирование закрытых периодов (настраивается в ролях).
Использовать привилегированный режим: УстановитьПривилегированныйРежим(Истина);
Явно указать дату в закрытом периоде: Док.Дата = '31.12.2022';

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

Как отменить проведение документа программно?

Используйте метод ОтменитьПроведение():

Док = Документы.ПоступлениеТоваровУслуг.НайтиПоНомеру("ПТ-000123");
Док.ОтменитьПроведение();

Если нужно отменить проведение пакета документов, используйте запрос:

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Ссылка ИЗ Документ.ПоступлениеТоваровУслуг ГДЕ Проведен = ИСТИНА";
Результат = Запрос.Выполнить();

Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
Док = Выборка.Ссылка.ПолучитьОбъект();
Док.ОтменитьПроведение();
КонецЦикла;

Что делать, если документ не записывается из-за ошибки "Объект не найден"?

Эта ошибка возникает, когда:

Указан несуществующий справочник (например, Контрагент с неверным именем).
Неверно указан тип документа (опечатка в имени).
Документ удалён, но код пытается получить его объект.

Решение:

Проверьте существование объекта через Справочники.Контрагенты.НайтиПоНаименованию().
Используйте Попытка...Исключение для обработки ошибок.
Для удалённых документов используйте ПолучитьОбъектЕслиЕсть().

Как записать документ с уникальным номером в формате "АБВ-123"?

Для нестандартных номеров документов:

Отключите автонумерацию в настройках типа документа.
Явно укажите номер перед записью:

Док.Номер = "АБВ-123";
Док.Записать();

Чтобы избежать дублей, предварительно проверяйте существование документа с таким номером:

Если НЕ Док.НайтиПоНомеру("АБВ-123") = Неопределено Тогда
Сообщить("Документ с таким номером уже существует!");
Возврат;
КонецЕсли;

Программная запись документов в 1С: от базовых методов до автоматизации