Алгоритм работы с методами в проактивных выплатах

Особенности документооборотов в СЭДО

• Для получения документов от ФСС нужно выполнить подписку оператора на организацию по РНС.

• Входящие документообороты от ФСС в статусе received не содержат документов. Чтобы их получить и поменять статус документооборотов, нужно сформировать запрос на получение документов.

• Все отправляемые в СЭДО документы являются SOAP-запросами.

• Запросы должны быть подписаны подписью в формате XMLDsig.

• Результат приема отчета «Сведения о застрахованном лице» нужно смотреть в документе «Результат регистрации сведений о застрахованных лицах» (urn:document:fss-sedo-insured-person-registration-result-response-result) по каждому СНИЛС отдельно.

• В проактивных выплатах сохраняется отправка реестров ПВСО, подробнее о порядке взаимодействия с ФСС читайте в статье Проактивные выплаты.

Работа с исходящими документооборотами

В схеме проактивных выплат работодатель направляет в ФСС следующие исходящие документообороты:

• urn:docflow:fss-sedo-insured-person-registration – сведения о застрахованных лицах;

• urn:docflow:fss-sedo-proactive-payments-reply – ответ на запрос проверки, подтверждения, корректировки сведений проактивной выплаты страхового обеспечения;

• urn:docflow:fss-sedo-benefit-payment-initiation – инициация выплат пособия;

• urn:docflow:fss-warrant-management – запрос на регистрацию и отзыв доверенности ФСС;

• urn:docflow:fss-sedo-demand-reply – ответ на требование ФСС;

• urn:docflow:fss-sedo-billing-information-demand – запрос на формирование справки о расчетах ФСС;

• urn:docflow:fss-sedo-baby-care-vacation-close-notice – уведомление о прекращении отпуска по уходу за ребенком до полутора лет.

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

Создание и отправка черновика

1. Создайте черновик: POST Create draft. При создании черновика в теле запроса обязательно укажите:

   1. в payer параметр registration-number-fss;

   2. в recipient параметр fss-code.

   Для формирования МЧД в payer укажите следующие параметры:

   3. ogrn – ОГРН, заполняется юридическими лицами и индивидуальными предпринимателями;

   4. snils – СНИЛС, заполняется индивидуальными предпринимателями и физическими лицами.

2. Загрузите файл документа в Сервис контентов.

3. Создайте документ в черновике: POST Add Document. При создании укажите ссылку на документ в виде идентификатора из Сервиса контентов.

4. Возьмите идентификатор контента для подписания из метаинформации ответа метода Add Document в поле data-to-sign-content-id и получите данные через Сервис контентов.

5. Подпишите эти данные необработанной (raw) подписью.

6. Приложите подпись к документу: POST Add signature.

7. Когда черновик готов, запустите последовательность методов: POST Check -> POST Prepare -> POST Send. Укажите флаг deferred = true для отложенного выполнения задач.

8. Проверьте статус выполнения задач для методов Check, Prepare, Send: GET DraftTask. Если запрос по методу Send завершился успешно, то в ответе вернется информация о созданном документообороте (ДО).

В рамках проактивных выплат ДО считается завершенным после отправки черновика. Когда ФСС обработает данные, отправит документ с результатом обработки или приема сообщения. На него нужно отправить ответный документ «Отметка о прочтении». О том, как сформировать и отправить отметку о прочтении читайте в разделе Отправка ответных документов.

Для каждого документооборота поступит соответствующий входящий документооборот от ФСС. Документы отобразятся в исходящем и входящем ДО.

Работа с входящими документооборотами от ФСС

Работа с входящими документооборотами от ФСС состоит из нескольких этапов:

1. Поиск входящих документооборотов от ФСС.

2. Запрос на получение документов в ФСС.

3. Отправка ответных документов.

Поиск входящих документооборотов от ФСС

Найдите входящие документообороты от ФСС: GET Docflows. В запросе укажите фильтр type и тип нужного ДО согласно спецификации, например, type=fss-sedo-pvso-notification&type=fss-sedo-sick-report-change-notification&type=fss-sedo-error.

Важно

В результатах поиска не будет документооборотов с типами fss-sedo-*, если их тип не был указан в параметре type.

Новые документообороты будут отображаться в статусе received. Для получения документов и смены статуса ДО нужно отправить запрос на получение документов от ФСС. Далее работайте с каждым ДО по отдельности.

Запрос на получение документов от ФСС

Для получения документов от ФСС нужно сформировать, подписать и отправить запрос. Для этого используйте методы генерации запроса в СЭДО ФСС:

1. Создайте запрос на получение документов от ФСС: POST GenerateDocumentsRequest. В запросе укажите id найденного входящего документооборота. В ответе метод вернет шаблон запроса и хэш для подписи.

2. Подпишите хэш, который вернется в параметре DataToSign в формате byte[].

3. Добавьте необработанную подпись к запросу: PUT SaveDocumentsRequestSignature.

4. Отправьте запрос на получение документов в ФСС: POST SendDocumentsRequest.

Когда ФСС обработает запрос, он отправит запрошенный документ и статус ДО поменяется:

1. Для следующих документооборотов документы появятся во входящих ДО:

   • urn:docflow:fss-sedo-insured-person-registration-result – результат регистрации сведений о застрахованном лице;

   • urn:docflow:fss-sedo-proactive-payments-reply-result – результат обработки ответа на запрос проверки;

   • urn:docflow:fss-warrant-management-result – результат создания или отзыва доверенности ФСС;

   • urn:docflow:fss-sedo-demand-reply-result – резульат ответа на требование ФСС;

   • urn:docflow:fss-sedo-billing-information-demand-result – результат обработки запроса справки о расчетах ФСС;

   • urn:docflow:fss-sedo-benefit-payment-status-notice – уведомление о статусе выплаты пособия.

Документы также отобразятся в соответствующих исходящих документооборотах.

Статус ДО поменяется на finished и они будут считаться завершенными.

2. Для следующих документооборотов документы появятся только во входящих ДО:

   • urn:docflow:fss-sedo-pvso-notification – извещение ПВСО;

   • urn:docflow:fss-sedo-sick-report-change-notification – уведомление об изменении статуса ЭЛН;

   • urn:docflow:fss-sedo-demand – требование ФСС.

Статус ДО поменяется на response-arrived. Для данных документооборотов потребуется отправка ответных документов: «Отметка о прочтении» и «Извещение о прочтении».

3. Для остальных входящих документооборотов статус поменяется на response-arrived. Документы будут только во входящем ДО. Для данных документооборотов потребуется отправка ответного документа «Отметка о прочтении».

Примечание

Рекомендуем для дальнейшей работы каждый документооборот вычитать отдельно методом GET Docflow.

Отправка ответных документов

Отметка о прочтении

1. Найдите в поле documents полученного ДО документ с соответствующим типом:

Документооборот	Тип документа
urn:docflow:fss-sedo-pvso-notification	urn:document:fss-sedo-pvso-notification-notification-message
urn:docflow:fss-sedo-sick-report-change-notification	urn:document:fss-sedo-sick-report-change-notification-notification-message
urn:docflow:fss-sedo-insured-person-mismatch	urn:document:fss-sedo-insured-person-mismatch-mismatch-message
urn:docflow:fss-sedo-proactive-payments-benefit	urn:document:fss-sedo-proactive-payments-benefit-benefit-message
urn:docflow:fss-sedo-proactive-payments-demand	urn:document:fss-sedo-proactive-payments-demand-demand-message
urn:docflow:fss-sedo-insured-person-registration	urn:document:urn:document:fss-sedo-insured-person-registration-response-result
urn:docflow:fss-sedo-proactive-payments-reply	urn:document:fss-sedo-proactive-payments-reply-response-result
urn:docflow:fss-sedo-benefit-payment-initiation	urn:document:fss-sedo-benefit-payment-initiation-result-document
urn:docflow:fss-warrant-management	urn:document:fss-warrant-management-response-message
urn:docflow:fss-sedo-demand	urn:document:fss-sedo-demand-message
urn:docflow:fss-sedo-demand-reply	urn:document:fss-sedo-demand-reply-result-document
urn:docflow:fss-sedo-billing-information-demand	urn:document:fss-sedo-billing-information-demand-result-document
urn:docflow:fss-sedo-billing-information	urn:document:fss-sedo-billing-information-message
urn:document:fss-sedo-baby-care-vacation-close-notice	urn:document:fss-sedo-baby-care-vacation-close-notice-result-document
urn:docflow:fss-sedo-employee-salary-information	urn:document:fss-sedo-employee-salary-information-result-document

2. Чтобы получить файл документа, возьмите идентификатор content-id в метаинформации документа, в модели docflow-document-contents и скачайте документ из Сервиса контентов.

3. Создайте ответный документ «Отметка о прочтении» к полученным документам. Это можно сделать несколькими способами:

   1. Сгенерирйте ответный документ: POST CreateReplyDocument. Используйте идентификатор найденного документа для поля documentId. Укажите в поле documentType тип документа для нужного ДО из таблицы ниже.

   2. Перейдите по ссылке из поля links в параметре rel, содержащей тип нужного ответного документа.

   Типы ответных документов для генерации отметки о прочтении:

Тип входящего документа	Тип ответного документа
urn:document:fss-sedo-pvso-notification-notification-message	urn:document:fss-sedo-pvso-notification-receipt
urn:document:fss-sedo-sick-report-change-notification-notification-message	urn:document:fss-sedo-sick-report-change-notification-receipt
urn:document:fss-sedo-insured-person-mismatch-mismatch-message	urn:document:fss-sedo-insured-person-mismatch-receipt-receipt
urn:document:fss-sedo-proactive-payments-benefit-benefit-message	urn:document:fss-sedo-proactive-payments-benefit-receipt
urn:document:fss-sedo-proactive-payments-demand-demand-message	urn:document:fss-sedo-proactive-payments-demand-receipt
urn:document:fss-sedo-benefit-payment-initiation-result-document	urn:document:fss-sedo-benefit-payment-initiation-read-receipt
urn:document:fss-sedo-insured-person-registration-receipt	urn:document:fss-sedo-insured-person-registration-read-receipt
urn:document:fss-sedo-proactive-payments-reply-receipt	urn:document:fss-sedo-proactive-payments-reply-read-receipt
urn:document:fss-warrant-management-response-message	urn:document:fss-warrant-management-response-read-receipt
urn:document:fss-sedo-demand-message	urn:document:fss-sedo-demand-read-receipt
urn:document:fss-sedo-demand-reply-result-document	urn:document:fss-sedo-demand-reply-read-receipt
urn:document:fss-sedo-billing-information-demand-result-document	urn:document:fss-sedo-billing-information-demand-read-receipt
urn:document:fss-sedo-billing-information-message	urn:document:fss-sedo-billing-information-read-receipt
urn:document:fss-sedo-baby-care-vacation-close-notice-result-document	urn:document:fss-sedo-baby-care-vacation-close-notice-read-receipt
urn:document:fss-sedo-employee-salary-information-result-document	urn:document:fss-sedo-employee-salary-information-read-receipt

Подписывать «Отметку о прочтении» не нужно.

4. Отправьте ответный документ: POST SendReplyDocument. После отправки отметки о прочтении статус документооборота поменяется на finished.

Извещение о прочтении

Помимо отметки о прочтении для документооборотов urn:docflow:fss-sedo-pvso-notification, urn:docflow:fss-sedo-sick-report-change-notification и urn:docflow:fss-sedo-demand нужно дополнительно создать, подписать и отправить в ФСС ответный документ «Извещение о прочтении».

1. Создайте ответный документ. Это можно сделать несколькими способами:

   1. Сгенерируйте ответный документ: POST CreateReplyDocument. При запросе указывает в поле documentType тип документа, который имеет вид fss-sedo-*-receipt-notification-message, где * - наименование документооборота.

   2. Перейдите по ссылке из поля links в параметре rel, содержащей тип нужного ответного документа.

2. Возьмите контент подписи из метаинформации созданного документа в параметре data-to-sign.

3. Подпишите эти данные необработанной (raw) подписью.

4. Добавьте подпись к ответному документу: PUT ReplyDocumentSignature.

5. Отправьте ответный документ: POST SendReplyDocument. После отправки отметки о прочтении статус документооборота поменяется на finished.

Результат принятия извещения о прочтения появится в текущем и во входящем документообороте urn:docflow:fss-sedo-receipt-notification-result – результат подтверждения прочтения.

Работа с ошибками

Если в ходе документооборота с СЭДО ФСС появится ошибка, то она может поступить:

• в виде документа в исходном ДО. В этом случае статус документооборота поменяется на finished. Типы документов об ошибке будут иметь вид fss-sedo-*-exchange-error, где * - наименование документооборота;

• в виде отдельного документооборота urn:docflow:fss-sedo-error. В этом случае перейдите к алгоритму работы с входящими документооборотами от ФСС. Документ с ошибкой от ФСС отобразится во входящем и в исходящем ДО. Статус входящего ДО поменяется на finished. Типы документов об ошибке будут иметь вид fss-sedo-*-error-massage, где * - наименование документооборота.

Тестирование сценариев

Если для тестирования вы используете сертификаты Контура, то они уже готовы для работы с СЭДО. Если вы используете другие сертификаты, то сертификаты удостоверяющих центров должны быть добавлены в список доверенных сертификатов со стороны ФСС.

Для удобства тестирования сценариев работы в СЭДО ФСС используйте коллекции Postman:

• Работа с исходящими документооборотами.

• Работа с входящими документооборотами.

В примерах xml-файлов ниже укажите данные из вашей учетной записи. Обратите внимание, что данные в сертификате должны совпадать с данными вашей учетной записи.

• Сведения о застрахованных лицах, пример.xml

• Ответ на запрос проверки подтверждения, корректировки сведений проактивной выплаты страхового обеспечения, пример.xml