Declared lost item: Display fees when declared lost with SET COST

CIRC-707 (BE - Declared lost item: Assign fees when declared lost w/ set cost) is the backend story for this front-end story. If there isn't any frontend work, this user story should be Closed as a Duplicate.

Declared lost item: Display fees when declared lost with set cost

Purpose: Assign fees to items when they are declared lost, based on the library's lost item fee policy for the item.

Story: As a staff member, I need to charge the patron for items they have lost, so that they can pay for the items and the library can replace them.

Attachment: UIU-1203.xlsx is a table representation of the Scenarios presented below. It may be an easier to develop the feature using the table.

Fee/Fine Records: The Scenarios provide the values for three of the Fee/Fine Record fields. The remainder of the fields should be set the same as other New Fee/Fine records except for Created At and Source. Created At should be set to the service point where item was reported lost. Source should be set to the name of staff member logged in.

Important Note: Fee/Fine Types "Lost item fee" and "Lost item processing fee" exist in the Manual Charges table (at Settings==>Users==>Fee/Fine: Manual Charges) with the new Manual/Automated Flag set to "automated." (See MODFEE-28, CIRC-656, MODFEE-30 and UIU-1490 for details; MODFEE-28 and CIRC-656 are scheduled for completion by March 6, 2020). The PO is not clear on why these entries need to be in the Manual Charges table or how they should be used. The "Overdue fine" Fee/Fine Type was added under the direction of Vega team member Oleksandr Kurash. Please contact him for for more information.

Scenarios

1. Scenario (Lost item fee not charged and lost item processing fee charged)
   • Given an open loan for a patron and item, and a lost item fee policy assigned to that combination of patron group, material type, location and loan type with the following aspects:
     • Charge amount for item: Set cost of 0
     • Lost item processing fee: some value A >0
     • Charge lost item processing fee if item declared lost by patron?: Yes
   • When the loan is declared lost
   • Then create the following fees/fines in accordance with the lost item fee policy:
     • Fee/Fine Record #1
       • Fee/fine owner: See DETERMINE THE FEE/FINE OWNER section below
       • Fee/fine type: Lost item processing fee
       • Fee/fine amount: value A
2. Scenario (Lost item fee charged and lost item processing fee charged)
   • Given an open loan for a patron and item, and a lost item fee policy assigned to that combination of patron group, material type, location and loan type with the following aspects:
     • Charge amount for item: Set cost of some value A > 0
     • Lost item processing fee: some value B > 0
     • Charge lost item processing fee if item declared lost by patron?: Yes
   • When the loan is declared lost
   • Then create the following fees/fines in accordance with the lost item fee policy:
     • Fee/Fine Record #1
       • Fee/fine owner: See DETERMINE THE FEE/FINE OWNER section below
       • Fee/fine type: Lost item fee
       • Fee/fine amount: value A
     • Fee/Fine Record #2
       • Fee/fine owner: See DETERMINE THE FEE/FINE OWNER section below
       • Fee/fine type: Lost item processing fee
       • Fee/fine amount: value B
3. Scenario (Lost item fee charged and lost item processing fee not charged)
   • Given an open loan for a patron and item, and a lost item fee policy assigned to that combination of patron group, material type, location and loan type with the following aspects:
     • Charge amount for item: Set cost of some value A > 0
     • Lost item processing fee: 0
     • Charge lost item processing fee if item declared lost by patron?: Yes
   • When the loan is declared lost
   • Then create the following fees/fines in accordance with the lost item fee policy:
     • Fee/Fine Record #1
       • Fee/fine owner: See DETERMINE THE FEE/FINE OWNER section below
       • Fee/fine type: Lost item fee
       • Fee/fine amount: value A
4. Scenario (Lost item fee charged and lost item processing fee not charged)
   • Given an open loan for a patron and item, and a lost item fee policy assigned to that combination of patron group, material type, location and loan type with the following aspects:
     • Charge amount for item: Set cost of some value A > 0
     • Lost item processing fee: any value
     • Charge lost item processing fee if item declared lost by patron?: No
   • When the loan is declared lost
   • Then create the following fees/fines in accordance with the lost item fee policy:
     • Fee/Fine Record #1
       • Fee/fine owner: See DETERMINE THE FEE/FINE OWNER section below
       • Fee/fine type: Lost item fee
       • Fee/fine amount: value A
5. From bohdan-suprun (added by cboerema from UIU-1597 which I have closed as a duplicate of this one)
   • • In order to display service point, where the item is declared lost, for a fee/fine action, UI need to pass the new servicePointId property to the declare-item-lost API request.
     • Value of the servicePointId property is the current service point chosen.
     • See API doc for more details: https://s3.amazonaws.com/foliodocs/api/mod-circulation/declare-item-lost.html#circulation_loans__id__declare_item_lost_post.

DETERMINE THE FEE/FINE OWNER

• Use the Barcode in the Loan Record to read the Item Record
• Use the Holdings Location: Permanent Location of the Item Record to find the Primary Service Point (Settings>Tenant>Service Points provides a list of Assigned Locations for each Service Point)
• Use the Primary Service Point to find the Fee/Fine Owner (Settings>Users>Fee/Fine: Owners provides a list of Associated Services Points for each Fee/Fine Owner)