Интеграция со СБИС

СБИС.ЗаписатьКомплект (API отчетность)

СБИС.ЗаписатьКомплект (API отчетность)

Обращение к методу «СБИС.ЗаписатьКомплект» требуется для создания комплекта отчетности на портале online.sbis.ru перед подписанием и отправкой.

Метод «СБИС.ЗаписатьКомплект» принимает массив объектов «Документ». Структура каждого объекта сделана максимально преемственной со структурой «Документ», которая используется в методах интерфейса СБИС.

«СБИС.ЗаписатьКомплект» — аналог метода «СБИС.ЗаписатьДокумент» внешнего интерфейса ЭДО.

Перед выполнением метода нужно авторизоваться на портале online.sbis.ru.

Параметры запроса

Создание комплектов отчетности работает только по приложенным ссылкам на файловое хранилище. Для создания комплекта отчетов следует передать на вход метода «СБИС.ЗаписатьКомплект следующую» структуру данных.

  • "Документ": массив объектов. Указывается один элемент для каждой отправки в сторону хранилища файлов:
    • "Идентификатор": строка, идентификатор документооборота. В онлайне это поля "ДокументРасширение.ИдентификаторВИ"
    • "Примечание": строка, содержит тему для отправки писем
    • "Тип": строка, содержит тип документа согласно справочнику
    • "ПодТип": строка, в которой нужно указывать подтип комплекта отчетности в соответствии со справочником
    • "ДатаВремяСоздания": строка
    • "Расширение": объект, содержит информация о связанном документе:
      • "КомплектОснование": строка, содержит идентификатор UUID связанного документа. Указывается идентификатор требования, на которое отправляется уведомление о невозможности представления документов
      • "ОснованиеНомер": строка, номер связанного документа. В ней передается номер связанного документа требования
      • "ИдентификаторДокументаОснования": строка, UUID ранее созданного документа отправки. Заполняется, если нет возможности определить комплект в толстом клиенте
      • "ИдентификаторКомплекта": строка — UUID. Уникальный идентификатор комплекта отчетности
    • "Редакция": объект, содержащий информацию об идентификаторе объекта
    • "НашаОрганизация": объект. Указывается налогоплательщик, а при отправке филиала — филиал:
      • "ИдентификаторБиллинга": строка, необязательный параметр. Уникальный идентификатор абонента на биллинге и операторе
      • "СвЮЛ": объект, идентификатор клиента в биллинге:
        • "ИНН": строка
        • "КПП": строка
        • "КодФилиала": строка
        • "Название": строка
        • "НазваниеПолное": строка
      • "СвФЛ":
        • "​ИНН": строка
        • "Фамилия": строка
        • "Имя": строка
        • "Отчетство": строка
    • "Участники":
      • "​Отправитель": объект, отправитель отчетности. При отправке по доверенности не совпадает с плательщиком. Формат совпадает с форматом объекта "Документ.НашаОрганизация"
      • "Получатель": объект, государственный орган (при отправке отчетности):
        • "ГосударственнаяИнспекция": строка, идентификатор государственного органа
      • "КонечныйПолучатель": объект. При отправке по крупнейшим налогоплательщикам — код налогового органа, в котором плательщик зарегистрирован по месту нахождения. Если отправка не за крупнейшнего НП — равен объекту "Плательщик". По формату совпадает с "Документ.Участники.Получатель"
    • "Вложение": массив объектов, указывается для каждого отдельного файла в отправляемом отчете:
      • "Подтип": строка, содержит КНД отдельных файлов. Указывается для отчетов, которые могут быть включены в разные комплекты. Для остальных отчетов КНД указывается в поле "Документ.ПодТип" или в файле описания в теге "КНДФормы"
      • "Направление": строка, содержит значение "Исходящий"
      • "Идентификатор": строка, UUID идентификатор вложения
      • "ВерсияФормата": строка
      • "ПодВерсияФормата": строка
      • "Название": название отправленного отчета
      • "ТипПриложения": строка. Используется только для бухгалтерской отчетности
      • "Категория": строка, значение "Основное"/"Приложение"
      • "Файл": объект:
        • "Имя": строка, имя файла
        • "Ссылка": строка. Содержит ссылку для скачивания файла из хранилища файлов
      • "Подпись": массив объектов.
        • "Сертификат": объект, реквизиты владельца ЭП.
          • "Отпечаток": строка, отпечаток сертификата.
    • "Сертификат": массив объектов:
      • "Отпечаток": строка, обязательный параметр
      • "Ключ": объект.
        • "Тип": строка, значение "Серверный"/"Клиентский"
    • "Сведения": объект:
      • "ГоловнойПлательщик": объект. При отправке отчетности от филиала указать головную организацию. В остальных случаях объект не указывается
      • "Ссылка": строка, ссылка на файл описания формата XML
      • "Номер": строка, номер документа
      • "Описание": объект:
        • "ИмяФормы": строка, обязательный элемент для ФНС и РОССТАТ
        • "КНДФормы": строка
        • "ВидДокумента": строка
        • "НомерКорректировки": строка
        • "НомГар": строка, номер банковской гарантии для соответствующего документооборота. Обязательный элемент
        • "НомУвед": строка
        • "НоПоМестуУчета": строка, обязательный элемент для отправки отчетности в ФНС
        • "НоПоМестуНахождения": строка, указывается код из класификатора СОНО
        • "РегистрационныйНомерПФ": строка, указывается для Пенсионного Фонда
        • "РегистрационныйНомерОрганизации":строка
        • "НомерОтчета": строка
        • "ВидОтчета": строка, содержит вид отчета — бухгалтерский или статистический, указывается для РОССТАТ
        • "УполномоченнаяБухгалтерия": строка
        • "Тема": строка, тема письма для исходящих писем
        • "Категория": строка. Для отправки отчета в ПФ укажите занчение "МакетЭВД". Если не нужно указывать, то передайте пустой тег. Для ответов на ретроконверсию, в строке укажите текст "Ретроконверсия"
        • "СНИЛС": строка, обязательный элемент
        • "ВидСтажа": строка, вид пенсионного стажа сотрудника. Обязательный элемент для ПФР
        • "ДатаВыходаНаПенсию": строка, обязательный элемент для ПФР
        • "ОтветНа": строка, идентификатор документооборота входящего письма. Обязательно указывать для ответов на ретроконверсию
        • "КодЗапроса": строка, обязательный элемент для ФНС и ИОН
        • "НомерДокНП": строка, номер заявления о ввозе и уплате косвенных налогов. Указывать для любых документов с регламентом «Заявление». Обязательный элемент
        • "КолФайл": строка, количество файлов при отправке представления несколькими отправками
        • "ФИО": объект, обязательный элемент для ПФР:
          • "Фамилия": строка
          • "Имя": строка
          • "Отчество": строка
        • "Отчетный период": объект, обязательный элемент:
          • "Год": строка, год за который предоставляется отчет
          • "Код": строка, указывается согласно справочнику СКНП
          • "ИдентификаторВложения": строка, обязательный параметр. Позволяет сопосотавить период и отдельное вложение. Параметр нужен для отправки корректирующих сведений в ПФ, которые содержат отчеты за разный период
      • "Пакет": объект:
        • "ВерсПрог": строка, версия программы отправки отчета
        • "СКЗИ": строка, версия СКЗИ. Указывается для ПФР
        • "Доверенность": объект, необязательный элемент. Указывать только при отправке в ПФР подоверенности
          • "Номер": строка,номер доверенности
          • "НомерСоглашенияЭДО": строка
          • "ДатаНачалаДействия": строка
          • "ДатаОкончанияДействия": строка
          • "УполномоченныйПредставитель": объект:
            • "ИдентификаторСубъекта": строка, регистрационный номер для ПФР. Для передачи данных в ФСС параметр не указывается
            • "ИНН": строка, указывать только для отправки в ФСС
            • "КПП": строка, указывать только для отправки в ФСС
            • "Имя": строка, название уполномоченного представителя для ПФР и ФСС
          • "Доверитель":
            • "ИНН": строка
            • "КПП": строка
            • "Название": строка
            • "ИдентификаторСубъекта": строка, регистрационный номер доверителя
        • "СоглашениеСПФР": объект, необязательный элемент. При его отсутствии оператор не сможет проверить корректность регистрации абонента. Абоненту может прийти отказ от ПФР:
          • "Дата": строка
          • "Номер": строка
        • "НатуральныйИдентификатор": строка, обязательный элемент для ПРФ и РОССТАТ. Для ТОГС,ОКПО и ПФР нужно указать регистрационный номер организации отправителя
        • "ПрограммаФормированияОтчета": строка, программа, в которой сформированы отчеты
        • "ИП": объект, идентификатор налогоплательщика. Информация используется только для отчетности в ПФР:
          • "Идентификатор": строка, регистрационный номер индивидуального предпринимателя как физического лица
          • "Название": строка, название ИП
          • "КодКатегории": строка, код категории из отчета ПФР. Если такого кода нет — укажите «не записывать»

Результат запроса

  • "Иденитифкатор": строка
  • "Примечание": строка
  • "Тип": строка
  • "ПодТип": строка
  • "ДатаВремяСоздания": строка
  • "Редакция": объект:
    • "ПримечаниеИС": строка
  • "НашаОрганизация": объект:
    • "ИдентификаторБиллинга"
    • "СвЮЛ": объект:
      • "ИНН": строка
      • "КПП": строка
      • "КодФилиала": строка
      • "Название": строка
      • "НазваниеПолное": строка
    • "СвФЛ":
      • "ИНН": строка
      • "Фамилия": строка
      • "Имя": строка
      • "Отчество": строка
    • "Участники":
      • "Отправитель": объект
      • "Получатель": объект:
        • "ГосударственнаяИнспекция": строка
      • "КонечныйПолучатель": объект
    • "Вложение": массив объектов:
      • "Подтип": строка
      • "Направление": строка, "Исходящий"
      • "Идентификатор": строка идентификатор вложения
      • "ВерсифФормата": строка
      • "ПодВерсияФормата": строка
      • "Название": строка
      • "ТипПриложения": строка
      • "Категория": строка
      • "ХешУникальныхДанных": строка
      • "Файл": объект:
        • "Имя": строка, имя файла
        • "Ссылка": строка
    • "Сведения": объект:
      • "ГоловнойПлательщик": строка
      • "Ссылка": строка
    • "Сертификат": массив объектов:
      • "ФИО": строка
      • "Должность": строка
      • "ИНН": строка
      • "Название": строка
      • "Отпечаток": строка
      • "СерийныйНомер": строка
      • "Квалифицированный": строка "Да"/"Нет"
      • "ДействителенС": строка
      • "ДействителенПо": строка
      • "Ключ": объект:
        • "Активирован": "Да"/"Нет"
        • "СпособАктивации": строка
        • "Тип": строка

Пример запроса

{
   "jsonrpc":"2.0",
   "method":"СБИС.ЗаписатьКомплект",
   "params":{
      "Документ":[
         {
            "Идентификатор":"c20675b1da9c4584981d9c84ac824e9d",
            "Примечание":"",
            "Тип":"ОтчетФНС",
            "ПодТип":"",
            "ДатаВремяСоздания":"2018-04-16 14:40:00",
            "Редакция":{
               "ПримечаниеИС":"8c7808b5-0eee-11e7-8803-005056b7582b"
            },
            "Расширение":{
               "КомплектОснование":"",
               "ОснованиеНомер":"",
               "ИдентификаторДокументаОснования":""
            },
            "НашаОрганизация":{
               "ИдентификаторБиллинга":"0606457004",
               "СвЮЛ":{
                  "ИНН":"1708003233",
                  "КПП":"170801001",
                  "Название":"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ, ООО",
                  "НазваниеПолное":"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ, ООО",
                  "КодФилиала":""
               }
            },
            "Участники":{
               "Отправитель":{
                  "ИдентификаторБиллинга":"0606457004",
                  "СвЮЛ":{
                     "ИНН":"1708003233",
                     "КПП":"170801001",
                     "Название":"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ, ООО",
                     "КодФилиала":""
                  }
               },
               "Получатель":{
                  "ГосударственнаяИнспекция":"7666"
               },
               "КонечныйПолучатель":{
                  "ГосударственнаяИнспекция":"7666"
               }
            },
            "Вложение":[
               {
                  "Идентификатор":"2c85a541-41db-40bc-b155-d8b00fc5f8cc",
                  "Название":"НД по ЕНВД для отдельных видов деятельности (от 22.12.15)",
                  "Категория":"Основное",
                  "ТипПриложения":"",
                  "ПодТип":"1152016",
                  "Направление":"Исходящий",
                  "ВерсияФормата":"5.06",
                  "ПодВерсияФормата":"",
                  "Файл":{
                     "Имя":"NO_ENVD_7666_7666_1708003233170801001_20180416_32DB18D2-6551-4B41-A84B-0D8D3F3F49B9.xml",
                     "Ссылка":"https://online.sbis.ru/disk/api/v1/efb957ee-9d7a-4304-a827-c130f4e57832_2ba54e6c-9a15-4373-9634-de603a6df312?object=simple_file_sd&diskhmac=DnOIfRkH4if%2BU%2FqVHcJIaZrwhZs%3D"
                  }
               }
            ],
            "Сертификат":{
               "Отпечаток":"CC92BD0D5C9005184B455C7B165C3D8F98F3FEF6",
               "Ключ":{
                  "Тип":"Клиентский"
               }
            },
            "Сведения":{
               "Описание":{
                  "ИмяФормы":"Налоговая декларация по единому налогу на вмененный доход для отдельных видов деятельности",
                  "КНДФормы":"1152016",
                  "ВидДокумента":"первичный",
                  "НОПоМестуУчета":"7666",
                  "НОПоМестуНахождения":"7666",
                  "УполномоченнаяБухгалтерия":"true",
                  "КолФайл":"1",
                  "Период":[
                     {
                        "ИдентификаторВложения":"2c85a541-41db-40bc-b155-d8b00fc5f8cc",
                        "Код":"22",
                        "Год":"2016"
                     }
                  ]
               },
               "Пакет":{
                  "ВерсПрог":"СБИС 2.4.535",
                  "ПрограммаФормированияОтчета":"СБИС 2.4.375;СБИС 2.4.535"
               }
            }
         }
      ]
   },
   "id":0
}