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

В этой статье мы разберем 5 проверенных способов программного поиска документов по номеру — от простых методов встроенного языка до оптимизированных запросов и работы с метаданными. Вы узнаете, как избежать типичных ошибок (например, поиска по неверному виду документа), почему иногда НайтиПоНомеру() возвращает Неопределено, и как ускорить поиск в больших базах. Материал будет полезен как начинающим разработчикам 1С, так и опытным специалистам, которые хотят систематизировать подходы.

Особое внимание уделим производительности: некоторые методы могут тормозить базу при массовом поиске, а другие — работать мгновенно даже на тысячах документов. Также рассмотрим, как учитывать периодичность документов, префиксы номеров и особенности конфигураций (1С:Бухгалтерия, 1С:УТ, 1С:ЗУП и др.).

📊 Какой метод поиска документов в 1С вы используете чаще?
Встроенные методы (НайтиПоНомеру)
Запросы
Прямой перебор
Внешние обработки
Не знаю, как оптимальнее

1. Метод НайтиПоНомеру(): простой, но опасный

Самый очевидный способ — использовать встроенный метод объектов документов НайтиПоНомеру(). Он доступен для любого документа и на первый взгляд кажется идеальным решением. Например, чтобы найти документ "ПоступлениеТоваровУслуг" с номером "ПТ-000123", достаточно написать: 

Документ = Документы.ПоступлениеТоваровУслуг.НайтиПоНомеру("ПТ-000123", ДатаДокумента);

Но здесь кроются три подводных камня:

  1. Дата обязательна. Без указания даты метод вернет Неопределено, даже если документ существует. Это связано с тем, что номера в 1С могут повторяться в разных периодах.
  2. Префиксы номеров. Если в настройках нумерации документов используется префикс (например, "ПТ-"), его нужно указывать в точности, иначе поиск не сработает.
  3. Производительность. При большом количестве документов метод может работать медленно, так как фактически перебирает все записи в базе.

Пример с учетом даты и префикса: 

ДатаПоиска = '2026-10-15';

НомерДокумента = "ПТ-000123";


Документ = Документы.ПоступлениеТоваровУслуг.НайтиПоНомеру(НомерДокумента, ДатаПоиска);



Если Документ = Неопределено Тогда


Сообщить("Документ не найден! Проверьте номер или дату.");


КонецЕсли;

⚠️ Внимание: В некоторых конфигурациях (например, 1С:Управление торговлей 11) метод НайтиПоНомеру() может игнорировать префиксы, если они добавлены через механизм "Серии номеров". В этом случае попробуйте искать без префикса или уточните его в настройках нумерации.

2. Поиск через запрос: быстро и гибко

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

Пример запроса для поиска документа "РеализацияТоваровУслуг" по номеру и дате: 

Запрос = Новый Запрос;

Запрос.Текст =


"ВЫБРАТЬ


|   РеализацияТоваровУслуг.Ссылка КАК Документ


|ИЗ


|   Документ.РеализацияТоваровУслуг КАК РеализацияТоваровУслуг


|ГДЕ


|   РеализацияТоваровУслуг.Номер = &Номер


|   И РеализацияТоваровУслуг.Дата = &Дата";



Запрос.УстановитьПараметр("Номер", "РТ-00456");


Запрос.УстановитьПараметр("Дата", '2026-10-20');



Результат = Запрос.Выполнить();


Если Результат.Пустой() Тогда


Сообщить("Документ не найден!");


Иначе


Документ = Результат.Получить(0).Документ;


КонецЕсли;

Преимущества этого метода:

  • 🔍 Гибкость: можно добавлять любые условия (по контрагенту, складу, сумме и т.д.).
  • ⚡ Производительность: запросы оптимизированы и работают быстрее, чем перебор в цикле.
  • 📊 Множественный поиск: можно получить список документов, соответствующих критериям.

Если номер документа содержит префикс, но вы не уверены в его точности, используйте функцию ПОДОБИЕ(): 

Запрос.Текст =

"ВЫБРАТЬ


|   Документ.Ссылка КАК Документ


|ИЗ


|   Документ.ПоступлениеТоваровУслуг КАК Документ


|ГДЕ


|   ПОДОБИЕ(Документ.Номер, &ПоисковыйНомер)";

⚠️ Внимание: В больших базах запросы с ПОДОБИЕ() могут тормозить. Если префикс известен заранее, лучше использовать точное сравнение (=), а не поиск по шаблону.

Указан ли префикс в номере документа?

Совпадает ли формат даты с форматом в базе?

Есть ли права на чтение документа?

Не используется ли в запросе лишних полей (это замедляет выполнение)-->

3. Прямой перебор документов: когда ничего не помогает

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

Пример кода для перебора документов "СчетФактураВыданный": 

Выборка = Документы.СчетФактураВыданный.Выбрать();

Пока Выборка.Следующий() Цикл


Если Выборка.Номер = "СФ-00789" И Выборка.Дата = '2026-10-10' Тогда


НайденныйДокумент = Выборка.Ссылка;


Прервать;


КонецЕсли;


КонецЦикла;

Чтобы ускорить перебор, добавьте отбор по дате или другим реквизитам: 

Выборка = Документы.СчетФактураВыданный.Выбрать();

Выборка.Отбор.Дата.Установить(НачалоДня('2026-10-01'), КонецДня('2026-10-31'));

Когда стоит использовать прямой перебор:

  • 🔄 Если номер документа формируется динамически (например, с учетом подчиненных документов).
  • 🛠️ Если конфигурация сильно модифицирована, и стандартные методы не работают.
  • 📂 Если нужно найти документ по частичному совпадению номера (например, все документы с номером, содержащим "АБ-").

Критическая ошибка: никогда не используйте прямой перебор без отборов в больших базах (100 000+ документов). Это может заблокировать работу пользователей!

💡

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

4. Поиск через менеджеры документов и метаданные

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

Пример универсальной функции поиска документа по номеру и дате: 

Функция НайдиДокументПоНомеру(ИмяДокумента, Номер, Дата)

МенеджерДокумента = Метаданные.Документы[ИмяДокумента];


Если МенеджерДокумента = Неопределено Тогда


Возврат Неопределено;


КонецЕсли;



Возврат МенеджерДокумента.НайтиПоНомеру(Номер, Дата);


КонецФункции



// Пример вызова:


Документ = НайдиДокументПоНомеру("ПоступлениеТоваровУслуг", "ПТ-000123", '2026-10-15');

Преимущества этого подхода:

Преимущество Описание
🔄 Универсальность Код работает с любым документом без изменений.
📌 Типизация Можно проверять существование документа через метаданные.
🛠️ Поддержка Упрощает рефакторинг и обновление кода.

Если вам нужно получить не только ссылку на документ, но и его реквизиты, используйте ПолучитьОбъект(): 

СсылкаНаДокумент = НайдиДокументПоНомеру("РеализацияТоваровУслуг", "РТ-00456", '2026-10-20');

Если СсылкаНаДокумент <> Неопределено Тогда


ДокументОбъект = СсылкаНаДокумент.ПолучитьОбъект();


Сообщить("Контрагент: " + ДокументОбъект.Контрагент.Наименование);


КонецЕсли;

⚠️ Внимание: При работе с метаданными учитывайте, что в некоторых конфигурациях (например, 1С:ERP) имена документов могут отличаться от привычных (например, "ЗаказПокупателя" вместо "ЗаказКлиента"). Всегда проверяйте точные имена в конфигураторе!

5. Внешние обработки и HTTP-сервисы: поиск извне

Если вам нужно найти документ по номеру из внешней системы (например, из сайта, мобильного приложения или другого ПО), можно использовать:

  • 🌐 HTTP-сервисы (REST или SOAP).
  • 📄 Внешние обработки с публичными методами.
  • 🔌 COM-соединение (для локальных интеграций).

Пример публикации HTTP-сервиса для поиска документов: 

// В модуле HTTP-сервиса

Функция НайдиДокументПоНомеруJSON(Запрос)


Параметры = JSON.Прочитать(Запрос.ТелоКакСтроку());


Номер = Параметры.Номер;


Дата = Параметры.Дата;


ИмяДокумента = Параметры.ИмяДокумента;



Документ = Документы[ИмяДокумента].НайтиПоНомеру(Номер, Дата);


Если Документ = Неопределено Тогда


Возврат JSON.Записать(Новый Структура("Успех, Статус", Ложь, "Ошибка", "Документ не найден"));


Иначе


Возврат JSON.Записать(Новый Структура("Успех, Ссылка", Истина, Документ.УникальныйИдентификатор()));


КонецЕсли;


КонецФункции

Чтобы вызвать этот сервис из внешней системы, отправьте POST-запрос с JSON-телом: 

{

"ИмяДокумента": "ПоступлениеТоваровУслуг",


"Номер": "ПТ-000123",


"Дата": "2026-10-15"


}

Для локальных интеграций (например, из Excel или Python) удобнее использовать COM-соединение: 

// Пример на VBScript (для Excel)

Set v8 = CreateObject("V83.ComConnector")


Set connection = v8.Connect("File=path_to_base;Usr=username;Pwd=password")


Set docManager = connection.Documents.ПоступлениеТоваровУслуг


Set doc = docManager.НайтиПоНомеру("ПТ-000123", "20261015")

Важно: при интеграции через COM или HTTP всегда ограничивайте права пользователя, от имени которого выполняется поиск. Не используйте администрирующие учетные записи!

Как защитить HTTP-сервис от несанкционированного доступа?

1. Используйте HTTPS вместо HTTP.

2. Добавляйте проверку токена авторизации в каждом методе.

3. Ограничивайте IP-адреса, с которых разрешены запросы (в настройках веб-сервера).

4. Логируйте все обращения к сервису для аудита.

6. Типичные ошибки и как их избежать

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

🔹 "Документ не найден, хотя он есть в базе"

  • 📅 Проверьте дату документа — она должна точно совпадать.
  • 🔤 Убедитесь, что префикс номера указан верно (или не указан, если не нужен).
  • 👁️ Проверьте права доступа — возможно, у пользователя нет прав на чтение этого вида документов.

🔹 "Метод НайтиПоНомеру() работает слишком медленно"

  • 🔍 Используйте запросы вместо прямого метода.
  • 📊 Добавьте индексы на поля "Номер" и "Дата" в конфигураторе.
  • 🗑️ Очистите базу от помеченных на удаление документов — они могут замедлять поиск.

🔹 "Номер документа содержит непечатаемые символы"

Иногда номера документов могут содержать пробелы, табуляции или другие скрытые символы. Чтобы это проверить, используйте функцию СокрЛП() (убирает пробелы) или СтрЗаменить(): 

Номер = СокрЛП(Номер); // Убираем пробелы с краев

Номер = СтрЗаменить(Номер, Символы.Таб, ""); // Убираем табуляции

🔹 "Документ найден, но не получается его изменить"

  • 🔒 Проверьте, не стоит ли у документа пометка на удаление.
  • 🔐 Убедитесь, что у пользователя есть права на изменение, а не только на чтение.
  • 📅 Проверьте, не проводится ли документ — некоторые операции запрещены для проведенных документов.
💡

Всегда проверяйте результат поиска на Неопределено перед работой с документом. Это предотвратит ошибки вида "Объект не является значением объекта документа".

7. Оптимизация поиска в больших базах

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

📌 Используйте кэширование

Если вы часто ищете одни и те же документы (например, в обработке, которая запускается раз в час), кэшируйте результаты в регистре сведений или хранилище значений: 

// Пример кэширования в хранилище значений

Если Не ХранилищеЗначений.СуществуетКлюч("ДокументыКэш_" + Номер + "_"+ Формат(Дата, "ДЛФ=DT")) Тогда


Документ = Документы.ПоступлениеТоваровУслуг.НайтиПоНомеру(Номер, Дата);


ХранилищеЗначений.Вставить("ДокументыКэш_" + Номер + "_" + Формат(Дата, "ДЛФ=DT"), Документ);


Иначе


Документ = ХранилищеЗначений.Получить("ДокументыКэш_" + Номер + "_" + Формат(Дата, "ДЛФ=DT"));


КонецЕсли;

📌 Разбивайте поиск по периодам

Если вы знаете, что документ точно создан в определенном квартале, добавьте отбор по дате в запрос: 

Запрос.Текст =

"ВЫБРАТЬ


|   Документ.Ссылка


|ИЗ


|   Документ.РеализацияТоваровУслуг КАК Документ


|ГДЕ


|   Документ.Номер = &Номер


|   И Документ.Дата МЕЖДУ &ДатаНачала И &ДатаОкончания";

📌 Используйте фоновые задания

Если поиск занимает много времени (например, при массовой обработке), перенесите его в фоновое задание: 

ФоновоеЗадание = ФоновыеЗадания.Создать("ПоискДокументов");

ФоновоеЗадание.Параметры.Вставить("Номер", "ПТ-000123");


ФоновоеЗадание.Параметры.Вставить("Дата", '2026-10-15');


ФоновоеЗадание.ВыполнитьАсинхронно();

📌 Настройте индексы в СУБД

Если вы работаете с SQL-версией 1С, добавьте индексы на поля "Номер" и "Дата" в таблицах документов. Это можно сделать через конфигуратор или напрямую в SQL Management Studio: 

CREATE INDEX IX_DocNumberDate ON dbo._Document123 (Number_, Date_);
⚠️ Внимание: Изменение индексов в СУБД может потребовать перезапуска сервера 1С. Всегда делайте резервную копию базы перед такими операциями!

FAQ: Ответы на частые вопросы

Можно ли найти документ по номеру без указания даты?

Технически да, но это не рекомендуется. Без даты вы рискуете получить первый попавшийся документ с таким номером (например, если номера сбрасываются ежегодно). Если дата действительно неизвестна, используйте запрос с сортировкой по дате и берите последний документ:

Запрос.Текст =

"ВЫБРАТЬ ПЕРВЫЕ 1


|   Документ.Ссылка КАК Документ


|ИЗ


|   Документ.ПоступлениеТоваровУслуг КАК Документ


|ГДЕ


|   Документ.Номер = &Номер


|УПОРЯДОЧИТЬ ПО


|   Документ.Дата УБЫВ";

Почему НайтиПоНомеру() возвращает Неопределено, хотя документ есть?

Причины могут быть следующими:

  1. Неверный префикс номера (например, ищете "ПТ123", а в базе "ПТ-123").
  2. Неверная дата (документ с таким номером есть, но в другом периоде).
  3. Документ помечен на удаление.
  4. У пользователя нет прав на чтение этого вида документов.
  5. Документ принадлежит другой организации (в многопользовательских базах).

Чтобы диагностировать проблему, выполните запрос напрямую к таблице документов в конфигураторе.

Как найти документ по номеру в управленческом учете, если он не проводится?

Для непроводимых документов (например, в 1С:Управление торговлей) используйте те же методы, но проверяйте статус проведения:

Документ = Документы.ЗаказКлиента.НайтиПоНомеру("ЗК-00456", '2026-10-20');

Если Документ <> Неопределено Тогда


Если НЕ Документ.Проведен Тогда


Сообщить("Документ не проведен!");


КонецЕсли;


КонецЕсли;

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

Можно ли искать документы по номеру в облачной версии 1С (1С:Фреш)?

Да, но с ограничениями:

  • 🔍 Метод НайтиПоНомеру() работает так же, как в обычной базе.
  • 🌐 Для внешних интеграций используйте REST API 1С:Фреш (документация доступна в личном кабинете).
  • ⚡ Запросы выполняются быстрее, чем в файловой базе, но есть лимиты на количество обращений.

Пример запроса к API 1С:Фреш:

// GET-запрос к API

URL = "https://api.1cfresh.com/v1/document/ПоступлениеТоваровУслуг?filter=Номер eq 'ПТ-000123' and Дата eq '2026-10-15'";


Заголовки = Новый Соответствие();


Заголовки.Вставить("Authorization", "Bearer YOUR_TOKEN");


Ответ = HTTPЗапрос.GET(URL, Заголовки);

Как найти документ по номеру, если он создан в другой информационной базе?

Если документы распределены по нескольким базам (например, в распределенной информационной базе 1С:РИБ), используйте:

  1. Обмен данными: настройте план обмена и ищите документ через механизм синхронизации.
  2. Внешние источники: если базы связаны через HTTP-сервисы, делайте запрос к удаленной базе.
  3. Универсальные форматы: экспортируйте/импортируйте документы в XML или JSON и ищите по номеру в файле.

Пример поиска через РИБ:

// Получаем ссылку на узел РИБ

Узел = ПланыОбмена.ОсновнойОбмен.НайтиПоИмени("ЦентральнаяБаза");


Если Узел = Неопределено Тогда


Сообщить("Узел не найден!");


Возврат;


КонецЕсли;



// Ищем документ в удаленной базе


Документ = Узел.НайтиДокументПоНомеру("ПоступлениеТоваровУслуг", "ПТ-000123", '2026-10-15');