FS/FS/ClientAPI/MyAccount.pm

   1 package FS::ClientAPI::MyAccount;
   2
   3 use 5.008; #require 5.8+ for Time::Local 1.05+
   4 use strict;
   5 use vars qw( $cache $DEBUG $me );
   6 use subs qw( _cache _provision );
   7 use IO::Scalar;
   8 use Data::Dumper;
   9 use Digest::MD5 qw(md5_hex);
  10 use Digest::SHA qw(sha512_hex);
  11 use Date::Format;
  12 use Time::Duration;
  13 use Time::Local qw(timelocal_nocheck);
  14 use Business::CreditCard 0.35;
  15 use HTML::Entities;
  16 use Text::CSV_XS;
  17 use Spreadsheet::WriteExcel;
  18 use OLE::Storage_Lite;
  19 use FS::UI::Web::small_custview qw(small_custview); #less doh
  20 use FS::UI::Web;
  21 use FS::UI::bytecount qw( display_bytecount );
  22 use FS::Conf;
  23 #use FS::UID qw(dbh);
  24 use FS::Record qw(qsearch qsearchs dbh);
  25 use FS::Msgcat qw(gettext);
  26 use FS::Misc qw(card_types money_pretty);
  27 use FS::Misc::DateTime qw(parse_datetime);
  28 use FS::TicketSystem;
  29 use FS::ClientAPI_SessionCache;
  30 use FS::cust_svc;
  31 use FS::svc_acct;
  32 use FS::svc_forward;
  33 use FS::svc_domain;
  34 use FS::svc_phone;
  35 use FS::svc_external;
  36 use FS::svc_dsl;
  37 use FS::dsl_device;
  38 use FS::part_svc;
  39 use FS::cust_main;
  40 use FS::cust_bill;
  41 use FS::legacy_cust_bill;
  42 use FS::cust_main_county;
  43 use FS::part_pkg;
  44 use FS::cust_pkg;
  45 use FS::payby;
  46 use FS::acct_rt_transaction;
  47 use FS::msg_template;
  48 use FS::contact;
  49 use FS::cust_contact;
  50 use FS::cust_location;
  51 use FS::cust_payby;
  52
  53 # for code organization
  54 use FS::ClientAPI::MyAccount::contact;
  55 use FS::ClientAPI::MyAccount::quotation;
  56
  57 $DEBUG = 0;
  58 $me = '[FS::ClientAPI::MyAccount]';
  59
  60 use vars qw( @cust_main_editable_fields @location_editable_fields );
  61 @cust_main_editable_fields = qw(
  62   first last company daytime night fax mobile
  63   locale
  64   ss stateid stateid_state
  65 );
  66 @location_editable_fields = qw(
  67   address1 address2 city county state zip country
  68 );
  69
  70
  71 BEGIN { #preload to reduce time customer_info takes
  72   if ( $FS::TicketSystem::system ) {
  73     warn "$me: initializing ticket system\n" if $DEBUG;
  74     FS::TicketSystem->init();
  75   }
  76 }
  77
  78 sub _cache {
  79   $cache ||= new FS::ClientAPI_SessionCache( {
  80                'namespace' => 'FS::ClientAPI::MyAccount',
  81              } );
  82 }
  83
  84 sub skin_info {
  85   my $p = shift;
  86
  87   my($context, $session, $custnum) = _custoragent_session_custnum($p);
  88   #return { 'error' => $session } if $context eq 'error';
  89
  90   my $agentnum = '';
  91   if ( $context eq 'customer' && $custnum ) {
  92
  93     my $sth = dbh->prepare('SELECT agentnum FROM cust_main WHERE custnum = ?')
  94       or die dbh->errstr;
  95
  96     $sth->execute($custnum) or die $sth->errstr;
  97
  98     $agentnum = $sth->fetchrow_arrayref->[0]
  99       or die "no agentnum for custnum $custnum";
 100
 101   #} elsif ( $context eq 'agent' ) {
 102   } elsif ( defined($p->{'agentnum'}) and $p->{'agentnum'} =~ /^(\d+)$/ ) {
 103     $agentnum = $1;
 104   }
 105   $p->{'agentnum'} = $agentnum;
 106
 107   my $conf = new FS::Conf;
 108
 109   #false laziness w/Signup.pm
 110
 111   my $skin_info_cache_agent = _cache->get("skin_info_cache_agent$agentnum");
 112
 113   if ( $skin_info_cache_agent ) {
 114
 115     warn "$me loading cached skin info for agentnum $agentnum\n"
 116       if $DEBUG > 1;
 117
 118   } else {
 119
 120     warn "$me populating skin info cache for agentnum $agentnum\n"
 121       if $DEBUG > 1;
 122
 123     $skin_info_cache_agent = {
 124       'agentnum' => $agentnum,
 125       ( map { $_ => scalar( $conf->config($_, $agentnum) ) }
 126         qw( company_name date_format ) ),
 127       ( map { $_ => scalar( $conf->config("selfservice-$_", $agentnum ) ) }
 128         qw( body_bgcolor box_bgcolor stripe1_bgcolor stripe2_bgcolor
 129             text_color link_color vlink_color hlink_color alink_color
 130             font title_color title_align title_size menu_bgcolor menu_fontsize
 131           )
 132       ),
 133       'menu_disable' => [ $conf->config('selfservice-menu_disable',$agentnum) ],
 134       ( map { $_ => $conf->exists("selfservice-$_", $agentnum ) }
 135         qw( menu_skipblanks menu_skipheadings menu_nounderline no_logo enable_payment_without_balance )
 136       ),
 137       ( map { $_ => scalar($conf->config_binary("selfservice-$_", $agentnum)) }
 138         qw( title_left_image title_right_image
 139             menu_top_image menu_body_image menu_bottom_image
 140           )
 141       ),
 142       'logo' => scalar($conf->config_binary('logo.png', $agentnum )),
 143       ( map { $_ => join("\n", $conf->config("selfservice-$_", $agentnum ) ) }
 144         qw( head body_header body_footer company_address ) ),
 145       'money_char' => $conf->config("money_char") || '$',
 146       'menu' => join("\n", $conf->config("ng_selfservice-menu", $agentnum ) ) ||
 147                 'main.php Home
 148
 149                  services.php Services
 150                  services.php My Services
 151                  services_new.php Order a new service
 152
 153                  personal.php Profile
 154                  personal.php Personal Information
 155                  password.php Change Password
 156
 157                  payment.php Payments
 158                  payment_cc.php Credit Card Payment
 159                  payment_ach.php Electronic Check Payment
 160                  payment_paypal.php PayPal Payment
 161                  payment_webpay.php Webpay Payments
 162
 163                  usage.php Usage
 164                  usage_data.php Data usage
 165                  usage_cdr.php Call usage
 166
 167                  tickets.php Help Desk
 168                  tickets.php Open Tickets
 169                  tickets_resolved.php Resolved Tickets
 170                  ticket_create.php Create a new ticket
 171
 172                  docs.php FAQs
 173
 174                  logout.php Logout
 175                 ',
 176     };
 177
 178     _cache->set("skin_info_cache_agent$agentnum", $skin_info_cache_agent);
 179
 180   }
 181
 182   #{ %$skin_info_cache_agent };
 183   $skin_info_cache_agent;
 184
 185 }
 186
 187 sub login_info {
 188   my $p = shift;
 189
 190   my $conf = new FS::Conf;
 191
 192   my %info = (
 193     %{ skin_info($p) },
 194     'phone_login'  => $conf->exists('selfservice_server-phone_login'),
 195     'single_domain'=> scalar($conf->config('selfservice_server-single_domain')),
 196     'banner_url'       => scalar($conf->config('selfservice-login_banner_url')),
 197     'banner_image_md5' =>
 198       md5_hex($conf->config_binary('selfservice-login_banner_image')),
 199   );
 200
 201   return \%info;
 202
 203 }
 204
 205 sub login_banner_image {
 206   my $p = shift;
 207   my $conf = new FS::Conf;
 208   my $image = $conf->config_binary('selfservice-login_banner_image');
 209   return {
 210     'md5'   => md5_hex($image),
 211     'image' => $image,
 212   };
 213 }
 214
 215 #false laziness w/FS::ClientAPI::passwd::passwd
 216 sub login {
 217   my $p = shift;
 218
 219   my $conf = new FS::Conf;
 220
 221   my $svc_x = '';
 222   my $session = {};
 223   if ( $p->{'domain'} eq 'svc_phone'
 224        && $conf->exists('selfservice_server-phone_login') ) {
 225
 226     my $svc_phone = qsearchs( 'svc_phone', { 'phonenum' => $p->{'username'} } );
 227     return { error => 'Number not found.' } unless $svc_phone;
 228
 229     #XXX?
 230     #my $pkg_svc = $svc_acct->cust_svc->pkg_svc;
 231     #return { error => 'Only primary user may log in.' }
 232     #  if $conf->exists('selfservice_server-primary_only')
 233     #    && ( ! $pkg_svc || $pkg_svc->primary_svc ne 'Y' );
 234
 235     return { error => 'Incorrect PIN.' }
 236       unless $svc_phone->check_pin($p->{'password'});
 237
 238     $svc_x = $svc_phone;
 239
 240   } elsif ( $p->{email}
 241               && (my $contact = FS::contact->by_selfservice_email($p->{email}))
 242           )
 243   {
 244     return { error => 'Incorrect contact password.' }
 245       unless $contact->authenticate_password($p->{'password'});
 246
 247     $session->{'contactnum'} = $contact->contactnum;
 248
 249     my @cust_contact = grep $_->selfservice_access, $contact->cust_contact;
 250     if ( scalar(@cust_contact) == 1 ) {
 251       $session->{'custnum'} = $cust_contact[0]->custnum;
 252     } elsif ( scalar(@cust_contact) ) {
 253       $session->{'customers'} = { map { $_->custnum => $_->cust_main->name }
 254                                     @cust_contact
 255                                 };
 256     } else {
 257       return { error => 'No customer self-service access for contact' }; #??
 258     }
 259
 260   } else {
 261
 262     ( $p->{username}, $p->{domain} ) = split('@', $p->{email}) if $p->{email};
 263
 264     my $svc_domain = qsearchs('svc_domain', { 'domain' => $p->{'domain'} } )
 265       or return { error => 'Domain '. $p->{'domain'}. ' not found' };
 266
 267     my @svc_acct = qsearch( 'svc_acct', { 'username'  => $p->{'username'},
 268                                           'domsvc'    => $svc_domain->svcnum, }
 269                           );
 270
 271     if ( $conf->exists('selfservice_server-login_svcpart') ) {
 272       my @svcpart = $conf->config('selfservice_server-login_svcpart');
 273       @svc_acct = grep { my $svcpart = $_->cust_svc->svcpart;
 274                          scalar( grep( $_ eq $svcpart, @svcpart ) );
 275                        }
 276                     @svc_acct;
 277     }
 278
 279     if ( $conf->exists('selfservice_server-primary_only') ) {
 280         @svc_acct =
 281           grep {
 282             my $cust_svc = $_->cust_svc;
 283             $cust_svc->cust_pkg->part_pkg->svcpart([qw( svc_acct svc_phone )])
 284               == $cust_svc->svcpart
 285           }
 286           @svc_acct;
 287     }
 288
 289     return { error => 'User not found.' } unless @svc_acct;
 290
 291     return { error => 'Multiple users.' } if scalar(@svc_acct) > 1;
 292
 293     my $svc_acct = $svc_acct[0];
 294
 295     if ( $conf->exists('selfservice_server-login_svcpart') ) {
 296       my @svcpart = $conf->config('selfservice_server-login_svcpart');
 297       my $svcpart = $svc_acct->cust_svc->svcpart;
 298       return { error => 'Invalid user.' }
 299         unless grep($_ eq $svcpart, @svcpart);
 300     }
 301
 302     return { error => 'Incorrect password.' }
 303       unless $svc_acct->check_password($p->{'password'});
 304
 305     $svc_x = $svc_acct;
 306
 307   }
 308
 309   if ( $svc_x ) {
 310
 311     $session->{'svcnum'} = $svc_x->svcnum;
 312
 313     my $cust_svc = $svc_x->cust_svc;
 314     my $cust_pkg = $cust_svc->cust_pkg;
 315     if ( $cust_pkg ) {
 316       my $cust_main = $cust_pkg->cust_main;
 317       $session->{'custnum'} = $cust_main->custnum;
 318       if ( $conf->exists('pkg-balances') ) {
 319         my @cust_pkg = grep { $_->part_pkg->freq !~ /^(0|$)/ }
 320                             $cust_main->ncancelled_pkgs;
 321         $session->{'pkgnum'} = $cust_pkg->pkgnum
 322           if scalar(@cust_pkg) > 1;
 323       }
 324     }
 325
 326     #my $pkg_svc = $svc_acct->cust_svc->pkg_svc;
 327     #return { error => 'Only primary user may log in.' }
 328     #  if $conf->exists('selfservice_server-primary_only')
 329     #    && ( ! $pkg_svc || $pkg_svc->primary_svc ne 'Y' );
 330     my $part_pkg = $cust_pkg->part_pkg;
 331     return { error => 'Only primary user may log in.' }
 332       if $conf->exists('selfservice_server-primary_only')
 333          && $cust_svc->svcpart != $part_pkg->svcpart([qw( svc_acct svc_phone )]);
 334
 335   }
 336
 337   my $session_id;
 338   do {
 339     $session_id = sha512_hex(time(). {}. rand(). $$)
 340   } until ( ! defined _cache->get($session_id) ); #just in case
 341
 342   my $timeout = $conf->config('selfservice-session_timeout') || '1 hour';
 343   _cache->set( $session_id, $session, $timeout );
 344
 345   return { 'error'      => '',
 346            'session_id' => $session_id,
 347            %$session,
 348          };
 349 }
 350
 351 sub logout {
 352   my $p = shift;
 353   my $skin_info = skin_info($p);
 354   if ( $p->{'session_id'} ) {
 355     _cache->remove($p->{'session_id'});
 356     return { %$skin_info, 'error' => '' };
 357   } else {
 358     return { %$skin_info, 'error' => "Can't resume session" }; #better error message
 359   }
 360 }
 361
 362 sub switch_acct {
 363   my $p = shift;
 364
 365   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 366   return { 'error' => $session } if $context eq 'error';
 367
 368   my $svc_acct = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_acct' )
 369     or return { 'error' => "Service not found" };
 370
 371   $session->{'svcnum'} = $svc_acct->svcnum;
 372
 373   my $conf = new FS::Conf;
 374   my $timeout = $conf->config('selfservice-session_timeout') || '1 hour';
 375   _cache->set( $p->{'session_id'}, $session, $timeout );
 376
 377   return { 'error' => '' };
 378
 379 }
 380
 381 sub switch_cust {
 382   my $p = shift;
 383   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 384   return { 'error' => $session } if $context eq 'error';
 385
 386   $session->{'custnum'} = $p->{'custnum'}
 387     if exists $session->{'customers'}{ $p->{'custnum'} };
 388
 389   my $conf = new FS::Conf;
 390   my $timeout = $conf->config('selfservice-session_timeout') || '1 hour';
 391   _cache->set( $p->{'session_id'}, $session, $timeout );
 392
 393   return { 'error'      => '',
 394            %{ customer_info( { session_id=>$p->{'session_id'} } ) },
 395          };
 396 }
 397
 398 sub payment_gateway {
 399   # internal use only
 400   # takes a cust_main and a cust_payby entry, returns the payment_gateway
 401   my $conf = new FS::Conf;
 402   my $cust_main = shift;
 403   my $cust_payby = shift;
 404   return '' if ! FS::payby->realtime($cust_payby);
 405   my $pg = $cust_main->agent->payment_gateway(
 406     'method'  => FS::payby->payby2bop($cust_payby),
 407     'nofatal' => 1
 408   );
 409   return $pg;
 410 }
 411
 412 sub access_info {
 413   my $p = shift;
 414
 415   my $conf = new FS::Conf;
 416
 417   my $info = skin_info($p);
 418
 419   use vars qw( $cust_paybys ); #cache for performance
 420   unless ( $cust_paybys ) {
 421
 422     my %cust_paybys = map { $_ => 1 }
 423                       map { FS::payby->payby2payment($_) }
 424                           $conf->config('signup_server-payby');
 425
 426     $cust_paybys = [ keys %cust_paybys ];
 427
 428   }
 429   $info->{'cust_paybys'} = $cust_paybys;
 430
 431   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 432   return { 'error' => $session } if $context eq 'error';
 433
 434   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } );
 435
 436   $info->{'hide_payment_fields'} = [
 437     map {
 438       my $pg = $cust_main && payment_gateway($cust_main, $_);
 439       $pg && $pg->gateway_namespace eq 'Business::OnlineThirdPartyPayment';
 440     } @{ $info->{cust_paybys} }
 441   ];
 442
 443   $info->{'self_suspend_reason'} =
 444       $conf->config('selfservice-self_suspend_reason',
 445                       $cust_main ? $cust_main->agentnum : ''
 446                    );
 447
 448   $info->{'edit_ticket_subject'} =
 449       $conf->exists('ticket_system-selfservice_edit_subject') &&
 450       $cust_main && $cust_main->edit_subject;
 451
 452   $info->{'timeout'} = $conf->config('selfservice-timeout') || 3600;
 453
 454   $info->{'hide_usage'} = $conf->exists('selfservice_hide-usage');
 455
 456   return { %$info,
 457            'custnum'       => $custnum,
 458            'access_pkgnum' => $session->{'pkgnum'},
 459            'access_svcnum' => $session->{'svcnum'},
 460          };
 461 }
 462
 463 sub customer_info {
 464   my $p = shift;
 465
 466   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 467   return { 'error' => $session } if $context eq 'error';
 468
 469   my %return;
 470
 471   my $conf = new FS::Conf;
 472   $return{'require_address2'} = $conf->exists('cust_main-require_address2');
 473
 474 #  if ( $FS::TicketSystem::system ) {
 475 #    warn "$me customer_info: initializing ticket system\n" if $DEBUG;
 476 #    FS::TicketSystem->init();
 477 #  }
 478
 479   if ( $custnum ) { #customer record
 480
 481     %return = ( %return, %{ customer_info_short($p) } );
 482
 483     #redundant with customer_info_short, but we need it for several things below
 484     my $search = { 'custnum' => $custnum };
 485     $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
 486     my $cust_main = qsearchs('cust_main', $search )
 487       or return { 'error' => "customer_info: unknown custnum $custnum" };
 488
 489     my $list_tickets = list_tickets($p);
 490     $return{'tickets'} = $list_tickets->{'tickets'};
 491
 492     if ( $session->{'pkgnum'} ) {
 493       #XXX open invoices in the pkg-balances case
 494     } else {
 495       $return{'money_char'} = $conf->config("money_char") || '$';
 496       my @open = map {
 497                        {
 498                          invnum     => $_->invnum,
 499                          date       => time2str("%b %o, %Y", $_->_date),
 500                          owed       => $_->owed,
 501                          charged    => $_->charged,
 502                        };
 503                      } $cust_main->open_cust_bill;
 504       $return{open_invoices} = \@open;
 505
 506       my $sql = 'SELECT MAX(_date) FROM cust_bill WHERE custnum = ?';
 507       my $sth = dbh->prepare($sql) or die  dbh->errstr;
 508       $sth->execute($custnum)      or die $sth->errstr;
 509       $return{'last_invoice_date'} = $sth->fetchrow_arrayref->[0];
 510       $return{'last_invoice_date_pretty'} =
 511         time2str('%m/%d/%Y', $return{'last_invoice_date'} );
 512     }
 513
 514     #customer_info_short always has nobalance on..
 515     $return{small_custview} =
 516       small_custview( $cust_main,
 517                       $return{countrydefault},
 518                       ( $session->{'pkgnum'} ? 1 : 0 ), #nobalance
 519                     );
 520
 521     $return{has_ship_address} = $cust_main->has_ship_address;
 522     $return{status} = $cust_main->status_label; #$cust_main->status; #better to break anyone obscurely testing for strings in self-service than to have to upgrade every front-end to get the new status to display
 523     $return{statuscolor} = $cust_main->statuscolor;
 524     $return{status_label} = $cust_main->status_label;
 525
 526     # compatibility: some places in selfservice use this to determine
 527     # if there's a ship address
 528     if ( $return{has_ship_address} ) {
 529       $return{ship_last}  = $cust_main->last;
 530       $return{ship_first} = $cust_main->first;
 531     }
 532
 533     if (scalar($conf->config('support_packages'))) {
 534       my @support_services = ();
 535       foreach ($cust_main->support_services) {
 536         my $seconds = $_->svc_x->seconds || 0;
 537         my $time_remaining = (($seconds < 0) ? '-' : '' ).
 538                              int(abs($seconds)/3600)."h".
 539                              sprintf("%02d",(abs($seconds)%3600)/60)."m";
 540         my $cust_pkg = $_->cust_pkg;
 541         my $pkgnum = '';
 542         my $pkg = '';
 543         $pkgnum = $cust_pkg->pkgnum if $cust_pkg;
 544         $pkg = $cust_pkg->part_pkg->pkg if $cust_pkg;
 545         push @support_services, { svcnum => $_->svcnum,
 546                                   time => $time_remaining,
 547                                   pkgnum => $pkgnum,
 548                                   pkg => $pkg,
 549                                 };
 550       }
 551       $return{support_services} = \@support_services;
 552     }
 553
 554     if ( $conf->config('prepayment_discounts-credit_type') ) {
 555       #need to eval?
 556       $return{discount_terms_hash} = { $cust_main->discount_terms_hash };
 557     }
 558
 559   } elsif ( $session->{'svcnum'} ) { #no customer record
 560
 561     my $svc_acct = qsearchs('svc_acct', { 'svcnum' => $session->{'svcnum'} } )
 562       or die "unknown svcnum";
 563     $return{name} = $svc_acct->email;
 564
 565   } else {
 566
 567     return { 'error' => 'Expired session' }; #XXX redirect to login w/this err!
 568
 569   }
 570
 571   return { 'error'   => '',
 572            'custnum' => $custnum,
 573            %return,
 574          };
 575
 576 }
 577
 578 sub customer_info_short {
 579   my $p = shift;
 580
 581   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 582   return { 'error' => $session } if $context eq 'error';
 583
 584   my %return;
 585
 586   my $conf = new FS::Conf;
 587
 588   if ( $custnum ) { #customer record
 589
 590     my $search = { 'custnum' => $custnum };
 591     $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
 592     my $cust_main = qsearchs('cust_main', $search )
 593       or return { 'error' => "customer_info_short: unknown custnum $custnum" };
 594
 595     $return{display_custnum} = $cust_main->display_custnum;
 596     $return{max_invnum}      = $cust_main->max_invnum;
 597
 598     if ( $session->{'pkgnum'} ) {
 599       $return{balance} = $cust_main->balance_pkgnum( $session->{'pkgnum'} );
 600       #next_bill_date from cust_pkg?
 601     } else {
 602       $return{balance} = $cust_main->balance;
 603       $return{next_bill_date} = $cust_main->next_bill_date;
 604       $return{next_bill_date_pretty} =
 605         $return{next_bill_date} ? time2str('%m/%d/%Y', $return{next_bill_date} )
 606                                 : '(none)';
 607     }
 608     $return{balance_pretty} = money_pretty($return{balance});
 609
 610     $return{countrydefault} = scalar($conf->config('countrydefault'));
 611
 612     $return{small_custview} =
 613       small_custview( $cust_main,
 614                       $return{countrydefault},
 615                       1, ##nobalance
 616                     );
 617
 618     $return{first}  = $cust_main->first;
 619     $return{'last'} = $cust_main->get('last');
 620     $return{name}   = $cust_main->first. ' '. $cust_main->get('last');
 621
 622     #none of these are terribly expensive if we want 'em...
 623     for (@cust_main_editable_fields) {
 624       $return{$_} = $cust_main->get($_);
 625     }
 626     #maybe a little more expensive, but it should be cached by now
 627     for (@location_editable_fields) {
 628       $return{$_} = $cust_main->bill_location->get($_)
 629         if $cust_main->bill_locationnum;
 630       $return{'ship_'.$_} = $cust_main->ship_location->get($_)
 631         if $cust_main->ship_locationnum;
 632     }
 633
 634     my @invoicing_list = $cust_main->invoicing_list;
 635     $return{'invoicing_list'} =
 636       join(', ', grep { $_ !~ /^(POST|FAX)$/ } @invoicing_list );
 637     $return{'postal_invoicing'} =
 638       0 < ( grep { $_ eq 'POST' } @invoicing_list );
 639
 640     if ( $session->{'svcnum'} ) {
 641       my $cust_svc = qsearchs('cust_svc', { 'svcnum' => $session->{'svcnum'} });
 642       $return{'svc_label'} = ($cust_svc->label)[1] if $cust_svc;
 643       $return{'svcnum'} = $session->{'svcnum'};
 644     }
 645
 646   } elsif ( $session->{'svcnum'} ) { #no customer record
 647
 648     #uuh, not supproted yet... die?
 649     return { 'error' => 'customer_info_short not yet supported as agent' };
 650
 651   } else {
 652
 653     return { 'error' => 'Expired session' }; #XXX redirect to login w/this err!
 654
 655   }
 656
 657   # this is here because this routine is called by both fs_ and ng_ main pages, where it appears
 658   # it is not customer-specific, though it is only shown to authenticated customers
 659   # it is not currently agent-specific, though at some point it might be
 660   $return{'announcement'} = join(' ',$conf->config('selfservice-announcement')) || '';
 661
 662   return { 'error'          => '',
 663            'custnum'        => $custnum,
 664            %return,
 665          };
 666 }
 667
 668 sub customer_recurring {
 669   my $p = shift;
 670
 671   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 672   return { 'error' => $session } if $context eq 'error';
 673
 674   my %return;
 675
 676   my $conf = new FS::Conf;
 677
 678   my $search = { 'custnum' => $custnum };
 679   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
 680   my $cust_main = qsearchs('cust_main', $search )
 681     or return { 'error' => "customer_info_short: unknown custnum $custnum" };
 682
 683   $return{'display_recurring'} = [ $cust_main->display_recurring ];
 684
 685   return { 'error'          => '',
 686            'custnum'        => $custnum,
 687            %return,
 688          };
 689 }
 690
 691 sub billing_history {
 692   my $p = shift;
 693
 694   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 695   return { 'error' => $session } if $context eq 'error';
 696
 697   return { 'error' => 'No customer' } unless $custnum;
 698
 699   my $search = { 'custnum' => $custnum };
 700   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
 701   my $cust_main = qsearchs('cust_main', $search )
 702     or return { 'error' => "unknown custnum $custnum" };
 703
 704   my %return = ();
 705
 706   if ( $session->{'pkgnum'} ) {
 707     #$return{balance} = $cust_main->balance_pkgnum( $session->{'pkgnum'} );
 708     #next_bill_date from cust_pkg?
 709     return { 'error' => 'No history for package' };
 710   }
 711
 712   $return{balance} = $cust_main->balance;
 713   $return{balance_pretty} = money_pretty($return{balance});
 714   $return{next_bill_date} = $cust_main->next_bill_date;
 715   $return{next_bill_date_pretty} =
 716     $return{next_bill_date} ? time2str('%m/%d/%Y', $return{next_bill_date} )
 717                             : '(none)';
 718
 719   my $conf = new FS::Conf;
 720
 721   $return{'history'} = [
 722     $cust_main->payment_history(
 723       'line_items' => $conf->exists('selfservice-billing_history-line_items'),
 724       'reverse_sort' => 1,
 725     )
 726   ];
 727
 728   $return{'money_char'} = $conf->config("money_char") || '$',
 729
 730   return \%return;
 731
 732 }
 733
 734 sub edit_info {
 735   my $p = shift;
 736   my $session = _cache->get($p->{'session_id'})
 737     or return { 'error' => "Can't resume session" }; #better error message
 738
 739   my $custnum = $session->{'custnum'}
 740     or return { 'error' => "no customer record" };
 741
 742   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 743     or return { 'error' => "unknown custnum $custnum" };
 744
 745   my $conf = new FS::Conf;
 746   if (($p->{payby} eq "CHEK" || $p->{payby} eq "DCHEK") && $conf->exists('selfservice-ACH_info_readonly')) {
 747     return { 'error' => "You do not have authority to add a bank account" };
 748   }
 749
 750   my $new = new FS::cust_main { $cust_main->hash };
 751
 752   $new->set( $_ => $p->{$_} )
 753     foreach grep { exists $p->{$_} } @cust_main_editable_fields;
 754
 755   if ( exists($p->{address1}) ) {
 756     my $bill_location = FS::cust_location->new({
 757         map { $_ => $p->{$_} } @location_editable_fields
 758     });
 759     # if this is unchanged from before, cust_main::replace will ignore it
 760     $new->set('bill_location' => $bill_location);
 761   }
 762
 763   if ( exists($p->{ship_address1}) ) {
 764     my $ship_location = FS::cust_location->new({
 765         map { $_ => $p->{"ship_$_"} } @location_editable_fields
 766     });
 767     if ( !grep { length($p->{"ship_$_"}) } @location_editable_fields ) {
 768       # Selfservice unfortunately tries to indicate "same as billing
 769       # address" by sending all fields empty.  Did this ever work?
 770       $ship_location = $cust_main->bill_location;
 771     }
 772     $new->set('ship_location' => $ship_location);
 773   }
 774   # but if it hasn't been passed in at all, leave ship_location alone--
 775   # DON'T change it to match bill_location.
 776
 777   my @invoicing_list;
 778   if ( exists $p->{'invoicing_list'} || exists $p->{'postal_invoicing'} ) {
 779     #false laziness with httemplate/edit/process/cust_main.cgi
 780     @invoicing_list = split( /\s*\,\s*/, $p->{'invoicing_list'} );
 781     push @invoicing_list, 'POST' if $p->{'postal_invoicing'};
 782   } else {
 783     @invoicing_list = $cust_main->invoicing_list;
 784   }
 785
 786   my $error = $new->replace($cust_main, \@invoicing_list);
 787   return { 'error' => $error } if $error;
 788   #$cust_main = $new;
 789
 790   return { 'error' => '' };
 791 }
 792
 793 sub payment_info {
 794   my $p = shift;
 795   my $session = _cache->get($p->{'session_id'})
 796     or return { 'error' => "Can't resume session" }; #better error message
 797
 798   ##
 799   #generic
 800   ##
 801
 802   my $conf = new FS::Conf;
 803   use vars qw($payment_info); #cache for performance
 804   unless ( $payment_info ) {
 805
 806     my %states = map { $_->state => 1 }
 807                    qsearch('cust_main_county', {
 808                      'country' => $conf->config('countrydefault') || 'US'
 809                    } );
 810
 811     my %cust_paybys = map { $_ => 1 }
 812                       map { FS::payby->payby2payment($_) }
 813                           $conf->config('signup_server-payby');
 814
 815     my @cust_paybys = keys %cust_paybys;
 816
 817     $payment_info = {
 818
 819       #list all counties/states/countries
 820       'cust_main_county' =>
 821         [ map { $_->hashref } qsearch('cust_main_county', {}) ],
 822
 823       #shortcut for one-country folks
 824       'states' =>
 825         [ sort { $a cmp $b } keys %states ],
 826
 827       'card_types' => card_types(),
 828
 829       'withcvv'            => $conf->exists('selfservice-require_cvv'), #or enable optional cvv?
 830       'require_cvv'        => $conf->exists('selfservice-require_cvv'),
 831       'onfile_require_cvv' => $conf->exists('selfservice-onfile_require_cvv'),
 832
 833       'paytypes' => [ FS::cust_payby::paytypes ],
 834
 835       'paybys' => [ $conf->config('signup_server-payby') ],
 836       'cust_paybys' => \@cust_paybys,
 837
 838       'stateid_label' => FS::Msgcat::_gettext('stateid'),
 839       'stateid_state_label' => FS::Msgcat::_gettext('stateid_state'),
 840
 841       'show_ss'  => $conf->exists('show_ss'),
 842       'show_stateid' => $conf->exists('show_stateid'),
 843       'show_paystate' => $conf->exists('show_bankstate'),
 844
 845       'save_unchecked' => $conf->exists('selfservice-save_unchecked'),
 846       'ach_read_only' => $conf->exists('selfservice-ACH_info_readonly'),
 847
 848     };
 849
 850   }
 851
 852   ##
 853   #customer-specific
 854   ##
 855
 856   my %return = %$payment_info;
 857
 858   delete $return{'cust_main_county'} if $p->{'omit_cust_main_county'};
 859
 860   my $custnum = $session->{'custnum'};
 861
 862   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 863     or return { 'error' => "unknown custnum $custnum" };
 864
 865   $return{'hide_payment_fields'} = [
 866     map {
 867       my $pg = payment_gateway($cust_main, $_);
 868       $pg && $pg->gateway_namespace eq 'Business::OnlineThirdPartyPayment';
 869     } @{ $return{cust_paybys} }
 870   ];
 871
 872   $return{balance} = $cust_main->balance; #XXX pkg-balances?
 873
 874   $return{$_} = $cust_main->bill_location->get($_)
 875     for qw(address1 address2 city state zip);
 876
 877   # look for stored cust_payby info
 878   #   only if we've been given a clear payment_payby (to avoid payname conflicts)
 879   if ($p->{'payment_payby'} =~ /^(CARD|CHEK)$/) {
 880     my @search_payby = ($p->{'payment_payby'} eq 'CARD') ? ('CARD','DCRD') : ('CHEK','DCHK');
 881     my ($cust_payby) = $cust_main->cust_payby(@search_payby);
 882     if ($cust_payby) {
 883       $return{payname} = $cust_payby->payname
 884                          || ( $cust_main->first. ' '. $cust_main->get('last') );
 885
 886       if ( $cust_payby->payby =~ /^(CARD|DCRD)$/ ) {
 887         $return{card_type} = cardtype($cust_payby->payinfo);
 888         $return{payinfo} = $cust_payby->paymask;
 889
 890         @return{'month', 'year'} = $cust_payby->paydate_monthyear;
 891
 892       }
 893
 894       if ( $cust_payby->payby =~ /^(CHEK|DCHK)$/ ) {
 895         my ($payinfo1, $payinfo2) = split '@', $cust_payby->paymask;
 896         $return{payinfo1} = $payinfo1;
 897         $return{payinfo2} = $payinfo2;
 898         $return{paytype}  = $cust_payby->paytype;
 899         $return{paystate} = $cust_payby->paystate;
 900         $return{payname}  = $cust_payby->payname;       # override 'first/last name' default from above, if any.  Is instution-name here.  (#15819)
 901       }
 902     }
 903   }
 904
 905   if ( $conf->config('prepayment_discounts-credit_type') ) {
 906     #need to eval?
 907     $return{discount_terms_hash} = { $cust_main->discount_terms_hash };
 908   }
 909
 910   #doubleclick protection
 911   my $_date = time;
 912   $return{payunique} = "webui-MyAccount-$_date-$$-". rand() * 2**32; #new
 913   $return{paybatch} = $return{payunique};  #back compat
 914
 915   $return{credit_card_surcharge_percentage} = $conf->config('credit-card-surcharge-percentage', $cust_main->agentnum);
 916
 917   return { 'error' => '',
 918            %return,
 919          };
 920
 921 }
 922
 923 #some false laziness with httemplate/process/payment.cgi - look there for
 924 #ACH and CVV support stuff
 925
 926 sub validate_payment {
 927   my $p = shift;
 928
 929   my $session = _cache->get($p->{'session_id'})
 930     or return { 'error' => "Can't resume session" }; #better error message
 931
 932   my $custnum = $session->{'custnum'};
 933
 934   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 935     or return { 'error' => "unknown custnum $custnum" };
 936
 937   $p->{'amount'} =~ /^\s*(\d+(\.\d{2})?)\s*$/
 938     or return { 'error' => gettext('illegal_amount') };
 939   my $amount = $1;
 940   return { error => 'Amount must be greater than 0' } unless $amount > 0;
 941
 942   #false laziness w/tr-amount_fee.html, but we don't want selfservice users
 943   #changing the hidden form values
 944   my $conf = new FS::Conf;
 945   my $fee_display = $conf->config('selfservice_process-display') || 'add';
 946   my $fee_pkgpart = $conf->config('selfservice_process-pkgpart', $cust_main->agentnum);
 947   my $fee_skip_first = $conf->exists('selfservice_process-skip_first');
 948   if ( $fee_display eq 'add'
 949          and $fee_pkgpart
 950          and ! $fee_skip_first || scalar($cust_main->cust_pay)
 951      )
 952   {
 953     my $fee_pkg = qsearchs('part_pkg', { pkgpart=>$fee_pkgpart } );
 954     $amount = sprintf('%.2f', $amount + $fee_pkg->option('setup_fee') );
 955   }
 956
 957   $p->{'discount_term'} =~ /^\s*(\d*)\s*$/
 958     or return { 'error' => gettext('illegal_discount_term'). ': '. $p->{'discount_term'} };
 959   my $discount_term = $1;
 960
 961   $p->{'payname'} =~ /^([\w \,\.\-\']+)$/
 962     or return { 'error' => gettext('illegal_name'). " payname: ". $p->{'payname'} };
 963   my $payname = $1;
 964
 965   $p->{'payunique'} =~ /^([\w \!\@\#\$\%\&\(\)\-\+\;\:\'\"\,\.\?\/\=]*)$/
 966     or return { 'error' => gettext('illegal_text'). " payunique: ". $p->{'payunique'} };
 967   my $payunique = $1;
 968
 969   $p->{'paybatch'} =~ /^([\w \!\@\#\$\%\&\(\)\-\+\;\:\'\"\,\.\?\/\=]*)$/
 970     or return { 'error' => gettext('illegal_text'). " paybatch: ". $p->{'paybatch'} };
 971   my $paybatch = $1;
 972
 973   $payunique = $paybatch if ! length($payunique) && length($paybatch);
 974
 975   $p->{'payby'} ||= 'CARD';
 976   $p->{'payby'} =~ /^([A-Z]{4})$/
 977     or return { 'error' => "illegal_payby " . $p->{'payby'} };
 978   my $payby = $1;
 979
 980   #false laziness w/process/payment.cgi
 981   my $payinfo;
 982   my $paycvv = '';
 983   my $replace_cust_payby;
 984   if ( $payby eq 'CHEK' || $payby eq 'DCHK' ) {
 985
 986     $p->{'payinfo1'} =~ /^([\dx]+)$/
 987       or return { 'error' => "illegal account number ". $p->{'payinfo1'} };
 988     my $payinfo1 = $1;
 989      $p->{'payinfo2'} =~ /^([\dx]+)$/
 990       or return { 'error' => "illegal ABA/routing number ". $p->{'payinfo2'} };
 991     my $payinfo2 = $1;
 992     $payinfo = $payinfo1. '@'. $payinfo2;
 993
 994     my $achonfile = 0;
 995     foreach my $cust_payby ($cust_main->cust_payby('CHEK','DCHK')) {
 996       if ( $cust_payby->paymask eq $payinfo ) {
 997         $payinfo = $cust_payby->payinfo;
 998         $replace_cust_payby = $cust_payby;
 999         $achonfile = 1;
1000         last;
1001       }
1002     }
1003
1004     if ($conf->exists('selfservice-ACH_info_readonly') && !$achonfile) {
1005       return { 'error' => "You are not allowed to change your payment information." };
1006     }
1007
1008   } elsif ( $payby eq 'CARD' || $payby eq 'DCRD' ) {
1009
1010     $payinfo = $p->{'payinfo'};
1011
1012     my $onfile = 0;
1013
1014     #more intelligent matching will be needed here if you change
1015     #card_masking_method and don't remove existing paymasks
1016     foreach my $cust_payby ($cust_main->cust_payby('CARD','DCRD')) {
1017       if ( $cust_payby->paymask eq $payinfo ) {
1018         $payinfo = $cust_payby->payinfo;
1019         $replace_cust_payby = $cust_payby;
1020         $onfile = 1;
1021         last;
1022       }
1023     }
1024
1025     $payinfo =~ s/\D//g;
1026     $payinfo =~ /^(\d{13,19}|\d{8,9})$/
1027       or return { 'error' => gettext('invalid_card') }; # . ": ". $self->payinfo
1028     $payinfo = $1;
1029
1030     validate($payinfo)
1031       or return { 'error' => gettext('invalid_card') }; # . ": ". $self->payinfo
1032     return { 'error' => gettext('unknown_card_type') }
1033       if !$cust_main->tokenized($payinfo) && cardtype($payinfo) eq "Unknown";
1034
1035     if ( length($p->{'paycvv'}) && $p->{'paycvv'} !~ /^\s*$/ ) {
1036       if ( cardtype($payinfo) eq 'American Express card' ) {
1037         $p->{'paycvv'} =~ /^\s*(\d{4})\s*$/
1038           or return { 'error' => "CVV2 (CID) for American Express cards is four digits." };
1039         $paycvv = $1;
1040       } else {
1041         $p->{'paycvv'} =~ /^\s*(\d{3})\s*$/
1042           or return { 'error' => "CVV2 (CVC2/CID) is three digits." };
1043         $paycvv = $1;
1044       }
1045     } elsif ( $conf->exists('selfservice-onfile_require_cvv') ) {
1046       return { 'error' => 'CVV2 is required' };
1047     } elsif ( !$onfile && $conf->exists('selfservice-require_cvv') ) {
1048       return { 'error' => 'CVV2 is required' };
1049     }
1050
1051   } else {
1052     die "unknown payby $payby";
1053   }
1054
1055   my %payby2fields = (
1056     'CARD' => [ qw( paystart_month paystart_year payissue payip
1057                     address1 address2 city state zip country    ) ],
1058     'CHEK' => [ qw( ss paytype paystate stateid stateid_state payip ) ],
1059   );
1060
1061   my %replace = ( 'replace' => $replace_cust_payby, );
1062
1063   my $card_type = '';
1064   $card_type = cardtype($payinfo) if $payby eq 'CARD';
1065
1066   {
1067     'cust_main'      => $cust_main, #XXX or just custnum??
1068     'amount'         => sprintf('%.2f', $amount),
1069     'payby'          => $payby,
1070     'payinfo'        => $payinfo,
1071     'paymask'        => FS::payinfo_Mixin->mask_payinfo( $payby, $payinfo ),
1072     'card_type'      => $card_type,
1073     'paydate'        => $p->{'year'}. '-'. $p->{'month'}. '-01',
1074     'paydate_pretty' => $p->{'month'}. ' / '. $p->{'year'},
1075     'month'          => $p->{'month'},
1076     'year'           => $p->{'year'},
1077     'payname'        => $payname,
1078     'payunique'      => $payunique,
1079     'paybatch'       => $paybatch,
1080     'paycvv'         => $paycvv,
1081     'payname'        => $payname,
1082     'discount_term'  => $discount_term,
1083     'pkgnum'         => $session->{'pkgnum'},
1084     %replace,
1085     map { $_ => $p->{$_} } ( @{ $payby2fields{$payby} },
1086                              qw( save auto ),
1087                            )
1088   };
1089
1090 }
1091
1092 sub store_payment {
1093   my $p = shift;
1094
1095   my $validate = validate_payment($p);
1096   return $validate if $validate->{'error'};
1097
1098   my $conf = new FS::Conf;
1099   my $timeout = $conf->config('selfservice-session_timeout') || '1 hour'; #?
1100   _cache->set( 'payment_'.$p->{'session_id'}, $validate, $timeout );
1101
1102   +{ map { $_=>$validate->{$_} }
1103       qw( card_type paymask payname paydate_pretty month year amount
1104           address1 address2 city state zip country
1105         )
1106   };
1107
1108 }
1109
1110 sub process_stored_payment {
1111   my $p = shift;
1112
1113   my $session_id = $p->{'session_id'};
1114
1115   my $payment_info = _cache->get( "payment_$session_id" )
1116     or return { 'error' => "Can't resume session" }; #better error message
1117
1118   do_process_payment($payment_info);
1119
1120 }
1121
1122 sub process_payment {
1123   my $p = shift;
1124
1125   my $payment_info = validate_payment($p);
1126   return $payment_info if $payment_info->{'error'};
1127
1128   do_process_payment($payment_info);
1129
1130 }
1131
1132 sub do_process_payment {
1133   my $validate = shift;
1134
1135   my $cust_main = $validate->{'cust_main'};
1136
1137   my $amount = delete $validate->{'amount'};
1138   my $paynum = '';
1139
1140   my $payby = delete $validate->{'payby'};
1141
1142   if ( $validate->{'save'} ) {
1143
1144     my %saveopt;
1145     foreach my $field ( qw( auto payinfo paymask payname payip ) ) {
1146       $saveopt{$field} = $validate->{$field};
1147     }
1148
1149     if ( $payby eq 'CARD' ) {
1150       my $bill_location = FS::cust_location->new({
1151           map { $_ => $validate->{$_} }
1152           qw(address1 address2 city state country zip)
1153       });
1154       $saveopt{'bill_location'} = $bill_location;
1155       foreach my $field ( qw( paydate paystart_month paystart_year payissue ) ) {
1156         $saveopt{$field} = $validate->{$field};
1157       }
1158     } else {
1159       # stateid/stateid_state won't be saved, might be broken as of 4.x
1160       foreach my $field ( qw( paytype paystate ) ) {
1161         $saveopt{$field} = $validate->{$field};
1162       }
1163     }
1164
1165     my $error = $cust_main->save_cust_payby(
1166       'payment_payby' => $payby,
1167       'replace'       => $validate->{'replace'}, # cust_payby object to replace
1168       %saveopt
1169     );
1170
1171     if ( $error ) {
1172       #no, this causes customers to process their payments again
1173       #return { 'error' => $error };
1174       #XXX just warn verosely for now so i can figure out how these happen in
1175       # the first place, eventually should redirect them to the "change
1176       #address" page but indicate if the payment processed?
1177       delete($validate->{'payinfo'}); #don't want to log this!
1178       warn "WARNING: error changing customer info when processing payment (not returning to customer as a processing error): $error\n".
1179            "PAYBY: $payby\n".
1180            "SAVEOPT: ".Dumper(\%saveopt)."\n".
1181            "CUST_MAIN: ". Dumper($cust_main)."\n".
1182            "PACKET: ". Dumper($validate)."\n";
1183     }
1184   }
1185
1186   my $error = $cust_main->realtime_bop( $FS::payby::payby2bop{$payby}, $amount,
1187     'quiet'       => 1,
1188     'manual'      => 1,
1189     'selfservice' => 1,
1190     'paynum_ref'  => \$paynum,
1191     %$validate,
1192   );
1193   return { 'error' => $error } if $error;
1194
1195   #no error, so order the fee package if applicable...
1196   my $conf = new FS::Conf;
1197   my $fee_pkgpart = $conf->config('selfservice_process-pkgpart', $cust_main->agentnum);
1198   my $fee_skip_first = $conf->exists('selfservice_process-skip_first');
1199
1200   if ( $fee_pkgpart and ! $fee_skip_first || scalar($cust_main->cust_pay) ) {
1201
1202     my $cust_pkg = new FS::cust_pkg { 'pkgpart' => $fee_pkgpart };
1203
1204     $error = $cust_main->order_pkg( 'cust_pkg' => $cust_pkg );
1205     return { 'error' => "payment processed successfully, but error ordering fee: $error" }
1206       if $error;
1207
1208     #and generate an invoice for it now too
1209     $error = $cust_main->bill( 'pkg_list' => [ $cust_pkg ] );
1210     return { 'error' => "payment processed and fee ordered successfully, but error billing fee: $error" }
1211       if $error;
1212
1213   }
1214
1215   $cust_main->apply_payments;
1216
1217   my $cust_pay = '';
1218   my $receipt_html = '';
1219   if ($paynum) {
1220       # currently supported for realtime CC only; send receipt data to SS
1221       $cust_pay = qsearchs('cust_pay', { 'paynum' => $paynum } );
1222       if($cust_pay) {
1223         $receipt_html = qq!
1224 <TABLE BGCOLOR="#cccccc" BORDER=0 CELLSPACING=2>
1225
1226 <TR>
1227   <TD ALIGN="right">Payment#</TD>
1228   <TD BGCOLOR="#FFFFFF"><B>! . $cust_pay->paynum . qq!</B></TD>
1229 </TR>
1230
1231 <TR>
1232   <TD ALIGN="right">Date</TD>
1233
1234   <TD BGCOLOR="#FFFFFF"><B>! .
1235         time2str("%a&nbsp;%b&nbsp;%o,&nbsp;%Y&nbsp;%r", $cust_pay->_date)
1236                                                             . qq!</B></TD>
1237 </TR>
1238
1239
1240 <TR>
1241   <TD ALIGN="right">Amount</TD>
1242   <TD BGCOLOR="#FFFFFF"><B>! . sprintf('%.2f', $cust_pay->paid) . qq!</B></TD>
1243
1244 </TR>
1245
1246 <TR>
1247   <TD ALIGN="right">Payment method</TD>
1248   <TD BGCOLOR="#FFFFFF"><B>! . $cust_pay->payby_name .' #'. $cust_pay->paymask
1249                                                                 . qq!</B></TD>
1250 </TR>
1251
1252 </TABLE>
1253 !;
1254       }
1255   }
1256
1257   if ( $cust_pay ) {
1258
1259     return {
1260       'error'        => '',
1261       'amount'       => sprintf('%.2f', $cust_pay->paid),
1262       'date'         => $cust_pay->_date,
1263       'date_pretty'  => time2str('%Y-%m-%d', $cust_pay->_date),
1264       'time_pretty'  => time2str('%T', $cust_pay->_date),
1265       'auth_num'     => $cust_pay->auth,
1266       'order_num'    => $cust_pay->order_number,
1267       'receipt_html' => $receipt_html,
1268     };
1269
1270   } else {
1271
1272     return {
1273       'error'        => '',
1274       'receipt_html' => '',
1275     };
1276
1277   }
1278
1279 }
1280
1281 sub realtime_collect {
1282   my $p = shift;
1283
1284   my $session = _cache->get($p->{'session_id'})
1285     or return { 'error' => "Can't resume session" }; #better error message
1286
1287   my $custnum = $session->{'custnum'};
1288
1289   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1290     or return { 'error' => "unknown custnum $custnum" };
1291
1292   my $amount;
1293   if ( $p->{'amount'} ) {
1294     $amount = $p->{'amount'};
1295   }
1296   elsif ( $session->{'pkgnum'} ) {
1297     $amount = $cust_main->balance_pkgnum( $session->{'pkgnum'} );
1298   }
1299   else {
1300     $amount = $cust_main->balance;
1301   }
1302
1303   my $error = $cust_main->realtime_collect(
1304     'method'     => $p->{'method'},
1305     'amount'     => $amount,
1306     'pkgnum'     => $session->{'pkgnum'},
1307     'session_id' => $p->{'session_id'},
1308     'apply'      => 1,
1309     'selfservice'=> 1,
1310   );
1311   return { 'error' => $error } unless ref( $error );
1312
1313   return { 'error' => '', amount => $amount, %$error };
1314 }
1315
1316 sub start_thirdparty {
1317   my $p = shift;
1318   my $session = _cache->get($p->{'session_id'})
1319     or return { 'error' => "Can't resume session" }; #better error message
1320   my $custnum = $session->{'custnum'};
1321   my $cust_main = FS::cust_main->by_key($custnum);
1322
1323   my $amount = $p->{'amount'}
1324     or return { error => 'no amount' };
1325
1326   my $result = $cust_main->create_payment(
1327     'method'      => $p->{'method'},
1328     'amount'      => $p->{'amount'},
1329     'pkgnum'      => $session->{'pkgnum'},
1330     'session_id'  => $p->{'session_id'},
1331   );
1332
1333   if ( ref($result) ) { # hashref or error
1334     return $result;
1335   } else {
1336     return { error => $result };
1337   }
1338 }
1339
1340 sub finish_thirdparty {
1341   my $p = shift;
1342   my $session_id = delete $p->{'session_id'};
1343   my $session = _cache->get($session_id)
1344     or return { 'error' => "Can't resume session" };
1345   my $custnum = $session->{'custnum'};
1346   my $cust_main = FS::cust_main->by_key($custnum);
1347
1348   if ( $p->{_cancel} ) {
1349     # customer backed out of making a payment
1350     return $cust_main->cancel_payment( $session_id );
1351   }
1352   my $result = $cust_main->execute_payment( $session_id, %$p );
1353   if ( ref($result) ) {
1354     return $result;
1355   } else {
1356     return { error => $result };
1357   }
1358 }
1359
1360 sub process_payment_order_pkg {
1361   my $p = shift;
1362
1363   my $hr = process_payment($p);
1364   return $hr if $hr->{'error'};
1365
1366   order_pkg($p);
1367 }
1368
1369 sub process_payment_order_renew {
1370   my $p = shift;
1371
1372   my $hr = process_payment($p);
1373   return $hr if $hr->{'error'};
1374
1375   order_renew($p);
1376 }
1377
1378 sub process_prepay {
1379
1380   my $p = shift;
1381
1382   my $session = _cache->get($p->{'session_id'})
1383     or return { 'error' => "Can't resume session" }; #better error message
1384
1385   my %return;
1386
1387   my $custnum = $session->{'custnum'};
1388
1389   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1390     or return { 'error' => "unknown custnum $custnum" };
1391
1392   my( $amount, $seconds, $upbytes, $downbytes, $totalbytes ) = ( 0, 0, 0, 0, 0 );
1393   my $error = $cust_main->recharge_prepay( $p->{'prepaid_cardnum'},
1394                                            \$amount,
1395                                            \$seconds,
1396                                            \$upbytes,
1397                                            \$downbytes,
1398                                            \$totalbytes,
1399                                          );
1400
1401   return { 'error' => $error } if $error;
1402
1403   return { 'error'     => '',
1404            'amount'    => $amount,
1405            'seconds'   => $seconds,
1406            'duration'  => duration_exact($seconds),
1407            'upbytes'   => $upbytes,
1408            'upload'    => FS::UI::bytecount::bytecount_unexact($upbytes),
1409            'downbytes' => $downbytes,
1410            'download'  => FS::UI::bytecount::bytecount_unexact($downbytes),
1411            'totalbytes'=> $totalbytes,
1412            'totalload' => FS::UI::bytecount::bytecount_unexact($totalbytes),
1413          };
1414
1415 }
1416
1417 sub invoice {
1418   my $p = shift;
1419   my $session = _cache->get($p->{'session_id'})
1420     or return { 'error' => "Can't resume session" }; #better error message
1421
1422   my $custnum = $session->{'custnum'};
1423
1424   my $invnum = $p->{'invnum'};
1425
1426   my $cust_bill = qsearchs('cust_bill', { 'invnum'  => $invnum,
1427                                           'custnum' => $custnum } )
1428     or return { 'error' => "Can't find invnum" };
1429
1430   #my %return;
1431
1432   return { 'error'        => '',
1433            'invnum'       => $invnum,
1434            'invoice_text' => join('', $cust_bill->print_text ),
1435            'invoice_html' => $cust_bill->print_html( { unsquelch_cdr => 1 } ),
1436          };
1437
1438 }
1439
1440 sub invoice_pdf {
1441   my $p = shift;
1442   my $session = _cache->get($p->{'session_id'})
1443     or return { 'error' => "Can't resume session" }; #better error message
1444
1445   my $custnum = $session->{'custnum'};
1446
1447   my $invnum = $p->{'invnum'};
1448
1449   my $cust_bill = qsearchs('cust_bill', { 'invnum'  => $invnum,
1450                                           'custnum' => $custnum } )
1451     or return { 'error' => "Can't find invnum" };
1452
1453   #my %return;
1454
1455   return { 'error'       => '',
1456            'invnum'      => $invnum,
1457            'invoice_pdf' => $cust_bill->print_pdf({
1458                               'unsquelch_cdr' => 1,
1459                               'locale'        => $p->{'locale'},
1460                             }),
1461          };
1462
1463 }
1464
1465 sub legacy_invoice {
1466   my $p = shift;
1467   my $session = _cache->get($p->{'session_id'})
1468     or return { 'error' => "Can't resume session" }; #better error message
1469
1470   my $custnum = $session->{'custnum'};
1471
1472   my $legacyinvnum = $p->{'legacyinvnum'};
1473
1474   my %hash = (
1475     'legacyinvnum' => $legacyinvnum,
1476     'custnum'      => $custnum,
1477   );
1478
1479   my $legacy_cust_bill =
1480          qsearchs('legacy_cust_bill', { %hash, 'locale' => $p->{'locale'} } )
1481       || qsearchs('legacy_cust_bill', \%hash )
1482     or return { 'error' => "Can't find legacyinvnum" };
1483
1484   #my %return;
1485
1486   return { 'error'        => '',
1487            'legacyinvnum' => $legacyinvnum,
1488            'legacyid'     => $legacy_cust_bill->legacyid,
1489            'invoice_html' => $legacy_cust_bill->content_html,
1490          };
1491
1492 }
1493
1494 sub legacy_invoice_pdf {
1495   my $p = shift;
1496   my $session = _cache->get($p->{'session_id'})
1497     or return { 'error' => "Can't resume session" }; #better error message
1498
1499   my $custnum = $session->{'custnum'};
1500
1501   my $legacyinvnum = $p->{'legacyinvnum'};
1502
1503   my $legacy_cust_bill = qsearchs('legacy_cust_bill', {
1504     'legacyinvnum' => $legacyinvnum,
1505     'custnum'      => $custnum,
1506   }) or return { 'error' => "Can't find legacyinvnum" };
1507
1508   #my %return;
1509
1510   return { 'error'        => '',
1511            'legacyinvnum' => $legacyinvnum,
1512            'legacyid'     => $legacy_cust_bill->legacyid,
1513            'invoice_pdf'  => $legacy_cust_bill->content_pdf,
1514          };
1515
1516 }
1517
1518 sub invoice_logo {
1519   my $p = shift;
1520
1521   #sessioning for this?  how do we get the session id to the backend invoice
1522   # template so it can add it to the link, blah
1523
1524   my $agentnum = '';
1525   if ( $p->{'invnum'} ) {
1526     my $cust_bill = qsearchs('cust_bill', { 'invnum' => $p->{'invnum'} } )
1527       or return { 'error' => 'unknown invnum' };
1528     $agentnum = $cust_bill->cust_main->agentnum;
1529   }
1530
1531   my $templatename = $p->{'template'} || $p->{'templatename'};
1532
1533   #false laziness-ish w/view/cust_bill-logo.cgi
1534
1535   my $conf = new FS::Conf;
1536   if ( $templatename =~ /^([^\.\/]*)$/ && $conf->exists("logo_$1.png") ) {
1537     $templatename = "_$1";
1538   } else {
1539     $templatename = '';
1540   }
1541
1542   my $filename = "logo$templatename.png";
1543
1544   return { 'error'        => '',
1545            'logo'         => $conf->config_binary($filename, $agentnum),
1546            'content_type' => 'image/png', #should allow gif, jpg too
1547          };
1548 }
1549
1550 sub list_invoices {
1551   my $p = shift;
1552   my $session = _cache->get($p->{'session_id'})
1553     or return { 'error' => "Can't resume session" }; #better error message
1554
1555   my $custnum = $session->{'custnum'};
1556
1557   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1558     or return { 'error' => "unknown custnum $custnum" };
1559
1560   my $conf = new FS::Conf;
1561
1562   my @legacy_cust_bill = $cust_main->legacy_cust_bill;
1563
1564   my @cust_bill = grep ! $_->hide, $cust_main->cust_bill;
1565
1566   my $balance = 0;
1567   my $invoices = [
1568     map {
1569       #not super efficient, we also run cust_bill_pay/cust_credited inside owed
1570       my @payments_and_credits = sort {$b->_date <=> $a->_date} ($_->cust_bill_pay,$_->cust_credited);
1571       my $owed = $_->owed;
1572       $balance += $owed;
1573       +{ 'invnum'       => $_->invnum,
1574          '_date'        => $_->_date,
1575          'date'         => time2str("%b %o, %Y", $_->_date),
1576          'date_short'   => time2str("%m-%d-%Y",  $_->_date),
1577          'previous'     => sprintf('%.2f', ($_->previous)[0]),
1578          'charged'      => sprintf('%.2f', $_->charged),
1579          'owed'         => sprintf('%.2f', $owed),
1580          'balance'      => sprintf('%.2f', $balance),
1581          'lastpay'      => @payments_and_credits
1582                            ? time2str("%b %o, %Y", $payments_and_credits[0]->_date)
1583                            : '',
1584       }
1585     } @cust_bill
1586   ];
1587
1588   return  { 'error'       => '',
1589             'balance'     => $cust_main->balance,
1590             'money_char'  => $conf->config("money_char") || '$',
1591             'invoices'    => $invoices,
1592             'legacy_invoices' => [
1593               map {
1594                     +{ 'legacyinvnum' => $_->legacyinvnum,
1595                        'legacyid'     => $_->legacyid,
1596                        '_date'        => $_->_date,
1597                        'date'         => time2str("%b %o, %Y", $_->_date),
1598                        'date_short'   => time2str("%m-%d-%Y",  $_->_date),
1599                        'charged'      => sprintf('%.2f', $_->charged),
1600                        'has_content'  => (    length($_->content_pdf)
1601                                            || length($_->content_html) ),
1602                      }
1603                   }
1604                   @legacy_cust_bill
1605             ],
1606           };
1607 }
1608
1609 sub list_payments {
1610   my $p = shift;
1611   my $session = _cache->get($p->{'session_id'})
1612     or return { 'error' => "Can't resume session" }; #better error message
1613
1614   my $custnum = $session->{'custnum'};
1615
1616   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1617     or return { 'error' => "unknown custnum $custnum" };
1618
1619   return  { 'error'       => '',
1620             'balance'     => $cust_main->balance,
1621             'money_char'  => FS::Conf->new->config("money_char") || '$',
1622             'payments'    => [ map $_->SSAPI_getinfo, $cust_main->cust_pay ],
1623           };
1624 }
1625
1626 sub payment_receipt {
1627   my $p = shift;
1628   my $session = _cache->get($p->{'session_id'})
1629     or return { 'error' => "Can't resume session" }; #better error message
1630
1631   my $custnum = $session->{'custnum'};
1632
1633   my $cust_pay = qsearchs('cust_pay', { 'custnum' => $custnum,
1634                                         'paynum'  => $p->{'paynum'},
1635                                       }
1636                          )
1637     or return { 'error' => "unknown payment ". $p->{'paynum'} };
1638
1639   return {
1640            'error' => '',
1641            %{ $cust_pay->SSAPI_getinfo },
1642          };
1643 }
1644
1645 sub list_payby {
1646   my $p = shift;
1647
1648   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1649   return { 'error' => $session } if $context eq 'error';
1650
1651   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1652     or return { 'error' => "unknown custnum $custnum" };
1653
1654   return {
1655     'payby' => [ map {
1656                        my $cust_payby = $_;
1657                        +{
1658                           map { $_ => $cust_payby->$_ }
1659                             qw( custpaybynum weight payby paymask paydate
1660                                 payname paystate paytype
1661                               )
1662                         };
1663                      }
1664                    $cust_main->cust_payby
1665                ],
1666   };
1667 }
1668
1669 sub insert_payby {
1670   my $p = shift;
1671
1672   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1673   return { 'error' => $session } if $context eq 'error';
1674
1675   #XXX payinfo1 + payinfo2 for CHEK?
1676   #or take the opportunity to use separate, more well- named fields?
1677   # my $payinfo;
1678   # $p->{'payinfo1'} =~ /^([\dx]+)$/
1679   #   or return { 'error' => "illegal account number ". $p->{'payinfo1'} };
1680   # my $payinfo1 = $1;
1681   #  $p->{'payinfo2'} =~ /^([\dx\.]+)$/ # . turned on by echeck-country CA ?
1682   #   or return { 'error' => "illegal ABA/routing number ". $p->{'payinfo2'} };
1683   # my $payinfo2 = $1;
1684   # $payinfo = $payinfo1. '@'. $payinfo2;
1685
1686   my $cust_payby = new FS::cust_payby {
1687     'custnum' => $custnum,
1688     map { $_ => $p->{$_} } qw( weight payby payinfo paycvv paydate payname
1689                                paystate paytype payip
1690                              ),
1691   };
1692
1693   my $error = $cust_payby->insert;
1694   if ( $error ) {
1695     return { 'error' => $error };
1696   } else {
1697     return { 'custpaybynum' => $cust_payby->custpaybynum };
1698   }
1699
1700 }
1701
1702 sub update_payby {
1703   my $p = shift;
1704
1705   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1706   return { 'error' => $session } if $context eq 'error';
1707
1708   my $cust_payby = qsearchs('cust_payby', {
1709                               'custnum'      => $custnum,
1710                               'custpaybynum' => $p->{'custpaybynum'},
1711                            })
1712     or return { 'error' => 'unknown custpaybynum '. $p->{'custpaybynum'} };
1713
1714   foreach my $field (
1715     qw( weight payby payinfo paycvv paydate payname paystate paytype payip )
1716   ) {
1717     next unless exists($p->{$field});
1718     $cust_payby->set($field,$p->{$field});
1719   }
1720
1721   my $error = $cust_payby->replace;
1722   if ( $error ) {
1723     return { 'error' => $error };
1724   } else {
1725     return { 'custpaybynum' => $cust_payby->custpaybynum };
1726   }
1727
1728 }
1729
1730 sub verify_payby {
1731   my $p = shift;
1732
1733   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1734   return { 'error' => $session } if $context eq 'error';
1735
1736   my $cust_payby = qsearchs('cust_payby', {
1737                               'custnum'      => $custnum,
1738                               'custpaybynum' => $p->{'custpaybynum'},
1739                            })
1740     or return { 'error' => 'unknown custpaybynum '. $p->{'custpaybynum'} };
1741
1742   return { 'error' => $cust_payby->verify };
1743
1744 }
1745
1746 sub delete_payby {
1747   my $p = shift;
1748
1749   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1750   return { 'error' => $session } if $context eq 'error';
1751
1752   my $cust_payby = qsearchs('cust_payby', {
1753                               'custnum'      => $custnum,
1754                               'custpaybynum' => $p->{'custpaybynum'},
1755                            })
1756     or return { 'error' => 'unknown custpaybynum '. $p->{'custpaybynum'} };
1757
1758   my $conf = new FS::Conf;
1759   if (($cust_payby->payby eq "DCHK" || $cust_payby->payby eq "CHEK") && $conf->exists('selfservice-ACH_info_readonly')) {
1760     return { 'error' => "Sorry you do not have permission to delete bank information." };
1761   }
1762   else {
1763     return { 'error' => $cust_payby->delete };
1764   }
1765 }
1766
1767 sub cancel {
1768   my $p = shift;
1769   my $session = _cache->get($p->{'session_id'})
1770     or return { 'error' => "Can't resume session" }; #better error message
1771
1772   my $custnum = $session->{'custnum'};
1773
1774   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1775     or return { 'error' => "unknown custnum $custnum" };
1776
1777   my @errors = $cust_main->cancel( 'quiet'=>1 );
1778
1779   my $error = scalar(@errors) ? join(' / ', @errors) : '';
1780
1781   return { 'error' => $error };
1782
1783 }
1784
1785 sub pkg_info {
1786   my $p = shift;
1787
1788   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1789   return { 'error' => $session } if $context eq 'error';
1790
1791   my $pkg = qsearchs({
1792     'table'     => 'cust_pkg',
1793     'addl_from' => 'LEFT JOIN part_pkg USING ( pkgpart )',
1794     'hashref'   => {
1795                       'custnum' => $custnum,
1796                       'pkgnum'  => $p->{'pkgnum'},
1797                    },
1798   })
1799     or return {'error' => 'unknown pkg num $pkgnum'};
1800
1801   return {
1802         pkg_label => $pkg->pkg,
1803         pkgpart   => $pkg->pkgpart,
1804         classnum  => $pkg->classnum,
1805   };
1806
1807 }
1808
1809 sub list_pkgs {
1810   my $p = shift;
1811
1812   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1813   return { 'error' => $session } if $context eq 'error';
1814
1815   my $search = { 'custnum' => $custnum };
1816   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1817   my $cust_main = qsearchs('cust_main', $search )
1818     or return { 'error' => "unknown custnum $custnum" };
1819
1820   my $conf = new FS::Conf;
1821   my $immutable = $conf->exists('selfservice_immutable-package');
1822
1823 # the duplication below is necessary:
1824 # 1. to maintain the current buggy behaviour wrt the cust_pkg and part_pkg
1825 # hashes overwriting each other (setup and no_auto fields). Fixing that is a
1826 # non-backwards-compatible change breaking the software of anyone using the API
1827 # instead of the stock selfservice
1828 # 2. to return cancelled packages as well - for wholesale and non-wholesale
1829   if( $conf->exists('selfservice_server-view-wholesale') ) {
1830     return { 'svcnum'   => $session->{'svcnum'},
1831             'custnum'  => $custnum,
1832             'cust_pkg' => [ map {
1833                           { $_->hash,
1834                             immutable => $immutable,
1835                             part_pkg => [ map $_->hashref, $_->part_pkg ],
1836                             part_svc =>
1837                               [ map $_->hashref, $_->available_part_svc ],
1838                             cust_svc =>
1839                               [ map { my $ref = { $_->hash,
1840                                                   label => [ $_->label ],
1841                                                 };
1842                                       $ref->{_password} = $_->svc_x->_password
1843                                         if $context eq 'agent'
1844                                         && $conf->exists('agent-showpasswords')
1845                                         && $_->part_svc->svcdb eq 'svc_acct';
1846                                       $ref;
1847                                     } $_->cust_svc
1848                               ],
1849                           };
1850                         } $cust_main->cust_pkg
1851                   ],
1852     'small_custview' =>
1853       small_custview( $cust_main, $conf->config('countrydefault') ),
1854     'wholesale_view' => 1,
1855     'login_svcpart' => [ $conf->config('selfservice_server-login_svcpart') ],
1856     'date_format' => $conf->config('date_format') || '%m/%d/%Y',
1857     'lnp' => $conf->exists('svc_phone-lnp'),
1858       };
1859   }
1860
1861   { 'svcnum'   => $session->{'svcnum'},
1862     'custnum'  => $custnum,
1863     'cust_pkg' => [ map {
1864                           my $primary_cust_svc = $_->primary_cust_svc;
1865                           +{ $_->hash,
1866                             $_->part_pkg->hash,
1867                             immutable   => $immutable,
1868                             pkg_label   => $_->pkg_locale,
1869                             status      => $_->status,
1870                             statuscolor => $_->statuscolor,
1871                             part_svc =>
1872                               [ map { $_->hashref }
1873                                   grep { $_->selfservice_access ne 'hidden' }
1874                                     $_->available_part_svc
1875                               ],
1876                             cust_svc =>
1877                               [ map { my $ref = { $_->hash,
1878                                                   label => [ $_->label ],
1879                                                 };
1880                                       $ref->{_password} = $_->svc_x->_password
1881                                         if $context eq 'agent'
1882                                         && $conf->exists('agent-showpasswords')
1883                                         && $_->part_svc->svcdb eq 'svc_acct';
1884                                       $ref->{svchash} = { $_->svc_x->hash } if
1885                                         $_->part_svc->svcdb eq 'svc_phone';
1886                                       $ref->{svchash}->{svcpart} =  $_->part_svc->svcpart
1887                                         if $_->part_svc->svcdb eq 'svc_phone'; # hack
1888                                       $ref;
1889                                     }
1890                                   grep { $_->part_svc->selfservice_access ne 'hidden' }
1891                                     $_->cust_svc
1892                               ],
1893                             primary_cust_svc =>
1894                               $primary_cust_svc
1895                                 ? { $primary_cust_svc->hash,
1896                                     label => [ $primary_cust_svc->label ],
1897                                     finger => $primary_cust_svc->svc_x->finger, #uuh
1898                                     $primary_cust_svc->part_svc->hash,
1899                                   }
1900                                 : {}, #'' ?
1901                           };
1902                         } $cust_main->ncancelled_pkgs
1903                   ],
1904     'small_custview' =>
1905       small_custview( $cust_main, $conf->config('countrydefault') ),
1906     'date_format' => $conf->config('date_format') || '%m/%d/%Y',
1907   };
1908
1909 }
1910
1911 sub list_svcs {
1912   my $p = shift;
1913
1914   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1915   return { 'error' => $session } if $context eq 'error';
1916
1917   my $conf = new FS::Conf;
1918
1919   my $hide_usage = $conf->exists('selfservice_hide-usage') ? 1 : 0;
1920   my $search = { 'custnum' => $custnum };
1921   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1922   my $cust_main = qsearchs('cust_main', $search )
1923     or return { 'error' => "unknown custnum $custnum" };
1924
1925   my $pkgnum = $session->{'pkgnum'} || $p->{'pkgnum'} || '';
1926   if ( ! $pkgnum && $p->{'svcnum'} ) {
1927     my $cust_svc = qsearchs('cust_svc', { 'svcnum' => $p->{'svcnum'} } );
1928     $pkgnum = $cust_svc->pkgnum if $cust_svc;
1929   }
1930
1931   my @cust_svc = ();
1932   my @cust_pkg_usage = ();
1933   foreach my $cust_pkg ( $p->{'ncancelled'}
1934                          ? $cust_main->ncancelled_pkgs
1935                          : $cust_main->unsuspended_pkgs ) {
1936     next if $pkgnum && $cust_pkg->pkgnum != $pkgnum;
1937     push @cust_svc, @{[ $cust_pkg->cust_svc ]}; #@{[ ]} to force array context
1938     push @cust_pkg_usage, $cust_pkg->cust_pkg_usage;
1939   }
1940
1941   @cust_svc = grep { $_->part_svc->selfservice_access ne 'hidden' } @cust_svc;
1942   my %usage_pools;
1943   if (!$hide_usage) {
1944     foreach (@cust_pkg_usage) {
1945       my $part = $_->part_pkg_usage;
1946       my $tag = $part->description . ($part->shared ? 1 : 0);
1947       my $row = $usage_pools{$tag}
1948             ||= [ $part->description, 0, 0, $part->shared ? 1 : 0 ];
1949       $row->[1] += sprintf('%.1f', $_->minutes); # minutes remaining
1950       $row->[2] += $part->minutes; # minutes total
1951     }
1952   } # otherwise just leave them empty
1953
1954   if ( $p->{'svcdb'} ) {
1955     my $svcdb = ref($p->{'svcdb'}) eq 'HASH'
1956                   ? $p->{'svcdb'}
1957                   : ref($p->{'svcdb'}) eq 'ARRAY'
1958                     ? { map { $_=>1 } @{ $p->{'svcdb'} } }
1959                     : { $p->{'svcdb'} => 1 };
1960     @cust_svc = grep $svcdb->{ $_->part_svc->svcdb }, @cust_svc
1961   }
1962
1963   #@svc_x = sort { $a->domain cmp $b->domain || $a->username cmp $b->username }
1964   #              @svc_x;
1965
1966   my @svcs; # stuff to return to the client
1967   my %bytes_used_total; # for _used columns only
1968   foreach my $cust_svc (@cust_svc) {
1969     my $svc_x = $cust_svc->svc_x;
1970     my($label, $value) = $cust_svc->label;
1971     my $part_svc = $cust_svc->part_svc;
1972     my $svcdb = $part_svc->svcdb;
1973     my $cust_pkg = $cust_svc->cust_pkg;
1974     my $part_pkg = $cust_pkg->part_pkg;
1975
1976     my %hash = (
1977       'svcnum'         => $cust_svc->svcnum,
1978       'display_svcnum' => $cust_svc->display_svcnum,
1979       'svcdb'          => $svcdb,
1980       'label'          => $label,
1981       'value'          => $value,
1982       'pkg_label'      => $cust_pkg->pkg_locale,
1983       'pkg_status'     => $cust_pkg->status,
1984       'readonly'       => ($part_svc->selfservice_access eq 'readonly'),
1985     );
1986
1987     # would it make sense to put this in a svc_* method?
1988
1989     if (!$hide_usage and grep(/^$svcdb$/, qw(svc_acct svc_broadband)) and $part_svc->part_export_usage) {
1990       my $last_bill = $cust_pkg->last_bill || 0;
1991       my $now = time;
1992       my $up_used = $cust_svc->attribute_since_sqlradacct($last_bill,$now,'AcctInputOctets');
1993       my $down_used = $cust_svc->attribute_since_sqlradacct($last_bill,$now,'AcctOutputOctets');
1994       %hash = (
1995         %hash,
1996         'seconds_used'    => $cust_svc->seconds_since_sqlradacct($last_bill,$now),
1997         'upbytes_used'    => display_bytecount($up_used),
1998         'downbytes_used'  => display_bytecount($down_used),
1999         'totalbytes_used' => display_bytecount($up_used + $down_used)
2000       );
2001       $bytes_used_total{'seconds_used'} += $hash{'seconds_used'};
2002       $bytes_used_total{'upbytes_used'} += $up_used;
2003       $bytes_used_total{'downbytes_used'} += $down_used;
2004       $bytes_used_total{'totalbytes_used'} += $up_used + $down_used;
2005     }
2006
2007     if ( $svcdb eq 'svc_acct' ) {
2008       foreach (qw(username email finger seconds)) {
2009         $hash{$_} = $svc_x->$_;
2010       }
2011
2012       if (!$hide_usage) {
2013         %hash = (
2014           %hash,
2015           'upbytes'    => display_bytecount($svc_x->upbytes),
2016           'downbytes'  => display_bytecount($svc_x->downbytes),
2017           'totalbytes' => display_bytecount($svc_x->totalbytes),
2018
2019           'recharge_amount'  => $part_pkg->option('recharge_amount',1),
2020           'recharge_seconds' => $part_pkg->option('recharge_seconds',1),
2021           'recharge_upbytes'    =>
2022             display_bytecount($part_pkg->option('recharge_upbytes',1)),
2023           'recharge_downbytes'  =>
2024             display_bytecount($part_pkg->option('recharge_downbytes',1)),
2025           'recharge_totalbytes' =>
2026             display_bytecount($part_pkg->option('recharge_totalbytes',1)),
2027           # more...
2028         );
2029       }
2030
2031     } elsif ( $svcdb eq 'svc_dsl' ) {
2032
2033       $hash{'phonenum'} = $svc_x->phonenum;
2034       if ( $svc_x->first || $svc_x->get('last') || $svc_x->company ) {
2035         $hash{'name'} = $svc_x->first. ' '. $svc_x->get('last');
2036         $hash{'name'} = $svc_x->company. ' ('. $hash{'name'}. ')'
2037           if $svc_x->company;
2038       } else {
2039         $hash{'name'} = $cust_main->name;
2040       }
2041       # no usage to hide here
2042
2043     } elsif ( $svcdb eq 'svc_phone' or $svcdb eq 'svc_pbx' ) {
2044       if (!$hide_usage) {
2045         # could potentially show lots of things...
2046         $hash{'outbound'} = 1;
2047         $hash{'inbound'}  = 0;
2048         if ( $svcdb eq 'svc_phone' ) {
2049           if ( $part_pkg->plan eq 'voip_inbound' ) {
2050             $hash{'outbound'} = 0;
2051             $hash{'inbound'}  = 1;
2052           } elsif ( $part_pkg->option('selfservice_inbound_format')
2053                 or  $conf->config('selfservice-default_inbound_cdr_format')
2054           ) {
2055             $hash{'inbound'}  = 1;
2056           }
2057         }
2058         foreach (qw(inbound outbound)) {
2059           # hmm...we can't filter by status here, because there might
2060           # not be cdr_terminations at all.  have to go by date.
2061           # find all since the last bill date.
2062           # XXX cdr types?  we are going to need them.
2063           if ( $hash{$_} ) {
2064             my $sum_cdr = $svc_x->sum_cdrs(
2065               'inbound' => ( $_ eq 'inbound' ? 1 : 0 ),
2066               'begin'   => ($cust_pkg->last_bill || 0),
2067               'nonzero' => 1,
2068               'disable_charged_party' => 1,
2069             );
2070             $hash{$_} = $sum_cdr->hashref;
2071           }
2072         }
2073       } # not hiding usage
2074     } # svcdb
2075
2076     push @svcs, \%hash;
2077   } # foreach $cust_svc
2078
2079   foreach my $field (keys %bytes_used_total) {
2080     if ($field =~ /bytes/) {
2081       $bytes_used_total{$field} = display_bytecount($bytes_used_total{$field});
2082     }
2083   }
2084
2085   return {
2086     'svcnum'   => $session->{'svcnum'},
2087     'custnum'  => $custnum,
2088     'date_format' => $conf->config('date_format') || '%m/%d/%Y',
2089     'view_usage_nodomain' => $conf->exists('selfservice-view_usage_nodomain'),
2090     'svcs'     => \@svcs,
2091     'bytes_used_total' => \%bytes_used_total,
2092     'usage_pools' => [
2093       map { $usage_pools{$_} }
2094       sort { $a cmp $b }
2095       keys %usage_pools
2096     ],
2097     'hide_usage' => $hide_usage,
2098   };
2099
2100 }
2101
2102 sub _customer_svc_x {
2103   my($custnum, $svcnum, $table) = (shift, shift, shift);
2104   my $hashref = ref($svcnum) ? $svcnum : { 'svcnum' => $svcnum };
2105
2106   $custnum =~ /^(\d+)$/ or die "illegal custnum";
2107   my $search = " AND custnum = $1";
2108   #$search .= " AND agentnum = ". $session->{'agentnum'} if $context eq 'agent';
2109
2110   qsearchs( {
2111     'table'     => ($table || 'svc_acct'),
2112     'addl_from' => 'LEFT JOIN cust_svc  USING ( svcnum  ) '.
2113                    'LEFT JOIN cust_pkg  USING ( pkgnum  ) ',#.
2114                    #'LEFT JOIN cust_main USING ( custnum ) ',
2115     'hashref'   => $hashref,
2116     'extra_sql' => $search, #important
2117   } );
2118
2119 }
2120
2121 sub svc_status_html {
2122   my $p = shift;
2123
2124   my($context, $session, $custnum) = _custoragent_session_custnum($p);
2125   return { 'error' => $session } if $context eq 'error';
2126
2127   #XXX only svc_dsl for now
2128   my $svc_x = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_dsl')
2129     or return { 'error' => "Service not found" };
2130
2131   my $html = $svc_x->getstatus_html;
2132
2133   return { 'html' => $html };
2134
2135 }
2136
2137 sub svc_status_hash {
2138   my $p = shift;
2139
2140   my($context, $session, $custnum) = _custoragent_session_custnum($p);
2141   return { 'error' => $session } if $context eq 'error';
2142
2143   #XXX only svc_acct for now
2144   my $svc_x = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_acct')
2145     or return { 'error' => "Service not found" };
2146
2147   my ( $html, $hashref ) = $svc_x->export_getstatus;
2148   return $hashref;
2149
2150 }
2151
2152 sub set_svc_status_hash    { _svc_method_X(shift, 'export_setstatus') }
2153 sub set_svc_status_listadd { _svc_method_X(shift, 'export_setstatus_listadd') }
2154 sub set_svc_status_listdel { _svc_method_X(shift, 'export_setstatus_listdel') }
2155 sub set_svc_status_vacationadd { _svc_method_X(shift, 'export_setstatus_vacationadd') }
2156 sub set_svc_status_vacationdel { _svc_method_X(shift, 'export_setstatus_vacationdel') }
2157
2158 sub _svc_method_X {
2159   my( $p, $method ) = @_;
2160
2161   my($context, $session, $custnum) = _custoragent_session_custnum($p);
2162   return { 'error' => $session } if $context eq 'error';
2163
2164   #XXX only svc_acct for now
2165   my $svc_x = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_acct')
2166     or return { 'error' => "Service not found" };
2167
2168   warn "$method ". join(' / ', map "$_=>".$p->{$_}, keys %$p )
2169     if $DEBUG;
2170   my $error = $svc_x->$method($p); #$p? returns error?
2171   return { 'error' => $error } if $error;
2172
2173   return {}; #? { 'error' => '' }
2174
2175 }
2176
2177 sub acct_forward_info {
2178   my $p = shift;
2179
2180   my($context, $session, $custnum) = _custoragent_session_custnum($p);
2181   return { 'error' => $session } if $context eq 'error';
2182
2183   my $svc_forward = _customer_svc_x( $custnum,
2184                                      { 'srcsvc' => $p->{'svcnum'} },
2185                                      'svc_forward',
2186                                    )
2187     or return { 'error' => '',
2188                 'dst'   => '',
2189               };
2190
2191   return { 'error' => '',
2192            'dst'   => $svc_forward->dst || $svc_forward->dstsvc_acct->email,
2193          };
2194
2195 }
2196
2197 sub process_acct_forward {
2198   my $p = shift;
2199   my($context, $session, $custnum) = _custoragent_session_custnum($p);
2200   return { 'error' => $session } if $context eq 'error';
2201
2202   my $old = _customer_svc_x( $custnum,
2203                              { 'srcsvc' => $p->{'svcnum'} },
2204                              'svc_forward',
2205                            );
2206
2207   if ( $p->{'dst'} eq '' ) {
2208     if ( $old ) {
2209       my $error = $old->delete;
2210       return { 'error' => $error };
2211     }
2212     return { 'error' => '' };
2213   }
2214
2215   my $new = new FS::svc_forward { 'srcsvc' => $p->{'svcnum'},
2216                                   'dst'    => $p->{'dst'},
2217                                 };
2218
2219   my $error;
2220   if ( $old ) {
2221     $new->svcnum($old->svcnum);
2222     my $cust_svc = $old->cust_svc;
2223     $new->svcpart($old->svcpart);
2224     $new->pkgnuym($old->pkgnum);
2225     $error = $new->replace($old);
2226   } else {
2227     my $conf = new FS::Conf;
2228     $new->svcpart($conf->config('selfservice-svc_forward_svcpart'));
2229
2230     my $svc_acct = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_acct' )
2231       or return { 'error' => 'No service' }; #how would we even get here?
2232
2233     $new->pkgnum( $svc_acct->cust_svc->pkgnum );
2234
2235     $error = $new->insert;
2236   }
2237
2238   return { 'error' => $error };
2239
2240 }
2241
2242 sub list_dsl_devices {
2243   my $p = shift;
2244
2245   my($context, $session, $custnum) = _custoragent_session_custnum($p);
2246   return { 'error' => $session } if $context eq 'error';
2247
2248   my $svc_dsl = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_dsl' )
2249     or return { 'error' => "Service not found" };
2250
2251   return {
2252     'devices' => [ map {
2253                          +{ 'mac_addr' => $_->mac_addr };
2254                        } $svc_dsl->dsl_device
2255                  ],
2256   };
2257
2258 }
2259
2260 sub add_dsl_device {
2261   my $p = shift;
2262
2263   my($context, $session, $custnum) = _custoragent_session_custnum($p);
2264   return { 'error' => $session } if $context eq 'error';
2265
2266   my $svc_dsl = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_dsl' )
2267     or return { 'error' => "Service not found" };
2268
2269   return { 'error' => 'No MAC address supplied' }
2270     unless length($p->{'mac_addr'});
2271
2272   my $dsl_device = new FS::dsl_device { 'svcnum'   => $svc_dsl->svcnum,
2273                                         'mac_addr' => scalar($p->{'mac_addr'}),
2274                                       };
2275   my $error = $dsl_device->insert;
2276   return { 'error' => $error };
2277
2278 }
2279
2280 sub delete_dsl_device {
2281   my $p = shift;
2282
2283   my($context, $session, $custnum) = _custoragent_session_custnum($p);
2284   return { 'error' => $session } if $context eq 'error';
2285
2286   my $svc_dsl = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_dsl' )
2287     or return { 'error' => "Service not found" };
2288
2289   my $dsl_device = qsearchs('dsl_device', { 'svcnum'   => $svc_dsl->svcnum,
2290                                             'mac_addr' => scalar($p->{'mac_addr'}),
2291                                           }
2292                            )
2293     or return { 'error' => 'Unknown MAC address: '. $p->{'mac_addr'} };
2294
2295   my $error = $dsl_device->delete;
2296   return { 'error' => $error };
2297
2298 }
2299
2300 sub port_graph {
2301   my $p = shift;
2302   _usage_details( \&_port_graph, $p,
2303                   'svcdb' => 'svc_port',
2304                 );
2305 }
2306
2307 sub _port_graph {
2308   my($svc_port, $begin, $end) = @_;
2309   my @usage = ();
2310   my $pngOrError = $svc_port->graph_png( start=>$begin, end=> $end );
2311   push @usage, { 'png' => $pngOrError };
2312   (@usage);
2313 }
2314
2315 sub _list_svc_usage {
2316   my($svc_acct, $begin, $end) = @_;
2317   my @usage = ();
2318   foreach my $part_export (
2319     map { qsearch ( 'part_export', { 'exporttype' => $_ } ) }
2320     qw( sqlradius sqlradius_withdomain )
2321   ) {
2322     push @usage, @ { $part_export->usage_sessions($begin, $end, $svc_acct) };
2323   }
2324   (@usage);
2325 }
2326
2327 sub list_svc_usage {
2328   _usage_details(\&_list_svc_usage, @_);
2329 }
2330
2331 sub _list_support_usage {
2332   my($svc_acct, $begin, $end) = @_;
2333   my @usage = ();
2334   foreach ( grep { $begin <= $_->_date && $_->_date <= $end }
2335             qsearch('acct_rt_transaction', { 'svcnum' => $svc_acct->svcnum })
2336           ) {
2337     push @usage, { 'seconds'  => $_->seconds,
2338                    'support'  => $_->support,
2339                    '_date'    => $_->_date,
2340                    'id'       => $_->transaction_id,
2341                    'creator'  => $_->creator,
2342                    'subject'  => $_->subject,
2343                    'status'   => $_->status,
2344                    'ticketid' => $_->ticketid,
2345                  };
2346   }
2347   (@usage);
2348 }
2349
2350 sub list_support_usage {
2351   _usage_details(\&_list_support_usage, @_);
2352 }
2353
2354 sub _list_cdr_usage {
2355   # XXX CDR type support...
2356   # XXX any way to do a paged search on this?
2357   # we have to return the results all at once...
2358   my($svc_x, $begin, $end, %opt) = @_;
2359   map [ $_->downstream_csv(%opt, 'keeparray' => 1) ],
2360     $svc_x->get_cdrs(
2361       'begin' => $begin,
2362       'end'   => $end,
2363       'disable_charged_party' => 1,
2364       %opt
2365     );
2366 }
2367
2368 sub list_cdr_usage {
2369   my $p = shift;
2370   _usage_details( \&_list_cdr_usage, $p );
2371 }
2372
2373 sub _usage_details {
2374   my($callback, $p, %opt) = @_;
2375   my $conf = FS::Conf->new;
2376
2377   if ( $conf->exists('selfservice_hide-usage') ) {
2378     return { 'error' => 'Viewing usage is not allowed.' };
2379   }
2380
2381   my($context, $session, $custnum) = _custoragent_session_custnum($p);
2382   return { 'error' => $session } if $context eq 'error';
2383
2384   my $search = { 'svcnum' => $p->{'svcnum'} };
2385   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
2386
2387   my $cust_svc = qsearchs( 'cust_svc', $search );
2388   return { 'error' => 'No service selected in list_svc_usage' }
2389     unless $cust_svc;
2390
2391   my $svc_x = $cust_svc->svc_x;
2392   my $svcdb = $svc_x->table;
2393   my $cust_pkg = $cust_svc->cust_pkg;
2394   my $freq     = $cust_pkg->part_pkg->freq;
2395   my %callback_opt;
2396   my $header = [];
2397   if ( $svcdb eq 'svc_phone' or $svcdb eq 'svc_pbx' ) {
2398     my $format = '';
2399     if ( $p->{inbound} ) {
2400       $format = $cust_pkg->part_pkg->option('selfservice_inbound_format')
2401                 || $conf->config('selfservice-default_inbound_cdr_format')
2402                 || 'source_default';
2403       $callback_opt{inbound} = 1;
2404     } else {
2405       $format = $cust_pkg->part_pkg->option('selfservice_format')
2406                 || $conf->config('selfservice-default_cdr_format')
2407                 || 'default';
2408     }
2409
2410     $callback_opt{format} = $format;
2411     $callback_opt{use_clid} = 1;
2412     $header = [ split(',', FS::cdr::invoice_header($format) ) ];
2413   }
2414
2415   my $start    = $cust_pkg->setup;
2416   #my $end      = $cust_pkg->bill; # or time?
2417   my $end      = time;
2418
2419   unless ( $p->{beginning} ) {
2420     $p->{beginning} = $cust_pkg->last_bill;
2421     $p->{ending}    = $end;
2422   }
2423
2424   die "illegal beginning" if $p->{beginning} !~ /^\d*$/;
2425   die "illegal ending"    if $p->{ending}    !~ /^\d*$/;
2426
2427   my (@usage) = &$callback($svc_x, $p->{beginning}, $p->{ending},
2428     %callback_opt
2429   );
2430
2431   if ( $conf->exists('selfservice-hide_cdr_price') ) {
2432     # ugly kludge, I know
2433     my ($delete_col) = grep { $header->[$_] eq 'Price' } (0..scalar(@$header));
2434     if (defined $delete_col) {
2435       delete($_->[$delete_col]) foreach ($header, @usage);
2436     }
2437   }
2438
2439   #kinda false laziness with FS::cust_main::bill, but perhaps
2440   #we should really change this bit to DateTime and DateTime::Duration
2441   #
2442   #change this bit to use Date::Manip? CAREFUL with timezones (see
2443   # mailing list archive)
2444   my ($nsec,$nmin,$nhour,$nmday,$nmon,$nyear) =
2445     (localtime($p->{ending}) )[0,1,2,3,4,5];
2446   my ($psec,$pmin,$phour,$pmday,$pmon,$pyear) =
2447     (localtime($p->{beginning}) )[0,1,2,3,4,5];
2448
2449   if ( $freq =~ /^\d+$/ ) {
2450     $nmon += $freq;
2451     until ( $nmon < 12 ) { $nmon -= 12; $nyear++; }
2452     $pmon -= $freq;
2453     until ( $pmon >= 0 ) { $pmon += 12; $pyear--; }
2454   } elsif ( $freq =~ /^(\d+)w$/ ) {
2455     my $weeks = $1;
2456     $nmday += $weeks * 7;
2457     $pmday -= $weeks * 7;
2458   } elsif ( $freq =~ /^(\d+)d$/ ) {
2459     my $days = $1;
2460     $nmday += $days;
2461     $pmday -= $days;
2462   } elsif ( $freq =~ /^(\d+)h$/ ) {
2463     my $hours = $1;
2464     $nhour += $hours;
2465     $phour -= $hours;
2466   } else {
2467     return { 'error' => "unparsable frequency: ". $freq };
2468   }
2469
2470   my $previous  = timelocal_nocheck($psec,$pmin,$phour,$pmday,$pmon,$pyear);
2471   my $next      = timelocal_nocheck($nsec,$nmin,$nhour,$nmday,$nmon,$nyear);
2472
2473   {
2474     'error'     => '',
2475     'svcnum'    => $p->{svcnum},
2476     'beginning' => $p->{beginning},
2477     'ending'    => $p->{ending},
2478     'inbound'   => $p->{inbound},
2479     'previous'  => ($previous > $start) ? $previous : $start,
2480     'next'      => ($next < $end) ? $next : $end,
2481     'header'    => $header,
2482     'usage'     => \@usage,
2483   };
2484 }
2485
2486 sub order_pkg {
2487   my $p = shift;
2488
2489   my($context, $session, $custnum) = _custoragent_session_custnum($p);
2490   return { 'error' => $session } if $context eq 'error';
2491
2492   my $search = { 'custnum' => $custnum };
2493   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
2494   my $cust_main = qsearchs('cust_main', $search )
2495     or return { 'error' => "unknown custnum $custnum" };
2496
2497   my $status = $cust_main->status;
2498
2499   my %order_pkg_options = ();
2500   if ( $p->{locationnum} > 0 ) {
2501     $order_pkg_options{locationnum} = delete($p->{locationnum});
2502   } elsif ( $p->{address1} ) {
2503     $order_pkg_options{'cust_location'} = new FS::cust_location {
2504       map { $_ => $p->{$_} }
2505         qw( address1 address2 city county state zip country )
2506     };
2507   }
2508
2509   #false laziness w/ClientAPI/Signup.pm
2510
2511   my $cust_pkg = new FS::cust_pkg ( {
2512     'custnum'  => $custnum,
2513     'pkgpart'  => $p->{'pkgpart'},
2514     'quantity' => $p->{'quantity'} || 1,
2515   } );
2516   my $error = $cust_pkg->check;
2517   return { 'error' => $error } if $error;
2518
2519   my @svc = ();
2520   unless ( $p->{'svcpart'} eq 'none' ) {
2521
2522     my $svcdb;
2523     my $svcpart = '';
2524     if ( $p->{'svcpart'} =~ /^(\d+)$/ ) {
2525       $svcpart = $1;
2526       my $part_svc = qsearchs('part_svc', { 'svcpart' => $svcpart } );
2527       return { 'error' => "Unknown svcpart $svcpart" } unless $part_svc;
2528       $svcdb = $part_svc->svcdb;
2529     } else {
2530       $svcdb = 'svc_acct';
2531     }
2532     $svcpart ||= $cust_pkg->part_pkg->svcpart($svcdb);
2533
2534     my %fields = (
2535       'svc_acct'     => [ qw( username domsvc _password sec_phrase popnum ) ],
2536       'svc_domain'   => [ qw( domain ) ],
2537       'svc_phone'    => [ qw( phonenum pin sip_password phone_name ) ],
2538       'svc_external' => [ qw( id title ) ],
2539       'svc_pbx'      => [ qw( id title ) ],
2540     );
2541
2542     my $svc_x = "FS::$svcdb"->new( {
2543       'svcpart'   => $svcpart,
2544       map { $_ => $p->{$_} } @{$fields{$svcdb}}
2545     } );
2546
2547     if ( $svcdb eq 'svc_acct' && exists($p->{"snarf_machine1"}) ) {
2548       my @acct_snarf;
2549       my $snarfnum = 1;
2550       while ( length($p->{"snarf_machine$snarfnum"}) ) {
2551         my $acct_snarf = new FS::acct_snarf ( {
2552           'machine'   => $p->{"snarf_machine$snarfnum"},
2553           'protocol'  => $p->{"snarf_protocol$snarfnum"},
2554           'username'  => $p->{"snarf_username$snarfnum"},
2555           '_password' => $p->{"snarf_password$snarfnum"},
2556         } );
2557         $snarfnum++;
2558         push @acct_snarf, $acct_snarf;
2559       }
2560       $svc_x->child_objects( \@acct_snarf );
2561     }
2562
2563     my $y = $svc_x->setdefault; # arguably should be in new method
2564     return { 'error' => $y } if $y && !ref($y);
2565
2566     $error = $svc_x->check;
2567     return { 'error' => $error } if $error;
2568
2569     push @svc, $svc_x;
2570
2571   }
2572
2573   $error = $cust_main->order_pkg(
2574     'cust_pkg' => $cust_pkg,
2575     'svcs'     => \@svc,
2576     'noexport' => 1,
2577     %order_pkg_options,
2578   );
2579   return { 'error' => $error } if $error;
2580
2581   my $conf = new FS::Conf;
2582   if ( $conf->exists('signup_server-realtime') ) {
2583
2584     my $bill_error = _do_bop_realtime( $cust_main, $status, 'collect'=>$p->{run_bill_events} );
2585
2586     if ($bill_error) {
2587       $cust_pkg->cancel('quiet'=>1);
2588       return $bill_error;
2589     } else {
2590       $cust_pkg->reexport;
2591     }
2592
2593   } else {
2594     $cust_pkg->reexport;
2595   }
2596
2597   my $svcnum = $svc[0] ? $svc[0]->svcnum : '';
2598
2599   return { error=>'', pkgnum=>$cust_pkg->pkgnum, svcnum=>$svcnum };
2600
2601 }
2602
2603 sub change_pkg {
2604   my $p = shift;
2605
2606   my($context, $session, $custnum) = _custoragent_session_custnum($p);
2607   return { 'error' => $session } if $context eq 'error';
2608
2609   my $conf = new FS::Conf;
2610   my $immutable = $conf->exists('selfservice_immutable-package');
2611   return { 'error' => "Package modification disabled" } if $immutable;
2612
2613   my $search = { 'custnum' => $custnum };
2614   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
2615   my $cust_main = qsearchs('cust_main', $search )
2616     or return { 'error' => "unknown custnum $custnum" };
2617
2618   my $status = $cust_main->status;
2619   my $cust_pkg = qsearchs('cust_pkg', { 'pkgnum' => $p->{pkgnum} } )
2620     or return { 'error' => "unknown package $p->{pkgnum}" };
2621
2622   #if someone does need self-service package change of suspended packages,
2623   # figure out how to be more discriminating
2624   return { error=>"Can't change a suspended package", pkgnum=>$cust_pkg->pkgnum}
2625     if $cust_pkg->status eq 'suspended';
2626
2627   my $err_or_cust_pkg = $cust_pkg->change( 'pkgpart'  => $p->{'pkgpart'},
2628                                            'quantity' => $p->{'quantity'} || 1,
2629                                          );
2630
2631   my $new_pkg = qsearchs('part_pkg', { 'pkgpart' => $p->{pkgpart} } )
2632     or return { 'error' => "unknown package $p->{pkgpart}" };
2633
2634   return { error=>$err_or_cust_pkg, pkgnum=>$cust_pkg->pkgnum }
2635     unless ref($err_or_cust_pkg);
2636
2637
2638   if ( $conf->exists('signup_server-realtime') ) {
2639
2640     my $bill_error = _do_bop_realtime( $cust_main, $status, 'no_invoice_void'=>1 );
2641
2642     if ($bill_error) {
2643       $err_or_cust_pkg->suspend;
2644       return $bill_error;
2645     } else {
2646       $err_or_cust_pkg->reexport;
2647     }
2648
2649   } else {
2650     $err_or_cust_pkg->reexport;
2651   }
2652
2653   return { error => '', pkg => $new_pkg->pkg, pkgnum => $err_or_cust_pkg->pkgnum };
2654
2655 }
2656
2657 sub order_recharge {
2658   my $p = shift;
2659
2660   my($context, $session, $custnum) = _custoragent_session_custnum($p);
2661   return { 'error' => $session } if $context eq 'error';
2662
2663   my $search = { 'custnum' => $custnum };
2664   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
2665   my $cust_main = qsearchs('cust_main', $search )
2666     or return { 'error' => "unknown custnum $custnum" };
2667
2668   my $status = $cust_main->status;
2669   my $cust_svc = qsearchs( 'cust_svc', { 'svcnum' => $p->{'svcnum'} } )
2670     or return { 'error' => "unknown service " . $p->{'svcnum'} };
2671
2672   my $svc_x = $cust_svc->svc_x;
2673   my $part_pkg = $cust_svc->cust_pkg->part_pkg;
2674
2675   my %vhash =
2676     map { $_ =~ /^recharge_(.*)$/; $1, $part_pkg->option($_, 1) }
2677     qw ( recharge_seconds recharge_upbytes recharge_downbytes
2678          recharge_totalbytes );
2679   my $amount = $part_pkg->option('recharge_amount', 1);
2680
2681   my ($l, $v, $d) = $cust_svc->label;  # blah
2682   my $pkg = "Recharge $v";
2683
2684   my $bill_error = $cust_main->charge($amount, $pkg,
2685      "time: $vhash{seconds}, up: $vhash{upbytes}," .
2686      "down: $vhash{downbytes}, total: $vhash{totalbytes}",
2687      $part_pkg->taxclass); #meh
2688
2689   my $conf = new FS::Conf;
2690   if ( $conf->exists('signup_server-realtime') && !$bill_error ) {
2691
2692     $bill_error = _do_bop_realtime( $cust_main, $status );
2693
2694     if ($bill_error) {
2695       return $bill_error;
2696     } else {
2697       my $error = $svc_x->recharge (\%vhash);
2698       return { 'error' => $error } if $error;
2699     }
2700
2701   } else {
2702     my $error = $bill_error;
2703     $error ||= $svc_x->recharge (\%vhash);
2704     return { 'error' => $error } if $error;
2705   }
2706
2707   return { error => '', svc => $cust_svc->part_svc->svc };
2708
2709 }
2710
2711 sub _do_bop_realtime {
2712   my ($cust_main, $status, %opt) = @_;
2713
2714   my $old_balance = $cust_main->balance;
2715
2716   my @cust_bill;
2717   my $bill_error = $cust_main->bill(
2718     'return_bill'   => \@cust_bill,
2719   );
2720
2721   $bill_error ||= $cust_main->apply_payments_and_credits;
2722
2723   $bill_error ||= $cust_main->realtime_collect('selfservice' => 1);
2724
2725   if (    $cust_main->balance > $old_balance
2726        && $cust_main->balance > 0
2727        && ( $cust_main->has_cust_payby_auto || $status eq 'suspended' )
2728      )
2729   {
2730     unless ( $opt{'no_invoice_void'} ) {
2731
2732       #this used to apply a credit, but now we can void invoices...
2733       foreach my $cust_bill (@cust_bill) {
2734         my $voiderror = $cust_bill->void('automatic payment failed');
2735         warn "Error voiding cust bill after decline: $voiderror" if $voiderror;
2736       }
2737
2738     }
2739
2740     return { 'error' => '_decline', 'bill_error' => $bill_error };
2741   }
2742
2743   if ( $opt{'collect'} ) {
2744     my $collect_error = $cust_main->collect();
2745     return { 'error' => '_decline', 'bill_error' => $collect_error }
2746      if $collect_error; #?
2747   }
2748
2749   '';
2750 }
2751
2752 sub renew_info {
2753   my $p = shift;
2754
2755   my($context, $session, $custnum) = _custoragent_session_custnum($p);
2756   return { 'error' => $session } if $context eq 'error';
2757
2758   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
2759     or return { 'error' => "unknown custnum $custnum" };
2760
2761   my @cust_pkg = sort { $a->bill <=> $b->bill }
2762                  grep { $_->part_pkg->freq ne '0' }
2763                  $cust_main->ncancelled_pkgs;
2764
2765   #return { 'error' => 'No active packages to renew.' } unless @cust_pkg;
2766
2767   my $total = $cust_main->balance;
2768
2769   my @array = map {
2770                     my $bill = $_->bill;
2771                     $total += $_->part_pkg->base_recur($_, \$bill);
2772                     my $renew_date = $_->part_pkg->add_freq($_->bill);
2773                     {
2774                       'pkgnum'             => $_->pkgnum,
2775                       'amount'             => sprintf('%.2f', $total),
2776                       'bill_date'          => $_->bill,
2777                       'bill_date_pretty'   => time2str('%x', $_->bill),
2778                       'renew_date'         => $renew_date,
2779                       'renew_date_pretty'  => time2str('%x', $renew_date),
2780                       'expire_date'        => $_->expire,
2781                       'expire_date_pretty' => time2str('%x', $_->expire),
2782                     };
2783                   }
2784                   @cust_pkg;
2785
2786   return { 'dates' => \@array };
2787
2788 }
2789
2790 sub payment_info_renew_info {
2791   my $p = shift;
2792   my $renew_info   = renew_info($p);
2793   my $payment_info = payment_info($p);
2794   return { %$renew_info,
2795            %$payment_info,
2796          };
2797 }
2798
2799 sub order_renew {
2800   my $p = shift;
2801
2802   my($context, $session, $custnum) = _custoragent_session_custnum($p);
2803   return { 'error' => $session } if $context eq 'error';
2804
2805   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
2806     or return { 'error' => "unknown custnum $custnum" };
2807
2808   my $date = $p->{'date'};
2809
2810   my $now = time;
2811
2812   #freeside-daily -n -d $date fs_daily $custnum
2813   $cust_main->bill_and_collect( 'time'         => $date,
2814                                 'invoice_time' => $now,
2815                                 'actual_time'  => $now,
2816                                 'check_freq'   => '1d',
2817                               );
2818
2819   return { 'error' => '' };
2820
2821 }
2822
2823 sub suspend_pkg {
2824   my $p = shift;
2825   my $session = _cache->get($p->{'session_id'})
2826     or return { 'error' => "Can't resume session" }; #better error message
2827
2828   my $custnum = $session->{'custnum'};
2829
2830   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
2831     or return { 'error' => "unknown custnum $custnum" };
2832
2833   my $conf = new FS::Conf;
2834   my $reasonnum =
2835     $conf->config('selfservice-self_suspend_reason', $cust_main->agentnum)
2836       or return { 'error' => 'Permission denied' };
2837
2838   my $pkgnum = $p->{'pkgnum'};
2839
2840   my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
2841                                         'pkgnum'  => $pkgnum,   } )
2842     or return { 'error' => "unknown pkgnum $pkgnum" };
2843
2844   my $error = $cust_pkg->suspend(reason => $reasonnum);
2845   return { 'error' => $error };
2846
2847 }
2848
2849 sub cancel_pkg {
2850   my $p = shift;
2851   my $session = _cache->get($p->{'session_id'})
2852     or return { 'error' => "Can't resume session" }; #better error message
2853
2854   my $custnum = $session->{'custnum'};
2855   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
2856     or return { 'error' => "unknown custnum $custnum" };
2857
2858   my $pkgnum = $p->{'pkgnum'};
2859   my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
2860                                         'pkgnum'  => $pkgnum,   } )
2861     or return { 'error' => "unknown pkgnum $pkgnum" };
2862
2863   my $error = $cust_pkg->cancel( 'quiet' => 1,
2864                                  'date'  => $p->{'date'},
2865                                );
2866   return { 'error' => $error };
2867 }
2868
2869 sub provision_phone {
2870   my $p = shift;
2871   my @bulkdid;
2872   @bulkdid = @{$p->{'bulkdid'}} if $p->{'bulkdid'};
2873
2874   #editing an existing phone number
2875   if ( $p->{'svcnum'} && $p->{'svcnum'} =~ /^\d+$/ ) {
2876       my($context, $session, $custnum) = _custoragent_session_custnum($p);
2877       return { 'error' => $session } if $context eq 'error';
2878
2879       my $svc_phone = qsearchs('svc_phone', { svcnum => $p->{'svcnum'} });
2880       return { 'error' => 'service not found' } unless $svc_phone;
2881       return { 'error' => 'invalid svcnum' }
2882         if $svc_phone && $svc_phone->cust_svc->cust_pkg->custnum != $custnum;
2883
2884       $svc_phone->email($p->{'email'})
2885         if $svc_phone->email ne $p->{'email'} && $p->{'email'} =~ /^([\w\.\d@]+|)$/;
2886       $svc_phone->forwarddst($p->{'forwarddst'})
2887         if $svc_phone->forwarddst ne $p->{'forwarddst'}
2888             && $p->{'forwarddst'} =~ /^(\d+|)$/;
2889       return { 'error' => $svc_phone->replace };
2890  }
2891
2892   # single DID LNP
2893   unless ( $p->{'lnp'} ) {
2894     $p->{'lnp_desired_due_date'} = parse_datetime($p->{'lnp_desired_due_date'});
2895     $p->{'lnp_status'} = "portingin";
2896     return _provision( 'FS::svc_phone',
2897                   [qw(lnp_desired_due_date lnp_other_provider
2898                     lnp_other_provider_account phonenum countrycode lnp_status)],
2899                   [qw(phonenum countrycode)],
2900                   $p,
2901                   @_
2902                 );
2903   }
2904
2905   # single DID order (the usual case)
2906   unless (scalar(@bulkdid)) {
2907     return _provision( 'FS::svc_phone',
2908                   [qw(phonenum countrycode)],
2909                   [qw(phonenum countrycode)],
2910                   $p,
2911                   @_
2912                 );
2913   }
2914
2915   # bulk DID order case
2916   my $error;
2917   foreach my $did ( @bulkdid ) {
2918     $did =~ s/[^0-9]//g;
2919     $error = _provision( 'FS::svc_phone',
2920               [qw(phonenum countrycode)],
2921               [qw(phonenum countrycode)],
2922               {
2923                 'pkgnum' => $p->{'pkgnum'},
2924                 'svcpart' => $p->{'svcpart'},
2925                 'phonenum' => $did,
2926                 'countrycode' => $p->{'countrycode'},
2927                 'session_id' => $p->{'session_id'},
2928               }
2929             );
2930     return $error if ($error->{'error'} && length($error->{'error'}) > 1);
2931   }
2932   { 'bulkdid' => [ @bulkdid ], 'svc' => $error->{'svc'} }
2933 }
2934
2935 sub provision_pbx {
2936   my $p = shift;
2937   warn "provision_pbx called\n"
2938     if $DEBUG;
2939
2940   warn "provision_pbx calling _provision\n"
2941     if $DEBUG;
2942   _provision( 'FS::svc_pbx',
2943               [qw(id title max_extensions max_simultaneous ip_addr)],
2944               [qw(id title max_extensions max_simultaneous ip_addr)],
2945               $p,
2946               @_
2947             );
2948 }
2949
2950 sub provision_acct {
2951   my $p = shift;
2952   warn "provision_acct called\n"
2953     if $DEBUG;
2954
2955   return { 'error' => gettext('passwords_dont_match') }
2956     if $p->{'_password'} ne $p->{'_password2'};
2957   return { 'error' => gettext('empty_password') }
2958     unless length($p->{'_password'});
2959
2960   if ($p->{'domsvc'}) {
2961     my %domains = domain_select_hash FS::svc_acct(map { $_ => $p->{$_} }
2962                                                   qw ( svcpart pkgnum ) );
2963     return { 'error' => gettext('invalid_domain') }
2964       unless ($domains{$p->{'domsvc'}});
2965   }
2966
2967   warn "provision_acct calling _provision\n"
2968     if $DEBUG;
2969   _provision( 'FS::svc_acct',
2970               [qw(username _password domsvc)],
2971               [qw(username _password domsvc)],
2972               $p,
2973               @_
2974             );
2975 }
2976
2977 sub provision_external {
2978   my $p = shift;
2979   #_provision( 'FS::svc_external', [qw(id title)], [qw(id title)], $p, @_ );
2980   _provision( 'FS::svc_external',
2981               [],
2982               [qw(id title)],
2983               $p,
2984               @_
2985             );
2986 }
2987
2988 sub provision_forward {
2989   my $p = shift;
2990   _provision( 'FS::svc_forward',
2991               ['srcsvc','src','dstsvc','dst'],
2992               [],
2993               $p,
2994             );
2995 }
2996
2997 sub _provision {
2998   my( $class, $fields, $return_fields, $p ) = splice(@_, 0, 4);
2999   warn "_provision called for $class\n"
3000     if $DEBUG;
3001
3002   my($context, $session, $custnum) = _custoragent_session_custnum($p);
3003   return { 'error' => $session } if $context eq 'error';
3004
3005   my $search = { 'custnum' => $custnum };
3006   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
3007   my $cust_main = qsearchs('cust_main', $search )
3008     or return { 'error' => "unknown custnum $custnum" };
3009
3010   my $pkgnum = $p->{'pkgnum'};
3011
3012   warn "searching for custnum $custnum pkgnum $pkgnum\n"
3013     if $DEBUG;
3014   my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
3015                                         'pkgnum'  => $pkgnum,
3016                                                                } )
3017     or return { 'error' => "unknown pkgnum $pkgnum" };
3018
3019   warn "searching for svcpart ". $p->{'svcpart'}. "\n"
3020     if $DEBUG;
3021   my $part_svc = qsearchs('part_svc', { 'svcpart' => $p->{'svcpart'} } )
3022     or return { 'error' => "unknown svcpart $p->{'svcpart'}" };
3023
3024   return { error=> 'svcpart '. $p->{'svcpart'}. " is not a $class definition" }
3025     if $class ne 'FS::'. $part_svc->svcdb;
3026
3027   warn "creating $class record\n"
3028     if $DEBUG;
3029   my $svc_x = $class->new( {
3030     'pkgnum'  => $p->{'pkgnum'},
3031     'svcpart' => $p->{'svcpart'},
3032     map { $_ => $p->{$_} } @$fields
3033   } );
3034
3035   my %insert_args = ();
3036   #i shouldn't be a special case here (pass an option or something)
3037   if ( $class eq 'FS::svc_phone'
3038          && grep length($p->{$_}), @location_editable_fields
3039      )
3040   {
3041     $insert_args{'cust_location'} = new FS::cust_location {
3042       map { $_ => $p->{$_} } @location_editable_fields
3043     };
3044   }
3045
3046   warn "inserting $class record\n"
3047     if $DEBUG;
3048   my $error = $svc_x->insert(%insert_args);
3049
3050   unless ( $error ) {
3051     warn "finding inserted record for svcnum ". $svc_x->svcnum. "\n"
3052       if $DEBUG;
3053     $svc_x = qsearchs($svc_x->table, { 'svcnum' => $svc_x->svcnum })
3054   }
3055
3056   my $return = { 'svc'   => $part_svc->svc,
3057                  'error' => $error,
3058                  map { $_ => $svc_x->get($_) } @$return_fields
3059                };
3060   warn "_provision returning ". Dumper($return). "\n"
3061     if $DEBUG;
3062   return $return;
3063
3064 }
3065
3066 sub part_svc_info {
3067   my $p = shift;
3068
3069   my($context, $session, $custnum) = _custoragent_session_custnum($p);
3070   return { 'error' => $session } if $context eq 'error';
3071
3072   my $search = { 'custnum' => $custnum };
3073   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
3074   my $cust_main = qsearchs('cust_main', $search )
3075     or return { 'error' => "unknown custnum $custnum" };
3076
3077   my $pkgnum = $p->{'pkgnum'};
3078
3079   my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
3080                                         'pkgnum'  => $pkgnum,
3081                                                                } )
3082     or return { 'error' => "unknown pkgnum $pkgnum" };
3083
3084   my $svcpart = $p->{'svcpart'};
3085
3086   my $pkg_svc = qsearchs('pkg_svc', { 'pkgpart' => $cust_pkg->pkgpart,
3087                                       'svcpart' => $svcpart,           } )
3088     or return { 'error' => "unknown svcpart $svcpart for pkgnum $pkgnum" };
3089   my $part_svc = $pkg_svc->part_svc;
3090
3091   my $conf = new FS::Conf;
3092
3093   my $ret = {
3094     'svc'     => $part_svc->svc,
3095     'svcdb'   => $part_svc->svcdb,
3096     'pkgnum'  => $pkgnum,
3097     'svcpart' => $svcpart,
3098     'custnum' => $custnum,
3099
3100     'security_phrase' => 0, #XXX !
3101     'svc_acct_pop'    => [], #XXX !
3102     'popnum'          => '',
3103     'init_popstate'   => '',
3104     'popac'           => '',
3105     'acstate'         => '',
3106
3107     'small_custview' =>
3108       small_custview( $cust_main, $conf->config('countrydefault') ),
3109
3110   };
3111
3112   if ($p->{'svcnum'} && $p->{'svcnum'} =~ /^\d+$/
3113                      && $ret->{'svcdb'} eq 'svc_phone') {
3114         $ret->{'svcnum'} = $p->{'svcnum'};
3115         my $svc_phone = qsearchs('svc_phone', { svcnum => $p->{'svcnum'} });
3116         if ( $svc_phone && $svc_phone->cust_svc->cust_pkg->custnum == $custnum ) {
3117             $ret->{'email'} = $svc_phone->email;
3118             $ret->{'forwarddst'} = $svc_phone->forwarddst;
3119         }
3120   }
3121
3122   if ($ret->{'svcdb'} eq 'svc_forward') {
3123     $ret->{'forward_emails'} = {$cust_pkg->forward_emails()};
3124   }
3125
3126   $ret;
3127 }
3128
3129 sub unprovision_svc {
3130   my $p = shift;
3131
3132   my($context, $session, $custnum) = _custoragent_session_custnum($p);
3133   return { 'error' => $session } if $context eq 'error';
3134
3135   my $search = { 'custnum' => $custnum };
3136   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
3137   my $cust_main = qsearchs('cust_main', $search )
3138     or return { 'error' => "unknown custnum $custnum" };
3139
3140   my $svcnum = $p->{'svcnum'};
3141
3142   my $cust_svc = qsearchs('cust_svc', { 'svcnum'  => $svcnum, } )
3143     or return { 'error' => "unknown svcnum $svcnum" };
3144
3145   return { 'error' => "Service $svcnum does not belong to customer $custnum" }
3146     unless $cust_svc->cust_pkg->custnum == $custnum;
3147
3148   my $conf = new FS::Conf;
3149
3150   return { 'svc'   => $cust_svc->part_svc->svc,
3151            'error' => $cust_svc->cancel,
3152            'small_custview' =>
3153              small_custview( $cust_main, $conf->config('countrydefault') ),
3154          };
3155
3156 }
3157
3158 sub myaccount_passwd {
3159   my $p = shift;
3160   my($context, $session, $custnum) = _custoragent_session_custnum($p);
3161   return { 'error' => $session } if $context eq 'error';
3162
3163   return { 'error' => "New passwords don't match." }
3164     if $p->{'new_password'} ne $p->{'new_password2'};
3165
3166   return { 'error' => 'Enter new password' }
3167     unless length($p->{'new_password'});
3168
3169   #my $search = { 'custnum' => $custnum };
3170   #$search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
3171   $custnum =~ /^(\d+)$/ or die "illegal custnum";
3172   my $search = " AND custnum = $1";
3173   $search .= " AND agentnum = ". $session->{'agentnum'} if $context eq 'agent';
3174
3175   my $svc_acct = qsearchs( {
3176     'table'     => 'svc_acct',
3177     'addl_from' => 'LEFT JOIN cust_svc  USING ( svcnum  ) '.
3178                    'LEFT JOIN cust_pkg  USING ( pkgnum  ) '.
3179                    'LEFT JOIN cust_main USING ( custnum ) ',
3180     'hashref'   => { 'svcnum' => $p->{'svcnum'}, },
3181     'extra_sql' => $search, #important
3182   } )
3183     or return { 'error' => "Service not found" };
3184
3185   my $error = '';
3186
3187   my $conf = new FS::Conf;
3188
3189   return { 'error' => 'Incorrect current password.' }
3190     if  ( exists($p->{'old_password'})
3191           || $conf->exists('selfservice-password_change_oldpass')
3192         )
3193     && ! $svc_acct->check_password($p->{'old_password'});
3194
3195   $error ||= $svc_acct->is_password_allowed($p->{'new_password'})
3196          ||  $svc_acct->set_password($p->{'new_password'})
3197          ||  $svc_acct->replace();
3198
3199   #regular pw change in self-service should change contact pw too, otherwise its
3200   #way too confusing.  hell its confusing they're separate at all, but alas.
3201   #need to support the "ISP provides email that's used as a contact email" case
3202   #as well as we can.
3203   my $contact = FS::contact->by_selfservice_email($svc_acct->email);
3204   if ( $contact && qsearchs('cust_contact', { contactnum=> $contact->contactnum,
3205                                               custnum   => $custnum,
3206                                               selfservice_access => 'Y',
3207                                             }
3208                            )
3209   ) {
3210     #svc_acct was successful but this one returns an error?  "shouldn't happen"
3211     #don't recheck is_password_allowed here; if the svc_acct password was
3212     #legal, that's good enough
3213     $error ||= $contact->change_password($p->{'new_password'});
3214   }
3215
3216   my($label, $value) = $svc_acct->cust_svc->label;
3217
3218   return { 'error' => $error,
3219            'label' => $label,
3220            'value' => $value,
3221          };
3222
3223 }
3224
3225 sub reset_passwd {
3226   my $p = shift;
3227
3228   my $info = skin_info($p);
3229
3230   my $conf = new FS::Conf;
3231   my $verification = $conf->config('selfservice-password_reset_verification')
3232     or return { %$info, 'error' => 'Password resets disabled' };
3233
3234   my $contact = '';
3235   my $svc_acct = '';
3236   my $cust_main = '';
3237   if ( $p->{'email'} ) { #new-style, changes contact and svc_acct
3238
3239     $contact = FS::contact->by_selfservice_email($p->{'email'});
3240
3241     if ( $contact ) {
3242       my @cust_contact = grep $_->selfservice_access, $contact->cust_contact;
3243       $cust_main = $cust_contact[0]->cust_main if scalar(@cust_contact) == 1;
3244     }
3245
3246     #also look for an svc_acct, otherwise it would be super confusing
3247
3248     my($username, $domain) = split('@', $p->{'email'});
3249     my $svc_domain = qsearchs('svc_domain', { 'domain' => $domain } );
3250     if ( $svc_domain ) {
3251       $svc_acct = qsearchs('svc_acct', { 'username' => $username,
3252                                          'domsvc'   => $svc_domain->svcnum  }
3253                           );
3254       if ( $svc_acct ) {
3255         my $cust_pkg = $svc_acct->cust_svc->cust_pkg;
3256         $cust_main ||= $cust_pkg->cust_main if $cust_pkg;
3257
3258         #precaution: don't change svc_acct password not part of the same
3259         # customer as contact
3260         $svc_acct = '' if ! $cust_pkg
3261                        || $cust_pkg->custnum != $cust_main->custnum;
3262       }
3263
3264     }
3265
3266     return { %$info, 'error' => 'Email address not found' }
3267       unless $contact || $svc_acct;
3268
3269   } elsif ( $p->{'username'} ) { #old style, looks in svc_acct only
3270
3271     my $svc_domain = qsearchs('svc_domain', { 'domain' => $p->{'domain'} } )
3272       or return { %$info, 'error' => 'Account not found' };
3273
3274     $svc_acct = qsearchs('svc_acct', { 'username' => $p->{'username'},
3275                                        'domsvc'   => $svc_domain->svcnum  }
3276                         )
3277       or return { %$info, 'error' => 'Account not found' };
3278
3279     my $cust_pkg = $svc_acct->cust_svc->cust_pkg
3280       or return { %$info, 'error' => 'Account not found' };
3281
3282     $cust_main = $cust_pkg->cust_main;
3283
3284   }
3285
3286   return { %$info, 'error' => 'Multi-customer contacts incompatible with customer-based verification' }
3287     if ! $cust_main && $verification ne 'email';
3288
3289   my %verify = (
3290     'email'   => sub { 1; },
3291     'paymask' => sub {
3292       my( $p, $cust_main ) = @_;
3293       $cust_main->payby =~ /^(CARD|DCRD|CHEK|DCHK)$/
3294         && $p->{'paymask'} eq substr($cust_main->paymask, -4)
3295     },
3296     'amount'  => sub {
3297       my( $p, $cust_main ) = @_;
3298       my $cust_pay = qsearchs({
3299         'table' => 'cust_pay',
3300         'hashref' => { 'custnum' => $cust_main->custnum },
3301         'order_by' => 'ORDER BY _date DESC LIMIT 1',
3302       })
3303         or return 0;
3304
3305       $p->{'amount'} == $cust_pay->paid;
3306     },
3307     'zip'     => sub {
3308       my( $p, $cust_main ) = @_;
3309       $p->{'zip'} eq $cust_main->zip
3310         || ( $cust_main->ship_zip && $p->{'zip'} eq $cust_main->ship_zip );
3311     },
3312   );
3313
3314   foreach my $verify ( split(',', $verification) ) {
3315
3316     &{ $verify{$verify} }( $p, $cust_main )
3317       or return { %$info, 'error' => 'Account not found' };
3318
3319   }
3320
3321   #okay, we're verified
3322
3323   if ( $contact ) {
3324
3325     my $error = $contact->send_reset_email(
3326                             'svcnum' => ($svc_acct ? $svc_acct->svcnum : ''),
3327                           );
3328
3329     if ( $error ) {
3330       return { %$info, 'error' => $error }; #????
3331     }
3332
3333   } elsif ( $svc_acct ) {
3334
3335     #create a unique session
3336
3337     my $reset_session = {
3338       'svcnum'   => $svc_acct->svcnum,
3339       'agentnum' => $svc_acct->cust_main->agentnum,
3340     };
3341
3342     my $timeout = '1 hour'; #?
3343
3344     my $reset_session_id;
3345     do {
3346       $reset_session_id = sha512_hex(time(). {}. rand(). $$)
3347     } until ( ! defined _cache->get("reset_passwd_$reset_session_id") );
3348       #just in case
3349
3350     _cache->set( "reset_passwd_$reset_session_id", $reset_session, $timeout );
3351
3352     #email it
3353
3354     my $msgnum = $conf->config('selfservice-password_reset_msgnum',
3355                                $cust_main->agentnum);
3356     #die "selfservice-password_reset_msgnum unset" unless $msgnum;
3357     return { %$info, 'error' => "selfservice-password_reset_msgnum unset" }
3358       unless $msgnum;
3359     my $msg_template = qsearchs('msg_template', { msgnum => $msgnum } );
3360     my $error = $msg_template->send( 'cust_main'     => $cust_main,
3361                                      'object'        => $svc_acct,
3362                                      'substitutions' => {
3363                                        'session_id' => $reset_session_id,
3364                                      }
3365                                    );
3366     if ( $error ) {
3367       return { %$info, 'error' => $error }; #????
3368     }
3369
3370   }
3371
3372   return { %$info, 'error' => '' };
3373 }
3374
3375 sub check_reset_passwd {
3376   my $p = shift;
3377
3378   my $conf = new FS::Conf;
3379   my $verification = $conf->config('selfservice-password_reset_verification')
3380     or return { 'error' => 'Password resets disabled' };
3381
3382   my $reset_session = _cache->get('reset_passwd_'. $p->{'session_id'})
3383     or return { 'error' => "Can't resume session" }; #better error message
3384
3385   if ( $reset_session->{'svcnum'} ) {
3386
3387     my $svcnum = $reset_session->{'svcnum'};
3388
3389     my $svc_acct = qsearchs('svc_acct', { 'svcnum' => $svcnum } )
3390       or return { 'error' => "Service not found" };
3391
3392     $p->{'agentnum'} = $svc_acct->cust_svc->cust_pkg->cust_main->agentnum;
3393     my $info = skin_info($p);
3394
3395     return { %$info,
3396              'error'      => '',
3397              'session_id' => $p->{'session_id'},
3398              'username'   => $svc_acct->username,
3399            };
3400
3401   } elsif ( $reset_session->{'contactnum'} ) {
3402
3403     my $contactnum = $reset_session->{'contactnum'};
3404
3405     my $contact = qsearchs('contact', { 'contactnum' => $contactnum } )
3406       or return { 'error' => "Contact not found" };
3407
3408     my @contact_email = $contact->contact_email;
3409     return { 'error' => 'No contact email' } unless @contact_email;
3410
3411     my @cust_contact = grep $_->selfservice_access, $contact->cust_contact;
3412     $p->{'agentnum'} = $cust_contact[0]->cust_main->agentnum
3413       if scalar(@cust_contact) == 1;
3414     my $info = skin_info($p);
3415
3416     return { %$info,
3417              'error'      => '',
3418              'session_id' => $p->{'session_id'},
3419              'email'      => $contact_email[0]->email, #the first?
3420            };
3421
3422   } else {
3423
3424     return { 'error' => 'No svcnum or contactnum in session' }; #??
3425
3426   }
3427
3428 }
3429
3430 sub process_reset_passwd {
3431   my $p = shift;
3432
3433   my $conf = new FS::Conf;
3434   my $verification = $conf->config('selfservice-password_reset_verification')
3435     or return { 'error' => 'Password resets disabled' };
3436
3437   my $reset_session = _cache->get('reset_passwd_'. $p->{'session_id'})
3438     or return { 'error' => "Can't resume session" }; #better error message
3439
3440   my $info = '';
3441
3442   my $svc_acct = '';
3443   if ( $reset_session->{'svcnum'} ) {
3444
3445     my $svcnum = $reset_session->{'svcnum'};
3446
3447     $svc_acct = qsearchs('svc_acct', { 'svcnum' => $svcnum } )
3448       or return { 'error' => "Service not found" };
3449
3450     $p->{'agentnum'} ||= $svc_acct->cust_svc->cust_pkg->cust_main->agentnum;
3451     $info ||= skin_info($p);
3452
3453   }
3454
3455   my $contact = '';
3456   if ( $reset_session->{'contactnum'} ) {
3457
3458     my $contactnum = $reset_session->{'contactnum'};
3459
3460     $contact = qsearchs('contact', { 'contactnum' => $contactnum } )
3461       or return { 'error' => "Contact not found" };
3462
3463     my @cust_contact = grep $_->selfservice_access, $contact->cust_contact;
3464     $p->{'agentnum'} = $cust_contact[0]->cust_main->agentnum
3465       if scalar(@cust_contact) == 1;
3466     $info ||= skin_info($p);
3467
3468   }
3469
3470   return { %$info, 'error' => "New passwords don't match." }
3471     if $p->{'new_password'} ne $p->{'new_password2'};
3472
3473   return { %$info, 'error' => 'Enter new password' }
3474     unless length($p->{'new_password'});
3475
3476   if ( $svc_acct ) {
3477
3478     my $error ||= $svc_acct->is_password_allowed($p->{'new_password'})
3479               ||  $svc_acct->set_password($p->{'new_password'})
3480               ||  $svc_acct->replace();
3481
3482     return { %$info, 'error' => $error } if $error;
3483
3484     #my($label, $value) = $svc_acct->cust_svc->label;
3485     #return { 'error' => $error,
3486     #         #'label' => $label,
3487     #         #'value' => $value,
3488     #       };
3489
3490   }
3491
3492   if ( $contact ) {
3493
3494     my $error = $contact->is_password_allowed($p->{'new_password'})
3495             ||  $contact->change_password($p->{'new_password'});
3496
3497     return { %$info, 'error' => $error }; # if $error;
3498
3499   }
3500
3501   #password changed ,so remove session, don't want it reused
3502   _cache->remove($p->{'session_id'});
3503
3504   return { %$info, 'error' => '' };
3505
3506 }
3507
3508 sub validate_passwd {
3509   my $p = shift;
3510
3511   my %result;
3512   %result = ( 'fieldid' => $p->{'fieldid'} )
3513     if $p->{'fieldid'} =~ /^\w+$/;
3514
3515   return { %result, 'password_invalid' => 'Enter new password' }
3516     unless length($p->{'check_password'});
3517
3518   my $svc_acct;
3519   if ($p->{'svcnum'}) {
3520     # false laziness with myaccount_passwd
3521     my($context, $session, $custnum) = _custoragent_session_custnum($p);
3522     return { %result, 'error' => $session } if $context eq 'error';
3523
3524     $custnum =~ /^(\d+)$/ or die "illegal custnum";
3525     my $search = " AND custnum = $1";
3526     $search .= " AND agentnum = ". $session->{'agentnum'} if $context eq 'agent';
3527
3528     $svc_acct = qsearchs( {
3529       'table'     => 'svc_acct',
3530       'addl_from' => 'LEFT JOIN cust_svc  USING ( svcnum  ) '.
3531                      'LEFT JOIN cust_pkg  USING ( pkgnum  ) '.
3532                      'LEFT JOIN cust_main USING ( custnum ) ',
3533       'hashref'   => { 'svcnum' => $p->{'svcnum'}, },
3534       'extra_sql' => $search, #important
3535     } )
3536       or return { %result, 'error' => "Service not found" };
3537     # end false laziness
3538   }
3539
3540   $svc_acct ||= new FS::svc_acct {};
3541
3542   my $error = $svc_acct->is_password_allowed($p->{'check_password'});
3543   return { %result, 'password_invalid' => $error } if $error;
3544   return { %result, 'password_valid' => 1 };
3545 }
3546
3547 sub list_tickets {
3548   my $p = shift;
3549   my($context, $session, $custnum) = _custoragent_session_custnum($p);
3550   return { 'error' => $session } if $context eq 'error';
3551
3552   my @tickets = ();
3553   if ( $session->{'pkgnum'} ) {
3554
3555     #tickets for specific service with pkg-balances on
3556     my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
3557                                           'pkgnum'  => $session->{'pkgnum'} })
3558                      or return { 'error' => 'unknown package' };
3559     foreach my $cust_svc ( $cust_pkg->cust_svc ) {
3560       push @tickets, $cust_svc->tickets( $p->{status} );
3561     }
3562
3563   } else {
3564
3565     my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
3566       or return { 'error' => "unknown custnum $custnum" };
3567
3568     @tickets = $cust_main->tickets( $p->{status} );
3569   }
3570
3571   # unavoidable false laziness w/ httemplate/view/cust_main/tickets.html
3572   if ( $FS::TicketSystem::system && FS::TicketSystem->selfservice_priority ) {
3573     my $conf = new FS::Conf;
3574     my $dir = $conf->exists('ticket_system-priority_reverse') ? -1 : 1;
3575     +{ tickets => [
3576          sort {
3577            (
3578              ($a->{'_selfservice_priority'} eq '') <=>
3579              ($b->{'_selfservice_priority'} eq '')
3580            ) ||
3581            ( $dir *
3582              ($b->{'_selfservice_priority'} <=> $a->{'_selfservice_priority'})
3583            )
3584          } @tickets
3585        ]
3586     };
3587   } else {
3588     +{ tickets => \@tickets };
3589   }
3590
3591 }
3592
3593 sub create_ticket {
3594   my $p = shift;
3595   my($context, $session, $custnum) = _custoragent_session_custnum($p);
3596   return { 'error' => $session } if $context eq 'error';
3597
3598   warn "$me create_ticket: initializing ticket system\n" if $DEBUG;
3599   FS::TicketSystem->init();
3600
3601   my $conf = new FS::Conf;
3602   my $queue = $p->{'queue'}
3603               || $conf->config('ticket_system-selfservice_queueid')
3604               || $conf->config('ticket_system-default_queueid');
3605
3606   warn "$me create_ticket: creating ticket\n" if $DEBUG;
3607   my $err_or_ticket = FS::TicketSystem->create_ticket(
3608     '', #create RT session based on FS CurrentUser (fs_selfservice)
3609     'queue'   => $queue,
3610     'custnum' => $custnum,
3611     'svcnum'  => $session->{'svcnum'},
3612     map { $_ => $p->{$_} } qw( requestor cc subject message mime_type )
3613   );
3614
3615   if ( ref($err_or_ticket) ) {
3616     warn "$me create_ticket: successful: ". $err_or_ticket->id. "\n"
3617       if $DEBUG;
3618     return { 'error'     => '',
3619              'ticket_id' => $err_or_ticket->id,
3620            };
3621   } else {
3622     warn "$me create_ticket: unsuccessful: $err_or_ticket\n"
3623       if $DEBUG;
3624     return { 'error' => $err_or_ticket };
3625   }
3626
3627
3628 }
3629
3630 sub did_report {
3631   my $p = shift;
3632   my($context, $session, $custnum) = _custoragent_session_custnum($p);
3633   return { 'error' => $session } if $context eq 'error';
3634
3635   return { error => 'requested format not implemented' }
3636     unless ($p->{'format'} eq 'csv' || $p->{'format'} eq 'xls');
3637
3638   my $conf = new FS::Conf;
3639   my $age_threshold = 0;
3640   $age_threshold = time() - $conf->config('selfservice-recent-did-age')
3641     if ($p->{'recentonly'} && $conf->exists('selfservice-recent-did-age'));
3642
3643   my $search = { 'custnum' => $custnum };
3644   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
3645   my $cust_main = qsearchs('cust_main', $search )
3646     or return { 'error' => "unknown custnum $custnum" };
3647
3648 # does it make more sense to just run one sql query for this instead of all the
3649 # insanity below? would increase performance greately for large data sets?
3650   my @svc_phone = ();
3651   foreach my $cust_pkg ( $cust_main->ncancelled_pkgs ) {
3652         my @part_svc = $cust_pkg->part_svc;
3653         foreach my $part_svc ( @part_svc ) {
3654             if($part_svc->svcdb eq 'svc_phone'){
3655                 my @cust_pkg_svc = @{$part_svc->cust_pkg_svc};
3656                 foreach my $cust_pkg_svc ( @cust_pkg_svc ) {
3657                     push @svc_phone, $cust_pkg_svc->svc_x
3658                         if $cust_pkg_svc->date_inserted >= $age_threshold;
3659                 }
3660             }
3661         }
3662   }
3663
3664   my $csv;
3665   my $xls;
3666   my($xls_r,$xls_c) = (0,0);
3667   my $xls_workbook;
3668   my $content = '';
3669   my @fields = qw( countrycode phonenum pin sip_password phone_name );
3670   if($p->{'format'} eq 'csv') {
3671     $csv = new Text::CSV_XS { 'always_quote' => 1,
3672                                  'eol'          => "\n",
3673                                 };
3674     return { 'error' => 'Unable to create CSV' } unless $csv->combine(@fields);
3675     $content .= $csv->string;
3676   }
3677   elsif($p->{'format'} eq 'xls') {
3678     my $XLS1 = new IO::Scalar \$content;
3679     $xls_workbook = Spreadsheet::WriteExcel->new($XLS1)
3680         or return { 'error' => "Error opening .xls file: $!" };
3681     $xls = $xls_workbook->add_worksheet('DIDs');
3682     foreach ( @fields ) {
3683         $xls->write(0,$xls_c++,$_);
3684     }
3685     $xls_r++;
3686   }
3687
3688   foreach my $svc_phone ( @svc_phone ) {
3689     my @cols = map { $svc_phone->$_ } @fields;
3690     if($p->{'format'} eq 'csv') {
3691         return { 'error' => 'Unable to create CSV' }
3692             unless $csv->combine(@cols);
3693         $content .= $csv->string;
3694     }
3695     elsif($p->{'format'} eq 'xls') {
3696         $xls_c = 0;
3697         foreach ( @cols ) {
3698             $xls->write($xls_r,$xls_c++,$_);
3699         }
3700         $xls_r++;
3701     }
3702   }
3703
3704   $xls_workbook->close() if $p->{'format'} eq 'xls';
3705
3706   { content => $content, format => $p->{'format'}, };
3707 }
3708
3709 sub get_ticket {
3710   my $p = shift;
3711   my($context, $session, $custnum) = _custoragent_session_custnum($p);
3712   return { 'error' => $session } if $context eq 'error';
3713
3714 #  warn "$me get_ticket: initializing ticket system\n" if $DEBUG;
3715 #  FS::TicketSystem->init();
3716 #  return { 'error' => 'get_ticket configuration error' }
3717 #    if $FS::TicketSystem::system ne 'RT_Internal';
3718
3719   # check existence and ownership as part of this
3720   warn "$me get_ticket: fetching ticket\n" if $DEBUG;
3721   my $rt_session = FS::TicketSystem->session('');
3722   my $Ticket = FS::TicketSystem->get_ticket_object(
3723     $rt_session,
3724     ticket_id => $p->{'ticket_id'},
3725     custnum => $custnum
3726   );
3727   return { 'error' => 'ticket not found' } if !$Ticket;
3728
3729   if ( length( $p->{'subject'} || '' ) ) {
3730     # subject change
3731     if ( $p->{'subject'} ne $Ticket->Subject ) {
3732       my ($val, $msg) = $Ticket->SetSubject($p->{'subject'});
3733       return { 'error' => "unable to set subject: $msg" } if !$val;
3734     }
3735   }
3736
3737   if(length($p->{'reply'})) {
3738     my @err_or_res = FS::TicketSystem->correspond_ticket(
3739       $rt_session,
3740       'ticket_id' => $p->{'ticket_id'},
3741       'content' => $p->{'reply'},
3742     );
3743
3744     return { 'error' => 'unable to reply to ticket' }
3745     unless ( $err_or_res[0] != 0 && defined $err_or_res[2] );
3746   }
3747
3748   warn "$me get_ticket: getting ticket history\n" if $DEBUG;
3749   my $err_or_ticket = FS::TicketSystem->get_ticket(
3750     $rt_session,
3751     'ticket_id' => $p->{'ticket_id'},
3752   );
3753
3754   if ( !ref($err_or_ticket) ) { # there is no way this should ever happen
3755     warn "$me get_ticket: unsuccessful: $err_or_ticket\n"
3756       if $DEBUG;
3757     return { 'error' => $err_or_ticket };
3758   }
3759
3760   my @custs = @{$err_or_ticket->{'custs'}};
3761   my @txns = @{$err_or_ticket->{'txns'}};
3762   my @filtered_txns;
3763
3764   # superseded by check in get_ticket_object
3765   #return { 'error' => 'invalid ticket requested' }
3766   #unless grep($_ eq $custnum, @custs);
3767
3768   foreach my $txn ( @txns ) {
3769     push @filtered_txns, $txn
3770     if ($txn->{'type'} eq 'EmailRecord'
3771       || $txn->{'type'} eq 'Correspond'
3772       || $txn->{'type'} eq 'Create');
3773   }
3774
3775   warn "$me get_ticket: successful: \n"
3776   if $DEBUG;
3777   return { 'error'     => '',
3778     'transactions' => \@filtered_txns,
3779     'ticket_fields' => $err_or_ticket->{'fields'},
3780     'ticket_id' => $p->{'ticket_id'},
3781   };
3782 }
3783
3784 sub adjust_ticket_priority {
3785   my $p = shift;
3786   my($context, $session, $custnum) = _custoragent_session_custnum($p);
3787   return { 'error' => $session } if $context eq 'error';
3788
3789 #  warn "$me adjust_ticket_priority: initializing ticket system\n" if $DEBUG;
3790 #  FS::TicketSystem->init;
3791   my $ss_priority = FS::TicketSystem->selfservice_priority;
3792
3793   return { 'error' => 'adjust_ticket_priority configuration error' }
3794     if $FS::TicketSystem::system ne 'RT_Internal'
3795       or !$ss_priority;
3796
3797   my $values = $p->{'values'}; #hashref, id => priority value
3798   my %ticket_error;
3799
3800   foreach my $id (keys %$values) {
3801     warn "$me adjust_ticket_priority: fetching ticket $id\n" if $DEBUG;
3802     my $Ticket = FS::TicketSystem->get_ticket_object('',
3803       'ticket_id' => $id,
3804       'custnum'   => $custnum,
3805     );
3806     if ( !$Ticket ) {
3807       $ticket_error{$id} = 'ticket not found';
3808       next;
3809     }
3810
3811   # RT API stuff--would we gain anything by wrapping this in FS::TicketSystem?
3812   # We're not going to implement it for RT_External.
3813     my $old_value = $Ticket->FirstCustomFieldValue($ss_priority);
3814     my $new_value = $values->{$id};
3815     next if $old_value eq $new_value;
3816
3817     warn "$me adjust_ticket_priority: updating ticket $id\n" if $DEBUG;
3818
3819     # AddCustomFieldValue works fine (replacing any existing value) if it's
3820     # a single-valued custom field, which it should be.  If it's not, you're
3821     # doing something wrong.
3822     my ($val, $msg);
3823     if ( length($new_value) ) {
3824       ($val, $msg) = $Ticket->AddCustomFieldValue(
3825         Field => $ss_priority,
3826         Value => $new_value,
3827       );
3828     }
3829     else {
3830       ($val, $msg) = $Ticket->DeleteCustomFieldValue(
3831         Field => $ss_priority,
3832         Value => $old_value,
3833       );
3834     }
3835
3836     $ticket_error{$id} = $msg if !$val;
3837     warn "$me adjust_ticket_priority: $id: $msg\n" if $DEBUG and !$val;
3838   }
3839   return { 'error' => '',
3840            'ticket_error' => \%ticket_error,
3841            %{ customer_info($p) } # send updated customer info back
3842          }
3843 }
3844
3845 #--
3846
3847 sub _custoragent_session_custnum {
3848   my $p = shift;
3849
3850   my($context, $session, $custnum);
3851   if ( $p->{'session_id'} ) {
3852
3853     $context = 'customer';
3854     $session = _cache->get($p->{'session_id'})
3855       or return ( 'error' => "Can't resume session" ); #better error message
3856     $custnum = $session->{'custnum'};
3857
3858   } elsif ( $p->{'agent_session_id'} ) {
3859
3860     $context = 'agent';
3861     my $agent_cache = new FS::ClientAPI_SessionCache( {
3862       'namespace' => 'FS::ClientAPI::Agent',
3863     } );
3864     $session = $agent_cache->get($p->{'agent_session_id'})
3865       or return ( 'error' => "Can't resume session" ); #better error message
3866     $custnum = $p->{'custnum'};
3867
3868   } else {
3869     $context = 'error';
3870     return ( 'error' => "Can't resume session" ); #better error message
3871   }
3872
3873   ($context, $session, $custnum);
3874
3875 }
3876
3877 1;
3878