250 lines
7.1 KiB
Perl
Executable file
250 lines
7.1 KiB
Perl
Executable file
package C4::Accounts; #assumes C4/Accounts
|
|
|
|
# This module uses the CDK modules, and crashes if called from a web script
|
|
# Hence the existence of Accounts2
|
|
#
|
|
# This module will be deprecated when we build a new curses/slang/character
|
|
# based interface.
|
|
|
|
# $Id$
|
|
|
|
# Copyright 2000-2002 Katipo Communications
|
|
#
|
|
# This file is part of Koha.
|
|
#
|
|
# Koha is free software; you can redistribute it and/or modify it under the
|
|
# terms of the GNU General Public License as published by the Free Software
|
|
# Foundation; either version 2 of the License, or (at your option) any later
|
|
# version.
|
|
#
|
|
# Koha is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
|
|
# A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License along with
|
|
# Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
|
|
# Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
use strict;
|
|
require Exporter;
|
|
use DBI;
|
|
use C4::Context;
|
|
use C4::Format;
|
|
use C4::Search;
|
|
use C4::Stats;
|
|
use C4::InterfaceCDK;
|
|
use C4::Interface::AccountsCDK;
|
|
use vars qw($VERSION @ISA @EXPORT);
|
|
|
|
# set the version for version checking
|
|
$VERSION = 0.01;
|
|
|
|
=head1 NAME
|
|
|
|
C4::Accounts - Functions for dealing with Koha accounts
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
use C4::Accounts;
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The functions in this module deal with the monetary aspect of Koha,
|
|
including looking up and modifying the amount of money owed by a
|
|
patron.
|
|
|
|
=head1 FUNCTIONS
|
|
|
|
=over 2
|
|
|
|
=cut
|
|
|
|
@ISA = qw(Exporter);
|
|
@EXPORT = qw(&checkaccount &reconcileaccount &getnextacctno);
|
|
|
|
=item checkaccount
|
|
|
|
$owed = &checkaccount($env, $borrowernumber, $dbh);
|
|
|
|
Looks up the total amount of money owed by a borrower (fines, etc.).
|
|
|
|
C<$borrowernumber> specifies the borrower to look up.
|
|
|
|
C<$dbh> is a DBI::db handle for the Koha database.
|
|
|
|
C<$env> is ignored.
|
|
|
|
=cut
|
|
#'
|
|
sub checkaccount {
|
|
#take borrower number
|
|
#check accounts and list amounts owing
|
|
my ($env,$bornumber,$dbh)=@_;
|
|
my $sth=$dbh->prepare("Select sum(amountoutstanding) from accountlines where
|
|
borrowernumber=$bornumber and amountoutstanding<>0");
|
|
$sth->execute;
|
|
my $total=0;
|
|
while (my $data=$sth->fetchrow_hashref){
|
|
$total += $data->{'sum(amountoutstanding)'};
|
|
}
|
|
$sth->finish;
|
|
# output(1,2,"borrower owes $total");
|
|
#if ($total > 0){
|
|
# # output(1,2,"borrower owes $total");
|
|
# if ($total > 5){
|
|
# reconcileaccount($env,$dbh,$bornumber,$total);
|
|
# }
|
|
#}
|
|
# pause();
|
|
return($total);
|
|
}
|
|
|
|
# XXX - POD. Need to figure out C4/Interface/AccountsCDK.pm first,
|
|
# though
|
|
# FIXME - It looks as though this function really wants to be part of
|
|
# a curses-based script.
|
|
sub reconcileaccount {
|
|
#print put money owing give person opportunity to pay it off
|
|
my ($env,$dummy,$bornumber,$total)=@_;
|
|
my $dbh = C4::Context->dbh;
|
|
#get borrower record
|
|
my $sth=$dbh->prepare("select * from borrowers
|
|
where borrowernumber=$bornumber");
|
|
$sth->execute;
|
|
my $borrower=$sth->fetchrow_hashref;
|
|
$sth->finish();
|
|
#get borrower information
|
|
$sth=$dbh->prepare("Select * from accountlines where
|
|
borrowernumber=$bornumber and amountoutstanding<>0 order by date");
|
|
$sth->execute;
|
|
#display account information
|
|
&clearscreen();
|
|
#&helptext('F11 quits');
|
|
output(20,0,"Accounts");
|
|
my @accountlines;
|
|
my $row=4;
|
|
my $i=0;
|
|
my $text;
|
|
#output (1,2,"Account Info");
|
|
#output (1,3,"Item\tDate \tAmount\tDescription");
|
|
while (my $data=$sth->fetchrow_hashref){
|
|
my $line=$i+1;
|
|
my $amount=0+$data->{'amountoutstanding'};
|
|
my $itemdata = itemnodata($env,$dbh,$data->{'itemnumber'});
|
|
$line= $data->{'accountno'}." ".$data->{'date'}." ".$data->{'accounttype'}." ";
|
|
my $title = $itemdata->{'title'};
|
|
if (length($title) > 15 ) {$title = substr($title,0,15);}
|
|
$line .= $itemdata->{'barcode'}." $title ".$data->{'description'};
|
|
$line = fmtstr($env,$line,"L65")." ".fmtdec($env,$amount,"52");
|
|
push @accountlines,$line;
|
|
$i++;
|
|
}
|
|
#get amount paid and update database
|
|
my ($data,$reason)=
|
|
&accountsdialog($env,"Payment Entry",$borrower,\@accountlines,$total);
|
|
if ($data>0) {
|
|
&recordpayment($env,$bornumber,$dbh,$data);
|
|
#Check if the borrower still owes
|
|
$total=&checkaccount($env,$bornumber,$dbh);
|
|
}
|
|
return($total);
|
|
|
|
}
|
|
|
|
# FIXME - This function is never used. Then again, it's not exported,
|
|
# either.
|
|
sub recordpayment{
|
|
#here we update both the accountoffsets and the account lines
|
|
my ($env,$bornumber,$dbh,$data)=@_;
|
|
my $updquery = "";
|
|
my $newamtos = 0;
|
|
my $accdata = "";
|
|
my $amountleft = $data;
|
|
# begin transaction
|
|
# my $sth = $dbh->prepare("begin");
|
|
# $sth->execute;
|
|
my $nextaccntno = getnextacctno($env,$bornumber,$dbh);
|
|
# get lines with outstanding amounts to offset
|
|
my $query = "select * from accountlines
|
|
where (borrowernumber = '$bornumber') and (amountoutstanding<>0)
|
|
order by date";
|
|
my $sth = $dbh->prepare($query);
|
|
$sth->execute;
|
|
# offset transactions
|
|
while (($accdata=$sth->fetchrow_hashref) and ($amountleft>0)){
|
|
if ($accdata->{'amountoutstanding'} < $amountleft) {
|
|
$newamtos = 0;
|
|
$amountleft -= $accdata->{'amountoutstanding'};
|
|
} else {
|
|
$newamtos = $accdata->{'amountoutstanding'} - $amountleft;
|
|
$amountleft = 0;
|
|
}
|
|
my $thisacct = $accdata->{accountno};
|
|
$updquery = "update accountlines set amountoutstanding= '$newamtos'
|
|
where (borrowernumber = '$bornumber') and (accountno='$thisacct')";
|
|
my $usth = $dbh->prepare($updquery);
|
|
$usth->execute;
|
|
$usth->finish;
|
|
|
|
$updquery = "insert into accountoffsets
|
|
(borrowernumber, accountno, offsetaccount, offsetamount)
|
|
values ($bornumber,$accdata->{'accountno'},$nextaccntno,$newamtos)";
|
|
$usth = $dbh->prepare($updquery);
|
|
# print $updquery
|
|
$usth->execute;
|
|
$usth->finish;
|
|
}
|
|
# create new line
|
|
#$updquery = "insert into accountlines (borrowernumber,
|
|
#accountno,date,amount,description,accounttype,amountoutstanding) values
|
|
#($bornumber,$nextaccntno,datetime('now'::abstime),0-$data,'Payment,thanks',
|
|
#'Pay',0-$amountleft)";
|
|
$updquery = "insert into accountlines
|
|
(borrowernumber, accountno,date,amount,description,accounttype,amountoutstanding)
|
|
values ($bornumber,$nextaccntno,now(),0-$data,'Payment,thanks',
|
|
'Pay',0-$amountleft)";
|
|
$usth = $dbh->prepare($updquery);
|
|
$usth->execute;
|
|
$usth->finish;
|
|
UpdateStats($env,'branch','payment',$data)
|
|
}
|
|
|
|
=item getnextacctno
|
|
|
|
$nextacct = &getnextacctno($env, $borrowernumber, $dbh);
|
|
|
|
Returns the next unused account number for the patron with the given
|
|
borrower number.
|
|
|
|
C<$dbh> is a DBI::db handle to the Koha database.
|
|
|
|
C<$env> is ignored.
|
|
|
|
=cut
|
|
# FIXME - Okay, so what does the above actually _mean_?
|
|
sub getnextacctno {
|
|
my ($env,$bornumber,$dbh)=@_;
|
|
my $nextaccntno = 1;
|
|
|
|
my $query = "select max(accountno)+1 from accountlines";
|
|
my $sth = $dbh->prepare($query);
|
|
$sth->execute;
|
|
if (my $accdata=$sth->fetchrow_hashref){
|
|
$nextaccntno = $accdata->{'accountno'} + 1;
|
|
}
|
|
$sth->finish;
|
|
return$nextaccntno;
|
|
}
|
|
|
|
END { } # module clean-up code here (global destructor)
|
|
|
|
1;
|
|
__END__
|
|
|
|
=back
|
|
|
|
=head1 SEE ALSO
|
|
|
|
C4::Accounts2(3), DBI(3)
|
|
|
|
=cut
|