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

Материал из razgovorov.ru
Перейти к: навигация, поиск
Строка 7: Строка 7:
 
* Дата * - дата документа (строка в формате "ДД.ММ.ГГГГ")
 
* Дата * - дата документа (строка в формате "ДД.ММ.ГГГГ")
 
* НашаОрганизация * - объект [[НашаОрганизация_-_API3_Объект|НашаОрганизация]]
 
* НашаОрганизация * - объект [[НашаОрганизация_-_API3_Объект|НашаОрганизация]]
* Сотрудник * - объект [[Сотрудник_-_API3_Объект|Сотрудник]]
+
* Сотрудник - объект [[Сотрудник_-_API3_Объект|Сотрудник]] (устаревший вариант, пока поддерживаем, но скоро откажемся)
 
* ЧастноеЛицо * - объект [[ЧастноеЛицо_-_API3_Объект|ЧастноеЛицо]]
 
* ЧастноеЛицо * - объект [[ЧастноеЛицо_-_API3_Объект|ЧастноеЛицо]]
 
* ВидОтпуска * - объект [[ВидОтпуска_-_API3_Объект|ВидОтпуска]]
 
* ВидОтпуска * - объект [[ВидОтпуска_-_API3_Объект|ВидОтпуска]]
 
* РабочаяГруппа * - объект [[СтруктураПредприятия_-_API3_Объект|СтруктураПредприятия]]
 
* РабочаяГруппа * - объект [[СтруктураПредприятия_-_API3_Объект|СтруктураПредприятия]]
 
* Название * - название
 
* Название * - название
* ДатаНач - дата начала отпуска(строка в формате "ДД.ММ.ГГГГ")
+
* ДатаНач - дата начала периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ")
* ДатаКнц - дата окончания отпуска (строка в формате "ДД.ММ.ГГГГ")
+
* ДатаКнц - дата окончания периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ")
 
* ДатаРасчета - месяц расчета в котором регистрируется документ (строка в формате "ДД.ММ.ГГГГ", последний день месяца)
 
* ДатаРасчета - месяц расчета в котором регистрируется документ (строка в формате "ДД.ММ.ГГГГ", последний день месяца)
 
* КоличествоДней - продолжительность отпуска
 
* КоличествоДней - продолжительность отпуска
Строка 20: Строка 20:
 
* Комментарий
 
* Комментарий
 
* Регламент
 
* Регламент
 +
* ДолжностиСотрудника - массив, каждый элемент - должность сотрудника. Содержит расшифровку по периодам отпусков в разрезе рабочих периодов. Работает ТОЛЬКО для отпусков "без учета"
 +
** Сотрудник * - объект [[Сотрудник_-_API3_Объект|Сотрудник]]
 +
** ДатаНач - дата начала периода отсутствия в рамках всех отпусков, по текущий должности(строка в формате "ДД.ММ.ГГГГ")
 +
** ДатаКнц - дата окончания периода отсутствия в рамках всех отпусков, по текущий должности(строка в формате "ДД.ММ.ГГГГ")
 +
** РабочийПериод - массив, каждый элемент - отдельный рабочий период
 +
*** ДатаНач - дата начала основного отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
 +
*** ДатаКнц - дата окончания основного отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
 +
*** РабочийГодС - дата начала рабочего периода за который предоставляется отпуск
 +
*** РабочийГодПо - дата окончания рабочего периода за который предоставляется отпуск
 +
*** ДопОтпуск - массив, каждый элемент - период доп.отпуска
 +
**** ДатаНач - дата начала доп.отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
 +
**** ДатаКнц - дата окончания доп.отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
 +
**** Причина - объект [[ВидОтпускаДополнительный_-_API3_Объект|ВидОтпускаДополнительный]]
 +
**** Продолжительность
 +
***** Кол_во - количество дней
 +
***** ОКЕИ - '359'
  
 
'''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону'''
 
'''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону'''
Строка 53: Строка 69:
 
   "РабочаяГруппа": {
 
   "РабочаяГруппа": {
 
     "ИдСБИС": "248"
 
     "ИдСБИС": "248"
   }
+
   },
 +
  "ДолжностиСотрудника": [
 +
    {
 +
      "ДатаКнц": "15.04.2019",
 +
      "ДатаНач": "01.04.2019",
 +
      "РабочийПериод": [
 +
        {
 +
          "ДатаКнц": "15.04.2019",
 +
          "ДатаНач": "01.04.2019",
 +
          "ДопОтпуск": [
 +
            {
 +
              "ДатаКнц": "13.04.2019",
 +
              "ДатаНач": "11.04.2019",
 +
              "Причина": {
 +
                "ИдИС": "61c320cc-e1a1-4f33-bd3f-c76d1f6fde2f",
 +
                "ИдСБИС": "2",
 +
                "ИмяИС": "Справочники.ВидыОтпусков",
 +
                "ИмяСБИС": "ВидОтпускаДополнительный",
 +
                "Ини": "СинхВыгрузка_ВидОтпускаДополнительный",
 +
                "Название": "Северный"
 +
              },
 +
              "Продолжительность": {
 +
                "Кол_во": "3.00",
 +
                "ОКЕИ": "359"
 +
              }
 +
            },
 +
            {
 +
              "ДатаКнц": "15.04.2019",
 +
              "ДатаНач": "14.04.2019",
 +
              "Причина": {
 +
                "ИдИС": "4420796a-a755-11eb-aab1-f079597094ef",
 +
                "ИдСБИС": "3",
 +
                "ИмяИС": "Справочники.ВидыОтпусков",
 +
                "ИмяСБИС": "ВидОтпускаДополнительный",
 +
                "Ини": "СинхВыгрузка_ВидОтпускаДополнительный",
 +
                "Название": "ежегоный дополниьельный"
 +
              },
 +
              "Продолжительность": {
 +
                "Кол_во": "2.00",
 +
                "ОКЕИ": "359"
 +
              }
 +
            }
 +
          ],
 +
          "РабочийГодПо": "21.12.2018",
 +
          "РабочийГодС": "22.12.2017"
 +
        }
 +
      ],
 +
      "Сотрудник": {
 +
        "ИдИС": "1f64cd44-533e-11ec-8548-fc349713f338",
 +
        "ИдСБИС": "750",
 +
        "ИмяИС": "Справочники.Сотрудники",
 +
        "ИмяСБИС": "Сотрудник",
 +
        "Ини": "СинхВыгрузка_Сотрудник"
 +
      }
 +
    }
 +
  ]
 
}
 
}
 
</source>
 
</source>

Версия 15:20, 23 декабря 2021

Объект

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

Структура:

  • ИдИС - идентификатор документа в ИС (строка)
  • Номер * - номер документа (строка)
  • Дата * - дата документа (строка в формате "ДД.ММ.ГГГГ")
  • НашаОрганизация * - объект НашаОрганизация
  • Сотрудник - объект Сотрудник (устаревший вариант, пока поддерживаем, но скоро откажемся)
  • ЧастноеЛицо * - объект ЧастноеЛицо
  • ВидОтпуска * - объект ВидОтпуска
  • РабочаяГруппа * - объект СтруктураПредприятия
  • Название * - название
  • ДатаНач - дата начала периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ")
  • ДатаКнц - дата окончания периода отсутствия в рамках всех отпусков, по всем должностям(строка в формате "ДД.ММ.ГГГГ")
  • ДатаРасчета - месяц расчета в котором регистрируется документ (строка в формате "ДД.ММ.ГГГГ", последний день месяца)
  • КоличествоДней - продолжительность отпуска
  • СреднийЗаработок - сумма среднего заработка по календарным дням
  • Сумма - начисленная сумма отпускных по документу
  • Комментарий
  • Регламент
  • ДолжностиСотрудника - массив, каждый элемент - должность сотрудника. Содержит расшифровку по периодам отпусков в разрезе рабочих периодов. Работает ТОЛЬКО для отпусков "без учета"
    • Сотрудник * - объект Сотрудник
    • ДатаНач - дата начала периода отсутствия в рамках всех отпусков, по текущий должности(строка в формате "ДД.ММ.ГГГГ")
    • ДатаКнц - дата окончания периода отсутствия в рамках всех отпусков, по текущий должности(строка в формате "ДД.ММ.ГГГГ")
    • РабочийПериод - массив, каждый элемент - отдельный рабочий период
      • ДатаНач - дата начала основного отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
      • ДатаКнц - дата окончания основного отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
      • РабочийГодС - дата начала рабочего периода за который предоставляется отпуск
      • РабочийГодПо - дата окончания рабочего периода за который предоставляется отпуск
      • ДопОтпуск - массив, каждый элемент - период доп.отпуска
        • ДатаНач - дата начала доп.отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
        • ДатаКнц - дата окончания доп.отпуска в рамках текущего периода работы(строка в формате "ДД.ММ.ГГГГ")
        • Причина - объект ВидОтпускаДополнительный
        • Продолжительность
          • Кол_во - количество дней
          • ОКЕИ - '359'

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


Пример:

{
  "ИдИС": "ИдИС",
  "Номер": "update1update1",
  "Дата": "20.11.2020",
  "ДатаРасчета": "31.12.2020",
  "Название": "Отпуск №update1update1 от 20.11.2020",
  "ДатаНач": "05.01.2021",
  "ДатаКнц": "13.01.2021",
  "Комментарий": "обновили",
  "КоличествоДней": "9",
  "Сумма": "4500.00",
  "СреднийЗаработок": "500.0",
  "Регламент": "для unittest",
  "НашаОрганизация": {
    "ИдСБИС": "167"
  },
  "ЧастноеЛицо": {
    "ИдСБИС": "879"
  },
  "Сотрудник": {
    "ИдСБИС": "61"
  },
  "ВидОтпуска": {
    "ИдСБИС": "8"
  },
  "РабочаяГруппа": {
    "ИдСБИС": "248"
  },
  "ДолжностиСотрудника": [
    {
      "ДатаКнц": "15.04.2019",
      "ДатаНач": "01.04.2019",
      "РабочийПериод": [
        {
          "ДатаКнц": "15.04.2019",
          "ДатаНач": "01.04.2019",
          "ДопОтпуск": [
            {
              "ДатаКнц": "13.04.2019",
              "ДатаНач": "11.04.2019",
              "Причина": {
                "ИдИС": "61c320cc-e1a1-4f33-bd3f-c76d1f6fde2f",
                "ИдСБИС": "2",
                "ИмяИС": "Справочники.ВидыОтпусков",
                "ИмяСБИС": "ВидОтпускаДополнительный",
                "Ини": "СинхВыгрузка_ВидОтпускаДополнительный",
                "Название": "Северный"
              },
              "Продолжительность": {
                "Кол_во": "3.00",
                "ОКЕИ": "359"
              }
            },
            {
              "ДатаКнц": "15.04.2019",
              "ДатаНач": "14.04.2019",
              "Причина": {
                "ИдИС": "4420796a-a755-11eb-aab1-f079597094ef",
                "ИдСБИС": "3",
                "ИмяИС": "Справочники.ВидыОтпусков",
                "ИмяСБИС": "ВидОтпускаДополнительный",
                "Ини": "СинхВыгрузка_ВидОтпускаДополнительный",
                "Название": "ежегоный дополниьельный"
              },
              "Продолжительность": {
                "Кол_во": "2.00",
                "ОКЕИ": "359"
              }
            }
          ],
          "РабочийГодПо": "21.12.2018",
          "РабочийГодС": "22.12.2017"
        }
      ],
      "Сотрудник": {
        "ИдИС": "1f64cd44-533e-11ec-8548-fc349713f338",
        "ИдСБИС": "750",
        "ИмяИС": "Справочники.Сотрудники",
        "ИмяСБИС": "Сотрудник",
        "Ини": "СинхВыгрузка_Сотрудник"
      }
    }
  ]
}

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

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

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

  • НашаОрганизация
  • Сотрудник
  • ЧастноеЛицо
  • ВидОтпуска
  • СтруктураПредприятия

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

  • Отпуск.Прочитать