Неуникальность кода справочника при обновлении 1С: как убрать предупреждение

Обновляли конфигурацию, и в конце вместо привычного «Обновление завершено» выскочило окно: Код справочника стал неуникальным. Реорганизация информации замерла, база вроде работает, а что делать — непонятно.

Разбираем, почему при обновлении 1С 8.3 код справочника становится неуникальным, чем это грозит и как убрать предупреждение без потери данных. Сценарий одинаковый для БП 3.0, ЗУП 3.1 и УТ 11 — меняется только имя справочника в тексте ошибки.

Что означает предупреждение «Код справочника стал неуникальным»

В 1С у каждого элемента справочника есть код — он должен быть уникальным в пределах своего уровня. Платформа сама следит за этим при вводе новых элементов.

Полный текст предупреждения обычно выглядит так:

Код справочника <Имя> стал неуникальным.
Изменение длины или типа кода привело к появлению одинаковых кодов
у разных элементов. Требуется перенумерация.

💡 Это предупреждение, а не ошибка платформы. База не сломана, обновление проходит. 1С честно сообщает: после её изменений в справочнике появились элементы с одинаковым кодом.

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

Почему код справочника становится неуникальным при обновлении

Причина одна: в новом релизе изменилась настройка поля «Код». Варианты изменений:

• 🔢 Изменилась длина кода — было 5 знаков, стало 9 (или наоборот, укоротили).
• 🔤 Изменился тип кода — был числовой, стал строковый, или добавили префиксы.
• ➕ Добавили серии кодов — раньше нумерация была сквозная, стала «в пределах подчинения».
• 🔀 Слили два справочника в один — коды из разных источников пересеклись.

Когда платформа пересчитывает коды по новым правилам, часть значений совпадает. Например, элементы с кодами 000000012 и 12 после обрезки до коротких кодов оба превращаются в 12. Вот и дубль.

⚠️ Особенно часто это ловят на «перепрыгивании» релизов — когда обновляются не по очереди, а сразу с версии годичной давности на свежую. Промежуточные изменения кода накладываются друг на друга.

Быстро сопоставить симптом и причину поможет диагностика:

Опасно ли это и можно ли продолжать обновление

Продолжать можно. Данные в проводках, документах и регистрах привязаны не к коду, а к внутренней ссылке (GUID) элемента. Одинаковые коды не «склеивают» элементы и не портят учёт.

Что действительно может пойти не так при неуникальных кодах:

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

Поэтому предупреждение не игнорируют, а закрывают перенумерацией. Но спешки нет — сначала копия.

Перед любыми правками справочника сделайте резервную копию базы. Выгрузка в .dt через «Администрирование → Выгрузить информационную базу» или копия каталога файловой базы.

Как исправить неуникальность кода справочника — по шагам

Штатный способ — встроенная перенумерация. Она проходит по справочнику и назначает уникальные коды всем элементам.

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

Как найти дублирующиеся коды в справочнике

Если перенумерации нет или хочется сначала посмотреть, где именно дубли, — их видно через консоль запросов (обработка «Консоль запросов» с ИТС или встроенная в расширениях).

Запрос ищет коды, которые встречаются больше одного раза:

ВЫБРАТЬ
    Спр.Код КАК Код,
    КОЛИЧЕСТВО(Спр.Ссылка) КАК Сколько
ИЗ
    Справочник.НалогиИВзносы КАК Спр
СГРУППИРОВАТЬ ПО
    Спр.Код
ИМЕЮЩИЕ
    КОЛИЧЕСТВО(Спр.Ссылка) > 1

Замените НалогиИВзносы на имя своего справочника из текста предупреждения. В результате — список кодов-дублей и сколько раз каждый повторяется.

Дальше по каждому коду решаете: какому элементу оставить код, а какому назначить новый. Менять код можно прямо в карточке элемента (поле «Код» открыто на редактирование в большинстве типовых справочников).

Если не помогло

Бывает, что перенумерация не запускается или предупреждение возвращается. Что пробуют дальше:

1. 🧹 Тестирование и исправление — «Администрирование → Тестирование и исправление ИБ» с галкой «Реструктуризация таблиц». Заодно чистит битые ссылки.
2. 🔁 Повторить обновление на копии — накатите тот же релиз на резервную копию и посмотрите, повторяется ли предупреждение. Так отсекается разовый сбой.
3. 🪜 Обновляться по шагам — если перепрыгнули много релизов, накатите промежуточные версии по очереди. Каждый релиз аккуратно пересчитывает коды.
4. 🧰 Предопределённые элементы — если дубль по предопределённому элементу, его код выровняет следующий релиз конфигурации; вручную такие коды лучше не трогать.

⚠️ Если справочник большой и правок много, а сроки горят — разумнее подключить специалиста с доступом к конфигуратору. Массовую перенумерацию с проверкой ссылок безопаснее делать под контролем.

Как предотвратить предупреждение при следующих обновлениях

Полностью избежать не всегда получится — решение о смене кода принимает разработчик релиза. Но снизить вероятность и последствия реально:

Частые вопросы