Отчетность через интернет

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

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

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

Обратите внимание: для правильной работы методов нужно указывать версию API внешнего интерфейса в заголовке запроса: X-API-Version: 2.3.1.

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

Для того чтобы обмениваться первичными документами с госорганами через 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-интерфейса и обрабатывала возвращаемые данные.

Лицензия

Для работы с API-сервисами СБИС требуется тариф «Внедрение ЭДО» сервиса «Электронный документооборот».

Для отправки отчетности: