Структура документа «Расчетный листок» в API

Параметр
* — обязательный

Тип

Описание

Идентификатор*

строка

идентификатор документа

Номер

строка

номер документа. Если не указан, значение генерируется автоматически

Дата

строка
«ДД.ММ.ГГГГ»

дата документа. Если не указана, устанавливается текущая дата

Тип*

строка

тип документа. Принимает значение SalaryPaySheetSet

Регламент*

объект

регламент документа. Чтобы указать регламент, достаточно заполнить одно из полей — «Название» или «Идентификатор». Если заполнены оба поля, регламент будет определяться по идентификатору

Идентификатор

строка

идентификатор регламента в Saby. Узнать идентификатор можно с помощью команды «СБИС.ПрочитатьДокумент»

Название

строка

название регламента в Saby

НашаОрганизация*

объект

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

СвЮЛ

объект

сведения о юридическом лице

ИНН*

строка

ИНН организации, 10 символов

КПП*

строка

КПП организации, 9 символов

КодФилиала

строка

код филиала

КодСтраны

строка

код страны в формате ISO 3166-1 Numeric

Название

строка

название организации

СвФЛ

объект

сведения о физическом лице

ИНН*

строка

ИНН, 12 символов

КодФилиала

строка

код филиала

КодСтраны

строка

код страны в формате ISO 3166-1 Numeric

Фамилия

строка

ФИО физического лица

Имя

строка

Отчество

строка

Автор

объект

сотрудник — автор документа. Если задан идентификатор, сотрудник ищется по нему, иначе по ФИО

Фамилия

строка

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

Имя

строка

Отчество

строка

Идентификатор

строка

идентификатор сотрудника во внешней системе

РасчетноПлатежнаяВедомость*

объект

параметры расчетного листка

МесяцРасчета

строка
«ДД.ММ.ГГГГ»

месяц расчета. Если не указан, устанавливается текущий месяц

Комментарий

строка

комментарий. Например, «Расчетно-платежная ведомость за январь 2025»

ЗапускатьДокументооборот

строка

признак, нужно ли запустить документ в работу. Если передано «Да», то документ будет запущен в соответствии с регламентом

ТипЗагрузки

строка

способ загрузки расчетного листка. Возможные значения:

• «СУчетом» — в личном кабинете будут отображаться начисления и удержания, по ним сформируется печатная форма расчетного листка. Перед загрузкой проверьте, что в Saby настроены виды начислений и удержаний, как в сторонней системе, а кадровые документы загружены до даты расчета;
• «БезУчета» — на основе переданных данных сформируется расчетный листок в формате внешней системы. Данные не повлияют на аналитику и учет в Saby;
• «ТолькоВложение» — файл расчетного листка прикрепляется к документу по ссылке или в виде двоичных данных, без загрузки в зарплату.

ИмяФайла

строка

имя файла расчетного листка, прикрепленного в виде двоичных данных. Получить данные можно с помощью декодера, например Base64.
Заполняется для типа загрузки «ТолькоВложение»

Сведения*

объект

информация о сотруднике и его начислениях и удержаниях

Фамилия

строка

фамилия

Имя

строка

имя

Идентификатор*

строка

идентификатор сотрудника во внешней системе

Начислено

строка

сумма начисления. Если число дробное, используйте разделитель-точку

Удержано

строка

сумма удержания. Если число дробное, используйте разделитель-точку

Выдано

строка

сумма выданных средств. Если число дробное, используйте разделитель-точку

Остаток

строка

сумма остатка средств. Если число дробное, используйте разделитель-точку

ДолгНачало

строка

сумма долга на начало расчетного периода. Если число дробное, используйте разделитель-точку

ДолгКонец

строка

сумма долга на конец расчетного периода. Если число дробное, используйте разделитель-точку

ДоходСНачалаГода

строка

сумма дохода сотрудника с начала года. Если число дробное, используйте разделитель-точку

НалогСНачалаГода

строка

сумма уплаченного налога. Если число дробное, используйте разделитель-точку

НалоговыйВычетСНачалаГода

строка

сумма налогового вычета сотрудника с начала года. Если число дробное, используйте разделитель-точку

ПланДни

строка

количество рабочих дней по плану, целое число

ПланЧасы

строка

количество рабочих часов по плану, целое число

ОтработаноДни

строка

количество отработанных дней. Если число дробное, используйте разделитель-точку

ОтработаноЧасы

строка

количество отработанных часов. Если число дробное, используйте разделитель-точку

СведенияПоДолжностям*

массив объектов

сведения о должностях сотрудника

ИдентификаторСотрудника*

строка

идентификатор сотрудника (трудового договора). Поле «ИдентификаторСотрудника» метода «СБИС.ЗаписатьСотрудника»

ТабельныйНомер*

строка

табельный номер сотрудника. Обязательно к заполнению, если не задан «ИдентификаторСотрудника»

ПланДни

строка

количество рабочих дней по плану, целое число

ПланЧасы

строка

количество рабочих часов по плану, целое число

ОтработаноДни

строка

количество фактически отработанных дней. Если число дробное, используйте разделитель-точку

ОтработаноЧасы

строка

количество фактически отработанных часов. Если число дробное, используйте разделитель-точку

Расчеты*

массив объектов

расчеты сотрудника

ИдентификаторСотрудника*

строка

идентификатор сотрудника (трудового договора). Поле «ИдентификаторСотрудника» метода «СБИС.ЗаписатьСотрудника»

ТабельныйНомер

строка

табельный номер сотрудника

ВидНУ

строка

используется для поиска вида начисления или удержания в справочнике «Виды начислений и удержаний». Укажите значение, как в поле «ИмяСлужебное» этого справочника

Сумма

строка

сумма расчета. Если число дробное, используйте разделитель-точку

ДатаПринятия

строка
«ДД.ММ.ГГГГ»

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

Выплаты

массив объектов

сведения о выплатах по сотруднику

Название

строка

имя вида начисления или удержания

СистемноеИмя

строка

служебное имя вида начисления или удержания

Код

строка

код дохода

Сумма

строка

сумма выплаты

Отсутствия

массив объектов

сведения о периодах, когда сотрудник отсутствовал

Название*

строка

название периода. Например, «Отпуск» или «Больничный»

ДатаС*

строка
«ДД.ММ.ГГГГ»

дата начала периода

ДатаПо*

строка
«ДД.ММ.ГГГГ»

дата окончания периода

КоличествоДней

строка

количество дней отсутствия. Если число дробное, используйте разделитель — точку

КоличествоЧасов

строка

количество часов отсутствия. Если число дробное, используйте разделитель — точку

Примечание

строка

например, причина отсутствия

НачисленияПоДолжности

массив объектов

сведения о начислениях по должности сотрудника. Например, оклад, премия, доплаты

Название

строка

имя вида начисления или удержания

СистемноеИмя

строка

служебное имя вида начисления или удержания

Код

строка

код дохода

Сумма

строка

сумма выплаты

Процент

строка

процент начисления