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

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

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

⚠️ Внимание: Способы получения ссылок зависят от версии платформы 1С:Предприятие (8.3.20+ рекомендуется) и типа клиента (тонкий, веб, толстый). Некоторые методы работают только в промышленных редакциях с лицензией на ws-соединения или REST-сервис.

1. Получение ссылки через веб-клиент 1С

Самый простой способ — использовать встроенные механизмы веб-клиента. Он автоматически формирует URL для документов, если база опубликована на веб-сервере (Apache, IIS или встроенном сервере 1С). Ссылка будет выглядеть так:

http://[адрес_сервера]/[имя_базы]/ru_RU?ref=[СсылкаНаДокумент]#[ТипДокумента]/[Идентификатор]

Где:

• 🔹 [адрес_сервера] — IP или домен сервера (например, 192.168.1.10 или erpserver.company.ru)
• 🔹 [имя_базы] — имя информационной базы (указывается при публикации)
• 🔹 [СсылкаНаДокумент] — уникальный идентификатор документа в формате Document.ЗаказПокупателя.12345
• 🔹 #[ТипДокумента] — сокращённое имя метаданных (например, SalesOrder для заказа покупателя)

Чтобы получить такую ссылку:

1. Откройте документ в веб-клиенте.
2. Скопируйте URL из адресной строки браузера.
3. При необходимости замените hs= на ref= (если используется хэш-ссылка).

⚠️ Внимание: В файловом варианте 1С (без веб-сервера) этот метод не работает. Также ссылки могут не открываться, если в настройках базы отключён параметр Разрешить открытие по ссылкам извне (проверьте в Администрирование → Настройки программы → Интеграция и обмен данными).

2. Формирование ссылок через REST API

Для автоматизированных систем (например, интеграции с сайтом или CRM) удобно использовать REST API. Этот метод требует предварительной настройки сервера 1С и публикации REST-сервиса, но даёт гибкость в формировании ссылок.

Шаги для получения ссылки:

1. Опубликуйте базу как REST-сервис в Администрирование → Публикация на веб-сервере.
2. Включите опцию Использовать OAuth 2.0 для безопасности.
3. Сформируйте URL по шаблону:

   http://[сервер]/[база]/odata/standard.odata/[ТипДокумента](guid'[Идентификатор]')

   Например, для заказа с GUID 123e4567-e89b-12d3-a456-426614174000:

   http://erpserver.company.ru/main/odata/standard.odata/Document_SalesOrder(guid'123e4567-e89b-12d3-a456-426614174000')

Чтобы получить GUID документа, используйте запрос в 1С:

Выбрать
Ссылка.УникальныйИдентификатор Как GUID
Из
Документ.ЗаказПокупателя Как Ссылка
Где
Ссылка.Ссылка = &ТекущийДокумент

Опубликовать базу как REST-сервис|Включить OAuth 2.0|Проверить права доступа для пользователя|Сгенерировать токен доступа|Протестировать запрос в Postman-->

⚠️ Внимание: REST API доступен только в платных промышленных редакциях 1С (начиная с версии 8.3.15). В базовых версиях или учебных конфигурациях этот метод не работает. Также учтите, что прямые ссылки на документы через REST могут экспонировать чувствительные данные, если не настроена авторизация.

3. Ссылки через внешние обработки и расширения

Если веб-клиент и REST API недоступны, можно использовать внешние обработки или расширения конфигурации. Этот метод требует минимальных знаний 1С-программирования, но подходит для любых версий платформы.

Пример кода для обработки, которая копирует ссылку на документ в буфер обмена:

Процедура КопироватьСсылкуНаДокумент(Команда)
ТекущийДокумент = ПолучаемТекущийДокумент; // Ваш метод получения документа
ТекстСсылки ="doc://" + ТекущийДокумент.УникальныйИдентификатор +"?type=" + ТекущийДокумент.Метаданные.Имя;

ТекстВБуферОбмена(ТекстСсылки);
Сообщить("Ссылка скопирована:" + ТекстСсылки, СтатусСообщения.Информация);
КонецПроцедуры

Особенности метода:

• 🔹 Работает в любом клиенте (тонкий, толстый, веб).
• 🔹 Можно адаптировать под HTTP-ссылки, если база опубликована на сервере.
• 🔹 Требует прав на изменение конфигурации или подключение внешних обработок.

⚠️ Внимание: Ссылки в формате doc:// работают только внутри 1С. Для внешних систем их нужно конвертировать в HTTP с учётом настроек веб-сервера. Также учтите, что уникальные идентификаторы документов могут меняться при переносе базы между серверами.

4. Альтернативные способы для файлового варианта

Если вы используете файловый вариант 1С (без сервера), стандартные методы получения ссылок не работают. В этом случае можно:

1. Экспортировать документ в PDF/Excel и прикрепить файл к письму или задаче. Для этого используйте команду Файл → Сохранить как....
2. Использовать 1С:Drive (если подключён). Сервис автоматически генерирует ссылки длящего доступа к документам.
3. Настроить FTP-сервер и выгружать документы в формате JSON/XML с последующей генерацией ссылок.

Для автоматизации выгрузки можно использовать регламентное задание:

Процедура ВыгрузитьДокументВPDF(Документ)
ИмяФайла = КаталогВременныхФайлов +"Док_" + Документ.Номер +".pdf";
Документ.Вывести(ТипФайлаPDF, ИмяФайла);
Возврат ИмяФайла;
КонецПроцедуры

http://erpserver.company.ru/main/ru_RU?ref=Document.SalesOrder.12345&auth=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

// Пример вызова из 1С
HTTPЗапрос = Новый HTTPЗапрос("https://company.bitrix24.ru/rest/1/abcdefghijklmnop/crm.deal.add");
HTTPЗапрос.УстановитьТелоИзСтроки(
"{
'fields': {
'TITLE':'Заказ №" + Документ.Номер +"',
'UF_CRM_16XXXX':'" + ПолучитьСсылкуНаДокумент(Документ) +"'
}
}"
);
Ответ = HTTPЗапрос.Выполнить;