1 package Koha::REST::V1::Patrons::Account;
3 # This file is part of Koha.
5 # Koha is free software; you can redistribute it and/or modify it
6 # under the terms of the GNU General Public License as published by
7 # the Free Software Foundation; either version 3 of the License, or
8 # (at your option) any later version.
10 # Koha is distributed in the hope that it will be useful, but
11 # WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 # GNU General Public License for more details.
15 # You should have received a copy of the GNU General Public License
16 # along with Koha; if not, see <http://www.gnu.org/licenses>.
20 use Mojo::Base 'Mojolicious::Controller';
24 use Try::Tiny qw( catch try );
28 Koha::REST::V1::Patrons::Account
36 Controller function that handles retrieving a patron's account balance
41 my $c = shift->openapi->valid_input or return;
43 my $patron_id = $c->validation->param('patron_id');
44 my $patron = Koha::Patrons->find($patron_id);
47 return $c->render( status => 404, openapi => { error => "Patron not found." } );
51 my $account = $patron->account;
53 # get outstanding debits and credits
54 my $debits = $account->outstanding_debits;
55 my $credits = $account->outstanding_credits;
60 balance => $account->balance,
61 outstanding_debits => {
62 total => $debits->total_outstanding,
63 lines => $debits->to_api
65 outstanding_credits => {
66 total => $credits->total_outstanding,
67 lines => $credits->to_api
73 $c->unhandled_exception($_);
79 Controller function that handles adding a credit to a patron's account
84 my $c = shift->openapi->valid_input or return;
86 my $patron_id = $c->validation->param('patron_id');
87 my $patron = Koha::Patrons->find($patron_id);
88 my $user = $c->stash('koha.user');
92 return $c->render( status => 404, openapi => { error => "Patron not found." } );
95 my $account = $patron->account;
96 my $body = $c->validation->param('body');
99 my $credit_type = $body->{credit_type} || 'PAYMENT'; # default to 'PAYMENT'
100 my $amount = $body->{amount}; # mandatory, validated by openapi
102 unless ( $amount > 0 ) { # until we support newer JSON::Validator and thus minimumExclusive
103 Koha::Exceptions::BadParameter->throw( { parameter => 'amount' } );
106 # read the rest of the params
107 my $payment_type = $body->{payment_type};
108 my $description = $body->{description};
109 my $note = $body->{note};
110 my $library_id = $body->{library_id};
112 my $credit = $account->add_credit(
114 type => $credit_type,
115 payment_type => $payment_type,
116 description => $description,
118 user_id => $user->id,
120 library_id => $library_id
123 $credit->discard_changes;
125 my $date = $body->{date};
126 $credit->date( $date )->store
129 my $debits_ids = $body->{account_lines_ids};
131 $debits = Koha::Account::Lines->search({ accountlines_id => { -in => $debits_ids } })
136 $credit = $credit->apply({ debits => [ $debits->as_list ] });
139 if ($credit->amountoutstanding != 0) {
140 my $outstanding_debits = $account->outstanding_debits;
141 $credit->apply({ debits => [ $outstanding_debits->as_list ] });
144 $credit->discard_changes;
148 openapi => $credit->to_api
152 $c->unhandled_exception($_);