Отпуск - API3 Объект — различия между версиями
Строка 7: | Строка 7: | ||
* Дата * - дата документа (строка в формате "ДД.ММ.ГГГГ") | * Дата * - дата документа (строка в формате "ДД.ММ.ГГГГ") | ||
* НашаОрганизация * - объект [[НашаОрганизация_-_API3_Объект|НашаОрганизация]] | * НашаОрганизация * - объект [[НашаОрганизация_-_API3_Объект|НашаОрганизация]] | ||
− | * Сотрудник | + | * Сотрудник - объект [[Сотрудник_-_API3_Объект|Сотрудник]] (устаревший вариант, пока поддерживаем, но скоро откажемся) |
* ЧастноеЛицо * - объект [[ЧастноеЛицо_-_API3_Объект|ЧастноеЛицо]] | * ЧастноеЛицо * - объект [[ЧастноеЛицо_-_API3_Объект|ЧастноеЛицо]] | ||
* ВидОтпуска * - объект [[ВидОтпуска_-_API3_Объект|ВидОтпуска]] | * ВидОтпуска * - объект [[ВидОтпуска_-_API3_Объект|ВидОтпуска]] | ||
* РабочаяГруппа * - объект [[СтруктураПредприятия_-_API3_Объект|СтруктураПредприятия]] | * РабочаяГруппа * - объект [[СтруктураПредприятия_-_API3_Объект|СтруктураПредприятия]] | ||
* Название * - название | * Название * - название | ||
− | * ДатаНач - дата начала | + | * ДатаНач - дата начала периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ") |
− | * ДатаКнц - дата окончания | + | * ДатаКнц - дата окончания периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ") |
* ДатаРасчета - месяц расчета в котором регистрируется документ (строка в формате "ДД.ММ.ГГГГ", последний день месяца) | * ДатаРасчета - месяц расчета в котором регистрируется документ (строка в формате "ДД.ММ.ГГГГ", последний день месяца) | ||
* КоличествоДней - продолжительность отпуска | * КоличествоДней - продолжительность отпуска | ||
Строка 20: | Строка 20: | ||
* Комментарий | * Комментарий | ||
* Регламент | * Регламент | ||
+ | * ДолжностиСотрудника - массив, каждый элемент - должность сотрудника. Содержит расшифровку по периодам отпусков в разрезе рабочих периодов. Работает ТОЛЬКО для отпусков "без учета" | ||
+ | ** Сотрудник * - объект [[Сотрудник_-_API3_Объект|Сотрудник]] | ||
+ | ** ДатаНач - дата начала периода отсутствия в рамках всех отпусков, по текущий должности(строка в формате "ДД.ММ.ГГГГ") | ||
+ | ** ДатаКнц - дата окончания периода отсутствия в рамках всех отпусков, по текущий должности(строка в формате "ДД.ММ.ГГГГ") | ||
+ | ** РабочийПериод - массив, каждый элемент - отдельный рабочий период | ||
+ | *** ДатаНач - дата начала основного отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ") | ||
+ | *** ДатаКнц - дата окончания основного отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ") | ||
+ | *** РабочийГодС - дата начала рабочего периода за который предоставляется отпуск | ||
+ | *** РабочийГодПо - дата окончания рабочего периода за который предоставляется отпуск | ||
+ | *** ДопОтпуск - массив, каждый элемент - период доп.отпуска | ||
+ | **** ДатаНач - дата начала доп.отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ") | ||
+ | **** ДатаКнц - дата окончания доп.отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ") | ||
+ | **** Причина - объект [[ВидОтпускаДополнительный_-_API3_Объект|ВидОтпускаДополнительный]] | ||
+ | **** Продолжительность | ||
+ | ***** Кол_во - количество дней | ||
+ | ***** ОКЕИ - '359' | ||
'''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону''' | '''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону''' | ||
Строка 53: | Строка 69: | ||
"РабочаяГруппа": { | "РабочаяГруппа": { | ||
"ИдСБИС": "248" | "ИдСБИС": "248" | ||
− | } | + | }, |
+ | "ДолжностиСотрудника": [ | ||
+ | { | ||
+ | "ДатаКнц": "15.04.2019", | ||
+ | "ДатаНач": "01.04.2019", | ||
+ | "РабочийПериод": [ | ||
+ | { | ||
+ | "ДатаКнц": "15.04.2019", | ||
+ | "ДатаНач": "01.04.2019", | ||
+ | "ДопОтпуск": [ | ||
+ | { | ||
+ | "ДатаКнц": "13.04.2019", | ||
+ | "ДатаНач": "11.04.2019", | ||
+ | "Причина": { | ||
+ | "ИдИС": "61c320cc-e1a1-4f33-bd3f-c76d1f6fde2f", | ||
+ | "ИдСБИС": "2", | ||
+ | "ИмяИС": "Справочники.ВидыОтпусков", | ||
+ | "ИмяСБИС": "ВидОтпускаДополнительный", | ||
+ | "Ини": "СинхВыгрузка_ВидОтпускаДополнительный", | ||
+ | "Название": "Северный" | ||
+ | }, | ||
+ | "Продолжительность": { | ||
+ | "Кол_во": "3.00", | ||
+ | "ОКЕИ": "359" | ||
+ | } | ||
+ | }, | ||
+ | { | ||
+ | "ДатаКнц": "15.04.2019", | ||
+ | "ДатаНач": "14.04.2019", | ||
+ | "Причина": { | ||
+ | "ИдИС": "4420796a-a755-11eb-aab1-f079597094ef", | ||
+ | "ИдСБИС": "3", | ||
+ | "ИмяИС": "Справочники.ВидыОтпусков", | ||
+ | "ИмяСБИС": "ВидОтпускаДополнительный", | ||
+ | "Ини": "СинхВыгрузка_ВидОтпускаДополнительный", | ||
+ | "Название": "ежегоный дополниьельный" | ||
+ | }, | ||
+ | "Продолжительность": { | ||
+ | "Кол_во": "2.00", | ||
+ | "ОКЕИ": "359" | ||
+ | } | ||
+ | } | ||
+ | ], | ||
+ | "РабочийГодПо": "21.12.2018", | ||
+ | "РабочийГодС": "22.12.2017" | ||
+ | } | ||
+ | ], | ||
+ | "Сотрудник": { | ||
+ | "ИдИС": "1f64cd44-533e-11ec-8548-fc349713f338", | ||
+ | "ИдСБИС": "750", | ||
+ | "ИмяИС": "Справочники.Сотрудники", | ||
+ | "ИмяСБИС": "Сотрудник", | ||
+ | "Ини": "СинхВыгрузка_Сотрудник" | ||
+ | } | ||
+ | } | ||
+ | ] | ||
} | } | ||
</source> | </source> |
Версия 15:20, 23 декабря 2021
Объект
Тип: Документ
Структура:
- ИдИС - идентификатор документа в ИС (строка)
- Номер * - номер документа (строка)
- Дата * - дата документа (строка в формате "ДД.ММ.ГГГГ")
- НашаОрганизация * - объект НашаОрганизация
- Сотрудник - объект Сотрудник (устаревший вариант, пока поддерживаем, но скоро откажемся)
- ЧастноеЛицо * - объект ЧастноеЛицо
- ВидОтпуска * - объект ВидОтпуска
- РабочаяГруппа * - объект СтруктураПредприятия
- Название * - название
- ДатаНач - дата начала периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ")
- ДатаКнц - дата окончания периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ")
- ДатаРасчета - месяц расчета в котором регистрируется документ (строка в формате "ДД.ММ.ГГГГ", последний день месяца)
- КоличествоДней - продолжительность отпуска
- СреднийЗаработок - сумма среднего заработка по календарным дням
- Сумма - начисленная сумма отпускных по документу
- Комментарий
- Регламент
- ДолжностиСотрудника - массив, каждый элемент - должность сотрудника. Содержит расшифровку по периодам отпусков в разрезе рабочих периодов. Работает ТОЛЬКО для отпусков "без учета"
- Сотрудник * - объект Сотрудник
- ДатаНач - дата начала периода отсутствия в рамках всех отпусков, по текущий должности(строка в формате "ДД.ММ.ГГГГ")
- ДатаКнц - дата окончания периода отсутствия в рамках всех отпусков, по текущий должности(строка в формате "ДД.ММ.ГГГГ")
- РабочийПериод - массив, каждый элемент - отдельный рабочий период
- ДатаНач - дата начала основного отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
- ДатаКнц - дата окончания основного отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
- РабочийГодС - дата начала рабочего периода за который предоставляется отпуск
- РабочийГодПо - дата окончания рабочего периода за который предоставляется отпуск
- ДопОтпуск - массив, каждый элемент - период доп.отпуска
- ДатаНач - дата начала доп.отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
- ДатаКнц - дата окончания доп.отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
- Причина - объект ВидОтпускаДополнительный
- Продолжительность
- Кол_во - количество дней
- ОКЕИ - '359'
Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону
Пример:
{
"ИдИС": "ИдИС",
"Номер": "update1update1",
"Дата": "20.11.2020",
"ДатаРасчета": "31.12.2020",
"Название": "Отпуск №update1update1 от 20.11.2020",
"ДатаНач": "05.01.2021",
"ДатаКнц": "13.01.2021",
"Комментарий": "обновили",
"КоличествоДней": "9",
"Сумма": "4500.00",
"СреднийЗаработок": "500.0",
"Регламент": "для unittest",
"НашаОрганизация": {
"ИдСБИС": "167"
},
"ЧастноеЛицо": {
"ИдСБИС": "879"
},
"Сотрудник": {
"ИдСБИС": "61"
},
"ВидОтпуска": {
"ИдСБИС": "8"
},
"РабочаяГруппа": {
"ИдСБИС": "248"
},
"ДолжностиСотрудника": [
{
"ДатаКнц": "15.04.2019",
"ДатаНач": "01.04.2019",
"РабочийПериод": [
{
"ДатаКнц": "15.04.2019",
"ДатаНач": "01.04.2019",
"ДопОтпуск": [
{
"ДатаКнц": "13.04.2019",
"ДатаНач": "11.04.2019",
"Причина": {
"ИдИС": "61c320cc-e1a1-4f33-bd3f-c76d1f6fde2f",
"ИдСБИС": "2",
"ИмяИС": "Справочники.ВидыОтпусков",
"ИмяСБИС": "ВидОтпускаДополнительный",
"Ини": "СинхВыгрузка_ВидОтпускаДополнительный",
"Название": "Северный"
},
"Продолжительность": {
"Кол_во": "3.00",
"ОКЕИ": "359"
}
},
{
"ДатаКнц": "15.04.2019",
"ДатаНач": "14.04.2019",
"Причина": {
"ИдИС": "4420796a-a755-11eb-aab1-f079597094ef",
"ИдСБИС": "3",
"ИмяИС": "Справочники.ВидыОтпусков",
"ИмяСБИС": "ВидОтпускаДополнительный",
"Ини": "СинхВыгрузка_ВидОтпускаДополнительный",
"Название": "ежегоный дополниьельный"
},
"Продолжительность": {
"Кол_во": "2.00",
"ОКЕИ": "359"
}
}
],
"РабочийГодПо": "21.12.2018",
"РабочийГодС": "22.12.2017"
}
],
"Сотрудник": {
"ИдИС": "1f64cd44-533e-11ec-8548-fc349713f338",
"ИдСБИС": "750",
"ИмяИС": "Справочники.Сотрудники",
"ИмяСБИС": "Сотрудник",
"Ини": "СинхВыгрузка_Сотрудник"
}
}
]
}
Естественные ключи
- Ключ1 - номер документа + дата документа + организация (вес = 3)
- Ключ1_1 - номер документа
- Ключ1_2 - дата документа
- Ключ1_3 - идентификатор организации
- Ключ2 - не используется
- Ключ3 - не используется
Зависит от объектов
- НашаОрганизация
- Сотрудник
- ЧастноеЛицо
- ВидОтпуска
- СтруктураПредприятия
Используемые методы БЛ
- Отпуск.Прочитать