The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

koha-claim - Claim overdues each day, grouping same overdues

VERSION

version 0.072

SYNOPSIS

  koha-claim
  koha-claim --doit
  koha-claim --doit --to myself@tamil.fr

DESCRIPTION

This script creates claim notifications to borrowers for their overdues based on claim rules. Notification are inserted into Koha standard notification queue (message_queue table). They have then to be processed by process_message_queue.pl script. The notifications group overdues. So for example, if a borrower has 3 overdues, 1 for 10 days and 2 for 20 days, and if you have 2 rules, one for 10 days and another one for 20 days, 2 notifications (not 3, one for each overdue) will be prepared: the 20 days notification will group the 2 20 days overdues.

Rules are found in ClaimRules Koha system preference.

  # Branch itype days action notice
  # action => 1=email, 2=debarre
  *    *   15  1   REL1
  MAIN *   25  1   REL1
  *    BK  40  1   REL1
  *    *   55  1   REL1
  *    *   75  1   REL1
  *    *   85  1   REL4
  *    *   90  1   REL1

This script MUST be run every day. It matches overdues on a exact number of days of overdue.

Without --doit parameter, the notifications are sent to the terminal (stdout) rather than to the notification queue.

The notifications are entered in Koha in Tools > Notifications. Items information must be enclosed into <items> </items> tag. For example:

  Library <<branches.branchname>>
  <<branches.branchaddress1>>
  <<branches.branchzip>> <<branches.branchcity>>
  <<branches.branchphone>>
  
  Miss, Madam, Sir,
  
  This is overdue:
  
  <items>
    Title:       <<biblio.title>>
    Author:      <<biblio.author>>
    Call Number: <<items.itemcallnumber>>
    Borrowed at: <<item_branch>>
    Due date:    <<issues.date_due>>
    Type:        <<itemtypes.description>>
  </items>

AUTHOR

Frédéric Demians <f.demians@tamil.fr>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2023 by Fréderic Démians.

This is free software, licensed under:

  The GNU General Public License, Version 3, June 2007