К статье
Практический материал

Другое · 8 мин

Как записать данные в документ 1С

Практическая инструкция по вводу и сохранению данных в документе 1С: заполнение реквизитов, табличной части, проведение и проверка записи вручную и программно.

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

Отличие между сохранением черновика и проведением документа критически важно. Непроведённый документ фиксирует фактическое событие, но не меняет остатки, расчёты или другие зависимые показатели. Проведение запускает алгоритмы движения, которые могут затронуть бухгалтерские, налоговые или складские данные, поэтому к нему предъявляются более жёсткие требования к заполнению и правам пользователя.

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

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

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

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

Порядок действий
  1. 1
    Откройте документ в режиме создания или редактирования
  2. 2
    Заполните обязательные реквизиты и строки табличной части
  3. 3
    Проверьте контрольные суммы, даты и контрагентов
  4. 4
    Выберите режим записи: только сохранение или сохранение с проведением
  5. 5
    Подтвердите запись и проверьте результат в списке документов

Способы записи: через форму и программно

Через пользовательскую интерфейс запись выполняется кнопкой «Записать» или «Записать и закрыть». Система проверяет обязательные поля, корректность заполнения табличной части и возможность проведения. Если проверка не пройдена, документ не сохраняется и выводится сообщение о причине отказа.

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

Через форму документа

Пользователь открывает журнал документов, нажимает «Создать» или выбирает существующий документ, заполняет поля и нажимает запись. При необходимости документ проводится сразу или отдельно после сохранения. Результат виден в списке: статус «Проведён» или «Не проведен», а также дата и время последней записи.

Программно в конфигурации

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

1c
Док = Документы.ИмяДокумента.СоздатьДокумент();
Док.Дата = ТекущаяДата();
Док.Записать(РежимЗаписиДокумента.Проведение);

Обязательные проверки перед записью

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

Проверьте права доступа и режим блокировки. Если документ открыт другим пользователем, запись может быть недоступна или привести к конфликту версий. В многопользовательской базе желательно завершать работу с документом сразу после сохранения, чтобы не удерживать блокировку надолго.

Контрольные точки

Как проверить результат

Статус документа в списке
Норма

Отображается как сохранённый или проведённый

Тревожный признак

Документ отсутствует или остался черновиком

Движения по регистрам
Норма

Созданы соответствующие записи после проведения

Тревожный признак

Движений нет или они не соответствуют введённым суммам

Остатки и расчёты
Норма

Изменены ожидаемым образом

Тревожный признак

Остатки не изменились или изменились некорректно

Проведение и отмена проведения

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

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

Частые ошибки и ограничения

Одна из типичных ошибок — запись документа с пустыми обязательными полями через программный интерфейс без обработки сообщений системы. Вторая ошибка — изменение проведённого документа без отмены проведения, что либо блокируется системой, либо приводит к несоответствию движений и введённых значений. Третья — попытка провести документ в закрытом периоде без соблюдения порядка корректировок.

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

Типичные ошибки
01
Сохранение документа без заполнения обязательных реквизитов приводит к отказу записи или неполным данным
02
Изменение проведённого документа без отмены проведения вызывает расхождение между реквизитами и движениями
03
Проведение в закрытом периоде без корректирующего документа нарушает последовательность учёта

Как подтвердить, что данные сохранены

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

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

Итог

Что важно запомнить

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

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

Запись без обязательных реквизитов обычно блокируется системой, но набор обязательных полей зависит от вида документа и конфигурации. Необязательные поля можно оставить пустыми, если это не противоречит правилам учёта, однако пустые аналитические значения могут помешать проведению или корректному отражению в регистрах.

Чем запись отличается от проведения?

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

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

Прямое изменение проведённого документа часто недоступно. Обычно требуется отменить проведение, внести исправления и провести документ повторно, либо оформить корректирующий документ. Точный порядок зависит от конфигурации и состояния периода.

Что делать, если запись не проходит без понятной ошибки?

Проверьте обязательные реквизиты, права доступа, блокировку другим пользователем и состояние периода. Если причина неясна, не пробуйте записать данные многократно в разных вариантах; лучше зафиксировать вводимые значения, попробовать запись на тестовой копии базы и обратиться к администратору или разработчику конфигурации.

Безопасно ли программно записывать документы из внешних источников?

Программная запись допустима, но требует тщательной проверки соответствия полей внешнего источника реквизитам 1С, обработки ошибок и соблюдения правил проведения. Рекомендуется сначала отработать выгрузку на копии базы, сверять результаты с исходными данными и ограничить доступ к записывающим обработкам.