Fineract icon

Fineract

Interact with Fineract API to manage clients and loans
Join our community

Actions39

Overview

This node integrates with the Fineract API to manage loans and clients. Specifically, the Loan Disburse operation allows users to disburse funds for a specified loan by providing the loan ID, the actual disbursement date, and the transaction amount. This is useful in financial workflows where loan management automation is required, such as updating loan statuses after approval or triggering downstream accounting processes.

Practical examples:

  • Automatically disbursing a loan once it has been approved in an internal system.
  • Recording the exact date and amount of disbursement for audit and reporting purposes.
  • Integrating loan disbursement events into broader customer lifecycle management workflows.

Properties

Name Meaning
Loan ID The unique identifier of the loan to be disbursed.
Actual Disbursement Date The real date when the loan was disbursed, formatted as YYYY-MM-DD.
Transaction Amount The monetary amount that is being disbursed for the loan.

Output

The node outputs JSON data representing the response from the Fineract API after attempting the loan disbursement. This typically includes details about the updated loan status, confirmation of the disbursement, and any relevant metadata returned by the API.

If the API supports binary data (not indicated here), it would generally represent documents or receipts related to the disbursement, but this node primarily deals with JSON responses.

Dependencies

  • Requires connection to a Fineract instance via its REST API.
  • Needs an API key credential configured in n8n with:
    • Base URL of the Fineract server.
    • Tenant ID header value.
  • The node sends requests to the /fineract-provider/api/v1 endpoint with appropriate headers for authentication and content type.

Troubleshooting

  • Common issues:

    • Invalid or missing Loan ID will cause the API to reject the request.
    • Incorrect date format for the disbursement date may result in validation errors.
    • Insufficient permissions or incorrect API credentials can lead to authorization failures.
    • Network connectivity problems to the Fineract server.

  • Error messages:

    • "Loan not found" — Verify the Loan ID is correct and exists in the system.
    • "Invalid date format" — Ensure the Actual Disbursement Date is in YYYY-MM-DD format.
    • "Unauthorized" or "Forbidden" — Check API credentials and tenant ID configuration.
    • "Bad Request" — Review all input parameters for correctness.

Resolving these usually involves verifying input values, checking API credentials, and ensuring the Fineract server is reachable.

Links and References

Discussion