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

Материал из razgovorov.ru
Перейти к: навигация, поиск
(→‎ВИ3.СоздатьЭлементСправочника)
(→‎ВИ3.СоздатьЭлементСправочника)
Строка 106: Строка 106:
 
** АдресПрописки - адрес места прописки частного лица
 
** АдресПрописки - адрес места прописки частного лица
 
** АдресФакт - адрес фактического места жительства частного лица
 
** АдресФакт - адрес фактического места жительства частного лица
−
 
+
** АдресМестаРождения - адрес места рождения частного лица
 +
** СемейноеПоложение_ИдИС - идентификатор семейного положения частного лица в ИС
 +
** СвФЛ - дополнительные сведения о частном лице
 +
*** ВоинскийУчет - сведения о воинском учете частного лица
 +
**** ВоинскоеЗвание
 +
**** КатегорияГодности_ИдИС - идентификатор категории годности в ИС
 +
**** ОтношениеКУчету_ИдИС - идентификатор отношения к воинскому учету частного лица в ИС (состоит, встает и т.д.)
 +
**** ОтношениеКСлужбе_ИдИС - идентификатор отношения к воинской службе в ИС (военнообязанный, призывник и т.д.)
 +
*** ТрудоваяДеятельность - сведения о трудовом стаже, местах работы частного лица
 +
**** Организация - название организации, места работы частного лица
 +
**** Комментарий - название должности частного лица
 +
**** Начало - дата приема на работу
 +
**** Конец - дата увольнения
 +
*** КонтактЛица - контактные данные частного лица
 +
*** ЧленСемьи - сведения о членах семьи частного лица
 +
**** СтепеньРодства_ИдИС - идентификатор степени родства в ИС
 +
**** ФамилияИмя - ФИО члена семьи
 +
**** ДатаРождения - дата рождения члена семьи
 +
*** Образование - сведения об образовании частного лица
 +
**** ВидОбразования_ИдИС - идентификатор вида образования в ИС
 +
**** НаименованиеУчЗаведения - название учреждения
 +
**** Профессия - специальность
 +
**** Квалификация
 +
**** ДокументВид
 +
**** ДокументНомер
 +
**** ДатаКнц
  
 
Результат:
 
Результат:
Строка 114: Строка 139:
 
Пример объекта Парам:
 
Пример объекта Парам:
 
<source lang="json">
 
<source lang="json">
−
 
 
{
 
{
−
  "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
+
  "Идентификатор": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
−
  "ЧастноеЛицо_ИдИС": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
+
  "Фамилия": "Иванов",
−
  "НашаОрганизация_ИдИС": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
+
  "Имя": "Иван",
−
  "ПодразделениеОрганизации_ИдИС": "6a185a64-2979-11e7-9bfa-3497f6377b7e"
+
  "Отчество": "Иваныч",
 +
  "ДатаРождения": "01.01.1985",
 +
  "ИНН": "111111111111",
 +
  "АдресМестаРождения": "0,Ярославль,,Ярославская,Россия",
 +
  "НомерСтраховогоСвидетельства": "100-000-000 00",
 +
  "ДокументВид": "21",
 +
  "ДокументСерия": "1111",
 +
  "ДокументНомер": "111111",
 +
  "ДокументДатаВыдачи": "01.01.2009",
 +
  "Пол_ИдИС": "Мужской",
 +
  "СемейноеПоложение_ИдИС": "4353f0d5-16ec-11df-b6af-00195b699aff",
 +
  "СвФл": {
 +
    "ТрудоваяДеятельность": [
 +
      {
 +
        "Организация": "ИП Ипатов",
 +
        "Комментарий": "Продавец-консультант",
 +
        "Начало": "01.10.2006",
 +
        "Конец": "15.01.2010"
 +
      },
 +
      {
 +
        "Организация": "ЗАО Солнышко",
 +
        "Комментарий": "Оператор звонкого центра",
 +
        "Начало": "05.04.2010",
 +
        "Конец": "22.04.2011"
 +
      },
 +
      {
 +
        "Организация": "ООО Солнышко лучистое",
 +
        "Комментарий": "Главный специалист",
 +
        "Начало": "26.07.2011",
 +
        "Конец": "12.04.2013"
 +
      },
 +
      {
 +
        "Организация": "МКП \"ИРЦ\" г. Ярославля",
 +
        "Комментарий": "Инженер-программист 1 категории",
 +
        "Начало": "15.04.2013",
 +
        "Конец": "28.11.2014"
 +
      },
 +
      {
 +
        "Организация": "НПО \"Элкор\", ООО",
 +
        "Комментарий": "Программист",
 +
        "Начало": "01.12.2014",
 +
        "Конец": "15.11.2016"
 +
      }
 +
    ],
 +
    "ЧленСемьи": [
 +
      {
 +
        "СтепеньРодства_Идентификатор": "4353f0d4-16ec-11df-b6af-00195b699aff",
 +
        "ФамилияИмя": "Анисимова Анна Егоровна",
 +
        "ДатаРождения": "24.06.2011"
 +
      },
 +
      {
 +
        "СтепеньРодства_Идентификатор": "4353f0d0-16ec-11df-b6af-00195b699aff",
 +
        "ФамилияИмя": "Анисимова Екатерина Витальевна",
 +
        "ДатаРождения": "16.02.1988"
 +
      },
 +
      {
 +
        "СтепеньРодства_Идентификатор": "4353f0d4-16ec-11df-b6af-00195b699aff",
 +
        "ФамилияИмя": "Анисимова Мария Егоровна",
 +
        "ДатаРождения": "07.02.2015"
 +
      }
 +
    ],
 +
    "Образование": [
 +
      {
 +
        "ВидОбразования_Идентификатор": "e55e3b58-60ef-4006-b0eb-a6fd3c5ec3a0",
 +
        "НаименованиеУчЗаведения": "",
 +
        "Профессия": "Прикладная математика и информатика",
 +
        "ДокументВид": "ВСГ 5282549",
 +
        "ДокументНомер": "ВСГ 5282549",
 +
        "Квалификация": "Математик, системный программист",
 +
        "ДатаКнц": 2010
 +
      }
 +
    ],
 +
    "ВоинскийУчет": {
 +
      "ОтношениеКУчету_Идентификатор": "Состоит на воинском учете",
 +
      "ОтношениеКСлужбе_Идентификатор": "Военнообязанный",
 +
      "ВоинскоеЗвание": "Рядовой",
 +
      "КатегорияГодности_Идентификатор": "Б - годен к военной службе с незначительными ограничениями"
 +
    }
 +
  },
 +
  "АдресПрописки": "150510, Ярославская обл, Ярославский р-н, Кузнечиха д, пр Сосновый, дом № 1",
 +
  "АдресФакт": "150510, Ярославская обл, Ярославский р-н, Кузнечиха д, пр Сосновый, дом № 1",
 +
  "КонтактЛица_Телефон_Значение": "89201026871",
 +
  "КонтактЛица_Телефон_ТипЛица": "0",
 +
  "КонтактЛица_Телефон_Тип": "0",
 +
  "КонтактЛица_Телефон_ПодТип": "1"
 
}
 
}
 
</source>
 
</source>

Версия 15:12, 28 сентября 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",
   "ЧастноеЛицо_ИдИС": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
   "НашаОрганизация_ИдИС": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
   "ПодразделениеОрганизации_ИдИС": "6a185a64-2979-11e7-9bfa-3497f6377b7e"
}

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

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

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

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

Параметры:

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

Результат:

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

{   
   "key1_1": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
   "key1_2": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
   "key1_3": "6a185a64-2979-11e7-9bfa-3497f6377b7e"
}

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

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

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

  • Персонал.ПрочитатьПоСотруднику
  • Контрагент.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",
  "СвФл": {
    "ТрудоваяДеятельность": [
      {
        "Организация": "ИП Ипатов",
        "Комментарий": "Продавец-консультант",
        "Начало": "01.10.2006",
        "Конец": "15.01.2010"
      },
      {
        "Организация": "ЗАО Солнышко",
        "Комментарий": "Оператор звонкого центра",
        "Начало": "05.04.2010",
        "Конец": "22.04.2011"
      },
      {
        "Организация": "ООО Солнышко лучистое",
        "Комментарий": "Главный специалист",
        "Начало": "26.07.2011",
        "Конец": "12.04.2013"
      },
      {
        "Организация": "МКП \"ИРЦ\" г. Ярославля",
        "Комментарий": "Инженер-программист 1 категории",
        "Начало": "15.04.2013",
        "Конец": "28.11.2014"
      },
      {
        "Организация": "НПО \"Элкор\", ООО",
        "Комментарий": "Программист",
        "Начало": "01.12.2014",
        "Конец": "15.11.2016"
      }
    ],
    "ЧленСемьи": [
      {
        "СтепеньРодства_Идентификатор": "4353f0d4-16ec-11df-b6af-00195b699aff",
        "ФамилияИмя": "Анисимова Анна Егоровна",
        "ДатаРождения": "24.06.2011"
      },
      {
        "СтепеньРодства_Идентификатор": "4353f0d0-16ec-11df-b6af-00195b699aff",
        "ФамилияИмя": "Анисимова Екатерина Витальевна",
        "ДатаРождения": "16.02.1988"
      },
      {
        "СтепеньРодства_Идентификатор": "4353f0d4-16ec-11df-b6af-00195b699aff",
        "ФамилияИмя": "Анисимова Мария Егоровна",
        "ДатаРождения": "07.02.2015"
      }
    ],
    "Образование": [
      {
        "ВидОбразования_Идентификатор": "e55e3b58-60ef-4006-b0eb-a6fd3c5ec3a0",
        "НаименованиеУчЗаведения": "",
        "Профессия": "Прикладная математика и информатика",
        "ДокументВид": "ВСГ 5282549",
        "ДокументНомер": "ВСГ 5282549",
        "Квалификация": "Математик, системный программист",
        "ДатаКнц": 2010
      }
    ],
    "ВоинскийУчет": {
      "ОтношениеКУчету_Идентификатор": "Состоит на воинском учете",
      "ОтношениеКСлужбе_Идентификатор": "Военнообязанный",
      "ВоинскоеЗвание": "Рядовой",
      "КатегорияГодности_Идентификатор": "Б - годен к военной службе с незначительными ограничениями"
    }
  },
  "АдресПрописки": "150510, Ярославская обл, Ярославский р-н, Кузнечиха д, пр Сосновый, дом № 1",
  "АдресФакт": "150510, Ярославская обл, Ярославский р-н, Кузнечиха д, пр Сосновый, дом № 1",
  "КонтактЛица_Телефон_Значение": "89201026871",
  "КонтактЛица_Телефон_ТипЛица": "0",
  "КонтактЛица_Телефон_Тип": "0",
  "КонтактЛица_Телефон_ПодТип": "1"
}

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

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

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

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

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

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

Параметры:

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

Результат:

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

{   
   "key1_1": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
   "key1_2": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
   "key1_3": "6a185a64-2979-11e7-9bfa-3497f6377b7e"
}

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

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

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

Источник — «http://wiki.razgovorov.ru/index.php?title=SBIS_API3&oldid=2747»