Отпуск - API3 Объект — различия между версиями
(не показаны 3 промежуточные версии этого же участника) | |||
Строка 9: | Строка 9: | ||
* Руководитель - объект [[ЧастноеЛицо_-_API3_Объект|ЧастноеЛицо]] | * Руководитель - объект [[ЧастноеЛицо_-_API3_Объект|ЧастноеЛицо]] | ||
* ДолжностьРуководителя - объект [[Должность_-_API3_Объект|Должность]] | * ДолжностьРуководителя - объект [[Должность_-_API3_Объект|Должность]] | ||
− | * ДатаНач - дата начала периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ") | + | * ДатаНач* - дата начала периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ") |
− | * ДатаКнц - дата окончания периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ") | + | * ДатаКнц* - дата окончания периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ") |
* ДатаРасчета - месяц расчета в котором регистрируется документ (строка в формате "ДД.ММ.ГГГГ", последний день месяца) | * ДатаРасчета - месяц расчета в котором регистрируется документ (строка в формате "ДД.ММ.ГГГГ", последний день месяца) | ||
* ВсегоДней - продолжительность отпуска | * ВсегоДней - продолжительность отпуска | ||
Строка 16: | Строка 16: | ||
* Сумма - начисленная сумма отпускных по документу | * Сумма - начисленная сумма отпускных по документу | ||
* СпособРасчета - признак, использовать основной и дополнительный (1), только основной отпуск (2) или только дополнительный (3). Работает ТОЛЬКО для отпусков "учетных" | * СпособРасчета - признак, использовать основной и дополнительный (1), только основной отпуск (2) или только дополнительный (3). Работает ТОЛЬКО для отпусков "учетных" | ||
− | * ДолжностиСотрудника - массив, каждый элемент - должность сотрудника. Содержит расшифровку по периодам отпусков в разрезе рабочих периодов. Работает ТОЛЬКО для отпусков "без учета" | + | * ОстаткиНаДату - дата, которую будут установлены остатки |
+ | * ДолжностиСотрудника* - массив, каждый элемент - должность сотрудника. Содержит расшифровку по периодам отпусков в разрезе рабочих периодов. Работает ТОЛЬКО для отпусков "без учета" | ||
** Сотрудник* - объект [[Сотрудник_-_API3_Объект|Сотрудник]] | ** Сотрудник* - объект [[Сотрудник_-_API3_Объект|Сотрудник]] | ||
− | ** ДатаНач - дата начала периода отсутствия в рамках всех отпусков, по текущий должности(строка в формате "ДД.ММ.ГГГГ") | + | ** ДатаНач* - дата начала периода отсутствия в рамках всех отпусков, по текущий должности(строка в формате "ДД.ММ.ГГГГ") |
− | ** ДатаКнц - дата окончания периода отсутствия в рамках всех отпусков, по текущий должности(строка в формате "ДД.ММ.ГГГГ") | + | ** ДатаКнц* - дата окончания периода отсутствия в рамках всех отпусков, по текущий должности(строка в формате "ДД.ММ.ГГГГ") |
− | ** РабочийПериод - массив, каждый элемент - отдельный рабочий период | + | ** <span style="color:#E70000">Оплачиваемый</span> - булевский флаг, оплачивать ли отпуск по данной должности |
− | *** ДатаНач - дата начала основного отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ") | + | ** РабочийПериод - массив, каждый элемент - отдельный рабочий период (для отпусков) |
− | *** ДатаКнц - дата окончания основного отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ") | + | *** ДатаНач* - дата начала основного отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ") |
+ | *** ДатаКнц* - дата окончания основного отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ") | ||
*** РабочийГодС - дата начала рабочего периода за который предоставляется отпуск | *** РабочийГодС - дата начала рабочего периода за который предоставляется отпуск | ||
*** РабочийГодПо - дата окончания рабочего периода за который предоставляется отпуск | *** РабочийГодПо - дата окончания рабочего периода за который предоставляется отпуск | ||
*** ДопОтпуск - массив, каждый элемент - период доп.отпуска | *** ДопОтпуск - массив, каждый элемент - период доп.отпуска | ||
− | **** ДатаНач - дата начала доп.отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ") | + | **** ДатаНач* - дата начала доп.отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ") |
− | **** ДатаКнц - дата окончания доп.отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ") | + | **** ДатаКнц* - дата окончания доп.отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ") |
− | **** Причина - объект [[ВидОтпускаДополнительный_-_API3_Объект|ВидОтпускаДополнительный]] | + | **** Причина* - объект [[ВидОтпускаДополнительный_-_API3_Объект|ВидОтпускаДополнительный]] |
**** Продолжительность | **** Продолжительность | ||
− | ***** Кол_во - количество дней | + | ***** Кол_во* - количество дней |
***** ОКЕИ - '359' | ***** ОКЕИ - '359' | ||
+ | ** Остатки - массив (для корректировок отпусков, в шапке ВидОтпуска=7) | ||
+ | *** ВидКорректируемогоОтпуска - объект [[ВидОтпускаДополнительный_-_API3_Объект|ВидОтпускаДополнительный]], если не передан - корректируем основной ежегодный | ||
+ | *** РабочийГодС* - дата начала рабочего периода за который предоставляются дни корректировки (строка в формате "ДД.ММ.ГГГГ") | ||
+ | *** РабочийГодПо* - дата начала рабочего периода за который предоставляются дни корректировки (строка в формате "ДД.ММ.ГГГГ") | ||
+ | *** ОстатокДней* | ||
+ | *** ПоложеноДней | ||
'''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону''' | '''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону''' | ||
Строка 39: | Строка 47: | ||
<source lang="json"> | <source lang="json"> | ||
{ | { | ||
− | + | 'Дата': '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', | |
− | + | 'Комментарий': 'комментарий документа', | |
− | + | 'Руководитель': {'ИдСБИС': '317'}, | |
− | + | 'ДолжностьРуководителя': {'ИдСБИС': '5'}, | |
− | + | 'Ответственный': {'ИдСБИС': '249'}, | |
− | + | 'Параметры': [{'Название': 'ПараметрШапки', 'Значение': 'значение1'}], | |
− | + | 'НашаОрганизация': {'ИдСБИС': '234'}, | |
− | + | 'ВидОтпуска': {'ИдСБИС': '0'}, | |
− | + | 'ДолжностиСотрудника': [ | |
− | + | { | |
− | + | 'Сотрудник': {'ИдСБИС': '47'}, | |
− | + | 'РабочийПериод': [ | |
− | + | { | |
− | + | 'ДатаНач': '19.06.2021', | |
− | + | 'ДатаКнц': '23.06.2021', | |
− | + | 'РабочийГодС': '01.08.2015', | |
− | + | 'РабочийГодПо': '31.07.2016', | |
− | + | 'ДопОтпуск': [ | |
− | + | { | |
− | + | 'Причина': {'ИдСБИС': '1'}, | |
− | + | 'ДатаНач': '19.06.2021', | |
− | + | 'ДатаКнц': '23.06.2021', | |
− | + | 'Продолжительность': {'Кол_во': '5'} | |
− | + | } | |
− | + | ] | |
− | + | } | |
− | + | ]} | |
− | + | ] | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
} | } | ||
</source> | </source> | ||
Строка 129: | Строка 92: | ||
** Ключ1_2 - дата документа | ** Ключ1_2 - дата документа | ||
** Ключ1_3 - идентификатор организации | ** Ключ1_3 - идентификатор организации | ||
+ | ** Кчлю1_4 - идентификатор частного лица | ||
* Ключ2 - не используется | * Ключ2 - не используется | ||
* Ключ3 - не используется | * Ключ3 - не используется | ||
Строка 138: | Строка 102: | ||
* ВидОтпуска | * ВидОтпуска | ||
* СтруктураПредприятия | * СтруктураПредприятия | ||
+ | * ВидОтпускаДополнительный | ||
+ | * ПричинаОтзываИзОтпуска | ||
+ | * Больничный | ||
+ | * Должность | ||
+ | * ПриказНаУвольнение | ||
===Используемые методы БЛ=== | ===Используемые методы БЛ=== | ||
+ | * Отпуск.WriteFrom1C | ||
+ | * Отпуск.Записать | ||
* Отпуск.Прочитать | * Отпуск.Прочитать | ||
[[Категория:SBIS API3 Объект]] | [[Категория:SBIS API3 Объект]] |
Текущая версия на 14:36, 15 апреля 2024
Объект
Тип: Документ
Легенда:
- Реквизиты черного цвета поддерживаются синхронизацией в обоих направлениях
- Реквизиты зеленого цвета поддерживаются синхронизацией только в СБИС
- Реквизиты красного цвета поддерживаются синхронизацией только из СБИС
Структура:
- ИдИС - идентификатор документа в ИС (строка)
- ИдСБИС - идентификатор документа в СБИС (строка)
- ИмяСБИС - имя api3 объекта
- Название - представление объекта
- Номер* - номер документа (строка)
- Дата* - дата документа (строка в формате "ДД.ММ.ГГГГ")
- НашаОрганизация* - объект НашаОрганизация
- Регламент - строка, название регламента
- Комментарий - строка
- Ответственный - объект ЧастноеЛицо
- Параметры - массив именованных параметров ключ / значение
- Название - строка, название параметра
- Значение - строка, значение параметра
- Тип - строка, тип параметра [Текст, Многострочный текст, Число, Флаг, Логическое, Дата, Период, Время, Список, Группа флагов, Объект]
- Основание - список объектов документы основания (массив)
- Документ - объект документа-основания
- ВидСвязи - вид связи с документом-основания
- Вложение - массив с данными файлов, прилагаемых к документу
- Идентификатор - идентификатор файла в хранилище СБИС Диск
- Файл
- Имя
- Идентификатор - ИдентификаторВИ
- Состояние - код состояния документа
- Автор - объект ЧастноеЛицо
- Название - текст названия документа
- Пометки - пометки по документу
- Проведён - Признак проведения документа (булево)
- Удалён - Признак перемещения документа в удаленные (булево)
- Важный - отметка Флажок на документе СБИС (булево)
- Плюс - отметка Плюс на документе СБИС (булево)
- Срочно - отметка Красный круг на документе СБИС (булево)
- НеТребуется - отметка Зеленый круг на документе СБИС (булево)
- Просмотрен - отметка Синий круг на документе СБИС (булево)
- Значительный - отметка Желтый круг на документе СБИС (булево)
- ЗакрытоОтИзменений - отметка серая галка на документе СБИС (булево)
- Провести - булевская величина, флаг необходимости провести документ. Документы проводятся в СБИС по умолчанию
- ЗапуститьЭДО - булевская величина, флаг необходимости запустить документ в ДО. Документооборот по умолчанию не запускается. Запускается при условии, что передан флаг, создается новый документ, действие на этапе не требует выбора ответственного или подписания
- ЧастноеЛицо - объект ЧастноеЛицо
- ВидОтпуска* - объект ВидОтпуска
- ВидОтпускаКолДоговор - объект ВидОтпускаДополнительный
- ОтзываемыйОтпуск - объект Отпуск, отпуск из которого отзывают
- ПричинаОтзыва - объект ПричинаОтзываИзОтпуска
- ДокументОснованиеОтзыва - объект Больничный, ссылка на больничный в случае отзыва по больничному
- ИнаяПричинаОтзыва - текст с указанием причины в случае если причина отзыва - иная.
- Руководитель - объект ЧастноеЛицо
- ДолжностьРуководителя - объект Должность
- ДатаНач* - дата начала периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ")
- ДатаКнц* - дата окончания периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ")
- ДатаРасчета - месяц расчета в котором регистрируется документ (строка в формате "ДД.ММ.ГГГГ", последний день месяца)
- ВсегоДней - продолжительность отпуска
- СреднийЗаработок - сумма среднего заработка по календарным дням
- Сумма - начисленная сумма отпускных по документу
- СпособРасчета - признак, использовать основной и дополнительный (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',
'Комментарий': 'комментарий документа',
'Руководитель': {'ИдСБИС': '317'},
'ДолжностьРуководителя': {'ИдСБИС': '5'},
'Ответственный': {'ИдСБИС': '249'},
'Параметры': [{'Название': 'ПараметрШапки', 'Значение': 'значение1'}],
'НашаОрганизация': {'ИдСБИС': '234'},
'ВидОтпуска': {'ИдСБИС': '0'},
'ДолжностиСотрудника': [
{
'Сотрудник': {'ИдСБИС': '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
- Отпуск.Записать
- Отпуск.Прочитать