Как создать свой нумератор в 1С

Нумератор в 1С — это механизм, который автоматически присваивает номера документам, справочникам и другим объектам. Стандартные номера вида «000000001» подходят не всегда: компаниям часто нужны префиксы по организациям, сброс нумерации с нового года или номера с буквами. Для этого в платформе 1С:Предприятие предусмотрен объект метаданных «Нумераторы».

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

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

Когда нужен собственный нумератор, а не стандартный

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

Собственный нумератор оправдан в нескольких ситуациях. Во-первых, когда разные документы должны нумероваться в единой последовательности — например, «Счёт на оплату» и «Акт выполненных работ» в одной серии. Во-вторых, когда нужен сброс нумерации каждый год, квартал или месяц. В-третьих, когда требуется общий контроль уникальности номеров для группы объектов.

Если же задача — просто добавить префикс организации или изменить формат номера одного вида документов, часто проще обойтись без отдельного нумератора: достаточно настроить свойства «Префикс» и «Длина номера» у самого документа или использовать программный способ.

Создание нумератора в конфигураторе: пошагово

Работа выполняется в конфигураторе 1С:Предприятие. Потребуются права на изменение конфигурации, а если конфигурация типовая и находится на поддержке — сначала потребуется включить возможность изменения (через «Конфигурация» → «Поддержка» → «Настройка поддержки»).

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

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

1. 1
   Откройте конфигуратор и ветку «Общие» → «Нумераторы»
2. 2
   Добавьте новый нумератор и задайте имя
3. 3
   Настройте тип номера, длину и периодичность
4. 4
   В свойствах каждого нужного документа укажите этот нумератор
5. 5
   Сохраните конфигурацию и обновите конфигурацию базы данных
6. 6
   Создайте тестовый документ и проверьте присвоенный номер

Ключевые свойства нумератора: тип, длина, периодичность

Тип номера определяет, какие значения может принимать номер. Числовой тип подходит для простой последовательности и обеспечивает естественную сортировку. Строковый тип нужен, если в номере будут буквы, дефисы или префиксы, но у него есть важная особенность: сортировка строк идёт посимвольно, поэтому «10» окажется раньше «2», если не использовать лидирующие нули.

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

Периодичность определяет, в каких границах нумерация ведётся непрерывно: в пределах года, квартала, месяца, дня или непериодически. Например, при периодичности «Год» с 1 января нумерация начнётся заново. Это удобно для счетов-фактур и других документов, где принято начинать отсчёт с нового периода.

Программная нумерация через ОбработкаПолученияНомера

Когда возможностей объекта «Нумераторы» не хватает — например, номер должен содержать код подразделения или год внутри строки — логику реализуют программно. Для этого в модуле объекта документа используется обработчик события «ОбработкаПолученияНомера». Внутри него можно сформировать номер по своим правилам и установить параметр «СтандартнаяОбработка» в значение «Ложь», чтобы платформа не применяла стандартный алгоритм.

Альтернативный вариант — метод «УстановитьНовыйНомер», который вызывают с указанием префикса. Он полезен, когда нужно просто задать префикс по организации или по подразделению без полного переопределения механизма: платформа сама вычислит очередной числовой хвост с учётом переданного префикса.

Процедура ОбработкаПолученияНомера(СтандартнаяОбработка, Номер, Дата)
    СтандартнаяОбработка = Ложь;
    Префикс = Организация.Префикс;
    Номер = Префикс + "-" + Формат(Год(Дата), "ЧГ=0") + "-" + Формат(ПолучитьОчереднойНомер(), "ЧЦ=5; ЧВН=; ЧГ=0");
КонецПроцедуры

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

Префиксы и нумерация по организациям

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

В собственной конфигурации префикс реализуют двумя способами. Первый — вызов «УстановитьНовыйНомер» с параметром-префиксом в обработчике «ПриУстановкеНовогоНомера». Второй — полностью программное формирование номера с учётом префикса, как в примере выше. Первый способ предпочтительнее, так как платформа сама обеспечивает непрерывность числовой части внутри каждого префикса.

Учтите, что префикс расходует длину номера. Если длина номера документа — 11 символов, а префикс занимает 3, на числовую часть остаётся 8 знаков. Планируйте длину с учётом самого длинного возможного префикса.

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

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

Частая проблема — «дырки» в нумерации, когда документ создали, но не записали или удалили. Это нормальное поведение платформы: номер выдаётся при создании объекта и не возвращается в пул. Для большинства учётных задач пропуски допустимы, но если требуется строгая непрерывность, потребуется отдельный механизм перенумерации.

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

Ограничения и границы самостоятельной настройки

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

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

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

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