ОТПРАВКА ЭЛЕКТРОННОЙ ОТЧЕТНОСТИ ЧЕРЕЗ API-ИНТЕРФЕЙС

Отправка электронной отчетности через API-интерфейс

Через программный интерфейс СБИС (API) можно отправлять не только первичные документы, но и отчетность в государственные органы.Обработка ошибок API-интерфейса Все отчеты, которые отправлены c помощью API, будут находиться в разделе «Учет/Отчетность». Для их отправки и обмена с государственными органами необходимо выполнить определенные алгоритмы.

На заметку!

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

Алгоритм отправки документов

Предназначается для запуска документа отчетности в документооборот

Алгоритм подразделаяется на шаги:

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

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

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

Обработка служебных этапов подразделаяется на шаги:

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

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

Алгоритм получения изменений с online.sbis.ru

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

Алгоритм получения изменений подразделяется на шаги:

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

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

 

0
0
Оставьте свой отзыв:
ОТПРАВИТЬ