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

Материал из razgovorov.ru
Перейти к: навигация, поиск
 
(не показано 26 промежуточных версий 4 участников)
Строка 1: Строка 1:
===Объект===
+
{{КадровыйДокумент_-_API3_Объект}}
* ИдИС - идентификатор документа в ИС
+
* <span style="color:#077F0B">РаботаетДистанционно</span> - флаг того, что сотрудник работает дистанционно
* ИдСБИС - идентификатор документа в СБиС
+
* ГородПребывания
* Номер - номер документа (строка)
+
* ТерриториальныеУсловия — объект [[ТерриториальныеУсловия_-_API3_Объект|ТерриториальныеУсловия]]
* Дата - дата документа (строка в формате "ДД.ММ.ГГГГ")
+
* МаксПроцСевНадбавки
* НомерПП (DEPRECATED)- порядковый номер сотрудника в документе, для совместимости с системами где приказ делается на несколько сотрудников (число)
+
* МестныйРайонныйКоэффициент
* НашаОрганизация * - объект [[НашаОрганизация_-_API3_Объект|НашаОрганизация]]
+
* ФедеральныйРайонныйКоэффициент
* Сотрудник * - объект [[Сотрудник_-_API3_Объект|Сотрудник]]
+
* ДопДниОтпуска
* ЧастноеЛицо * - объект [[ЧастноеЛицо - API3 Объект|ЧастноеЛицо]]
+
* ТрудовойДоговорНомер — номер договора, строка
* ПодразделениеОрганизации - объект [[СтруктураПредприятия - API3 Объект|СтруктураПредприятия]]
+
* ТрудовойДоговорДата — дата оформления договора, она же дата С на СБИС (строка в формате "ДД.ММ.ГГГГ")
* Должность * - объект [[Должность_-_API3_Объект|Должность]]
+
* ТрудовойДоговорСрок — дата, до которой оформлен договор, она же дата ПО на СБИС (строка в формате "ДД.ММ.ГГГГ")
* ГрафикРаботы * - объект [[ГрафикРабочегоВремени_-_API3_Объект|График рабочего времени]]
+
* ОснованиеСрочногоТрудовогоДоговора
* ДатаПриема * - дата принятия на должность (строка в формате "ДД.ММ.ГГГГ")
+
* ЗанимаемыхСтавок — количество ставок, число
* ОсновныеНачисления- начисления/удержания по сотруднику (массив объектов)
+
* ДатаПриема — дата приема (строка в формате "ДД.ММ.ГГГГ")
** ВидНачисленийУдержаний - объект[[ВидНачисленийУдержаний_-_API3_Объект| Вид начислений/удержаний]]
+
* ИспытательныйСрок — срок в месяцах, число
** Показатель - показатель для расчета начисления (число)
+
* ШтатноеРасписание — объект [[ШтатноеРасписание_-_API3_Объект|ШтатноеРасписание]]
 +
* ВидЗанятости — объект [[ВидЗанятости_-_API3_Объект|ВидЗанятости]]
 +
* Должность — объект [[Должность_-_API3_Объект|Должность]]
 +
* РабочаяГруппа — объект [[СтруктураПредприятия_-_API3_Объект|СтруктураПредприятия]]
 +
* ГрафикРаботы — объект [[ГрафикРабочегоВремени_-_API3_Объект|ГрафикРабочегоВремени]]
 +
* ПредыдущаяДолжность — объект [[Должность_-_API3_Объект|Должность]]
 +
* ВидЗанятости — объект [[ВидЗанятости_-_API3_Объект|ВидЗанятости]]
 +
* ОсновныеНачисления массив
 +
** ВидНачисленияУдержания — объект [[ВидНачисленияУдержания_-_API3_Объект|ВидНачисленияУдержания]] (может содержать: Код - код вида ну, нужен для выставления флагов на документе)
 +
** Показатель/Ставка — сумма/ставка
 +
 
 +
 
 +
'''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону'''
  
 
'''Пример:'''
 
'''Пример:'''
 
<source lang="json">
 
<source lang="json">
 
{
 
{
  "ИдИС": "5f9102f4-28c9-11e7-a6d9-156_9dd14674-5a7a-11e7-80f5-00155d079f30",
+
'Дата': '01.06.2023',
  "Номер": "00000002",
+
'ДатаПриема': '10.06.2023',
  "Дата": "17.01.2015",
+
'ТрудовойДоговорДата': '15.06.2023',
  "НомерПП": 1,
+
'ТрудовойДоговорНомер': '112233',
  "НашаОрганизация": {
+
'Номер': '20230601-full-upd',
    "ИдИС": "9dd14666-5a7a-11e7-80f5-00155d079f30",
+
'Название': 'Прием на работу копия №20230601-full-upd от 01.06.2023',
    "ИмяСБИС": "НашаОрганизация"
+
'Регламент': 'Прием на работу копия',
  },
+
'Комментарий': 'комментарий документа',
  "Сотрудник": {
+
'Ответственный': {'ИдСБИС': '249'},
    "ИдИС": "9dd14674-5a7a-11e7-80f5-00155d079f30",
+
'ШтатноеРасписание': {'ИдСБИС': '2'},
    "ИмяСБИС": "Сотрудник"
+
'Параметры': [{'Название': 'ПараметрШапки', 'Значение': 'значение1'}],
  },
+
'НашаОрганизация': {'ИдСБИС': '234'},
  "ЧастноеЛицо": {
+
'Руководитель': {'ИдСБИС': '317'},
    "ИдИС": "30b64f32-9102-4ba3-896d-cf60f1535c4f",
+
'ЧастноеЛицо': {'ИдСБИС': '316'},
    "ИмяСБИС": "ЧастноеЛицо"
+
'Сотрудник': {'ИдСБИС': '225', 'ТабельныйНомер': '5590-0014'},
  },
+
'ОсновныеНачисления': [{'ВидНачисленияУдержания': {'ИдСБИС': '481'}, 'Показатель': '5000.00'},
  "ПодразделениеОрганизации": {
+
  {'ВидНачисленияУдержания': {'ИдСБИС': '576'}, 'Показатель': '65000.00'},
    "ИдИС": "9dd1466c-5a7a-11e7-80f5-00155d079f30",
+
  {'ВидНачисленияУдержания': {'ИдСБИС': '339'}, 'Показатель': '10.00'}],
    "ИмяСБИС": "СтруктураПредприятия"
+
 
  },
+
'ВидЗанятости': {'ИдСБИС': '0'},
  "Должность": {
+
'Должность': {'ИдСБИС': '6'},
    "ИдИС": "9dd14672-5a7a-11e7-80f5-00155d079f30",
+
'РабочаяГруппа': {'ИдСБИС': '318'},
    "ИмяСБИС": "Должность"
+
'ГрафикРаботы': {'ИдСБИС': '2'},
  },
+
'ЗанимаемыхСтавок': '0.75',
  "ГрафикРаботы": {
+
'ИспытательныйСрок': '2',
    "ИдИС": "9dd14677-5a7a-11e7-80f5-00155d079f30",
+
'ТрудовойДоговорСрок': '15.02.2025',
    "ИмяСБИС": "ГрафикРабочегоВремени"
+
'ОснованиеСрочногоТрудовогоДоговора': {'ИдСБИС': '59000'},
  },
+
'РаботаетДистанционно': True,
  "ДатаПриема": "28.06.2017",
+
'ГородПребывания': 'Магадан',
  "ИспытательныйСрок": 0,
+
'МаксПроцСевНадбавки': '5',
  "ОсновныеНачисления": [
+
'МестныйРайонныйКоэффициент': '1.3',
    {
+
'ФедеральныйРайонныйКоэффициент': '1.2',
      "ВидНачисленияУдержания": {
+
'ДопДниОтпуска': '4',
        "ИдИС": "a280992b-2653-4dca-964e-f4b9e066c72a",
+
'ТерриториальныеУсловия': {'ИдСБИС': '4'},
        "ИмяСБИС": "ВидНачисленияУдержания"
 
      },
 
      "Показатель": 568
 
    }
 
  ]
 
 
}
 
}
 
</source>
 
</source>
Строка 63: Строка 70:
 
===Естественные ключи===
 
===Естественные ключи===
 
* Ключ1 - номер документа + дата документа + организация(вес = 3)
 
* Ключ1 - номер документа + дата документа + организация(вес = 3)
** Ключ1_1 - номер документа
+
** Ключ1_1 номер документа
** Ключ1_2 - дата документа
+
** Ключ1_2 дата документа
** Ключ1_3 - идентификатор организации в ИС
+
** Ключ1_3 идентификатор организации
* Ключ2 - идентификатор документа в ИС (ExternalId - для поиска документа в СБИС по внешнему идентификатору)
+
** Кчлю1_4 — идентификатор частного лица
* Ключ3 - не используется
+
* Ключ2 — не используется
 +
* Ключ3 не используется
  
 
===Зависит от объектов===
 
===Зависит от объектов===
* Частное лицо
+
* ЧастноеЛицо
 
* НашаОрганизация
 
* НашаОрганизация
 
* Сотрудник
 
* Сотрудник
 
* ГрафикРабочегоВремени
 
* ГрафикРабочегоВремени
 
* Должность
 
* Должность
 +
* ВидЗанятости
 +
* СтруктураПредприятия
 +
* ВидНачисленияУдержания
 +
* ШтатноеРасписание
 +
* ТерриториальныеУсловия
 +
* ОснованиеСрочногоТрудовогоДоговора
  
 
===Используемые методы БЛ===
 
===Используемые методы БЛ===
 
* ПриемНаРаботу.Integrate
 
* ПриемНаРаботу.Integrate
 +
* ПриемНаРаботу.ПрочитатьДляУчастника
 +
* StaffTable.FindIdByPostAndDepartment
  
 
[[Категория:SBIS API3 Объект]]
 
[[Категория:SBIS API3 Объект]]

Текущая версия на 09:07, 16 июля 2024

Объект

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

Легенда:

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


Структура:

  • Вложение — массив с данными файлов, прилагаемых к документу
  • Дата* — дата документа, строка в формате "ДД.ММ.ГГГГ"
  • ЗапуститьЭДО — флаг необходимости запустить документ в ДО. Документооборот по умолчанию не запускается. Запускается при условии, что передан флаг, создается новый документ, действие на этапе не требует выбора ответственного или подписания, булево
  • Идентификатор — идентификатор файла в хранилище СБИС Диск
  • Файл
    • Имя
  • ВнешнийИдентификатор — внешний идентификатор документа в СБИС. Если передан является ключом поиска документа без учета типа (в СБИС это уникальное поле в разрезе всех типов документов). При создании будет записан и в последующем документ может быть найден по нему, даже при условии изменившихся других ключей
  • ИдИС — идентификатор документа в ИС, строка
  • ИдСБИС — идентификатор документа в СБИС, строка
  • ИмяСБИС — имя 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