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

Материал из razgovorov.ru
Перейти к: навигация, поиск
Строка 1: Строка 1:
===Объект===
+
{{КадровыйДокумент_-_API3_Объект}}
Тип: Документ
+
* <span style="color:#077F0B">РаботаетДистанционно</span> - флаг того, что сотрудник работает дистанционно
 
+
* ГородПребывания
'''Структура:'''
+
* ТерриториальныеУсловия - объект [[ТерриториальныеУсловия_-_API3_Объект|ТерриториальныеУсловия]]
* ИдИС - идентификатор документа в ИС
+
* МаксПроцСевНадбавки
* ИдСБИС - идентификатор документа в СБиС
+
* МестныйРайонныйКоэффициент
* Номер * - номер документа (строка)
+
* ФедеральныйРайонныйКоэффициент
* Дата * - дата документа (строка в формате "ДД.ММ.ГГГГ")
+
* ДопДниОтпуска
* ДатаПриема * - дата принятия на должность (строка в формате "ДД.ММ.ГГГГ")
+
* ТрудовойДоговорНомер
* ЗанимаемыхСтавок - количество занимаемых ставок
+
* ТрудовойДоговорДата
* НашаОрганизация * - объект [[НашаОрганизация_-_API3_Объект|НашаОрганизация]]
+
* ТрудовойДоговорСрок
* ИспытательныйСрок - испытательный срок в месяцах (целое число, иначе возьмем целую часть)
+
* ОснованиеСрочногоТрудовогоДоговора
* Сотрудник * - объект [[Сотрудник_-_API3_Объект|Сотрудник]]
+
* ЗанимаемыхСтавок
* ЧастноеЛицо * - объект [[ЧастноеЛицо - API3 Объект|ЧастноеЛицо]]
+
* ДатаПриема
* РабочаяГруппа - объект [[СтруктураПредприятия - API3 Объект|СтруктураПредприятия]]
+
* ИспытательныйСрок
* Должность * - объект [[Должность_-_API3_Объект|Должность]]
+
* ШтатноеРасписание - объект [[ШтатноеРасписание_-_API3_Объект|ШтатноеРасписание]]
* ВидЗанятости * - объект [[ВидЗанятости_-_API3_Объект|ВидЗанятости]]
+
* ВидЗанятости - объект [[ВидЗанятости_-_API3_Объект|ВидЗанятости]]
* ГрафикРаботы * - объект [[ГрафикРабочегоВремени_-_API3_Объект|График рабочего времени]]
+
* Должность - объект [[Должность_-_API3_Объект|Должность]]
* ДоговорГПХ - признак приема по договору ГПХ, ожидаемое значение 'Да'/'True' или 'Нет'/'False' (если не передавать считается, что False)
+
* РабочаяГруппа - объект [[СтруктураПредприятия_-_API3_Объект|СтруктураПредприятия]]
* ДатаКнц - дата завершения договора ГПХ
+
* ГрафикРаботы - объект [[ГрафикРабочегоВремени_-_API3_Объект|ГрафикРабочегоВремени]]
* Основание - текст, предмет договора ГПХ
+
* ПредыдущаяДолжность - объект [[Должность_-_API3_Объект|Должность]]
* ХарактерОплаты - объект характер выплаты по договору ГПХ [[ХарактерВыплатыПоДоговору - API3 Объект]]
+
* ВидЗанятости - объект [[ВидЗанятости_-_API3_Объект|ВидЗанятости]]
* РазмерЕжемесячногоПлатежа - сумма ежемесячного платежа для ГПХ (взаимоисключающие с РазмерАванса и ДатаАванса)
+
* ОсновныеНачисления - массив
* РазмерАванса - сумма аванса (взаимоисключающие с РазмерЕжемесячногоПлатежа)
+
** ВидНачисленияУдержания - объект [[ВидНачисленияУдержания_-_API3_Объект|ВидНачисленияУдержания]] (может содержать: Код - код вида ну, нужен для выставления флагов на документе)
* ДатаАванса - дата аванса (взаимоисключающие с РазмерЕжемесячногоПлатежа)
+
** Показатель/Ставка - сумма/ставка
* Травма - признак Начислять страховые взносы за травматизм (True/False) для ГПХ
 
* ВидДоговораГПХ - объект [[ВидНачисленияУдержания_-_API3_Объект|ВидНачисленияУдержания]], вид договора для ГПХ
 
* ПриглашениеНовомуПользователю - флаг если необходимо отправить сотруднику из документа приглашение на регистрацию (обязательно должен быть email). Доступные значения - да, истина, true. Фича - если отдать имя приложения, то передадим его идентификатор в приглашение для отправки именно в него
 
* ПримечаниеКПриграшению - текстовое примечание к приглашению на регистрацию
 
* ЗавершитьДО - признак необходимости завершить ДО, булевская величина
 
* ЭтапыНачисленияПоДоговоруГПХ - массив
 
** Дата - дата выплаты
 
** Сумма - сумма выплаты
 
** Примечание - комментарий
 
* ОсновныеНачисления- начисления/удержания по сотруднику (массив объектов)
 
** ВидНачисленияУдержания - объект [[ВидНачисленияУдержания_-_API3_Объект|ВидНачисленияУдержания]]
 
** Показатель - показатель для расчета начисления (число)
 
* РаботаетДистанционно - признак дистанционной работы. Допустимые значения - Да, True, Истина, 1. Отсутствие узла или любые другие значения считаются False
 
* ГородПребывания - город фактического пребывания
 
* ТерриториальныеУсловия - объект[[ТерриториальныеУсловия_-_API3_Объект|ТерриториальныеУсловия]]
 
* МаксПроцСевНадбавки - максимальный процент северной надбавки
 
* МестныйРайонныйКоэффициент - местный районный коэффициент
 
* ФедеральныйРайонныйКоэффициент - федеральный районный коэффициент
 
* ДопДниОтпуска - количество дней дополнительного отпуска
 
* ТрудовойДоговорДата - дата трудового договора
 
* ТрудовойДоговорНомер - номер трудового договора
 
* ТрудовойДоговорСрок - дата завершения срочного трудового договора
 
* ОснованиеСрочногоТрудовогоДоговора - объект[[ОснованиеСрочногоТрудовогоДоговора_-_API3_Объект|ОснованиеСрочногоТрудовогоДоговора]]
 
 
 
'''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону'''
 
 
 
'''Пример:'''
 
<source lang="json">
 
{
 
  "Номер": "Hire123",
 
  "Дата": "30.10.2019",
 
  "ТрудовойДоговорДата": "02.11.2019",
 
  "ТрудовойДоговорНомер": "123123123",
 
  "ДатаПриема": "25.10.2019",
 
  "ИдИС": "ИдИС",
 
  "ЗанимаемыхСтавок": "1.0",
 
  "НашаОрганизация": {
 
    "ИдСБИС": "167"
 
  },
 
  "Должность": {
 
    "ИдСБИС": "1"
 
  },
 
  "РабочаяГруппа": {
 
    "ИдСБИС": "437"
 
  },
 
  "ГрафикРаботы": {
 
    "ИдСБИС": "1"
 
  },
 
  "ВидЗанятости": {
 
    "ИдСБИС": "1"
 
  },
 
  "Сотрудник": {
 
    "ИдСБИС": "109",
 
    "ТабельныйНомер": "100007"
 
  },
 
  "ЧастноеЛицо": {
 
    "ИдСБИС": "2371"
 
  },
 
  "ОсновныеНачисления": [
 
    {
 
      "Показатель": "1000",
 
      "ВидНачисленияУдержания": {
 
        "ИдСБИС": "351"
 
      }
 
    },
 
    {
 
      "Показатель": "50",
 
      "ВидНачисленияУдержания": {
 
        "ИдСБИС": "318"
 
      }
 
    }
 
  ]
 
}
 
</source>
 
 
 
===Естественные ключи===
 
* Ключ1 - номер документа + дата документа + организация(вес = 3)
 
** Ключ1_1 - номер документа
 
** Ключ1_2 - дата документа
 
** Ключ1_3 - идентификатор организации в ИС
 
* Ключ2 - не используется
 
* Ключ3 - не используется
 
 
 
===Зависит от объектов===
 
* Частное лицо
 
* НашаОрганизация
 
* Сотрудник
 
* ГрафикРабочегоВремени
 
* Должность
 
* ВидЗанятости
 
* СТруктураПредприятия
 
* ВидНачисленияУдержания
 
 
 
===Используемые методы БЛ===
 
* ПриемНаРаботу.Integrate
 
 
 
[[Категория:SBIS API3 Объект]]
 

Версия 15:12, 8 августа 2023

Объект

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

Легенда:

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


Структура:

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