Подключение ФГИС ФСА через API

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

Подключение ФГИС ФСА через API

Для подключения API сначала проверяют обмен в тестовом контуре, затем получают рабочие реквизиты. На этих двух этапах используют отдельные ключи и разные режимы подключения. Учебная публикация не переносится в рабочий кабинет при переключении.

В этой статье

Соберите всё для первого теста

Понадобятся право изменения параметров лаборатории, тестовый ключ вашей организации, настроенная личная ЭЦП и отдельный учебный протокол с доступным PDF. Ключ копируют из полученных реквизитов полностью и хранят как секрет доступа.

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

Ниже подробно описаны заявление, настройка, тест, лог и переход к рабочему обмену. Срок и условия выдачи доступа определяет оператор, а не отметка о сохранении поля TesLab.

Два этапа подключения API: тестовый контур, подтверждение теста и отдельный рабочий ключ.
Схема подключения API: тестовый и рабочий контуры используют разные ключи. После подтверждения теста меняют и режим, и ключ.

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

Что понадобится

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

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

Подключение задаётся для всей лаборатории на данном сервере TesLab. Сохраняется один текущий режим и один API-ключ. Переключение режима не подбирает другой ключ: тестовый ключ нужно заменить рабочим, когда оператор предоставит рабочий доступ. До завершения тестовой отправки не меняйте общие параметры подключения.

Получение тестового доступа

Если ключ ещё не получен, откройте «Лаборатория» → «Синхронизация» → «Настройки» → «Инструкция по подключению». В окне «Подключение TesLab ко ФГИС ФСА» нажмите «Скачать заявление».

Открытие инструкции само по себе не отправляет заявление или протокол. Кнопка «Скачать заявление» формирует файл; передать оформленное обращение в ФСА нужно отдельно.

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

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

Что проверить в заявлении

В документ подставляются сведения организации и лаборатории, а контактным лицом становится сотрудник, который скачивает заявление. Это не обязательно специалист, ответственный за подключение. Проверьте и при необходимости замените его ФИО, должность, телефон и email.

  • Исходящий номер и дату обращения. Вместо образца или подсказки должен стоять ваш номер.
  • Наименование, ИНН, ОГРН, адрес организации, должность и ФИО руководителя.
  • Полное название лаборатории и уникальный номер записи об аккредитации.
  • Контакты технического специалиста, который будет получать ответ оператора.
  • Тип размещения TesLab и внешний IP сервера, с которого будет идти обмен. Это адрес сервера, а не IP компьютера с браузером.

Если осталось пустое поле или надпись «УКАЖИТЕ», заполните её до передачи документа. Автоматическая подстановка не заменяет проверку заявления.

Отдельный тестовый протокол

Подготовьте учебную запись, которую нельзя перепутать с реальным рабочим документом. Заполните обязательные сведения, утвердите её, задайте различимый номер, например «ТЕСТ-1», и проверьте разрешение публикации. Подпишите подготовленный документ в TesLab либо загрузите согласованный для теста PDF.

Учебный файл допустим только в отдельном тестовом сценарии, согласованном для проверки подключения. Не используйте его как скан реального рабочего протокола. Наличие PDF не отменяет электронного подписания при API-отправке: передаваемые данные проходят собственные этапы подписи.

Перед первым тестом дополнительно проверьте:

Название «ТЕСТ-1» помогает различить запись, но само по себе не подготавливает её данные к отправке.

Тестовый режим и ключ

  1. Откройте «Лаборатория → Синхронизация → Настройки».
  2. В «Подключение к ФГИС» выберите «Режим синхронизации ФГИС» → «Тестовый сервер API».
  3. Дождитесь успешного сохранения режима.
  4. В появившееся поле «API-ключ от ФГИС ФСА» вставьте полный тестовый ключ из письма.
  5. Щёлкните вне поля и дождитесь отметки сохранения.
  6. Обновите страницу только после завершения записи, затем повторно проверьте режим и наличие ключа.

Отдельной кнопки «Сохранить» нет: параметры записываются при изменении. Выбранная строка списка до ответа сервера ещё не подтверждает рабочий режим. Если поле ключа не видно, проверьте API-режим; если отсутствует весь блок, проверьте право настройки.

Тестовый сервер API и поле API-ключа в настройках подключения.
На снимке: 1. Выбранный тестовый режим. 2. Поле API-ключа с подсказкой о ранее сохранённом значении.

Во время записи дождитесь окончания индикатора сохранения. Если показана ошибка, новый параметр не следует считать подтверждённым. После повторного чтения ключ скрыт: подсказка «сохранён · введите новый, чтобы заменить» сообщает о наличии сохранённого ключа. Она не доказывает, что последняя неуспешная попытка заменила прежнее значение. Для замены вводите полный новый ключ, без маски, пробелов внутри и переносов строки.

Первая отправка

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

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

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

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

Лог успешного теста

После подтверждённой отправки найдите учебный документ на вкладке «Опубликованные». Вкладка «Опубликованные» показывает общий журнал TesLab и не разделяет строки по текущему тестовому или рабочему режиму. Найденный учебный документ и результат тестовой отправки не подтверждают публикацию в рабочем кабинете.

  1. Уберите выбор с посторонних строк.
  2. Откройте контекстное меню учебного протокола.
  3. Выберите «Лог обмена со ФГИС (в буфер)».
  4. Дождитесь сообщения «Скопировано в буфер: 1 прот.».
  5. Вставьте лог в подготовленный ответ и проверьте его содержимое.

Если тест завершился ошибкой, этот же лог доступен на «К публикации». Не пишите об успешном тесте по одному началу очереди.

Контекстное меню учебного протокола и пункт копирования полного лога обмена со ФГИС.
На снимке: 1. «Лог обмена со ФГИС (в буфер)» для учебного документа.

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

Для ответа оператору выбирайте полный «Лог обмена со ФГИС (в буфер)». Пункт «Лог последней попытки (в буфер)» даёт сокращённый результат без полной истории и не заменяет полный лог автоматически. Сообщение «Скопировано» подтверждает копирование, а не успешность теста.

Перед письмом сверьте номер и дату протокола, Request ID запроса и окончательный результат обработки. Если в логе указан контур, проверьте и его. В старых данных контур может отсутствовать: не определяйте его по одному текущему режиму TesLab. Тестовую публикацию проверяют в тестовом контуре; переход в рабочий кабинет не подтверждает результат теста.

Ответ оператору и рабочий доступ

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

Здравствуйте! Выполнили тестовую отправку протокола из TesLab в тестовую среду ФГИС ФСА. Организация: [название]. Протокол: ТЕСТ-1. Дата отправки: [дата]. Просим проверить результат тестирования и предоставить реквизиты для рабочего подключения. Ниже прилагаем лог обмена: [вставленный текст лога].

Вставка из буфера: Ctrl+V в Windows или ⌘+V на Mac. Перед отправкой проверьте, что вместо пояснения появился сам лог и результат действительно успешен. Письмо готовит и отправляет уполномоченный сотрудник по действующему порядку.

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

Переход на рабочий контур

После получения рабочего ключа откройте настройки, выберите «Рабочий сервер API» и замените тестовый ключ рабочим. Дождитесь сохранения обоих параметров, обновите страницу и проверьте их снова. Нужно изменить и режим, и ключ. После этого используйте только подготовленные реальные документы и контролируйте результат по каждому.

Для возврата к ранее настроенному агенту выбирают «TesLab SyncFSA сервер (локальный агент)». Его подключение проверяется отдельно. API-маршрут не требует локального агента, но требует доступной ЭЦП и правильного ключа. Переключение режима не переносит тестовый документ в рабочую публикацию автоматически.

Если подключение не получается

  • Нет блока подключения: проверьте право «Параметры лаборатории». Для отсутствующего поля ключа проверьте, выбран ли тестовый или рабочий API-режим.
  • Ключ не сохраняется: сверьте контур, полноту ключа и сообщение об ошибке. При отказе проверки связи не считайте новый ключ сохранённым; прежняя подсказка могла относиться к старому ключу.
  • Учебного протокола нет на «К публикации»: проверьте его утверждение, разрешение публикации, доступ к записи и фильтры журнала.
  • Не завершается подписание: проверьте доступность личного сертификата, носителя и криптографического компонента на выбранном устройстве.
  • Нет лога обмена: проверьте выбранный документ и факт API-отправки. Наличие строки в общем журнале само по себе не создаёт данные API-обмена.
  • Результат неизвестен: обновите журнал, получите лог и проверьте документ во внешнем контуре. Дождитесь завершения уже начатой обработки перед повтором и сменой режима.

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

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