5fd310b5eae51cf29c89dff8d9b4da28ab63ae4a
[working/Evergreen.git] / docs / circulation / circulation_patron_records.txt
1 Circulation - Patron Record 
2 ---------------------------
3
4 [[circulation_searching_patrons]] 
5 Searching Patrons 
6 ~~~~~~~~~~~~~~~~~
7
8 indexterm:[patrons, searching for]
9
10 To search for a patron, select the Patron Search option from the toolbar,
11 _Search -> Search for Patrons_ from the menu bar, or *F4*.
12
13 The Patron Search screen will display.  The orientation of the search pane may
14 be vertical or horizontal, depending on your library’s configuration.  It will
15 contain options to search on the following fields:
16
17 * Last Name 
18 * First Name 
19 * Middle Name 
20 * Alias 
21 * Address 1 
22 * Address 2 
23 * City 
24 * Zip 
25 * Phone
26 * Email 
27 * State 
28 * Barcode 
29 * OPAC Login ID
30
31 Use the options above the search fields to include patrons marked ``inactive''
32 in your search results or to limit results to patrons in a specific library
33 branch or in a specific permission group.
34
35 image::media/circulation_patron_records-1.png[circulation_patron_records 1]
36
37 .Tips for searching 
38 [TIP] 
39 =================== 
40 * Search one field or combine fields for more precise results.  
41 * Truncate search terms for more search results.
42 ===================
43
44 Once you have located the desired patron, highlight the entry for this patron in
45 the results screen.  A summary for this patron will display in place of the
46 search fields.  
47
48 image::media/circulation_patron_records-2.png[circulation_patron_records 2]
49
50 Use the _Retrieve Patron_ button to retrieve the patron for circulation or
51 editing.
52
53 image::media/circulation_patron_records-3.png[circulation_patron_records 3]
54
55 The _Search Form_ button may be used to resume searching for patrons.
56
57 Registering New Patrons 
58 ~~~~~~~~~~~~~~~~~~~~~~~
59
60 indexterm:[patrons, registering]
61
62 To register a new patron, select _Patron Registration_ from the toolbar,
63 _Circulation -> Register Patron_ from the menu bar, or *shift + F1*. The Patron
64 Registration form will display. 
65
66 image::media/circulation_patron_records-4.png[Patron registration form]
67
68 Mandatory fields display in yellow.
69
70 image::media/circulation_patron_records-5.png[circulation_patron_records 5]
71
72 The _Show Only Required Fields_ and _Show Suggested Fields_ may be used to limit
73 the options on this page.
74
75 image::media/circulation_patron_records-6.png[circulation_patron_records 6]
76
77 When one of these options is selected, it is possible switch to the other
78 limited view or to revert to the original view by selecting _Show All Fields_. 
79
80 image::media/circulation_patron_records-7.png[circulation_patron_records 7]
81
82 When finished entering the necessary information, select _Save_ to save the new
83 patron record or _Save & Clone_ to register a patron with the same address.
84 When _Save & Clone_ is selected, the address information is copied into the
85 resulting patron registration screen.  It is linked to the original patron.
86 Address information may only be edited through the original record.
87
88 image::media/circulation_patron_records-8.png[circulation_patron_records 8]
89
90 [TIP]
91 ============================================================================
92 * Requested fields may be configured in the _Library Settings Editor_ (_Admin ->
93  Local Admin -> Library Settings Editor_).  
94 * Statistical categories may be created for information tracked by your library 
95 that is not in the default patron record.  
96 * These may be configured in the _Statistical Categories Editor_ (_Admin -> 
97 Local Admin -> Statistical Categories Editor_).  
98 * Staff accounts may also function as patron accounts.
99 * You must select a _Main (Profile) Permission Group_ before the _Update Expire
100 Date_ button will work, since the permission group determines the expiration date.
101 ============================================================================
102
103
104 Patron Self-Registration
105 ~~~~~~~~~~~~~~~~~~~~~~~~
106 *Abstract*
107
108 Patron Self-Registration allows patrons to initiate registration for a library account through the OPAC.  Patrons can fill out a web-based form with basic information that will be stored as a “pending patron” in Evergreen.  Library staff can review pending patrons in the staff-client and use the pre-loaded account information to create a full patron account.  Pending patron accounts that are not approved within a configurable amount of time will be automatically deleted.  
109
110 *Patron Self-Registration*
111
112 . In the OPAC, click on the link to *Request Library Card*
113
114 . Fill out the self-registration form to request a library card, and click *Submit Registration*.
115
116 . Patrons will see a confirmation message: “Registration successful!  Please see library staff to complete your registration.”
117
118 image::media/patron_self_registration2.JPG[Patron Self-Registration form]
119
120 *Managing Pending Patrons*
121
122 . In the staff client select *Circulation* -> *Pending Patrons*.
123
124 . Select the patron you would like to review.  In this screen you have the option to *Delete* a pending patron account or *Load* the pending patron information to create a permanent library account.
125
126 . To create a permanent library account for the patron, click on the patron’s row, right-click and select *Load Patron* or click on the *Load Patron* button at the top of the screen.  This will load the patron self-registration information into the main *Patron Registration* form. 
127
128 . Fill in the necessary patron information for your library, and click *Save* to create the permanent patron account.
129
130
131
132 *Library Settings*
133
134 Three new Library Settings have been created to manage patron self-registration:
135
136 * *OPAC: Allow Patron Self-Registration* must be set to ‘True’ to enable use of this feature.
137
138 * *OPAC: Patron Self-Reg. Expire Interval* allows each library to set the amount of time after which pending patron accounts should be deleted.
139
140 * *OPAC: Patron Self-Reg. Display Timeout* allows each library to set the amount of time after which the patron self-registration screen will timeout in the OPAC.  The default is 5 minutes.
141
142 Several existing Library Settings can be used to determine if a field should be required or hidden in the self-registration form:
143
144 * *GUI: Require day_phone field on patron registration*
145
146 * *GUI: Show day_phone on patron registration*
147
148 * *GUI: Require dob (date of birth) field on patron registration*
149
150 * *GUI: Show dob field on patron registration*
151
152 * *GUI: Require email field on patron registration*
153
154 * *GUI: Show email field on patron registration*
155
156 * *GUI: Require State field on patron registration*
157
158 * *GUI: Show State field on patron registration*
159
160 * *GUI: Require county field on patron registration*
161
162 * *GUI: Show county field on patron registration*  [New Setting]
163
164 Several existing Library Settings can be used to verify values in certain fields and provide examples for data format on the registration form:
165
166 * *Global: Patron username format*
167
168 * *GUI: Regex for phone fields on patron registration* OR *GUI: Regex for day_phone field on patron registration*
169
170 * *GUI: Regex for email field on patron registration*
171
172 * *GUI: Regex for post_code field on patron registration*
173
174 * *GUI: Example for email field on patron registration*
175
176 * *GUI: Example for post_code field on patron registration*
177
178 * *GUI: Example for day_phone field on patron registration* OR *GUI: Example for phone fields on patron registration*
179
180
181
182 [[updating_patron_information]] 
183 Updating Patron Information
184 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
185
186 indexterm:[patrons, updating]
187
188 Retrieve the patron record as described in the section
189 <<circulation_searching_patrons,Searching Patrons>>.
190
191 Select _Edit_ from the options that display at the top of the patron record. 
192
193 image::media/circulation_patron_records-9.png[Patron edit with summary display]
194
195 Edit information as required.  When finished, select _Save_.  If you attempt to
196 close out of the patron account before the information is received, an alert
197 will display.
198
199 image::media/circulation_patron_records-10.png[circulation_patron_records 10]
200
201 Select _OK_ to continue or _Cancel_ to return to the editing form.
202
203 After selecting _Save_, the page will refresh.  The edited information will be
204 reflected in the patron summary pane.
205
206 [TIP]
207 =======
208 * You can resize the patron summary pane, or collapse and expand it using
209 the button on the right border of the pane.
210 * To quickly renew an expired patron, click the _Update Expire Date_ button.
211 You will need a _Main (Profile) Permission Group_ selected for this to work,
212 since the permission group determines the expiration date.
213 =======
214
215 Renewing Library Cards 
216 ~~~~~~~~~~~~~~~~~~~~~~
217
218 indexterm:[library cards, renewing]
219
220 Expired patron accounts display with a black box around the patron’s name, a
221 note that the patron is expired, and – when initially retrieved – an alert
222 stating that the ``Patron account is EXPIRED.''
223
224 image::media/circulation_patron_records-11.png[circulation_patron_records 11]
225
226 Open the patron record in edit mode as described in the section
227 <<updating_patron_information,Updating Patron Information>>.
228
229 Navigate to the information field labeled _Privilege Expiration Date_.  Enter a
230 new date in this box.  When you place your cursor in the _Patron Expiration Date
231 box_, a calendar widget will display to help you easily navigate to the desired
232 date. 
233
234 image::media/circulation_patron_records-12.png[circulation_patron_records 12]
235
236 Select the date using the calendar widget or key the date in manually.  Click
237 the _Save_ button.  The screen will refresh and the ``expired'' alerts on the
238 account will be removed. 
239
240 Lost Library Cards 
241 ~~~~~~~~~~~~~~~~~~
242
243 indexterm:[library cards, replacing]
244
245 Retrieve the patron record as described in the section
246 <<circulation_searching_patrons,Searching Patrons>>. 
247
248 Open the patron record in edit mode as described in the section
249 <<updating_patron_information,Updating Patron Information>>.
250  
251 Next to the _Barcode_ field, select the _Replace Barcode_ button.
252
253 image::media/circulation_patron_records-13.png[circulation_patron_records 13]
254
255 This will clear the barcode field.  Enter a new barcode and _Save_ the record.
256 The screen will refresh and the new barcode will display in the patron summary
257 pane.  
258
259 If a patron’s barcode is mistakenly replaced, the old barcode may be reinstated.
260 Retrieve the patron record as described in the section
261 <<circulation_searching_patrons,Searching Patrons>>. Open the patron record in
262 edit mode as described in the section <<updating_patron_information,Updating
263 Patron Information>>.
264
265 Select the _See All_ button next to the _Replace Barcode_ button.  This will
266 display the current and past barcodes associated with this account. 
267
268 image::media/circulation_patron_records-14.png[circulation_patron_records 14]
269
270 Check the box(es) for all barcodes that should be ``active'' for the patron.  An
271 ``active'' barcode may be used for circulation transactions.  A patron may have
272 more than one ``active'' barcode.  Only one barcode may be designated
273 ``primary.'' The ``primary'' barcode displays in the patron’s summary
274 information in the _Library Card_ field. 
275
276 Once you have modified the patron barcode(s), _Save_ the patron record.  If you
277 modified the ``primary'' barcode, the new primary barcode will display in the
278 patron summary screen. 
279
280 Resetting Patron's Password 
281 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
282
283 indexterm:[patrons, passwords]
284
285 A patron’s password may be reset from the OPAC or through the staff client.  To
286 reset the password from the staff client, retrieve the patron record as
287 described in the section <<circulation_searching_patrons,Searching Patrons>>. 
288
289 Open the patron record in edit mode as described in the section
290 <<updating_patron_information,Updating Patron Information>>.
291
292 Select the _Reset Password_ button next to the _Password_ field.  
293
294 image::media/circulation_patron_records-15.png[circulation_patron_records 15]
295
296 NOTE: The existing password is not displayed in patron records for security
297 reasons.
298
299 A new number will populate the _Password_ and _Verify Password_ text boxes.
300 Make note of the new password and _Save_ the patron record.  The screen will
301 refresh and the new password will be suppressed from view.   
302
303
304 [TIP]
305 =======================
306 If you need to change a patron or staff account password without using the staff client, here is how you can reset it with SQL.
307
308 Connect to your Evergreen database using _psql_ or similar tool, and retreive and verify your admin username:
309
310 [source, sql]
311 ------------------------------------------------------------------------------
312 psql -U <user-name> -h <hostname> -d <database>
313
314 SELECT id, usrname, passwd from actor.usr where usrname = 'admin';
315 ------------------------------------------------------------------------------
316
317 If you do not remember the username that you set, search for it in the _actor.usr_ table, and then reset the password.
318
319 [source, sql]
320 ------------------------------------------------------------------------------
321 UPDATE actor.usr SET passwd = <password> WHERE id=<id of row to be updated>;
322 ------------------------------------------------------------------------------
323
324 The new password will automatically be hashed. 
325
326 =======================
327
328 Barring a Patron 
329 ~~~~~~~~~~~~~~~~
330
331 indexterm:[patrons, barring]
332
333 A patron may be barred from circulation activities.  To bar a patron, retrieve
334 the patron record as described in the section
335 <<circulation_searching_patrons,Searching Patrons>>. 
336
337 Open the patron record in edit mode as described in the section 
338 <<updating_patron_information,Updating Patron Information>>.
339
340 Check the box for _Barred_ in the patron account. 
341
342 image::media/circulation_patron_records-16.png[circulation_patron_records 16]
343
344 _Save_ the user.  The screen will refresh.  
345
346 The patron account will now display an alert stating that the patron account 
347 is *BARRED*.  
348
349 Additionally a red box and note will indicate the patron’s barred status. 
350
351 image::media/circulation_patron_records-17.png[circulation_patron_records 17]
352
353 NOTE: Barring a patron from one library bars that patron from all consortium
354 member libraries. 
355
356 To unbar a patron, uncheck the Barred checkbox.
357
358 Barred vs. Blocked 
359 ~~~~~~~~~~~~~~~~~~
360
361 indexterm:[patrons, barring]
362
363 *Barred*: Stops patrons from using their library cards; alerts the staff that
364 the patron is banned/barred from the library. The ``check-out'' functionality is
365 disabled for barred patrons (NO option to override – the checkout window is
366 unusable and the bar must be removed from the account before the patron is able
367 to checkout items).  These patrons may still log in to the OPAC to view their
368 accounts.
369
370 indexterm:[patrons, blocking]
371
372 *Blocked*: Often, these are system-generated blocks on patron accounts.  
373
374 Some examples:
375
376 * Patron exceeds fine threshold 
377 * Patron exceeds max checked out item threshold
378
379 A notice appears when a staff person tries to checkout an item to blocked
380 patrons, but staff may be given permissions to override blocks.
381
382 Patron Alerts 
383 ~~~~~~~~~~~~~~
384
385 indexterm:[patrons, Alerts]
386     
387 When an account has an alert on it, a Stop sign is displayed when the record is
388 retrieved.
389
390 image::media/circulation_patron_records-18.png[circulation_patron_records 18]
391
392 Navigating to an area of the patron record using the navigation buttons at the
393 top of the record (for example, Edit or Bills) will clear the message from view.
394
395 If you wish to view these alerts after they are cleared from view, they may be
396 retrieved.  Use the Other menu to select _Display Alert_ and _Messages_.
397
398 image::media/circulation_patron_records-19.png[circulation_patron_records 19]
399
400 There are two types of Patron Alerts:
401
402 *System-generated alerts*: Once the cause is resolved (e.g. patron's account has
403 been renewed), the message will disappear automatically.
404
405 *Staff-generated alerts*: Must be added and removed manually. 
406
407 To add an alert to a patron account, retrieve the patron record as described 
408 in the section <<circulation_searching_patrons,Searching Patrons>>. 
409
410 Open the patron record in edit mode as described in the section 
411 <<updating_patron_information,Updating Patron Information>>.
412
413 Enter the alert text in the Alert Message field.
414
415 image::media/circulation_patron_records-20.png[circulation_patron_records 20]
416
417 _Save_ the record. The screen will refresh and the alert will display.
418
419 Additionally, the patron name will be highlighted in yellow and a note will
420 indicate that there is an alert on the account. 
421
422 image::media/circulation_patron_records-21.png[circulation_patron_records 21]
423
424 To remove the alert, retrieve the patron record as described in the section
425 <<circulation_searching_patrons,Searching Patrons>>. 
426
427 Open the patron record in edit mode as described in the section 
428 <<updating_patron_information,Updating Patron Information>>.
429
430 Delete the alert text in the _Alert Message_ field. 
431
432 _Save_ the record.  
433
434 The screen will refresh and the indicators for the alert will be removed from 
435 the account. 
436
437 Patron Notes 
438 ~~~~~~~~~~~~
439
440 indexterm:[patrons, notes]
441
442 When a patron account contains a note, a _See Notes_ message appears beneath the
443 patron’s name in the patron summary pane. 
444
445 image::media/circulation_patron_records-22.png[circulation_patron_records 22]
446
447 Notes are strictly communicative and may be made visible to the patron via their
448 account on the OPAC.  In the JSPAC, these notes display on the account summary
449 screen in the OPAC.
450
451 image::media/circulation_patron_records-23.png[circulation_patron_records 23]
452
453 To insert or remove a note, retrieve the patron record as described in the
454 section  <<circulation_searching_patrons,Searching Patrons>>. 
455
456 Open the patron record in edit mode as described in the section
457 <<updating_patron_information,Updating Patron Information>>.
458
459 Use the Other menu to navigate to _Notes_.
460
461 image::media/circulation_patron_records-24.png[circulation_patron_records 24]
462
463 Select the _Add New Note_ button. An _Add Note_ window displays.  
464
465 [TIP] 
466 ================================================ 
467 To add a box in the _Add Note_ window for staff initials and require their entry, see the section <<settings_for_staff_initials,Granular Settings for Staff Initials>>.
468 ================================================ 
469
470 Enter note information. 
471
472 Select the check box for _Patron Visible_ to display the note in the OPAC. 
473
474 image::media/circulation_patron_records-25.png[circulation_patron_records 25]
475
476 Select _Add Note_ to save the note to the patron account.  
477
478 To delete a note, go to _Other -> Notes_ and use the _Delete This Note_ button
479 under each note.
480
481 image::media/circulation_patron_records-26.png[circulation_patron_records 26]
482
483 An alert will display.  Click _Yes_ to delete the note or No to retain the note.
484 A confirmation box will display; click _OK_.
485
486 Merging Patron Records 
487 ~~~~~~~~~~~~~~~~~~~~~~
488
489 indexterm:[patrons, merging]
490
491 When patron records are erroneously duplicated, they may be merged into one
492 record.  As described in the section <<circulation_searching_patrons,Searching
493 Patrons>>, search for the term(s) shared by the two records. 
494
495 Select the two records to merge by pressing down the CTRL key and clicking each
496 record. 
497
498 Click the _Merge Patrons_ button next to the _Search Form_ and _Retrieve Patron_
499 buttons on the top of the screen.
500
501 image::media/circulation_patron_records-27.png[circulation_patron_records 27]
502
503 A Record Merging window will display.  Compare the two records.  
504
505 Select the record you want to keep by checking the radio button 
506 _Lead Record_ next to the appropriate record. 
507
508 image::media/circulation_patron_records-28.png[circulation_patron_records 28]
509
510 After making your selection, click the _Merge_ button.  The screen will refresh.
511 Only one of the two patron names will display.
512
513 NOTE: Once two records have been merged, the notes, bills, holds and outstanding
514 items under the non-lead record are brought to the lead record. Staff-inserted
515 alert messages are not transferred from the non-lead record; lead record alerts
516 are retained.
517
518 Patron records may also be merged from the _Patron Group_ screen Retrieve one of
519 the two patron records you want to merge.  
520
521 Go to _Other -> Group Member Details_.
522
523 image::media/circulation_patron_records-29.png[circulation_patron_records 29]
524
525 The patron records are displayed as group members. If both patron records are
526 not already displayed on this screen, click _Choose an Action -> Move another
527 patron to this patron group_.
528
529 image::media/circulation_patron_records-30.png[circulation_patron_records 30]
530
531 At the prompt, scan or type the patron's barcode. 
532  
533 Click _OK_. 
534
535 Confirm the move by clicking the _Move_ button on top of the screen. 
536
537 image::media/circulation_patron_records-31.png[circulation_patron_records 31]
538
539 Click _OK_ on the confirmation pop-up window.
540
541 Both records are displayed as group members. 
542
543 Select both records by pressing *CTRL* key and clicking each record. 
544
545 Click _Choose an Action -> Merge Selected Patrons_. The merging records window
546 pops up. 
547
548 Choose the lead record and continue to merge records as described in the above.
549
550 NOTE: The merged record will still show under group members. Both members point
551 to the same patron record.
552
553 [[bills_and_payments]] 
554 Bills and Payments 
555 ~~~~~~~~~~~~~~~~~~
556
557 When a patron account has bills attached to it, a note displays under the patron
558 name in the patron summary panel.  
559
560 image::media/circulation_patron_bills-1.png[circulation_patron_bills 1]
561
562 To view more information about the patron’s bills, or to make payments on or
563 edit the bills, click on the Bills button from the patron account screen. 
564
565 image::media/circulation_patron_bills-2.png[circulation_patron_bills 2]
566
567 [[circ_vs_grocery]] 
568 *Circulation bills*: system-generated (overdue fines, lost
569 item cost, processing fees, etc.).
570
571 * Overdue fines are added daily once an item is overdue.  When an item is marked
572 * as lost, bills may be automatically generated to cover the item's cost and a
573 * processing fee, according to library policy.
574
575 *Grocery bills*: staff-applied to patron accounts.
576
577 * One default grocery bill, Misc, exists in an unmodified Evergreen
578 * installation.  Additional grocery bills may be configured through the Admin
579 * settings.  Admin -> Server Administration -> Billing Types.
580
581 To view more information about a bill, highlight the bill and right-click or use
582 the _Actions for Selected Transactions_ menu to select _Full Details_.
583
584 image::media/circulation_patron_bills-3.png[circulation_patron_bills 3]
585
586 A window will display additional information about the bill, including a record
587 of any payments that have been made on the bill.
588
589 image::media/circulation_patron_bills-4.png[circulation_patron_bills 4] 
590
591 From the _Full Details_ screen, portions of the bill may be voided (e.g. an
592 erroneous daily overdue charge) by using the _Void selected billings_ button.
593 Notes may be added to payments or line items by using the _Edit note_ button.
594
595 image::media/circulation_patron_bills-5.png[circulation_patron_bills 5]
596
597 [[making_payments]] 
598 Making Payments 
599 ^^^^^^^^^^^^^^^
600
601 To collect payments, retrieve the patron record.  Navigate to the _Bills_ screen
602 as described in <<bills_and_payments,Bills and Payments>>.
603
604 When bills are paid, the money applied starts at the top of the list of bills.
605 To pay specific bills, uncheck the bills that you do not wish to pay at this
606 time. The amount displayed in _Total Checked:_ will change to reflect the
607 appropriate amount.
608
609 image::media/circulation_patron_bills-6.png[circulation_patron_bills 6]
610
611 NOTE: the presence of the _Uncheck All_ and _Check All_ options below the list
612 of bills.
613
614 image::media/circulation_patron_bills-7.png[circulation_patron_bills 7]
615
616 When you are ready to make a payment, select a payment type from the dropdown
617 menu in the _Pay Bill_ portion of the screen.
618
619 image::media/circulation_patron_bills-8.png[circulation_patron_bills 8]
620
621 Enter the amount of payment in the _Payment received_ field.  
622
623 If you would like to add a note to the payment, check the box for 
624 _Annotate Payment_.  
625
626 Click _Apply Payment!_ to make the payment.  
627
628 If you have selected _Annotate Payment_, a box will display for the annotation.  
629
630 The screen will refresh to display the updated bill information for the patron.
631 If change is due, the bottom portion of the screen, _Change Due Upon Payment:_
632 will briefly reflect the amount due to the patron.  
633
634 TIP: if you need more time to review the amount due, click outside the _Payment
635 Received_ box before selecting _Apply Payment!_ This will cause the screen to
636 refresh and display the amount due.
637
638 It is possible to convert change due to a patron credit by selecting the
639 _Convert Change to Patron Credit_ checkbox.
640
641 image::media/circulation_patron_bills-9.png[circulation_patron_bills 9]
642
643 [TIP] 
644 ================================================ 
645 * Items marked with red are still checked out. It is possible for a patron to
646 * pay a bill while the item is still out and accruing fines.  When Check is
647 * selected as the payment type, it is not necessary to select _Annotate
648 * Payment_, as a box for the check number and a note displays automatically.
649 ================================================
650
651 Void vs. Forgive 
652 ^^^^^^^^^^^^^^^^
653  
654 Void clears all history of the bill, while forgive retains the history. 
655
656 Forgiving Bills 
657 ^^^^^^^^^^^^^^^
658  
659 Choose forgive as the payment type as described in the section
660 <<making_payments,Making Payments>>. 
661
662 Enter the amount to be forgiven.  Choose _Annotate Payment_ as required by local
663 policy.
664
665 Apply Payment.  Annotate, if prompted.
666
667 The screen will refresh to display the payment.
668
669
670 Voiding Bills 
671 ^^^^^^^^^^^^^
672
673 Bills under one transaction are grouped in one bill line. Bills may be voided in
674 part or in whole.
675
676 *To void the full billing amount:* 
677
678 Select the bill(s) to be voided from the list in the patron account.  
679
680 Right click or use the _Actions for Selected Transactions_ menu to select _Void
681 All Billings_.
682
683 image::media/circulation_patron_bills-10.png[circulation_patron_bills 10]
684
685 Confirm the action.
686
687 *To void a partial amount:*
688
689 Select a billing and choose Full Details for the transaction, as described in
690 the section <circ_vs_grocery,Circulation vs. Grocery Bills>>
691
692 The bill details screen displays.
693
694 Select the specific bill to void.
695
696 Void Selected Billings and confirm the action.
697
698 image::media/circulation_patron_bills-11.png[circulation_patron_bills 11]
699
700 Adding New ``Grocery'' Bills 
701 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
702
703 A grocery bill can be added as a new bill or to an existing bill.
704
705 *To add a as a new bill:*
706
707 . Retrieve the patron record.  
708 . Navigate to the Bills screen.  
709 . Click the_Bill Patron_ button above the list of current bills.  
710 +
711 image::media/circulation_patron_bills-12.png[circulation_patron_bills 12] 
712
713 .Choose appropriate _Billing Type_ from the drop down menu. (``Grocery'' is the
714 only available transaction type.) . Enter the Amount and Note (as required).  
715 .
716 _Submit this Bill_ and confirm this action.
717
718 image::media/circulation_patron_bills-13.png[circulation_patron_bills 13]
719
720 *To add bill to an existing bill line:*
721
722 . Retrieve the patron record.  
723 . Navigate to the Bills screen.  
724 . Highlight the desired bill.  
725 . Use the _Actions for Selected Transactions_ to select _Add Billing_.  
726 Confirm this action.  
727 . Follow steps 4 through 6 above.  There is no confirmation message 
728 after clicking _Submit this Bill_.  
729 . The _Money Summary_ will adjust accordingly.
730
731 Bill History 
732 ^^^^^^^^^^^^
733
734 *To view a patron’s bill history:*
735
736 . Retrieve the patron record.  
737 . From the _Bills_ screen, click _History_.  
738 . A _Bill History_ screen with two tabs will display.  One for _Transactions_ and
739 one for _Payments_.  
740 +
741 image::media/circulation_patron_bills-14.png[circulation_patron_bills 14] 
742
743 . For more information about a specific billing, select the bill and click _Full
744 Details_. A screen detailing item information, billings, and payments will
745 display.
746
747 image::media/circulation_patron_bills-15.png[circulation_patron_bills 15]
748
749 Items may be deleted from the catalog even if a charge for that item is still
750 attached to the patron's record.  The charge will remain on the patron's account
751 after the deletion.
752
753 Sorting Money Columns in Billing Interface
754 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
755
756 This enhancement enables Evergreen to sort money columns numerically in the billing interface.  You can perform an ascending or descending sort on these columns.
757
758 To view and sort patron bills, retrieve the patron's account, and click the *Bills* tab in the top right corner of the screen.  You can view the money that is owed or paid in the "Total Billed" and *Total Paid* columns. Simply click on the headers of these columns to sort the columns numerically.
759
760 Disable Patron Credit in Billing Interface
761 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
762 The Library Setting, *Disable Patron Credit*, allows staff to disable the Patron Credit payment type and to hide patron credit payment actions within the billing interface of a patron’s account. 
763
764 By default, the payment type *Patron Credit* is enabled in the staff client. Within the Bills interface of a patron’s account, the Patron Credit payment type, the Credit Available, and the option to Convert Change to Patron Credit are exposed by default in the staff client. 
765
766 image::media/Default_Patron_Billing_Screen.jpg[Default Patron Billing Screen]
767
768 When the Library Setting, *Disable Patron Credit*, is set to *True*, the patron credit payment type will be disabled. Patron Credit will not be an option within the payment type dropdown menu. The Convert Change to Patron Credit and the summary of Credit Available will be hidden from the patron billing interface in the staff client. 
769
770 image::media/Disabled_Patron_Credit_Patron_Billing_Screen.jpg[Disabled Patron Credit Patron Billing Screen]
771
772 To set the new Library Setting:
773
774 . Click *Admin* -> *Local Administration* -> *Library Settings Editor*
775
776 . Search for *Disable Patron Credit*
777
778 . Click *Edit*
779
780 . Set the value to *True*
781
782 . Click *Update Setting*
783
784 image::media/Disable_Patron_Credit_Library_Setting.jpg[Disable Patron Credit Library Setting]
785
786 NOTE: After applying changes to this library setting, it is necessary to restart the staff client to see the changes take effect.  
787
788
789 Lost and Long Overdue Bill Colors
790 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
791
792 This stylization enhancement distinguishes Lost and Long Overdue circulations that appear within the billed transactions of a patron’s account from other items that are still checked out.  
793
794 Within the patron’s list of billed transactions, Lost or Long Overdue items, which have not yet been returned, display differently from other items that are still checked out. The color distinctions are applied to the entire row of the billed transaction (previous to version 2.5, only the title of the billed transaction was highlighted). These color enhancements are accompanied by helpful indicators that define the meaning of the colors for staff.  
795
796 By default, Lost circulations will appear in dark red. The default indicator reads, “Dark Red Items are Lost.”  
797
798 When the 6 Month Overdue Mark Long-Overdue trigger event definition is enabled, Long Overdue circulations will appear in orange, by default. The default indicator reads, “Orange Items are Long Overdue.”  
799  
800 image::media/Billed_Transaction_Color.JPG[Billed Transaction Color]
801  
802 Both the color distinctions and indicators are customizable. To customize, a change to circ.css (for the color) and lang.dtd (for the indicator) are required.   
803