Коротко: Подключение GigaChat к 1С начните с контрольного запроса из тестового контура. Затем проверьте разбор одного вида документов, структуру полей и доступность исходника для сверки. При сбое сотрудник должен увидеть состояние задания и продолжить работу вручную.
Скан акта из двух страниц
Бухгалтер получает акт, где реквизиты находятся на первой странице, а часть услуг — на второй. До оценки модели проверьте, как в выбранной схеме загружается файл или извлекается текст. Поддержку форматов и структурированного ответа уточняют по версии API и модели. Если текст распознаётся отдельно, передавайте номера страниц и порядок строк. Руководство по GigaChat API, структурированный вывод GigaChat.
Для результата задайте номер, дату, период услуги, список строк и отметки о нечитаемых значениях. Сохраните исходный документ и привязку к странице в доступном бухгалтеру месте. Схема ответа помогает проверить форму данных. Суммы, число строк и соответствие оригиналу всё равно проверяют в 1С и при просмотре документа.
Ведомость проверки от сервера до рабочего места
| Условие | Что проверяет администратор | Что видит бухгалтер |
|---|---|---|
| Первый запрос без рабочих данных | Связь из нужного контура, авторизацию и выбранную модель | Подтверждение готовности тестовой обработки |
| Две страницы и повёрнутый скан | Формат входа, порядок страниц и наличие текста | Черновик с источниками и отметкой, если поле нечитаемо |
| Ошибка авторизации | Код и время отказа без раскрытия ключа | Задание ожидает исправления подключения |
| Тайм-аут | Идентификатор и историю попыток | Можно взять документ вручную |
| Неверная структура | Причину отклонения ответа | Поля не попали в подтверждённый документ |
Перед пилотом проверьте соединение именно с узла, который выполняет обмен из 1С. Рабочий запрос с компьютера администратора подтверждает другой сетевой путь. Для диагностики используйте коды и описания поставщика. Для временных ошибок согласуйте число повторов и условия остановки, а при отказе авторизации проверьте настройки. Описание ошибок GigaChat API, как устроить журнал обмена.
Что записать в журнал при неразобранном акте
Администратор открывает запись по идентификатору обработки и видит время начала, версию API, результат загрузки, число переданных страниц, статус ответа и причину отклонения. Если ответ успешный, а сумма в черновике расходится с документом, журнал помогает отделить проблему связи от ошибки распознавания или извлечения. Для бухгалтера достаточно причины «проверьте сумму на второй странице» и ссылки на файл. В диагностике исключите секреты и копии документов, которые не нужны для проверки. Если доступ к подробному запросу требуется на пилоте, согласуйте отдельную роль и срок хранения. Проверьте журнал после ошибки и после восстановления, чтобы одинаковое задание можно было найти по одной цепочке попыток.
Приёмка на комплекте актов
Возьмите читаемый акт, акт с продолжением таблицы и файл с плохо видимой датой. Сначала сравните подготовленный вход с оригиналом. Затем проверьте, что бухгалтер открыл нужную страницу и сверил полученные поля. Если пропущена вторая страница, зафиксируйте, на каком шаге она потерялась.
На тестовой базе повторите запрос после тайм-аута. В рабочем списке должен появиться один принятый результат по одному заданию. Отключите внешнюю обработку и оформите документ вручную. В акте приёмки укажите версию интеграции, образцы, ожидаемый итог и наблюдаемое поведение при каждом сбое. С чего начать пилот в 1С.