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

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

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

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

ФГИС ФСА, API, тестовый контур, ключ, подключение, заявление, лог Комментарии

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

В этой статье

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Руководителю ИЛ: все статьи раздела.
  • Следующая статья: Отправка протоколов через API: очередь и статусы.