SBIS API3 — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
(→‎ВИ3.НайтиЭлементСправочника)
(→‎ВИ3.НайтиЭлементСправочника)
Строка 68: Строка 68:
  
 
Результат:
 
Результат:
−
Метод возвращаем массив подходящих объектов
+
Метод возвращаем массив подходящих объектов, или пустой массив
  
 
* result - массив подходящих объектов
 
* result - массив подходящих объектов
−
** Тип * – тип объекта (Строка)
 
 
** ИдИС - идентификатор ИС (Строка)
 
** ИдИС - идентификатор ИС (Строка)
 
** ИдСБИС - идентификатор СБИС (Строка)
 
** ИдСБИС - идентификатор СБИС (Строка)
−
** Название - Представление объекта(Строка)
+
** Название * - Представление объекта(Строка)
 
** Ключ1_1 - естественный ключ 1_1 (Строка)
 
** Ключ1_1 - естественный ключ 1_1 (Строка)
 
** Ключ1_2 - естественный ключ 1_2 (Строка)
 
** Ключ1_2 - естественный ключ 1_2 (Строка)

Версия 11:11, 9 октября 2017

Сотрудник

ВИ3.СоздатьЭлементСправочника

Описание: Метод создает/обновляет информацию о объекте ИС принадлежности сотрудника к юридическому лицу или его подразделению (не обновляет данные физического лица)

Параметры:

  • Тип – строка, тип объекта
  • Объект – json объект с данными объекта

Описание доступных типов и структуры данных объектов смотрите в справочнике объектов API3.

Результат:

  • ИдИС - Иднтификатор объекта ИС
  • ИдСБИС - Идентификатор объекта СБИС
  • Название - Строка представления объекта
  • Ключ1_1 - Значение ключа 1_1 в СБИС
  • Ключ1_2 - Значение ключа 1_2 в СБИС
  • Ключ1_3 - Значение ключа 1_3 в СБИС
  • Ключ2 - Значение ключа 2 в СБИС
  • Ключ3 - Значение ключа 3 в СБИС

Пример объекта Парам: 

{
   "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
   "ЧастноеЛицо_ИдИС": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
   "НашаОрганизация_ИдИС": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
   "ПодразделениеОрганизации_ИдИС": "6a185a64-2979-11e7-9bfa-3497f6377b7e"
}

Пример результата: 

{
   "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
   "ИдСБИС": "75",
   "ЧастноеЛицо_ИдИС": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
   "НашаОрганизация_ИдИС": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
   "ПодразделениеОрганизации_ИдИС": "6a185a64-2979-11e7-9bfa-3497f6377b7e"
}

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

  • Персонал.ПрочитатьПоСотруднику
  • Персонал.ЗаписатьКарточку
  • СтруктураПредприятия.КореньФилиалаКадровойСтруктуры
  • Персонал.СоздатьСотрудника

ВИ3.НайтиЭлементСправочника

Описание: Метод поиска объекта, ищет объект по переданным ключам. Поиск осуществляется по всем ключам. Результат сортируется по весу ключа.

Вес ИдСБИС = 1, Вес Ид1С = 2 (чем меньше тем выше в результате). Вес естественных ключей смотрите в справочнике объектов.

Параметры:

  • Парам
    • Тип – тип объекта
    • ИдИС - идентификатор ИС
    • ИдСБИС - идентификатор СБИС
    • Ключ1_1 - естественный ключ 1_1
    • Ключ1_2 - естественный ключ 1_2
    • Ключ1_3 - естественный ключ 1_3
    • Ключ2 - естественный ключ 2
    • Ключ3 - естественный ключ 3

Результат: Метод возвращаем массив подходящих объектов, или пустой массив

  • result - массив подходящих объектов
    • ИдИС - идентификатор ИС (Строка)
    • ИдСБИС - идентификатор СБИС (Строка)
    • Название * - Представление объекта(Строка)
    • Ключ1_1 - естественный ключ 1_1 (Строка)
    • Ключ1_2 - естественный ключ 1_2 (Строка)
    • Ключ1_3 - естественный ключ 1_3 (Строка)
    • Ключ2 - естественный ключ 2 (Строка)
    • Ключ3 - естественный ключ 3 (Строка)


Пример объекта Парам: 

{   
   "Тип": "Сотрудник",
   "Ключ1_1": "5f9102f3-28c9-11e7-a6d9-3497f6323b8f",
   "Ключ1_2": "5f9102f2-28c9-11e7-a6d9-3497f6374b3g",
}

Пример результата: 

{
   "ИдИс": "а12321а3422315",
   "ИдСБИС": "2315",
   "НазваниеСБИС": "Иванов Иван Иваныч",
   "ключ1_1": "21",
   "ключ1_2": "175",
   "ключ1_3": "2385"
}

ЧастноеЛицо

ВИ3.СоздатьЭлементСправочника

Описание: Метод создает/обновляет информацию о частном лице

Параметры:

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

Результат:

Пример объекта Парам: 

{
  "ИдИС": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
  "Фамилия": "Иванов",
  "Имя": "Иван",
  "Отчество": "Иваныч",
  "ДатаРождения": "01.01.1985",
  "ИНН": "111111111111",
  "АдресМестаРождения": "0,Ярославль,,Ярославская,Россия",
  "НомерСтраховогоСвидетельства": "100-000-000 00",
  "ДокументВид": "21",
  "ДокументСерия": "1111",
  "ДокументНомер": "111111",
  "ДокументДатаВыдачи": "01.01.2009",
  "Пол_ИдИС": "Мужской",
  "СемейноеПоложение_ИдИС": "4353f0d5-16ec-11df-b6af-00195b699aff",
  "СвФл": {
    "ТрудоваяДеятельность": [      
      {
        "Организация": "ЗАО Солнышко",
        "Комментарий": "Оператор звонкого центра",
        "Начало": "05.04.2010",
        "Конец": "22.04.2011"
      },
      {
        "Организация": "ООО Солнышко лучистое",
        "Комментарий": "Главный специалист",
        "Начало": "26.07.2011",
        "Конец": "12.04.2013"
      },
      {
        "Организация": "ООО Лучистое",
        "Комментарий": "Инженер-программист 1 категории",
        "Начало": "15.04.2013",
        "Конец": "28.11.2014"
      }
    ],
    "ЧленСемьи": [
      {
        "СтепеньРодства_ИдИС": "4353f0d4-16ec-11df-b6af-00195b699aff",
        "ФамилияИмя": "Иванова Анна Ивановна",
        "ДатаРождения": "01.06.2011"
      },
      {
        "СтепеньРодства_ИдИС": "4353f0d0-16ec-11df-b6af-00195b699aff",
        "ФамилияИмя": "Иванова Екатерина Витальевна",
        "ДатаРождения": "01.01.1990"
      },
      {
        "СтепеньРодства_ИдИС": "4353f0d4-16ec-11df-b6af-00195b699aff",
        "ФамилияИмя": "Иванова Мария Ивановна",
        "ДатаРождения": "07.02.2015"
      }
    ],
    "Образование": [
      {
        "ВидОбразования_ИдИС": "e55e3b58-60ef-4006-b0eb-a6fd3c5ec3a0",
        "НаименованиеУчЗаведения": "",
        "Профессия": "Прикладная математика и информатика",
        "ДокументВид": "Диплом",
        "ДокументНомер": "ВСГ 1111111",
        "Квалификация": "Математик, системный программист",
        "ДатаКнц": 2010
      }
    ],
    "ВоинскийУчет": {
      "ОтношениеКУчету_ИдИС": "Состоит на воинском учете",
      "ОтношениеКСлужбе_ИдИС": "Военнообязанный",
      "ВоинскоеЗвание": "Рядовой",
      "КатегорияГодности_ИдИС": "Б - годен к военной службе с незначительными ограничениями"
    }
  },
  "АдресПрописки": "150510, Ярославская обл, Ярославский р-н, Кузнечиха д, пр Сосновый, дом № 1",
  "АдресФакт": "150510, Ярославская обл, Ярославский р-н, Кузнечиха д, пр Сосновый, дом № 1"
}

Пример результата: 

{
   "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
   "ИдСБИС": "123",
   "НазваниеСБИС": "Иванов Иван Иваныч"
}

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

  • ЧастноеЛицо.Прочитать
  • ЧастноеЛицо.Записать
  • ВоинскийУчет.Записать
  • ТрудоваяДеятельность.Создать
  • ТрудоваяДеятельность.Записать
  • ContactData.FindOrCreate
  • ЧленСемьи.Записать
  • Образование.Создать
  • Образование.Записать

ВИ3.НайтиЭлементСправочника

Описание: Метод ищет частное лицо по естественным ключам

Параметры:

  • Тип – строка, значение: «ЧастноеЛицо»
  • Парам – json объект с данными
    • Ключ1_1 * - идентификатор вида документа в ИС (приоритет поиска 1)
    • Ключ1_2 * - серия документа частного лица (приоритет поиска 1)
    • Ключ1_3 * - номер документа частного лица (приоритет поиска 1)
    • Ключ2 - инн частного лица (приоритет поиска 2)
    • Название - фио частного лица (приоритет поиска 3)

Результат:

Пример объекта Парам: 

{   
   "Ключ1_1": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
   "Ключ1_2": "1111",
   "Ключ1_3": "111111",
   "Ключ2": "111111111111",
   "Название": "Иванов Иван Иванович"
}

Пример результата: 

{
   "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
   "ИдСБИС": "115",
   "НазваниеСБИС": "Иванов Иван Иваныч"
}

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

СтруктураПредприятия

ВИ3.СоздатьЭлементСправочника

Описание: Метод создает/обновляет информацию о подразделении и его принадлежности к юридическому лицу

Параметры:

  • Тип – строка, значение: «СтруктураПредприятия»
  • Парам – json объект с данными
    • ИдИС * - идентификатор подразделения в ИС
    • Раздел - идентификатор родительского подразделения в ИС
    • Организация_ИдИС * - идентификатор нашей организации в ИС
    • Название * - название подразделения организации в ИС

Результат:

Пример объекта Парам: 

{
   "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
   "Раздел": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
   "Организация_ИдИС": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
   "Название": "Администрация"
}

Пример результата: 

{
   "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
   "ИдСБИС": "2380",
   "ЧастноеЛицо_ИдИС": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
   "НашаОрганизация_ИдИС": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
   "ПодразделениеОрганизации_ИдИС": "6a185a64-2979-11e7-9bfa-3497f6377b7e"
}

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

  • СтруктураПредприятия.Прочитать
  • СтруктураПредприятия.КореньФилиалаКадровойСтруктуры
  • СтруктураПредприятия.ЗаписатьСтруктуруПредприятия

ВИ3.НайтиЭлементСправочника

Описание: Метод ищет подразделение по естественным ключам

Параметры:

  • Тип – строка, значение: «СтруктураПредприятия»
  • Парам – json объект с данными
    • ключ1_1 * - код подразделения в ИС
    • ключ1_2 * - идентификатор нашей организации в ИС

Результат:

Пример объекта Парам: 

{   
   "ключ1_1": "0000001",
   "ключ1_2": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e"
}

Пример результата: 

{
   "ИдСБИС": "2315",
   "НазваниеСБИС": "Администрация",
   "ключ1_1": "21",
   "ключ1_2": "175"
}

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

  • СтруктураПредприятия.СписокДляКарточки
Источник — «http://wiki.razgovorov.ru/index.php?title=SBIS_API3&oldid=2779»