Disbursements (Desembolsos)

The Disbursement screen is where a staged Loan Application transitions into a live loan. This is the step where cash is physically handed to the borrower — and where the system simultaneously creates the borrower's customer record and generates the full installment calendar.

Important: You can only disburse an application that is in In Progress status. Applications already disbursed or cancelled will not appear in the disbursement screen.

Before You Disburse

Disbursement requires write access. If your device is in Read-Only Mode (e.g., syncing restrictions are active), the operation will be blocked with an Error_ReadOnlyMode message. Contact your supervisor if this happens.

You must have a Loan Application already created in the Applications (Solicitudes) screen before proceeding.

Starting a Disbursement

1. Open the Applications (Solicitudes) list.
2. Tap the application you want to disburse.
3. Review the applicant's details and the credit terms.
4. Tap the Disburse (Desembolsar) button.

Disbursement Configuration

On the disbursement screen, confirm or adjust the following before finalizing:

Disbursement Date

• Set the exact calendar date on which the cash is being handed to the borrower.
• The system uses this date as the anchor for generating the full installment schedule (amortization table).

Late Payment Rate (Mora)

• Enter the percentage charged per month on overdue installments (e.g., 5%).
• The system internally converts this to a daily rate (monthly rate ÷ 30) and applies it per day an installment is past due.
• If set to 0, no late fees will be calculated.

What Happens on Confirm

When you tap Confirm Disbursement, the system executes all of the following steps inside a single database transaction:

1. Strategy Selection: The system identifies the loan product type from the staged application (e.g., flat-interest, gota-a-gota) and selects the appropriate calculation strategy.
2. Amortization Calculation: Based on the application's principal, interest rate, number of installments, and payment frequency, the system computes:
   • The exact installment amount (periodic payment).
   • The total amount to be repaid.
   • The complete payment calendar — one row per installment with its due date and amount.
3. Customer Record Created: A new customer profile is automatically generated from the applicant's data captured in the Loan Application (name, ID, phone, address, photo, etc.). You do not need to create the customer manually.
4. Loan Record Created: A Loan is saved with the code LN-XXXXXX, linked to the new customer, with status Active.
5. Installments Generated: Each payment slot in the amortization table is saved as an individual installment. If the disbursement date is backdated and some installments fall in the past, those are immediately flagged as overdue with their DaysOverdue and OverdueAmount calculated.
6. Application Closed: The original Loan Application status changes to Active (disbursed), removing it from the pending applications list.

If any step fails, the entire operation is rolled back — nothing is saved.

Installment Status After Disbursement

After Disbursement

Once confirmed, the app will:

• Navigate you to the new loan's detail screen.
• Prompt you to print a Disbursement Receipt via your paired Bluetooth printer to hand to the borrower (see Printing).