Отправка протоколов через API: очередь и статусы

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

Личный кабинет

Отправка протоколов через API: очередь и статусы

Отправка через API проходит несколько стадий: подготовка документов, электронная подпись, серверная очередь и обработка во ФГИС ФСА. Проверяйте результат каждого протокола. Подписанный документ или завершённое окно прогресса ещё не подтверждают публикацию.

В этой статье

Краткий порядок отправки

  1. Проверьте API-подключение, готовность документов и личной электронной подписи.
  2. На вкладке «К публикации» выберите нужные протоколы и нажмите «Отправить».
  3. Завершите необходимые этапы подписи и дождитесь подтверждения принятия очереди сервером.
  4. Проверьте статусы каждой строки и результат публикации в нужном контуре.
Подготовка, подпись и проверка результата API-отправки каждого протокола
Этапы отправки и возможные результаты по отдельному протоколу.

Подготовка выбора

Откройте «Лаборатория» → «Синхронизация». Проверьте подключение по инструкции настройки API. Для рабочих документов нужны рабочий контур и соответствующий ключ. До завершения текущего обмена не переключайте общий режим и не заменяйте ключ.

  • У протокола должен быть статус «Утверждён» и разрешена публикация.
  • Откройте скан/PDF заранее и проверьте содержание, номер, дату и объект. Отправка через API не заменяет проверку самого документа.
  • Проверьте актуальность связей сотрудников, оборудования и показателей, а также результат проверки по области аккредитации.
  • Подготовьте личную ЭЦП и криптографический компонент на поддерживаемом устройстве.
  • Снимите лишние отметки, оставшиеся от предыдущего выбора. Не включайте в новую отправку строки, которые уже обрабатываются или ожидают назначенного повтора.

Запуск передачи и подпись

  1. На вкладке «К публикации» отметьте подготовленные протоколы.
  2. Нажмите «Отправить» и сверьте количество в подтверждении. Программа исключает недоступные к отправке и занятые строки; прочитайте сообщения о пропусках.
  3. Дождитесь подготовки сканов и завершите предлагаемые этапы подписи: сначала скан-копии, затем XML со сведениями протокола.
  4. Если программа предлагает выбрать сертификат, используйте подходящий личный сертификат. При действующей привязке он может подставляться без повторного выбора.
  5. Дождитесь сообщения о принятии очереди сервером. Затем контролируйте «Статус выгрузки» и итоговую сводку.
Выбор двух протоколов на вкладке К публикации и кнопка Отправить
Отмечены два протокола. 1. Кнопка «Отправить» запускает обработку выбранных строк.

При первой отправке обычно нужны оба этапа подписи. Если данные и контур не изменились, программа может использовать ранее подготовленные материалы. Отсутствие повторного выбора сертификата или запроса подписи само по себе не означает успешную публикацию.

Если часть документов не удалось подписать или сервер отклонил подпись изменившегося XML, проверьте причину в строке. Успешно подтверждённая часть может продолжить отправку. Исправляйте и повторно проверяйте только оставшиеся документы.

Сообщение о принятии сервером очереди из двух протоколов
1. Подтверждение принятия очереди позволяет закрыть страницу. Публикацию каждого протокола проверяют отдельно.

Статусы и действия пользователя

Надпись или стадияЧто делать
Подготовка, «Подписание скан-копий», «Подписание протоколов»Оставаться на странице и завершить запросы личной ЭЦП.
«Поставлено в очередь отправки»Сервер принял задание. Проверять дальнейшие статусы, не запускать дубликат.
«Отправлено во ФГИС ФСА», «Ожидание обработки ФГИС ФСА»Дождаться внешнего ответа. Эти надписи ещё не подтверждают публикацию.
«На проверке ФГИС ФСА», «В обработке ФГИС ФСА»Контролировать дальнейший результат. При необходимости запросить актуальный статус.
Сбой ФГИС с указанием назначенного повтораДать серверу выполнить повтор. Не отправлять занятую строку вручную.
Причина ошибки в строкеПрочитать причину и сохранить полный лог. Выяснить, требуется ли исправление данных или сбой относится к внешней системе.
«Опубликовано во ФГИС РА»Проверить строку в «Опубликованные», внешний идентификатор и нужный контур.

После подтверждения, что сервер принял очередь, страницу можно закрыть. До этого закрытие или перезагрузка во время личного подписания может прервать необходимый этап. Принятие задания сервером не гарантирует принятие документа ФГИС.

Если подтверждение не получено или связь оборвалась, сначала перечитайте список, проверьте статусы и лог. Отсутствие ответа не доказывает, что операция не состоялась.

Партии и автоматические повторы

В «Настройки» → «Подключение к ФГИС» уполномоченный пользователь может изменить параметры обработки. Ниже приведены значения по умолчанию; фактические настройки лаборатории могут отличаться.

  • «Протоколов в одной партии»: 2, допустимо от 1 до 10. Задаёт размер очередной партии.
  • «Отправок одного протокола»: 5, допустимо от 1 до 10. Включает первую отправку, а не только повторы.
  • «Пауза перед повтором»: 60 секунд, допустимо от 10 до 600 секунд.
  • «Предел одной отправки»: 30 минут, допустимо от 5 до 180 минут. Ограничивает длительность одной операции сервера и не задаёт срок публикации во ФГИС.

Автоматически повторяются только предусмотренные временные сбои. Ошибки реквизитов и содержания требуют устранения причины. Не увеличивайте все лимиты одновременно из-за одного отказа.

При превышении времени операции назначенные повторы могут продолжиться фоновыми задачами. Если сервер не успел начать отправку отдельного протокола, возможен результат «Не отправлено: превышено время операции, повторите отправку». Проверьте статус и лог этой строки, затем запустите её повторно, если она доступна к отправке. Не включайте в повтор уже занятые документы.

Проверка статусов и длительное ожидание

Отметьте нужные строки и нажмите «Проверить». Кнопка запрашивает актуальные статусы, а не выполняет принудительную повторную отправку. Надпись «Проверка статуса…» является промежуточной. При сетевом отказе перечитайте список и сохраните текст ошибки.

Протоколы с ожиданием обработки, временным сбоем и ошибкой данных
Строки требуют разных действий. 1. «Проверить» запрашивает актуальный статус выбранных протоколов.

При длительном «Ожидание обработки ФГИС ФСА» выберите эту строку, запросите статус и сохраните полный лог. Для зависших запросов предусмотрен отдельный автоматический механизм переотправки. По умолчанию порог составляет 3 часа, общий лимит составляет 3 попытки с учётом первой. Для продолжения нужны сохранённые файлы, подписи и выполнение условий обработки. Это не обещание публикации через 3 часа.

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

Итоговая сводка может содержать опубликованные, ошибки, ожидающие ответа ФГИС и пропущенные документы. Например, из пяти протоколов три опубликованы, один ожидает ответа и один отклонён. Завершение прогресса не означает успех всех пяти.

Диагностический лог и кеш обмена

В контекстном меню доступны три варианта получения материалов:

  • «Лог обмена со ФГИС (в буфер)»: полный разбор с идентификаторами, статусами, временем и историей.
  • «Лог последней попытки (в буфер)»: сведения о последней попытке.
  • «Скачать XML-запросы ФГИС»: файлы запросов для проверки переданных сведений.

Отмеченные строки определяют состав выгрузки. Для разбора одного протокола снимите посторонние отметки. После копирования дождитесь подтверждения и проверьте вставленный текст.

Контекстное меню протокола с командой копирования полного лога обмена
1. Полный лог нужен для разбора всех попыток выбранного протокола.

«Очистить кеш обмена со ФГИС» применяют после определения причины, например при проблеме сохранённых сведений о вложениях. Сначала сохраните лог. Следующая отправка может потребовать повторной подготовки и подписи.

Очистка не является обычным обновлением списка и не отменяет запрос во ФГИС. Активные запросы пропускаются; идентификатор запроса и история сохраняются. Подробный разбор приведён в статье «Ошибки публикации: повторы, статусы и журнал обмена».

Контроль завершения

После публикации проверьте «Опубликованные», внешний идентификатор и результат в нужном контуре. Эта вкладка показывает общий журнал TesLab. Текущий переключатель тестового или рабочего режима не определяет, где был опубликован прежний документ. Если контур попытки неизвестен, не делайте вывод только по текущей настройке.

Тестовый результат не подтверждает рабочую публикацию. Для обращения к оператору укажите номер и дату тестовой передачи и приложите лог. Успешный тест подтверждает проверенный маршрут, но не гарантирует принятие любого будущего документа.

Отдельно проверьте выданный заказчику комплект. Принятие серверной очереди, публикация во ФГИС и доставка заказчику подтверждаются разными результатами.

Продолжение работы