Information in italics is intended to provide guidance while writing documentation and in general should be removed when a doc is at a v.1 stage.
The italics are suggestions to help guide what might go in a particular section. If you feel a section does not apply to the app or feature, please keep the section but just add that it does not apply.
If you feel it makes more sense for your documentation, you can move sections up and down.
Purpose
A Fee/fine owner is a FOLIO setting that represents the agent(s) or office(s) that manages fines for FOLIO transactions. Fee/fine owners collect fees/fines for FOLIO service points.
Libraries may name these in different ways, such as:
- Individual service points (essentially duplicating their service point infrastructure, if each service point manages their own fines)
- Library departments (e.g., "Undergraduate Library Business Services")
- Staff roles (e.g., "Business Library Finance Assistant")
Given that fee/fine owners are not directly connected to locations in configuration, it can be confusing to understand how fines accrue to an owner.
- When an item circulates, it does so through the FOLIO circulation rules. If a fine should be charged if the item is not returned on time, it would need to be included in the circulation rule as an overdue and/or lost item policy.
- The item that circulates has an effective location when it is loaned to the patron.
- The fine is charged / accrued based on the effective location of the item that is loaned, even if the location tree is not part of the circulation rule that was triggered, or the effective location is not where the item was borrowed from.
Conceptually, even though a service point is not located in the circulation rules, the fee/fine accrues back to the correct owner through the following logic:
- Item effective location → primary service point for the effective location → Fee/fine owner for that service point.
Permissions
One permission is applicable to this section:
- Settings (Users): Can create, edit and remove owners
UX/UI
When configuring fines, fee/fine owners must be defined first, before other settings.
- A fee/fine owner may be connected to one or more service points.
- A service point may be connected to one and only one fee/fine owner.
Available fields:
- Owner
- Required
- Will be the name that displays in FOLIO workflow
- Description
- Optional
- Only displays in this section of FOLIO (in default behavior)
- Associated Service Points
- Optional - but Fee/fine owners will not accrue fines unless Service Points are associated to them.
Searching
There is no search functionality built into this section of FOLIO.
Functional workflows
Describe available tasks that can be conducted in the app. To document those tasks, create a new page and link it to this page.
Describe action-based permissions that are connected to these functional workflows, if any.
To Modify a Fee/fine Owner
- From Settings → Users, open the list of Fee/fine Owners.
- Click on the Pencil icon under Actions for the Fee/fine Owner you wish to modify.
- Input Changes to the Fee/Fine Owner record.
- Click Save on the end of the row to save the change.
To create a Fee/fine Owner
- From Settings → Users, open the list of Fee/fine Owners.
- Click New in the Top Right.
- Type in a name for the Fee/fine Owner. The name must not already exist as a Fee/fine owner.
- Type in a Description (Optional).
- Associate the Fee/fine Owner to a specific service point or multiple service points (Optional).
- Click Save on the end of the row to save the new Fee/fine Owner.
To Delete a Fee/fine Owner
- From Settings → Users, open the list of Fee/fine Owners.
- Click on the Trash icon under Actions for the Fee/fine Owner you wish to delete.
- Click Delete to confirm deletion.
Reporting
Describe available in-app reports, including parameters for the reports, and associated permissions.
If there are developed LDP reports/queries for this app / area of FOLIO, describe those reports as well.
List any fields that may not be available in the LDP (e.g., for privacy reasons.)
There are no in-app reports in this section of FOLIO.
There is no personally identifying information in this area of FOLIO, unless a library chooses to include it.
Integrations
Describe any APIs that interact with the app. Provide links to the API / module information in Github.
Describe integrations that individual libraries may wish to develop for this app / area of FOLIO, if relevant.
If existing integrations have been developed by adopting libraries, provide links to the integration in Github or wherever the information can be found.
Describe and include any permanent links such as a link structure to records, searches, etc
Most libraries will want to use this setting as part of integrations with reporting and external payment systems (like the University Bursar, or PCI credit card payment sites.) The project intends to produce a global export file of fine information, but individual institutions would need to customize that export themselves, for their own requirements.
Considerations for Implementation
Describe decisions or implications that need to be considered when implementing this feature. Include topics such as order of operations during implementation or affects of implementing in a certain way.
- There is no requirement that Fee/fine owners be named in certain ways. However, libraries should consider opportunities to consolidate fee/fine processing, if appropriate to their institution.
- Libraries may also find it helpful to stick to the same conceptual idea when creating these - e.g., they are all service points, or all library departments - rather than mixing models.
- If a library is intending to be able to charge fees and fines, Fee/fine owners must be implemented first.
- Service points do not need to be implemented beforehand - however, fee/fine owners will not actually accrue any fines until service points are implemented and then associated to the fee/fine owners