]> git.evergreen-ils.org Git - working/Evergreen.git/blob - Open-ILS/web/js/ui/default/staff/circ/patron/bills.js
LP1781274 Fix floating point issue preventing transactions from closing
[working/Evergreen.git] / Open-ILS / web / js / ui / default / staff / circ / patron / bills.js
1
2 /* Billing Service */
3
4 angular.module('egPatronApp')
5
6 .factory('billSvc', 
7        ['$q','egCore','egWorkLog','patronSvc',
8 function($q , egCore , egWorkLog , patronSvc) {
9
10     var service = {};
11
12     // fetch org unit settings specific to the bills display
13     service.fetchBillSettings = function() {
14         if (service.settings) return $q.when(service.settings);
15         return egCore.org.settings([
16             'ui.circ.billing.uncheck_bills_and_unfocus_payment_box',
17             'ui.circ.billing.amount_warn', 'ui.circ.billing.amount_limit',
18             'circ.staff_client.do_not_auto_attempt_print',
19             'circ.disable_patron_credit'
20         ]).then(function(s) {return service.settings = s});
21     }
22
23     // user billing summary
24     service.fetchSummary = function() {
25         return egCore.pcrud.retrieve(
26             'mous', service.userId, {}, {authoritative : true})
27         .then(function(summary) {return service.summary = summary})
28     }
29
30     service.applyPayment = function(
31         type, payments, note, check, cc_args, patron_credit) {
32
33         return egCore.net.request(
34             'open-ils.circ',
35             'open-ils.circ.money.payment',
36             egCore.auth.token(), {
37                 userid : service.userId,
38                 note : note || '', 
39                 payment_type : type,
40                 check_number : check,
41                 payments : payments,
42                 patron_credit : patron_credit,
43                 cc_args : cc_args
44             },
45             patronSvc.current.last_xact_id()
46         ).then(function(resp) {
47             console.debug('payments: ' + js2JSON(resp));
48
49             if (evt = egCore.evt.parse(resp)) {
50                 // Ideally, all scenarios that lead to this alert appearing
51                 // will be avoided by the application logic.  Leave the alert
52                 // in place now to root out any that remain to be addressed.
53                 alert(evt);
54                 return $q.reject(''+evt);
55             }
56
57             var total = 0; angular.forEach(payments,function(p) { total += p[1]; });
58             var msg;
59             switch(type) {
60                 case 'cash_payment' : msg = egCore.strings.EG_WORK_LOG_CASH_PAYMENT; break;
61                 case 'check_payment' : msg = egCore.strings.EG_WORK_LOG_CHECK_PAYMENT; break;
62                 case 'credit_card_payment' : msg = egCore.strings.EG_WORK_LOG_CREDIT_CARD_PAYMENT; break;
63                 case 'debit_card_payment' : msg = egCore.strings.EG_WORK_LOG_DEBIT_CARD_PAYMENT; break;
64                 case 'credit_payment' : msg = egCore.strings.EG_WORK_LOG_CREDIT_PAYMENT; break;
65                 case 'work_payment' : msg = egCore.strings.EG_WORK_LOG_WORK_PAYMENT; break;
66                 case 'forgive_payment' : msg = egCore.strings.EG_WORK_LOG_FORGIVE_PAYMENT; break;
67                 case 'goods_payment' : msg = egCore.strings.EG_WORK_LOG_GOODS_PAYMENT; break;
68             }
69             egWorkLog.record(
70                 msg,{
71                     'action' : 'paid_bill',
72                     'patron_id' : service.userId,
73                     'total_amount' : total
74                 }
75             );
76
77             // payment API returns the update xact id so we can track it
78             // for future payments without having to refresh the user.
79             patronSvc.current.last_xact_id(resp.last_xact_id);
80
81             // reload patron data if credit balance has changed:
82             if(type === 'credit_payment' || patron_credit){ patronSvc.refreshPrimary(); }
83
84             return resp.payments;
85         });
86     }
87
88     service.fetchBills = function(xact_id) {
89         var bills = [];
90         return egCore.pcrud.search('mb',
91             {xact : xact_id}, null,
92             {authoritative : true}
93         ).then(
94             function() {return bills},
95             null,
96             function(bill) {bills.push(bill); return bill}
97         );
98     }
99
100     service.fetchStatement = function(xact_id) {
101         return egCore.net.request(
102             'open-ils.circ',
103             'open-ils.circ.money.statement.retrieve',
104             egCore.auth.token(), xact_id
105         ).then(function(resp) {
106             if (evt = egCore.evt.parse(resp)) return alert(evt);
107             return resp;
108         });
109     }
110
111     // TODO: no longer needed?
112     service.fetchPayments = function(xact_id) {
113         return egCore.net.request(
114             'open-ils.circ',
115             'open-ils.circ.money.payment.retrieve.all.authoritative',
116             egCore.auth.token(), xact_id
117         );
118     }
119
120     service.voidBills = function(bill_ids) {
121         return egCore.net.requestWithParamList(
122             'open-ils.circ',
123             'open-ils.circ.money.billing.void',
124             [egCore.auth.token()].concat(bill_ids)
125         ).then(function(resp) {
126             if (evt = egCore.evt.parse(resp)) return alert(evt);
127             return resp;
128         });
129     }
130
131     service.adjustBillsToZero = function(bill_ids) {
132         return egCore.net.request(
133             'open-ils.circ',
134             'open-ils.circ.money.billable_xact.adjust_to_zero',
135             egCore.auth.token(),
136             bill_ids
137         ).then(function(resp) {
138             if (evt = egCore.evt.parse(resp)) return alert(evt);
139             return resp;
140         });
141     }
142
143     service.updateBillNotes = function(note, ids) {
144         return egCore.net.requestWithParamList(
145             'open-ils.circ',
146             'open-ils.circ.money.billing.note.edit',
147             [egCore.auth.token(), note].concat(ids)
148         ).then(function(resp) {
149             if (evt = egCore.evt.parse(resp)) return alert(evt);
150             return resp;
151         });
152     }
153
154     service.updatePaymentNotes = function(note, ids) {
155         return egCore.net.requestWithParamList(
156             'open-ils.circ',
157             'open-ils.circ.money.payment.note.edit',
158             [egCore.auth.token(), note].concat(ids)
159         ).then(function(resp) {
160             if (evt = egCore.evt.parse(resp)) return alert(evt);
161             return resp;
162         });
163     }
164
165     return service;
166 }])
167
168
169 /**
170  * Manages Bills
171  */
172 .controller('PatronBillsCtrl',
173        ['$scope','$q','$routeParams','egCore','egConfirmDialog','$location',
174         'egGridDataProvider','billSvc','patronSvc','egPromptDialog', 'egAlertDialog',
175         'egBilling','$uibModal',
176 function($scope , $q , $routeParams , egCore , egConfirmDialog , $location,
177          egGridDataProvider , billSvc , patronSvc , egPromptDialog, egAlertDialog,
178          egBilling , $uibModal) {
179
180     $scope.initTab('bills', $routeParams.id);
181     billSvc.userId = $routeParams.id;
182
183     // set up some defaults
184     $scope.check_number = null;
185     $scope.payment_amount = null;
186     $scope.session_voided = 0;
187     $scope.payment_type = 'cash_payment';
188     $scope.focus_payment = true;
189     $scope.annotate_payment = false;
190     $scope.receipt_count = 1;
191     $scope.receipt_on_pay = { isChecked: false };
192     $scope.convert_to_credit = {isChecked: false};
193     $scope.warn_amount = 1000;
194     $scope.max_amount = 100000;
195     $scope.amount_verified = false;
196     $scope.disable_auto_print = false;
197
198     // Load persistant settings
199     egCore.hatch.getItem('circ.bills.receiptonpay')
200                 .then(function(rcptOnPay){
201                     if (rcptOnPay) $scope.receipt_on_pay.isChecked = rcptOnPay;
202                 });
203
204     egCore.hatch.getItem('eg.circ.bills.annotatepayment')
205                 .then(function(annoPay){
206                     if (annoPay) $scope.annotate_payment = annoPay;
207                 });
208
209     // pre-define list-returning funcs in case we access them
210     // before the grid instantiates
211     $scope.gridControls = {
212         focusRowSelector : false,
213         selectedItems : function(){return []},
214         allItems : function(){return []},
215         itemRetrieved : function(item) {
216             item.payment_pending = 0;
217         },
218         activateItem : function(item) {
219             $scope.showFullDetails([item]);
220         },
221         setQuery : function() {    
222             return {
223                 usr : billSvc.userId, 
224                 xact_finish : null,
225                 'summary.balance_owed' : {'<>' : 0}
226             }
227         }, 
228         setSort : function() {
229             return ['xact_start']; 
230         }
231     }
232     // -------------
233     // Apply coloring to rows based on fines stop reason
234     $scope.colorizeBillsList = {
235         apply: function(item) {
236             if (item['circulation.due_date'] && !item['circulation.checkin_time']) {
237                 if (item['circulation.stop_fines'] == 'LOST') {
238                     return 'lost-row';
239                 } else if (item['circulation.stop_fines'] == 'LONGOVERDUE') {
240                     return 'longoverdue-row';
241                 } else {
242                     return 'overdue-row';
243                 }
244             }
245         }
246     }
247
248     // Status Icon Column definition
249     $scope.statusIconColumn = {
250         isEnabled: true,
251         template: function(item) {
252             var icon = '';
253             if (item['circulation.due_date'] && !item['circulation.checkin_time']) {
254                 if (item['circulation.stop_fines'] == "LOST") {
255                     icon = 'glyphicon-question-sign';
256                 } else if (item['circulation.stop_fines'] == "LONGOVERDUE") {
257                     icon = 'glyphicon-exclamation-sign';
258                 } else {
259                     icon = 'glyphicon-time';
260                 }
261             }
262             return "<i class='glyphicon " + icon + "'></i>"
263         }
264     }
265
266     billSvc.fetchSummary().then(function(s) {$scope.summary = s});
267
268     // given a payment amount, determines how much of that is applied
269     // to selected transactions and how much is left over (change).
270     function pending_payment_info() {
271         var amt = $scope.payment_amount || 0;
272         if (amt >= $scope.owed_selected()) {
273             return {
274                 payment : $scope.owed_selected(),
275                 change : amt - $scope.owed_selected()
276             }
277         } 
278         return {payment : amt, change : 0};
279     }
280
281     // calculates amount owed, billed, and paid for selected items
282     // TODO: move me to service
283     function selected_payment_info() {
284         var info = {owed : 0, billed : 0, paid : 0};
285         angular.forEach($scope.gridControls.selectedItems(), function(item) {
286             info.owed   += Number(item['summary.balance_owed']) * 100;
287             info.billed += Number(item['summary.total_owed']) * 100;
288             info.paid   += Number(item['summary.total_paid']) * 100;
289         });
290         info.owed /= 100;
291         info.billed /= 100;
292         info.paid /= 100;
293         return info;
294     }
295
296     $scope.pending_payment = function() {
297         return pending_payment_info().payment;
298     }
299     $scope.pending_change = function() {
300         return pending_payment_info().change;
301     }
302     $scope.owed_selected = function() {
303         return selected_payment_info().owed; 
304     }
305     $scope.billed_selected = function() {
306         return selected_payment_info().billed;
307     }
308     $scope.paid_selected = function() {
309         return selected_payment_info().paid;
310     }
311     $scope.refunds_available = function() {
312         var amount = 0;
313         angular.forEach($scope.gridControls.allItems(), function(item) {
314             if (item['summary.balance_owed'] < 0) 
315                 amount += item['summary.balance_owed'] * 100;
316         });
317         return -(amount / 100);
318     }
319     $scope.invalid_check_number = function() { 
320         return $scope.payment_type == 'check_payment' && ! $scope.check_number; 
321     }
322
323     // update the item.payment_pending value each time the user
324     // selects different transactions to pay against.
325     $scope.$watch(
326         function() {return $scope.gridControls.selectedItems()},
327         function() {updatePendingColumn()},
328         true
329     );
330
331     // update the item.payment_pending for each (selected) 
332     // transaction any time the user-entered payment amount is modified
333     $scope.$watch('payment_amount', updatePendingColumn);
334
335     // updates the value of the payment_pending column in the grid.
336     // This has to be managed manually since the display value in the grid
337     // is derived from the value on the stored item and not the contents
338     // of our local scope variables.
339     function updatePendingColumn() {
340         // reset all to zero..
341         angular.forEach($scope.gridControls.allItems(), 
342             function(item) {item.payment_pending = 0});
343
344         var payment_amount = $scope.pending_payment();
345
346         var selected = $scope.gridControls.selectedItems();
347         for (var i = 0; i < selected.length; i++) { // for/break
348             var item = selected[i];
349             var owed = Number(item['summary.balance_owed']);
350
351             if (payment_amount > owed) {
352                 // pending payment exceeds balance of current item.
353                 // pay the entire item.
354                 item.payment_pending = owed;
355                 payment_amount -= owed;
356
357             } else {
358                 // balance owed on the current item matches or exceeds
359                 // the pending payment.  Apply the full remainder of
360                 // the payment to this item.. and we're done.
361                 // Limit to two decimal places to avoid floating point issues
362                 item.payment_pending = payment_amount.toFixed(2);
363                 break;
364             }
365         }
366     }
367
368     // builds payment arrays ([xact_id, ammount]) for all transactions
369     // which have a pending payment amount.
370     function generatePayments() {
371         var payments = [];
372         angular.forEach($scope.gridControls.selectedItems(), function(item) {
373             if (item.payment_pending == 0) return;
374             payments.push([item.id, item.payment_pending]);
375         });
376         return payments;
377     }
378
379     function refreshDisplay() {
380         patronSvc.fetchUserStats();
381         billSvc.fetchSummary().then(function(s) {$scope.summary = s});
382         $scope.payment_amount = null;
383         $scope.gridControls.refresh();
384     }
385
386     // generates payments, collects user note if needed, and sends payment
387     // to server.
388     function sendPayment(note, cc_args) {
389         $scope.applyingPayment = true;
390         var make_payments = generatePayments();
391         var patron_credit = $scope.convert_to_credit.isChecked ?
392             $scope.pending_change() : 0; 
393         billSvc.applyPayment($scope.payment_type, 
394             make_payments, note, $scope.check_number, cc_args, patron_credit)
395         .then(
396             function(payment_ids) {
397
398                 if (!$scope.disable_auto_print && $scope.receipt_on_pay.isChecked) {
399                     printReceipt(
400                         $scope.payment_type, payment_ids, make_payments, note);
401                 }
402
403                 refreshDisplay();
404             },
405             function(msg) {
406                 console.error('Payment was rejected: ' + msg);
407             }
408         )
409         .finally(function() { $scope.applyingPayment = false; })
410     }
411
412     $scope.onReceiptOnPayChanged = function(){
413         egCore.hatch.setItem('circ.bills.receiptonpay', $scope.receipt_on_pay.isChecked);
414     }
415
416     $scope.onAnnotatePaymentChanged = function(){
417         egCore.hatch.setItem('eg.circ.bills.annotatepayment', $scope.annotate_payment);
418     }
419
420     function printReceipt(type, payment_ids, payments_made, note) {
421         var payment_blobs = [];
422         var cusr = patronSvc.current;
423
424         angular.forEach(payments_made, function(payment) {
425             var xact_id = payment[0];
426
427             // find the original transaction in the grid..
428             var xact = $scope.gridControls.allItems().filter(
429                 function(item) {return item.id == xact_id})[0];
430
431             payment_blobs.push({
432                 xact : egCore.idl.flatToNestedHash(xact),
433                 amount : payment[1]
434             });
435         });
436
437         console.log(js2JSON(payment_blobs[0]));
438
439         // page data not yet refreshed, capture data from current scope
440         var print_data = {
441             payment_type : type,
442             payment_note : note,
443             previous_balance : Number($scope.summary.balance_owed()),
444             payment_total : Number($scope.payment_amount),
445             payment_applied : $scope.pending_payment(),
446             amount_voided : Number($scope.session_voided),
447             change_given : $scope.pending_change(),
448             payments : payment_blobs,
449             current_location : egCore.idl.toHash(
450                 egCore.org.get(egCore.auth.user().ws_ou()))
451         };
452
453         // Not a good idea to use patron_stats.fines for this; it's out of date
454         print_data.patron = {
455             prefix : cusr.prefix(),
456             first_given_name : cusr.first_given_name(),
457             second_given_name : cusr.second_given_name(),
458             family_name : cusr.family_name(),
459             suffix : cusr.suffix(),
460             pref_prefix : cusr.pref_prefix(),
461             pref_first_given_name : cusr.pref_first_given_name(),
462             pref_second_given_name : cusr.pref_second_given_name(),
463             pref_family_name : cusr.pref_family_name(),
464             pref_suffix : cusr.pref_suffix(),
465             card : { barcode : cusr.card().barcode() },
466             expire_date : cusr.expire_date(),
467             alias : cusr.alias(),
468             has_email : Boolean(patronSvc.current.email() && patronSvc.current.email().match(/.*@.*/)),
469             has_phone : Boolean(cusr.day_phone() || cusr.evening_phone() || cusr.other_phone())
470         };
471
472         print_data.new_balance = (
473             print_data.previous_balance * 100 - 
474             print_data.payment_applied * 100) / 100;
475
476         for (var i = 0; i < $scope.receipt_count; i++) {
477             egCore.print.print({
478                 context : 'receipt', 
479                 template : 'bill_payment', 
480                 scope : print_data
481             });
482         }
483     }
484
485     $scope.showHistory = function() {
486         $location.path('/circ/patron/' + 
487             patronSvc.current.id() + '/bill_history/transactions');
488     }
489     
490     // For now, only adds billing to first selected item.
491     // Could do batches later if needed
492     $scope.addBilling = function(all) {
493         if (all[0]) {
494             egBilling.showBillDialog({
495                 xact : egCore.idl.flatToNestedHash(all[0]),
496                 patron : $scope.patron()
497             }).then(refreshDisplay);
498         }
499     }
500
501     $scope.showBillDialog = function($event) {
502         egBilling.showBillDialog({
503             patron : $scope.patron()
504         }).then(refreshDisplay);
505     }
506
507     // Select refunds adds all refunds to the existing selection.
508     // It does not /only/ select refunds
509     $scope.selectRefunds = function() {
510         var ids = $scope.gridControls.selectedItems().map(
511             function(i) { return i.id });
512         angular.forEach($scope.gridControls.allItems(), function(item) {
513             if (Number(item['summary.balance_owed']) < 0)
514                 ids.push(item.id);
515         });
516         $scope.gridControls.selectItems(ids);
517     }
518
519     // -------------
520     // determine on initial page load when all of the grid rows should
521     // be selected.
522     var selectOnLoad = true;
523     billSvc.fetchBillSettings().then(function(s) {
524         if (s['ui.circ.billing.uncheck_bills_and_unfocus_payment_box']) {
525             $scope.focus_payment = false; // de-focus the payment box
526             $scope.gridControls.focusRowSelector = true;
527             selectOnLoad = false;
528             // if somehow the grid finishes rendering before our settings 
529             // arrive, manually de-select everything.
530             $scope.gridControls.selectItems([]);
531         }
532         if (s['ui.circ.billing.amount_warn']) {
533             $scope.warn_amount = Number(s['ui.circ.billing.amount_warn']);
534         }
535         if (s['ui.circ.billing.amount_limit']) {
536             $scope.max_amount = Number(s['ui.circ.billing.amount_limit']);
537         }
538         if (s['circ.staff_client.do_not_auto_attempt_print'] && angular.isArray(s['circ.staff_client.do_not_auto_attempt_print'])) {
539             $scope.disable_auto_print = Boolean(
540                 s['circ.staff_client.do_not_auto_attempt_print'].indexOf('Bill Pay') > -1
541             );
542         }
543         if (s['circ.disable_patron_credit']) {
544             $scope.disablePatronCredit = true;
545         }
546     });
547
548     $scope.gridControls.allItemsRetrieved = function() {
549         if (selectOnLoad) {
550             selectOnLoad = false; // only for initial controller load.
551             // select all non-refund items
552             $scope.gridControls.selectItems( 
553                 $scope.gridControls.allItems()
554                 .filter(function(i) {return i['summary.balance_owed'] > 0})
555                 .map(function(i){return i.id})
556             );
557         }
558     }
559     // -------------
560
561
562     $scope.printBills = function(selected) {
563         if (!selected.length) return;
564         // bills print receipt assumes nested hashes, but our grid
565         // stores flattener data.  Fetch the selected xacts as
566         // fleshed pcrud objects and hashify.  
567         // (Consider an alternate approach..)
568         var ids = selected.map(function(t){ return t.id });
569         var xacts = [];
570         egCore.pcrud.search('mbt', 
571             {id : ids},
572             {flesh : 5, flesh_fields : {
573                 'mbt' : ['summary', 'circulation'],
574                 'circ' : ['target_copy'],
575                 'acp' : ['call_number'],
576                 'acn' : ['record'],
577                 'bre' : ['simple_record']
578                 }
579             },
580             {authoritative : true}
581         ).then(
582             function() {
583                 var cusr = patronSvc.current;
584                 egCore.print.print({
585                     context : 'receipt', 
586                     template : 'bills_current', 
587                     scope : {   
588                         transactions : xacts,
589                         current_location : egCore.idl.toHash(
590                             egCore.org.get(egCore.auth.user().ws_ou())),
591                         patron : {
592                             prefix : cusr.prefix(),
593                             first_given_name : cusr.first_given_name(),
594                             second_given_name : cusr.second_given_name(),
595                             family_name : cusr.family_name(),
596                             suffix : cusr.suffix(),
597                             pref_prefix : cusr.pref_prefix(),
598                             pref_first_given_name : cusr.pref_first_given_name(),
599                             pref_second_given_name : cusr.pref_second_given_name(),
600                             pref_family_name : cusr.pref_family_name(),
601                             pref_suffix : cusr.pref_suffix(),
602                             card : { barcode : cusr.card().barcode() },
603                             expire_date : cusr.expire_date(),
604                             alias : cusr.alias(),
605                             has_email : Boolean(cusr.email() && cusr.email().match(/.*@.*/)),
606                             has_phone : Boolean(cusr.day_phone() || cusr.evening_phone() || cusr.other_phone())
607                         }
608                     }
609                 });
610             }, 
611             null, 
612             function(xact) {
613                 newXact = {
614                     billing_total : xact.billing_total(),
615                     billings : xact.billings(),
616                     grocery : xact.grocery(),
617                     id : xact.id(),
618                     payment_total : xact.payment_total(),
619                     payments : xact.payments(),
620                     summary : egCore.idl.toHash(xact.summary()),
621                     unrecovered : xact.unrecovered(),
622                     xact_finish : xact.xact_finish(),
623                     xact_start : xact.xact_start(),
624                 }
625                 if (xact.circulation()) {
626                     newXact.copy_barcode = xact.circulation().target_copy().barcode(),
627                     newXact.title = xact.circulation().target_copy().call_number().record().simple_record().title()
628                 }
629                 xacts.push(newXact);
630             }
631         );
632     }
633
634     $scope.applyPayment = function() {
635
636         if ($scope.payment_amount > $scope.max_amount ) {
637             egAlertDialog.open(
638                 egCore.strings.PAYMENT_OVER_MAX,
639                 {   max_amount : ''+$scope.max_amount,
640                     ok : function() {
641                         $scope.payment_amount = 0;
642                     }
643                 }
644             );
645             return;
646         }
647
648         verify_payment_amount().then(
649             function() { // amount confirmed
650                 add_payment_note().then(function(pay_note) {
651                     add_cc_args().then(function(cc_args) {
652                         var note_text = pay_note ? pay_note.value || '' : null;
653                         sendPayment(note_text, cc_args);
654                     })
655                 });
656             },
657             function() { // amount rejected
658                 console.warn('payment amount rejected');
659                 $scope.payment_amount = 0;
660             }
661         );
662     }
663
664     function verify_payment_amount() {
665         if ($scope.payment_amount < $scope.warn_amount)
666             return $q.when();
667
668         return egConfirmDialog.open(
669             egCore.strings.PAYMENT_WARN_AMOUNT_TITLE, 
670             egCore.strings.PAYMENT_WARN_AMOUNT,
671             {payment_amount : ''+$scope.payment_amount}
672         ).result;
673     }
674
675     function add_payment_note() {
676         if (!$scope.annotate_payment) return $q.when();
677         return egPromptDialog.open(
678             egCore.strings.ANNOTATE_PAYMENT_MSG, '').result;
679     }
680
681     function add_cc_args() {
682         if ($scope.payment_type != 'credit_card_payment') 
683             return $q.when();
684
685         return $uibModal.open({
686             templateUrl : './circ/patron/t_cc_payment_dialog',
687             backdrop: 'static',
688             controller : [
689                         '$scope','$uibModalInstance',
690                 function($scope , $uibModalInstance) {
691
692                     $scope.context = {
693                         cc : {
694                             where_process : '1', // internal=1 ; external=0
695                             type : 'VISA', // external only
696                             billing_first : patronSvc.current.first_given_name(),
697                             billing_last : patronSvc.current.family_name()
698                         }
699                     }
700
701                     var addr = patronSvc.current.billing_address() ||
702                         patronSvc.current.mailing_address();
703                     if (addr) {
704                         var cc = $scope.context.cc;
705                         cc.billing_address = addr.street1() + 
706                             (addr.street2() ? ' ' + addr.street2() : '');
707                         cc.billing_city = addr.city();
708                         cc.billing_state = addr.state();
709                         cc.billing_zip = addr.post_code();
710                     }
711
712                     $scope.ok = function() {
713                         // CC payment form is not a <form>, 
714                         // so apply validation manually.
715                         if ( $scope.context.cc.where_process == 0 && 
716                             !$scope.context.cc.approval_code)
717                             return;
718
719                         $uibModalInstance.close($scope.context.cc);
720                     }
721
722                     $scope.cancel = function() {
723                         $uibModalInstance.dismiss();
724                     }
725                 }
726             ]
727         }).result;
728     }
729
730     $scope.voidAllBillings = function(items) {
731         var promises = [];
732         var bill_ids = [];
733         var cents = 0;
734         angular.forEach(items, function(item) {
735             promises.push(
736                 billSvc.fetchBills(item.id).then(function(bills) {
737                     angular.forEach(bills, function(b) {
738                         if (b.voided() != 't') {
739                             cents += b.amount() * 100;
740                             bill_ids.push(b.id())
741                         }
742                     });
743
744                     if (bill_ids.length == 0) {
745                         // TODO: warn
746                         return;
747                     }
748
749                 })
750             );
751         });
752
753         $q.all(promises).then(function(){
754             egCore.audio.play('warning.circ.void_billings_confirmation');
755             egConfirmDialog.open(
756                 egCore.strings.CONFIRM_VOID_BILLINGS, '', 
757                 {   billIds : ''+bill_ids,
758                     amount : ''+(cents/100),
759                     ok : function() {
760                         billSvc.voidBills(bill_ids).then(function() {
761                             $scope.session_voided = 
762                                 ($scope.session_voided * 100 + cents) / 100;
763                             refreshDisplay();
764                         });
765                     }
766                 }
767             );
768         });
769     }
770
771     $scope.adjustToZero = function(items) {
772         if (items.length == 0) return;
773
774         var ids = items.map(function(item) {return item.id});
775
776         egCore.audio.play('warning.circ.adjust_to_zero_confirmation');
777         egConfirmDialog.open(
778             egCore.strings.CONFIRM_ADJUST_TO_ZERO, '', 
779             {   xactIds : ''+ids,
780                 ok : function() {
781                     billSvc.adjustBillsToZero(ids).then(function() {
782                         refreshDisplay();
783                     });
784                 }
785             }
786         );
787
788     }
789
790     // note this is functionally equivalent to selecting a neg. transaction
791     // then clicking Apply Payment -- this just adds a speed bump (ditto
792     // the XUL client).
793     $scope.refundXact = function(all) {
794         var items = all.filter(function(item) {
795             return item['summary.balance_owed'] < 0
796         });
797
798         if (items.length == 0) return;
799
800         var ids = items.map(function(item) {return item.id});
801
802         egCore.audio.play('warning.circ.refund_confirmation');
803         egConfirmDialog.open(
804             egCore.strings.CONFIRM_REFUND_PAYMENT, '', 
805             {   xactIds : ''+ids,
806                 ok : function() {
807                     // reset the received payment amount.  this ensures
808                     // we're not mingling payments with refunds.
809                     $scope.payment_amount = 0;
810                 }
811             }
812         );
813     }
814
815     // direct the user to the transaction details page
816     $scope.showFullDetails = function(all) {
817         var lastClicked = $scope.gridControls.contextMenuItem();
818         if (lastClicked) {
819             $location.path('/circ/patron/' + 
820                 patronSvc.current.id() + '/bill/' + lastClicked + '/statement');
821         } else if (all[0]) {
822             $location.path('/circ/patron/' + 
823                 patronSvc.current.id() + '/bill/' + all[0].id + '/statement');
824         }
825             
826     }
827
828     $scope.activateBill = function(xact) {
829         $scope.showFullDetails([xact]);
830     }
831
832 }])
833
834 /**
835  * Displays details of a single transaction
836  */
837 .controller('XactDetailsCtrl',
838        ['$scope','$q','$routeParams','egCore','egGridDataProvider','patronSvc','billSvc','egPromptDialog','egBilling','egConfirmDialog',
839 function($scope,  $q , $routeParams , egCore , egGridDataProvider , patronSvc , billSvc , egPromptDialog , egBilling , egConfirmDialog ) {
840
841     $scope.initTab('bills', $routeParams.id);
842     var xact_id = $routeParams.xact_id;
843     $scope.xact_tab = $routeParams.xact_tab;
844
845     var xactGrid = $scope.xactGridControls = {
846         setQuery : function() { return {xact : xact_id} },
847         setSort : function() { return ['billing_ts'] }
848     }
849
850     var paymentGrid = $scope.paymentGridControls = {
851         setQuery : function() { return {xact : xact_id} },
852         setSort : function() { return ['payment_ts'] }
853     }
854
855     // -- actions
856     $scope.voidBillings = function(bill_list) {
857         var bill_ids = [];
858         var cents = 0;
859         angular.forEach(bill_list, function(b) {
860             if (b.voided != 't') {
861                 cents += b.amount * 100;
862                 bill_ids.push(b.id)
863             }
864         });
865
866         if (bill_ids.length == 0) {
867             // TODO: warn
868             return;
869         }
870
871         egCore.audio.play('warning.circ.void_billings_confirmation');
872         egConfirmDialog.open(
873             egCore.strings.CONFIRM_VOID_BILLINGS, '', 
874             {   billIds : ''+bill_ids,
875                 amount : ''+(cents/100),
876                 ok : function() {
877                     billSvc.voidBills(bill_ids).then(function() {
878                         // TODO? $scope.session_voided = ...
879
880                         // refresh bills and summary data
881                         // note: no need to update payments
882                         patronSvc.fetchUserStats();
883
884                         egBilling.fetchXact(xact_id).then(function(xact) {
885                             $scope.xact = xact
886                         });
887
888                         xactGrid.refresh();
889                     });
890                 }
891             }
892         );
893     }
894
895     // batch-edit billing and payment notes, depending on 'type'
896     function editNotes(selected, type) {
897         var notes = selected.map(function(b){ return b.note }).join(',');
898         var ids = selected.map(function(b){ return b.id });
899
900         // show the note edit prompt
901         egPromptDialog.open(
902             egCore.strings.EDIT_BILL_PAY_NOTE, notes, {
903                 ids : ''+ids,
904                 ok : function(value) {
905
906                     var func = 'updateBillNotes';
907                     if (type == 'payment') func = 'updatePaymentNotes';
908
909                     billSvc[func](value, ids).then(function() {
910                         if (type == 'payment') {
911                             paymentGrid.refresh();
912                         } else {
913                             xactGrid.refresh();
914                         }
915                     });
916                 }
917             }
918         );
919     }
920
921     $scope.editBillNotes = function(selected) {
922         editNotes(selected, 'bill');
923     }
924
925     $scope.editPaymentNotes = function(selected) {
926         editNotes(selected, 'payment');
927     }
928
929     // -- retrieve our data
930     if ($scope.xact_tab == 'statement') {
931         //fetch combined billing statement data
932         billSvc.fetchStatement(xact_id).then(function(statement) {
933             //console.log(statement);
934             $scope.statement_data = statement;
935         });
936     }
937     $scope.total_circs = 0; // start with 0 instead of undefined
938     egBilling.fetchXact(xact_id).then(function(xact) {
939         $scope.xact = xact;
940
941         var copyId = xact.circulation().target_copy().id();
942         var circ_count = 0;
943         egCore.pcrud.search('circbyyr',
944             {copy : copyId}, null, {atomic : true})
945         .then(function(counts) {
946             angular.forEach(counts, function(count) {
947                 circ_count += Number(count.count());
948             });
949             $scope.total_circs = circ_count;
950         });
951         // set the title.  only needs to be done on initial page load
952         if (xact.circulation()) {
953             if (xact.circulation().target_copy().call_number().id() == -1) {
954                 $scope.title = xact.circulation().target_copy().dummy_title();
955             } else  {
956                 // TODO: shared bib service?
957                 $scope.title = xact.circulation().target_copy()
958                     .call_number().record().simple_record().title();
959                 $scope.title_id = xact.circulation().target_copy()
960                     .call_number().record().id();
961             }
962         }
963     });
964 }])
965
966
967 .controller('BillHistoryCtrl',
968        ['$scope','$q','$routeParams','egCore','patronSvc','billSvc','egPromptDialog','$location',
969 function($scope,  $q , $routeParams , egCore , patronSvc , billSvc , egPromptDialog , $location) {
970
971     $scope.initTab('bills', $routeParams.id);
972     billSvc.userId = $routeParams.id;
973     $scope.bill_tab = $routeParams.history_tab;
974     $scope.totals = {};
975
976     // link page controller actions defined by sub-controllers here
977     $scope.actions = {};
978
979     var start = new Date(); // now - 1 year
980     start.setFullYear(start.getFullYear() - 1),
981     $scope.dates = {
982         xact_start : start,
983         xact_finish : new Date()
984     }
985
986     $scope.date_range = function() {
987         var start = $scope.dates.xact_start.toISOString().replace(/T.*/,'');
988         var end = $scope.dates.xact_finish.toISOString().replace(/T.*/,'');
989         var today = new Date().toISOString().replace(/T.*/,'');
990         if (end == today) end = 'now';
991         return [start, end];
992     }
993 }])
994
995
996 .controller('BillXactHistoryCtrl',
997        ['$scope','$q','egCore','patronSvc','billSvc','egPromptDialog','$location','egBilling',
998 function($scope,  $q , egCore , patronSvc , billSvc , egPromptDialog , $location , egBilling) {
999
1000     // generate a grid query with the current date widget values.
1001     function current_grid_query() {
1002         return {
1003             '-or' : [
1004                 {'summary.balance_owed' : {'<>' : 0}},
1005                 {'summary.last_payment_ts' : {'<>' : null}}
1006             ],
1007             xact_start : {between : $scope.date_range()},
1008             usr : billSvc.userId
1009         }
1010     }
1011
1012     $scope.gridControls = {
1013         selectedItems : function(){return []},
1014         activateItem : function(item) {
1015             $scope.showFullDetails([item]);
1016         },
1017         // this sets the query on page load
1018         setQuery : current_grid_query
1019     }
1020
1021     $scope.$watch('dates.xact_start', function(new_date, old_date) {
1022         if (new_date !== old_date && new_date) {
1023             if (new_date.getTime() > $scope.dates.xact_finish.getTime()) {
1024                 $scope.dates.xact_finish = new_date;
1025             } else {
1026                 $scope.actions.apply_date_range();
1027             }
1028         }
1029     });
1030     $scope.$watch('dates.xact_finish', function(new_date, old_date) {
1031         if (new_date !== old_date && new_date) {
1032             if (new_date.getTime() < $scope.dates.xact_start.getTime()) {
1033                 $scope.dates.xact_start = new_date;
1034             } else {
1035                 $scope.actions.apply_date_range();
1036             }
1037         }
1038     });
1039
1040     $scope.actions.apply_date_range = function() {
1041         // tells the grid to re-draw itself with the new query
1042         $scope.gridControls.setQuery(current_grid_query());
1043     }
1044
1045     // TODO; move me to service
1046     function selected_payment_info() {
1047         var info = {owed : 0, billed : 0, paid : 0};
1048         angular.forEach($scope.gridControls.selectedItems(), function(item) {
1049             info.owed   += Number(item['summary.balance_owed']) * 100;
1050             info.billed += Number(item['summary.total_owed']) * 100;
1051             info.paid   += Number(item['summary.total_paid']) * 100;
1052         });
1053         info.owed /= 100;
1054         info.billed /= 100;
1055         info.paid /= 100;
1056         return info;
1057     }
1058
1059     $scope.totals.selected_billed = function() {
1060         return selected_payment_info().billed;
1061     }
1062     $scope.totals.selected_paid = function() {
1063         return selected_payment_info().paid;
1064     }
1065
1066     $scope.showFullDetails = function(all) {
1067         if (all[0]) 
1068             $location.path('/circ/patron/' + 
1069                 patronSvc.current.id() + '/bill/' + all[0].id + '/statement');
1070     }
1071
1072     // For now, only adds billing to first selected item.
1073     // Could do batches later if needed
1074     $scope.addBilling = function(all) {
1075         if (all[0]) {
1076             egBilling.showBillDialog({
1077                 xact : egCore.idl.flatToNestedHash(all[0]),
1078                 patron : $scope.patron()
1079             }).then(function() { 
1080                 $scope.gridControls.refresh();
1081                 patronSvc.fetchUserStats();
1082             })
1083         }
1084     }
1085
1086     $scope.printBills = function(selected) { // FIXME: refactor me
1087         if (!selected.length) return;
1088         // bills print receipt assumes nested hashes, but our grid
1089         // stores flattener data.  Fetch the selected xacts as
1090         // fleshed pcrud objects and hashify.  
1091         // (Consider an alternate approach..)
1092         var ids = selected.map(function(t){ return t.id });
1093         var xacts = [];
1094         egCore.pcrud.search('mbt', 
1095             {id : ids},
1096             {flesh : 5, flesh_fields : {
1097                 'mbt' : ['summary', 'circulation'],
1098                 'circ' : ['target_copy'],
1099                 'acp' : ['call_number'],
1100                 'acn' : ['record'],
1101                 'bre' : ['simple_record']
1102                 }
1103             },
1104             {authoritative : true}
1105         ).then(
1106             function() {
1107                 var cusr = patronSvc.current;
1108                 egCore.print.print({
1109                     context : 'receipt', 
1110                     template : 'bills_historical', 
1111                     scope : {   
1112                         transactions : xacts,
1113                         current_location : egCore.idl.toHash(
1114                             egCore.org.get(egCore.auth.user().ws_ou())),
1115                         patron : {
1116                             prefix : cusr.prefix(),
1117                             pref_prefix : cusr.pref_prefix(),
1118                             pref_first_given_name : cusr.pref_first_given_name(),
1119                             pref_second_given_name : cusr.pref_second_given_name(),
1120                             pref_family_name : cusr.pref_family_name(),
1121                             pref_suffix : cusr.pref_suffix(),
1122                             first_given_name : cusr.first_given_name(),
1123                             second_given_name : cusr.second_given_name(),
1124                             family_name : cusr.family_name(),
1125                             suffix : cusr.suffix(),
1126                             card : { barcode : cusr.card().barcode() },
1127                             expire_date : cusr.expire_date(),
1128                             alias : cusr.alias(),
1129                             has_email : Boolean(cusr.email() && cusr.email().match(/.*@.*/)),
1130                             has_phone : Boolean(cusr.day_phone() || cusr.evening_phone() || cusr.other_phone())
1131                         }
1132                     }
1133                 });
1134             }, 
1135             null, 
1136             function(xact) {
1137                 newXact = {
1138                     billing_total : xact.billing_total(),
1139                     billings : xact.billings(),
1140                     grocery : xact.grocery(),
1141                     id : xact.id(),
1142                     payment_total : xact.payment_total(),
1143                     payments : xact.payments(),
1144                     summary : egCore.idl.toHash(xact.summary()),
1145                     unrecovered : xact.unrecovered(),
1146                     xact_finish : xact.xact_finish(),
1147                     xact_start : xact.xact_start(),
1148                 }
1149                 if (xact.circulation()) {
1150                     newXact.copy_barcode = xact.circulation().target_copy().barcode(),
1151                     newXact.title = xact.circulation().target_copy().call_number().record().simple_record().title()
1152                 }
1153                 xacts.push(newXact);
1154             }
1155         );
1156     }
1157 }])
1158
1159 .controller('BillPaymentHistoryCtrl',
1160        ['$scope','$q','egCore','patronSvc','billSvc','$location',
1161 function($scope,  $q , egCore , patronSvc , billSvc , $location) {
1162
1163     // generate a grid query with the current date widget values.
1164     function current_grid_query() {
1165         return {
1166             'payment_ts' : {between : $scope.date_range()},
1167             'xact.usr' : billSvc.userId
1168         }
1169     }
1170
1171     $scope.gridControls = {
1172         selectedItems : function(){return []},
1173         activateItem : function(item) {
1174             $scope.showFullDetails([item]);
1175         },
1176         setSort : function() {
1177             return [{'payment_ts' : 'DESC'}, 'id'];
1178         },
1179         setQuery : current_grid_query
1180     }
1181
1182     $scope.$watch('dates.xact_start', function(new_date, old_date) {
1183         if (new_date !== old_date && new_date) {
1184             if (new_date.getTime() > $scope.dates.xact_finish.getTime()) {
1185                 $scope.dates.xact_finish = new_date;
1186             } else {
1187                 $scope.actions.apply_date_range();
1188             }
1189         }
1190     });
1191     $scope.$watch('dates.xact_finish', function(new_date, old_date) {
1192         if (new_date !== old_date && new_date) {
1193             if (new_date.getTime() < $scope.dates.xact_start.getTime()) {
1194                 $scope.dates.xact_start = new_date;
1195             } else {
1196                 $scope.actions.apply_date_range();
1197             }
1198         }
1199     });
1200
1201     $scope.actions.apply_date_range = function() {
1202         // tells the grid to re-draw itself with the new query
1203         $scope.gridControls.setQuery(current_grid_query());
1204     }
1205
1206     $scope.showFullDetails = function(all) {
1207         if (all[0]) 
1208             $location.path('/circ/patron/' + 
1209                 patronSvc.current.id() + '/bill/' + all[0]['xact.id'] + '/statement');
1210     }
1211
1212     $scope.totals.selected_paid = function() {
1213         var paid = 0;
1214         angular.forEach($scope.gridControls.selectedItems(), function(payment) {
1215             paid += Number(payment.amount) * 100;
1216         });
1217         return paid / 100;
1218     }
1219 }])
1220
1221
1222