From e16ba0cb0a47f6486d32b8328e32a45935102215 Mon Sep 17 00:00:00 2001
From: tonnesen <tonnesen>
Date: Mon, 15 Jan 2001 19:31:41 +0000
Subject: [PATCH] API for circulation modules

---
 C4/Circulation/Circ2.pm | 467 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 467 insertions(+)
 create mode 100755 C4/Circulation/Circ2.pm

diff --git a/C4/Circulation/Circ2.pm b/C4/Circulation/Circ2.pm
new file mode 100755
index 0000000000..b6f63996d2
--- /dev/null
+++ b/C4/Circulation/Circ2.pm
@@ -0,0 +1,467 @@
+package C4::Circulation::Circ2; #assumes C4/Circulation/Returns
+
+#package to deal with Returns
+#written 3/11/99 by olwen@katipo.co.nz
+
+use strict;
+require Exporter;
+use DBI;
+use C4::Database;
+use C4::Accounts;
+use C4::InterfaceCDK;
+use C4::Circulation::Main;
+use C4::Format;
+use C4::Circulation::Renewals;
+use C4::Scan;
+use C4::Stats;
+use C4::Search;
+use C4::Print;
+
+use vars qw($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS);
+  
+# set the version for version checking
+$VERSION = 0.01;
+    
+@ISA = qw(Exporter);
+@EXPORT = qw(&getpatroninformation &currentissues &getiteminformation &findborrower &issuebook &returnbook);
+%EXPORT_TAGS = ( );     # eg: TAG => [ qw!name1 name2! ],
+		  
+# your exported package globals go here,
+# as well as any optionally exported functions
+
+@EXPORT_OK   = qw($Var1 %Hashit);
+
+
+# non-exported package globals go here
+#use vars qw(@more $stuff);
+	
+# initalize package globals, first exported ones
+
+my $Var1   = '';
+my %Hashit = ();
+		    
+# then the others (which are still accessible as $Some::Module::stuff)
+my $stuff  = '';
+my @more   = ();
+	
+# all file-scoped lexicals must be created before
+# the functions below that use them.
+		
+# file-private lexicals go here
+my $priv_var    = '';
+my %secret_hash = ();
+			    
+# here's a file-private function as a closure,
+# callable as &$priv_func;  it cannot be prototyped.
+my $priv_func = sub {
+  # stuff goes here.
+};
+						    
+# make all your functions, whether exported or not;
+
+sub getpatroninformation {
+    my ($env, $borrowernumber,$cardnumber) = @_;
+    my $dbh=&C4Connect;  
+    my $sth;
+    if ($borrowernumber) {
+	$sth=$dbh->prepare("select * from borrowers where borrowernumber=$borrowernumber");
+    } elsif ($cardnumber) {
+	$sth=$dbh->prepare("select * from borrowers where cardnumber=$cardnumber");
+    } else {
+	 # error condition.  This subroutine must be called with either a
+	 # borrowernumber or a card number.
+	$env->{'apierror'}="invalid borrower information passed to getpatroninformation subroutine";
+	 return();
+    }
+    $sth->execute;
+    my $borrower=$sth->fetchrow_hashref;
+    my $flags=patronflags($env, $borrower, $dbh);
+    $sth->finish;
+    $dbh->disconnect;
+    return($borrower, $flags);
+}
+
+sub patronflags {
+    my %flags;
+    my ($env,$patroninformation,$dbh) = @_;
+    my $amount = checkaccount($env,$patroninformation->{'borrowernumber'}, $dbh);
+    if ($amount>0) { 
+	my %flaginfo;
+	$flaginfo{'message'}='Patron owes $amount'; 
+	if ($amount>5) {
+	    $flaginfo{'noissues'}=1;
+	}
+	$flags{'CHARGES'}=\%flaginfo;
+    }
+    if ($patroninformation->{'gonenoaddress'} == 1) {
+	my %flaginfo;
+	$flaginfo{'message'}='Borrower has no valid address.'; 
+	$flaginfo{'noissues'}=1;
+	$flags{'GNA'}=\%flaginfo;
+    }
+    if ($patroninformation->{'lost'} == 1) {
+	my %flaginfo;
+	$flaginfo{'message'}='Borrower\'s card reported lost.'; 
+	$flaginfo{'noissues'}=1;
+	$flags{'LOST'}=\%flaginfo;
+    }
+    if ($patroninformation->{'borrowernotes'}) {
+	my %flaginfo;
+	$flaginfo{'message'}="Note: $patroninformation->{'borrowernotes'}";
+	$flags{'NOTES'}=\%flaginfo;
+    }
+    my ($odues) = checkoverdues($env,$patroninformation->{'borrowernumber'},$dbh);
+    if ($odues > 0) {
+	my %flaginfo;
+	$flaginfo{'message'}="Overdue Items";
+	$flags{'ODUES'}=\%flaginfo;
+    }
+    my ($nowaiting,$itemswaiting) = checkwaiting($env,$dbh,$patroninformation->{'borrowernumber'});
+    if ($nowaiting>0) {
+	my %flaginfo;
+	$flaginfo{'message'}="Reserved items available";
+	$flaginfo{'itemlist'}=$itemswaiting;
+	$flaginfo{'itemfields'}=['barcode', 'title', 'author', 'dewey', 'subclass', 'holdingbranch'];
+	$flags{'WAITING'}=\%flaginfo;
+    }
+
+    my $flag;
+    my $key;
+    return(\%flags);
+}
+
+
+
+sub currentissues {
+    my ($env, $borrower) = @_;
+    my $dbh=&C4Connect;
+    my %currentissues;
+    my $counter=1;
+    my $borrowernumber=$borrower->{'borrowernumber'};
+    my $sth=$dbh->prepare("select * from issues,items,biblio where borrowernumber=$borrowernumber and issues.itemnumber=items.itemnumber and items.biblionumber=biblio.biblionumber and returndate is null order by date_due");
+    $sth->execute;
+    while (my $data = $sth->fetchrow_hashref) {
+	my $datedue=$data->{'date_due'};
+	my $itemnumber=$data->{'itemnumber'};
+	my ($iteminformation) = getiteminformation($env, $itemnumber,0);
+	open O, ">>/root/tkcirc.out";
+	print O "Getting item info for $itemnumber $iteminformation->{'barcode'}.\n";
+	close O;
+	$iteminformation->{'datedue'}=$datedue;
+	$currentissues{$counter}=$iteminformation;
+	$counter++;
+    }
+    $sth->finish;
+    $dbh->disconnect;
+    return(\%currentissues);
+}
+
+sub getiteminformation {
+    my ($env, $itemnumber, $barcode) = @_;
+    my $dbh=&C4Connect;
+    my $sth;
+    if ($itemnumber) {
+	$sth=$dbh->prepare("select * from biblio,items,biblioitems where items.itemnumber=$itemnumber and biblio.biblionumber=items.biblionumber and biblioitems.biblioitemnumber = items.biblioitemnumber");
+    } elsif ($barcode) {
+	my $q_barcode=$dbh->quote($barcode);
+	$sth=$dbh->prepare("select * from biblio,items,biblioitems where items.barcode=$q_barcode and biblio.biblionumber=items.biblionumber and biblioitems.biblioitemnumber = items.biblioitemnumber");
+    } else {
+	$env->{'apierror'}="getiteminformation() subroutine must be called with either an itemnumber or a barcode";
+	# Error condition.  
+	return();
+    }
+    $sth->execute;
+    my $iteminformation=$sth->fetchrow_hashref;
+    $sth->finish;
+    $dbh->disconnect;
+    $iteminformation->{'dewey'}=~s/0*$//;
+    return($iteminformation);
+}
+
+sub findborrower {
+    my ($env, $key) = @_;
+    my $dbh=&C4Connect;
+    my @borrowers;
+    my $q_key=$dbh->quote($key);
+    my $sth=$dbh->prepare("select * from borrowers where cardnumber=$q_key");
+    $sth->execute;
+    if ($sth->rows) {
+	my ($borrower)=$sth->fetchrow_hashref;
+	push (@borrowers, $borrower);
+    } else {
+	$q_key=$dbh->quote("$key%");
+	$sth->finish;
+	$sth=$dbh->prepare("select * from borrowers where surname like $q_key");
+	$sth->execute;
+	while (my $borrower = $sth->fetchrow_hashref) {
+	    push (@borrowers, $borrower);
+	}
+    }
+    $sth->finish;
+    $dbh->disconnect;
+    return(\@borrowers);
+}
+
+sub currentborrower {
+    my ($env, $itemnumber, $dbh) = @_;
+    my $q_itemnumber=$dbh->quote($itemnumber);
+    my $sth=$dbh->prepare("select borrowers.borrowernumber from
+    issues,borrowers where issues.itemnumber=$q_itemnumber and
+    issues.borrowernumber=borrowers.borrowernumber and issues.returndate is
+    NULL");
+    $sth->execute;
+    my ($previousborrower)=$sth->fetchrow;
+    return($previousborrower);
+}
+
+
+sub checkreserve {
+  # Check for reserves for biblio 
+  my ($env,$dbh,$itemnum)=@_;
+  my $resbor = "";
+  my $query = "select * from reserves,items 
+    where (items.itemnumber = '$itemnum')
+    and (reserves.cancellationdate is NULL)
+    and (items.biblionumber = reserves.biblionumber)
+    and ((reserves.found = 'W')
+    or (reserves.found is null)) 
+    order by priority";
+  my $sth = $dbh->prepare($query);
+  $sth->execute();
+  my $resrec;
+  if (my $data=$sth->fetchrow_hashref) {
+    $resrec=$data;
+    my $const = $data->{'constrainttype'};
+    if ($const eq "a") {
+      $resbor = $data->{'borrowernumber'};
+    } else {
+      my $found = 0;
+      my $cquery = "select * from reserveconstraints,items 
+         where (borrowernumber='$data->{'borrowernumber'}') 
+         and reservedate='$data->{'reservedate'}'
+         and reserveconstraints.biblionumber='$data->{'biblionumber'}'
+         and (items.itemnumber=$itemnum and 
+         items.biblioitemnumber = reserveconstraints.biblioitemnumber)";
+      my $csth = $dbh->prepare($cquery);
+      $csth->execute;
+      if (my $cdata=$csth->fetchrow_hashref) {$found = 1;}
+      if ($const eq 'o') {
+        if ($found eq 1) {$resbor = $data->{'borrowernumber'};}
+      } else {
+        if ($found eq 0) {$resbor = $data->{'borrowernumber'};}
+      }
+      $csth->finish();
+    }
+  }
+  $sth->finish;
+  return ($resbor,$resrec);
+}
+
+
+sub issuebook {
+    my ($env, $patroninformation, $barcode, $responses) = @_;
+    my $dbh=&C4Connect;
+    my $iteminformation=getiteminformation($env, 0, $barcode);
+    my ($datedue);
+    my ($rejected,$question,$defaultanswer,$questionnumber, $noissue);
+    SWITCH: {
+	if ($iteminformation->{'notforloan'} == 1) {
+	    $rejected="Item not for loan.";
+	    last SWITCH;
+	}
+	if ($iteminformation->{'wthdrawn'} == 1) {
+	    $rejected="Item withdrawn.";
+	    last SWITCH;
+	}
+	if ($iteminformation->{'restricted'} == 1) {
+	    $rejected="Restricted item.";
+	    last SWITCH;
+	}
+	if ($iteminformation->{'itemtype'} eq 'REF') {
+	    $rejected="Reference item:  Not for loan.";
+	    last SWITCH;
+	}
+	my ($currentborrower) = currentborrower($env, $iteminformation->{'itemnumber'}, $dbh);
+	if ($currentborrower eq $patroninformation->{'borrowernumber'}) {
+# Already issued to current borrower
+	    my ($renewstatus) = renewstatus($env,$dbh,$patroninformation->{'borrowernumber'}, $iteminformation->{'itemnumber'});
+	    if ($renewstatus == 0) {
+		$rejected="No more renewals allowed for this item.";
+		last SWITCH;
+	    } else {
+		if ($responses->{4} eq '') {
+		    $questionnumber=4;
+		    $question="Book is issued to this borrower.\nRenew?";
+		    $defaultanswer='Y';
+		    last SWITCH;
+		} elsif ($responses->{4} eq 'Y') {
+		    renewbook($env,$dbh, $patroninformation->{'borrowernumber'}, $iteminformation->{'itemnumber'});
+		    $noissue=1;
+		} else {
+		    $rejected=-1;
+		    last SWITCH;
+		}
+	    }
+	} elsif ($currentborrower ne '') {
+	    my ($currborrower, $cbflags)=getpatroninformation($env,$currentborrower,0);
+	    if ($responses->{1} eq '') {
+		$questionnumber=1;
+		$question="Issued to $currborrower->{'firstname'} $currborrower->{'surname'} ($currborrower->{'cardnumber'}).\nMark as returned?";
+		$defaultanswer='Y';
+		last SWITCH;
+	    } elsif ($responses->{1} eq 'Y') {
+		returnbook($env,$iteminformation->{'barcode'});
+	    } else {
+		$rejected=-1;
+		last SWITCH;
+	    }
+	}
+
+	my ($resbor, $resrec) = checkreserve($env, $dbh, $iteminformation->{'itemnumber'});
+
+	if ($resbor eq $patroninformation->{'borrowernumber'}) {
+	     my $rquery = "update reserves set found = 'F' where reservedate = '$resrec->{'reservedate'}' and borrowernumber = '$resrec->{'borrowernumber'}' and biblionumber = '$resrec->{'biblionumber'}'";
+	     my $rsth = $dbh->prepare($rquery);
+	     $rsth->execute;
+	     $rsth->finish;
+	} elsif ($resbor ne "") {
+	    my $resborrower=getpatroninformation($env, $resbor,0);
+	    if ($responses->{2} eq '') {
+		$questionnumber=2;
+		$question="Reserved for $resborrower->{'firstname'} $resborrower->{'surname'} ($resborrower->{'cardnumber'}\nAllow issue?";
+		$defaultanswer='N';
+		last SWITCH;
+	    } elsif ($responses->{2} eq 'N') {
+		printreserve($env, $resrec, $resborrower, $iteminformation);
+		$rejected=-1;
+		last SWITCH;
+	    } else {
+		if ($responses->{3} eq '') {
+		    $questionnumber=3;
+		    $question="Cancel reserve for $resborrower->{'firstname'} $resborrower->{'surname'} ($resborrower->{'cardnumber'}?";
+		    $defaultanswer='N';
+		    last SWITCH;
+		} elsif ($responses->{3} eq 'Y') {
+		    my $rquery = "update reserves set found = 'F' where reservedate = '$resrec->{'reservedate'}' and borrowernumber = '$resrec->{'borrowernumber'}' and biblionumber = '$resrec->{'biblionumber'}'";
+		    my $rsth = $dbh->prepare($rquery);
+		    $rsth->execute;
+		    $rsth->finish;
+		}
+	    }
+	}
+    }
+    my $dateduef;
+    unless (($question) || ($rejected) || ($noissue)) {
+	my $loanlength=21;
+	if ($iteminformation->{'loanlength'}) {
+	    $loanlength=$iteminformation->{'loanlength'};
+	}
+	my $ti=time;
+	my $datedue=time+($loanlength)*86400;
+	my @datearr = localtime($datedue);
+	$dateduef = (1900+$datearr[5])."-".($datearr[4]+1)."-".$datearr[3];
+	my $sth=$dbh->prepare("insert into issues (borrowernumber, itemnumber, date_due, branchcode) values ($patroninformation->{'borrowernumber'}, $iteminformation->{'itemnumber'}, '$dateduef', '$env->{'branchcode'}')");
+	$sth->execute;
+	$sth->finish;
+	$iteminformation->{'issues'}++;
+	$sth=$dbh->prepare("update items set issues=$iteminformation->{'issues'} where itemnumber=$iteminformation->{'itemnumber'}");
+	$sth->execute;
+	$sth->finish;
+    }
+    $dbh->disconnect;
+    return ($iteminformation, $dateduef, $rejected, $question, $questionnumber, $defaultanswer);
+}
+
+
+sub updatelastseen {
+    my ($env,$dbh,$itemnumber)= @_;
+    my $br = $env->{'branchcode'};
+    my $query = "update items 
+    set datelastseen = now(), holdingbranch = '$br'
+    where (itemnumber = '$itemnumber')";
+    my $sth = $dbh->prepare($query);
+    $sth->execute;
+    $sth->finish;
+} 
+
+sub returnbook {
+    my ($env, $barcode) = @_;
+    my ($messages, $overduecharge);
+    my $dbh=&C4Connect;
+    my ($iteminformation) = getiteminformation($env, 0, $barcode);
+    my $borrower;
+    if ($iteminformation) {
+	my $sth=$dbh->prepare("select * from issues where (itemnumber='$iteminformation->{'itemnumber'}') and (returndate is null)");
+	$sth->execute;
+	my ($currentborrower) = currentborrower($env, $iteminformation->{'itemnumber'}, $dbh);
+	($borrower)=getpatroninformation($env,$currentborrower,0);
+
+	my @datearr = localtime(time);
+	my $dateret = (1900+$datearr[5])."-".$datearr[4]."-".$datearr[3];
+	my $query = "update issues set returndate = now(), branchcode ='$env->{'branchcode'}' where (borrowernumber = $borrower->{'borrowernumber'}) and (itemnumber = $iteminformation->{'itemnumber'}) and (returndate is null)";
+	my $sth = $dbh->prepare($query);
+	$sth->execute;
+	$sth->finish;
+	updatelastseen($env,$dbh,$iteminformation->{'itemnumber'});
+
+
+	# check for overdue fine
+
+	$overduecharge;
+	$sth=$dbh->prepare("select * from accountlines where (borrowernumber=$borrower->{'borrowernumber'}) and (itemnumber = $iteminformation->{'itemnumber'}) and (accounttype='FU' or accounttype='O')");
+	$sth->execute;
+	# alter fine to show that the book has been returned
+	if (my $data = $sth->fetchrow_hashref) {
+	    my $usth=$dbh->prepare("update accountlines set accounttype='F' where (borrowernumber=$borrower->{'borrowernumber'}) and (itemnumber=$iteminformation->{'itemnumber'}) and (acccountno='$data->{'accountno'}')");
+	    $usth->execute();
+	    $usth->finish();
+	    $overduecharge=$data->{'amountoutstanding'};
+	}
+	$sth->finish;
+	# check for charge made for lost book
+	$sth=$dbh->prepare("select * from accountlines where (borrowernumber=$borrower->{'borrowernumber'}) and (itemnumber = $iteminformation->{'itemnumber'}) and (accounttype='L')");
+	$sth->execute;
+	if (my $data = $sth->fetchrow_hashref) {
+	    # writeoff this amount
+	    my $offset;
+	    my $amount = $data->{'amount'};
+	    my $acctno = $data->{'accountno'};
+	    my $amountleft;
+	    if ($data->{'amountoutstanding'} == $amount) {
+		$offset = $data->{'amount'};
+		$amountleft = 0;
+	    } else {
+		$offset = $amount - $data->{'amountoutstanding'};
+		$amountleft = $data->{'amountoutstanding'} - $amount;
+	    }
+	    my $uquery = "update accountlines
+	      set accounttype = 'LR',amountoutstanding='0'
+	      where (borrowernumber = $borrower->{'borrowernumber'})
+	      and (itemnumber = $iteminformation->{'itemnumber'})
+	      and (accountno = '$acctno') ";
+	    my $usth = $dbh->prepare($uquery);
+	    $usth->execute();
+	    $usth->finish;
+	    my $nextaccntno = C4::Accounts::getnextacctno($env,$borrower->{'borrowernumber'},$dbh);
+	    $uquery = "insert into accountlines
+	      (borrowernumber,accountno,date,amount,description,accounttype,amountoutstanding)
+	      values ($borrower->{'borrowernumber'},$nextaccntno,now(),0-$amount,'Book Returned',
+	      'CR',$amountleft)";
+	    $usth = $dbh->prepare($uquery);
+	    $usth->execute;
+	    $usth->finish;
+	    $uquery = "insert into accountoffsets
+	      (borrowernumber, accountno, offsetaccount,  offsetamount)
+	      values ($borrower->{'borrowernumber'},$data->{'accountno'},$nextaccntno,$offset)";
+	    $usth = $dbh->prepare($uquery);
+	    $usth->execute;
+	    $usth->finish;
+	}
+	$sth->finish;
+    }
+    $dbh->disconnect;
+    UpdateStats($env,'branch','return','0','',$iteminformation->{'itemnumber'});
+    return ($iteminformation, $borrower, $messages, $overduecharge);
+}
+
+END { }       # module clean-up code here (global destructor)
-- 
2.39.5