Продажа заявок

Для отправки кредитной заявки в систему Ninja Lender необходимо выполнить следующее:

1. Авторизироваться в системе и получить токен, который будет использоваться во всех последующих запросах.

2. Получить справочники "Цель займа" и "Причина отказа", так как данные этих справочников используются при загрузке заявок в систему.

3. Получить тело шаблона на основе которого заявка будет заполняться реквизитами.

4. Составить заявку и отправить её в систему.

Пример: У нас есть кредитная заявка, где заёмщик запрашивает 10 000 на 30 дней для покупки бытовой техники, но мы не можем выдать заём из-за несоответствия возрастным ограничениям. Для начала, находим в справочнике нужную цель займа (в примере ниже это цель с "id":"2")

{
    "code": 0,
    "message": "ok",
    "data": [
        {
            "id": 1,
            "label": "health_care",
            "title": "Health care"
        },
        {
            "id": 2,
            "label": "other_purchases",
            "title": "Other purchases"
        },
        {
            "id": 3,
            "label": "debt_restructuring",
            "title": "Debt restructuring"
        }
    ],
    "log_key": 750
}

а также причину отказа (в примере ниже это причина с "id":"4")

{
    "code": 0,
    "message": "ok",
    "data": [
        {
            "id": 1,
            "label": "auto_scoring",
            "title": "Auto scoring"
        },
        {
            "id": 2,
            "label": "unstable_income",
            "title": "Unstable income"
        },
        {
            "id": 3,
            "label": "low_income",
            "title": "Low Income"
        },
        {
            "id": 4,
            "label": "age_criteria",
            "title": "Age criteria"
        }
    ],
    "log_key": 750
}

Дальше получаем тело шаблона

{
    "code": 0,
    "message": "ok",
    "data": {
        "body": {
            "age": {
                "id": "4",
                "kind": 2,
                "type": 0,
                "label": "age",
                "required": true,
                "variants": null,
                "description": null,
                "title": "Age"
            },
            "income": {
                "id": "5",
                "kind": 2,
                "type": 0,
                "label": "income",
                "required": true,
                "variants": null,
                "description": null,
                "title": "Income"
            },
            "marital_status": {
                "id": "14",
                "kind": 5,
                "type": 0,
                "label": "marital_status",
                "required": false,
                "variants": [
                    {
                        "label": "married",
                        "title": "married"
                    },
                    {
                        "label": "single",
                        "title": "single"
                    },
                    {
                        "label": "widowed",
                        "title": "widowed"
                    },
                    {
                        "label": "divorced",
                        "title": "divorced"
                    }
                ],
                "description": null,
                "title": "Marital status"
            }
            
        },
        "id": 20,
        "label": "1-8test",
        "description": null,
        "title": "1-8test"
    },
    "log_key": 757
}

И приступаем к составлению JSON для загрузки заявки. Для начала заполним сумму, минимальную сумму, срок, причину отказа, цель займа и в какой шаблон мы загружаем заявку

{
    "params": {
        "amount": "10000",
        "price_min": "10",
        "term": "864000",
        "refuse_reason": 4,
        "purpose": 2,
        "template": "4"
        "requisites": {
           
        },
        
    }
}

Теперь нам нужно заполнить реквизиты заявки исходя из тела шаблона. Каждый реквизит в теле описан JSON обьектом, где ключ обьекта – это название (ключ) реквизита, а в значениях выводится описание самого реквизита.

Пример реквизита из тела шаблона:

Ключ	Тип	Описание
id	int	идентификатор реквизита
kind	int	вид реквизита, определяет тип данных для значений реквизита: 0 – строка 1 – текст 2 – число 3 – дата 4 – булевое 5 – справочник (в случае с данным видом система будет ожидать в значении самого реквизита один из элементов из массива variants) 6 - телефон в международном формате 7 - валидный адресс электронной почты
label	string	название реквизита
required	boolean	является ли реквизит обязательным
variants	JSON.array	список вариантов для реквизитов вида "справочник"
description	string	описание реквизита
title	string	заголовок реквизита

{
    "params": {
        "amount": "10000",
        "price_min": "10",
        "term": "864000",
        "refuse_reason": 4,
        "purpose": 2,
        "template": "4"
        "requisites": {
           "age":"",
           "income":"",
           "marital_status":""
        },
        
    }
}

Заполняем реквизиты согласно их типам

{
    "params": {
        "amount": "10000",
        "price_min": "10",
        "term": "864000",
        "refuse_reason": 4,
        "purpose": 2,
        "template": "4"
        "requisites": {
           "age":"55",
           "income":"10000",
           "marital_status":"single"
        },
        
    }
}

Теперь JSON заявки готов и его можно загружать в систему.