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','ui.circ.billing.amount_warn','ui.circ.billing.amount_limit','circ.staff_client.do_not_auto_attempt_print']
  17         ).then(function(s) {return service.settings = s});
  18     }
  19
  20     // user billing summary
  21     service.fetchSummary = function() {
  22         return egCore.pcrud.retrieve(
  23             'mous', service.userId, {}, {authoritative : true})
  24         .then(function(summary) {return service.summary = summary})
  25     }
  26
  27     service.applyPayment = function(type, payments, note, check, cc_args) {
  28         return egCore.net.request(
  29             'open-ils.circ',
  30             'open-ils.circ.money.payment',
  31             egCore.auth.token(), {
  32                 userid : service.userId,
  33                 note : note || '',
  34                 payment_type : type,
  35                 check_number : check,
  36                 payments : payments,
  37                 patron_credit : 0,
  38                 cc_args : cc_args
  39             },
  40             patronSvc.current.last_xact_id()
  41         ).then(function(resp) {
  42             console.debug('payments: ' + js2JSON(resp));
  43             var total = 0; angular.forEach(payments,function(p) { total += p[1]; });
  44             var msg;
  45             switch(type) {
  46                 case 'cash_payment' : msg = egCore.strings.EG_WORK_LOG_CASH_PAYMENT; break;
  47                 case 'check_payment' : msg = egCore.strings.EG_WORK_LOG_CHECK_PAYMENT; break;
  48                 case 'credit_card_payment' : msg = egCore.strings.EG_WORK_LOG_CREDIT_CARD_PAYMENT; break;
  49                 case 'credit_payment' : msg = egCore.strings.EG_WORK_LOG_CREDIT_PAYMENT; break;
  50                 case 'work_payment' : msg = egCore.strings.EG_WORK_LOG_WORK_PAYMENT; break;
  51                 case 'forgive_payment' : msg = egCore.strings.EG_WORK_LOG_FORGIVE_PAYMENT; break;
  52                 case 'goods_payment' : msg = egCore.strings.EG_WORK_LOG_GOODS_PAYMENT; break;
  53             }
  54             egWorkLog.record(
  55                 msg,{
  56                     'action' : 'paid_bill',
  57                     'patron_id' : service.userId,
  58                     'total_amount' : total
  59                 }
  60             );
  61             if (evt = egCore.evt.parse(resp))
  62                 return alert(evt);
  63
  64             // payment API returns the update xact id so we can track it
  65             // for future payments without having to refresh the user.
  66             patronSvc.current.last_xact_id(resp.last_xact_id);
  67             return resp.payments;
  68         });
  69     }
  70
  71     service.fetchBills = function(xact_id) {
  72         var bills = [];
  73         return egCore.pcrud.search('mb',
  74             {xact : xact_id}, null,
  75             {authoritative : true}
  76         ).then(
  77             function() {return bills},
  78             null,
  79             function(bill) {bills.push(bill); return bill}
  80         );
  81     }
  82
  83     // TODO: no longer needed?
  84     service.fetchPayments = function(xact_id) {
  85         return egCore.net.request(
  86             'open-ils.circ',
  87             'open-ils.circ.money.payment.retrieve.all.authoritative',
  88             egCore.auth.token(), xact_id
  89         );
  90     }
  91
  92     service.voidBills = function(bill_ids) {
  93         return egCore.net.requestWithParamList(
  94             'open-ils.circ',
  95             'open-ils.circ.money.billing.void',
  96             [egCore.auth.token()].concat(bill_ids)
  97         ).then(function(resp) {
  98             if (evt = egCore.evt.parse(resp)) return alert(evt);
  99             return resp;
 100         });
 101     }
 102
 103     service.adjustBillsToZero = function(bill_ids) {
 104         return egCore.net.request(
 105             'open-ils.circ',
 106             'open-ils.circ.money.billable_xact.adjust_to_zero',
 107             egCore.auth.token(),
 108             bill_ids
 109         ).then(function(resp) {
 110             if (evt = egCore.evt.parse(resp)) return alert(evt);
 111             return resp;
 112         });
 113     }
 114
 115     service.updateBillNotes = function(note, ids) {
 116         return egCore.net.requestWithParamList(
 117             'open-ils.circ',
 118             'open-ils.circ.money.billing.note.edit',
 119             [egCore.auth.token(), note].concat(ids)
 120         ).then(function(resp) {
 121             if (evt = egCore.evt.parse(resp)) return alert(evt);
 122             return resp;
 123         });
 124     }
 125
 126     service.updatePaymentNotes = function(note, ids) {
 127         return egCore.net.requestWithParamList(
 128             'open-ils.circ',
 129             'open-ils.circ.money.payment.note.edit',
 130             [egCore.auth.token(), note].concat(ids)
 131         ).then(function(resp) {
 132             if (evt = egCore.evt.parse(resp)) return alert(evt);
 133             return resp;
 134         });
 135     }
 136
 137     return service;
 138 }])
 139
 140
 141 /**
 142  * Manages Bills
 143  */
 144 .controller('PatronBillsCtrl',
 145        ['$scope','$q','$routeParams','egCore','egConfirmDialog','$location',
 146         'egGridDataProvider','billSvc','patronSvc','egPromptDialog', 'egAlertDialog',
 147         'egBilling','$uibModal',
 148 function($scope , $q , $routeParams , egCore , egConfirmDialog , $location,
 149          egGridDataProvider , billSvc , patronSvc , egPromptDialog, egAlertDialog,
 150          egBilling , $uibModal) {
 151
 152     $scope.initTab('bills', $routeParams.id);
 153     billSvc.userId = $routeParams.id;
 154
 155     // set up some defaults
 156     $scope.check_number = null;
 157     $scope.payment_amount = null;
 158     $scope.session_voided = 0;
 159     $scope.payment_type = 'cash_payment';
 160     $scope.focus_payment = true;
 161     $scope.annotate_payment = false;
 162     $scope.receipt_count = 1;
 163     $scope.receipt_on_pay = { isChecked: false };
 164     $scope.warn_amount = 1000;
 165     $scope.max_amount = 100000;
 166     $scope.amount_verified = false;
 167     $scope.disable_auto_print = false;
 168
 169     // check receipt_on_pay setting default persisted
 170     egCore.hatch.getItem('circ.bills.receiptonpay')
 171                 .then(function(rcptOnPay){
 172                     if (rcptOnPay) $scope.receipt_on_pay.isChecked = rcptOnPay;
 173                 });
 174
 175     // pre-define list-returning funcs in case we access them
 176     // before the grid instantiates
 177     $scope.gridControls = {
 178         focusRowSelector : false,
 179         selectedItems : function(){return []},
 180         allItems : function(){return []},
 181         itemRetrieved : function(item) {
 182             item.payment_pending = 0;
 183         },
 184         activateItem : function(item) {
 185             $scope.showFullDetails([item]);
 186         },
 187         setQuery : function() {
 188             return {
 189                 usr : billSvc.userId,
 190                 xact_finish : null,
 191                 'summary.balance_owed' : {'<>' : 0}
 192             }
 193         },
 194         setSort : function() {
 195             return ['xact_start'];
 196         }
 197     }
 198
 199     billSvc.fetchSummary().then(function(s) {$scope.summary = s});
 200
 201     // given a payment amount, determines how much of that is applied
 202     // to selected transactions and how much is left over (change).
 203     function pending_payment_info() {
 204         var amt = $scope.payment_amount || 0;
 205         if (amt >= $scope.owed_selected()) {
 206             return {
 207                 payment : $scope.owed_selected(),
 208                 change : amt - $scope.owed_selected()
 209             }
 210         }
 211         return {payment : amt, change : 0};
 212     }
 213
 214     // calculates amount owed, billed, and paid for selected items
 215     // TODO: move me to service
 216     function selected_payment_info() {
 217         var info = {owed : 0, billed : 0, paid : 0};
 218         angular.forEach($scope.gridControls.selectedItems(), function(item) {
 219             info.owed   += Number(item['summary.balance_owed']) * 100;
 220             info.billed += Number(item['summary.total_owed']) * 100;
 221             info.paid   += Number(item['summary.total_paid']) * 100;
 222         });
 223         info.owed /= 100;
 224         info.billed /= 100;
 225         info.paid /= 100;
 226         return info;
 227     }
 228
 229     $scope.pending_payment = function() {
 230         return pending_payment_info().payment;
 231     }
 232     $scope.pending_change = function() {
 233         return pending_payment_info().change;
 234     }
 235     $scope.owed_selected = function() {
 236         return selected_payment_info().owed;
 237     }
 238     $scope.billed_selected = function() {
 239         return selected_payment_info().billed;
 240     }
 241     $scope.paid_selected = function() {
 242         return selected_payment_info().paid;
 243     }
 244     $scope.refunds_available = function() {
 245         var amount = 0;
 246         angular.forEach($scope.gridControls.allItems(), function(item) {
 247             if (item['summary.balance_owed'] < 0)
 248                 amount += item['summary.balance_owed'] * 100;
 249         });
 250         return -(amount / 100);
 251     }
 252     $scope.invalid_check_number = function() {
 253         return $scope.payment_type == 'check_payment' && ! $scope.check_number;
 254     }
 255
 256     // update the item.payment_pending value each time the user
 257     // selects different transactions to pay against.
 258     $scope.$watch(
 259         function() {return $scope.gridControls.selectedItems()},
 260         function() {updatePendingColumn()},
 261         true
 262     );
 263
 264     // update the item.payment_pending for each (selected)
 265     // transaction any time the user-entered payment amount is modified
 266     $scope.$watch('payment_amount', updatePendingColumn);
 267
 268     // updates the value of the payment_pending column in the grid.
 269     // This has to be managed manually since the display value in the grid
 270     // is derived from the value on the stored item and not the contents
 271     // of our local scope variables.
 272     function updatePendingColumn() {
 273         // reset all to zero..
 274         angular.forEach($scope.gridControls.allItems(),
 275             function(item) {item.payment_pending = 0});
 276
 277         var payment_amount = $scope.pending_payment();
 278
 279         var selected = $scope.gridControls.selectedItems();
 280         for (var i = 0; i < selected.length; i++) { // for/break
 281             var item = selected[i];
 282             var owed = Number(item['summary.balance_owed']);
 283
 284             if (payment_amount > owed) {
 285                 // pending payment exceeds balance of current item.
 286                 // pay the entire item.
 287                 item.payment_pending = owed;
 288                 payment_amount -= owed;
 289
 290             } else {
 291                 // balance owed on the current item matches or exceeds
 292                 // the pending payment.  Apply the full remainder of
 293                 // the payment to this item.. and we're done.
 294                 item.payment_pending = payment_amount;
 295                 break;
 296             }
 297         }
 298     }
 299
 300     // builds payment arrays ([xact_id, ammount]) for all transactions
 301     // which have a pending payment amount.
 302     function generatePayments() {
 303         var payments = [];
 304         angular.forEach($scope.gridControls.selectedItems(), function(item) {
 305             if (item.payment_pending == 0) return;
 306             payments.push([item.id, item.payment_pending]);
 307         });
 308         return payments;
 309     }
 310
 311     function refreshDisplay() {
 312         patronSvc.fetchUserStats();
 313         billSvc.fetchSummary().then(function(s) {$scope.summary = s});
 314         $scope.payment_amount = null;
 315         $scope.gridControls.refresh();
 316     }
 317
 318     // generates payments, collects user note if needed, and sends payment
 319     // to server.
 320     function sendPayment(note, cc_args) {
 321         var make_payments = generatePayments();
 322         billSvc.applyPayment($scope.payment_type,
 323             make_payments, note, $scope.check_number, cc_args)
 324         .then(function(payment_ids) {
 325
 326             if (!$scope.disable_auto_print && $scope.receipt_on_pay.isChecked) {
 327                 printReceipt(
 328                     $scope.payment_type, payment_ids, make_payments, note);
 329             }
 330
 331             refreshDisplay();
 332         })
 333     }
 334
 335     $scope.onReceiptOnPayChanged = function(){
 336         egCore.hatch.setItem('circ.bills.receiptonpay', $scope.receipt_on_pay.isChecked);
 337     }
 338
 339     function printReceipt(type, payment_ids, payments_made, note) {
 340         var payment_blobs = [];
 341         angular.forEach(payments_made, function(payment) {
 342             var xact_id = payment[0];
 343
 344             // find the original transaction in the grid..
 345             var xact = $scope.gridControls.allItems().filter(
 346                 function(item) {return item.id == xact_id})[0];
 347
 348             payment_blobs.push({
 349                 xact : egCore.idl.flatToNestedHash(xact),
 350                 amount : payment[1]
 351             });
 352         });
 353
 354         console.log(js2JSON(payment_blobs[0]));
 355
 356         // page data not yet refreshed, capture data from current scope
 357         var print_data = {
 358             payment_type : type,
 359             payment_note : note,
 360             previous_balance : Number($scope.summary.balance_owed()),
 361             payment_total : Number($scope.payment_amount),
 362             payment_applied : $scope.pending_payment(),
 363             amount_voided : Number($scope.session_voided),
 364             change_given : $scope.pending_change(),
 365             payments : payment_blobs,
 366             current_location : egCore.idl.toHash(
 367                 egCore.org.get(egCore.auth.user().ws_ou()))
 368         }
 369
 370         print_data.new_balance = (
 371             print_data.previous_balance * 100 -
 372             print_data.payment_applied * 100) / 100;
 373
 374         for (var i = 0; i < $scope.receipt_count; i++) {
 375             egCore.print.print({
 376                 context : 'receipt',
 377                 template : 'bill_payment',
 378                 scope : print_data
 379             });
 380         }
 381     }
 382
 383     $scope.showHistory = function() {
 384         $location.path('/circ/patron/' +
 385             patronSvc.current.id() + '/bill_history/transactions');
 386     }
 387
 388     // For now, only adds billing to first selected item.
 389     // Could do batches later if needed
 390     $scope.addBilling = function(all) {
 391         if (all[0]) {
 392             egBilling.showBillDialog({
 393                 xact : egCore.idl.flatToNestedHash(all[0]),
 394                 patron : $scope.patron()
 395             }).then(refreshDisplay);
 396         }
 397     }
 398
 399     $scope.showBillDialog = function($event) {
 400         egBilling.showBillDialog({
 401             patron : $scope.patron()
 402         }).then(refreshDisplay);
 403     }
 404
 405     // Select refunds adds all refunds to the existing selection.
 406     // It does not /only/ select refunds
 407     $scope.selectRefunds = function() {
 408         var ids = $scope.gridControls.selectedItems().map(
 409             function(i) { return i.id });
 410         angular.forEach($scope.gridControls.allItems(), function(item) {
 411             if (Number(item['summary.balance_owed']) < 0)
 412                 ids.push(item.id);
 413         });
 414         $scope.gridControls.selectItems(ids);
 415     }
 416
 417     // -------------
 418     // determine on initial page load when all of the grid rows should
 419     // be selected.
 420     var selectOnLoad = true;
 421     billSvc.fetchBillSettings().then(function(s) {
 422         if (s['ui.circ.billing.uncheck_bills_and_unfocus_payment_box']) {
 423             $scope.focus_payment = false; // de-focus the payment box
 424             $scope.gridControls.focusRowSelector = true;
 425             selectOnLoad = false;
 426             // if somehow the grid finishes rendering before our settings
 427             // arrive, manually de-select everything.
 428             $scope.gridControls.selectItems([]);
 429         }
 430         if (s['ui.circ.billing.amount_warn']) {
 431             $scope.warn_amount = Number(s['ui.circ.billing.amount_warn']);
 432         }
 433         if (s['ui.circ.billing.amount_limit']) {
 434             $scope.max_amount = Number(s['ui.circ.billing.amount_limit']);
 435         }
 436         if (s['circ.staff_client.do_not_auto_attempt_print'] && angular.isArray(s['circ.staff_client.do_not_auto_attempt_print'])) {
 437             $scope.disable_auto_print = Boolean(
 438                 s['circ.staff_client.do_not_auto_attempt_print'].indexOf('Bill Pay') > -1
 439             );
 440         }
 441     });
 442
 443     $scope.gridControls.allItemsRetrieved = function() {
 444         if (selectOnLoad) {
 445             selectOnLoad = false; // only for initial controller load.
 446             // select all non-refund items
 447             $scope.gridControls.selectItems(
 448                 $scope.gridControls.allItems()
 449                 .filter(function(i) {return i['summary.balance_owed'] > 0})
 450                 .map(function(i){return i.id})
 451             );
 452         }
 453     }
 454     // -------------
 455
 456
 457     $scope.printBills = function(selected) {
 458         if (!selected.length) return;
 459         // bills print receipt assumes nested hashes, but our grid
 460         // stores flattener data.  Fetch the selected xacts as
 461         // fleshed pcrud objects and hashify.
 462         // (Consider an alternate approach..)
 463         var ids = selected.map(function(t){ return t.id });
 464         var xacts = [];
 465         egCore.pcrud.search('mbt',
 466             {id : ids},
 467             {flesh : 1, flesh_fields : {'mbt' : ['summary']}},
 468             {authoritative : true}
 469         ).then(
 470             function() {
 471                 egCore.print.print({
 472                     context : 'receipt',
 473                     template : 'bills_current',
 474                     scope : {
 475                         transactions : xacts,
 476                         current_location : egCore.idl.toHash(
 477                             egCore.org.get(egCore.auth.user().ws_ou()))
 478                     }
 479                 });
 480             },
 481             null,
 482             function(xact) {
 483                 xacts.push(egCore.idl.toHash(xact));
 484             }
 485         );
 486     }
 487
 488     $scope.applyPayment = function() {
 489
 490         if ($scope.payment_amount > $scope.max_amount ) {
 491             egAlertDialog.open(
 492                 egCore.strings.PAYMENT_OVER_MAX,
 493                 {   max_amount : ''+$scope.max_amount,
 494                     ok : function() {
 495                         $scope.payment_amount = 0;
 496                     }
 497                 }
 498             );
 499             return;
 500         }
 501
 502         verify_payment_amount().then(
 503             function() { // amount confirmed
 504                 add_payment_note().then(function(pay_note) {
 505                     add_cc_args().then(function(cc_args) {
 506                         sendPayment(pay_note, cc_args);
 507                     })
 508                 });
 509             },
 510             function() { // amount rejected
 511                 console.warn('payment amount rejected');
 512                 $scope.payment_amount = 0;
 513             }
 514         );
 515     }
 516
 517     function verify_payment_amount() {
 518         if ($scope.payment_amount < $scope.warn_amount)
 519             return $q.when();
 520
 521         return egConfirmDialog.open(
 522             egCore.strings.PAYMENT_WARN_AMOUNT_TITLE,
 523             egCore.strings.PAYMENT_WARN_AMOUNT,
 524             {payment_amount : ''+$scope.payment_amount}
 525         ).result;
 526     }
 527
 528     function add_payment_note() {
 529         if (!$scope.annotate_payment) return $q.when();
 530         return egPromptDialog.open(
 531             egCore.strings.ANNOTATE_PAYMENT_MSG, '').result;
 532     }
 533
 534     function add_cc_args() {
 535         if ($scope.payment_type != 'credit_card_payment')
 536             return $q.when();
 537
 538         return $uibModal.open({
 539             templateUrl : './circ/patron/t_cc_payment_dialog',
 540             controller : [
 541                         '$scope','$uibModalInstance',
 542                 function($scope , $uibModalInstance) {
 543
 544                     $scope.context = {
 545                         cc : {
 546                             where_process : '1', // internal=1 ; external=0
 547                             type : 'VISA', // external only
 548                             billing_first : patronSvc.current.first_given_name(),
 549                             billing_last : patronSvc.current.family_name()
 550                         }
 551                     }
 552
 553                     var addr = patronSvc.current.billing_address() ||
 554                         patronSvc.current.mailing_address();
 555                     if (addr) {
 556                         var cc = $scope.context.cc;
 557                         cc.billing_address = addr.street1() +
 558                             (addr.street2() ? ' ' + addr.street2() : '');
 559                         cc.billing_city = addr.city();
 560                         cc.billing_state = addr.state();
 561                         cc.billing_zip = addr.post_code();
 562                     }
 563
 564                     $scope.ok = function() {
 565                         $uibModalInstance.close($scope.context.cc);
 566                     }
 567
 568                     $scope.cancel = function() {
 569                         $uibModalInstance.dismiss();
 570                     }
 571                 }
 572             ]
 573         }).result;
 574     }
 575
 576     $scope.voidAllBillings = function(items) {
 577         var promises = [];
 578         var bill_ids = [];
 579         var cents = 0;
 580         angular.forEach(items, function(item) {
 581             promises.push(
 582                 billSvc.fetchBills(item.id).then(function(bills) {
 583                     angular.forEach(bills, function(b) {
 584                         if (b.voided() != 't') {
 585                             cents += b.amount() * 100;
 586                             bill_ids.push(b.id())
 587                         }
 588                     });
 589
 590                     if (bill_ids.length == 0) {
 591                         // TODO: warn
 592                         return;
 593                     }
 594
 595                 })
 596             );
 597         });
 598
 599         $q.all(promises).then(function(){
 600             egCore.audio.play('warning.circ.void_billings_confirmation');
 601             egConfirmDialog.open(
 602                 egCore.strings.CONFIRM_VOID_BILLINGS, '',
 603                 {   billIds : ''+bill_ids,
 604                     amount : ''+(cents/100),
 605                     ok : function() {
 606                         billSvc.voidBills(bill_ids).then(function() {
 607                             $scope.session_voided =
 608                                 ($scope.session_voided * 100 + cents) / 100;
 609                             refreshDisplay();
 610                         });
 611                     }
 612                 }
 613             );
 614         });
 615     }
 616
 617     $scope.adjustToZero = function(items) {
 618         if (items.length == 0) return;
 619
 620         var ids = items.map(function(item) {return item.id});
 621
 622         egCore.audio.play('warning.circ.adjust_to_zero_confirmation');
 623         egConfirmDialog.open(
 624             egCore.strings.CONFIRM_ADJUST_TO_ZERO, '',
 625             {   xactIds : ''+ids,
 626                 ok : function() {
 627                     billSvc.adjustBillsToZero(ids).then(function() {
 628                         refreshDisplay();
 629                     });
 630                 }
 631             }
 632         );
 633
 634     }
 635
 636     // note this is functionally equivalent to selecting a neg. transaction
 637     // then clicking Apply Payment -- this just adds a speed bump (ditto
 638     // the XUL client).
 639     $scope.refundXact = function(all) {
 640         var items = all.filter(function(item) {
 641             return item['summary.balance_owed'] < 0
 642         });
 643
 644         if (items.length == 0) return;
 645
 646         var ids = items.map(function(item) {return item.id});
 647
 648         egCore.audio.play('warning.circ.refund_confirmation');
 649         egConfirmDialog.open(
 650             egCore.strings.CONFIRM_REFUND_PAYMENT, '',
 651             {   xactIds : ''+ids,
 652                 ok : function() {
 653                     // reset the received payment amount.  this ensures
 654                     // we're not mingling payments with refunds.
 655                     $scope.payment_amount = 0;
 656                 }
 657             }
 658         );
 659     }
 660
 661     // direct the user to the transaction details page
 662     $scope.showFullDetails = function(all) {
 663         if (all[0])
 664             $location.path('/circ/patron/' +
 665                 patronSvc.current.id() + '/bill/' + all[0].id);
 666     }
 667
 668     $scope.activateBill = function(xact) {
 669         $scope.showFullDetails([xact]);
 670     }
 671
 672 }])
 673
 674 /**
 675  * Displays details of a single transaction
 676  */
 677 .controller('XactDetailsCtrl',
 678        ['$scope','$q','$routeParams','egCore','egGridDataProvider','patronSvc','billSvc','egPromptDialog','egBilling','egConfirmDialog',
 679 function($scope,  $q , $routeParams , egCore , egGridDataProvider , patronSvc , billSvc , egPromptDialog , egBilling , egConfirmDialog ) {
 680
 681     $scope.initTab('bills', $routeParams.id);
 682     var xact_id = $routeParams.xact_id;
 683
 684     var xactGrid = $scope.xactGridControls = {
 685         setQuery : function() { return {xact : xact_id} },
 686         setSort : function() { return ['billing_ts'] }
 687     }
 688
 689     var paymentGrid = $scope.paymentGridControls = {
 690         setQuery : function() { return {xact : xact_id} },
 691         setSort : function() { return ['payment_ts'] }
 692     }
 693
 694     // -- actions
 695     $scope.voidBillings = function(bill_list) {
 696         var bill_ids = [];
 697         var cents = 0;
 698         angular.forEach(bill_list, function(b) {
 699             if (b.voided != 't') {
 700                 cents += b.amount * 100;
 701                 bill_ids.push(b.id)
 702             }
 703         });
 704
 705         if (bill_ids.length == 0) {
 706             // TODO: warn
 707             return;
 708         }
 709
 710         egCore.audio.play('warning.circ.void_billings_confirmation');
 711         egConfirmDialog.open(
 712             egCore.strings.CONFIRM_VOID_BILLINGS, '',
 713             {   billIds : ''+bill_ids,
 714                 amount : ''+(cents/100),
 715                 ok : function() {
 716                     billSvc.voidBills(bill_ids).then(function() {
 717                         // TODO? $scope.session_voided = ...
 718
 719                         // refresh bills and summary data
 720                         // note: no need to update payments
 721                         patronSvc.fetchUserStats();
 722
 723                         egBilling.fetchXact(xact_id).then(function(xact) {
 724                             $scope.xact = xact
 725                         });
 726
 727                         xactGrid.refresh();
 728                     });
 729                 }
 730             }
 731         );
 732     }
 733
 734     // batch-edit billing and payment notes, depending on 'type'
 735     function editNotes(selected, type) {
 736         var notes = selected.map(function(b){ return b.note }).join(',');
 737         var ids = selected.map(function(b){ return b.id });
 738
 739         // show the note edit prompt
 740         egPromptDialog.open(
 741             egCore.strings.EDIT_BILL_PAY_NOTE, notes, {
 742                 ids : ''+ids,
 743                 ok : function(value) {
 744
 745                     var func = 'updateBillNotes';
 746                     if (type == 'payment') func = 'updatePaymentNotes';
 747
 748                     billSvc[func](value, ids).then(function() {
 749                         if (type == 'payment') {
 750                             paymentGrid.refresh();
 751                         } else {
 752                             xactGrid.refresh();
 753                         }
 754                     });
 755                 }
 756             }
 757         );
 758     }
 759
 760     $scope.editBillNotes = function(selected) {
 761         editNotes(selected, 'bill');
 762     }
 763
 764     $scope.editPaymentNotes = function(selected) {
 765         editNotes(selected, 'payment');
 766     }
 767
 768     // -- retrieve our data
 769     $scope.total_circs = 0; // start with 0 instead of undefined
 770     egBilling.fetchXact(xact_id).then(function(xact) {
 771         $scope.xact = xact;
 772
 773         var copyId = xact.circulation().target_copy().id();
 774         var circ_count = 0;
 775         egCore.pcrud.search('circbyyr',
 776             {copy : copyId}, null, {atomic : true})
 777         .then(function(counts) {
 778             angular.forEach(counts, function(count) {
 779                 circ_count += Number(count.count());
 780             });
 781             $scope.total_circs = circ_count;
 782         });
 783         // set the title.  only needs to be done on initial page load
 784         if (xact.circulation()) {
 785             if (xact.circulation().target_copy().call_number().id() == -1) {
 786                 $scope.title = xact.circulation().target_copy().dummy_title();
 787             } else  {
 788                 // TODO: shared bib service?
 789                 $scope.title = xact.circulation().target_copy()
 790                     .call_number().record().simple_record().title();
 791                 $scope.title_id = xact.circulation().target_copy()
 792                     .call_number().record().id();
 793             }
 794         }
 795     });
 796 }])
 797
 798
 799 .controller('BillHistoryCtrl',
 800        ['$scope','$q','$routeParams','egCore','patronSvc','billSvc','egPromptDialog','$location',
 801 function($scope,  $q , $routeParams , egCore , patronSvc , billSvc , egPromptDialog , $location) {
 802
 803     $scope.initTab('bills', $routeParams.id);
 804     billSvc.userId = $routeParams.id;
 805     $scope.bill_tab = $routeParams.history_tab;
 806     $scope.totals = {};
 807
 808     // link page controller actions defined by sub-controllers here
 809     $scope.actions = {};
 810
 811     var start = new Date(); // now - 1 year
 812     start.setFullYear(start.getFullYear() - 1),
 813     $scope.dates = {
 814         xact_start : start,
 815         xact_finish : new Date()
 816     }
 817
 818     $scope.date_range = function() {
 819         var start = $scope.dates.xact_start.toISOString().replace(/T.*/,'');
 820         var end = $scope.dates.xact_finish.toISOString().replace(/T.*/,'');
 821         var today = new Date().toISOString().replace(/T.*/,'');
 822         if (end == today) end = 'now';
 823         return [start, end];
 824     }
 825 }])
 826
 827
 828 .controller('BillXactHistoryCtrl',
 829        ['$scope','$q','egCore','patronSvc','billSvc','egPromptDialog','$location','egBilling',
 830 function($scope,  $q , egCore , patronSvc , billSvc , egPromptDialog , $location , egBilling) {
 831
 832     // generate a grid query with the current date widget values.
 833     function current_grid_query() {
 834         return {
 835             '-or' : [
 836                 {'summary.balance_owed' : {'<>' : 0}},
 837                 {'summary.last_payment_ts' : {'<>' : null}}
 838             ],
 839             xact_start : {between : $scope.date_range()},
 840             usr : billSvc.userId
 841         }
 842     }
 843
 844     $scope.gridControls = {
 845         selectedItems : function(){return []},
 846         activateItem : function(item) {
 847             $scope.showFullDetails([item]);
 848         },
 849         // this sets the query on page load
 850         setQuery : current_grid_query
 851     }
 852
 853     $scope.actions.apply_date_range = function() {
 854         // tells the grid to re-draw itself with the new query
 855         $scope.gridControls.setQuery(current_grid_query());
 856     }
 857
 858     // TODO; move me to service
 859     function selected_payment_info() {
 860         var info = {owed : 0, billed : 0, paid : 0};
 861         angular.forEach($scope.gridControls.selectedItems(), function(item) {
 862             info.owed   += Number(item['summary.balance_owed']) * 100;
 863             info.billed += Number(item['summary.total_owed']) * 100;
 864             info.paid   += Number(item['summary.total_paid']) * 100;
 865         });
 866         info.owed /= 100;
 867         info.billed /= 100;
 868         info.paid /= 100;
 869         return info;
 870     }
 871
 872     $scope.totals.selected_billed = function() {
 873         return selected_payment_info().billed;
 874     }
 875     $scope.totals.selected_paid = function() {
 876         return selected_payment_info().paid;
 877     }
 878
 879     $scope.showFullDetails = function(all) {
 880         if (all[0])
 881             $location.path('/circ/patron/' +
 882                 patronSvc.current.id() + '/bill/' + all[0].id);
 883     }
 884
 885     // For now, only adds billing to first selected item.
 886     // Could do batches later if needed
 887     $scope.addBilling = function(all) {
 888         if (all[0]) {
 889             egBilling.showBillDialog({
 890                 xact : egCore.idl.flatToNestedHash(all[0]),
 891                 patron : $scope.patron()
 892             }).then(function() {
 893                 $scope.gridControls.refresh();
 894                 patronSvc.fetchUserStats();
 895             })
 896         }
 897     }
 898
 899     $scope.printBills = function(selected) { // FIXME: refactor me
 900         if (!selected.length) return;
 901         // bills print receipt assumes nested hashes, but our grid
 902         // stores flattener data.  Fetch the selected xacts as
 903         // fleshed pcrud objects and hashify.
 904         // (Consider an alternate approach..)
 905         var ids = selected.map(function(t){ return t.id });
 906         var xacts = [];
 907         egCore.pcrud.search('mbt',
 908             {id : ids},
 909             {flesh : 1, flesh_fields : {'mbt' : ['summary']}},
 910             {authoritative : true}
 911         ).then(
 912             function() {
 913                 egCore.print.print({
 914                     context : 'receipt',
 915                     template : 'bills_historical',
 916                     scope : {
 917                         transactions : xacts,
 918                         current_location : egCore.idl.toHash(
 919                             egCore.org.get(egCore.auth.user().ws_ou()))
 920                     }
 921                 });
 922             },
 923             null,
 924             function(xact) {
 925                 xacts.push(egCore.idl.toHash(xact));
 926             }
 927         );
 928     }
 929
 930
 931 }])
 932
 933 .controller('BillPaymentHistoryCtrl',
 934        ['$scope','$q','egCore','patronSvc','billSvc','$location',
 935 function($scope,  $q , egCore , patronSvc , billSvc , $location) {
 936
 937     // generate a grid query with the current date widget values.
 938     function current_grid_query() {
 939         return {
 940             'payment_ts' : {between : $scope.date_range()},
 941             'xact.usr' : billSvc.userId
 942         }
 943     }
 944
 945     $scope.gridControls = {
 946         selectedItems : function(){return []},
 947         activateItem : function(item) {
 948             $scope.showFullDetails([item]);
 949         },
 950         setSort : function() {
 951             return [{'payment_ts' : 'DESC'}, 'id'];
 952         },
 953         setQuery : current_grid_query
 954     }
 955
 956     $scope.actions.apply_date_range = function() {
 957         // tells the grid to re-draw itself with the new query
 958         $scope.gridControls.setQuery(current_grid_query());
 959     }
 960
 961     $scope.showFullDetails = function(all) {
 962         if (all[0])
 963             $location.path('/circ/patron/' +
 964                 patronSvc.current.id() + '/bill/' + all[0]['xact.id']);
 965     }
 966
 967     $scope.totals.selected_paid = function() {
 968         var paid = 0;
 969         angular.forEach($scope.gridControls.selectedItems(), function(payment) {
 970             paid += Number(payment.amount) * 100;
 971         });
 972         return paid / 100;
 973     }
 974 }])
 975
 976
 977