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

Материал из razgovorov.ru
Перейти к: навигация, поиск
(→‎ВИ3.НайтиЭлементСправочника)
(→‎ВИ3.НайтиЭлементСправочника)
 
(не показано 25 промежуточных версий 2 участников)
Строка 1: Строка 1:
−
=Сотрудник=
+
=ВИ3.СоздатьЭлементСправочника=
−
==ВИ3.СоздатьЭлементСправочника==
 
  
−
Описание: Метод создает/обновляет информацию о принадлежности сотрудника к юридическому лицу или его подразделению (не обновляет данные физического лица)
+
Описание: Метод создает/обновляет информацию о [[:Категория:SBIS API3 Объект |объекте ИС]]
  
 
Параметры:
 
Параметры:
−
* Тип – строка, значение:  «Сотрудник»
+
* Тип – строка, тип объекта
−
* Парам – json объект с данными  
+
* Объект – json объект с данными объекта
−
** ИдИС * - идентификатор сотрудника в ИС
+
 
−
** ЧастноеЛицо_ИдИС * - идентификатор частного лица в ИС
+
Описание доступных типов и структуры данных объектов смотрите [[:Категория:SBIS API3 Объект|в справочнике объектов API3]].
−
** НашаОрганизация_ИдИС * - идентификатор нашей организации в ИС
 
−
** ПодразделениеОрганизации_ИдИС * - идентификатор подразделения организации в ИС
 
  
 
Результат:
 
Результат:
−
*
+
* ИдИС - Иднтификатор объекта ИС
−
*
+
* ИдСБИС - Идентификатор объекта СБИС
 +
* Название - Строка представления объекта
 +
* Ключ1_1 - Значение ключа 1_1 в СБИС
 +
* Ключ1_2 - Значение ключа 1_2 в СБИС
 +
* Ключ1_3 - Значение ключа 1_3 в СБИС
 +
* Ключ2 - Значение ключа 2 в СБИС
 +
* Ключ3 - Значение ключа 3 в СБИС
  
 
Пример объекта Парам:
 
Пример объекта Парам:
Строка 32: Строка 35:
 
{
 
{
 
   "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
 
   "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
 +
  "ИдСБИС": "75",
 
   "ЧастноеЛицо_ИдИС": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
 
   "ЧастноеЛицо_ИдИС": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
 
   "НашаОрганизация_ИдИС": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
 
   "НашаОрганизация_ИдИС": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
Строка 39: Строка 43:
 
</source>
 
</source>
  
−
Используемые методы БЛ:
+
=ВИ3.НайтиЭлементСправочника=
−
* Персонал.ПрочитатьПоСотруднику
 
−
* Персонал.ЗаписатьКарточку
 
−
* СтруктураПредприятия.КореньФилиалаКадровойСтруктуры
 
−
* Персонал.СоздатьСотрудника
 
−
 
 
−
==ВИ3.НайтиЭлементСправочника==
 
−
 
 
−
Описание: Метод ищет сотрудника по естественным ключам
 
−
 
 
−
Параметры:
 
−
* Тип – строка, значение:  «Сотрудник»
 
−
* Парам – json объект с данными
 
−
** key1_1 * - идентификатор частного лица в ИС
 
−
** key1_2 * - идентификатор нашей организации в ИС
 
−
** key1_3 * - идентификатор подразделения организации в ИС
 
−
 
 
−
Результат:
 
−
*
 
−
*
 
−
 
 
−
Пример объекта Парам:
 
−
<source lang="json">
 
−
{ 
 
−
  "key1_1": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
 
−
  "key1_2": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
 
−
  "key1_3": "6a185a64-2979-11e7-9bfa-3497f6377b7e"
 
−
}
 
−
</source>
 
−
 
 
−
Пример результата:
 
−
<source lang="json">
 
−
{
 
−
  "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
 
−
  "ЧастноеЛицо_ИдИС": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
 
−
  "НашаОрганизация_ИдИС": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
 
−
  "ПодразделениеОрганизации_ИдИС": "6a185a64-2979-11e7-9bfa-3497f6377b7e"
 
−
}
 
−
</source>
 
−
 
 
−
Используемые методы БЛ:
 
−
* Персонал.ПрочитатьПоСотруднику
 
−
* Контрагент.FindNearestHead
 
−
* ЧастноеЛицо.MainPositionOnDate
 
  
−
=ЧастноеЛицо=
+
Описание: Метод поиска объекта, ищет объект по переданным ключам. Поиск осуществляется по всем ключам. Результат сортируется по весу ключа.  
−
==ВИ3.СоздатьЭлементСправочника==
 
  
−
Описание: Метод создает/обновляет информацию о частном лице
+
Вес ИдСБИС = 1, Вес ИдИС = 2 (чем меньше тем выше в результате). Вес естественных ключей смотрите в [[:Категория:SBIS API3 Объект|справочнике объектов]].
  
 
Параметры:
 
Параметры:
−
* Тип – строка, значение:  «ЧастноеЛицо»
+
*Парам
−
* Парам – json объект с данными:
+
** Тип – тип объекта
−
** ИдИС * - идентификатор частного лица в ИС
+
** ИдИС - идентификатор ИС
−
** Фамилия * - фамилия частного лица
+
** ИдСБИС - идентификатор СБИС
−
** Имя * - имя частного лица
+
** Ключ1_1 - естественный ключ 1_1
−
** Отчество * - отчество частного лица
+
** Ключ1_2 - естественный ключ 1_2
−
** ДатаРождения  - дата рождения частного лица
+
** Ключ1_3 - естественный ключ 1_3
−
** Пол_ИдИС  - идентификатор пола частного лица в ИС
+
** Ключ2 - естественный ключ 2
−
** ДокументВид_ИдИС  - идентификатор вида удостоверяющего документа частного лица в ИС
+
** Ключ3 - естественный ключ 3
−
** ДокументСерия  - серия удостоверяющего документа частного лица
 
−
** ДокументНомер  - номер удостоверяющего документа частного лица
 
−
** ДокументДатаВыдачи  - дата выдачи удостоверяющего документа частного лица
 
−
** ИНН  - ИНН частного лица
 
−
** НомерСтраховогоСвидетельства - номер СНИЛС частного лица
 
−
** АдресПрописки - адрес места прописки частного лица
 
−
** АдресФакт - адрес фактического места жительства частного лица
 
−
** АдресМестаРождения - адрес места рождения частного лица
 
−
** СемейноеПоложение_ИдИС - идентификатор семейного положения частного лица в ИС
 
−
** СвФЛ - дополнительные сведения о частном лице
 
−
*** ВоинскийУчет - сведения о воинском учете частного лица
 
−
**** ВоинскоеЗвание
 
−
**** КатегорияГодности_ИдИС - идентификатор категории годности в ИС
 
−
**** ОтношениеКУчету_ИдИС - идентификатор отношения к воинскому учету частного лица в ИС (состоит, встает и т.д.)
 
−
**** ОтношениеКСлужбе_ИдИС - идентификатор отношения к воинской службе в ИС (военнообязанный, призывник и т.д.)
 
−
*** ТрудоваяДеятельность - сведения о трудовом стаже, местах работы частного лица
 
−
**** Организация - название организации, места работы частного лица
 
−
**** Комментарий - название должности частного лица
 
−
**** Начало - дата приема на работу
 
−
**** Конец - дата увольнения
 
−
*** КонтактЛица - контактные данные частного лица
 
−
*** ЧленСемьи - сведения о членах семьи частного лица
 
−
**** СтепеньРодства_ИдИС - идентификатор степени родства в ИС
 
−
**** ФамилияИмя - ФИО члена семьи
 
−
**** ДатаРождения - дата рождения члена семьи
 
−
*** Образование - сведения об образовании частного лица
 
−
**** ВидОбразования_ИдИС - идентификатор вида образования в ИС
 
−
**** НаименованиеУчЗаведения - название учреждения
 
−
**** Профессия - специальность
 
−
**** Квалификация
 
−
**** ДокументВид
 
−
**** ДокументНомер
 
−
**** ДатаКнц
 
  
 
Результат:
 
Результат:
−
*
+
Метод возвращаем массив подходящих объектов, или пустой массив
−
*
 
−
 
 
−
Пример объекта Парам:
 
−
<source lang="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"
 
−
}
 
−
</source>
 
−
 
 
−
Пример результата:
 
−
<source lang="json">
 
−
 
 
−
{
 
−
  "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
 
−
  "ЧастноеЛицо_ИдИС": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
 
−
  "НашаОрганизация_ИдИС": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
 
−
  "ПодразделениеОрганизации_ИдИС": "6a185a64-2979-11e7-9bfa-3497f6377b7e"
 
−
}
 
−
 
 
−
</source>
 
  
−
Используемые методы БЛ:
+
* result - массив подходящих объектов
−
* ЧастноеЛицо.Прочитать
+
** ИдИС - идентификатор ИС (Строка)
−
* ЧастноеЛицо.Записать
+
** ИдСБИС - идентификатор СБИС (Строка)
−
* ВоинскийУчет.Записать
+
** Название * - Представление объекта(Строка)
−
* ТрудоваяДеятельность.Создать
+
** Ключ1_1 - естественный ключ 1_1 (Строка)
−
* ТрудоваяДеятельность.Записать
+
** Ключ1_2 - естественный ключ 1_2 (Строка)
−
* ContactData.FindOrCreate
+
** Ключ1_3 - естественный ключ 1_3 (Строка)
−
* ЧленСемьи.Записать
+
** Ключ2 - естественный ключ 2 (Строка)
−
* Образование.Создать
+
** Ключ3 - естественный ключ 3 (Строка)
−
* Образование.Записать
 
  
−
==ВИ3.НайтиЭлементСправочника==
 
−
 
−
Описание: Метод ищет частное лицо по естественным ключам
 
−
 
−
Параметры:
 
−
* Тип – строка, значение:  «ЧастноеЛицо»
 
−
* Парам – json объект с данными
 
−
** key1_1 * - идентификатор вида документа в ИС (приоритет поиска 1)
 
−
** key1_2 * - серия документа частного лица (приоритет поиска 1)
 
−
** key1_3 * - номер документа частного лица (приоритет поиска 1)
 
−
** key2 - инн частного лица (приоритет поиска 2)
 
−
** name - фио частного лица (приоритет поиска 3)
 
−
 
−
Результат:
 
−
*
 
−
*
 
  
 
Пример объекта Парам:
 
Пример объекта Парам:
 
<source lang="json">
 
<source lang="json">
 
{   
 
{   
−
   "key1_1": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
+
   "Тип": "Сотрудник",
−
   "key1_2": "1111",
+
  "Ключ1_1": "5f9102f3-28c9-11e7-a6d9-3497f6323b8f",
−
  "key1_3": "111111",
+
   "Ключ1_2": "5f9102f2-28c9-11e7-a6d9-3497f6374b3g",
−
  "key2": "111111111111",
 
−
  "name": "Иванов Иван Иванович"
 
 
}
 
}
 
</source>
 
</source>
Строка 269: Строка 86:
 
<source lang="json">
 
<source lang="json">
 
{
 
{
−
   "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
+
   "result":
−
  "ЧастноеЛицо_ИдИС": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
+
  {
−
  "НашаОрганизация_ИдИС": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
+
      "ИдИC": "а12321а3422315",
−
  "ПодразделениеОрганизации_ИдИС": "6a185a64-2979-11e7-9bfa-3497f6377b7e"
+
      "ИдСБИС": "2315",
 +
      "Название": "Иванов Иван Иваныч",
 +
      "Ключ1_1": "21",
 +
      "Ключ1_2": "175",
 +
      "Ключ1_3": "2385"
 +
  }
 
}
 
}
 
</source>
 
</source>
−
 
−
Используемые методы БЛ:
 

Текущая версия на 09:37, 10 октября 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, Вес ИдИС = 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",
}

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

{
   "result":
   {
      "ИдИC": "а12321а3422315",
      "ИдСБИС": "2315",
      "Название": "Иванов Иван Иваныч",
      "Ключ1_1": "21",
      "Ключ1_2": "175",
      "Ключ1_3": "2385"
   }
}
Источник — «http://wiki.razgovorov.ru/index.php?title=SBIS_API3&oldid=2803»