Ссылка на документ из 1С: как отправить её клиенту и открыть на другой стороне
Содержание
Ссылку на любой документ в 1С 8.3 сотрудник получает за секунду: открыть документ и нажать Shift+F11 или значок цепочки в заголовке формы. Но такая ссылка откроется только у того, у кого есть учётная запись в этой же базе. Клиенту она ничего не даст: чтобы покупатель скачал документ по ссылке, нужен файл (PDF) в доступном ему месте или опубликованная на веб-сервере база с отдельным механизмом выдачи.
Механизм ссылок общий для платформы 8.3, поэтому порядок действий одинаков в Бухгалтерии 3.0, УТ 11, ЗУП 3.1 и других типовых конфигурациях. Различаются только названия документов и печатных форм.
Какие бывают ссылки на документ 1С и чем они отличаются
Под словами «документ из 1С по ссылке» скрываются три разные вещи. Их часто путают, и отсюда половина жалоб «прислали ссылку — не работает ».
| Вид ссылки | Как выглядит | Кто может открыть | Для чего подходит |
|---|---|---|---|
| Навигационная ссылка | e1cib/data/Документ.РеализацияТоваровУслуг?ref=... | Пользователь этой же базы с правами на документ | Передать коллеге, вставить в задачу или письмо внутри компании |
| Ссылка веб-клиента | https://сервер/имя_публикации/#e1cib/data/... | Пользователь базы, который входит через браузер под своим логином | Удалённые сотрудники, работа без установки платформы |
| Ссылка на файл | https://.../schet-1245.pdf или ссылка облачного диска | Любой, у кого есть ссылка (или пароль к ней) | Клиенты, поставщики, контрагенты |
🔗 Навигационная ссылка — это адрес объекта внутри базы. В ней зашит уникальный идентификатор документа (GUID), а не его номер. Поэтому ссылка не меняется, если документ перенумеровать.
🌐 Ссылка веб-клиента — та же навигационная ссылка, к которой спереди приписан адрес опубликованной базы. Браузер откроет страницу входа, а после авторизации — нужный документ.
📄 Ссылка на файл — единственный вариант, рассчитанный на внешнего получателя. Клиент не входит в 1С и не видит базу. Он получает готовую печатную форму: счёт, акт, накладную, сверку.
Если клиенту нужен счёт или акт, ему нужна не «ссылка на документ 1С», а ссылка на PDF-файл печатной формы. Пускать внешнего человека в рабочую базу ради одного счёта не стоит.
Публикация базы на веб-сервере: что нужно, чтобы ссылка работала через интернет
Навигационная ссылка внутри офиса работает без настройки. Чтобы она открывалась из браузера за пределами локальной сети, базу публикуют на веб-сервере.
Что потребуется
- 🖥 веб-сервер: IIS на Windows Server 2016 и новее или Apache;
- 🧩 модули расширения веб-сервера, которые ставятся вместе с платформой 1С (компонент нужно отметить при установке);
- 🌍 внешний адрес: белый IP или доменное имя, направленное на сервер;
- 🔒 сертификат TLS, чтобы ссылка открывалась по
https://; - 👤 учётная запись пользователя в базе для каждого, кто будет входить.
Порядок публикации
- Запустите Конфигуратор от имени администратора Windows. Без этого публикация не сможет записать файлы в каталог веб-сервера.
- Откройте
Администрирование → Публикация на веб-сервере. - Укажите имя публикации латиницей, например
buh. Оно станет частью адреса:https://сервер/buh/. - Выберите веб-сервер (IIS или Apache) и каталог публикации.
- Отметьте публикацию тонкого и веб-клиента. HTTP-сервисы отмечайте, только если они нужны (о них ниже).
- Нажмите «Опубликовать». Для Apache после публикации перезапустите службу веб-сервера.
- Проверьте адрес в браузере на самом сервере, затем снаружи сети.
Перезапуск веб-сервера обрывает сеансы всех, кто сейчас работает через браузер. Делайте это вне рабочего времени или предупредите пользователей заранее.
После публикации любая навигационная ссылка превращается во внешнюю простым склеиванием: адрес публикации + # + сама ссылка.
Навигационная ссылка:
e1cib/data/Документ.СчетНаОплатуПокупателю?ref=a1b2c3d4e5f60718293a4b5c6d7e8f90
Ссылка для браузера:
https://1c.example.ru/buh/#e1cib/data/Документ.СчетНаОплатуПокупателю?ref=a1b2c3d4e5f60718293a4b5c6d7e8f90
Публикация открывает базу в интернет. Без HTTPS и надёжных паролей у всех пользователей так делать нельзя.
Как получить ссылку на документ в 1С: шаги для сотрудника
Здесь сценарий зависит от того, кому адресована ссылка.
Ссылка для коллеги из той же базы
- Откройте документ, например «Реализация (акт, накладная)» или «Счёт покупателю».
- Нажмите
Shift+F11или значок цепочки в правом верхнем углу формы. - В окне появится строка вида
e1cib/data/.... Скопируйте её. - Отправьте коллеге в почте, мессенджере или вставьте в задачу.
Коллега открывает её так: в 1С вызывает главное меню (кнопка с тремя полосками в левом верхнем углу), выбирает команду «Перейти по ссылке» и вставляет строку. Если база опубликована, ссылку можно открыть сразу в браузере в формате, показанном выше.
Ссылка на документ для клиента
Здесь нужен файл. Самый быстрый и надёжный путь в типовых конфигурациях:
- Откройте документ и нажмите «Печать», выберите нужную форму (счёт, акт, ТОРГ-12, УПД).
- В окне печатной формы сохраните её в PDF через кнопку сохранения.
- Загрузите PDF в облачное хранилище компании или на файловый сервер с внешним доступом.
- Создайте ссылку на этот файл, ограничьте срок её действия и, если хранилище позволяет, задайте пароль.
- Отправьте клиенту ссылку. Пароль — другим каналом (например, СМС вместо почты).
Если документ уходит по почте прямо из 1С, ссылка часто и не нужна. В окне печатной формы есть кнопка отправки по почте: 1С сама сформирует письмо с PDF во вложении. Ссылка выигрывает, когда вложение слишком большое, почта клиента режет файлы или нужно, чтобы документ был доступен ограниченное время.
Выдача документов по ссылке через HTTP-сервис
Для потока клиентов (интернет-магазин, сервисная компания, сотни счетов в день) вручную загружать PDF неудобно. Программист добавляет в базу HTTP-сервис в расширении конфигурации. Сервис по короткому одноразовому токену находит документ, формирует печатную форму и отдаёт её браузеру как PDF.
Схема выглядит так:
- при проведении или по кнопке 1С генерирует случайный токен и запоминает пару «токен → документ, срок действия» в регистре сведений;
- в письмо клиенту уходит ссылка вида
https://1c.example.ru/buh/hs/docs/get?t=токен; - сервис проверяет токен и срок, формирует табличный документ и возвращает PDF;
- клиент видит только этот файл, а не базу.
Каркас обработчика метода GET в модуле сервиса:
Функция ПолучитьДокументGET(Запрос)
Токен = Запрос.ПараметрыЗапроса.Получить("t");
Документ = НайтиДокументПоТокену(Токен); // поиск в регистре сведений с проверкой срока
Если Документ = Неопределено Тогда
Возврат Новый HTTPСервисОтвет(404);
КонецЕсли;
ТабДок = СформироватьПечатнуюФорму(Документ); // ваша процедура печати
ИмяФайла = ПолучитьИмяВременногоФайла("pdf");
ТабДок.Записать(ИмяФайла, ТипФайлаТабличногоДокумента.PDF);
Ответ = Новый HTTPСервисОтвет(200);
Ответ.Заголовки.Вставить("Content-Type", "application/pdf");
Ответ.УстановитьТелоИзДвоичныхДанных(Новый ДвоичныеДанные(ИмяФайла));
УдалитьФайлы(ИмяФайла);
Возврат Ответ;
КонецФункции
Функции НайтиДокументПоТокену и СформироватьПечатнуюФорму пишутся под вашу конфигурацию. Сервис публикуется той же командой публикации на веб-сервере, с отметкой HTTP-сервисов. Для его работы нужен отдельный пользователь базы с минимальными правами: только чтение нужных документов и регистра токенов.
Делайте токен длинным и случайным (например, строка из Новый УникальныйИдентификатор), а не номером документа. Иначе любой перебором скачает чужие счета.
Действия получателя: как клиенту открыть и скачать файл
На стороне клиента всё проще, но и тут бывают затруднения. Подскажите получателю порядок действий заранее, особенно если он получает документы по ссылке впервые.
- Откройте ссылку из письма или мессенджера в браузере. Если почтовая программа открывает её во встроенном окне — скопируйте адрес и вставьте в обычный браузер.
- Если хранилище запрашивает пароль, введите тот, что пришёл отдельным сообщением.
- PDF откроется во встроенном просмотрщике браузера или сразу начнёт скачиваться.
- Чтобы сохранить файл , нажмите значок загрузки в панели просмотрщика или выберите в меню браузера «Сохранить как».
- Проверьте, что в файле нужный документ: номер, дата, сумма, реквизиты.
Для документов с подписью есть нюанс. PDF из ссылки — это копия печатной формы. Юридическую силу в электронном виде имеет документ с электронной подписью, который приходит через оператора ЭДО. Если клиенту нужен оригинал для учёта, договоритесь, как он его получит: через ЭДО или на бумаге с подписью и печатью.
Почему ссылка на документ 1С не открывается: ошибки и решения
Большинство проблем сводится к тому, что ссылку одного типа пытаются открыть способом, рассчитанным на другой. Остальное — права и настройки сервера.
Если ни одна причина не подходит, откройте ту же ссылку на сервере, где опубликована база. Открывается там — проблема в сети: брандмауэр, проброс портов, DNS. Не открывается и там — смотрите публикацию и права.
Безопасность передачи документов 1С по ссылке
Ссылка — это ключ. Кто её получил, тот и открыл. Поэтому правила простые, но соблюдать их нужно все.
Для опубликованной базы
- 🔒 только
https://, без открытого HTTP; - 👤 у каждого пользователя свой логин и сложный пароль, общий «клиентский» пользователь без пароля недопустим;
- 🚫 в публикации отключите всё, что не используется: веб-клиент, если хватает тонкого клиента, и лишние HTTP-сервисы;
- 🧱 доступ к адресу публикации по возможности только через VPN или с разрешённых IP;
- 📜 включённый журнал регистрации, чтобы видеть, кто и что открывал.
Для ссылок на файлы клиентам
- ⏳ ограниченный срок действия ссылки: неделя для счёта обычно достаточно;
- 🔑 пароль на ссылку, переданный отдельным каналом;
- 🎲 случайный длинный токен в адресе, а не номер документа или ИНН;
- 🗑 удаление файлов из хранилища после срока;
- 📬 проверка адресата перед отправкой: ссылка, ушедшая не тому клиенту, раскрывает цены и условия.
Печатные формы часто содержат персональные данные: ФИО, паспортные данные в доверенностях, адреса физлиц. Их передача по открытой ссылке без ограничения доступа — нарушение требований закона о персональных данных. Для таких документов ссылка должна быть с паролем и сроком действия, а лучше — канал ЭДО.
Частые вопросы
Можно ли открыть навигационную ссылку 1С без установленной платформы?
Меняется ли ссылка на документ, если изменить его номер или дату?
Откроется ли ссылка из рабочей базы в её копии?
Чем ссылка на PDF хуже отправки через ЭДО?
Сколько стоит организовать выдачу документов клиентам по ссылке?
Источники
- Федеральный закон от 27.07.2006 № 152-ФЗ «О персональных данных»
- Федеральный закон от 06.04.2011 № 63-ФЗ «Об электронной подписи»