Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.



Page Properties


Document status

Status
colourYellow
titleDRAFT

Area coveredFines and Fees, 3rd Party Integrations
Lead Author
Co-authors

Rick Dietz, Stanislaus

Brian Moore (Unlicensed), San Diego

Eva Sorrell (Unlicensed), San Bernardino

Suzanna Conrad (Unlicensed), Sacramento

Cecilia Huang, Pomona

Christian Ward, Sacramento


...

This policy applies to the implementation considerations and system configuration required for exchanging user fine/fee data with a campus bursar system. 

Three Possible Models

I.  CashNet SmartPay Portal 

Image Removed

Requirements:  Pay User Fines / Fees API, Export User Blocks, Users API, CashNet "SmartPay"

See:  Ex Libris Tech Blog:  Integrating Alma and PayPal with the Alma REST APIs

Through a CashNet portal, a payment type is set up through a campus' existing CashNet system, enabling users to login, view their balance of library fines, and make payments.    When the user logs into the portal, their username is sent to the Users API to retrieve fine amounts. The user pays the fines and fees through CashNet, and upon payment completion, information about the payment is generated and sent back to a script to be manipulated for import into Alma using the Pay User Fines / Fees API.  The fine is then logged as paid in Alma.

With this option, the only interaction with PeopleSoft would involve placing blocks / holds on the user's PeopleSoft record (for example, if the library places holds on student's registration for unpaid library fees).  Using the Export User Blocks integration with Alma, patrons with blocks such as registration holds can be exported and prepared for ingest to PeopleSoft.  We are still investigating removal of blocks, which may remain manual.  Could also use once-a-day Analytics data export to export fine amounts into PeopleSoft.

Issues/ Questions with this approach:

  • Removing Blocks/Holds in PeopleSoft remain manual; fine amount owed not available in PeopleSoft (necessarily) - if using Analytics API export, however, this could be available in PeopleSoft, once a day.
  • Need more information about CashNet portal setup (Christian Ward (Sacramento) is researching)
    • Info from Christian:  Requires CashNet add-on called "Smart Pay" used to build a "Storefront" web application.  Sacramento's parking services is using this type of integration with a third party parking tickets application that enables guests and campus users to pay citations through CashNet.   We may be able to work with CashNet to create an interface that all campuses could use but would need the CO to help with that.  It may be more efficient to straight into CashNet without using the unique account page, but that would be worked out with CashNet.  See Information re: Parking Fine Payment @ Sac State
  • Need to research any differences in approach for campuses using PayPal (e.g., Pomona) OR whether all CSUs using PayPal could move to CashNet for this integration.

II.  PeopleSoft Integration (San Marcos Approach)

Ian Chan (Unlicensed) at San Marcos is developing a solution that focuses on communication between Alma and PeopleSoft.  In this model, fines and fees data are generated through the Analytics API, as with the CashNet portal, and prepared for ingest into PeopleSoft.  San Marcos Campus IT is working on a script that checks user accounts periodically throughout  the day to check to see if payments have been made.  If a payment is made, that information is sent back to Alma through the Pay User Fines / Fees API.

Problems with this approach:

  • Analytics data only available once a day.  Ex Libris enhancement request:  Retrieve user accounts from Users API via fine amount?  See Idea Exchange Entry.

III.  Bursar Export

This is the native bursar export provided by Ex Libris.  With this option, fines and fees are closed in Alma.  This option is best if your library does not intend to restrict library use for balances owed, and does not wish to accept fines in the library.  If TOU restrict permissions based on fine balance owed, those restrictions would not take effect, as fine balances are closed out once they are exported to the bursar's office.

...

Current export of fines and fees information integration closes fines and fees in Alma.  Would like Ex Libris to provide an option to export fines and fees to third party system while keeping the fine information open and active in the user's account.Ex Libris should also enable the User API to be queried by user fine amount.  Relying on a once-daily acquisitions report to run information about fines and fees is limiting.

Implementation Considerations

...