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

Чтобы создать комплект отчетности на online.sbis.ru, используется команда «СБИС.ЗаписатьКомплект». После этого документы можно подписать и отправить.

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

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

Перед тем как выполнить метод, авторизуйтесь в личном кабинете СБИС.

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

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

• "Документ": массив объектов. Чтобы отправить массив в хранилище файлов, укажите один элемент:
  • "Идентификатор": строка, идентификатор документооборота. В онлайн-кабинете это поля "ДокументРасширение.ИдентификаторВИ"
  • "Примечание": строка, содержит тему для отправки писем
  • "Тип": строка, содержит тип документа согласно справочнику
  • "ПодТип": строка, в которой нужно указать подтип комплекта отчетности в соответствии со справочником
  • "ДатаВремяСоздания": строка
  • "Расширение": объект, содержит информацию о связанном документе:
    • "КомплектОснование": строка, содержит идентификатор UUID связанного документа. Укажите идентификатор требования, на которое отправляется уведомление о том, что невозможно представить документы
    • "ОснованиеНомер": строка, номер связанного документа. В ней передается номер связанного документа требования
    • "ИдентификаторДокументаОснования": строка, UUID ранее созданного документа отправки. Заполняется, если нет возможности определить комплект в толстом клиенте
    • "ИдентификаторКомплекта": строка — UUID. Уникальный идентификатор комплекта отчетности
  • "Редакция": объект, содержащий информацию об идентификаторе объекта
  • "НашаОрганизация": объект. Указывается налогоплательщик, а при отправке филиала — филиал:
    • "ИдентификаторБиллинга": строка, необязательный параметр. Уникальный идентификатор абонента на биллинге и у оператора связи
    • "СвЮЛ": объект, идентификатор клиента в биллинге:
      • "ИНН": строка
      • "КПП": строка
      • "КодФилиала": строка
      • "Название": строка
      • "НазваниеПолное": строка
    • "СвФЛ":
      • "​ИНН": строка
      • "Фамилия": строка
      • "Имя": строка
      • "Отчетство": строка
  • "Участники":
    • "​Отправитель": объект, отправитель отчетности. При отправке по доверенности не совпадает с плательщиком. Формат такой же, как у объекта "Документ.НашаОрганизация"
    • "Получатель": объект, государственный орган (при отправке отчетности):
      • "ГосударственнаяИнспекция": строка, идентификатор государственного органа
    • "КонечныйПолучатель": объект. При отправке по крупнейшим налогоплательщикам — код налогового органа, в котором плательщик зарегистрирован по месту нахождения. Если отправка не за крупнейшего НП — совпадает с объектом "Плательщик". По формату совпадает с "Документ.Участники.Получатель"
  • "Вложение": массив объектов, указывается для каждого отдельного файла в отправляемом отчете:
    • "Подтип": строка, содержит КНД отдельных файлов. Указывается для отчетов, которые могут быть включены в разные комплекты. Для остальных отчетов КНД указывается в поле "Документ.ПодТип" или в файле описания в теге "КНДФормы"
    • "Направление": строка, содержит значение "Исходящий"
    • "Идентификатор": строка, UUID идентификатор вложения
    • "ВерсияФормата": строка
    • "ПодВерсияФормата": строка
    • "Название": название отправленного отчета
    • "ТипПриложения": строка. Используется только для бухгалтерской отчетности
    • "Категория": строка, значение "Основное"/"Приложение"
    • "Файл": объект:
      • "Имя": строка, имя файла
      • "Ссылка": строка. Содержит ссылку для скачивания файла из хранилища файлов
      • "ДвоичныеДанные": двоичные данные в кодировке base64 или ссылка
    • "Подпись": массив объектов:
      • "Сертификат": объект, реквизиты владельца ЭП
        • "Отпечаток": строка, отпечаток сертификата
  • "Сертификат": массив объектов:
    • "Отпечаток": строка, обязательный параметр
    • "Ключ": объект:
      • "Тип": строка, значение "Серверный"/"Клиентский"
  • "Сведения": объект:
    • "ГоловнойПлательщик": объект. При отправке отчетности от филиала указать головную организацию. В остальных случаях объект не указывается
    • "Ссылка": строка, ссылка на файл описания формата 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
}