Отпуск - API3 Объект

Объект

Тип: Документ

Легенда:

• Реквизиты черного цвета поддерживаются синхронизацией в обоих направлениях
• Реквизиты зеленого цвета поддерживаются синхронизацией только в СБИС
• Реквизиты красного цвета поддерживаются синхронизацией только из СБИС

Структура:

• Валюта — объект Валюта, валюта документа

развернуть

• Вложение — массив, массив с данными файлов, прилагаемых к документу

• Идентификатор — строка, идентификатор файла в хранилище СБИС Диск
• Тип - строка, название типа формализованного вложения
• ПодТип - строка, название подтипа формализованного вложения
• ВерсияФормата - строка, версия формата
• ПодверсияФормата - строка, подверсия формата
• Файл
  • Имя

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

развернуть

• Основание — массив, массив документов основания

• ВидСвязи — число строкой, код вида связи с документом-основания [1]
• Документ — объект документа-основания (любой объект с типом Документ)
• Сумма — число строкой, сумма связи в валюте учета
• СуммаВалютная — число строкой, сумма связи в валюте документа

• Ответственный — объект ЧастноеЛицо, ответственный за документ

развернуть

• Параметры — массив, массив именованных параметров ключ / значение

• Значение — строка, значение параметра
• Название — строка, название параметра
• Тип — строка, тип параметра [Текст, Многострочный текст, Число, Флаг, Логическое, Дата, Период, Время, Список, Группа флагов, Объект]

развернуть

• Пометки — словарь, пометки по документу

• Проведён — Признак проведения документа, булево
• Важный — отметка Флажок на документе СБИС, булево
• Плюс — отметка Плюс на документе СБИС, булево
• Срочно — отметка Красный круг на документе СБИС, булево
• НеТребуется — отметка Зеленый круг на документе СБИС, булево
• Просмотрен — отметка Синий круг на документе СБИС, булево
• Значительный — отметка Желтый круг на документе СБИС, булево
• ЗакрытоОтИзменений — отметка серая галка на документе СБИС, булево

• Проведён — булево, признак необходимости провести документ. Актуально только для документов с движениями
• Регламент — строка, название регламента
• Состояние — число строкой, код состояния документа
• Сумма — число строкой, сумма документа
• СчетУчетаКонтрагент — объект ПоказательУчета, счет учета с контрагентом
• СчетУчетаАванс — объект ПоказательУчета, счет учета авансов
• Удалён — булево, признак удаленности документа. По умолчанию считаем что документ не помечен на удаление
• ЧастноеЛицо - объект ЧастноеЛицо
• ВидОтпуска* - объект ВидОтпуска
• ВидОтпускаКолДоговор - объект ВидОтпускаДополнительный
• ОтзываемыйОтпуск - объект Отпуск, отпуск из которого отзывают
• ПричинаОтзыва - объект ПричинаОтзываИзОтпуска
• ДокументОснованиеОтзыва - объект Больничный, ссылка на больничный в случае отзыва по больничному
• ИнаяПричинаОтзыва - текст с указанием причины в случае если причина отзыва - иная.
• Руководитель - объект ЧастноеЛицо
• ДолжностьРуководителя - объект Должность
• ДатаНач* - дата начала периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ")
• ДатаКнц* - дата окончания периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ")
• ДатаРасчета - месяц расчета в котором регистрируется документ (строка в формате "ДД.ММ.ГГГГ", последний день месяца)
• ВсегоДней - продолжительность отпуска
• СреднийЗаработок - сумма среднего заработка по календарным дням
• Сумма - начисленная сумма отпускных по документу
• ДетализацияСуммы - словарь, содержащий детализацию заработка по территориальным условиям (применяется с января 2025)
  • СуммаОсновная - сумма доли основного заработка (без доли районной и северной надбавки)
  • СуммаРК - сумма доли районного коэффициента
  • СуммаСН - сумма доли северной надбавки
• СпособРасчета - признак, использовать основной и дополнительный (1), только основной отпуск (2) или только дополнительный (3). Работает ТОЛЬКО для отпусков "учетных"
• ОстаткиНаДату - дата, которую будут установлены остатки
• ДолжностиСотрудника* - массив, каждый элемент - должность сотрудника. Содержит расшифровку по периодам отпусков в разрезе рабочих периодов. Работает ТОЛЬКО для отпусков "без учета"
  • Сотрудник* - объект Сотрудник
  • ДатаНач* - дата начала периода отсутствия в рамках всех отпусков, по текущий должности(строка в формате "ДД.ММ.ГГГГ")
  • ДатаКнц* - дата окончания периода отсутствия в рамках всех отпусков, по текущий должности(строка в формате "ДД.ММ.ГГГГ")
  • Оплачиваемый - булевский флаг, оплачивать ли отпуск по данной должности
  • РабочийПериод - массив, каждый элемент - отдельный рабочий период (для отпусков)
    • ДатаНач* - дата начала основного отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
    • ДатаКнц* - дата окончания основного отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
    • РабочийГодС - дата начала рабочего периода за который предоставляется отпуск
    • РабочийГодПо - дата окончания рабочего периода за который предоставляется отпуск
    • ДопОтпуск - массив, каждый элемент - период доп.отпуска
      • ДатаНач* - дата начала доп.отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
      • ДатаКнц* - дата окончания доп.отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
      • Причина* - объект ВидОтпускаДополнительный
      • Продолжительность
        • Кол_во* - количество дней
        • ОКЕИ - '359'
  • Остатки - массив (для корректировок отпусков, в шапке ВидОтпуска=7)
    • ВидКорректируемогоОтпуска - объект ВидОтпускаДополнительный, если не передан - корректируем основной ежегодный
    • РабочийГодС* - дата начала рабочего периода за который предоставляются дни корректировки (строка в формате "ДД.ММ.ГГГГ")
    • РабочийГодПо* - дата начала рабочего периода за который предоставляются дни корректировки (строка в формате "ДД.ММ.ГГГГ")
    • ОстатокДней*
    • ПоложеноДней

Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону

Пример:

{
	'Дата': '01.06.2021',
	'ДатаРасчета': '30.06.2021',
	'ДатаНач': '19.06.2021',
	'ДатаКнц': '23.06.2021',
	'ВсегоДней': '5',
	'Номер': '20210601-full-upd',
	'Название': 'Отпуск копия №20210601-full-upd от 01.06.2021',
	'Регламент': 'Отпуск копия',
	'СреднийЗаработок': '1200.00',
	'Сумма': '7800.00',
	'ДетализацияСуммы': {
                'СуммаОсновная': '7000',
                'СуммаРК': '0',
                'СуммаСН': '0'
        },
        'ВидОтпуска': {'ИдСБИС': '0'},
	'Комментарий': 'комментарий документа',
	'Руководитель': {'ИдСБИС': '317'},
	'ДолжностьРуководителя': {'ИдСБИС': '5'},
	'Ответственный': {'ИдСБИС': '249'},
	'Параметры': [{'Название': 'ПараметрШапки', 'Значение': 'значение1'}],
	'НашаОрганизация': {'ИдСБИС': '234'},
	'ДолжностиСотрудника': [
		{
			'Сотрудник': {'ИдСБИС': '47'},
			'РабочийПериод': [
				{
					'ДатаНач': '19.06.2021',
					'ДатаКнц': '23.06.2021',
					'РабочийГодС': '01.08.2015',
					'РабочийГодПо': '31.07.2016',
					'ДопОтпуск': [
						{
							'Причина': {'ИдСБИС': '1'},
							'ДатаНач': '19.06.2021',
							'ДатаКнц': '23.06.2021',
							'Продолжительность': {'Кол_во': '5'}
						}
					]
				}
			]}
	]
}

Естественные ключи

• Ключ1 - номер документа + дата документа + организация (вес = 3)
  • Ключ1_1 - номер документа
  • Ключ1_2 - дата документа
  • Ключ1_3 - идентификатор организации
  • Кчлю1_4 - идентификатор частного лица
• Ключ2 - не используется
• Ключ3 - не используется

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

• НашаОрганизация
• Сотрудник
• ЧастноеЛицо
• ВидОтпуска
• СтруктураПредприятия
• ВидОтпускаДополнительный
• ПричинаОтзываИзОтпуска
• Больничный
• Должность
• ПриказНаУвольнение

Используемые методы БЛ

• Отпуск.WriteFrom1C
• Отпуск.Записать
• Отпуск.Прочитать