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

Через API Saby можно отправлять как первичные документы, так и отчеты в госорганы — при условии, что отправка отчета реализована в Saby. Все отправленные файлы доступны в личном кабинете.

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

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

Вы можете воспользоваться типовыми сценариями работы для обмена документами с государственными органами — ФНС, СФР, Росстатом, ФСКАТР (ФСРАР), РПН и МВД.

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

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

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

При отправке запросов «СБИС.ЗаписатьКомплект» соблюдайте лимит — не более 10 запросов в минуту. Иначе система заблокирует пользователя.

Обработка служебных этапов

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

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

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

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

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

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

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

С чего начать

1. Зарегистрируйтесь в Saby.
2. Подключите внешнюю систему к Saby и настройте для нее авторизацию.