ПриемНаРаботу - API3 Объект — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
 
(не показано 13 промежуточных версий этого же участника)
Строка 1: Строка 1:
===Объект===
+
{{КадровыйДокумент_-_API3_Объект}}
Тип: Документ
+
* <span style="color:#077F0B">РаботаетДистанционно</span> - флаг того, что сотрудник работает дистанционно
 +
* ГородПребывания
 +
* ТерриториальныеУсловия - объект [[ТерриториальныеУсловия_-_API3_Объект|ТерриториальныеУсловия]]
 +
* МаксПроцСевНадбавки
 +
* МестныйРайонныйКоэффициент
 +
* ФедеральныйРайонныйКоэффициент
 +
* ДопДниОтпуска
 +
* ТрудовойДоговорНомер
 +
* ТрудовойДоговорДата
 +
* ТрудовойДоговорСрок
 +
* ОснованиеСрочногоТрудовогоДоговора
 +
* ЗанимаемыхСтавок
 +
* ДатаПриема
 +
* ИспытательныйСрок
 +
* ШтатноеРасписание - объект [[ШтатноеРасписание_-_API3_Объект|ШтатноеРасписание]]
 +
* ВидЗанятости - объект [[ВидЗанятости_-_API3_Объект|ВидЗанятости]]
 +
* Должность - объект [[Должность_-_API3_Объект|Должность]]
 +
* РабочаяГруппа - объект [[СтруктураПредприятия_-_API3_Объект|СтруктураПредприятия]]
 +
* ГрафикРаботы - объект [[ГрафикРабочегоВремени_-_API3_Объект|ГрафикРабочегоВремени]]
 +
* ПредыдущаяДолжность - объект [[Должность_-_API3_Объект|Должность]]
 +
* ВидЗанятости - объект [[ВидЗанятости_-_API3_Объект|ВидЗанятости]]
 +
* ОсновныеНачисления - массив
 +
** ВидНачисленияУдержания - объект [[ВидНачисленияУдержания_-_API3_Объект|ВидНачисленияУдержания]] (может содержать: Код - код вида ну, нужен для выставления флагов на документе)
 +
** Показатель/Ставка - сумма/ставка
  
'''Структура:'''
 
* ИдИС - идентификатор документа в ИС
 
* ИдСБИС - идентификатор документа в СБиС
 
* Номер * - номер документа (строка)
 
* Дата * - дата документа (строка в формате "ДД.ММ.ГГГГ")
 
* ДатаПриема * - дата принятия на должность (строка в формате "ДД.ММ.ГГГГ")
 
* ЗанимаемыхСтавок - количество занимаемых ставок
 
* НашаОрганизация * - объект [[НашаОрганизация_-_API3_Объект|НашаОрганизация]]
 
* ИспытательныйСрок - испытательный срок в месяцах (целое число, иначе возьмем целую часть)
 
* Сотрудник * - объект [[Сотрудник_-_API3_Объект|Сотрудник]]
 
* ЧастноеЛицо * - объект [[ЧастноеЛицо - API3 Объект|ЧастноеЛицо]]
 
* РабочаяГруппа - объект [[СтруктураПредприятия - API3 Объект|СтруктураПредприятия]]
 
* Должность * - объект [[Должность_-_API3_Объект|Должность]]
 
* ВидЗанятости * - объект [[ВидЗанятости_-_API3_Объект|ВидЗанятости]]
 
* ГрафикРаботы * - объект [[ГрафикРабочегоВремени_-_API3_Объект|График рабочего времени]]
 
* ДоговорГПХ - признак приема по договору ГПХ, ожидаемое значение 'Да'/'True' или 'Нет'/'False' (если не передавать считается, что False)
 
* ДатаКнц - дата завершения договора ГПХ
 
* Основание - текст, предмет договора ГПХ
 
* ХарактерВыплаты - объект характер выплаты по договору ГПХ [[ХарактерВыплатыПоДоговору - API3 Объект]]
 
* ТрудовойДоговорДата - дата трудового договора
 
* ТрудовойДоговорНомер - номер трудового договора
 
* ОсновныеНачисления- начисления/удержания по сотруднику (массив объектов)
 
** ВидНачисленийУдержаний - объект[[ВидНачисленийУдержаний_-_API3_Объект| Вид начислений/удержаний]]
 
** Показатель - показатель для расчета начисления (число)
 
* РаботаетДистанционно - признак дистанционной работы. Допустимые значения - Да, True, Истина, 1. Отсутствие узла или любые другие значения считаются False
 
* ГородПребывания - город фактического проживания
 
* ТерриториальныеУсловия - объект[[ВидНачисленийУдержаний_-_API3_Объект| Вид начислений/удержаний]]
 
* МаксПроцСевНадбавки - максимальный процент северной надбавки
 
* МестныйРайонныйКоэффициент - местный районный коэффициент
 
* ФедеральныйРайонныйКоэффициент - федеральный районный коэффициент
 
* ДопДниОтпуска - количество дней дополнительного отпуска
 
  
 
'''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону'''
 
'''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону'''
Строка 39: Строка 31:
 
<source lang="json">
 
<source lang="json">
 
{
 
{
  "Номер": "Hire123",
+
'Дата': '01.06.2023',
  "Дата": "30.10.2019",
+
'ДатаПриема': '10.06.2023',
  "ТрудовойДоговорДата": "02.11.2019",
+
'ТрудовойДоговорДата': '15.06.2023',
  "ТрудовойДоговорНомер": "123123123",
+
'ТрудовойДоговорНомер': '112233',
  "ДатаПриема": "25.10.2019",
+
'Номер': '20230601-full-upd',
  "ИдИС": "ИдИС",
+
'Название': 'Прием на работу копия №20230601-full-upd от 01.06.2023',
  "ЗанимаемыхСтавок": "1.0",
+
'Регламент': 'Прием на работу копия',
  "НашаОрганизация": {
+
'Комментарий': 'комментарий документа',
    "ИдСБИС": "167"
+
'Ответственный': {'ИдСБИС': '249'},
  },
+
'ШтатноеРасписание': {'ИдСБИС': '2'},
  "Должность": {
+
'Параметры': [{'Название': 'ПараметрШапки', 'Значение': 'значение1'}],
    "ИдСБИС": "1"
+
'НашаОрганизация': {'ИдСБИС': '234'},
  },
+
'Руководитель': {'ИдСБИС': '317'},
  "РабочаяГруппа": {
+
'ЧастноеЛицо': {'ИдСБИС': '316'},
    "ИдСБИС": "437"
+
'Сотрудник': {'ИдСБИС': '225', 'ТабельныйНомер': '5590-0014'},
  },
+
'ОсновныеНачисления': [{'ВидНачисленияУдержания': {'ИдСБИС': '481'}, 'Показатель': '5000.00'},
  "ГрафикРаботы": {
+
  {'ВидНачисленияУдержания': {'ИдСБИС': '576'}, 'Показатель': '65000.00'},
    "ИдСБИС": "1"
+
  {'ВидНачисленияУдержания': {'ИдСБИС': '339'}, 'Показатель': '10.00'}],
  },
+
 
  "ВидЗанятости": {
+
'ВидЗанятости': {'ИдСБИС': '0'},
    "ИдСБИС": "1"
+
'Должность': {'ИдСБИС': '6'},
  },
+
'РабочаяГруппа': {'ИдСБИС': '318'},
  "Сотрудник": {
+
'ГрафикРаботы': {'ИдСБИС': '2'},
    "ИдСБИС": "109",
+
'ЗанимаемыхСтавок': '0.75',
    "ТабельныйНомер": "100007"
+
'ИспытательныйСрок': '2',
  },
+
'ТрудовойДоговорСрок': '15.02.2025',
  "ЧастноеЛицо": {
+
'ОснованиеСрочногоТрудовогоДоговора': {'ИдСБИС': '59000'},
    "ИдСБИС": "2371"
+
'РаботаетДистанционно': True,
  },
+
'ГородПребывания': 'Магадан',
  "ОсновныеНачисления": [
+
'МаксПроцСевНадбавки': '5',
    {
+
'МестныйРайонныйКоэффициент': '1.3',
      "Показатель": "1000",
+
'ФедеральныйРайонныйКоэффициент': '1.2',
      "ВидНачисленияУдержания": {
+
'ДопДниОтпуска': '4',
        "ИдСБИС": "351"
+
'ТерриториальныеУсловия': {'ИдСБИС': '4'},
      }
 
    },
 
    {
 
      "Показатель": "50",
 
      "ВидНачисленияУдержания": {
 
        "ИдСБИС": "318"
 
      }
 
    }
 
  ]
 
 
}
 
}
 
</source>
 
</source>
Строка 89: Строка 72:
 
** Ключ1_1 - номер документа
 
** Ключ1_1 - номер документа
 
** Ключ1_2 - дата документа
 
** Ключ1_2 - дата документа
** Ключ1_3 - идентификатор организации в ИС
+
** Ключ1_3 - идентификатор организации
 +
** Кчлю1_4 - идентификатор частного лица
 
* Ключ2 - не используется
 
* Ключ2 - не используется
 
* Ключ3 - не используется
 
* Ключ3 - не используется
  
 
===Зависит от объектов===
 
===Зависит от объектов===
* Частное лицо
+
* ЧастноеЛицо
 
* НашаОрганизация
 
* НашаОрганизация
 
* Сотрудник
 
* Сотрудник
Строка 100: Строка 84:
 
* Должность
 
* Должность
 
* ВидЗанятости
 
* ВидЗанятости
* СТруктураПредприятия
+
* СтруктураПредприятия
 
* ВидНачисленияУдержания
 
* ВидНачисленияУдержания
 +
* ШтатноеРасписание
 +
* ТерриториальныеУсловия
 +
* ОснованиеСрочногоТрудовогоДоговора
  
 
===Используемые методы БЛ===
 
===Используемые методы БЛ===
 
* ПриемНаРаботу.Integrate
 
* ПриемНаРаботу.Integrate
 +
* ПриемНаРаботу.ПрочитатьДляУчастника
 +
* StaffTable.FindIdByPostAndDepartment
  
 
[[Категория:SBIS API3 Объект]]
 
[[Категория:SBIS API3 Объект]]

Текущая версия на 13:03, 9 августа 2023

Объект

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

Легенда:

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


Структура:

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


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

Пример:

{
	'Дата': '01.06.2023',
	'ДатаПриема': '10.06.2023',
	'ТрудовойДоговорДата': '15.06.2023',
	'ТрудовойДоговорНомер': '112233',
	'Номер': '20230601-full-upd',
	'Название': 'Прием на работу копия №20230601-full-upd от 01.06.2023',
	'Регламент': 'Прием на работу копия',
	'Комментарий': 'комментарий документа',
	'Ответственный': {'ИдСБИС': '249'},
	'ШтатноеРасписание': {'ИдСБИС': '2'},
	'Параметры': [{'Название': 'ПараметрШапки', 'Значение': 'значение1'}],
	'НашаОрганизация': {'ИдСБИС': '234'},
	'Руководитель': {'ИдСБИС': '317'},
	'ЧастноеЛицо': {'ИдСБИС': '316'},
	'Сотрудник': {'ИдСБИС': '225', 'ТабельныйНомер': '5590-0014'},
	'ОсновныеНачисления': [{'ВидНачисленияУдержания': {'ИдСБИС': '481'}, 'Показатель': '5000.00'},
						   {'ВидНачисленияУдержания': {'ИдСБИС': '576'}, 'Показатель': '65000.00'},
						   {'ВидНачисленияУдержания': {'ИдСБИС': '339'}, 'Показатель': '10.00'}],

	'ВидЗанятости': {'ИдСБИС': '0'},
	'Должность': {'ИдСБИС': '6'},
	'РабочаяГруппа': {'ИдСБИС': '318'},
	'ГрафикРаботы': {'ИдСБИС': '2'},
	'ЗанимаемыхСтавок': '0.75',
	'ИспытательныйСрок': '2',
	'ТрудовойДоговорСрок': '15.02.2025',
	'ОснованиеСрочногоТрудовогоДоговора': {'ИдСБИС': '59000'},
	'РаботаетДистанционно': True,
	'ГородПребывания': 'Магадан',
	'МаксПроцСевНадбавки': '5',
	'МестныйРайонныйКоэффициент': '1.3',
	'ФедеральныйРайонныйКоэффициент': '1.2',
	'ДопДниОтпуска': '4',
	'ТерриториальныеУсловия': {'ИдСБИС': '4'},
}

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

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

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

  • ЧастноеЛицо
  • НашаОрганизация
  • Сотрудник
  • ГрафикРабочегоВремени
  • Должность
  • ВидЗанятости
  • СтруктураПредприятия
  • ВидНачисленияУдержания
  • ШтатноеРасписание
  • ТерриториальныеУсловия
  • ОснованиеСрочногоТрудовогоДоговора

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

  • ПриемНаРаботу.Integrate
  • ПриемНаРаботу.ПрочитатьДляУчастника
  • StaffTable.FindIdByPostAndDepartment