Описание API
Описание изменений в версиях
1.79 от 23.08.2025 17:03:13
Сообщение обмена: getLoansList (getLoansList)
- Добавлены поля по задолженности
1.78 от 16.07.2025 22:48:42
Сообщение обмена: getClientsList (getClientsList)
Добавлены поле Loyalty по уровням лояльности клиента
1.75 от 11.05.2025 20:47:38
Сообщение обмена: getClientLoans (getClientLoans)
Добавлено поле maxPaymentSum - максимальная сумма платежа по залогам
Сообщение обмена: getClientLoans (getClientLoans)
Добавлено поле originalPawnBillNumber
Сообщение обмена: getLoanDetails (getLoanDetails)
Добавлено поле maxPaymentSum - максимальная сумма платежа по залогам
1.74 от 25.04.2025 20:16:06
Сообщение обмена: getClientLoans (getClientLoans)
Добавлен параметр статуса залога
1.71 от 16.04.2025 15:07:11
Сообщение обмена: getClientDetails (getClientDetails)
- Добавлена дата рождения клиента
- Добавлен пол клиента
- Добавлен код отделения, где клиент последний раз делал залог
Сообщение обмена: getClientsList (getClientsList)
- Добавлена дата рождения клиента
- Добавлен пол клиента
- Добавлен код отделения, где клиент последний раз делал залог
1.70 от 31.03.2025 15:29:51
Сообщение обмена: getClientDetails (getClientDetails)
- Введено дополнительне поле ClientInternalCode
- Введено дополнительно поле Segments
Сообщение обмена: getClientsList (getClientsList)
- Введено дополнительне поле ClientInternalCode
1.69 от 25.03.2025 23:19:05
Сообщение обмена: getClientsList (getClientsList)
- Введены дополнительные поля AdditionalInformation и Segments
1.58 от 26.10.2024 21:28:45
Сообщение обмена: getClientDetails (getClientDetails)
Добавлено поле AdditionalInformation для вывода дополнительных данных клиента, не относящихся к предопределённой контактной инофрмации, например, статус программы лояльности, если она заведена через КИ.
Сообщение обмена: getPaymentSchedule (getPaymentSchedule)
Новый метод для графика платежей по залогу
Сообщение обмена: getStuffList (getStuffList)
Расширен перечень описаний объекта залога Предоставлена информация о вставках. Вставки выводятся одной строкой и разделены точкой с запятой
1.20 от 02.05.2023 14:12:37
Сообщение обмена: getClientDetails (getClientDetails)
Добавлен новый метод
Сообщение обмена: getClientLoans (getClientLoans)
Добавлено поле sellingDate
Сообщение обмена: getClientPayments (getClientPayments)
Добавлен новый метод. Получает историю погашений по клиенту
Сообщение обмена: getLoanDetails (getLoanDetails)
Добавлено новое поле DetailedInfo
Сообщение обмена: getLoanDetails (getLoanDetails)
Добавлены поля tariffID, tariffDescription
Сообщение обмена: getLocationDetails (getLocationDetails)
Добавлено новый метод
Сообщение обмена: getStuffList (getStuffList)
Добавлено поле BillNumber
Сообщение обмена: getStuffList (getStuffList)
Предоставлены ссылки на загруженные фотографии и их миниатюры в SuffList
Описание формата json
Общее описание пакета сообщений
Сообщение всегда передается в составе пакета, т.е. библиотека интеграции на стороне потребителя данных всегда ожидает массив сообщений. В частном случае в массиве может быть одно сообщение. Для каждого сообщения должны быть объявлены поля:
- MsgType - Строка - имя типа сообщения;
- MsgID - Число - уникальный номер;
- MsgData - вложенный json - содержание сообщения, формат определяется типом, который задан в MsgType;
[
{
"MsgType": "Loan", // имя типа
"MsgID": 1, // уникальный номер в пакете
"MsgData":
{
// содержание сообщения, формат определяется типом сообщения
}
},
{
"MsgType": "Client", // имя типа
"MsgID": 2, // уникальный номер в пакете
"MsgData":
{
// содержание сообщения, формат определяется типом сообщения
}
}
]
postMessage
Пакет сообщений передается в теле запроса POST "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/postMessage". Где "[ИмяБазы]" это наименование информационной базы, указанное при ее публикации. А "[ИдентификаторПоставщика]" это идентификатор поставщика, указанный в поле "Идентификатор" в соответствующем элементе справочника Поставщики данных, по настройкам которого будет загружаться пакет сообщений. Пример ответа от сервера:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор запущенного задания загрузки переданных данных
"taskStarted", "true" // Признак, что задание успешно запущено
"declineReason", "" // Представление ошибки, в случае если задание не запущено
}
getTaskStatus по заданию загрузки
Получить результат загрузки пакета сообщений можно через запрос GET "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/getTaskStatus?taskID=[ИдентификаторЗаданияПотребителя]" Где "[ИмяБазы]" это наименование информационной базы, указанное при ее публикации. А "[ИдентификаторПоставщика]" это идентификатор поставщика, использованный ранее при выгрузке данных. И "[ИдентификаторЗаданияПотребителя]" это идентификатор, полученный с ответом сервера при выполнении postMessage.
Пример ответа от сервера:
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 150000, // Общее количество сообщений в задании
"dataProcessed": 150000, // Количество обработанных на момент запроса сообщений
"dataDeclined": 2, // Количество сообщений с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID": "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания загрузки данных
"msgIDs": // Массив сообщений, которые не были загружены или были загружены с ошибками
[
{
"msgID": "34" // Идентификатор сообщения с ошибкой
},
{
"msgID": "54792" // Идентификатор сообщения с ошибкой
}
]
}
Сообщения пакета
Залог Pawn -
Наименование этого сообщения в журнале регистрации: "Залог".
Для сообщения определены следующие поля (в скобках представление для журнала регистрации):
-
ID (Идентификатор) - Строка - ;
-
Num (Номер) - Строка - ;
-
Date (Дата) - Дата - ;
-
AgreementDate (ДатаСоглашения) - Дата - ;
-
RegDate (ДатаРегистрации) - Дата - ;
-
Dept (Подразделение) - Строка - ;
-
Client (Клиент) - Строка - ;
-
Store (МестоХранения) - Строка - ;
-
FinancialProduct (Тариф) - Строка - ;
-
MainPeriodEndDate (ОкончаниеОП) - Дата - ;
-
GracePeriodEndDate (ОкончаниеЛП) - Дата - ;
-
TrueInterestCost (ПСК) - Число - ;
Необязательный параметр.
-
LoanAmount (СуммаЗайма) - Число - ;
-
LoanTerm (СрокЗайма) - Число - ;
Необязательный параметр.
-
PrincipalDebtBalance (ОстатокОсновногоДолга) - Число - ;
Необязательный параметр.
-
InterestDebtBalance (ОстатокПроцентов) - Число - ;
Необязательный параметр.
-
InterestLimitBalance (ОстатокЛимитаНачислений) - Число - ;
Необязательный параметр.
-
PawnObjects (ОбъектыЗалога) - Массив -
- ID (Идентификатор) - Строка -
- PawnValue (ЗалоговаяСтоимость) - Число -
- LoanAmount (СуммаЗайма) - Число -
-
Comment (Комментарий) - Строка - ;
Необязательный параметр.
-
InterestPlan (ПланНачислений) - Массив -
-
Begin (Начало) - Дата -
-
End (Окончание) - Дата -
-
Accrual (ВидНачисления) - Строка -
Необязательный параметр. Значение по умолчанию: ;
-
InterestRate (ПроцентнаяСтавка) - Число -
-
RegInterestRate (ПроцентнаяСтавкаРегл) - Число -
Необязательный параметр. Значение по умолчанию: 0;
-
DifCloseDate (ДатаЗакрытияРазницы) - Дата -
Необязательный параметр. Значение по умолчанию: 01.01.0001 0:00:00;
-
-
FixedInterestPlan (ПланФиксированныхНачислений) - Массив -
-
Begin (Начало) - Дата -
-
End (Окончание) - Дата -
-
Accrual (ВидНачисления) - Строка -
Необязательный параметр. Значение по умолчанию: ;
-
Amount (Сумма) - Число -
-
RegAmount (СуммаРегл) - Число -
Необязательный параметр. Значение по умолчанию: 0;
-
DifCloseDate (ДатаЗакрытияРазницы) - Дата -
Необязательный параметр. Значение по умолчанию: 01.01.0001 0:00:00;
-
Пример пакета с сообщением Pawn
[
{
"MsgType": "Pawn",
"MsgID": 1,
"MsgData":
{
"ID": ,
"Num": ,
"Date": ,
"AgreementDate": ,
"RegDate": ,
"Dept": ,
"Client": ,
"Store": ,
"FinancialProduct": ,
"MainPeriodEndDate": ,
"GracePeriodEndDate": ,
"TrueInterestCost": ,
"LoanAmount": ,
"LoanTerm": ,
"PrincipalDebtBalance": ,
"InterestDebtBalance": ,
"InterestLimitBalance": ,
"PawnObjects":
[
{
"ID": ,
"PawnValue": ,
"LoanAmount":
}
],
"Comment": ,
"InterestPlan":
[
{
"Begin": ,
"End": ,
"Accrual": ,
"InterestRate": ,
"RegInterestRate": ,
"DifCloseDate":
}
],
"FixedInterestPlan":
[
{
"Begin": ,
"End": ,
"Accrual": ,
"Amount": ,
"RegAmount": ,
"DifCloseDate":
}
]
}
}
]
Клиент Client -
Наименование этого сообщения в журнале регистрации: "Клиент".
Для сообщения определены следующие поля (в скобках представление для журнала регистрации):
-
ID (Идентификатор) - Строка - ;
-
LastName (Фамилия) - Строка - ;
-
FirstName (Имя) - Строка - ;
-
Patronymic (Отчество) - Строка - ;
Необязательный параметр.
-
Sex (Пол) - Строка - ;
Необязательный параметр.
Допустимые значения (см. описание типа с перечисляемыми значениями ПолКлиента):
- "Female" (Женский);
- "Male" (Мужской);
-
BirthDate (ДатаРождения) - Дата - ;
-
BirthPlace (МестоРождения) - Строка - ;
Необязательный параметр.
-
CitizenCountryCode (Гражданство) - Строка - ;
Необязательный параметр.
-
RussianTaxpayerID (ИНН) - Строка - ;
Необязательный параметр.
-
RussianInsuranceID (СНИЛС) - Строка - ;
Необязательный параметр.
-
TelephoneNumber (Телефон) - Строка - ;
Необязательный параметр.
-
RegirstrationAddress (АдресПрописки) - Строка - ;
Необязательный параметр.
-
ResidentialAddress (АдресПроживания) - Строка - ;
Необязательный параметр.
Пример пакета с сообщением Client
[
{
"MsgType": "Client",
"MsgID": 1,
"MsgData":
{
"ID": ,
"LastName": ,
"FirstName": ,
"Patronymic": ,
"Sex": ,
"BirthDate": ,
"BirthPlace": ,
"CitizenCountryCode": ,
"RussianTaxpayerID": ,
"RussianInsuranceID": ,
"TelephoneNumber": ,
"RegirstrationAddress": ,
"ResidentialAddress":
}
}
]
КлиентСДокументами ClientWtIdDocs - Клиент ломбарда
Наименование этого сообщения в журнале регистрации: "КлиентСДокументами".
Для сообщения определены следующие поля (в скобках представление для журнала регистрации):
-
ID (Идентификатор) - Строка - ;
-
LastName (Фамилия) - Строка - ;
-
FirstName (Имя) - Строка - ;
-
Patronymic (Отчество) - Строка - ;
Необязательный параметр.
-
Sex (Пол) - Строка - ;
Необязательный параметр.
Допустимые значения (см. описание типа с перечисляемыми значениями ПолКлиента):
- "Female" (Женский);
- "Male" (Мужской);
-
BirthDate (ДатаРождения) - Дата - ;
-
BirthPlace (МестоРождения) - Строка - ;
Необязательный параметр.
-
CitizenCountryCode (Гражданство) - Строка - ;
Необязательный параметр.
-
RussianTaxpayerID (ИНН) - Строка - ;
Необязательный параметр.
-
RussianInsuranceID (СНИЛС) - Строка - ;
Необязательный параметр.
-
TelephoneNumber (Телефон) - Строка - ;
Необязательный параметр.
-
RegirstrationAddress (АдресПрописки) - Строка - ;
Необязательный параметр.
-
ResidentialAddress (АдресПроживания) - Строка - ;
Необязательный параметр.
-
IdDocs (ДокументыУдостоверяющиеЛичность) - Массив -
-
DocType (ВидДокумента) - Строка -
-
DocSeries (СерияДокумента) - Строка -
Необязательный параметр. Значение по умолчанию: ;
-
DocNumber (НомерДокумента) - Строка -
-
DocIssueDate (ДатаВыдачиДокумента) - Дата -
-
DocIssueDepartment (КемВыданДокумент) - Строка -
Необязательный параметр. Значение по умолчанию: ;
-
DocIssueDepartmentCode (КодПодразделенияДокумента) - Строка -
Необязательный параметр. Значение по умолчанию: ;
-
Пример пакета с сообщением ClientWtIdDocs
[
{
"MsgType": "ClientWtIdDocs",
"MsgID": 1,
"MsgData":
{
"ID": ,
"LastName": ,
"FirstName": ,
"Patronymic": ,
"Sex": ,
"BirthDate": ,
"BirthPlace": ,
"CitizenCountryCode": ,
"RussianTaxpayerID": ,
"RussianInsuranceID": ,
"TelephoneNumber": ,
"RegirstrationAddress": ,
"ResidentialAddress": ,
"IdDocs":
[
{
"DocType": ,
"DocSeries": ,
"DocNumber": ,
"DocIssueDate": ,
"DocIssueDepartment": ,
"DocIssueDepartmentCode":
}
]
}
}
]
КлиентСДокументом ClientWtIdDoc -
Наименование этого сообщения в журнале регистрации: "КлиентСДокументом".
Для сообщения определены следующие поля (в скобках представление для журнала регистрации):
-
ID (Идентификатор) - Строка - ;
-
LastName (Фамилия) - Строка - ;
-
FirstName (Имя) - Строка - ;
-
Patronymic (Отчество) - Строка - ;
Необязательный параметр.
-
Sex (Пол) - Строка - ;
Необязательный параметр.
Допустимые значения (см. описание типа с перечисляемыми значениями ПолКлиента):
- "Female" (Женский);
- "Male" (Мужской);
-
BirthDate (ДатаРождения) - Дата - ;
-
BirthPlace (МестоРождения) - Строка - ;
Необязательный параметр.
-
CitizenCountryCode (Гражданство) - Строка - ;
Необязательный параметр.
-
RussianTaxpayerID (ИНН) - Строка - ;
Необязательный параметр.
-
RussianInsuranceID (СНИЛС) - Строка - ;
Необязательный параметр.
-
TelephoneNumber (Телефон) - Строка - ;
Необязательный параметр.
-
RegirstrationAddress (АдресПрописки) - Строка - ;
Необязательный параметр.
-
ResidentialAddress (АдресПроживания) - Строка - ;
Необязательный параметр.
-
IdDocType (ВидДокумента) - Строка - ;
-
IdDocSeries (СерияДокумента) - Строка - ;
Необязательный параметр. Значение по умолчанию: ""
-
IdDocNumber (НомерДокумента) - Строка - ;
-
IdDocIssueDate (ДатаВыдачиДокумента) - Дата - ;
Необязательный параметр. Значение по умолчанию: Дата("00010101000000")
-
IdDocIssueDepartment (КемВыданДокумент) - Строка - ;
Необязательный параметр. Значение по умолчанию: ""
-
IdDocIssueDepartmentCode (КодПодразделенияДокумента) - Строка - ;
Необязательный параметр. Значение по умолчанию: ""
Пример пакета с сообщением ClientWtIdDoc
[
{
"MsgType": "ClientWtIdDoc",
"MsgID": 1,
"MsgData":
{
"ID": ,
"LastName": ,
"FirstName": ,
"Patronymic": ,
"Sex": ,
"BirthDate": ,
"BirthPlace": ,
"CitizenCountryCode": ,
"RussianTaxpayerID": ,
"RussianInsuranceID": ,
"TelephoneNumber": ,
"RegirstrationAddress": ,
"ResidentialAddress": ,
"IdDocType": ,
"IdDocNumber":
}
}
]
ОбъектЗалога PawnObject -
Наименование этого сообщения в журнале регистрации: "ОбъектЗалога".
Для сообщения определены следующие поля (в скобках представление для журнала регистрации):
-
ID (Идентификатор) - Строка - ;
-
Name (Наименование) - Строка - ;
-
Type (Тип) - Строка - ;
Допустимые значения (см. описание типа с перечисляемыми значениями ТипОбъектаЗалога):
- "OtherPawnObject" (Прочее);
- "TransportFacilityPawnObject" (ТранспортныеСредства);
- "JewelleryPawnObject" (ЮвелирныеИзделия);
-
Category (Категория) - Строка - ;
-
Pawn (Залог) - Строка - ;
-
Description (Описание) - Строка - ;
Необязательный параметр.
Пример пакета с сообщением PawnObject
[
{
"MsgType": "PawnObject",
"MsgID": 1,
"MsgData":
{
"ID": ,
"Name": ,
"Type": ,
"Category": ,
"Pawn": ,
"Description":
}
}
]
ОбъектЗалогаЮвелирноеИзделие JewelleryPawnObject -
Наименование этого сообщения в журнале регистрации: "ОбъектЗалогаЮвелирноеИзделие".
Для сообщения определены следующие поля (в скобках представление для журнала регистрации):
-
ID (Идентификатор) - Строка - ;
-
Name (Наименование) - Строка - ;
-
Type (Тип) - Строка - ;
Допустимые значения (см. описание типа с перечисляемыми значениями ТипОбъектаЗалога):
- "OtherPawnObject" (Прочее);
- "TransportFacilityPawnObject" (ТранспортныеСредства);
- "JewelleryPawnObject" (ЮвелирныеИзделия);
-
Category (Категория) - Строка - ;
-
Pawn (Залог) - Строка - ;
-
Description (Описание) - Строка - ;
Необязательный параметр.
-
Metall (Металл) - Строка - ;
-
Hallmark (Проба) - Строка - ;
-
FullWeight (Вес) - Число - ;
-
MetallWeight (ВесМеталла) - Число - ;
-
Size (Размер) - Число - ;
Необязательный параметр.
Пример пакета с сообщением JewelleryPawnObject
[
{
"MsgType": "JewelleryPawnObject",
"MsgID": 1,
"MsgData":
{
"ID": ,
"Name": ,
"Type": ,
"Category": ,
"Pawn": ,
"Description": ,
"Metall": ,
"Hallmark": ,
"FullWeight": ,
"MetallWeight": ,
"Size":
}
}
]
Тариф FinancialProduct - Тариф
Сообщение предназначается для передачи информации о тарифе
Наименование этого сообщения в журнале регистрации: "Тариф".
Для сообщения определены следующие поля (в скобках представление для журнала регистрации):
-
ID (Идентификатор) - Строка - Уникальный идентификтор тарифа;
-
Name (Наименование) - Строка - Наименование тарифа;
-
Enable (Действует) - Булево - Признак доступности тарифа для новых выдач. Истина -- если тариф должен быть доступен для новых договоров, Ложь -- если тариф не должен быть скрыт при выдаче.;
-
Priority (Приоритет) - Число - Приоритет выбора тарифа при выдаче. Чем больше, тем выше в списке выбора будет отображаться тариф для нового договора. Тариф с максимальным значением будет выбран как значение по умолчанию.;
Необязательный параметр. Значение по умолчанию: 0
-
LoanTerm (СрокЗайма) - Число - Количество дней основного периода займа, для которого может применятся этот тариф.;
-
IncludeIssueDay (СрокЗаймаВключаетДеньВыдачи) - Булево - Признак, что срок займа включает или исключает день выдачи. Истина -- значит включается день выдачи, при сроке займа 2 дня, плановая дата выкупа будет на следующий день после выдачи. Ложь -- значит день выдачи исключен из срока, если займ выдается на 2 дня, плановая дата выкупа будет после завтра от дня выдачи.;
-
ProlongationEnable (ДоступноПродление) - Булево - Признак, что договоры, выданные по данному тарифу, можно продлять.;
-
DistantProlongationEnable (ДоступноДистанционноеПогашение) - Булево - Признак, что договоры, выданные по данному тарифу, можно дистанционно погашать.;
-
ProlongationAfterPartialRdmp (ПродлениеПриЧастичномВыкупе) - Булево - Признак, что договоры с более чем одним объектом залога, выданные по данному тарифу, при выкупе части заложенного имущества будут автоматически продлеваться согласно правилам продления.;
-
ProlongationTerm (СрокПродления) - Число - Количество дней основного периода, на которые продлевается договор при продлении.;
-
GracePeriodUnit (РазмерностьЛьготногоПериода) - Строка - Размерность периода заданного числом в GracePeriod (ЛьготныйПериод);
Допустимые значения (см. описание типа с перечисляемыми значениями РазмерностиЛьготногоПериода):
- "Day" (День);
- "Month" (Месяц);
-
GracePeriod (ЛьготныйПериод) - Число - Количество дней льготного периода;
-
UseFixedTrueInterestCost (ИспользоватьФиксированнуюПСК) - Булево - Признак, что по новым договорам, выданным по данному тарифу, не будет рассчитываться ПСК. Если признак установлен, в поле FixedTrueInterestCost (ФиксированнаяПСК) должно быть указано значение, которое будет копироваться в новый договор.;
Необязательный параметр. Значение по умолчанию: Ложь
-
FixedTrueInterestCost (ФиксированнаяПСК) - Число - Значение фиксированной ПСК, если по новым договорам, выданным по данному тарифу, не будет рассчитываться ПСК.;
Необязательный параметр.
-
PR (ПериодическиеНачисления) - Массив - Перечень правил начисления процентов по данному тарифу
-
Concept (Представление) - Строка - Произвольное описание правила начисления процентов
Необязательный параметр. Значение по умолчанию: ;
-
ForPawn (ДляЗалога) - Булево - Правило применяется для операции первичной выдачи
-
ForProlongation (ДляПродления) - Булево - Правило применяется для операций обычного продления и продления при частичном выкупе части имущества из договора залога
-
Period (Период) - Строка - Идентификатор варианта периода жизненного цикла договора займа
-
Direction (Направление) - Строка -
-
Begin (Начало) - Число -
-
HasEnd (ЕстьОкончание) - Булево -
-
End (Окончание) - Число -
Необязательный параметр. Значение по умолчанию: 0;
-
Accrual (ВидНачисления) - Строка -
Необязательный параметр. Значение по умолчанию: ;
-
InterestRate (Ставка) - Число -
Необязательный параметр. Значение по умолчанию: 0;
-
RegInterestRate (СтавкаРегл) - Число -
Необязательный параметр. Значение по умолчанию: 0;
-
DifClosePeriod (ПериодЗакрытияРазницы) - Строка -
Необязательный параметр. Значение по умолчанию: ;
-
DifCloseDirection (НаправлениеЗакрытияРазницы) - Строка -
Необязательный параметр. Значение по умолчанию: ;
-
DifCloseDay (ДеньЗакрытияРазницы) - Число -
Необязательный параметр. Значение по умолчанию: 0;
-
Пример пакета с сообщением FinancialProduct
[
{
"MsgType": "FinancialProduct",
"MsgID": 1,
"MsgData":
{
"ID": "f23fd3bd-3bc0-4f85-8ef4-69ced6779ff4",
"Name": "Основой тариф ломбарда",
"Enable": true,
"LoanTerm": 30,
"IncludeIssueDay": false,
"ProlongationEnable": true,
"DistantProlongationEnable": true,
"ProlongationAfterPartialRdmp": true,
"ProlongationTerm": 30,
"GracePeriodUnit": "Day",
"GracePeriod": 30,
"FixedTrueInterestCost": 0.0,
"PR":
[
{
"Concept": "Проценты на весь основной период займа",
"ForPawn": true,
"ForProlongation": true,
"Period": "MainPeriod",
"Direction": ,
"Begin": ,
"HasEnd": ,
"End": ,
"Accrual": ,
"InterestRate": ,
"RegInterestRate": ,
"DifClosePeriod": ,
"DifCloseDirection": ,
"DifCloseDay":
}
]
}
}
]
Методы
Метод может быть вызван синхронно и асинхронно: соответственно через PUT методы syncCall и asyncCall. В случае асинхронного вызова результат выполнения метода может быть получен через GET метод getTaskStatus
auth auth - Авторизоваться
Запрос авторизации пользователя по СМС
В журнале регистрации метод имеет наименование: "auth".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/auth"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/auth"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
- phoneNumber (phoneNumber) - Строка - Номер телефона для авторизации;
Пример параметров метода auth
{
"phoneNumber":
}
В случае вызова для асинхронного запуска asyncCall/auth возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/auth:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/auth возвращают результат со следующими полями (в скобках представление для журнала регистрации):
-
taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
-
dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
-
dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
-
dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
-
progress (Прогресс) - Число - Доля выполенных загрузок сообщений
-
isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
-
startTime (ВремяЗапуска) - Дата - Начало выполнения
-
finishTime (ВремяЗавершения) - Дата - Окончание выполнения
-
errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
-
providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
-
taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
-
success (success) - Булево - Успешно или нет ;
Необязательный параметр.
Пример результата метода auth
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"success": ,
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
confirmSign confirmSign - Подтвердить выпуск ПЭП клиентом
В журнале регистрации метод имеет наименование: "confirmSign".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/confirmSign"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/confirmSign"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
- requestID (requestID) - Строка - Идентификатор запроса выпуска ПЭП;
- sign (sign) - Строка - Выпущенная клиентом подпись;
- SMS (SMS) - Строка - Код, полученные клиентом;
Пример параметров метода confirmSign
{
"requestID": "8d3efade-1dca-45e5-a060-3ceb7d66eaf4",
"sign": "8d3efade-1dca-45e5-a060-3ceb7d66eaf4",
"SMS": 553852
}
В случае вызова для асинхронного запуска asyncCall/confirmSign возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/confirmSign:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/confirmSign возвращают результат со следующими полями (в скобках представление для журнала регистрации):
-
taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
-
dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
-
dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
-
dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
-
progress (Прогресс) - Число - Доля выполенных загрузок сообщений
-
isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
-
startTime (ВремяЗапуска) - Дата - Начало выполнения
-
finishTime (ВремяЗавершения) - Дата - Окончание выполнения
-
errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
-
providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
-
taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
-
success (success) - Строка - подпись подтверждена;
Необязательный параметр.
-
failReason (failReason) - Строка - описание причины неудачи;
Необязательный параметр.
Пример результата метода confirmSign
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"success": true,,
"failReason": "",
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
doRemotePayment doRemotePayment - Отразить проведенные платёж
Запрос отражения удалённого платежа
В журнале регистрации метод имеет наименование: "doRemotePayment".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/doRemotePayment"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/doRemotePayment"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
- LoanID (LoanID) - Строка - Идентификатор залога;
- PaymentSum (PaymentSum) - Число - Сумма погашения;
Пример параметров метода doRemotePayment
{
"LoanID": ""8d3efade-1dca-45e5-a060-3ceb7d66eaf4"",
"PaymentSum": 222.32
}
В случае вызова для асинхронного запуска asyncCall/doRemotePayment возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/doRemotePayment:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/doRemotePayment возвращают результат со следующими полями (в скобках представление для журнала регистрации):
-
taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
-
dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
-
dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
-
dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
-
progress (Прогресс) - Число - Доля выполенных загрузок сообщений
-
isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
-
startTime (ВремяЗапуска) - Дата - Начало выполнения
-
finishTime (ВремяЗавершения) - Дата - Окончание выполнения
-
errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
-
providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
-
taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
-
Result (Result) - Булево - Результат выполнения запроса;
Необязательный параметр.
Пример результата метода doRemotePayment
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"Result": ,
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
doRemotePayments doRemotePayments -
В журнале регистрации метод имеет наименование: "doRemotePayments".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/doRemotePayments"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/doRemotePayments"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
- Payments (Payments) - Массив -
- LoanID (ИдентификаторЗайма) - Строка -
- PaymentSum (Сумма) - Число -
Пример параметров метода doRemotePayments
{
"Payments":
[
{
"LoanID": ,
"PaymentSum":
}
]
}
В случае вызова для асинхронного запуска asyncCall/doRemotePayments возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/doRemotePayments:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/doRemotePayments возвращают результат со следующими полями (в скобках представление для журнала регистрации):
- taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
- dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
- dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
- dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
- progress (Прогресс) - Число - Доля выполенных загрузок сообщений
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
- startTime (ВремяЗапуска) - Дата - Начало выполнения
- finishTime (ВремяЗавершения) - Дата - Окончание выполнения
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
- providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
- taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
- Result (Result) - Булево - ;
Пример результата метода doRemotePayments
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"Result": ,
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
getClientDetails getClientDetails - Получить данные клиента
Информация по клиенту из базы
В журнале регистрации метод имеет наименование: "getClientDetails".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/getClientDetails"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/getClientDetails"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
- clientID (clientID) - Строка - Идентификатор клиента;
Пример параметров метода getClientDetails
{
"clientID": "8d3efade-1dca-45e5-a060-3ceb7d66eaf4"
}
В случае вызова для асинхронного запуска asyncCall/getClientDetails возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/getClientDetails:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/getClientDetails возвращают результат со следующими полями (в скобках представление для журнала регистрации):
-
taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
-
dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
-
dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
-
dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
-
progress (Прогресс) - Число - Доля выполенных загрузок сообщений
-
isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
-
startTime (ВремяЗапуска) - Дата - Начало выполнения
-
finishTime (ВремяЗавершения) - Дата - Окончание выполнения
-
errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
-
providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
-
taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
-
clientInternalCode (КодКлиента) - Строка - Код клиента в Ломбардис;
Необязательный параметр.
-
deptCode (КодОтделения) - Строка - Код подразделения, где последний раз клиент обслуживался;
Необязательный параметр.
-
surname (Фамилия) - Строка - Последний вариант фамилии;
Необязательный параметр.
-
name (Имя) - Строка - Последний вариант имени;
Необязательный параметр.
-
patronymic (Отчество) - Строка - Последний вариант отчества;
Необязательный параметр.
-
email (email) - Строка - Формат почты не гарантирован;
Необязательный параметр.
-
phone (Телефон) - Строка - Формат телефона не гарантирован;
Необязательный параметр.
-
taxNumber (ИНН) - Строка - Формат ИНН не гарантирован;
Необязательный параметр.
-
gender (Пол) - Строка - Пол клиента;
Допустимые значения (см. описание типа с перечисляемыми значениями ПолКлиента):
- "Female" (Женский);
- "Male" (Мужской);
-
birthDate (ДатаРождения) - Дата - Дата рождения;
Необязательный параметр.
-
additionalInformation (ДополнительнаяИнформация) - Массив -
- Field (Свойство) - Строка -
- Value (Значение) - Строка -
-
segments (Сегменты) - Массив -
- SegmentID (SegmentID) - Строка - Код сегмента
- SegmentDescription (SegmentDescription) - Строка - Представление сегмента
-
loyaltyLevels (УровниЛояльности) - Массив -
- Level (Уровень) - Строка - Уровень в системе лояльности
- levelCode (КодУровня) - Строка - Код уровня
- loyaltyCode (КодПрограммыЛояльности) - Строка - Код используемой программы лояльности
Пример результата метода getClientDetails
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"clientInternalCode": "001230122",,
"deptCode": "00000001",,
"surname": "Иванов",,
"name": "Алекснадр",,
"patronymic": "Владимирович",,
"email": "a@wow1c.com",,
"phone": "+79112223344",,
"taxNumber": "344346577788",,
"gender": "male",,
"birthDate": "1930-01-01T00:00:00",,
"additionalInformation":
[
{
"Field": ,
"Value":
}
],
"segments":
[
{
"SegmentID": "ПЛ_Золото",
"SegmentDescription": "Клиенты уровня Золото"
}
],
"loyaltyLevels":
[
{
"Level": "Постоянный клиент",
"levelCode": "0000002",
"loyaltyCode": "000000001"
}
]
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
getClientID getClientID - Получить идентификатор клиента
В журнале регистрации метод имеет наименование: "getClientID".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/getClientID"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/getClientID"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
- queryString (queryString) - Строка - Строка запрос: "Номер залога + дата рождения" , "Номер паспорта + дата рождения";
Пример параметров метода getClientID
{
"queryString": "АБ332211 20220101"
}
В случае вызова для асинхронного запуска asyncCall/getClientID возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/getClientID:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/getClientID возвращают результат со следующими полями (в скобках представление для журнала регистрации):
-
taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
-
dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
-
dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
-
dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
-
progress (Прогресс) - Число - Доля выполенных загрузок сообщений
-
isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
-
startTime (ВремяЗапуска) - Дата - Начало выполнения
-
finishTime (ВремяЗавершения) - Дата - Окончание выполнения
-
errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
-
providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
-
taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
-
ClientID (ClientID) - Строка - Идентфикатор клиента;
Необязательный параметр.
Пример результата метода getClientID
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"ClientID": "8d3efade-1dca-45e5-a060-3ceb7d66eaf4",
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
getClientLoans getClientLoans - Перечень залогов клиентов
В журнале регистрации метод имеет наименование: "getClientLoans".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/getClientLoans"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/getClientLoans"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
-
ClientID (clientID) - Строка - Идентификатор клиента;
-
closed (closed) - Булево - Возвращать ли закрытые займы;
Необязательный параметр. Значение по умолчанию: Ложь
-
includeAwaitingForSign (includeAwaitingForSign) - Булево - Возвращать ли займы, ожидающие подписания;
Необязательный параметр. Значение по умолчанию: Ложь
Пример параметров метода getClientLoans
{
"ClientID": "8d3efade-1dca-45e5-a060-3ceb7d66eaf4"
}
В случае вызова для асинхронного запуска asyncCall/getClientLoans возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/getClientLoans:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/getClientLoans возвращают результат со следующими полями (в скобках представление для журнала регистрации):
- taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
- dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
- dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
- dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
- progress (Прогресс) - Число - Доля выполенных загрузок сообщений
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
- startTime (ВремяЗапуска) - Дата - Начало выполнения
- finishTime (ВремяЗавершения) - Дата - Окончание выполнения
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
- providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
- taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
- Loans (Loans) - Массив -
- LoanID (LoanID) - Строка - Идентификатор залога
- pawnBillNumber (pawnBillNumber) - Строка - Номер залогового билета текущий и оригинальный
- originalPawnBillNumber (originalPawnBillNumber) - Строка - Первоначальный номер залогового билета
- LoanDescription (LoanDescription) - Строка - Описание залога
- ShortLoanDescription (ShortLoanDescription) - Строка - Наименование категории
- LoanDate (LoanDate) - Дата - Дата залога
- PaymentDate (PaymentDate) - Дата - Дата платежа
- Closed (Closed) - Булево - Признак закрытости займа
- fullDebt (fullDebt) - Число - Полная задолженность
- prolongationSum (prolongationSum) - Число - Сумма для продления
- maxPaymentSum (maxPaymentSum) - Число - Максимальная допустимая сумма платежа
- sellingDate (sellingDate) - Дата - Дата начала продажи
- PaymentAvailable (PaymentAvailable) - Булево - Доступно продление билета
- Status (Status) - Строка -
Пример результата метода getClientLoans
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
getClientNotifications getClientNotifications - Получить уведомления клиента
В журнале регистрации метод имеет наименование: "getClientNotifications".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/getClientNotifications"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/getClientNotifications"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
-
clientID (clientID) - Строка - ;
-
new (new) - Булево - ;
Необязательный параметр. Значение по умолчанию: Истина
Пример параметров метода getClientNotifications
{
"clientID":
}
В случае вызова для асинхронного запуска asyncCall/getClientNotifications возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/getClientNotifications:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/getClientNotifications возвращают результат со следующими полями (в скобках представление для журнала регистрации):
- taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
- dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
- dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
- dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
- progress (Прогресс) - Число - Доля выполенных загрузок сообщений
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
- startTime (ВремяЗапуска) - Дата - Начало выполнения
- finishTime (ВремяЗавершения) - Дата - Окончание выполнения
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
- providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
- taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
- notifications (notifications) - Массив -
- notificationID (notificationID) - Строка - Идентификатор уведомления
- notificationTime (notificationTime) - Дата - Дата и время уведомления
- topic (topic) - Строка - Заголовок уведомления пользователя
- content (content) - Строка - Подробная информация уведомления
- foundation (foundation) - Строка - Идентификатор основания (залог, выкуп, продление...)
- payload (payload) - Строка - Любая дополнительная информация
Пример результата метода getClientNotifications
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"notifications":
[
{
"notificationID": "983d55e3-2d91-4157-9192-6aae3022b711",
"notificationTime": "--",
"topic": "Заголовок уведомления",
"content": "Содержание данного уведомления",
"foundation": "guid-foundation",
"payload": "{""someInfo"":""some details""}"
}
]
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
getClientPayments getClientPayments - Список операций по клиенту (залогу)
В журнале регистрации метод имеет наименование: "getClientPayments".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/getClientPayments"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/getClientPayments"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
-
ClientID (ClientID) - Строка - Идентификатор клиента;
-
lastDays (lastDays) - Число - За сколько последних дней необходимо найти платежи;
Необязательный параметр. Значение по умолчанию: 90
Пример параметров метода getClientPayments
{
"ClientID": "8d3efade-1dca-45e5-a060-3ceb7d66eaf4"
}
В случае вызова для асинхронного запуска asyncCall/getClientPayments возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/getClientPayments:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/getClientPayments возвращают результат со следующими полями (в скобках представление для журнала регистрации):
- taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
- dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
- dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
- dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
- progress (Прогресс) - Число - Доля выполенных загрузок сообщений
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
- startTime (ВремяЗапуска) - Дата - Начало выполнения
- finishTime (ВремяЗавершения) - Дата - Окончание выполнения
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
- providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
- taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
- History (ИсторияОпераций) - Массив -
- LoanID (LoanID) - Строка - Идентификатор залога
- firstPawnBillNumber (firstPawnBillNumber) - Строка - Первичный номер залогового билета
- issuedPawnBillNumber (issuedPawnBillNumber) - Строка - Выданный номер билета
- Date (Date) - Дата - Дата и время проведённой операции в локали часового пояса базы
- Operation (Operation) - Строка - Продление, Выкуп, Частичный выкуп, Продажа с витрины (список расширяем)
- accrualType (accrualType) - Строка - Вид начисления, погашаемый платежом
- writingOffType (writingOffType) - Строка - Способ проведения погашения
- Amount (Amount) - Число - Сумма, погашаемая в рамках данного начисления
Пример результата метода getClientPayments
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"History":
[
{
"LoanID": "adkfj12341234",
"firstPawnBillNumber": "AB223311",
"issuedPawnBillNumber": "AB261222",
"Date": "2022-04-05T12:30:00",
"Operation": "Продление",
"accrualType": "Основной долг",
"writingOffType": "Наличные ККТ",
"Amount": 3300.00
}
]
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
getClientsList getClientsList - Получить список клиентов
В журнале регистрации метод имеет наименование: "getClientsList".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/getClientsList"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/getClientsList"
Для метода не предусмотрены параметры.
В случае вызова для асинхронного запуска asyncCall/getClientsList возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/getClientsList:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/getClientsList возвращают результат со следующими полями (в скобках представление для журнала регистрации):
- taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
- dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
- dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
- dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
- progress (Прогресс) - Число - Доля выполенных загрузок сообщений
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
- startTime (ВремяЗапуска) - Дата - Начало выполнения
- finishTime (ВремяЗавершения) - Дата - Окончание выполнения
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
- providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
- taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
- ClientsList (СписокКлиентов) - Массив -
- ClientID (ClientID) - Строка - Идентификартор клиента
- ClientInternalCode (ClientInternalCode) - Строка - Код клиента в Ломбардис
- PhoneNumber (PhoneNumber) - Строка - Номер телефона клиента
- FullDebt (FullDebt) - Число - Полная текущая задолженность по ОД и процентам
- FullInterestsDebt (FullInterestsDebt) - Число - Полная текущая задолженность по процентам
- OverdueDebt (OverdueDebt) - Число - Полная просроченная задолженность
- OverdueInterestsDebt (OverdueInterestsDebt) - Число - Просроченная задолженность по процентам
- NearestPaymentDate (NearestPaymentDate) - Дата - Ближайшая дата платежа
- DepartmentCode (DepartmentCode) - Строка - Код подразделения, где обслуживания клиент
- Gender (Gender) - Строка - Пол клиента
- BirthDate (BirthDate) - Дата - Дата рождения клиента
- AdditionalInformation (AdditionalInformation) - Строка - Дополнительная информация по клинту из не предопределённой контактной информации.
- Segments (Segments) - Строка - Сегменты клиента
- Loyalty (Loyalty) - Строка - Уровни лояльности клиента
Пример результата метода getClientsList
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"ClientsList":
[
{
"ClientID": "3cf0f559-a752-4068-840f-15498209a5b3",
"ClientInternalCode": "001271726",
"PhoneNumber": "+79259084181",
"FullDebt": 1000,
"FullInterestsDebt": 100,
"OverdueDebt": 1100,
"OverdueInterestsDebt": 100,
"NearestPaymentDate": "2024-04-16T00:00:00",
"DepartmentCode": "00000003",
"Gender": "male",
"BirthDate": "1983-04-16T00:00:00",
"AdditionalInformation": [ {"Field": "КастомноеПоле1", "Value": "Значение поля 1"}, {"Field": "КастомноеПоле2", "Value": "Значение поля 2"} ],
"Segments": [ {"SegmentID": "Элита", "SegmentDescription": "Сегмент элиты"}, {"SegmentID": "СПатриарших", "SegmentDescription": "Патрики наше всё"} ],
"Loyalty": [{"Level": "Базовая","levelCode": "000000001","loyaltyCode": "000000001"}]
}
]
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
getDocsForSigning getDocsForSigning - Получить документы на подпись
В журнале регистрации метод имеет наименование: "getDocsForSigning".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/getDocsForSigning"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/getDocsForSigning"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
- clientID (clientID) - Строка - Идентификатор клиента, по которому нужно получить документы на подпись.;
Пример параметров метода getDocsForSigning
{
"clientID": "8d3efade-1dca-45e5-a060-3ceb7d66eaf4"
}
В случае вызова для асинхронного запуска asyncCall/getDocsForSigning возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/getDocsForSigning:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/getDocsForSigning возвращают результат со следующими полями (в скобках представление для журнала регистрации):
- taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
- dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
- dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
- dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
- progress (Прогресс) - Число - Доля выполенных загрузок сообщений
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
- startTime (ВремяЗапуска) - Дата - Начало выполнения
- finishTime (ВремяЗавершения) - Дата - Окончание выполнения
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
- providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
- taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
- docsForSigning (docsForSigning) - Массив -
- agreementID (agreementID) - Строка - Идентификатор соглашения на подпись
- loanID (loanID) - Строка - Идентификатор договора
- docType (docType) - Строка - Тип соглашения на подпись
Пример результата метода getDocsForSigning
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"docsForSigning":
[
{
"agreementID": "8d3efade-1dca-45e5-a060-3ceb7d66eaf4",
"loanID": "8d3efade-1dca-45e5-a060-3ceb7d66eaf4",
"docType": "Залог"
}
]
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
getLoanDetails getLoanDetails - Получить информацию по займу
В журнале регистрации метод имеет наименование: "getLoanDetails".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/getLoanDetails"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/getLoanDetails"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
- LoanID (LoanID) - Строка - Идентификатор займа;
Пример параметров метода getLoanDetails
{
"LoanID": "8d3efade-1dca-45e5-a060-3ceb7d66eaf4"
}
В случае вызова для асинхронного запуска asyncCall/getLoanDetails возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/getLoanDetails:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/getLoanDetails возвращают результат со следующими полями (в скобках представление для журнала регистрации):
-
taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
-
dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
-
dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
-
dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
-
progress (Прогресс) - Число - Доля выполенных загрузок сообщений
-
isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
-
startTime (ВремяЗапуска) - Дата - Начало выполнения
-
finishTime (ВремяЗавершения) - Дата - Окончание выполнения
-
errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
-
providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
-
taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
-
LoanNumber (НомерЗалога) - Строка - Идентификатор залога;
Необязательный параметр.
-
LoanDate (ДатаЗалога) - Дата - Дата залога;
Необязательный параметр.
-
PaymentDate (ДатаВозврата) - Дата - Дата планового платежа;
Необязательный параметр.
-
SellingDate (ДатаРеализации) - Дата - Дата начала реализации;
Необязательный параметр.
-
LoanSum (СуммаЗайма) - Число - Сумма займа;
Необязательный параметр.
-
DebtSum (ВсегоНачислено) - Число - Всего начислено по займу;
Необязательный параметр.
-
InterestsSum (СуммаПроцентов) - Число - Сумма процентов по займу;
Необязательный параметр.
-
maxPaymentSum (МаксимальнаяСуммаПлатежа) - Число - Максимальная сумма платежа;
Необязательный параметр.
-
Stuff (Вещи) - Массив -
- Presentation (Presentation) - Строка - Представление, наименование вещи
- Description (Description) - Строка - Описание вещи
- FullDescription (FullDescription) - Строка - Полное описание
- Status (Status) - Строка - Текущий статус
- Location (Location) - Строка - Место положение вещи
- LocationID (LocationID) - Строка -
- StuffID (StuffID) - Строка - Идентификатор вещи
- Price (Price) - Число - Цена (залога, реализации, зависит от статуса)
- DetailedInfo (DetailedInfo) - Строка - Детальные данные по залоговой вещи. Возвращается только для метода "loan". Для sales -- пустое.
- BillNumber (BillNumber) - Строка -
- ThumbnailURLs (ThumbnailURLs) - Строка - Массив URL миниатюр , разделённых точкой с запятой
- ImageURLs (ImageURLs) - Строка - Массив URL фотографий , разделённых точкой с запятой
- StuffCode (StuffCode) - Строка -
- Gems (Gems) - Строка - Описание вставок, все перечислены через точку с запятой
-
tariffID (Тариф) - Строка - Код тарифа;
Необязательный параметр.
-
tariffDescription (ТарифОписание) - Строка - Описание тарифа;
Необязательный параметр.
-
paymentAvailable (ДоступнаОплата) - Булево - ;
Необязательный параметр.
Пример результата метода getLoanDetails
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"LoanNumber": "asdf123312ladslqwe1234",,
"LoanDate": "2022-04-05T00:00:00",,
"PaymentDate": "2022-05-05T00:00:00",,
"SellingDate": "2022-06-05T00:00:00",,
"LoanSum": 3313,,
"DebtSum": 4442,,
"InterestsSum": 1022,,
"maxPaymentSum": 3000,,
"Stuff":
[
{
"Presentation": "кольцо",
"Description": "кольцо из золота",
"FullDescription": "очень красивое прекрасное произведение искусства",
"Status": "",
"Location": "отделение севере",
"LocationID": "000003",
"StuffID": "asiodjf123--3141234sdaf",
"Price": 3446,
"DetailedInfo": ,
"BillNumber": ,
"ThumbnailURLs": /1231233/333/1.jpg;/1231233/333/2.jpg;/1231233/333/3.jpg;,
"ImageURLs": /1231233/333/1.jpg;/1231233/333/2.jpg;/1231233/333/3.jpg;,
"StuffCode": ,
"Gems": 33 Амазонит, Микроклин 3кар И-89 /; 1 Бриллиант 3кар И-89 6/3
}
],
"tariffID": "00000004",,
"tariffDescription": "5% на 30 дней",,
"paymentAvailable": ,
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
getLoanDocument getLoanDocument - Получить pdf залога
В журнале регистрации метод имеет наименование: "getLoanDocument".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/getLoanDocument"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/getLoanDocument"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
- LoanID (LoanID) - Строка - Идентификатор залога;
Пример параметров метода getLoanDocument
{
"LoanID":
}
В случае вызова для асинхронного запуска asyncCall/getLoanDocument возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/getLoanDocument:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/getLoanDocument возвращают результат со следующими полями (в скобках представление для журнала регистрации):
-
taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
-
dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
-
dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
-
dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
-
progress (Прогресс) - Число - Доля выполенных загрузок сообщений
-
isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
-
startTime (ВремяЗапуска) - Дата - Начало выполнения
-
finishTime (ВремяЗавершения) - Дата - Окончание выполнения
-
errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
-
providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
-
taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
-
result (result) - Строка - PDF в Base64;
Необязательный параметр.
Пример результата метода getLoanDocument
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"result": ,
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
getLoansList getLoansList - Произвольный запрос на обзвон
В журнале регистрации метод имеет наименование: "getLoansList".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/getLoansList"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/getLoansList"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
-
closed (Закрытые) - Булево - ;
Необязательный параметр. Значение по умолчанию: Истина
-
opened (Открытые) - Булево - ;
Необязательный параметр. Значение по умолчанию: Истина
Пример параметров метода getLoansList
{
}
В случае вызова для асинхронного запуска asyncCall/getLoansList возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/getLoansList:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/getLoansList возвращают результат со следующими полями (в скобках представление для журнала регистрации):
- taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
- dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
- dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
- dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
- progress (Прогресс) - Число - Доля выполенных загрузок сообщений
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
- startTime (ВремяЗапуска) - Дата - Начало выполнения
- finishTime (ВремяЗавершения) - Дата - Окончание выполнения
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
- providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
- taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
- result (Результат) - Массив -
- ClientID (ИдентификаторКлиента) - Строка - Идентификатор клиента
- LoanID (ИдентификаторЗалога) - Строка - Идентификатор залога
- BillNumber (НомерБилета) - Строка - Номер билета
- LoanDate (ДатаЗалога) - Дата -
- TariffID (ИдентификаторТарифа) - Строка - Код тарифа ломбардиса
- PaymentDate (ДатаПлатежа) - Дата - Плановая дата платежа
- SellingDate (ДатаНачалаРеализации) - Дата - Плановая дата начала реализации
- Debt (СуммаОсновнойДолг) - Число -
- Interests (СуммаПроценты) - Число -
- Stuff (Вещи) - Строка -
- Closed (Закрыт) - Булево -
Пример результата метода getLoansList
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"result":
[
{
"ClientID": ,
"LoanID": ,
"BillNumber": ,
"LoanDate": ,
"TariffID": ,
"PaymentDate": ,
"SellingDate": ,
"Debt": ,
"Interests": ,
"Stuff": ,
"Closed":
}
]
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
getLocationDetails getLocationDetails - Информация по отделениям
В журнале регистрации метод имеет наименование: "getLocationDetails".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/getLocationDetails"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/getLocationDetails"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
- locationCode (КодОтделения) - Строка - Код места хренения;
Пример параметров метода getLocationDetails
{
"locationCode": "00000003"
}
В случае вызова для асинхронного запуска asyncCall/getLocationDetails возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/getLocationDetails:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/getLocationDetails возвращают результат со следующими полями (в скобках представление для журнала регистрации):
-
taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
-
dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
-
dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
-
dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
-
progress (Прогресс) - Число - Доля выполенных загрузок сообщений
-
isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
-
startTime (ВремяЗапуска) - Дата - Начало выполнения
-
finishTime (ВремяЗавершения) - Дата - Окончание выполнения
-
errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
-
providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
-
taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
-
locationDescription (Описание) - Строка - Описание названия отделения;
Необязательный параметр.
-
locationAddress (Адрес) - Строка - Адрес отделения;
Необязательный параметр.
-
locationPhone (Телефон) - Строка - Телефон отделения;
Необязательный параметр.
Пример результата метода getLocationDetails
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"locationDescription": "Отделение на парковой",,
"locationAddress": "Москва, ул. Ленина д1",,
"locationPhone": "+1233331222",
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
getOperationsList getOperationsList - Получить список операций
В журнале регистрации метод имеет наименование: "getOperationsList".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/getOperationsList"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/getOperationsList"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
-
date (Дата) - Дата - ;
-
locationID (КодОтделения) - Строка - ;
Необязательный параметр. Значение по умолчанию: """"
Пример параметров метода getOperationsList
{
"date":
}
В случае вызова для асинхронного запуска asyncCall/getOperationsList возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/getOperationsList:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/getOperationsList возвращают результат со следующими полями (в скобках представление для журнала регистрации):
- taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
- dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
- dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
- dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
- progress (Прогресс) - Число - Доля выполенных загрузок сообщений
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
- startTime (ВремяЗапуска) - Дата - Начало выполнения
- finishTime (ВремяЗавершения) - Дата - Окончание выполнения
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
- providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
- taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
- operationsList (СписокОпераций) - Массив - Список операций
- date (ДатаОперации) - Дата - Дата и время операции
- clientID (ИдентификаторКлиента) - Строка - Идентификатор клиента
- loanID (ИдентификаторЗалога) - Строка - Идентификатор залога
- operation (Операция) - Строка - pawn - залог prolongation - продление partialBuyback - частичный выкуп buyback - выкуп
- locationID (КодОтделения) - Строка - Код отделения Ломбардис
- operatorID (Товаровед) - Строка - Имя товароведа
- remote (Удаленно) - Булево - Операция выполнена удалённо
Пример результата метода getOperationsList
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"operationsList":
[
{
"date": ,
"clientID": f76a9f4c-a079-4f98-9fc8-084ae7bd9f91,
"loanID": 7f93c2cb-460a-40f1-bde9-01a570220815,
"operation": "pawn",
"locationID": "00000009",
"operatorID": "Георгина Мазурова",
"remote": false
}
]
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
getPaymentSchedule getPaymentSchedule - Получить график платежей
В журнале регистрации метод имеет наименование: "getPaymentSchedule".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/getPaymentSchedule"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/getPaymentSchedule"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
-
LoanID (LoanID) - Строка - Идентификатор залога;
Необязательный параметр.
Пример параметров метода getPaymentSchedule
{
"LoanID":
}
В случае вызова для асинхронного запуска asyncCall/getPaymentSchedule возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/getPaymentSchedule:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/getPaymentSchedule возвращают результат со следующими полями (в скобках представление для журнала регистрации):
-
taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
-
dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
-
dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
-
dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
-
progress (Прогресс) - Число - Доля выполенных загрузок сообщений
-
isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
-
startTime (ВремяЗапуска) - Дата - Начало выполнения
-
finishTime (ВремяЗавершения) - Дата - Окончание выполнения
-
errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
-
providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
-
taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
-
paymentSchedule (ГрафикПлатежей) - Массив - Результат графика платежа
- typeOfAccrual (ВидНачисления) - Строка -
- amount (Сумма) - Число -
- date (Дата) - Дата -
-
scheduleEndDate (ГраницаГрафика) - Дата - Дата до которой рассчитан график;
Необязательный параметр.
Пример результата метода getPaymentSchedule
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"paymentSchedule":
[
{
"typeOfAccrual": ,
"amount": ,
"date":
}
],
"scheduleEndDate": ,
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
getReceipts getReceipts - Фискальные чеки клиента
Получает фискальные чеки по клиенту или документу. Передаётся или идентификатор клиента, или идентификатор операции.
В журнале регистрации метод имеет наименование: "getReceipts".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/getReceipts"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/getReceipts"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
-
ClientID (ClientID) - Строка - Идентификатор клиента;
Необязательный параметр.
-
OperationID (OperationID) - Строка - Идентификатор операции;
Необязательный параметр.
Пример параметров метода getReceipts
{
"ClientID": "{GUID}",
"OperationID": "{GUID}"
}
В случае вызова для асинхронного запуска asyncCall/getReceipts возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/getReceipts:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/getReceipts возвращают результат со следующими полями (в скобках представление для журнала регистрации):
- taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
- dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
- dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
- dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
- progress (Прогресс) - Число - Доля выполенных загрузок сообщений
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
- startTime (ВремяЗапуска) - Дата - Начало выполнения
- finishTime (ВремяЗавершения) - Дата - Окончание выполнения
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
- providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
- taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
- Receipts (Receipts) - Массив - Информация о чеках
- OperationID (OperationID) - Строка -
- OperationType (OperationType) - Строка -
- ReceiptID (ReceiptID) - Строка -
- ReceiptDate (ReceiptDate) - Строка -
- FiscalDocumentNumber (FiscalDocumentNumber) - Строка -
- FiscalSign (FiscalSign) - Строка -
- PDF (PDF) - Строка -
Пример результата метода getReceipts
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"Receipts":
[
{
"OperationID": ,
"OperationType": ,
"ReceiptID": ,
"ReceiptDate": ,
"FiscalDocumentNumber": ,
"FiscalSign": ,
"PDF":
}
]
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
getStuffList getStuffList - Перечень вещей
В журнале регистрации метод имеет наименование: "getStuffList".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/getStuffList"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/getStuffList"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
-
stuffType (stuffType) - Строка - Тип запрашиваемых объетов;
Допустимые значения (см. описание типа с перечисляемыми значениями stuffType):
- "loan" (loan);
- "pawner" (pawner);
- "sales" (sales);
-
reqID (reqID) - Строка - Для pawner и loan - соответствующие идентификаторы;
Необязательный параметр.
-
page (page) - Число - Номер страницы выборки данных, нумерация начинается с 1;
Необязательный параметр.
-
pageSize (pageSize) - Число - Количество элементов на странице;
Необязательный параметр.
Пример параметров метода getStuffList
{
"stuffType": "sales",
"reqID": ,
"page": 1,
"pageSize": 20
}
В случае вызова для асинхронного запуска asyncCall/getStuffList возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/getStuffList:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/getStuffList возвращают результат со следующими полями (в скобках представление для журнала регистрации):
- taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
- dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
- dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
- dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
- progress (Прогресс) - Число - Доля выполенных загрузок сообщений
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
- startTime (ВремяЗапуска) - Дата - Начало выполнения
- finishTime (ВремяЗавершения) - Дата - Окончание выполнения
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
- providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
- taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
- SuffList (SuffList) - Массив -
- Presentation (Presentation) - Строка - Представление, наименование вещи
- Description (Description) - Строка - Описание вещи
- FullDescription (FullDescription) - Строка - Полное описание
- Status (Status) - Строка - Текущий статус
- Location (Location) - Строка - Место положение вещи
- LocationID (LocationID) - Строка -
- StuffID (StuffID) - Строка - Идентификатор вещи
- Price (Price) - Число - Цена (залога, реализации, зависит от статуса)
- DetailedInfo (DetailedInfo) - Строка - Детальные данные по залоговой вещи. Возвращается только для метода "loan". Для sales -- пустое.
- BillNumber (BillNumber) - Строка -
- ThumbnailURLs (ThumbnailURLs) - Строка - Массив URL миниатюр , разделённых точкой с запятой
- ImageURLs (ImageURLs) - Строка - Массив URL фотографий , разделённых точкой с запятой
- StuffCode (StuffCode) - Строка -
- Gems (Gems) - Строка - Описание вставок, все перечислены через точку с запятой
Пример результата метода getStuffList
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"SuffList":
[
{
"Presentation": "кольцо",
"Description": "кольцо из золота",
"FullDescription": "очень красивое прекрасное произведение искусства",
"Status": "",
"Location": "отделение севере",
"LocationID": "000003",
"StuffID": "asiodjf123--3141234sdaf",
"Price": 3446,
"DetailedInfo": ,
"BillNumber": ,
"ThumbnailURLs": /1231233/333/1.jpg;/1231233/333/2.jpg;/1231233/333/3.jpg;,
"ImageURLs": /1231233/333/1.jpg;/1231233/333/2.jpg;/1231233/333/3.jpg;,
"StuffCode": ,
"Gems": 33 Амазонит, Микроклин 3кар И-89 /; 1 Бриллиант 3кар И-89 6/3
}
]
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
privateLoansForDay privateLoansForDay -
В журнале регистрации метод имеет наименование: "privateLoansForDay".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/privateLoansForDay"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/privateLoansForDay"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
- date (date) - Дата - ;
Пример параметров метода privateLoansForDay
{
"date":
}
В случае вызова для асинхронного запуска asyncCall/privateLoansForDay возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/privateLoansForDay:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/privateLoansForDay возвращают результат со следующими полями (в скобках представление для журнала регистрации):
- taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
- dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
- dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
- dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
- progress (Прогресс) - Число - Доля выполенных загрузок сообщений
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
- startTime (ВремяЗапуска) - Дата - Начало выполнения
- finishTime (ВремяЗавершения) - Дата - Окончание выполнения
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
- providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
- taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
- privateLoansForDayResult (privateLoansForDayResult) - Массив -
- PledgeID (PledgeID) - Строка -
- Branch_Code (Branch_Code) - Строка -
- Branch_Name (Branch_Name) - Строка -
- LastName (LastName) - Строка -
- FirstName (FirstName) - Строка -
- MiddleName (MiddleName) - Строка -
- ClientID (ClientID) - Строка -
- BirthDate (BirthDate) - Дата -
- DocumentType (DocumentType) - Строка -
- Series (Series) - Строка -
- Number (Number) - Строка -
- IssueDate (IssueDate) - Строка -
- IssuedBy (IssuedBy) - Строка -
- Phone (Phone) - Строка -
- PledgeDate (PledgeDate) - Дата -
- Tariff_Code (Tariff_Code) - Строка -
- Tariff_Name (Tariff_Name) - Строка -
- Appraisal_Total (Appraisal_Total) - Число -
- Loan_Total (Loan_Total) - Число -
- PayoutRoute (PayoutRoute) - Строка -
- PayoutRouteID (PayoutRouteID) - Строка -
- Responsible_Code (Responsible_Code) - Строка -
- Responsible_Name (Responsible_Name) - Строка -
- PawnTicket_Series (PawnTicket_Series) - Строка -
- PawnTicket_Number (PawnTicket_Number) - Строка -
Пример результата метода privateLoansForDay
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"privateLoansForDayResult":
[
{
"PledgeID": ,
"Branch_Code": ,
"Branch_Name": ,
"LastName": ,
"FirstName": ,
"MiddleName": ,
"ClientID": ,
"BirthDate": ,
"DocumentType": ,
"Series": ,
"Number": ,
"IssueDate": ,
"IssuedBy": ,
"Phone": ,
"PledgeDate": ,
"Tariff_Code": ,
"Tariff_Name": ,
"Appraisal_Total": ,
"Loan_Total": ,
"PayoutRoute": ,
"PayoutRouteID": ,
"Responsible_Code": ,
"Responsible_Name": ,
"PawnTicket_Series": ,
"PawnTicket_Number":
}
]
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
privatePledgedItemsForDay privatePledgedItemsForDay -
В журнале регистрации метод имеет наименование: "privatePledgedItemsForDay".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/privatePledgedItemsForDay"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/privatePledgedItemsForDay"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
-
date (date) - Дата - ;
Необязательный параметр.
Пример параметров метода privatePledgedItemsForDay
{
"date":
}
В случае вызова для асинхронного запуска asyncCall/privatePledgedItemsForDay возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/privatePledgedItemsForDay:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/privatePledgedItemsForDay возвращают результат со следующими полями (в скобках представление для журнала регистрации):
- taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
- dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
- dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
- dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
- progress (Прогресс) - Число - Доля выполенных загрузок сообщений
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
- startTime (ВремяЗапуска) - Дата - Начало выполнения
- finishTime (ВремяЗавершения) - Дата - Окончание выполнения
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
- providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
- taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
- privatePledgedItemsForDayResult (privatePledgedItemsForDayResult) - Массив -
- PledgeID (PledgeID) - Строка -
- Category_Code (Category_Code) - Строка -
- Category_Name (Category_Name) - Строка -
- Hallmark_Code (Hallmark_Code) - Строка -
- Hallmark_Name (Hallmark_Name) - Строка -
- PricePerGram (PricePerGram) - Число -
- Weight (Weight) - Число -
- InsertWeight (InsertWeight) - Число -
- NetWeight (NetWeight) - Число -
- AppraisalValue (AppraisalValue) - Число -
- LoanAmount (LoanAmount) - Число -
- PledgedItem_Name (PledgedItem_Name) - Строка -
Пример результата метода privatePledgedItemsForDay
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"privatePledgedItemsForDayResult":
[
{
"PledgeID": ,
"Category_Code": ,
"Category_Name": ,
"Hallmark_Code": ,
"Hallmark_Name": ,
"PricePerGram": ,
"Weight": ,
"InsertWeight": ,
"NetWeight": ,
"AppraisalValue": ,
"LoanAmount": ,
"PledgedItem_Name":
}
]
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
requestPayment requestPayment - Запрос оплаты через Мандарин
requestPayment
В журнале регистрации метод имеет наименование: "requestPayment".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/requestPayment"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/requestPayment"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
-
clientID (clientID) - Строка - requestPayment;
-
Loans (Loans) - Массив - requestPayment
- LoanID (LoanID) - Строка -
-
requestedPaymentSum (requestedPaymentSum) - Число - ;
Необязательный параметр. Значение по умолчанию: 0
Пример параметров метода requestPayment
{
"clientID": requestPayment,
"Loans":
[
{
"LoanID":
}
]
}
В случае вызова для асинхронного запуска asyncCall/requestPayment возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/requestPayment:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/requestPayment возвращают результат со следующими полями (в скобках представление для журнала регистрации):
-
taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
-
dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
-
dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
-
dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
-
progress (Прогресс) - Число - Доля выполенных загрузок сообщений
-
isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
-
startTime (ВремяЗапуска) - Дата - Начало выполнения
-
finishTime (ВремяЗавершения) - Дата - Окончание выполнения
-
errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
-
providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
-
taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
-
paymentLink (paymentLink) - Строка - Ссылка на оплату;
Необязательный параметр.
-
paymentSum (paymentSum) - Число - Сумма запрашиваемой оплаты;
Необязательный параметр.
-
paymentDetails (paymentDetails) - Массив - Детали платежа
- PawnbillNumber (PawnbillNumber) - Строка - Идентификтор залога
- PaymentSum (PaymentSum) - Число - Сумма платежа
Пример результата метода requestPayment
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"paymentLink": "https://mandario/somelink",,
"paymentSum": 23312,,
"paymentDetails":
[
{
"PawnbillNumber": "Аб3333",
"PaymentSum": 333
}
]
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
requestSign requestSign - Запросить ПЭП
В журнале регистрации метод имеет наименование: "requestSign".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/requestSign"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/requestSign"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
- clientID (clientID) - Строка - Идентификатор клиента;
- sign (sign) - Строка - ;
- deviceInfo (deviceInfo) - Строка - Описание устройства подписи;
- biometric (biometric) - Булево - При подписи будет применяться биометрия;
Пример параметров метода requestSign
{
"clientID": "8d3efade-1dca-45e5-a060-3ceb7d66eaf4",
"sign": "8d3efade-1dca-45e5-a060-3ceb7d66eaf4",
"deviceInfo": ,
"biometric": true
}
В случае вызова для асинхронного запуска asyncCall/requestSign возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/requestSign:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/requestSign возвращают результат со следующими полями (в скобках представление для журнала регистрации):
-
taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
-
dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
-
dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
-
dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
-
progress (Прогресс) - Число - Доля выполенных загрузок сообщений
-
isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
-
startTime (ВремяЗапуска) - Дата - Начало выполнения
-
finishTime (ВремяЗавершения) - Дата - Окончание выполнения
-
errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
-
providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
-
taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
-
success (success) - Булево - ;
Необязательный параметр.
-
failReason (failReason) - Булево - ;
Необязательный параметр.
-
requestID (requestID) - Булево - ;
Необязательный параметр.
Пример результата метода requestSign
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"success": ,,
"failReason": ,,
"requestID": ,
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
setClientAppCredentials setClientAppCredentials - Установить реквизиты приложения клиента
Для использования мобильным приложением, телеграм ботом, смс и голосовыми звонками.
В журнале регистрации метод имеет наименование: "setClientAppCredentials".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/setClientAppCredentials"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/setClientAppCredentials"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
- clientID (clientID) - Строка - Идентификатор клиента;
- credentials (credentials) - Строка - Реквизиты приложения клиента;
Пример параметров метода setClientAppCredentials
{
"clientID": "8d3efade-1dca-45e5-a060-3ceb7d66eaf4",
"credentials": "<>"
}
В случае вызова для асинхронного запуска asyncCall/setClientAppCredentials возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/setClientAppCredentials:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/setClientAppCredentials возвращают результат со следующими полями (в скобках представление для журнала регистрации):
- taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
- dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
- dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
- dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
- progress (Прогресс) - Число - Доля выполенных загрузок сообщений
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
- startTime (ВремяЗапуска) - Дата - Начало выполнения
- finishTime (ВремяЗавершения) - Дата - Окончание выполнения
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
- providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
- taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
Пример результата метода setClientAppCredentials
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
setNotificationReadMark setNotificationReadMark - Установить помтеку прочтения уведомления
В журнале регистрации метод имеет наименование: "setNotificationReadMark".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/setNotificationReadMark"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/setNotificationReadMark"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
- notificationID (notificationID) - Строка - Идентификатор уведомления;
- clientID (clientID) - Строка - ;
Пример параметров метода setNotificationReadMark
{
"notificationID": "-",
"clientID":
}
В случае вызова для асинхронного запуска asyncCall/setNotificationReadMark возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/setNotificationReadMark:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/setNotificationReadMark возвращают результат со следующими полями (в скобках представление для журнала регистрации):
- taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
- dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
- dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
- dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
- progress (Прогресс) - Число - Доля выполенных загрузок сообщений
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
- startTime (ВремяЗапуска) - Дата - Начало выполнения
- finishTime (ВремяЗавершения) - Дата - Окончание выполнения
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
- providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
- taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
Пример результата метода setNotificationReadMark
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
sign sign - Подписать соглашение
В журнале регистрации метод имеет наименование: "sign".
Синхронный вызов метода осуществляется через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/syncCall/sign"
Асинхронный вызов через PUT "[ИмяБазы]/hs/apiv1/[ИдентификаторПоставщика]/asyncCall/sign"
Для метода определены следующие параметры, передаваемые через тело запроса в виде json (в скобках представление для журнала регистрации):
- docs (docs) - Массив -
- docID (docID) - Строка - Идентификатор соглашения на подпись
- sign (sign) - Строка - Идентификатор ранее подверждённой подписи;
Пример параметров метода sign
{
"docs":
[
{
"docID": "29615365-6070-4c5d-bda1-1534d04bd73f"
}
],
"sign": "идентификатор подписи пэп"
}
В случае вызова для асинхронного запуска asyncCall/sign возвращает результат со следующими полями (в скобках представление для журнала регистрации):
- isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при запуске
- errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок запуска
- TaskID (ИдентификаторЗадания) - Строка - Идентификатор задания в случае успешного запуска
Пример результата asyncCall/sign:
{
"providerID": "ibd1", // Идентификатор поставщика данных
"taskID", "744df418-5c52-471b-9f75-8095a3abad91", // Уникальный идентификатор задания выполняющегося метода
"taskStarted", "true" // Признак, что метод успешно стартовал
"declineReason", "" // Представление ошибки, в случае если метод не запущен
}
Получать результат асинхронного выполнения метода следует через getTaskStatus по TaskID, полученному при запуске. Метод getTaskStatus и синхронный вызов syncCall/sign возвращают результат со следующими полями (в скобках представление для журнала регистрации):
-
taskStatus (СтатусЗадания) - Строка - 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
-
dataToProcess (ДанныхКОбработке) - Число - Количество объектов данных к обработке
-
dataProcessed (ДанныхОбработано) - Число - Количество обработанных на момент запроса объектов данных
-
dataDeclined (ДанныхОтклонено) - Число - Количество объектов данных с ошибками
-
progress (Прогресс) - Число - Доля выполенных загрузок сообщений
-
isError (ВыполненоСОшибкой) - Булево - Признак наличия ошибок при выполнении
-
startTime (ВремяЗапуска) - Дата - Начало выполнения
-
finishTime (ВремяЗавершения) - Дата - Окончание выполнения
-
errorMessage (СообщениеОбОшибке) - Строка - Текстовое представление ошибок при выполнении
-
providerID (ПоставщикДанных) - Строка - Идентификатор поставщика данных
-
taskID (ИдентификаторЗадания) - Строка - Уникальный идентификатор задания
-
success (success) - Булево - ;
Необязательный параметр.
-
failReason (failReason) - Строка - ;
Необязательный параметр.
Пример результата метода sign
{
"taskStatus": 1, // 1 - Запланировано; 2 - Выполняется; 3 - Выполнено
"dataToProcess": 0, // Количество объектов данных к обработке
"dataProcessed": 0, // Количество обработанных на момент запроса объектов данных
"dataDeclined": 2, // Количество объектов данных с ошибками
"progress": 1, // Доля выполенных загрузок сообщений
"isError": "true", // Наличие ошибок во время выполнения
"startTime": "20200211150000", // Начало выполнения
"finishTime": "20200211150500", // Окончание выполнения
"errorMessage": "", // Представление сообщения об ошибке
"providerID": "ibd1", // Идентификатор поставщика данных
"success": ,,
"failReason": ,
"taskID": "744df418-5c52-471b-9f75-8095a3abad91" // Уникальный идентификатор задания
}
Типы с перечисляемыми значениями
В качестве значений некоторых полей сообщения обмена могут быть использованы строки с ограниченным списком возможных значений.
agreementsStatus
Допустимые значения:
- Active - ;
- AwaitingForSign - ;
- Canceled - ;
- Draft - ;
getCustomCallingListRequestType
Допустимые значения:
- full - Запрос по всем займам, в том числе закрытым. ;
- onGracePeriod - Займы на льготном сроке;
- onSell - На периоде реализации;
- paymentDate - Запрос по дате планового платежа;
- sellingDate - Запрос по дате начала реализации;
stuffType
Допустимые значения:
- loan - ;
- pawner - ;
- sales - ;
НаправлениеОтсчета
Допустимые значения:
- AtEnd - С конца;
- AtBegin - С начала;
ПериодыНачислений
Допустимые значения:
- GracePeriod - Льготный период;
- MainPeriod - Основной период;
- RetailPeriod - Период реализации;
- Current - Текущий;
ПолКлиента
Допустимые значения:
- Female - ;
- Male - ;
РазмерностиЛьготногоПериода
Допустимые значения:
- Day - День;
- Month - Месяц;
ТипОбъектаЗалога
Допустимые значения:
- OtherPawnObject - ;
- TransportFacilityPawnObject - ;
- JewelleryPawnObject - ;