Business Process Description: Creating a Client and Application with Automatic Lead Creation and Verification (DMS)
This guide is intended for third-party developers integrating with the BrainySoft API.
Goal: to demonstrate step-by-step how to programmatically create a client (individual), initiate a loan application, link a credit product, and submit the application for automatic verification, which will result in automatic lead creation from the saved application.
Process Overview
To complete the full business process, you need to sequentially call 5 API methods:
| Step | Method | URI | Description |
|---|---|---|---|
| 1 | GET | /bs-core/main/clients/init | Client initialization |
| 2 | POST | /bs-core/main/clients | Client creation |
| 3 | GET | /bs-core/main/loan-apps/init/client-id/{clientId} | Application initialization |
| 4 | POST | /bs-core/main/loan-apps/products/{creditProductId}/apply | Automatic addition of credit product to application |
| 5 | POST | /bs-core/main/loan-apps | Application creation |
Result: The following will be created in the system:
- Client (individual).
- Loan application.
- Lead (automatically after saving the application).
- Checks launched in the Decision Making System (DMS).
Important: This scenario uses only system-required fields, which minimizes the risk of errors and simplifies initial integration. The credit product "Basic Tariff" is used as an example.
Prerequisites
To execute the business process, you will need:
- Access to the BrainySoft API and valid credentials.
- Loan manager identifier from the "Loan Specialists" directory (managerId).
- Credit product identifier {creditProductId}.
- Subdivision identifier (subdivisionId).
- Branch identifier (branchId).