FS/FS/ClientAPI/MyAccount.pm

   1 package FS::ClientAPI::MyAccount;
   2
   3 use strict;
   4 use vars qw($cache);
   5 use subs qw(_cache);
   6 use Digest::MD5 qw(md5_hex);
   7 use Date::Format;
   8 use Business::CreditCard;
   9 use Time::Duration;
  10 use FS::CGI qw(small_custview); #doh
  11 use FS::UI::Web;
  12 use FS::UI::bytecount;
  13 use FS::Conf;
  14 use FS::Record qw(qsearch qsearchs);
  15 use FS::Msgcat qw(gettext);
  16 use FS::Misc qw(card_types);
  17 use FS::ClientAPI_SessionCache;
  18 use FS::svc_acct;
  19 use FS::svc_domain;
  20 use FS::svc_external;
  21 use FS::part_svc;
  22 use FS::cust_main;
  23 use FS::cust_bill;
  24 use FS::cust_main_county;
  25 use FS::cust_pkg;
  26 use FS::payby;
  27 use FS::acct_rt_transaction;
  28 use HTML::Entities;
  29
  30 #false laziness with FS::cust_main
  31 BEGIN {
  32   eval "use Time::Local;";
  33   die "Time::Local minimum version 1.05 required with Perl versions before 5.6"
  34     if $] < 5.006 && !defined($Time::Local::VERSION);
  35   eval "use Time::Local qw(timelocal_nocheck);";
  36 }
  37
  38 use vars qw( @cust_main_editable_fields );
  39 @cust_main_editable_fields = qw(
  40   first last company address1 address2 city
  41     county state zip country daytime night fax
  42   ship_first ship_last ship_company ship_address1 ship_address2 ship_city
  43     ship_state ship_zip ship_country ship_daytime ship_night ship_fax
  44   payby payinfo payname paystart_month paystart_year payissue payip
  45   ss paytype paystate stateid stateid_state
  46 );
  47
  48 use subs qw(_provision);
  49
  50 sub _cache {
  51   $cache ||= new FS::ClientAPI_SessionCache( {
  52                'namespace' => 'FS::ClientAPI::MyAccount',
  53              } );
  54 }
  55
  56 #false laziness w/FS::ClientAPI::passwd::passwd
  57 sub login {
  58   my $p = shift;
  59
  60   my $svc_domain = qsearchs('svc_domain', { 'domain' => $p->{'domain'} } )
  61     or return { error => 'Domain '. $p->{'domain'}. ' not found' };
  62
  63   my $svc_acct = qsearchs( 'svc_acct', { 'username'  => $p->{'username'},
  64                                          'domsvc'    => $svc_domain->svcnum, }
  65                          );
  66   return { error => 'User not found.' } unless $svc_acct;
  67
  68   my $conf = new FS::Conf;
  69   my $pkg_svc = $svc_acct->cust_svc->pkg_svc;
  70   return { error => 'Only primary user may log in.' }
  71     if $conf->exists('selfservice_server-primary_only')
  72        && ( ! $pkg_svc || $pkg_svc->primary_svc ne 'Y' );
  73
  74   return { error => 'Incorrect password.' }
  75     unless $svc_acct->check_password($p->{'password'});
  76
  77   my $session = {
  78     'svcnum' => $svc_acct->svcnum,
  79   };
  80
  81   my $cust_pkg = $svc_acct->cust_svc->cust_pkg;
  82   if ( $cust_pkg ) {
  83     my $cust_main = $cust_pkg->cust_main;
  84     $session->{'custnum'} = $cust_main->custnum;
  85   }
  86
  87   my $session_id;
  88   do {
  89     $session_id = md5_hex(md5_hex(time(). {}. rand(). $$))
  90   } until ( ! defined _cache->get($session_id) ); #just in case
  91
  92   my $timeout = $conf->config('selfservice-session_timeout') || '1 hour';
  93   _cache->set( $session_id, $session, $timeout );
  94
  95   return { 'error'      => '',
  96            'session_id' => $session_id,
  97          };
  98 }
  99
 100 sub logout {
 101   my $p = shift;
 102   if ( $p->{'session_id'} ) {
 103     _cache->remove($p->{'session_id'});
 104     return { 'error' => '' };
 105   } else {
 106     return { 'error' => "Can't resume session" }; #better error message
 107   }
 108 }
 109
 110 sub customer_info {
 111   my $p = shift;
 112
 113   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 114   return { 'error' => $session } if $context eq 'error';
 115
 116   my %return;
 117
 118   my $conf = new FS::Conf;
 119   if ($conf->exists('cust_main-require_address2')) {
 120     $return{'require_address2'} = '1';
 121   }else{
 122     $return{'require_address2'} = '';
 123   }
 124
 125   if ( $custnum ) { #customer record
 126
 127     my $search = { 'custnum' => $custnum };
 128     $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
 129     my $cust_main = qsearchs('cust_main', $search )
 130       or return { 'error' => "unknown custnum $custnum" };
 131
 132     $return{balance} = $cust_main->balance;
 133
 134     $return{tickets} = [ ($cust_main->tickets) ];
 135
 136     my @open = map {
 137                      {
 138                        invnum => $_->invnum,
 139                        date   => time2str("%b %o, %Y", $_->_date),
 140                        owed   => $_->owed,
 141                      };
 142                    } $cust_main->open_cust_bill;
 143     $return{open_invoices} = \@open;
 144
 145     $return{small_custview} =
 146       small_custview( $cust_main, $conf->config('countrydefault') );
 147
 148     $return{name} = $cust_main->first. ' '. $cust_main->get('last');
 149
 150     for (@cust_main_editable_fields) {
 151       $return{$_} = $cust_main->get($_);
 152     }
 153
 154     if ( $cust_main->payby =~ /^(CARD|DCRD)$/ ) {
 155       $return{payinfo} = $cust_main->paymask;
 156       @return{'month', 'year'} = $cust_main->paydate_monthyear;
 157     }
 158
 159     $return{'invoicing_list'} =
 160       join(', ', grep { $_ !~ /^(POST|FAX)$/ } $cust_main->invoicing_list );
 161     $return{'postal_invoicing'} =
 162       0 < ( grep { $_ eq 'POST' } $cust_main->invoicing_list );
 163
 164     if (scalar($conf->config('support_packages'))) {
 165       my @support_services = ();
 166       foreach ($cust_main->support_services) {
 167         my $seconds = $_->svc_x->seconds;
 168         my $time_remaining = (($seconds < 0) ? '-' : '' ).
 169                              int(abs($seconds)/3600)."h".
 170                              sprintf("%02d",(abs($seconds)%3600)/60)."m";
 171         my $cust_pkg = $_->cust_pkg;
 172         my $pkgnum = '';
 173         my $pkg = '';
 174         $pkgnum = $cust_pkg->pkgnum if $cust_pkg;
 175         $pkg = $cust_pkg->part_pkg->pkg if $cust_pkg;
 176         push @support_services, { svcnum => $_->svcnum,
 177                                   time => $time_remaining,
 178                                   pkgnum => $pkgnum,
 179                                   pkg => $pkg,
 180                                 };
 181       }
 182       $return{support_services} = \@support_services;
 183     }
 184
 185   } elsif ( $session->{'svcnum'} ) { #no customer record
 186
 187     my $svc_acct = qsearchs('svc_acct', { 'svcnum' => $session->{'svcnum'} } )
 188       or die "unknown svcnum";
 189     $return{name} = $svc_acct->email;
 190
 191   } else {
 192
 193     return { 'error' => 'Expired session' }; #XXX redirect to login w/this err!
 194
 195   }
 196
 197   return { 'error'          => '',
 198            'custnum'        => $custnum,
 199            %return,
 200          };
 201
 202 }
 203
 204 sub edit_info {
 205   my $p = shift;
 206   my $session = _cache->get($p->{'session_id'})
 207     or return { 'error' => "Can't resume session" }; #better error message
 208
 209   my $custnum = $session->{'custnum'}
 210     or return { 'error' => "no customer record" };
 211
 212   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 213     or return { 'error' => "unknown custnum $custnum" };
 214
 215   my $new = new FS::cust_main { $cust_main->hash };
 216   $new->set( $_ => $p->{$_} )
 217     foreach grep { exists $p->{$_} } @cust_main_editable_fields;
 218
 219   my $payby = '';
 220   if (exists($p->{'payby'})) {
 221     $p->{'payby'} =~ /^([A-Z]{4})$/
 222       or return { 'error' => "illegal_payby " . $p->{'payby'} };
 223     $payby = $1;
 224   }
 225
 226   if ( $payby =~ /^(CARD|DCRD)$/ ) {
 227
 228     $new->paydate($p->{'year'}. '-'. $p->{'month'}. '-01');
 229
 230     if ( $new->payinfo eq $cust_main->paymask ) {
 231       $new->payinfo($cust_main->payinfo);
 232     } else {
 233       $new->payinfo($p->{'payinfo'});
 234     }
 235
 236     $new->set( 'payby' => $p->{'auto'} ? 'CARD' : 'DCRD' );
 237
 238   }elsif ( $payby =~ /^(CHEK|DCHK)$/ ) {
 239     my $payinfo;
 240     $p->{'payinfo1'} =~ /^([\dx]+)$/
 241       or return { 'error' => "illegal account number ". $p->{'payinfo1'} };
 242     my $payinfo1 = $1;
 243      $p->{'payinfo2'} =~ /^([\dx]+)$/
 244       or return { 'error' => "illegal ABA/routing number ". $p->{'payinfo2'} };
 245     my $payinfo2 = $1;
 246     $payinfo = $payinfo1. '@'. $payinfo2;
 247
 248     if ( $payinfo eq $cust_main->paymask ) {
 249       $new->payinfo($cust_main->payinfo);
 250     } else {
 251       $new->payinfo($payinfo);
 252     }
 253
 254     $new->set( 'payby' => $p->{'auto'} ? 'CHEK' : 'DCHK' );
 255
 256   }elsif ( $payby =~ /^(BILL)$/ ) {
 257   } elsif ( $payby ) {  #notyet ready
 258     return { 'error' => "unknown payby $payby" };
 259   }
 260
 261   my @invoicing_list;
 262   if ( exists $p->{'invoicing_list'} || exists $p->{'postal_invoicing'} ) {
 263     #false laziness with httemplate/edit/process/cust_main.cgi
 264     @invoicing_list = split( /\s*\,\s*/, $p->{'invoicing_list'} );
 265     push @invoicing_list, 'POST' if $p->{'postal_invoicing'};
 266   } else {
 267     @invoicing_list = $cust_main->invoicing_list;
 268   }
 269
 270   my $error = $new->replace($cust_main, \@invoicing_list);
 271   return { 'error' => $error } if $error;
 272   #$cust_main = $new;
 273
 274   return { 'error' => '' };
 275 }
 276
 277 sub payment_info {
 278   my $p = shift;
 279   my $session = _cache->get($p->{'session_id'})
 280     or return { 'error' => "Can't resume session" }; #better error message
 281
 282   ##
 283   #generic
 284   ##
 285
 286   use vars qw($payment_info); #cache for performance
 287   unless ( $payment_info ) {
 288
 289     my $conf = new FS::Conf;
 290     my %states = map { $_->state => 1 }
 291                    qsearch('cust_main_county', {
 292                      'country' => $conf->config('countrydefault') || 'US'
 293                    } );
 294
 295     $payment_info = {
 296
 297       #list all counties/states/countries
 298       'cust_main_county' =>
 299         [ map { $_->hashref } qsearch('cust_main_county', {}) ],
 300
 301       #shortcut for one-country folks
 302       'states' =>
 303         [ sort { $a cmp $b } keys %states ],
 304
 305       'card_types' => card_types(),
 306
 307       'paytypes' => [ @FS::cust_main::paytypes ],
 308
 309       'paybys' => [ $conf->config('signup_server-payby') ],
 310
 311       'stateid_label' => FS::Msgcat::_gettext('stateid'),
 312       'stateid_state_label' => FS::Msgcat::_gettext('stateid_state'),
 313
 314       'show_ss'  => $conf->exists('show_ss'),
 315       'show_stateid' => $conf->exists('show_stateid'),
 316       'show_paystate' => $conf->exists('show_bankstate'),
 317     };
 318
 319   }
 320
 321   ##
 322   #customer-specific
 323   ##
 324
 325   my %return = %$payment_info;
 326
 327   my $custnum = $session->{'custnum'};
 328
 329   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 330     or return { 'error' => "unknown custnum $custnum" };
 331
 332   $return{balance} = $cust_main->balance;
 333
 334   $return{payname} = $cust_main->payname
 335                      || ( $cust_main->first. ' '. $cust_main->get('last') );
 336
 337   $return{$_} = $cust_main->get($_) for qw(address1 address2 city state zip);
 338
 339   $return{payby} = $cust_main->payby;
 340   $return{stateid_state} = $cust_main->stateid_state;
 341
 342   if ( $cust_main->payby =~ /^(CARD|DCRD)$/ ) {
 343     $return{card_type} = cardtype($cust_main->payinfo);
 344     $return{payinfo} = $cust_main->paymask;
 345
 346     @return{'month', 'year'} = $cust_main->paydate_monthyear;
 347
 348   }
 349
 350   if ( $cust_main->payby =~ /^(CHEK|DCHK)$/ ) {
 351     my ($payinfo1, $payinfo2) = split '@', $cust_main->paymask;
 352     $return{payinfo1} = $payinfo1;
 353     $return{payinfo2} = $payinfo2;
 354     $return{paytype}  = $cust_main->paytype;
 355     $return{paystate} = $cust_main->paystate;
 356
 357   }
 358
 359   #doubleclick protection
 360   my $_date = time;
 361   $return{paybatch} = "webui-MyAccount-$_date-$$-". rand() * 2**32;
 362
 363   return { 'error' => '',
 364            %return,
 365          };
 366
 367 };
 368
 369 #some false laziness with httemplate/process/payment.cgi - look there for
 370 #ACH and CVV support stuff
 371 sub process_payment {
 372
 373   my $p = shift;
 374
 375   my $session = _cache->get($p->{'session_id'})
 376     or return { 'error' => "Can't resume session" }; #better error message
 377
 378   my %return;
 379
 380   my $custnum = $session->{'custnum'};
 381
 382   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 383     or return { 'error' => "unknown custnum $custnum" };
 384
 385   $p->{'payname'} =~ /^([\w \,\.\-\']+)$/
 386     or return { 'error' => gettext('illegal_name'). " payname: ". $p->{'payname'} };
 387   my $payname = $1;
 388
 389   $p->{'paybatch'} =~ /^([\w \!\@\#\$\%\&\(\)\-\+\;\:\'\"\,\.\?\/\=]*)$/
 390     or return { 'error' => gettext('illegal_text'). " paybatch: ". $p->{'paybatch'} };
 391   my $paybatch = $1;
 392
 393   $p->{'payby'} =~ /^([A-Z]{4})$/
 394     or return { 'error' => "illegal_payby " . $p->{'payby'} };
 395   my $payby = $1;
 396
 397   my $payinfo;
 398   my $paycvv = '';
 399   if ( $payby eq 'CHEK' || $payby eq 'DCHK' ) {
 400
 401     $p->{'payinfo1'} =~ /^([\dx]+)$/
 402       or return { 'error' => "illegal account number ". $p->{'payinfo1'} };
 403     my $payinfo1 = $1;
 404      $p->{'payinfo2'} =~ /^([\dx]+)$/
 405       or return { 'error' => "illegal ABA/routing number ". $p->{'payinfo2'} };
 406     my $payinfo2 = $1;
 407     $payinfo = $payinfo1. '@'. $payinfo2;
 408
 409     $payinfo = $cust_main->payinfo
 410       if $cust_main->paymask eq $payinfo;
 411
 412   } elsif ( $payby eq 'CARD' || $payby eq 'DCRD' ) {
 413
 414     $payinfo = $p->{'payinfo'};
 415     $payinfo =~ s/[^\dx]//g;
 416     $payinfo =~ /^(\d{13,16})$/
 417       or return { 'error' => gettext('invalid_card') }; # . ": ". $self->payinfo
 418     $payinfo = $1;
 419
 420     $payinfo = $cust_main->payinfo
 421       if $cust_main->paymask eq $payinfo;
 422
 423     validate($payinfo)
 424       or return { 'error' => gettext('invalid_card') }; # . ": ". $self->payinfo
 425     return { 'error' => gettext('unknown_card_type') }
 426       if cardtype($payinfo) eq "Unknown";
 427
 428     if ( length($p->{'paycvv'}) && $p->{'paycvv'} !~ /^\s*$/ ) {
 429       if ( cardtype($payinfo) eq 'American Express card' ) {
 430         $p->{'paycvv'} =~ /^\s*(\d{4})\s*$/
 431           or return { 'error' => "CVV2 (CID) for American Express cards is four digits." };
 432         $paycvv = $1;
 433       } else {
 434         $p->{'paycvv'} =~ /^\s*(\d{3})\s*$/
 435           or return { 'error' => "CVV2 (CVC2/CID) is three digits." };
 436         $paycvv = $1;
 437       }
 438     }
 439
 440   } else {
 441     die "unknown payby $payby";
 442   }
 443
 444   my %payby2fields = (
 445     'CARD' => [ qw( paystart_month paystart_year payissue address1 address2 city state zip payip ) ],
 446     'CHEK' => [ qw( ss paytype paystate stateid stateid_state payip ) ],
 447   );
 448
 449   my $error = $cust_main->realtime_bop( $FS::payby::payby2bop{$payby}, $p->{'amount'},
 450     'quiet'    => 1,
 451     'payinfo'  => $payinfo,
 452     'paydate'  => $p->{'year'}. '-'. $p->{'month'}. '-01',
 453     'payname'  => $payname,
 454     'paybatch' => $paybatch,
 455     'paycvv'   => $paycvv,
 456     map { $_ => $p->{$_} } @{ $payby2fields{$payby} }
 457   );
 458   return { 'error' => $error } if $error;
 459
 460   $cust_main->apply_payments;
 461
 462   if ( $p->{'save'} ) {
 463     my $new = new FS::cust_main { $cust_main->hash };
 464     if ($payby eq 'CARD' || $payby eq 'DCRD') {
 465       $new->set( $_ => $p->{$_} )
 466         foreach qw( payname paystart_month paystart_year payissue payip
 467                     address1 address2 city state zip payinfo );
 468       $new->set( 'payby' => $p->{'auto'} ? 'CARD' : 'DCRD' );
 469     } elsif ($payby eq 'CHEK' || $payby eq 'DCHK') {
 470       $new->set( $_ => $p->{$_} )
 471         foreach qw( payname payip paytype paystate
 472                     stateid stateid_state );
 473       $new->set( 'payinfo' => $payinfo );
 474       $new->set( 'payby' => $p->{'auto'} ? 'CHEK' : 'DCHK' );
 475     }
 476     $new->set( 'paydate' => $p->{'year'}. '-'. $p->{'month'}. '-01' );
 477     my $error = $new->replace($cust_main);
 478     return { 'error' => $error } if $error;
 479     $cust_main = $new;
 480   }
 481
 482   return { 'error' => '' };
 483
 484 }
 485
 486 sub process_payment_order_pkg {
 487   my $p = shift;
 488
 489   my $hr = process_payment($p);
 490   return $hr if $hr->{'error'};
 491
 492   order_pkg($p);
 493 }
 494
 495 sub process_prepay {
 496
 497   my $p = shift;
 498
 499   my $session = _cache->get($p->{'session_id'})
 500     or return { 'error' => "Can't resume session" }; #better error message
 501
 502   my %return;
 503
 504   my $custnum = $session->{'custnum'};
 505
 506   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 507     or return { 'error' => "unknown custnum $custnum" };
 508
 509   my( $amount, $seconds, $upbytes, $downbytes, $totalbytes ) = ( 0, 0, 0, 0, 0 );
 510   my $error = $cust_main->recharge_prepay( $p->{'prepaid_cardnum'},
 511                                            \$amount,
 512                                            \$seconds,
 513                                            \$upbytes,
 514                                            \$downbytes,
 515                                            \$totalbytes,
 516                                          );
 517
 518   return { 'error' => $error } if $error;
 519
 520   return { 'error'     => '',
 521            'amount'    => $amount,
 522            'seconds'   => $seconds,
 523            'duration'  => duration_exact($seconds),
 524            'upbytes'   => $upbytes,
 525            'upload'    => FS::UI::bytecount::bytecount_unexact($upbytes),
 526            'downbytes' => $downbytes,
 527            'download'  => FS::UI::bytecount::bytecount_unexact($downbytes),
 528            'totalbytes'=> $totalbytes,
 529            'totalload' => FS::UI::bytecount::bytecount_unexact($totalbytes),
 530          };
 531
 532 }
 533
 534 sub invoice {
 535   my $p = shift;
 536   my $session = _cache->get($p->{'session_id'})
 537     or return { 'error' => "Can't resume session" }; #better error message
 538
 539   my $custnum = $session->{'custnum'};
 540
 541   my $invnum = $p->{'invnum'};
 542
 543   my $cust_bill = qsearchs('cust_bill', { 'invnum'  => $invnum,
 544                                           'custnum' => $custnum } )
 545     or return { 'error' => "Can't find invnum" };
 546
 547   #my %return;
 548
 549   return { 'error'        => '',
 550            'invnum'       => $invnum,
 551            'invoice_text' => join('', $cust_bill->print_text ),
 552            'invoice_html' => $cust_bill->print_html,
 553          };
 554
 555 }
 556
 557 sub invoice_logo {
 558   my $p = shift;
 559
 560   #sessioning for this?  how do we get the session id to the backend invoice
 561   # template so it can add it to the link, blah
 562
 563   my $templatename = $p->{'templatename'};
 564
 565   #false laziness-ish w/view/cust_bill-logo.cgi
 566
 567   my $conf = new FS::Conf;
 568   if ( $templatename =~ /^([^\.\/]*)$/ && $conf->exists("logo_$1.png") ) {
 569     $templatename = "_$1";
 570   } else {
 571     $templatename = '';
 572   }
 573
 574   my $filename = "logo$templatename.png";
 575
 576   return { 'error'        => '',
 577            'logo'         => $conf->config_binary($filename),
 578            'content_type' => 'image/png', #should allow gif, jpg too
 579          };
 580 }
 581
 582
 583 sub list_invoices {
 584   my $p = shift;
 585   my $session = _cache->get($p->{'session_id'})
 586     or return { 'error' => "Can't resume session" }; #better error message
 587
 588   my $custnum = $session->{'custnum'};
 589
 590   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 591     or return { 'error' => "unknown custnum $custnum" };
 592
 593   my @cust_bill = $cust_main->cust_bill;
 594
 595   return  { 'error'       => '',
 596             'invoices'    =>  [ map { { 'invnum' => $_->invnum,
 597                                         '_date'  => $_->_date,
 598                                       }
 599                                     } @cust_bill
 600                               ]
 601           };
 602 }
 603
 604 sub cancel {
 605   my $p = shift;
 606   my $session = _cache->get($p->{'session_id'})
 607     or return { 'error' => "Can't resume session" }; #better error message
 608
 609   my $custnum = $session->{'custnum'};
 610
 611   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 612     or return { 'error' => "unknown custnum $custnum" };
 613
 614   my @errors = $cust_main->cancel( 'quiet'=>1 );
 615
 616   my $error = scalar(@errors) ? join(' / ', @errors) : '';
 617
 618   return { 'error' => $error };
 619
 620 }
 621
 622 sub list_pkgs {
 623   my $p = shift;
 624
 625   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 626   return { 'error' => $session } if $context eq 'error';
 627
 628   my $search = { 'custnum' => $custnum };
 629   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
 630   my $cust_main = qsearchs('cust_main', $search )
 631     or return { 'error' => "unknown custnum $custnum" };
 632
 633   #return { 'cust_pkg' => [ map { $_->hashref } $cust_main->ncancelled_pkgs ] };
 634
 635   my $conf = new FS::Conf;
 636
 637   { 'svcnum'   => $session->{'svcnum'},
 638     'custnum'  => $custnum,
 639     'cust_pkg' => [ map {
 640                           { $_->hash,
 641                             $_->part_pkg->hash,
 642                             part_svc =>
 643                               [ map $_->hashref, $_->available_part_svc ],
 644                             cust_svc =>
 645                               [ map { my $ref = { $_->hash,
 646                                                   label => [ $_->label ],
 647                                                 };
 648                                       $ref->{_password} = $_->svc_x->_password
 649                                         if $context eq 'agent'
 650                                         && $conf->exists('agent-showpasswords')
 651                                         && $_->part_svc->svcdb eq 'svc_acct';
 652                                       $ref;
 653                                     } $_->cust_svc
 654                               ],
 655                           };
 656                         } $cust_main->ncancelled_pkgs
 657                   ],
 658     'small_custview' =>
 659       small_custview( $cust_main, $conf->config('countrydefault') ),
 660   };
 661
 662 }
 663
 664 sub list_svcs {
 665   my $p = shift;
 666
 667   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 668   return { 'error' => $session } if $context eq 'error';
 669
 670   my $search = { 'custnum' => $custnum };
 671   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
 672   my $cust_main = qsearchs('cust_main', $search )
 673     or return { 'error' => "unknown custnum $custnum" };
 674
 675   my @cust_svc = ();
 676   #foreach my $cust_pkg ( $cust_main->ncancelled_pkgs ) {
 677   foreach my $cust_pkg ( $p->{'ncancelled'}
 678                          ? $cust_main->ncancelled_pkgs
 679                          : $cust_main->unsuspended_pkgs ) {
 680     push @cust_svc, @{[ $cust_pkg->cust_svc ]}; #@{[ ]} to force array context
 681   }
 682   @cust_svc = grep { $_->part_svc->svcdb eq $p->{'svcdb'} } @cust_svc
 683     if $p->{'svcdb'};
 684
 685   #@svc_x = sort { $a->domain cmp $b->domain || $a->username cmp $b->username }
 686   #              @svc_x;
 687
 688   {
 689     #no#'svcnum'   => $session->{'svcnum'},
 690     'custnum'  => $custnum,
 691     'svcs'     => [ map {
 692                           my $svc_x = $_->svc_x;
 693                           my($label, $value) = $_->label;
 694                           my $part_pkg = $svc_x->cust_svc->cust_pkg->part_pkg;
 695
 696                           { 'svcnum'    => $_->svcnum,
 697                             'label'     => $label,
 698                             'value'     => $value,
 699                             'username'  => $svc_x->username,
 700                             'email'     => $svc_x->email,
 701                             'seconds'   => $svc_x->seconds,
 702                             'upbytes'   => FS::UI::bytecount::display_bytecount($svc_x->upbytes),
 703                             'downbytes' => FS::UI::bytecount::display_bytecount($svc_x->downbytes),
 704                             'totalbytes'=> FS::UI::bytecount::display_bytecount($svc_x->totalbytes),
 705                             'recharge_amount' => $part_pkg->option('recharge_amount', 1),
 706                             'recharge_seconds' => $part_pkg->option('recharge_seconds', 1),
 707                             'recharge_upbytes' => FS::UI::bytecount::display_bytecount($part_pkg->option('recharge_upbytes', 1)),
 708                             'recharge_downbytes' => FS::UI::bytecount::display_bytecount($part_pkg->option('recharge_downbytes', 1)),
 709                             'recharge_totalbytes' => FS::UI::bytecount::display_bytecount($part_pkg->option('recharge_totalbytes', 1)),
 710                             # more...
 711                           };
 712                         }
 713                         @cust_svc
 714                   ],
 715   };
 716
 717 }
 718
 719 sub _list_svc_usage {
 720   my($svc_acct, $begin, $end) = @_;
 721   my @usage = ();
 722   foreach my $part_export (
 723     map { qsearch ( 'part_export', { 'exporttype' => $_ } ) }
 724     qw (sqlradius sqlradius_withdomain')
 725   ) {
 726
 727     push @usage, @ { $part_export->usage_sessions($begin, $end, $svc_acct) };
 728   }
 729   (@usage);
 730 }
 731
 732 sub list_svc_usage {
 733   _usage_details(\&_list_svc_usage, @_);
 734 }
 735
 736 sub _list_support_usage {
 737   my($svc_acct, $begin, $end) = @_;
 738   my @usage = ();
 739   foreach ( grep { $begin <= $_->_date && $_->_date <= $end }
 740             qsearch('acct_rt_transaction', { 'svcnum' => $svc_acct->svcnum })
 741           ) {
 742     push @usage, { 'seconds'  => $_->seconds,
 743                    'support'  => $_->support,
 744                    '_date'    => $_->_date,
 745                    'id'       => $_->transaction_id,
 746                    'creator'  => $_->creator,
 747                    'subject'  => $_->subject,
 748                    'status'   => $_->status,
 749                    'ticketid' => $_->ticketid,
 750                  };
 751   }
 752   (@usage);
 753 }
 754
 755 sub list_support_usage {
 756   _usage_details(\&_list_support_usage, @_);
 757 }
 758
 759 sub _usage_details {
 760   my ($callback, $p) = (shift,shift);
 761
 762   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 763   return { 'error' => $session } if $context eq 'error';
 764
 765   my $search = { 'svcnum' => $p->{'svcnum'} };
 766   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
 767   my $svc_acct = qsearchs ( 'svc_acct', $search );
 768   return { 'error' => 'No service selected in list_svc_usage' }
 769     unless $svc_acct;
 770
 771   my $freq   = $svc_acct->cust_svc->cust_pkg->part_pkg->freq;
 772   my $start  = $svc_acct->cust_svc->cust_pkg->setup;
 773   #my $end    = $svc_acct->cust_svc->cust_pkg->bill; # or time?
 774   my $end    = time;
 775
 776   unless($p->{beginning}){
 777     $p->{beginning} = $svc_acct->cust_svc->cust_pkg->last_bill;
 778     $p->{ending} = $end;
 779   }
 780
 781   my (@usage) = &$callback($svc_acct,$p->{beginning},$p->{ending});
 782
 783   #kinda false laziness with FS::cust_main::bill, but perhaps
 784   #we should really change this bit to DateTime and DateTime::Duration
 785   #
 786   #change this bit to use Date::Manip? CAREFUL with timezones (see
 787   # mailing list archive)
 788   my ($nsec,$nmin,$nhour,$nmday,$nmon,$nyear) =
 789     (localtime($p->{ending}) )[0,1,2,3,4,5];
 790   my ($psec,$pmin,$phour,$pmday,$pmon,$pyear) =
 791     (localtime($p->{beginning}) )[0,1,2,3,4,5];
 792
 793   if ( $freq =~ /^\d+$/ ) {
 794     $nmon += $freq;
 795     until ( $nmon < 12 ) { $nmon -= 12; $nyear++; }
 796     $pmon -= $freq;
 797     until ( $pmon >= 0 ) { $pmon += 12; $pyear--; }
 798   } elsif ( $freq =~ /^(\d+)w$/ ) {
 799     my $weeks = $1;
 800     $nmday += $weeks * 7;
 801     $pmday -= $weeks * 7;
 802   } elsif ( $freq =~ /^(\d+)d$/ ) {
 803     my $days = $1;
 804     $nmday += $days;
 805     $pmday -= $days;
 806   } elsif ( $freq =~ /^(\d+)h$/ ) {
 807     my $hours = $1;
 808     $nhour += $hours;
 809     $phour -= $hours;
 810   } else {
 811     return { 'error' => "unparsable frequency: ". $freq };
 812   }
 813
 814   my $previous  = timelocal_nocheck($psec,$pmin,$phour,$pmday,$pmon,$pyear);
 815   my $next      = timelocal_nocheck($nsec,$nmin,$nhour,$nmday,$nmon,$nyear);
 816
 817   {
 818     'error'     => '',
 819     'svcnum'    => $p->{svcnum},
 820     'beginning' => $p->{beginning},
 821     'ending'    => $p->{ending},
 822     'previous'  => ($previous > $start) ? $previous : $start,
 823     'next'      => ($next < $end) ? $next : $end,
 824     'usage'     => \@usage,
 825   };
 826 }
 827
 828 sub order_pkg {
 829   my $p = shift;
 830
 831   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 832   return { 'error' => $session } if $context eq 'error';
 833
 834   my $search = { 'custnum' => $custnum };
 835   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
 836   my $cust_main = qsearchs('cust_main', $search )
 837     or return { 'error' => "unknown custnum $custnum" };
 838
 839   my $status = $cust_main->status;
 840   #false laziness w/ClientAPI/Signup.pm
 841
 842   my $cust_pkg = new FS::cust_pkg ( {
 843     'custnum' => $custnum,
 844     'pkgpart' => $p->{'pkgpart'},
 845   } );
 846   my $error = $cust_pkg->check;
 847   return { 'error' => $error } if $error;
 848
 849   my @svc = ();
 850   unless ( $p->{'svcpart'} eq 'none' ) {
 851
 852     my $svcdb;
 853     my $svcpart = '';
 854     if ( $p->{'svcpart'} =~ /^(\d+)$/ ) {
 855       $svcpart = $1;
 856       my $part_svc = qsearchs('part_svc', { 'svcpart' => $svcpart } );
 857       return { 'error' => "Unknown svcpart $svcpart" } unless $part_svc;
 858       $svcdb = $part_svc->svcdb;
 859     } else {
 860       $svcdb = 'svc_acct';
 861     }
 862     $svcpart ||= $cust_pkg->part_pkg->svcpart($svcdb);
 863
 864     my %fields = (
 865       'svc_acct'     => [ qw( username domsvc _password sec_phrase popnum ) ],
 866       'svc_domain'   => [ qw( domain ) ],
 867       'svc_external' => [ qw( id title ) ],
 868     );
 869
 870     my $svc_x = "FS::$svcdb"->new( {
 871       'svcpart'   => $svcpart,
 872       map { $_ => $p->{$_} } @{$fields{$svcdb}}
 873     } );
 874
 875     if ( $svcdb eq 'svc_acct' ) {
 876       my @acct_snarf;
 877       my $snarfnum = 1;
 878       while ( length($p->{"snarf_machine$snarfnum"}) ) {
 879         my $acct_snarf = new FS::acct_snarf ( {
 880           'machine'   => $p->{"snarf_machine$snarfnum"},
 881           'protocol'  => $p->{"snarf_protocol$snarfnum"},
 882           'username'  => $p->{"snarf_username$snarfnum"},
 883           '_password' => $p->{"snarf_password$snarfnum"},
 884         } );
 885         $snarfnum++;
 886         push @acct_snarf, $acct_snarf;
 887       }
 888       $svc_x->child_objects( \@acct_snarf );
 889     }
 890
 891     my $y = $svc_x->setdefault; # arguably should be in new method
 892     return { 'error' => $y } if $y && !ref($y);
 893
 894     $error = $svc_x->check;
 895     return { 'error' => $error } if $error;
 896
 897     push @svc, $svc_x;
 898
 899   }
 900
 901   use Tie::RefHash;
 902   tie my %hash, 'Tie::RefHash';
 903   %hash = ( $cust_pkg => \@svc );
 904   #msgcat
 905   $error = $cust_main->order_pkgs( \%hash, '', 'noexport' => 1 );
 906   return { 'error' => $error } if $error;
 907
 908   my $conf = new FS::Conf;
 909   if ( $conf->exists('signup_server-realtime') ) {
 910
 911     my $bill_error = _do_bop_realtime( $cust_main, $status );
 912
 913     if ($bill_error) {
 914       $cust_pkg->cancel('quiet'=>1);
 915       return $bill_error;
 916     } else {
 917       $cust_pkg->reexport;
 918     }
 919
 920   } else {
 921     $cust_pkg->reexport;
 922   }
 923
 924   return { error => '', pkgnum => $cust_pkg->pkgnum };
 925
 926 }
 927
 928 sub change_pkg {
 929   my $p = shift;
 930
 931   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 932   return { 'error' => $session } if $context eq 'error';
 933
 934   my $search = { 'custnum' => $custnum };
 935   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
 936   my $cust_main = qsearchs('cust_main', $search )
 937     or return { 'error' => "unknown custnum $custnum" };
 938
 939   my $status = $cust_main->status;
 940   my $cust_pkg = qsearchs('cust_pkg', { 'pkgnum' => $p->{pkgnum} } )
 941     or return { 'error' => "unknown package $p->{pkgnum}" };
 942
 943   my @newpkg;
 944   my $error = FS::cust_pkg::order( $custnum,
 945                                    [$p->{pkgpart}],
 946                                    [$p->{pkgnum}],
 947                                    \@newpkg,
 948                                  );
 949
 950   my $conf = new FS::Conf;
 951   if ( $conf->exists('signup_server-realtime') ) {
 952
 953     my $bill_error = _do_bop_realtime( $cust_main, $status );
 954
 955     if ($bill_error) {
 956       $newpkg[0]->suspend;
 957       return $bill_error;
 958     } else {
 959       $newpkg[0]->reexport;
 960     }
 961
 962   } else {
 963     $newpkg[0]->reexport;
 964   }
 965
 966   return { error => '', pkgnum => $cust_pkg->pkgnum };
 967
 968 }
 969
 970 sub order_recharge {
 971   my $p = shift;
 972
 973   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 974   return { 'error' => $session } if $context eq 'error';
 975
 976   my $search = { 'custnum' => $custnum };
 977   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
 978   my $cust_main = qsearchs('cust_main', $search )
 979     or return { 'error' => "unknown custnum $custnum" };
 980
 981   my $status = $cust_main->status;
 982   my $cust_svc = qsearchs( 'cust_svc', { 'svcnum' => $p->{'svcnum'} } )
 983     or return { 'error' => "unknown service " . $p->{'svcnum'} };
 984
 985   my $svc_x = $cust_svc->svc_x;
 986   my $part_pkg = $cust_svc->cust_pkg->part_pkg;
 987
 988   my %vhash =
 989     map { $_ =~ /^recharge_(.*)$/; $1, $part_pkg->option($_, 1) }
 990     qw ( recharge_seconds recharge_upbytes recharge_downbytes
 991          recharge_totalbytes );
 992   my $amount = $part_pkg->option('recharge_amount', 1);
 993
 994   my ($l, $v, $d) = $cust_svc->label;  # blah
 995   my $pkg = "Recharge $v";
 996
 997   my $bill_error = $cust_main->charge($amount, $pkg,
 998      "time: $vhash{seconds}, up: $vhash{upbytes}," .
 999      "down: $vhash{downbytes}, total: $vhash{totalbytes}",
1000      $part_pkg->taxclass); #meh
1001
1002   my $conf = new FS::Conf;
1003   if ( $conf->exists('signup_server-realtime') && !$bill_error ) {
1004
1005     $bill_error = _do_bop_realtime( $cust_main, $status );
1006
1007     if ($bill_error) {
1008       return $bill_error;
1009     } else {
1010       my $error = $svc_x->recharge (\%vhash);
1011       return { 'error' => $error } if $error;
1012     }
1013
1014   } else {
1015     my $error = $bill_error;
1016     $error ||= $svc_x->recharge (\%vhash);
1017     return { 'error' => $error } if $error;
1018   }
1019
1020   return { error => '', svc => $cust_svc->part_svc->svc };
1021
1022 }
1023
1024 sub _do_bop_realtime {
1025   my ($cust_main, $status) = (shift, shift);
1026
1027     my $old_balance = $cust_main->balance;
1028
1029     my $bill_error =    $cust_main->bill
1030                      || $cust_main->apply_payments_and_credits
1031                      || $cust_main->collect('realtime' => 1);
1032
1033     if (    $cust_main->balance > $old_balance
1034          && $cust_main->balance > 0
1035          && ( $cust_main->payby !~ /^(BILL|DCRD|DCHK)$/ ?
1036               1 : $status eq 'suspended' ) ) {
1037       #this makes sense.  credit is "un-doing" the invoice
1038       my $conf = new FS::Conf;
1039       $cust_main->credit( sprintf("%.2f", $cust_main->balance - $old_balance ),
1040                           'self-service decline',
1041                           'reason_type' => $conf->config('signup_credit_type'),
1042                         );
1043       $cust_main->apply_credits( 'order' => 'newest' );
1044
1045       return { 'error' => '_decline', 'bill_error' => $bill_error };
1046     }
1047
1048     '';
1049 }
1050
1051 sub cancel_pkg {
1052   my $p = shift;
1053   my $session = _cache->get($p->{'session_id'})
1054     or return { 'error' => "Can't resume session" }; #better error message
1055
1056   my $custnum = $session->{'custnum'};
1057
1058   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1059     or return { 'error' => "unknown custnum $custnum" };
1060
1061   my $pkgnum = $p->{'pkgnum'};
1062
1063   my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
1064                                         'pkgnum'  => $pkgnum,   } )
1065     or return { 'error' => "unknown pkgnum $pkgnum" };
1066
1067   my $error = $cust_pkg->cancel( 'quiet'=>1 );
1068   return { 'error' => $error };
1069
1070 }
1071
1072 sub provision_acct {
1073   my $p = shift;
1074
1075   return { 'error' => gettext('passwords_dont_match') }
1076     if $p->{'_password'} ne $p->{'_password2'};
1077   return { 'error' => gettext('empty_password') }
1078     unless length($p->{'_password'});
1079
1080   if ($p->{'domsvc'}) {
1081     my %domains = domain_select_hash FS::svc_acct(map { $_ => $p->{$_} }
1082                                                   qw ( svcpart pkgnum ) );
1083     return { 'error' => gettext('invalid_domain') }
1084       unless ($domains{$p->{'domsvc'}});
1085   }
1086
1087   _provision( 'FS::svc_acct',
1088               [qw(username _password domsvc)],
1089               [qw(username _password domsvc)],
1090               $p,
1091               @_
1092             );
1093 }
1094
1095 sub provision_external {
1096   my $p = shift;
1097   #_provision( 'FS::svc_external', [qw(id title)], [qw(id title)], $p, @_ );
1098   _provision( 'FS::svc_external',
1099               [],
1100               [qw(id title)],
1101               $p,
1102               @_
1103             );
1104 }
1105
1106 sub _provision {
1107   my( $class, $fields, $return_fields, $p ) = splice(@_, 0, 4);
1108
1109   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1110   return { 'error' => $session } if $context eq 'error';
1111
1112   my $search = { 'custnum' => $custnum };
1113   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1114   my $cust_main = qsearchs('cust_main', $search )
1115     or return { 'error' => "unknown custnum $custnum" };
1116
1117   my $pkgnum = $p->{'pkgnum'};
1118
1119   my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
1120                                         'pkgnum'  => $pkgnum,
1121                                                                } )
1122     or return { 'error' => "unknown pkgnum $pkgnum" };
1123
1124   my $part_svc = qsearchs('part_svc', { 'svcpart' => $p->{'svcpart'} } )
1125     or return { 'error' => "unknown svcpart $p->{'svcpart'}" };
1126
1127   my $svc_x = $class->new( {
1128     'pkgnum'  => $p->{'pkgnum'},
1129     'svcpart' => $p->{'svcpart'},
1130     map { $_ => $p->{$_} } @$fields
1131   } );
1132   my $error = $svc_x->insert;
1133   $svc_x = qsearchs($svc_x->table, { 'svcnum' => $svc_x->svcnum })
1134     unless $error;
1135
1136   return { 'svc'   => $part_svc->svc,
1137            'error' => $error,
1138            map { $_ => $svc_x->get($_) } @$return_fields
1139          };
1140
1141 }
1142
1143 sub part_svc_info {
1144   my $p = shift;
1145
1146   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1147   return { 'error' => $session } if $context eq 'error';
1148
1149   my $search = { 'custnum' => $custnum };
1150   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1151   my $cust_main = qsearchs('cust_main', $search )
1152     or return { 'error' => "unknown custnum $custnum" };
1153
1154   my $pkgnum = $p->{'pkgnum'};
1155
1156   my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
1157                                         'pkgnum'  => $pkgnum,
1158                                                                } )
1159     or return { 'error' => "unknown pkgnum $pkgnum" };
1160
1161   my $svcpart = $p->{'svcpart'};
1162
1163   my $pkg_svc = qsearchs('pkg_svc', { 'pkgpart' => $cust_pkg->pkgpart,
1164                                       'svcpart' => $svcpart,           } )
1165     or return { 'error' => "unknown svcpart $svcpart for pkgnum $pkgnum" };
1166   my $part_svc = $pkg_svc->part_svc;
1167
1168   my $conf = new FS::Conf;
1169
1170   return {
1171     'svc'     => $part_svc->svc,
1172     'svcdb'   => $part_svc->svcdb,
1173     'pkgnum'  => $pkgnum,
1174     'svcpart' => $svcpart,
1175     'custnum' => $custnum,
1176
1177     'security_phrase' => 0, #XXX !
1178     'svc_acct_pop'    => [], #XXX !
1179     'popnum'          => '',
1180     'init_popstate'   => '',
1181     'popac'           => '',
1182     'acstate'         => '',
1183
1184     'small_custview' =>
1185       small_custview( $cust_main, $conf->config('countrydefault') ),
1186
1187   };
1188
1189 }
1190
1191 sub unprovision_svc {
1192   my $p = shift;
1193
1194   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1195   return { 'error' => $session } if $context eq 'error';
1196
1197   my $search = { 'custnum' => $custnum };
1198   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1199   my $cust_main = qsearchs('cust_main', $search )
1200     or return { 'error' => "unknown custnum $custnum" };
1201
1202   my $svcnum = $p->{'svcnum'};
1203
1204   my $cust_svc = qsearchs('cust_svc', { 'svcnum'  => $svcnum, } )
1205     or return { 'error' => "unknown svcnum $svcnum" };
1206
1207   return { 'error' => "Service $svcnum does not belong to customer $custnum" }
1208     unless $cust_svc->cust_pkg->custnum == $custnum;
1209
1210   my $conf = new FS::Conf;
1211
1212   return { 'svc'   => $cust_svc->part_svc->svc,
1213            'error' => $cust_svc->cancel,
1214            'small_custview' =>
1215              small_custview( $cust_main, $conf->config('countrydefault') ),
1216          };
1217
1218 }
1219
1220 sub myaccount_passwd {
1221   my $p = shift;
1222   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1223   return { 'error' => $session } if $context eq 'error';
1224
1225   return { 'error' => "New passwords don't match." }
1226     if $p->{'new_password'} ne $p->{'new_password2'};
1227
1228   return { 'error' => 'Enter new password' }
1229     unless length($p->{'new_password'});
1230
1231   #my $search = { 'custnum' => $custnum };
1232   #$search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1233   $custnum =~ /^(\d+)$/ or die "illegal custnum";
1234   my $search = " AND custnum = $1";
1235   $search .= " AND agentnum = ". $session->{'agentnum'} if $context eq 'agent';
1236
1237   my $svc_acct = qsearchs( {
1238     'table'     => 'svc_acct',
1239     'addl_from' => 'LEFT JOIN cust_svc  USING ( svcnum  ) '.
1240                    'LEFT JOIN cust_pkg  USING ( pkgnum  ) '.
1241                    'LEFT JOIN cust_main USING ( custnum ) ',
1242     'hashref'   => { 'svcnum' => $p->{'svcnum'}, },
1243     'extra_sql' => $search, #important
1244   } )
1245     or return { 'error' => "Service not found" };
1246
1247   $svc_acct->_password($p->{'new_password'});
1248   my $error = $svc_acct->replace();
1249
1250   my($label, $value) = $svc_acct->cust_svc->label;
1251
1252   return { 'error' => $error,
1253            'label' => $label,
1254            'value' => $value,
1255          };
1256
1257 }
1258
1259 #--
1260
1261 sub _custoragent_session_custnum {
1262   my $p = shift;
1263
1264   my($context, $session, $custnum);
1265   if ( $p->{'session_id'} ) {
1266
1267     $context = 'customer';
1268     $session = _cache->get($p->{'session_id'})
1269       or return ( 'error' => "Can't resume session" ); #better error message
1270     $custnum = $session->{'custnum'};
1271
1272   } elsif ( $p->{'agent_session_id'} ) {
1273
1274     $context = 'agent';
1275     my $agent_cache = new FS::ClientAPI_SessionCache( {
1276       'namespace' => 'FS::ClientAPI::Agent',
1277     } );
1278     $session = $agent_cache->get($p->{'agent_session_id'})
1279       or return ( 'error' => "Can't resume session" ); #better error message
1280     $custnum = $p->{'custnum'};
1281
1282   } else {
1283     return ( 'error' => "Can't resume session" ); #better error message
1284   }
1285
1286   ($context, $session, $custnum);
1287
1288 }
1289
1290 1;
1291