Skip to main content

Loan Action : Adhoc Receivable

POST Adhoc Receivable

This API facilitates the initiation of adhoc receivable requests within the SynoFin system. Users can create receivables associated with specific loan accounts by providing relevant details through the request body.

To make use of this API effectively, certain attributes fetched from the master need to be added to SynoFin Master either through the Admin panel or by contacting the Synoriq support team. Sample values are provided in the API documentation, which can be utilized for testing purposes.

To carry out a adhoc receivable, users must gather data for charges and other necessary information. This enables them to execute the adhoc receivable process effectively. Here is the method user can employ to retrieve the required data for adhoc receivable:

Retrieve Data for adhoc receivable

In order to retrieve information for Adhoc Receivable charges, users are required to utilize the SynoFin getDataForLoanAction API. This API facilitates the retrieval of all necessary information.

API Endpoint: {{base_url}}/loan-modification/v1/service-request/getDataForLoanActions

Run in Postman: Get Data for Loan Action

Request Body

{
    "loan_id": "123", //replace with actual loanId
    "request_id": "adhoc_receivable"
}

Response Body

{
    "response": true,
    "data": {
        "tax_amount": null,
        "effective_amount": null,
        "receivableDueDate": "2029-10-10",
        "receivable_charge": [
            {
                "key": "imd_income",
                "value": "IMD income",
                "is_tax_applicable": true
            }
        ]
    },
    "error": null
}



Another important API for Adhoc charges comes into play when the charge that is added is tax/GST applicable. This endpoint helps the user calculate the tax configured in the Synofin LMS system. If not configured, it can be added or reconfigured using the Synofin admin panel. Here is the method users can employ to calculate the taxed amount for adhoc receivables:

Calculate taxed amount for adhoc receivable

This API calculates the tax amount and total amount including tax for a given adhoc charge.

Note: All charges that are tax-applicable will be retrieved using the getDataForLoanAction with the key in the response as:

getDataForLoanAction Reference JSON 
{
    "response": true,
    "data": {
        "tax_amount": null,
        "effective_amount": null,
        "receivableDueDate": "2029-10-10",
        "receivable_charge": [
            {
                "key": "imd_income", //charge code that need to be passed in the request param
                "value": "IMD income",
                "is_tax_applicable": true //if tax/GST is applicable as configured in SynoFin Admin else by default false 
            }
        ]
    },
    "error": null
}



API Endpoint: {{base_url}}/loan-modification/v1/gst-calculation

Run in Postman: Get Data for Loan Action

Request Body

GET https://api-preprod.synofin.tech/lms/loan-modification/v1/gst-calculation?amount=10000&charge_code=repossession_charge

Response Body

{
    "response": true,
    "data": {
        "tax_amount": null,
        "effective_amount": null,
        "receivableDueDate": "2029-10-10",
        "receivable_charge": [
            {
                "key": "imd_income",
                "value": "IMD income",
                "is_tax_applicable": true
            }
        ]
    },
    "error": null
}
URL: {{base_url}}/loan-modification/v1/service-request/save
Run in Postman: Loan Foreclosure

Request: 

Request Type: POST
Authorization: Bearer Token

Back to top