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','owning_lib','prefix','suffix'],
 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                     newXact.call_number = {
 629                         label : xact.circulation().target_copy().call_number().label(),
 630                                     prefix : xact.circulation().target_copy().call_number().prefix().label(),
 631                                     suffix : xact.circulation().target_copy().call_number().suffix().label(),
 632                         owning_lib : {
 633                             name : xact.circulation().target_copy().call_number().owning_lib().name(),
 634                             shortname : xact.circulation().target_copy().call_number().owning_lib().shortname()
 635                         }
 636                     }
 637                 }
 638                 xacts.push(newXact);
 639             }
 640         );
 641     }
 642
 643     $scope.applyPayment = function() {
 644
 645         if ($scope.payment_amount > $scope.max_amount ) {
 646             egAlertDialog.open(
 647                 egCore.strings.PAYMENT_OVER_MAX,
 648                 {   max_amount : ''+$scope.max_amount,
 649                     ok : function() {
 650                         $scope.payment_amount = 0;
 651                     }
 652                 }
 653             );
 654             return;
 655         }
 656
 657         verify_payment_amount().then(
 658             function() { // amount confirmed
 659                 add_payment_note().then(function(pay_note) {
 660                     add_cc_args().then(function(cc_args) {
 661                         var note_text = pay_note ? pay_note.value || '' : null;
 662                         sendPayment(note_text, cc_args);
 663                     })
 664                 });
 665             },
 666             function() { // amount rejected
 667                 console.warn('payment amount rejected');
 668                 $scope.payment_amount = 0;
 669             }
 670         );
 671     }
 672
 673     function verify_payment_amount() {
 674         if ($scope.payment_amount < $scope.warn_amount)
 675             return $q.when();
 676
 677         return egConfirmDialog.open(
 678             egCore.strings.PAYMENT_WARN_AMOUNT_TITLE,
 679             egCore.strings.PAYMENT_WARN_AMOUNT,
 680             {payment_amount : ''+$scope.payment_amount}
 681         ).result;
 682     }
 683
 684     function add_payment_note() {
 685         if (!$scope.annotate_payment) return $q.when();
 686         return egPromptDialog.open(
 687             egCore.strings.ANNOTATE_PAYMENT_MSG, '').result;
 688     }
 689
 690     function add_cc_args() {
 691         if ($scope.payment_type != 'credit_card_payment')
 692             return $q.when();
 693
 694         return $uibModal.open({
 695             templateUrl : './circ/patron/t_cc_payment_dialog',
 696             backdrop: 'static',
 697             controller : [
 698                         '$scope','$uibModalInstance',
 699                 function($scope , $uibModalInstance) {
 700
 701                     $scope.context = {
 702                         cc : {
 703                             where_process : '1', // internal=1 ; external=0
 704                             type : 'VISA', // external only
 705                             billing_first : patronSvc.current.first_given_name(),
 706                             billing_last : patronSvc.current.family_name()
 707                         }
 708                     }
 709
 710                     var addr = patronSvc.current.billing_address() ||
 711                         patronSvc.current.mailing_address();
 712                     if (addr) {
 713                         var cc = $scope.context.cc;
 714                         cc.billing_address = addr.street1() +
 715                             (addr.street2() ? ' ' + addr.street2() : '');
 716                         cc.billing_city = addr.city();
 717                         cc.billing_state = addr.state();
 718                         cc.billing_zip = addr.post_code();
 719                     }
 720
 721                     $scope.ok = function() {
 722                         // CC payment form is not a <form>,
 723                         // so apply validation manually.
 724                         if ( $scope.context.cc.where_process == 0 &&
 725                             !$scope.context.cc.approval_code)
 726                             return;
 727
 728                         $uibModalInstance.close($scope.context.cc);
 729                     }
 730
 731                     $scope.cancel = function() {
 732                         $uibModalInstance.dismiss();
 733                     }
 734                 }
 735             ]
 736         }).result;
 737     }
 738
 739     $scope.voidAllBillings = function(items) {
 740         var promises = [];
 741         var bill_ids = [];
 742         var cents = 0;
 743         angular.forEach(items, function(item) {
 744             promises.push(
 745                 billSvc.fetchBills(item.id).then(function(bills) {
 746                     angular.forEach(bills, function(b) {
 747                         if (b.voided() != 't') {
 748                             cents += b.amount() * 100;
 749                             bill_ids.push(b.id())
 750                         }
 751                     });
 752
 753                     if (bill_ids.length == 0) {
 754                         // TODO: warn
 755                         return;
 756                     }
 757
 758                 })
 759             );
 760         });
 761
 762         $q.all(promises).then(function(){
 763             egCore.audio.play('warning.circ.void_billings_confirmation');
 764             egConfirmDialog.open(
 765                 egCore.strings.CONFIRM_VOID_BILLINGS, '',
 766                 {   billIds : ''+bill_ids,
 767                     amount : ''+(cents/100),
 768                     ok : function() {
 769                         billSvc.voidBills(bill_ids).then(function() {
 770                             $scope.session_voided =
 771                                 ($scope.session_voided * 100 + cents) / 100;
 772                             refreshDisplay();
 773                         });
 774                     }
 775                 }
 776             );
 777         });
 778     }
 779
 780     $scope.adjustToZero = function(items) {
 781         if (items.length == 0) return;
 782
 783         var ids = items.map(function(item) {return item.id});
 784
 785         egCore.audio.play('warning.circ.adjust_to_zero_confirmation');
 786         egConfirmDialog.open(
 787             egCore.strings.CONFIRM_ADJUST_TO_ZERO, '',
 788             {   xactIds : ''+ids,
 789                 ok : function() {
 790                     billSvc.adjustBillsToZero(ids).then(function() {
 791                         refreshDisplay();
 792                     });
 793                 }
 794             }
 795         );
 796
 797     }
 798
 799     // note this is functionally equivalent to selecting a neg. transaction
 800     // then clicking Apply Payment -- this just adds a speed bump (ditto
 801     // the XUL client).
 802     $scope.refundXact = function(all) {
 803         var items = all.filter(function(item) {
 804             return item['summary.balance_owed'] < 0
 805         });
 806
 807         if (items.length == 0) return;
 808
 809         var ids = items.map(function(item) {return item.id});
 810
 811         egCore.audio.play('warning.circ.refund_confirmation');
 812         egConfirmDialog.open(
 813             egCore.strings.CONFIRM_REFUND_PAYMENT, '',
 814             {   xactIds : ''+ids,
 815                 ok : function() {
 816                     // reset the received payment amount.  this ensures
 817                     // we're not mingling payments with refunds.
 818                     $scope.payment_amount = 0;
 819                 }
 820             }
 821         );
 822     }
 823
 824     // direct the user to the transaction details page
 825     $scope.showFullDetails = function(all) {
 826         var lastClicked = $scope.gridControls.contextMenuItem();
 827         if (lastClicked) {
 828             $location.path('/circ/patron/' +
 829                 patronSvc.current.id() + '/bill/' + lastClicked + '/statement');
 830         } else if (all[0]) {
 831             $location.path('/circ/patron/' +
 832                 patronSvc.current.id() + '/bill/' + all[0].id + '/statement');
 833         }
 834
 835     }
 836
 837     $scope.activateBill = function(xact) {
 838         $scope.showFullDetails([xact]);
 839     }
 840
 841 }])
 842
 843 /**
 844  * Displays details of a single transaction
 845  */
 846 .controller('XactDetailsCtrl',
 847        ['$scope','$q','$routeParams','egCore','egGridDataProvider','patronSvc','billSvc','egPromptDialog','egBilling','egConfirmDialog',
 848 function($scope,  $q , $routeParams , egCore , egGridDataProvider , patronSvc , billSvc , egPromptDialog , egBilling , egConfirmDialog ) {
 849
 850     $scope.initTab('bills', $routeParams.id);
 851     var xact_id = $routeParams.xact_id;
 852     $scope.xact_tab = $routeParams.xact_tab;
 853
 854     var xactGrid = $scope.xactGridControls = {
 855         setQuery : function() { return {xact : xact_id} },
 856         setSort : function() { return ['billing_ts'] }
 857     }
 858
 859     var paymentGrid = $scope.paymentGridControls = {
 860         setQuery : function() { return {xact : xact_id} },
 861         setSort : function() { return ['payment_ts'] }
 862     }
 863
 864     // -- actions
 865     $scope.voidBillings = function(bill_list) {
 866         var bill_ids = [];
 867         var cents = 0;
 868         angular.forEach(bill_list, function(b) {
 869             if (b.voided != 't') {
 870                 cents += b.amount * 100;
 871                 bill_ids.push(b.id)
 872             }
 873         });
 874
 875         if (bill_ids.length == 0) {
 876             // TODO: warn
 877             return;
 878         }
 879
 880         egCore.audio.play('warning.circ.void_billings_confirmation');
 881         egConfirmDialog.open(
 882             egCore.strings.CONFIRM_VOID_BILLINGS, '',
 883             {   billIds : ''+bill_ids,
 884                 amount : ''+(cents/100),
 885                 ok : function() {
 886                     billSvc.voidBills(bill_ids).then(function() {
 887                         // TODO? $scope.session_voided = ...
 888
 889                         // refresh bills and summary data
 890                         // note: no need to update payments
 891                         patronSvc.fetchUserStats();
 892
 893                         egBilling.fetchXact(xact_id).then(function(xact) {
 894                             $scope.xact = xact
 895                         });
 896
 897                         xactGrid.refresh();
 898                     });
 899                 }
 900             }
 901         );
 902     }
 903
 904     // batch-edit billing and payment notes, depending on 'type'
 905     function editNotes(selected, type) {
 906         var notes = selected.map(function(b){ return b.note }).join(',');
 907         var ids = selected.map(function(b){ return b.id });
 908
 909         // show the note edit prompt
 910         egPromptDialog.open(
 911             egCore.strings.EDIT_BILL_PAY_NOTE, notes, {
 912                 ids : ''+ids,
 913                 ok : function(value) {
 914
 915                     var func = 'updateBillNotes';
 916                     if (type == 'payment') func = 'updatePaymentNotes';
 917
 918                     billSvc[func](value, ids).then(function() {
 919                         if (type == 'payment') {
 920                             paymentGrid.refresh();
 921                         } else {
 922                             xactGrid.refresh();
 923                         }
 924                     });
 925                 }
 926             }
 927         );
 928     }
 929
 930     $scope.editBillNotes = function(selected) {
 931         editNotes(selected, 'bill');
 932     }
 933
 934     $scope.editPaymentNotes = function(selected) {
 935         editNotes(selected, 'payment');
 936     }
 937
 938     // -- retrieve our data
 939     if ($scope.xact_tab == 'statement') {
 940         //fetch combined billing statement data
 941         billSvc.fetchStatement(xact_id).then(function(statement) {
 942             //console.log(statement);
 943             $scope.statement_data = statement;
 944         });
 945     }
 946     $scope.total_circs = 0; // start with 0 instead of undefined
 947     egBilling.fetchXact(xact_id).then(function(xact) {
 948         $scope.xact = xact;
 949
 950         var copyId = xact.circulation().target_copy().id();
 951         var circ_count = 0;
 952         egCore.pcrud.search('circbyyr',
 953             {copy : copyId}, null, {atomic : true})
 954         .then(function(counts) {
 955             angular.forEach(counts, function(count) {
 956                 circ_count += Number(count.count());
 957             });
 958             $scope.total_circs = circ_count;
 959         });
 960         // set the title.  only needs to be done on initial page load
 961         if (xact.circulation()) {
 962             if (xact.circulation().target_copy().call_number().id() == -1) {
 963                 $scope.title = xact.circulation().target_copy().dummy_title();
 964             } else  {
 965                 // TODO: shared bib service?
 966                 $scope.title = xact.circulation().target_copy()
 967                     .call_number().record().simple_record().title();
 968                 $scope.title_id = xact.circulation().target_copy()
 969                     .call_number().record().id();
 970             }
 971         }
 972     });
 973 }])
 974
 975
 976 .controller('BillHistoryCtrl',
 977        ['$scope','$q','$routeParams','egCore','patronSvc','billSvc','egPromptDialog','$location',
 978 function($scope,  $q , $routeParams , egCore , patronSvc , billSvc , egPromptDialog , $location) {
 979
 980     $scope.initTab('bills', $routeParams.id);
 981     billSvc.userId = $routeParams.id;
 982     $scope.bill_tab = $routeParams.history_tab;
 983     $scope.totals = {};
 984
 985     // link page controller actions defined by sub-controllers here
 986     $scope.actions = {};
 987
 988     var start = new Date(); // now - 1 year
 989     start.setFullYear(start.getFullYear() - 1),
 990     $scope.dates = {
 991         xact_start : start,
 992         xact_finish : new Date()
 993     }
 994
 995     $scope.date_range = function() {
 996         var start = $scope.dates.xact_start.toISOString().replace(/T.*/,'');
 997         var end = $scope.dates.xact_finish.toISOString().replace(/T.*/,'');
 998         var today = new Date().toISOString().replace(/T.*/,'');
 999         if (end == today) end = 'now';
1000         return [start, end];
1001     }
1002 }])
1003
1004
1005 .controller('BillXactHistoryCtrl',
1006        ['$scope','$q','egCore','patronSvc','billSvc','egPromptDialog','$location','egBilling',
1007 function($scope,  $q , egCore , patronSvc , billSvc , egPromptDialog , $location , egBilling) {
1008
1009     // generate a grid query with the current date widget values.
1010     function current_grid_query() {
1011         return {
1012             '-or' : [
1013                 {'summary.balance_owed' : {'<>' : 0}},
1014                 {'summary.last_payment_ts' : {'<>' : null}}
1015             ],
1016             xact_start : {between : $scope.date_range()},
1017             usr : billSvc.userId
1018         }
1019     }
1020
1021     $scope.gridControls = {
1022         selectedItems : function(){return []},
1023         activateItem : function(item) {
1024             $scope.showFullDetails([item]);
1025         },
1026         // this sets the query on page load
1027         setQuery : current_grid_query
1028     }
1029
1030     $scope.$watch('dates.xact_start', function(new_date, old_date) {
1031         if (new_date !== old_date && new_date) {
1032             if (new_date.getTime() > $scope.dates.xact_finish.getTime()) {
1033                 $scope.dates.xact_finish = new_date;
1034             } else {
1035                 $scope.actions.apply_date_range();
1036             }
1037         }
1038     });
1039     $scope.$watch('dates.xact_finish', function(new_date, old_date) {
1040         if (new_date !== old_date && new_date) {
1041             if (new_date.getTime() < $scope.dates.xact_start.getTime()) {
1042                 $scope.dates.xact_start = new_date;
1043             } else {
1044                 $scope.actions.apply_date_range();
1045             }
1046         }
1047     });
1048
1049     $scope.actions.apply_date_range = function() {
1050         // tells the grid to re-draw itself with the new query
1051         $scope.gridControls.setQuery(current_grid_query());
1052     }
1053
1054     // TODO; move me to service
1055     function selected_payment_info() {
1056         var info = {owed : 0, billed : 0, paid : 0};
1057         angular.forEach($scope.gridControls.selectedItems(), function(item) {
1058             info.owed   += Number(item['summary.balance_owed']) * 100;
1059             info.billed += Number(item['summary.total_owed']) * 100;
1060             info.paid   += Number(item['summary.total_paid']) * 100;
1061         });
1062         info.owed /= 100;
1063         info.billed /= 100;
1064         info.paid /= 100;
1065         return info;
1066     }
1067
1068     $scope.totals.selected_billed = function() {
1069         return selected_payment_info().billed;
1070     }
1071     $scope.totals.selected_paid = function() {
1072         return selected_payment_info().paid;
1073     }
1074
1075     $scope.showFullDetails = function(all) {
1076         if (all[0])
1077             $location.path('/circ/patron/' +
1078                 patronSvc.current.id() + '/bill/' + all[0].id + '/statement');
1079     }
1080
1081     // For now, only adds billing to first selected item.
1082     // Could do batches later if needed
1083     $scope.addBilling = function(all) {
1084         if (all[0]) {
1085             egBilling.showBillDialog({
1086                 xact : egCore.idl.flatToNestedHash(all[0]),
1087                 patron : $scope.patron()
1088             }).then(function() {
1089                 $scope.gridControls.refresh();
1090                 patronSvc.fetchUserStats();
1091             })
1092         }
1093     }
1094
1095     $scope.printBills = function(selected) { // FIXME: refactor me
1096         if (!selected.length) return;
1097         // bills print receipt assumes nested hashes, but our grid
1098         // stores flattener data.  Fetch the selected xacts as
1099         // fleshed pcrud objects and hashify.
1100         // (Consider an alternate approach..)
1101         var ids = selected.map(function(t){ return t.id });
1102         var xacts = [];
1103         egCore.pcrud.search('mbt',
1104             {id : ids},
1105             {flesh : 5, flesh_fields : {
1106                 'mbt' : ['summary', 'circulation'],
1107                 'circ' : ['target_copy'],
1108                 'acp' : ['call_number'],
1109                 'acn' : ['record','owning_lib','prefix','suffix'],
1110                 'bre' : ['simple_record']
1111                 }
1112             },
1113             {authoritative : true}
1114         ).then(
1115             function() {
1116                 var cusr = patronSvc.current;
1117                 egCore.print.print({
1118                     context : 'receipt',
1119                     template : 'bills_historical',
1120                     scope : {
1121                         transactions : xacts,
1122                         current_location : egCore.idl.toHash(
1123                             egCore.org.get(egCore.auth.user().ws_ou())),
1124                         patron : {
1125                             prefix : cusr.prefix(),
1126                             pref_prefix : cusr.pref_prefix(),
1127                             pref_first_given_name : cusr.pref_first_given_name(),
1128                             pref_second_given_name : cusr.pref_second_given_name(),
1129                             pref_family_name : cusr.pref_family_name(),
1130                             pref_suffix : cusr.pref_suffix(),
1131                             first_given_name : cusr.first_given_name(),
1132                             second_given_name : cusr.second_given_name(),
1133                             family_name : cusr.family_name(),
1134                             suffix : cusr.suffix(),
1135                             card : { barcode : cusr.card().barcode() },
1136                             expire_date : cusr.expire_date(),
1137                             alias : cusr.alias(),
1138                             has_email : Boolean(cusr.email() && cusr.email().match(/.*@.*/)),
1139                             has_phone : Boolean(cusr.day_phone() || cusr.evening_phone() || cusr.other_phone())
1140                         }
1141                     }
1142                 });
1143             },
1144             null,
1145             function(xact) {
1146                 newXact = {
1147                     billing_total : xact.billing_total(),
1148                     billings : xact.billings(),
1149                     grocery : xact.grocery(),
1150                     id : xact.id(),
1151                     payment_total : xact.payment_total(),
1152                     payments : xact.payments(),
1153                     summary : egCore.idl.toHash(xact.summary()),
1154                     unrecovered : xact.unrecovered(),
1155                     xact_finish : xact.xact_finish(),
1156                     xact_start : xact.xact_start(),
1157                 }
1158                 if (xact.circulation()) {
1159                     newXact.copy_barcode = xact.circulation().target_copy().barcode();
1160                     newXact.title = xact.circulation().target_copy().call_number().record().simple_record().title();
1161                     newXact.call_number = {
1162                         label : xact.circulation().target_copy().call_number().label(),
1163                                     prefix : xact.circulation().target_copy().call_number().prefix().label(),
1164                                     suffix : xact.circulation().target_copy().call_number().suffix().label(),
1165                         owning_lib : {
1166                             name : xact.circulation().target_copy().call_number().owning_lib().name(),
1167                             shortname : xact.circulation().target_copy().call_number().owning_lib().shortname()
1168                         }
1169                     }
1170                 }
1171                 xacts.push(newXact);
1172             }
1173         );
1174     }
1175 }])
1176
1177 .controller('BillPaymentHistoryCtrl',
1178        ['$scope','$q','egCore','patronSvc','billSvc','$location',
1179 function($scope,  $q , egCore , patronSvc , billSvc , $location) {
1180
1181     // generate a grid query with the current date widget values.
1182     function current_grid_query() {
1183         return {
1184             'payment_ts' : {between : $scope.date_range()},
1185             'xact.usr' : billSvc.userId
1186         }
1187     }
1188
1189     $scope.gridControls = {
1190         selectedItems : function(){return []},
1191         activateItem : function(item) {
1192             $scope.showFullDetails([item]);
1193         },
1194         setSort : function() {
1195             return [{'payment_ts' : 'DESC'}, 'id'];
1196         },
1197         setQuery : current_grid_query
1198     }
1199
1200     $scope.$watch('dates.xact_start', function(new_date, old_date) {
1201         if (new_date !== old_date && new_date) {
1202             if (new_date.getTime() > $scope.dates.xact_finish.getTime()) {
1203                 $scope.dates.xact_finish = new_date;
1204             } else {
1205                 $scope.actions.apply_date_range();
1206             }
1207         }
1208     });
1209     $scope.$watch('dates.xact_finish', function(new_date, old_date) {
1210         if (new_date !== old_date && new_date) {
1211             if (new_date.getTime() < $scope.dates.xact_start.getTime()) {
1212                 $scope.dates.xact_start = new_date;
1213             } else {
1214                 $scope.actions.apply_date_range();
1215             }
1216         }
1217     });
1218
1219     $scope.actions.apply_date_range = function() {
1220         // tells the grid to re-draw itself with the new query
1221         $scope.gridControls.setQuery(current_grid_query());
1222     }
1223
1224     $scope.showFullDetails = function(all) {
1225         if (all[0])
1226             $location.path('/circ/patron/' +
1227                 patronSvc.current.id() + '/bill/' + all[0]['xact.id'] + '/statement');
1228     }
1229
1230     $scope.totals.selected_paid = function() {
1231         var paid = 0;
1232         angular.forEach($scope.gridControls.selectedItems(), function(payment) {
1233             paid += Number(payment.amount) * 100;
1234         });
1235         return paid / 100;
1236     }
1237 }])
1238
1239
1240