Интеграция с информационной системой

Запросить электронный лист нетрудоспособности

Запросить электронный лист нетрудоспособности

Используя API-интерфейс вы можете подготовить и отправить файл запроса электронного листа нетрудоспособности (ЭЛН). В ответ на них ФСС пришлет подтверждение о получении вашего запроса.

Отправьте запрос ЭЛН
Получите лист нетрудоспособности от ФСС
  1. Авторизуйтесь на online.sbis.ru под пользователем с правами «Бухгалтер по отчетности» с помощью протокола O-Auth.
  2. Подготовьте файл запроса ЭЛН. Для отправки запроса используйте служебный формат файла СБИС.

    Пример

    • В поле «regNum» укажите регистрационный номер работодателя в ФСС.
    • В поле «lnCode» — номер листка нетрудоспособности.
    • В поле «snils» — СНИЛС получателя пособия.
  3. Отправьте запрос ЭЛН в файловое хранилище и получите идентификатор объекта.
  4. Вызовите метод «СБИС.ЗаписатьКомплект».

    Комментарий

    • В полях «Идентификатор», «Расширение.ИдентификаторКомплекта», «Вложение.Идентификатор» передаются уникальные значение при каждом вызове метода.
    • Значение поля «Сведения.Период.ИдентификаторВложения» должно совпадать со значением поля «Вложение.Идентификатор».
    • Значение полей «Тип», «Подтип», «Вложение.Подтип», «Вложение.ВерсияФормата», «Вложение.ПодверсияФормата» нужно всегда указывать согласно справочнику типов документов и типов вложений.
  5. Вызовите метод «СБИС.ПодготовитьДействие».

    В ответе метода:

    • «Идентификатор», «Вложение.Идентификатор» должны совпасть с соответствующими параметрами вызова метода «СБИС.ЗаписатьКомплект»;
    • Значение параметра «Этап.Действие.ТребуетПодписание»=«Да»;
    • Параметр «Этап.Действие.ТипПодписи» говорит о том, что будет выполнено подписание для SOAP-протокола портала ФСС;
    • «Этап.Вложение.Файл.Хеш» содержит данные, которые вы подписываете.
  6. Подпишите криптографический хеш, который получен в ответе «СБИС.ПодготовитьДействие». Чтобы подписать хеш используйте функцию WinAPI CryptSignHash или ее аналог.
  7. Вызовите метод «СБИС.ВыполнитьДействие».

Ваш запрос ЭЛН сформирован и отправлен через online.sbis.ru. После отправки, в личном кабинете СБИС появится ваш комплект электронного листка нетрудоспособности.

Через несколько минут ФСС сформирует и автоматически вышлет электронный листок нетрудоспособности.

Теперь нужно обработать служебные этапы и скачать с online.sbis.ru расшифрованный ЭЛН.

  1. Вызовите метод «СБИС.СписокСлужебныхЭтапов». В параметрах укажите реквизиты организации по которой будете обрабатывать служебные этапы.

    В ответе метода обратите внимание:

    • метод вернул один ответ «Этап.Действие» с типом «ТребуетРасшифровки»;
    • идентификатор документа, которому соответствует «Этап» совпадает с идентификатором отправленного в поле «ЗаписатьКомплект» документа ;
    • метод может вернуть больше одного этапа (максимум 20, для указанных параметров «Навигации»). Типы этапов и их документы могут быть разными, но все они должны быть обработаны по общему алгоритму.
  2. Для этапа ответа вызовите метод «СБИС.ПодготовитьДействие».

  3. Расшифруйте тело ответа. Для этого скачайте файл по ссылке в ответе от метода «СБИС.ПодготовитьДействие» («Этап.Вложение.Файл.Ссылка»).

    Пример

  4. Чтобы обеспечить конфиденциальность передаваемых данных сервис высылает ответ, который зашифрован по стандарту XMLEncryptionSyntaxandProcessing(W3C).

    Шифрование сессионного ключа и данных происходит по алгоритму ГОСТ 28147-89.

    С учетом этих особенностей, создайте операции расшифровки в вашей информационной системе. На вход передайте тело сообщения ответа, которое приведено в примере выше.

  5. Вызовите метод «СБИС.ВыполнитьДействие». Расшифрованные данные передайте на вход в поле «ДвоичныеДанные». Тело ответа кодируется в Base64.

  6. Если методы «ПодготовитьДействие» и «ВыполнитьДействие» не были вызваны, то документооборот по ЭЛН не будет завершен. Метод «СБИС.ПодготовитьДействие» не возвращает ответ, а выполняет только обработку ответа. Для получения ответа используйте данные метода «СБИС.СписокИзменений».
  7. Вызов метода «СБИС.СписокСлужебныхЭтапов» повторяйте пока он не вернет пустой массив этапов и пока все этапы не будут обработатаны.
  8. Когда все служебные этапы будут обработаны, получите свежие ответы с online.sbis.ru. Для этого вызовите метод «СБИС.СписокИзменений», который вернет, в том числе, и расшифрованные вами ответы.

    Комментарий

    • Метод «СБИС.СписокИзменений» вернет в поле «Событие» список завершенных событий документооборота по всем документам в кабинете контрагента. К каждому событию приложены расшифрованные файлы и подписи.
    • Если нужно отделить события по запросу ЭЛН от прочих документов, проверьте значения полей «Тип»=«РеестрФСС», «Расширение.ПодТип»=«GETPRIVATELDATA».
    • Значения полей «Состояние» и «Событие.Группа» описывают состояние документооборота по больничному.
    • Вызов метода «СБИС.СписокИзменений» нужно повторять пока не будут обработаны все события. Для этого в вашей учетной системе должен храниться идентификатор последнего обработанного события (из поля «Событие.Идентификатор»). Передайте его на вход при следующем вызове метода «СписокИзменений».
  9. Скачайте файл по ссылке в поле «Событие.Вложение.Файл.Ссылка». Ссылка находится в событии «Ответ», вложение с подтипом «GETPRIVATELNDATARESPONSE».

    Пример

    Файл электронного больничного: