Знижка на послуги УБКІ
Сервіс з надання знижки на послуги УБКІ для ваших клієнтів
Знижка надається за рахунок УБКІ. Для партнера запити на встановлення знижки клієнтам безкоштовні.
Http Method | POST |
---|---|
Headers | Accept: application/jsonContent-Type: application/json |
Request URL | https://nr.ubki.ua/bonusservice/discount |
Request JSON( ** параметри передаються опціонально) { "sessid": "Сесійний ключ (отримуємо із API авторизації)", "reptype" : "Код послуги", "inn": "РНОКПП (ІПН) фіз.особи", "**email": "Електронна пошта фіз.особи для повідомлення СКІ" } |
Опис параметрів запиту
Параметр | Опис | Формат |
---|---|---|
sessid | Сесійний ключ (отриманий через API авторизації) | [TEXT,250] текстовий формат змінної довжини, до 250 символів |
reptype | Код послуги (ALB - Кредитна історія, BLC - Кредитний рейтинг, SKN - СтатусКонтроль на рік, SKN_3 - СтатусКонтроль на 3 місяці) | [TEXT,10] текстовий формат змінної довжини, до 10 символів |
inn | РНОКПП (ІПН) фіз.особи | [N,10] 10 чисельних символів |
Електронна пошта фіз.особи для повідомлення СКІ | [TEXT,250] текстовий формат змінної довжини, до 250 символів |
Response JSON:{ "result_code": "Код результату виконання операції", "message": "Текстове повідомлення про статус операції", "details": ["Деталі при отриманні помилки"], "partner": { "sessid": "Сесійний ключ (отриманий через API авторизації)", "userid": "ІД користувача", "bankid": "ІД організації", "bankokpo": "ЄДРПОУ організації", "bankname": "Найменування організації" }, "client": { "inn": "РНОКПП (ІПН) фіз.особи", "email": "Електронна пошта фіз.особи для повідомлення СКІ" }, "service": { "reptype": "Код послуги", "reptyperef": "Найменування послуги", "def_price": "Дефолтна вартість послуги", "sale_price": "Вартість послуги з урахуванням знижки", "discount_term": "Кількість днів дії знижки", "discount_start_date": "Дата початку дії знижки", "discount_end_date": "Дата закінчення дії знижки" } } |
Опис параметрів відповіді
Параметр | Опис | Формат |
---|---|---|
result_code | Код результату (0 - успіх, інше - помилка) | [N,10] 10 чисельних символів |
message | Текстове повідомлення про статус операції | [TEXT,40] текстовий формат змінної довжини, до 40 символів |
details | Деталі при отриманні помилки | [TEXT,1000] текстовий формат змінної довжини, до 1000 символів |
partner | ||
sessid | Сесійний ключ (отриманий через API авторизації) | [TEXT,250] текстовий формат змінної довжини, до 250 символів |
userid | ІД користувача | [TEXT,40] текстовий формат змінної довжини, до 40 символів |
bankid | ІД організації | [TEXT,40] текстовий формат змінної довжини, до 40 символів |
bankokpo | ЄДРПОУ організації | [TEXT,8] текстовий формат змінної довжини, до 8 символів |
bankname | Найменування організації | [TEXT,250] текстовий формат змінної довжини, до 250 символів |
client | ||
inn | РНОКПП (ІПН) фіз.особи | [N,10] 10 чисельних символів |
Електронна пошта фіз.особи для повідомлення СКІ | [TEXT,250] текстовий формат змінної довжини, до 250 символів | |
service | ||
reptype | Код послуги (ALB - Кредитна історія, BLC - Кредитний рейтинг, SKN - СтатусКонтроль на рік, SKN_3 - СтатусКонтроль на 3 місяці) | [TEXT,10] текстовий формат змінної довжини, до 10 символів |
reptyperef | Найменування послуги (ALB - Кредитна історія, BLC - Кредитний рейтинг, SKN - СтатусКонтроль на рік, SKN_3 - СтатусКонтроль на 3 місяці) | [TEXT,250] текстовий формат змінної довжини, до 250 символів |
def_price | Дефолтна вартість послуги ALB - 90.00 BLC - 70.00 SKN - 900.00 SKN_3 - 250.00 | [N,15,2], числовий формат з плаваючою точкою, 2 цифри після крапки |
sale_price | Вартість послуги з урахуванням знижки ALB - 70.00 BLC - 50.00 SKN - 700.00 SKN_3 - 192.00 | [N,15,2], числовий формат з плаваючою точкою, 2 цифри після крапки |
discount_term | Кількість днів дії знижки | [N,10] 10 чисельних символів |
discount_start_date | Дата початку дії знижки | Формат дати [2024-14-01 12:00:00] |
discount_end_date | Дата закінчення дії знижки | Формат дати [2024-14-01 12:00:00] |
Довідник нотифікацій та помилок
result_code | message |
---|---|
0 | Операція успішна. Служба підтримки УБКІ: 0445851196. |
1 | Невірний чи застарілий сесійний ключ. Служба підтримки УБКІ: 0445851196. |
2 | Запит відхилено - діє послуга СтатусКонтроль. Служба підтримки УБКІ: 0445851196. |
3 | Дані суб’єкта для побудови звіту відсутні в базі бюро. Служба підтримки УБКІ: 0445851196. |
4 | Відсутні або невалідні обов’язкові атрибути. Служба підтримки УБКІ: 0445851196. |
5 | Системна помилка. Служба підтримки УБКІ: 0445851196. |
Приклад |
---|
Request JSON | {
"sessid": "98D0069895B34892A264845F71167FEF",
"reptype" : "ALB",
"inn": "3241500301",
"email": "o.limarenko@gmail.com"
} |
Response JSON | {
"result_code": "0",
"message": "Операцію успішно виконано. Служба підтримки УБКІ: 0445851196.",
"partner": {
"sessid": "98D0069895B34892A264845F71167FEF",
"userid": "29120",
"bankid": "1826",
"bankokpo": "01982523",
"bankname": "КВІТЕНЬ"
},
"client": {
"inn": "3241500301",
"email": "o.limarenko@gmail.com"
},
"service": {
"reptype": "ALB",
"reptyperef": "Кредитна історія",
"def_price": "90",
"sale_price": "70",
"discount_term": "7",
"discount_start_date": "2024-09-04 14:39:13",
"discount_end_date": "2024-09-11 14:39:13"
}
} |