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

Материал из razgovorov.ru
Перейти к: навигация, поиск
(→‎ВИ3.СоздатьЭлементСправочника)
Строка 142: Строка 142:
 
<source lang="json">
 
<source lang="json">
 
{
 
{
−
   "Идентификатор": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
+
   "ИдИС": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
 
   "Фамилия": "Иванов",
 
   "Фамилия": "Иванов",
 
   "Имя": "Иван",
 
   "Имя": "Иван",

Версия 13:40, 29 сентября 2017

Сотрудник

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

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

Параметры:

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

Результат:

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

{
   "ИдИС": "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.НайтиЭлементСправочника

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

Параметры:

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

Результат:

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

{   
   "ключ1_1": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
   "ключ1_2": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
   "ключ1_3": "6a185a64-2979-11e7-9bfa-3497f6377b7e"
}

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

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

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

  • Персонал.ПрочитатьПоСотруднику
  • Контрагент.FindNearestHead
  • ЧастноеЛицо.MainPositionOnDate

ЧастноеЛицо

ВИ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 объект с данными
    • key1_1 * - идентификатор вида документа в ИС (приоритет поиска 1)
    • key1_2 * - серия документа частного лица (приоритет поиска 1)
    • key1_3 * - номер документа частного лица (приоритет поиска 1)
    • key2 - инн частного лица (приоритет поиска 2)
    • name - фио частного лица (приоритет поиска 3)

Результат:

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

{   
   "key1_1": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
   "key1_2": "1111",
   "key1_3": "111111",
   "key2": "111111111111",
   "name": "Иванов Иван Иванович"
}

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

{
   "ИдИС": "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=2758»