Как создать документ на основании другого документа в 1С программно
Программное создание документа 1С на основании другого: копирование реквизитов и таблиц, проведение, проверка и защита от дублей без потери данных.
IS
IT'S EDUДругое
Справочный материал
Создание документа на основании другого документа в 1С означает программное формирование нового объекта с заполнением реквизитов и табличных частей из существующего. Это используется при оформлении реализации по заказу, переоценке по приходной накладной, создании платежного поручения по договору и подобных цепочках.
Основная задача — перенести только те данные, которые действительно зависят от источника, и оставить возможность вручную скорректировать суммы, даты, контрагентов или аналитику перед записью. Неправильное копирование может привести к несоответствию остатков, ошибкам в регистрах и дублированию проводок.
Контрольные точки
Как проверить результат
Совпадение реквизитов с источником
Норма
Значения контрагента, организации, договора и даты совпадают
Тревожный признак
Реквизиты пустые или взяты не из документа-основания
Строки табличной части
Норма
Количество и состав строк соответствуют источнику
Тревожный признак
Строки дублируются, отсутствуют или содержат нулевые количества
Проведение и период
Норма
Документ проведен в открытом периоде без ошибок
Тревожный признак
Ошибка проведения или период закрыт
Программный способ оправдан, когда операция повторяется регулярно, источник содержит много строк табличной части, а ручное заполнение занимает много времени или связано с риском опечаток. Для разовых операций проще использовать стандартную команду «Создать на основании» из интерфейса, если она доступна в конфигурации.
Когда программное создание на основании оправдано
Подходит для сценариев, где новый документ является логическим продолжением источника: отгрузка по заказу клиента, списание по приходу, начисление по договору, создание платежного документа по счету. В таких случаях поля контрагента, организации, склада, договора и номенклатуры обычно берутся из документа-основания.
Типичные ошибки
01
Копирование всех реквизитов без очистки уникальных полей создает дубли и некорректные ссылки.
02
Пропуск обязательных реквизитов строк табличной части портит регистры и остатки.
Признаки подходящей ситуации
Если в документе-основании есть заполненные табличные части, которые нужно перенести почти без изменений, программное копирование экономит время. Если же новый документ требует существенной переработки состава строк или изменения условий сделки, автоматическое заполнение может создать лишнюю работу по исправлению.
Маршрут решения
Как выбрать действие
Структуры документов совпадают и нужно быстро перенести поляИспользуйте ЗаполнитьЗначенияСвойств и проверьте результат
Нужно отфильтровать строки или изменить суммыЗаполняйте табличную часть циклом с ручной корректировкой
Период закрыт или нет прав на созданиеОстановитесь и уточните права или дату документа
Способы переноса данных между документами
В 1С чаще всего используют три подхода: копирование объекта через встроенные средства, заполнение свойств функцией ЗаполнитьЗначенияСвойств и последовательное заполнение реквизитов и строк вручную. Выбор зависит от совместимости структур документов и необходимости преобразования данных.
Способ
Когда подходит
Ограничение
Копирование объекта документа
Документы имеют одинаковую или близкую структуру реквизитов
Может перенести лишние поля, которые требуют очистки
ЗаполнитьЗначенияСвойств для реквизитов и строк
Нужно скопировать набор полей без ручного перечисления
Не подходит, если имена реквизитов в документах различаются
Ручное заполнение в цикле по табличной части
Требуется преобразование данных, фильтрация строк или расчет новых значений
Больше кода и выше риск пропустить обязательные реквизиты
При копировании табличной части важно пройти по строкам источника и добавить соответствующие строки в новый документ, а не пытаться скопировать всю таблицу одним присваиванием, если платформа не поддерживает такое прямое присваивание для данной конфигурации.
Пример порядка действий в модуле документа
Обычно алгоритм выглядит так: получить ссылку на документ-основание, создать новый документ методом СоздатьДокумент, скопировать основные реквизиты, заполнить табличные части циклом, задать специфичные для нового документа значения, записать и, при необходимости, провести.
Код может выглядеть приблизительно так: создать объект нового документа, заполнить его свойства из источника, пройти циклом по строкам табличной части источника, добавить строки в новую табличную часть и заполнить их свойства. После этого вызвать запись с подходящим режимом.
НовыйДокумент = Документы.ИмяДокумента.СоздатьДокумент();
ЗаполнитьЗначенияСвойств(НовыйДокумент, ДокументОснования);
Для Каждого СтрокаИсточника Из ДокументОснования.ТабличнаяЧасть Цикл
НоваяСтрока = НовыйДокумент.ТабличнаяЧасть.Добавить();
ЗаполнитьЗначенияСвойств(НоваяСтрока, СтрокаИсточника);
КонецЦикла;
НовыйДокумент.Записать(РежимЗаписиДокумента.Отложенная);
Точные имена объектов, реквизитов и режимов записи зависят от конфигурации, поэтому пример нужно адаптировать под конкретную базу. Не используйте жестко заданные номера документов без проверки их существования.
Проверка результата и проведение
После записи нового документа убедитесь, что он сохранен в базе, имеет ожидаемый номер и дату, а реквизиты совпадают с источником. Проверьте табличные части: количество строк, номенклатуру, количество, суммы и аналитику должны соответствовать заданной логике.
Если документ требует проведения, выполните его только после проверки остатков, цен и закрытости периода. Проведение некорректно заполненного документа может испортить регистры накопления и бухгалтерские проводки, исправление которых займет больше времени, чем первичная настройка.
Ограничения, права доступа и риски
Пользователь, от имени которого выполняется код, должен иметь права на чтение документа-основания и создание нового документа. Если права отсутствуют, программа вернет ошибку доступа или создаст документ с ограниченной видимостью, в зависимости от настроек ролей.
Будьте осторожны с автоматическим проведением: ошибка в суммах или налогах может повлиять на налоговые и складские данные. Не запускайте массовое создание документов на основании других без предварительной проверки на копии базы или ограниченном наборе документов.
Типичные ошибки и как их избежать
Частая ошибка — копирование всех реквизитов без очистки полей, которые должны быть уникальными для нового документа, например номера, даты или статуса. Это приводит к созданию дублей или некорректных ссылок на источник.
Другая ошибка — игнорирование обязательных реквизитов новой табличной части. Если в строке не заполнен важный аналитический признак, запись может пройти, но регистры заполнятся неверно. Также не стоит копировать уже проведенные документы без анализа влияния на остатки.
Как выбрать способ и проверить результат
Если структуры документов совпадают, начните с ЗаполнитьЗначенияСвойств и ручной доработки. Если строк нужно фильтровать или пересчитывать, используйте цикл по табличной части. После записи всегда проверяйте документ в интерфейсе: реквизиты, строки, статус и отражение в регистрах.
Итог
Что важно запомнить
Создавайте документ программно, копируйте только нужные реквизиты и строки, проверяйте период и права, проводите только после подтверждения корректности данных.
Частые вопросы
Можно ли скопировать документ целиком одной командой?
Прямое копирование всего документа одной командой не всегда возможно, так как реквизиты и табличные части могут различаться. Надежнее создать новый документ и перенести поля и строки отдельно, с проверкой обязательных реквизитов.
Нужно ли проводить новый документ сразу после записи?
Не обязательно. Сначала запишите документ в отложенном режиме, проверьте заполнение и только потом проведите, если период открыт и данные подтверждены. Это снижает риск ошибочных проводок.
Что делать, если реквизиты в документах называются по-разному?
В этом случае функция ЗаполнитьЗначенияСвойств не перенесет такие поля автоматически. Нужно в коде явно присвоить каждое нужное значение из реквизита источника в соответствующий реквизит нового документа.
Как избежать дублей при повторном создании на основании?
Перед созданием проверяйте, нет ли уже документа, оформленного на основании этого же источника, по номеру, дате или ссылке на основание. При необходимости добавляйте признак обработки или отменяйте создание дубликата.
Безопасно ли запускать массовое создание документов на основании других?
Массовое создание безопасно только после тестирования на ограниченном наборе и проверки результатов. Лучше запускать по группам, проверять ошибки записи и проведения, а не обрабатывать всю базу сразу.