Присоединяйтесь!

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

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 СБИС.

Вы можете отправлять зашифрованную отчетность, если политика конфиденциальности вашей компании требует не разглашать коммерческую информацию оператору связи. Отчетность и служебные документы будут расшифрованы только на стороне госоргана. API позволяет клиенту работать по направлениям:

  • ФНС;
  • ПФР, кроме регламентов ЭДО ПФР;
  • Росстат;
  • ФСС, кроме ЭЛН и СЭДО.

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

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

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

  1. Подготовьте файлы служебных документов. Подпишите и зашифруйте их, если этого требует регламент.
  2. Авторизуйтесь на online.sbis.ru.
  3. Отправьте подготовленные файлы в хранилище, в заголовке запроса передайте признак шифрования.
  4. Вызовите метод СБИС.ОтправитьСлужебныйДокумент. В качестве параметров передайте ID сеанса обмена, название транзакции и ссылку на файл или тело файла в формате base64.

Получить ответы от госорганов и входящей корреспонденции

Если в документообороте произошло событие (получено извещение или протокол), документ считается измененным. Получите список изменений:

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

С чего начать

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