Начните поиск...

API справочника «Подразделение»

Подразделение — структурная единица организации. Может быть создано в юридической и управленческой структуре.

Описание полей объекта «departments»

Параметр * — обязательный			Тип	Описание
departments			объект	подразделение
	title		строка	название подразделения
	code		строка	код подразделения
	id		строка UUID	идентификатор подразделения
	parent		объект	информация о родительском подразделении
		id	строка	идентификатор подразделения в формате UUID
		code	строка	код подразделения
	type*		число	тип подразделения. Возможные значения: «0» — подразделение, «1» — рабочая группа, «2» — обособленное подразделение
	structureType*		число	тип структуры. Возможные значения: «0» — управленческое подразделение, «1» — кадровое подразделение, «2» — является кадровым и управленческим, такое подразделение имеет все свойства кадрового и отображается в управленческой структуре
	localizationTitles		массив	список локализаций. Чтобы удалить локализацию, передайте значение «langCode» и пустое поле «title»
		langCode	строка	код языка, например «fr»
		title	строка	название подразделения
	closeDate		строка «ДД.ММ.ГГГГ»	дата закрытия
	address		строка	адрес подразделения, записанный в одну строку
	addressParts		объект	адрес подразделения, записанный частями
		settlement	строка	населенный пункт
		city	строка	город
		street	строка	улица
		house	строка	дом
		building	строка	номер корпуса/строения, литера
		flat	строка	квартира
		postalCode	строка	индекс
	organization		объект	информация об организации. Чтобы создать подразделение в головной организации, не передавайте параметры «code» и «kpp»
		inn	строка	ИНН организации
		kpp	строка	КПП организации
		code	строка	код филиала
	description		строка	примечание
	phone		строка	телефон
	email		строка	адрес электронной почты
	manager		объект	информация о руководителе
		extId	строка	внешний идентификатор сотрудника
	businessCalendar		строка	название производственного календаря
	vacationSchedule		логический	признак сдачи графиков отпусков
	timesheet		логический	признак сдачи табелей
	timekeeper		объект	информация о табельщике
		extId	строка	внешний идентификатор сотрудника

Комментарий

Особенности подразделения с типом «Обособленное подразделение»:

если для поля «type» установлено значение «Обособленное подразделение», то его нельзя изменить. Другие типы изменить на «Обособленное подразделение» можно;
обособленное подразделение всегда создает филиал в объекте «Наша компания»;
при смене типа записи с «Подразделения» на «Обособленное подразделение» нельзя выбрать филиал, всегда будет создаваться новый;
у обособленного подразделения и соответствующего ему филиала при любых изменениях всегда синхронизируются поля: «organization», «inn», «kpp», «code» (в филиале запишется в поле «code»), «address».

Команды

Для работы со справочником подразделений предусмотрены команды:

«sabyDepartment.Delete» — удаляет подразделение;
«sabyDepartment.Read» — получает список подразделений;
«sabyDepartment.Update» — создает новое или обновляет существующее подразделение.
«sabyDepartment.ChangeId» — изменяет идентификатора подразделения.

Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.