Загрузка и создание документов

Что это и зачем

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

Модуль кроссистемный: он работает и для подключений 1С, и для подключений iiko. Общая часть (загрузка, распознавание, проверка, создание) одинакова; различаются только типы документов и поля, специфичные для каждой системы. Какой набор открывается, определяется типом активного подключения и его настройками.

Где находится и как открыть

Экран выбора типа документа называется Загрузка документов (заголовок «Выберите тип документа»); отдельно есть экран справочников Работа с мастер-данными. В текущем интерфейсе попасть на них можно несколькими путями:

• Из Библиотеки документов. Это основной сценарий. Откройте Библиотеку (пункт Библиотека в группе Действия левого меню) и для готовой строки нажмите «Создать в системе» — откроется нужный мастер загрузки сразу на шаге проверки.
• Из самого мастера. Внутри страниц справочников (номенклатура, рецептуры, контрагенты) кнопка «Назад» возвращает на экран выбора типа документа, где можно выбрать другой тип.
• По прямой ссылке. Экран выбора и страницы конкретных документов открываются по своим адресам в приложении.

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

Как пользоваться (общие шаги)

Сценарий для всех типов документов и обеих систем единый:

1. Выберите тип документа на стартовом экране (плитка с названием и описанием).
2. Загрузите файл. Можно загрузить скан, фотографию или электронный файл документа. Поддерживаются изображения и PDF, а также офисные форматы — DOCX и XLSX/XLS. Можно выбрать сразу несколько файлов.
3. Дождитесь распознавания. Система выполняет OCR (оптическое распознавание текста) и затем извлекает из текста структурированные поля документа — реквизиты, табличную часть, суммы и налоги.
4. Проверьте и при необходимости поправьте извлечённые поля. На этом шаге система уже подставляет найденные в учётной базе сущности (контрагента, организацию, договор, номенклатуру). Вы можете скорректировать значения и выбрать недостающие из справочников.
5. Создайте документ. По кнопке создания документ записывается в учётную систему. После успеха система покажет подтверждение.

Как это работает

Под каждым типом документа работает единый конвейер обработки:

• Загрузка в хранилище. Файл сначала загружается в объектное хранилище — либо по подписанной (presigned) ссылке напрямую в бакет, либо прокси-загрузкой через сервис. Дальше обработка идёт по ссылке на файл, без передачи самого файла в теле последующих запросов.
• OCR. Распознавание текста выполняет встроенный OCR-клиент (основной провайдер — Yandex Vision, с поддержкой русского и английского). Изображения нестандартных форматов (PNG, WEBP, HEIC и др.) автоматически приводятся к виду, пригодному для распознавания; PDF обрабатываются как документы. Офисные файлы (DOCX, XLSX/XLS) обрабатываются отдельной веткой извлечения текста без OCR.
• Извлечение полей. По распознанному тексту языковая модель извлекает структурированные данные документа (шапка и строки). Для каждого типа документа используется свой промпт извлечения.
• Обогащение из учётной базы. Извлечённые контрагент/организация ищутся в системе по ИНН и наименованию, подбирается договор, строки сопоставляются с номенклатурой. Найденные сущности подставляются в форму проверки.
• Создание документа. После подтверждения данные отправляются в учётную систему командой создания документа. Для ряда типов 1С перед отправкой выполняется предварительная проверка обязательных полей (например, наличие контрагента и суммы).

Права доступа

Все операции загрузки и создания документов, а также вспомогательные справочные запросы (счета учёта номенклатуры, группы номенклатуры и контрагентов, значения перечислений, справочники iiko) требуют права Загрузка документов (upload). Без этого права раздел и его страницы недоступны. Назначение прав выполняется в разделе Пользователи.

На частоту операций действуют ограничения: выдача ссылок на загрузку файлов ограничена примерно 12 запросами в минуту на пользователя и подключение; создание приходной накладной в iiko — 6 в минуту, создание товара или поставщика в iiko — по 12 в минуту. При слишком частых попытках система попросит немного подождать.

Возможности для 1С

Для подключения 1С на экране выбора в разделе Покупки доступны следующие типы документов (видимость каждого зависит от настроек конкретной конфигурации 1С):

• УПД — Поступление — универсальный передаточный документ от поставщика (товары и услуги). Создаёт поступление в 1С.
• Приобретение товаров и услуг — загрузка поступлений товаров и услуг (открывается тот же мастер УПД в режиме приобретения).
• Загрузка Чеков — распознавание кассовых чеков для создания поступления (товары и услуги).
• Товарная накладная (ТОРГ-12) — загрузка товарных накладных для создания поступления (только товары).

Отдельный экран справочников (Работа с мастер-данными, раздел Справочники) позволяет создавать и пополнять мастер-данные 1С:

• Номенклатура — массовое создание номенклатуры из файлов.
• Рецептуры — загрузка рецептур для общепита (конфигурации БИТ): распознаётся блюдо, ингредиенты и посуда, выполняется поиск номенклатуры, создаётся документ рецептуры. Доступно только если для подключения включена соответствующая функция.
• Контрагенты — создание контрагента по ИНН (с подбором реквизитов и созданием договора по умолчанию, если это применимо к конфигурации).

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

Возможности для iiko

Для подключения iiko на экране выбора доступна одна плитка в разделе Покупки — Поступление товаров («Загрузка приходной накладной от поставщика (УПД, ТОРГ-12, чек)»). Она открывает мастер Приходная накладная.

Процесс тот же, что и для 1С: загрузка файла, OCR, извлечение полей, проверка, создание документа. Отличия в части, специфичной для iiko:

• Перед распознаванием изображение или PDF предварительно классифицируется по типу документа (УПД / ТОРГ-12 / чек) с помощью распознавания по картинке, чтобы применить подходящий промпт извлечения. Офисные файлы (DOCX, XLSX/XLS) шаг классификации пропускают.
• Вместо поиска по справочникам 1С выполняется сопоставление с данными iiko: подбираются поставщик, склад поступления и товарные позиции (продукты), а также единицы измерения. Недостающего поставщика или товар можно создать в iiko прямо из мастера; сопоставления товаров запоминаются, чтобы в следующий раз позиции распознавались автоматически.
• На выходе создаётся приходная накладная в iiko. Дату документа система приводит к формату iiko автоматически. При необходимости накладную можно сразу провести (статус «обработана»).

Ограничения

• Создавать документы можно только при выбранном подключении нужного типа; без активного подключения экраны загрузки недоступны.
• Для 1С перечень типов документов ограничен настройками конкретной конфигурации — если тип не разрешён, его плитка не отображается. Рецептуры требуют включённой функции и конфигурации БИТ.
• OCR расходует суточный лимит страниц подключения; при его исчерпании распознавание новых файлов недоступно до сброса лимита.
• Действуют ограничения на частоту запросов (загрузка файлов, создание документов/товаров/поставщиков в iiko); при превышении приходит ответ с просьбой подождать.
• Качество автоматического заполнения зависит от читаемости скана или фото — нечёткие или повёрнутые изображения распознаются хуже, поэтому шаг проверки полей обязателен.
• «Авансовый отчёт» и «Акты сверки» сейчас отключены и не описаны как рабочие сценарии.

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

Какие форматы файлов можно загружать? Фотографии и сканы (в том числе JPG, PNG, WEBP, HEIC), PDF, а также офисные форматы DOCX и XLSX/XLS. Можно выбрать несколько файлов сразу.

Документ не появился сразу после загрузки — это нормально? Да. После загрузки идут распознавание и извлечение полей (это может занять несколько секунд). Документ создаётся только после вашего подтверждения на шаге проверки.

Можно ли не загружать файл повторно, если он уже есть в Библиотеке? Да. Откройте документ в Библиотеке и выберите «Создать в системе» — мастер откроется сразу на проверке, без повторного OCR. Это и есть основной способ начать создание документа.

Почему я не вижу возможности загрузки? Скорее всего, у вашей учётной записи нет права Загрузка документов. Обратитесь к администратору (раздел Пользователи).