34 KiB
Вкладка "Исходящие документы"
Для настройки нужно в Меню в поисковой строке ввести - "Настройка параметров обмена с 1С*".
Данная вкладка предназначена для описания настроек по документам, отправляемым в 1С. При первом входе в документ, табличная часть вкладки «Исходящие документы» будет пред заполнена.
Необходимо заполнить столбец «Справочник в Лексеме» в строках с «Типами»: • Заявление от сотрудника • Реквизиты заявлений от сотрудников • Служебная записка на командировку В зависимости от того, на каком «Типе» строк вызывается справочник – для выбора будет соответствующий набор данных.
Заявления от сотрудников
Для «Типа» строк «Заявления от сотрудников» необходимо заполнить следующие поля: Справочник в Лексеме – подтип из документа «Конструктор документов» с типом «Заявление от сотрудника»:
Наименование документа – наименование документа, в который будут передаваться данные. Сущность в 1С – наименование метаданных для обмена данными с 1С. Для заявлений указываются параметры для передачи. Например, Document_Отпуск. Параметр #- шаблон json передачи данных в 1С для создания приказа, указанного в столбцах "Наименование документа" и "Сущность в 1С". Например, при формировании запроса, на основании строки шаблона "Сотрудник_Key": "" из таблицы соответствия по данным заявления подбирается код сотрудника и строка будет иметь вид: "Сотрудник_Key": "d3533108-6e8a-11dc-827a-000bcdf174e3"
При первоначальной настройке необходимо для документов типа "Отпуск" указать guid видов отпуска, в тэгах "ВидОтпуска_Key":, "ВидРасчета_Key":
Параметр для повторяющей части заполняется, например, для Заявлений на доп. отпуска, потому что заявление обычно составляет один сотрудник, а для доп. отпусков запись в 1С производится в табличную часть. Для того, чтобы значение данного поля учлось при формировании параметра, в поле Параметр указывается служебное слово %parametrDetail%
Например,
*Параметр*
{"ФизическоеЛицо_Key": "",
"Сотрудник_Key": "",
................
"НачалоОтпуска": "0001-01-01T00:00:00",
"ОкончаниеОтпуска": "0001-01-01T00:00:00",
%parametrDetail% --Это часть про дополнительные отпуска
}
*Параметр для повторяющей части*
"ДополнительныеОтпуска": [
{
"Ref_Key": "00000000-0000-0000-0000-000000000000",
.....
}
]
Сущность вложения - сущность на стороне 1С, в которую передаются вложения (файлы) из документа «Заявления от сотрудника». В ней хранится перечень файлов – наименование, расширение, связка с документом в 1С, например, Catalog_ОтпускПрисоединенныеФайлы Сущность хранилища файлов InformationRegister_ХранилищеФайлов, сущность, в которой хранятся все файлы в двоичном представлении.
При появлении нового типа заявления, обмен которыми необходим между системами, нужно внести вручную новые строчки с типом и заполнить все необходимые данные. В первую очередь внести данный подтип заявления в «Конструктор документов» и указать код созданного подтипа в поле «Справочник в Лексеме | Выбор».
Для параметров, которые должны быть заполнены из СЭД, оставляем строчку пустой ": ""
Это реквизиты заявлений, а также поля: ФизическоеЛицо_Key,Сотрудник_Key,ОсновнойСотрудник_Key,ПериодРегистрации,Date,Организация_Key,Основание,Комментарий.
Дату документа "Date": "", совсем убираем из шаблона, если нужно чтобы дата создаваемого в 1С документа устанавливалась текущей датой, если будет данная строчка в шаблоне – возьмется дата заявления
Значения, которые передавать не надо, заполняем нулевыми значениями, н-р, “Руководитель_Key” : "00000000-0000-0000-0000-000000000000".
Например,
"Ref_Key": "00000000-0000-0000-0000-000000000000", --заполняем нули, так как поле типа quid и не передаем из СЭД
"DataVersion": "AAACsQAAAAA=",
"DeletionMark": false,
"Number": "",
"Posted": true,
"Организация_Key": "", --не заполняем, так как поле передается из СЭД
"ФизическоеЛицо_Key": "", --не заполняем, так как поле передается из СЭД
"ПериодРасчетаСреднегоЗаработкаНачало": "0001-01-01T00:00:00", --поле типа дата, не передаем из СЭД, поэтому заполняем нулевым значением
........
Реквизиты заявления от сотрудников
Для формирования файла обмена по Заявлению от сотрудников необходимы соответствия данных в 1с и СЭД.
Справочник в Лексеме – атрибут документа «Конструктор документов», из которого берутся значения для составления файла обмена передачи документа. Выпадающий список с атрибутами отфильтровывается по выбранному конструктору.
При выборе соответсвующего справочника в документе отображается его наименование.
Наименование документа – наименование документа, в который будут передаваться данные. Сущность в 1С – сущность на стороне 1С, в которую передаются данные. В этих строчках указываются параметры для передачи заявления от сотрудника в 1С. Параметры – имя реквизита в 1С, которое будет подставлено в шаблон выгрузки заявления. Например, в шаблоне для заявления указана строка "ДатаНачалаОсновногоОтпуска": "", ДатаНачалаОсновногоОтпуска – по этому реквизиту будет найдена строчка с описанием реквизита, по коду реквизита из документа Заявление от сотрудника найдется значение и итоговая строчка будет иметь вид: "ДатаНачалаОсновногоОтпуска":"01.12.2021"
Пример настройки для подтипа "Заявление на ежегодный оплачиваемый отпуск (по графику отпусков)":
- Тип заявления: Заявления от сотрудников
- Наименование: Заявление на ежегодный основной оплачиваемый отпуск (по графику отпусков)
- Наименование документа: ОтпускЕжегодный
- Сущность в 1С:
Document_Отпуск
- Параметр:
{"ФизическоеЛицо_Key": "",
"Сотрудник_Key": "",
"ПериодРегистрации": "",
"ДатаНачалаОсновногоОтпуска": "",
"Организация_Key": "",
"ДатаНачалаПериодаОтсутствия": "",
"ДатаОкончанияПериодаОтсутствия": "",
"КоличествоДнейОсновногоОтпуска": "",
"ДатаНачалаСобытия": "",
"ДатаОкончанияОсновногоОтпуска": "",
"Основание": "Заявление от сотрудника",
"ЗаявкаСотрудника": "",
"ПредставлениеПериода": "",
"DeletionMark": false,
"Posted": false,
"Ref_Key": "00000000-0000-0000-0000-000000000000",
"ПредоставитьОсновнойОтпуск": true,
"КоличествоДнейКомпенсацииОсновногоОтпуска": 0,
"РасходЧасовОтгула": 0,
"ПредоставитьОтгул": false,
"КоличествоДнейОтгула": 0,
"ПредоставитьКомпенсациюОсновногоОтпуска": false,
"ПредоставитьЕдиновременнуюВыплатуКОтпуску": false,
"ПредоставитьДополнительныйОтпуск": false,
"РасходДнейОтгула": 0,
"ПредоставитьМатериальнуюПомощьПриОтпуске": false,
"ВидРасчетаОтгул_Key": "00000000-0000-0000-0000-000000000000",
"ВидРасчетаЕдиновременнойВыплатыКОтпуску_Key": "00000000-0000-0000-0000-000000000000",
"ВидРасчетаМатериальнойПомощиПриОтпуске_Key": "00000000-0000-0000-0000-000000000000",
"ФиксПериодРасчетаСреднегоЗаработка": false,
"Руководитель_Key": "00000000-0000-0000-0000-000000000000",
"ПорядокВыплаты": "Межрасчет",
"ОснованиеПодписиРуководителя": "",
"ДокументПроведен": false,
"ДокументРассчитан": false,
"РассчитатьЗарплату": false,
"ИсправленныйДокумент_Key": "00000000-0000-0000-0000-000000000000",
"ГлавныйБухгалтер_Key": "00000000-0000-0000-0000-000000000000",
"ДолжностьГлавногоБухгалтера_Key": "00000000-0000-0000-0000-000000000000",
"Бухгалтер_Key": "00000000-0000-0000-0000-000000000000",
"ОснованиеПодписиГлавногоБухгалтера": "",
"ДолжностьРуководителя_Key": "00000000-0000-0000-0000-000000000000",
"ДокументЗаполнения_Key": "00000000-0000-0000-0000-000000000000",
"Ответственный_Key": "00000000-0000-0000-0000-000000000000",
"Исполнитель_Key": "00000000-0000-0000-0000-000000000000",
"ОснованиеПодписиРаботникаКадровойСлужбы": "",
"ДолжностьБухгалтера_Key": "00000000-0000-0000-0000-000000000000",
"ДолжностьИсполнителя_Key": "00000000-0000-0000-0000-000000000000",
"РаботникКадровойСлужбы_Key": "00000000-0000-0000-0000-000000000000",
"ДолжностьРаботникаКадровойСлужбы_Key": "00000000-0000-0000-0000-000000000000",
"ОснованиеПодписиБухгалтера": "",
"ДатаЗапрета": "0001-01-01T00:00:00",
"УчитыватьМРОТПриОплатеПоСреднемуЗаработку": true,
"НачалоОтпуска": "0001-01-01T00:00:00",
"ОкончаниеОтпуска": "0001-01-01T00:00:00"
}
- Сущность вложений: Catalog_ОтпускПрисоединенныеФайлы
- Сущность хранилища файлов: InformationRegister_ХранилищеФайлов
- Сущность двоичных данных файлов: Catalog_ХранилищеДвоичныхДанных
Служебная записка на конструкторе
Настройки похожи на тип «Заявления от сотрудника», но создается другой тип документа - «СЗ на конструкторе».
- Тип заявления: СЗ на конструкторе
- Наименование: (для ЗУП УПР) КТУ
- Наименование документа: (для ЗУП УПР) КТУ
- Сущность в 1С:
InformationRegister_нп_СлужебныеЗапискиЛексема
- Параметр:
{
"Ref_Key": "",
"Period": "",
"ТипСлужебнойЗаписки": "КТУ",
"GUID_Сотрудник": "",
"Сумма": ""
}
- Сущность хранилища файлов: InformationRegister_ХранилищеФайлов
- Сущность двоичных данных файлов: Catalog_ХранилищеДвоичныхДанных
Служебная записка на командировку
Настройки похожи на тип «Заявления от сотрудника», но создается другой тип документа - «Служебная записка на командировку». Документ не делится по подтипам, поэтому нет необходимости указывать подтип в поле «Справочник в Лексеме | Выбор».
- Тип заявления: Служебная записка на командировку
- Наименование: Командировка
- Сущность в 1С:
Document_Командировка
- Параметр:
{
"Ref_Key": "00000000-0000-0000-0000-000000000000",
"DataVersion": "AAAABwAAAAA=",
"DeletionMark": false,
"Number": "",
"Posted": true,
"ПериодРегистрации": "",
"Организация_Key": "",
"Сотрудник_Key": "",
"ФизическоеЛицо_Key": "",
"ВидРасчета_Key": "00000000-0000-0000-0000-000000000000",
"ВнутрисменнаяКомандировка": false,
"ДатаНачала": "",
"ДатаОкончания": "",
"ДатаКомандировки": "0001-01-01T00:00:00",
"ОплачиватьЧасов": 0,
"ДатаНачалаСобытия": "",
"ОсвобождатьСтавку": false,
"ПериодРасчетаСреднегоЗаработкаНачало": "0001-01-01T00:00:00",
"ПериодРасчетаСреднегоЗаработкаОкончание": "0001-01-01T00:00:00",
"ФиксПериодРасчетаСреднегоЗаработка": false,
"СреднийЗаработок": 0,
"Начислено": 0,
"Удержано": 0,
"ВидВремениЗамещаемый_Key": "00000000-0000-0000-0000-000000000000",
"ПорядокВыплаты": "Зарплата",
"ПланируемаяДатаВыплаты": "0001-01-01T00:00:00",
"ИсправленныйДокумент_Key": "00000000-0000-0000-0000-000000000000",
"ДокументРассчитан": false,
"Рассчитал_Key": "00000000-0000-0000-0000-000000000000",
"ПредставлениеПериода": "",
"МестоНазначения": "",
"ОрганизацияНазначения": "",
"Основание": "",
"Цель": "",
"ДнейВПути": 0,
"КомандировкаЗаСчетСредств": "",
"Руководитель_Key": "00000000-0000-0000-0000-000000000000",
"ДолжностьРуководителя_Key": "00000000-0000-0000-0000-000000000000",
"ОснованиеПодписиРуководителя": "",
"ГлавныйБухгалтер_Key": "00000000-0000-0000-0000-000000000000",
"ДолжностьГлавногоБухгалтера_Key": "00000000-0000-0000-0000-000000000000",
"ОснованиеПодписиГлавногоБухгалтера": "",
"Бухгалтер_Key": "00000000-0000-0000-0000-000000000000",
"ДолжностьБухгалтера_Key": "00000000-0000-0000-0000-000000000000",
"ОснованиеПодписиБухгалтера": "",
"Исполнитель_Key": "00000000-0000-0000-0000-000000000000",
"ДолжностьИсполнителя_Key": "00000000-0000-0000-0000-000000000000",
"ОснованиеПодписиИсполнителя": "",
"ЗаявкаСотрудника": ""
}
Параметр для повторяющей части – в СЗ на командировку может быть указано несколько сотрудников в табличной части документа. В этом поле указывается шаблон json для формирования файла обмена по табличной части документа.
- Сущность вложений: Catalog_КомандировкаПрисоединенныеФайлы
- Сущность хранилища файлов: InformationRegister_ХранилищеФайлов
- Сущность двоичных данных файлов: Catalog_ХранилищеДвоичныхДанных
Служебная записка на командировку на конструкторе
- Тип заявления: Служебная записка на командировку
- Наименование: Командировка
- Сущность в 1С:
Document_Командировка
- Параметр:
{
"Ref_Key": "00000000-0000-0000-0000-000000000000",
"DataVersion": "AAAABwAAAAA=",
"DeletionMark": false,
"Number": "",
"Posted": false,
"ПериодРегистрации": "",
"Организация_Key": "",
"Сотрудник_Key": "",
"ФизическоеЛицо_Key": "",
"ВидРасчета_Key": "00000000-0000-0000-0000-000000000000",
"ВнутрисменнаяКомандировка": false,
"ДатаНачала": "",
"ДатаОкончания": "",
"ДатаКомандировки": "0001-01-01T00:00:00",
"ОплачиватьЧасов": 0,
"ДатаНачалаСобытия": "",
"ОсвобождатьСтавку": false,
"ПериодРасчетаСреднегоЗаработкаНачало": "0001-01-01T00:00:00",
"ПериодРасчетаСреднегоЗаработкаОкончание": "0001-01-01T00:00:00",
"ФиксПериодРасчетаСреднегоЗаработка": false,
"СреднийЗаработок": 0,
"Начислено": 0,
"Удержано": 0,
"ВидВремениЗамещаемый_Key": "00000000-0000-0000-0000-000000000000",
"ПорядокВыплаты": "Зарплата",
"ПланируемаяДатаВыплаты": "0001-01-01T00:00:00",
"ИсправленныйДокумент_Key": "00000000-0000-0000-0000-000000000000",
"ДокументРассчитан": false,
"Рассчитал_Key": "00000000-0000-0000-0000-000000000000",
"ПредставлениеПериода": "",
"МестоНазначения": "",
"ОрганизацияНазначения": "",
"Основание": "",
"Цель": "",
"ДнейВПути": 0,
"КомандировкаЗаСчетСредств": "",
"Руководитель_Key": "00000000-0000-0000-0000-000000000000",
"ДолжностьРуководителя_Key": "00000000-0000-0000-0000-000000000000",
"ОснованиеПодписиРуководителя": "",
"ГлавныйБухгалтер_Key": "00000000-0000-0000-0000-000000000000",
"ДолжностьГлавногоБухгалтера_Key": "00000000-0000-0000-0000-000000000000",
"ОснованиеПодписиГлавногоБухгалтера": "",
"Бухгалтер_Key": "00000000-0000-0000-0000-000000000000",
"ДолжностьБухгалтера_Key": "00000000-0000-0000-0000-000000000000",
"ОснованиеПодписиБухгалтера": "",
"Исполнитель_Key": "00000000-0000-0000-0000-000000000000",
"ДолжностьИсполнителя_Key": "00000000-0000-0000-0000-000000000000",
"ОснованиеПодписиИсполнителя": "",
"ЗаявкаСотрудника": "",
"Комментарий": ""
}
Параметр для повторяющей части – в СЗ на командировку может быть указано несколько сотрудников в табличной части документа. В этом поле указывается шаблон json для формирования файла обмена по табличной части документа.
- Сущность вложений: Catalog_КомандировкаПрисоединенныеФайлы
- Сущность хранилища файлов: InformationRegister_ХранилищеФайлов
- Сущность двоичных данных файлов: Catalog_ХранилищеДвоичныхДанных
Уведомления Lexema
Из подписанных работником Уведомлений, сформированных по графику отпусков, есть возможность создавать приказ на отпуск в 1С. Для этого в конструкторе документов должен быть создан документ со служебным наименованием NotificationLexema:
- Тип заявления: Уведомления Lexema
- Наименование: Уведомления об отпуске
- Наименование документа: ОтпускИзУведомлений
- Сущность в 1С:
Document_Отпуск
- Параметр:
{"ФизическоеЛицо_Key": "",
"Сотрудник_Key": "",
"ПериодРегистрации": "",
"Организация_Key": "",
"ДатаНачалаОсновногоОтпуска": "",
"КоличествоДнейОсновногоОтпуска": "",
"ДатаОкончанияОсновногоОтпуска": "",
"ДатаНачалаПериодаОтсутствия": "",
"ДатаНачалаСобытия": "",
"Основание": "Заявление от сотрудника",
"ЗаявкаСотрудника": "",
"ПредставлениеПериода": "",
"Комментарий": "",
"ВидРасчетаКомпенсацииОсновногоОтпуска_Key":"00000000-0000-0000-0000-000000000000",
"DeletionMark": false,
"Posted": false,
"Ref_Key": "00000000-0000-0000-0000-000000000000",
"ПредоставитьОсновнойОтпуск": ,
"КоличествоДнейКомпенсацииОсновногоОтпуска": "",
"РасходЧасовОтгула": 0,
"ПредоставитьОтгул": false,
"КоличествоДнейОтгула": 0,
"ПредоставитьКомпенсациюОсновногоОтпуска": false,
"ПредоставитьЕдиновременнуюВыплатуКОтпуску": false,
"ПредоставитьДополнительныйОтпуск": ,
"РасходДнейОтгула": 0,
"ПредоставитьМатериальнуюПомощьПриОтпуске": false,
"ВидРасчетаОтгул_Key": "00000000-0000-0000-0000-000000000000",
"ВидРасчетаЕдиновременнойВыплатыКОтпуску_Key": "00000000-0000-0000-0000-000000000000",
"ВидРасчетаМатериальнойПомощиПриОтпуске_Key": "00000000-0000-0000-0000-000000000000",
"ФиксПериодРасчетаСреднегоЗаработка": false,
"Руководитель_Key": "00000000-0000-0000-0000-000000000000",
"ПорядокВыплаты": "Межрасчет",
"ОснованиеПодписиРуководителя": "",
"ДокументПроведен": false,
"ДокументРассчитан": false,
"ДокументПроведен": false,
"РассчитатьЗарплату": false,
"ИсправленныйДокумент_Key": "00000000-0000-0000-0000-000000000000",
"ГлавныйБухгалтер_Key": "00000000-0000-0000-0000-000000000000",
"ДолжностьГлавногоБухгалтера_Key": "00000000-0000-0000-0000-000000000000",
"Бухгалтер_Key": "00000000-0000-0000-0000-000000000000",
"ОснованиеПодписиГлавногоБухгалтера": "",
"ДолжностьРуководителя_Key": "00000000-0000-0000-0000-000000000000",
"ДокументЗаполнения_Key": "00000000-0000-0000-0000-000000000000",
"Ответственный_Key": "00000000-0000-0000-0000-000000000000",
"Исполнитель_Key": "00000000-0000-0000-0000-000000000000",
"ОснованиеПодписиРаботникаКадровойСлужбы": "",
"ДолжностьБухгалтера_Key": "00000000-0000-0000-0000-000000000000",
"ДолжностьИсполнителя_Key": "00000000-0000-0000-0000-000000000000",
"РаботникКадровойСлужбы_Key": "00000000-0000-0000-0000-000000000000",
"ДолжностьРаботникаКадровойСлужбы_Key": "00000000-0000-0000-0000-000000000000",
"ОснованиеПодписиБухгалтера": "",
"ДатаЗапрета": "0001-01-01T00:00:00",
"УчитыватьМРОТПриОплатеПоСреднемуЗаработку": true,
"НачалоОтпуска": "0001-01-01T00:00:00",
"ОкончаниеОтпуска": "0001-01-01T00:00:00",
"ДополнительныеОтпуска": [%parametrDetail%]
}
Параметр для повторяющей части:
{
"Ref_Key": "00000000-0000-0000-0000-000000000000",
"LineNumber": "1",
"ВидОтпуска_Key": "",
"ВидРасчета_Key": "00000000-0000-0000-0000-000000000000",
"НачалоПериодаЗаКоторыйПредоставляетсяОтпуск": "0001-01-01T00:00:00",
"КонецПериодаЗаКоторыйПредоставляетсяОтпуск": "0001-01-01T00:00:00",
"КоличествоДней": ,
"ДатаНачала": "",
"КоличествоДнейКомпенсации": 0,
"ВидРасчетаКомпенсации_Key": "00000000-0000-0000-0000-000000000000",
"Основание": "",
"КоличествоДнейАвансом": 0,
"ВидВремени_Key": "00000000-0000-0000-0000-000000000000"
}
- Сущность вложений: Catalog_ОтпускПрисоединенныеФайлы
- Сущность двоичных данных файлов: Catalog_ХранилищеДвоичныхДанных
Остальные поля заполняются аналогично типу «Заявления от сотрудника» Данные передаются в сущность Document_Отпуск.
Дополнительная настройка для документа "Работа в выходные и праздники"
В случае если на проекте используется документ "Работа в выходные и праздники", то необходимо выполнить следующее дополнительное условие:
- При создании [конструктор документа](../Конструктор документов/) для данного подтипа документа, также необходимо создать [пользовательские атрибуты](../../../Пользовательские типы атрибутов документов/), с наименованиями Повышенная Оплата и Отгул для данного конструктора.
!!! warning Наименования пользовательских атрибут связаны с параметрами, которые передаются в 1С. Если наименования будут отличаться в этом случае интеграция данного типа документа с системой 1С не произойдет.
Дополнительная настройка для определения подписанта кадровых документов
На проекте возможно настроить чтобы в документ "Отпуск" в системе 1С автоматически заполнялся подписант. Для этого необходимо выполнить следующие дополнительные условия:
- в документе "Виды ответственных лиц" должна быть запись об ответственном сотруднике. Поле "Должность" заполняется в произвольной форме. Поле "Служебное наименование" заполняется сервисной функцией ["Service.ListOf.COrg_HR_Doc_Sign"](../../../Настройка шаблонов маршрутов/#сервисные_функции).
- в настройках учетной политики, во вкладке "Ответственные лица" должно быть назначено должностное лицо.
- в поле "Параметр", для того типа заявления в котором необходимо заполнение подписанта, должен быть реквизит "Руководитель_Key":
"Руководитель_Key": ""
или
"Руководитель_Key": "00000000-0000-0000-0000-000000000000"