SIP2 "Chargeable Loans"

[Jason Stephenson]

3M and likely other Self-check vendors support a mode called "chargeable loans." In this mode the ILS is able to report that a fee is required for the circulation transaction to complete to the SC. The SC then asks the patron if they accept the fee. If the patron accepts the fee, the SC tries the checkout again with the fee accepted field "BO" set to "Y".

I have been working on some code to implement this feature in Evergreen's SIP2 modules. It requires updates to Evergreen and to SIPServer in order to function properly.

I've only tested this with our own PHPSIP2 module, so it may not actually work as expected with an actual self-check. (I'm trying to get some consortium members to test it, but that is never as easy as it sounds.)

I'm posting this bug to call for anyone who'd like to try the code out and so that it doesn't get lost in the to and fro of other work.

You can get the SIPServer changes in the following branch:

git://git.evergreen-ils.org/working/SIPServer <email address hidden>/chargeable_loans
or at
git://git.mvlcstaff.org/jason/SIPServer chargeable_loans

The code necessary for Evergreen is at

git://git.evergreen-ils.org/working/Evergreen <email address hidden>/SIP2_chargeable_loans
or at
git://git.mvlcstaff.org/jason/ILS SIP2_chargeable_loans

Currently, the code does not conflict with the SIP23738 branch mentioned in another "bug," so you can test them independently of each other or at the same time.

[Jason Stephenson (jstephenson)]

I went ahead and added a backport branch for rel_2_1 for this code. It was a clean cherry-pick of the relevant bits from master and the SIP2_chargeable_loans branch:

git://git.evergreen-ils.org/working/Evergreen.git <email address hidden>/SIP2_chargeable_loans_rel_2_1

[Jason Stephenson (jstephenson)]

Something else that I forgot to mention in the details above:

If you are going to use this code and you have not already done so, you will need to add permissions for ITEM_RENTAL_FEE_REQUIRED.override and ITEM_DEPOSIT_FEE_REQUIRED.override and grant these to your SIP circulation group.

Without these permissions, the Evergreen circulation code will reject the checkout and not charge the fee.

[Jason Stephenson (jstephenson)]

Did some testing on a 3M self check this afternoon, and we will be using this in production starting next week.

[Jason Stephenson (jstephenson)]

I am told by the members who are using it that this feature "just works."

[Jason Stephenson (jstephenson)]

Steps to use this code:

First, get SIPServer:

git clone git://git.evergreen-ils.org/SIPServer.git
cd SIPServer
git remote add working git://git.evergreen-ils.org/working/SIPServer.git
git fetch working
git checkout -b chargeable_loans <email address hidden>/chargeable_loans
cd ..

Now, get Evergreen:
git clone git://git.evergreen-ils.org/Evergreen.git
cd Evergreen
git remote add working git://git.evergreen-ils.org/working/Evergreen.git
git fetch working
git checkout -b SIP2_chargeable_loan origin/master
git merge <email address hidden>/SIP2_chargeable_loans

Then, do the ./autogen.sh; configure; make ; make install dance.

[Bill Erickson (berick)]

Both branches merged to their relative master repositories.