Почему при записи документа в 1С возникает ошибка «Значение поля Номер не уникально» и как её исправить?

← На главную

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

Выясним причины сбоя нумерации документов

Для понимания корня проблемы проанализируем, как платформа 1С формирует и проверяет уникальность номеров. По умолчанию система выполняет поиск максимального значения MAX(Номер) среди документов заданного вида в пределах установленной периодичности (как правило, в пределах календарного года) и с учетом заданного префикса. Затем к полученному числу прибавляется единица. Сбой этого механизма происходит по ряду типичных причин:

Ручное вмешательство пользователей. Самая распространенная причина: пользователь вручную отредактировал номер существующего или нового документа (например, случайно сократил количество лидирующих нулей, ввел букву «О» вместо цифры «0», изменил префикс или вручную присвоил номер «из будущего»). Платформа воспринимает такой номер как ориентир и начинает отсчитывать следующие значения от него, либо «теряет» правильную последовательность.
Помеченные на удаление документы. Контроль уникальности в СУБД работает по всей таблице документов. Если документ был помечен на удаление, он физически никуда не исчез и продолжает занимать свой номер. Если счетчик откатился назад, попытка занять этот номер вызовет ошибку.
Ограничения прав на уровне записей (RLS). Документ с проблемным номером может существовать в базе данных, но быть скрыт от текущего пользователя настройками прав доступа (по организации, подразделению и т.д.). Для пользователя списка документ невидим, однако платформа и СУБД видят дубликат.
Использование общего нумератора. Если в конфигураторе для нескольких видов документов (например, для различных видов накладных или актов) назначен единый общий нумератор, номер мог быть занят объектом совершенно другого типа.
Манипуляции с датами документов. Если периодичность нумератора установлена «В пределах года», а документу задним числом изменили дату так, что он переместился из прошлого года в текущий (или наоборот), его номер не пересчитывается автоматически и может вступить в конфликт с новой нумерацией.
Рассинхронизация серверного кэша номеров. В клиент-серверном варианте кластер 1С кэширует диапазоны номеров в памяти рабочих процессов. При аварийном завершении процессов или массовых сбоях транзакций кэш может рассинхронизироваться с фактическими записями базы данных.

Шаг 1. Ищем виновника и дублирующий документ через Журнал регистрации и консоль

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

Проверяем Журнал регистрации. Найдем в журнале список документов с проблемным номером. Сделаем отбор по представлению документа или по метаданным за период, когда номер появился впервые. В событиях изменения документа посмотрим имя пользователя, который последним записывал объект. Это позволит понять, был ли номер изменен вручную.
Выполняем поиск без учета RLS. Если в обычном списке документ с таким номером не отображается, откроем консоль запросов в режиме привилегированного сеанса (под полными правами) и выполним прямой запрос к таблице. Обязательно проверяем реквизит ПометкаУдаления:


ВЫБРАТЬ
    Док.Ссылка КАК Ссылка,
    Док.Дата КАК Дата,
    Док.Номер КАК Номер,
    Док.ПометкаУдаления КАК ПометкаУдаления
ИЗ
    Документ.ПриобретениеТоваровУслуг КАК Док
ГДЕ
    Док.Номер ПОДОБНО "%000125%"

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

Шаг 2. Сбрасываем кэш с помощью функции ОбновитьНумерациюОбъектов()

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

Рекомендуется вызывать этот метод не для всей информационной базы (чтобы не создавать избыточную нагрузку на сервер), а точечно для проблемного объекта метаданных. Создадим внешнюю обработку или выполним код во внешней обработке с контекстом сервера:


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

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

Шаг 3. Программная переинициализация и ручное восстановление цепочки

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


// Принудительное назначение нового номера перед записью объекта
ДокументОбъект = СсылкаНаДокумент.ПолучитьОбъект();
ПрефиксНомера = "ФР-"; // Задаем актуальный префикс
ДокументОбъект.УстановитьНовыйНомер(ПрефиксНомера);
ДокументОбъект.Записать();

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

Найдем ошибочный документ с нарушенным форматом номера.
Вручную или программно исправим его номер на корректный, соблюдая правильную длину строки и лидирующие нули.
Вызовем метод ОбновитьНумерациюОбъектов() для данного типа метаданных.
Создадим новый документ и убедимся, что автонумерация подставляет следующий по порядку свободный номер.

Таким образом, сочетание проверки скрытых и помеченных на удаление записей с точечным вызовом ОбновитьНумерациюОбъектов() позволяет быстро и надежно ликвидировать конфликт уникальности номеров без риска повреждения данных.