API сервиса «Отчетность»

Через программный интерфейс СБИС можно отправлять не только первичные документы, но и отчетность в государственные органы. Отправленные файлы можно будет найти в личном кабинете СБИС в разделе «Учет/Отчетность».

Как это работает

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

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

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

1. Подготовьте файлы отчетности.
2. Авторизуйтесь на online.sbis.ru.
3. Отправьте в файловое хранилище служебные и юридически значимые документы.
4. Для отправляемого документа вызовите метод «СБИС.ЗаписатьКомплект».
5. Выполните команду «СБИС.ПодготовитьДействие» и получите криптографический хеш.
6. Подпишите криптографический хеш и вызовите метод «СБИС.ВыполнитьДействие».

Обработать служебные этапы

Алгоритм используется для расшифровки полученных ответов от госорганов, формирования и подписи служебных документов.

1. Получите список служебных этапов с online.sbis.ru с помощью команды «СБИС.СписокСлужебныхЭтапов».
2. Для каждого этапа вызовите метод «СБИС.ПодготовитьДействие». Если в ответе есть поле:
   • «ТребуетРасшифровки»=«Да» — выполните расшифровку зашифрованного вложения с помощью закрытой части ключа. После этого:
     • скачайте файл по ссылке в поле «Этап.Вложение[0].Файл»;
     • расшифруйте файл с помощью закрытой части ключа из поля «Этап.Сертификат».
   • «ТребуетПодписания»=«Да» — подпишите значение в поле «Этап.Вложение.Хеш» из результата команды «СБИС.ПодготовитьДействие».

   Операции нужно провести для каждого вложения в ответе метода «СБИС.ПодготовитьДействие».

3. Вызовите команду «СБИС.ВыполнитьДействие». Метод нужно выполнять с приложенными к каждому вложению расшифрованными или подписанными данными.

Алгоритм обработки служебных этапов совпадает с формированием служебных документов через API СБИС.

Получение изменений с online.sbis.ru

Алгоритм используется для получения расшифрованных ответов от госорганов и синхронизации отчетности с online.sbis.ru. Фактом изменения являются события по документам. Для получения изменений:

1. Вызовите команду «СБИС.СписокИзменений» по организации и последнему полученному событию.
2. Проанализируйте ответ, сохраните полученные вложения, состояния документооборота и группы событий.

Алгоритм обработки изменений совпадает с получением входящих и контролем состояния исходящих документов с помощью API СБИС.

С чего начать

1. Зарегистрируйтесь на sbis.ru.
2. Подключите один из тарифов сервиса «Отчетность» и «Внедрение ЭДО» сервиса «Электронный документооборот».
3. Подключите внешнюю систему к СБИС и настройте для нее авторизацию.
4. Настройте свою информационную систему так, чтобы она вызывала методы API-интерфейса и обрабатывала возвращаемые данные.