Koha/C4/SIP/ILS/Transaction/Checkout.pm
Kyle M Hall 643e38e835
Bug 34153: (QA follow-up) Tidy code
Signed-off-by: Victor Grousset/tuxayo <victor@tuxayo.net>
Rebased-by: Victor Grousset/tuxayo <victor@tuxayo.net>
Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>
2023-10-04 16:40:19 -04:00

190 lines
6.8 KiB
Perl

#
# An object to handle checkout status
#
package C4::SIP::ILS::Transaction::Checkout;
use warnings;
use strict;
use POSIX qw(strftime);
use C4::SIP::Sip qw( siplog );
use Data::Dumper;
use CGI qw ( -utf8 );
use C4::SIP::ILS::Transaction;
use C4::Context;
use C4::Circulation qw( AddIssue GetIssuingCharges CanBookBeIssued ProcessOfflineIssue );
use C4::Members;
use Koha::DateUtils qw( dt_from_string );
use Koha::Items;
use parent qw(C4::SIP::ILS::Transaction);
# Most fields are handled by the Transaction superclass
my %fields = (
security_inhibit => 0,
due => undef,
renew_ok => 0,
);
sub new {
my $class = shift;;
my $self = $class->SUPER::new();
foreach my $element (keys %fields) {
$self->{_permitted}->{$element} = $fields{$element};
}
@{$self}{keys %fields} = values %fields;
return bless $self, $class;
}
sub do_checkout {
my $self = shift;
my $account = shift;
my $no_block_due_date = shift;
siplog( 'LOG_DEBUG', "ILS::Transaction::Checkout performing checkout..." );
my $shelf = $self->{item}->hold_attached;
my $barcode = $self->{item}->id;
my $patron = Koha::Patrons->find( $self->{patron}->{borrowernumber} );
my $overridden_duedate; # usually passed as undef to AddIssue
my $prevcheckout_block_checkout = $account->{prevcheckout_block_checkout};
my $allow_additional_materials_checkout = $account->{allow_additional_materials_checkout};
my ( $issuingimpossible, $needsconfirmation, $messages ) = _can_we_issue( $patron, $barcode, 0 );
if ( $no_block_due_date ) {
my $year = substr($no_block_due_date,0,4);
my $month = substr($no_block_due_date,4,2);
my $day = substr($no_block_due_date,6,2);
my $hour = substr($no_block_due_date,12,2);
my $minute = substr($no_block_due_date,14,2);
my $second = substr($no_block_due_date,16,2);
my $iso = "$year-$month-$day $hour:$minute:$second";
$no_block_due_date = dt_from_string( $iso, "iso" );
}
my $noerror=1; # If set to zero we block the issue
if ( keys %{$issuingimpossible} ) {
foreach ( keys %{$issuingimpossible} ) {
# do something here so we pass these errors
$self->screen_msg("Issue failed : $_");
$noerror = 0;
last;
}
} else {
foreach my $confirmation ( keys %{$needsconfirmation} ) {
if ( $confirmation eq 'RENEW_ISSUE' ) {
$self->screen_msg("Item already checked out to you: renewing item.");
} elsif ( $confirmation eq 'RESERVED' and !C4::Context->preference("AllowItemsOnHoldCheckoutSIP") ) {
$self->screen_msg("Item is reserved for another patron upon return.");
$noerror = 0;
} elsif ( $confirmation eq 'RESERVED' and C4::Context->preference("AllowItemsOnHoldCheckoutSIP") ) {
next;
} elsif ( $confirmation eq 'RESERVE_WAITING'
or $confirmation eq 'TRANSFERRED'
or $confirmation eq 'PROCESSING' )
{
$self->screen_msg("Item is on hold for another patron.");
$noerror = 0;
} elsif ( $confirmation eq 'ISSUED_TO_ANOTHER' ) {
$self->screen_msg("Item already checked out to another patron. Please return item for check-in.");
$noerror = 0;
last;
} elsif ( $confirmation eq 'DEBT' ) {
$self->screen_msg('Outstanding Fines block issue');
$noerror = 0;
last;
} elsif ( $confirmation eq 'HIGHHOLDS' ) {
$overridden_duedate = $needsconfirmation->{$confirmation}->{returndate};
$self->screen_msg('Loan period reduced for high-demand item');
} elsif ( $confirmation eq 'RENTALCHARGE' ) {
if ( $self->{fee_ack} ne 'Y' ) {
$noerror = 0;
last;
}
} elsif ( $confirmation eq 'PREVISSUE' ) {
$self->screen_msg("This item was previously checked out by you");
$noerror = 0 if ($prevcheckout_block_checkout);
last;
} elsif ( $confirmation eq 'ADDITIONAL_MATERIALS' ) {
if ($allow_additional_materials_checkout) {
my $item = Koha::Items->find( { barcode => $barcode } );
$self->screen_msg( 'Item has additional materials: ' . $item->materials );
} else {
$self->screen_msg('Item must be checked out at a circulation desk');
$noerror = 0;
last;
}
} elsif ( $confirmation eq 'RECALLED' ) {
$self->screen_msg('Item has been recalled for another patron');
$noerror = 0;
last;
} else {
# We've been returned a case other than those above
$self->screen_msg("Item cannot be issued: $confirmation");
$noerror = 0;
siplog( 'LOG_DEBUG', "Blocking checkout Reason:$confirmation" );
last;
}
}
}
my $itemnumber = $self->{item}->{itemnumber};
my ($fee, undef) = GetIssuingCharges($itemnumber, $patron->borrowernumber);
if ( $fee > 0 ) {
$self->{sip_fee_type} = '06';
$self->{fee_amount} = sprintf '%.2f', $fee;
if ($self->{fee_ack} eq 'N' ) {
$noerror = 0;
}
}
if ( $noerror == 0 && !$no_block_due_date ) {
$self->ok(0);
return $self;
}
if ( $no_block_due_date ) {
$overridden_duedate = $no_block_due_date;
ProcessOfflineIssue({
cardnumber => $patron->cardnumber,
barcode => $barcode,
timestamp => $no_block_due_date,
});
} else {
# can issue
my $recall_id;
foreach ( keys %{$messages} ) {
if ( $_ eq "RECALLED" ) {
$recall_id = $messages->{RECALLED};
}
}
my $issue = AddIssue( $patron, $barcode, $overridden_duedate, 0, undef, undef, { recall_id => $recall_id } );
$self->{due} = $self->duedatefromissue( $issue, $itemnumber );
}
$self->ok(1);
return $self;
}
sub _can_we_issue {
my ( $patron, $barcode, $pref ) = @_;
my ( $issuingimpossible, $needsconfirmation, $alerts, $messages ) =
CanBookBeIssued( $patron, $barcode, undef, 0, $pref );
for my $href ( $issuingimpossible, $needsconfirmation ) {
# some data is returned using lc keys we only
foreach my $key ( keys %{$href} ) {
if ( $key =~ m/[^A-Z_]/ ) {
delete $href->{$key};
}
}
}
return ( $issuingimpossible, $needsconfirmation, $messages );
}
1;
__END__