Через программный интерфейс СБИС можно отправлять не только первичные документы, но и отчетность в государственные органы. Отправленные файлы можно будет найти в личном кабинете СБИС в разделе «Учет/Отчетность».
Как это работает
Для того чтобы обмениваться первичными документами с госорганами через API, в вашей системе нужно настроить алгоритмы отправки, расшифровки, а затем получения служебных документов и ответов от госорганов.
Отправить документы
Алгоритм используется для запуска комплекта отчетности в документооборот. Для того чтобы отправить документы:
- Подготовьте файлы отчетности.
- Авторизуйтесь на online.sbis.ru.
- Отправьте в файловое хранилище служебные и юридически значимые документы.
- Для отправляемого документа вызовите метод «СБИС.ЗаписатьКомплект».
- Выполните команду «СБИС.ПодготовитьДействие» и получите криптографический хеш.
- Подпишите криптографический хеш и вызовите метод «СБИС.ВыполнитьДействие».
Обработать служебные этапы
Алгоритм используется для расшифровки полученных ответов от госорганов, формирования и подписи служебных документов.
- Получите список служебных этапов с online.sbis.ru с помощью команды «СБИС.СписокСлужебныхЭтапов».
- Для каждого этапа вызовите метод «СБИС.ПодготовитьДействие». Если в ответе есть поле:
- «ТребуетРасшифровки»=«Да» — выполните расшифровку зашифрованного вложения с помощью закрытой части ключа. После этого:
- скачайте файл по ссылке в поле «Этап.Вложение[0].Файл»;
- расшифруйте файл с помощью закрытой части ключа из поля «Этап.Сертификат».
- «ТребуетПодписания»=«Да» — подпишите значение в поле «Этап.Вложение.Хеш» из результата команды «СБИС.ПодготовитьДействие».
Операции нужно провести для каждого вложения в ответе метода «СБИС.ПодготовитьДействие».
- «ТребуетРасшифровки»=«Да» — выполните расшифровку зашифрованного вложения с помощью закрытой части ключа. После этого:
- Вызовите команду «СБИС.ВыполнитьДействие». Метод нужно выполнять с приложенными к каждому вложению расшифрованными или подписанными данными.
Алгоритм обработки служебных этапов совпадает с формированием служебных документов через API СБИС.
Получение изменений с online.sbis.ru
Алгоритм используется для получения расшифрованных ответов от госорганов и синхронизации отчетности с online.sbis.ru. Фактом изменения являются события по документам. Для получения изменений:
- Вызовите команду «СБИС.СписокИзменений» по организации и последнему полученному событию.
- Проанализируйте ответ, сохраните полученные вложения, состояния документооборота и группы событий.
Алгоритм обработки изменений совпадает с получением входящих и контролем состояния исходящих документов с помощью API СБИС.
Вы можете отправлять зашифрованную отчетность, если политика конфиденциальности вашей компании требует не разглашать коммерческую информацию оператору связи. Отчетность и служебные документы будут расшифрованы только на стороне госоргана. API позволяет клиенту работать по направлениям:
- ФНС;
- ПФР, кроме регламентов ЭДО ПФР;
- Росстат;
- ФСС, кроме ЭЛН и СЭДО.
Отправить первичные документы
- Подготовьте файлы отчетности. Подпишите и зашифруйте их, если этого требует регламент.
- Авторизуйтесь на online.sbis.ru.
- Отправьте подготовленные файлы в хранилище, в заголовке запроса передайте признак шифрования.
- Вызовите метод СБИС.ОтправитьЗашифрованныйОтчет. В результате вернется ID сеанса обмена. Сохраните его.
Отправка завершена.
Отправить служебные документы
- Подготовьте файлы служебных документов. Подпишите и зашифруйте их, если этого требует регламент.
- Авторизуйтесь на online.sbis.ru.
- Отправьте подготовленные файлы в хранилище, в заголовке запроса передайте признак шифрования.
- Вызовите метод СБИС.ОтправитьСлужебныйДокумент. В качестве параметров передайте ID сеанса обмена, название транзакции и ссылку на файл или тело файла в формате base64.
Получить ответы от госорганов и входящей корреспонденции
Если в документообороте произошло событие (получено извещение или протокол), документ считается измененным. Получите список изменений:
- Вызовите команду «СБИС.СписокИзменений» по организации и последнему полученному событию.
- Проанализируйте ответ, сохраните полученные вложения. Если на вложении стоит флаг «Упакован» или «Зашифрован», распакуйте или расшифруйте файл.
С чего начать
- Зарегистрируйтесь на sbis.ru.
- Подключите один из тарифов сервиса «Отчетность» и «Внедрение ЭДО» сервиса «Электронный документооборот».
- Подключите внешнюю систему к СБИС и настройте для нее авторизацию.
- Настройте свою информационную систему так, чтобы она вызывала методы API-интерфейса и обрабатывала возвращаемые данные.