Skip to content

Fines and Overdue Management

Fines and Overdue Management

Track overdue items, calculate fines, and collect penalties for late returns.

Time required: 2-5 minutes per fine

Overview

Fines are automatically calculated based on:

  • Days overdue
  • Library card type penalty rate
  • Per-day fine amount

Fine Calculation Formula

Fine = (Actual Return Days - Allowed Days) × Penalty Rate Per Day

Example:

  • Allowed duration: 14 days
  • Actual duration: 18 days
  • Penalty rate: $0.50/day
  • Fine: (18 - 14) × $0.50 = $2.00

Configure Fine Rates

Step 1: Set Up Card Type Penalties

  1. Go to LibraryConfigurationCard Types
  2. Edit a card type
  3. Set penalty fields:
FieldDescriptionExample
DurationAllowed checkout days14
Penalty Amount/DayFine per overdue day0.50
Allow MediaMax items allowed5

Process Late Return

Step 1: Return the Item

  1. Go to LibraryMedia Movements
  2. Find the issued item
  3. Click Return Media

Step 2: Review Calculated Fine

The system automatically:

  1. Calculates overdue days
  2. Applies penalty rate
  3. Shows fine amount
FieldValue
Return Date (Due)2024-10-15
Actual Return2024-10-20
Days Overdue5
Fine Amount$2.50

Step 3: Handle Fine

If fine exists:

  • Status = “Return” (awaiting payment)
  • Create Invoice button appears

If no fine:

  • Status = “Return Done”
  • Transaction complete

Create Fine Invoice

Step 1: Generate Invoice

  1. Open movement with pending fine
  2. Click Create Invoice button
  3. System creates account.move record

Step 2: Invoice Details

FieldValue
PartnerPatron (student/faculty)
TypeCustomer Invoice
AmountCalculated fine
ProductLibrary Fine Product

Step 3: Collect Payment

  1. Share invoice with patron
  2. Process payment
  3. Mark invoice as paid

Overdue Notifications

Automatic Email Alerts

The system sends automated emails:

AlertTimingPurpose
Pre-Due1 day beforeRemind to return
Overdue1 day afterNotify item is late

View Overdue Items

  1. Go to LibraryMedia Movements
  2. Filter by “Issued” status
  3. Sort by return_date
  4. Items past due date are overdue

Student Portal View (Enterprise)

Students see:

  • All their checkouts
  • Due dates
  • Penalty amount column
  • Status badges (red for fines due)

Field Reference

Media Movement (Fine Fields)

Technical FieldUI LabelTypeNotes
issued_dateIssued DateDateCheckout date
return_dateDue DateDateExpected return
actual_return_dateReturned OnDateActual return
penaltyFineFloatCalculated amount
invoice_idInvoiceMany2oneGenerated invoice
stateStatusSelectionMovement state

Library Card Type

Technical FieldUI LabelTypeNotes
durationDurationIntegerDays allowed
penalty_amt_per_dayFine/DayFloatDaily penalty
allow_mediaMax ItemsIntegerCheckout limit

Troubleshooting

Fine not calculating

Check:

  • Card type has penalty rate set
  • Actual return date is entered
  • Item was actually overdue

Cannot create invoice

Ensure:

  • Fine amount > 0
  • No existing invoice
  • Status is “Return”

Invoice button not visible

Verify:

  • You have manager permissions
  • Movement state = ‘return’
  • Penalty field has value

Related: Issue and Return Books | Manage Library Cards