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 Data::Dumper;
   8 use Digest::MD5 qw(md5_hex);
   9 use Date::Format;
  10 use Business::CreditCard;
  11 use Time::Duration;
  12 use Time::Local qw(timelocal_nocheck);
  13 use FS::UI::Web::small_custview qw(small_custview); #less doh
  14 use FS::UI::Web;
  15 use FS::UI::bytecount qw( display_bytecount );
  16 use FS::Conf;
  17 #use FS::UID qw(dbh);
  18 use FS::Record qw(qsearch qsearchs dbh);
  19 use FS::Msgcat qw(gettext);
  20 use FS::Misc qw(card_types);
  21 use FS::Misc::DateTime qw(parse_datetime);
  22 use FS::ClientAPI_SessionCache;
  23 use FS::svc_acct;
  24 use FS::svc_domain;
  25 use FS::svc_phone;
  26 use FS::svc_external;
  27 use FS::part_svc;
  28 use FS::cust_main;
  29 use FS::cust_bill;
  30 use FS::cust_main_county;
  31 use FS::cust_pkg;
  32 use FS::payby;
  33 use FS::acct_rt_transaction;
  34 use HTML::Entities;
  35 use FS::TicketSystem;
  36 use Text::CSV_XS;
  37 use IO::Scalar;
  38 use Spreadsheet::WriteExcel;
  39
  40 $DEBUG = 0;
  41 $me = '[FS::ClientAPI::MyAccount]';
  42
  43 use vars qw( @cust_main_editable_fields );
  44 @cust_main_editable_fields = qw(
  45   first last company address1 address2 city
  46     county state zip country daytime night fax
  47   ship_first ship_last ship_company ship_address1 ship_address2 ship_city
  48     ship_state ship_zip ship_country ship_daytime ship_night ship_fax
  49   payby payinfo payname paystart_month paystart_year payissue payip
  50   ss paytype paystate stateid stateid_state
  51 );
  52
  53 sub _cache {
  54   $cache ||= new FS::ClientAPI_SessionCache( {
  55                'namespace' => 'FS::ClientAPI::MyAccount',
  56              } );
  57 }
  58
  59 sub skin_info {
  60   my $p = shift;
  61
  62   my($context, $session, $custnum) = _custoragent_session_custnum($p);
  63   #return { 'error' => $session } if $context eq 'error';
  64
  65   my $agentnum = '';
  66   if ( $context eq 'customer' ) {
  67
  68     my $sth = dbh->prepare('SELECT agentnum FROM cust_main WHERE custnum = ?')
  69       or die dbh->errstr;
  70
  71     $sth->execute($custnum) or die $sth->errstr;
  72
  73     $agentnum = $sth->fetchrow_arrayref->[0]
  74       or die "no agentnum for custnum $custnum";
  75
  76   #} elsif ( $context eq 'agent' ) {
  77   } elsif ( $p->{'agentnum'} =~ /^(\d+)$/ ) {
  78     $agentnum = $1;
  79   }
  80
  81   my $conf = new FS::Conf;
  82
  83   #false laziness w/Signup.pm
  84
  85   my $skin_info_cache_agent = _cache->get("skin_info_cache_agent$agentnum");
  86
  87   if ( $skin_info_cache_agent ) {
  88
  89     warn "$me loading cached skin info for agentnum $agentnum\n"
  90       if $DEBUG > 1;
  91
  92   } else {
  93
  94     warn "$me populating skin info cache for agentnum $agentnum\n"
  95       if $DEBUG > 1;
  96
  97     $skin_info_cache_agent = {
  98       'agentnum' => $agentnum,
  99       ( map { $_ => scalar( $conf->config($_, $agentnum) ) }
 100         qw( company_name ) ),
 101       ( map { $_ => scalar( $conf->config("selfservice-$_", $agentnum ) ) }
 102         qw( body_bgcolor box_bgcolor
 103             text_color link_color vlink_color hlink_color alink_color
 104             font title_color title_align title_size menu_bgcolor menu_fontsize
 105           )
 106       ),
 107       ( map { $_ => $conf->exists("selfservice-$_", $agentnum ) }
 108         qw( menu_skipblanks menu_skipheadings menu_nounderline )
 109       ),
 110       ( map { $_ => scalar($conf->config_binary("selfservice-$_", $agentnum)) }
 111         qw( title_left_image title_right_image
 112             menu_top_image menu_body_image menu_bottom_image
 113           )
 114       ),
 115       'logo' => scalar($conf->config_binary('logo.png', $agentnum )),
 116       ( map { $_ => join("\n", $conf->config("selfservice-$_", $agentnum ) ) }
 117         qw( head body_header body_footer company_address ) ),
 118     };
 119
 120     _cache->set("skin_info_cache_agent$agentnum", $skin_info_cache_agent);
 121
 122   }
 123
 124   #{ %$skin_info_cache_agent };
 125   $skin_info_cache_agent;
 126
 127 }
 128
 129 sub login_info {
 130   my $p = shift;
 131
 132   my $conf = new FS::Conf;
 133
 134   my %info = (
 135     %{ skin_info($p) },
 136     'phone_login'  => $conf->exists('selfservice_server-phone_login'),
 137     'single_domain'=> scalar($conf->config('selfservice_server-single_domain')),
 138   );
 139
 140   return \%info;
 141
 142 }
 143
 144 #false laziness w/FS::ClientAPI::passwd::passwd
 145 sub login {
 146   my $p = shift;
 147
 148   my $conf = new FS::Conf;
 149
 150   my $svc_x = '';
 151   if ( $p->{'domain'} eq 'svc_phone'
 152        && $conf->exists('selfservice_server-phone_login') ) {
 153
 154     my $svc_phone = qsearchs( 'svc_phone', { 'phonenum' => $p->{'username'} } );
 155     return { error => 'Number not found.' } unless $svc_phone;
 156
 157     #XXX?
 158     #my $pkg_svc = $svc_acct->cust_svc->pkg_svc;
 159     #return { error => 'Only primary user may log in.' }
 160     #  if $conf->exists('selfservice_server-primary_only')
 161     #    && ( ! $pkg_svc || $pkg_svc->primary_svc ne 'Y' );
 162
 163     return { error => 'Incorrect PIN.' }
 164       unless $svc_phone->check_pin($p->{'password'});
 165
 166     $svc_x = $svc_phone;
 167
 168   } else {
 169
 170     my $svc_domain = qsearchs('svc_domain', { 'domain' => $p->{'domain'} } )
 171       or return { error => 'Domain '. $p->{'domain'}. ' not found' };
 172
 173     my $svc_acct = qsearchs( 'svc_acct', { 'username'  => $p->{'username'},
 174                                            'domsvc'    => $svc_domain->svcnum, }
 175                            );
 176     return { error => 'User not found.' } unless $svc_acct;
 177
 178     if($conf->exists('selfservice_server-login_svcpart')) {
 179         my @svcpart = $conf->config('selfservice_server-login_svcpart');
 180         my $svcpart = $svc_acct->cust_svc->svcpart;
 181         return { error => 'Invalid user.' }
 182             unless grep($_ eq $svcpart, @svcpart);
 183     }
 184
 185     return { error => 'Incorrect password.' }
 186       unless $svc_acct->check_password($p->{'password'});
 187
 188     $svc_x = $svc_acct;
 189
 190   }
 191
 192   my $session = {
 193     'svcnum' => $svc_x->svcnum,
 194   };
 195
 196   my $cust_svc = $svc_x->cust_svc;
 197   my $cust_pkg = $cust_svc->cust_pkg;
 198   if ( $cust_pkg ) {
 199     my $cust_main = $cust_pkg->cust_main;
 200     $session->{'custnum'} = $cust_main->custnum;
 201     if ( $conf->exists('pkg-balances') ) {
 202       my @cust_pkg = grep { $_->part_pkg->freq !~ /^(0|$)/ }
 203                           $cust_main->ncancelled_pkgs;
 204       $session->{'pkgnum'} = $cust_pkg->pkgnum
 205         if scalar(@cust_pkg) > 1;
 206     }
 207   }
 208
 209   #my $pkg_svc = $svc_acct->cust_svc->pkg_svc;
 210   #return { error => 'Only primary user may log in.' }
 211   #  if $conf->exists('selfservice_server-primary_only')
 212   #    && ( ! $pkg_svc || $pkg_svc->primary_svc ne 'Y' );
 213   my $part_pkg = $cust_pkg->part_pkg;
 214   return { error => 'Only primary user may log in.' }
 215     if $conf->exists('selfservice_server-primary_only')
 216        && $cust_svc->svcpart != $part_pkg->svcpart([qw( svc_acct svc_phone )]);
 217
 218   my $session_id;
 219   do {
 220     $session_id = md5_hex(md5_hex(time(). {}. rand(). $$))
 221   } until ( ! defined _cache->get($session_id) ); #just in case
 222
 223   my $timeout = $conf->config('selfservice-session_timeout') || '1 hour';
 224   _cache->set( $session_id, $session, $timeout );
 225
 226   return { 'error'      => '',
 227            'session_id' => $session_id,
 228          };
 229 }
 230
 231 sub logout {
 232   my $p = shift;
 233   if ( $p->{'session_id'} ) {
 234     _cache->remove($p->{'session_id'});
 235     return { %{ skin_info($p) }, 'error' => '' };
 236   } else {
 237     return { %{ skin_info($p) }, 'error' => "Can't resume session" }; #better error message
 238   }
 239 }
 240
 241 sub payment_gateway {
 242   # internal use only
 243   # takes a cust_main and a cust_payby entry, returns the payment_gateway
 244   my $conf = new FS::Conf;
 245   my $cust_main = shift;
 246   my $cust_payby = shift;
 247   my $gatewaynum = $conf->config('selfservice-payment_gateway');
 248   if ( $gatewaynum ) {
 249     my $pg = qsearchs('payment_gateway', { gatewaynum => $gatewaynum });
 250     die "configured gatewaynum $gatewaynum not found!" if !$pg;
 251     return $pg;
 252   }
 253   else {
 254     return '' if ! FS::payby->realtime($cust_payby);
 255     my $pg = $cust_main->agent->payment_gateway(
 256       'method'  => FS::payby->payby2bop($cust_payby),
 257       'nofatal' => 1
 258     );
 259     return $pg;
 260   }
 261 }
 262
 263 sub access_info {
 264   my $p = shift;
 265
 266   my $conf = new FS::Conf;
 267
 268   my $info = skin_info($p);
 269
 270   use vars qw( $cust_paybys ); #cache for performance
 271   unless ( $cust_paybys ) {
 272
 273     my %cust_paybys = map { $_ => 1 }
 274                       map { FS::payby->payby2payment($_) }
 275                           $conf->config('signup_server-payby');
 276
 277     $cust_paybys = [ keys %cust_paybys ];
 278
 279   }
 280   $info->{'cust_paybys'} = $cust_paybys;
 281
 282   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 283   return { 'error' => $session } if $context eq 'error';
 284
 285   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 286     or return { 'error' => "unknown custnum $custnum" };
 287
 288   $info->{'hide_payment_fields'} = [
 289     map {
 290       my $pg = payment_gateway($cust_main, $_);
 291       $pg && $pg->gateway_namespace eq 'Business::OnlineThirdPartyPayment';
 292     } @{ $info->{cust_paybys} }
 293   ];
 294
 295   $info->{'self_suspend_reason'} =
 296       $conf->config('selfservice-self_suspend_reason', $cust_main->agentnum);
 297
 298   return { %$info,
 299            'custnum'       => $custnum,
 300            'access_pkgnum' => $session->{'pkgnum'},
 301            'access_svcnum' => $session->{'svcnum'},
 302          };
 303 }
 304
 305 sub customer_info {
 306   my $p = shift;
 307
 308   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 309   return { 'error' => $session } if $context eq 'error';
 310
 311   my %return;
 312
 313   my $conf = new FS::Conf;
 314   if ($conf->exists('cust_main-require_address2')) {
 315     $return{'require_address2'} = '1';
 316   }else{
 317     $return{'require_address2'} = '';
 318   }
 319
 320   if ( $custnum ) { #customer record
 321
 322     my $search = { 'custnum' => $custnum };
 323     $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
 324     my $cust_main = qsearchs('cust_main', $search )
 325       or return { 'error' => "unknown custnum $custnum" };
 326
 327     if ( $session->{'pkgnum'} ) {
 328       $return{balance} = $cust_main->balance_pkgnum( $session->{'pkgnum'} );
 329     } else {
 330       $return{balance} = $cust_main->balance;
 331     }
 332
 333     $return{tickets} = [ ($cust_main->tickets) ];
 334
 335     unless ( $session->{'pkgnum'} ) {
 336       my @open = map {
 337                        {
 338                          invnum => $_->invnum,
 339                          date   => time2str("%b %o, %Y", $_->_date),
 340                          owed   => $_->owed,
 341                        };
 342                      } $cust_main->open_cust_bill;
 343       $return{open_invoices} = \@open;
 344     }
 345
 346     $return{small_custview} =
 347       small_custview( $cust_main,
 348                       scalar($conf->config('countrydefault')),
 349                       ( $session->{'pkgnum'} ? 1 : 0 ), #nobalance
 350                     );
 351
 352     $return{name} = $cust_main->first. ' '. $cust_main->get('last');
 353
 354     for (@cust_main_editable_fields) {
 355       $return{$_} = $cust_main->get($_);
 356     }
 357
 358     if ( $cust_main->payby =~ /^(CARD|DCRD)$/ ) {
 359       $return{payinfo} = $cust_main->paymask;
 360       @return{'month', 'year'} = $cust_main->paydate_monthyear;
 361     }
 362
 363     $return{'invoicing_list'} =
 364       join(', ', grep { $_ !~ /^(POST|FAX)$/ } $cust_main->invoicing_list );
 365     $return{'postal_invoicing'} =
 366       0 < ( grep { $_ eq 'POST' } $cust_main->invoicing_list );
 367
 368     if (scalar($conf->config('support_packages'))) {
 369       my @support_services = ();
 370       foreach ($cust_main->support_services) {
 371         my $seconds = $_->svc_x->seconds;
 372         my $time_remaining = (($seconds < 0) ? '-' : '' ).
 373                              int(abs($seconds)/3600)."h".
 374                              sprintf("%02d",(abs($seconds)%3600)/60)."m";
 375         my $cust_pkg = $_->cust_pkg;
 376         my $pkgnum = '';
 377         my $pkg = '';
 378         $pkgnum = $cust_pkg->pkgnum if $cust_pkg;
 379         $pkg = $cust_pkg->part_pkg->pkg if $cust_pkg;
 380         push @support_services, { svcnum => $_->svcnum,
 381                                   time => $time_remaining,
 382                                   pkgnum => $pkgnum,
 383                                   pkg => $pkg,
 384                                 };
 385       }
 386       $return{support_services} = \@support_services;
 387     }
 388
 389     if ( $conf->config('prepayment_discounts-credit_type') ) {
 390       #need to eval?
 391       $return{discount_terms_hash} = { $cust_main->discount_terms_hash };
 392     }
 393
 394   } elsif ( $session->{'svcnum'} ) { #no customer record
 395
 396     my $svc_acct = qsearchs('svc_acct', { 'svcnum' => $session->{'svcnum'} } )
 397       or die "unknown svcnum";
 398     $return{name} = $svc_acct->email;
 399
 400   } else {
 401
 402     return { 'error' => 'Expired session' }; #XXX redirect to login w/this err!
 403
 404   }
 405
 406   return { 'error'          => '',
 407            'custnum'        => $custnum,
 408            %return,
 409          };
 410
 411 }
 412
 413 sub edit_info {
 414   my $p = shift;
 415   my $session = _cache->get($p->{'session_id'})
 416     or return { 'error' => "Can't resume session" }; #better error message
 417
 418   my $custnum = $session->{'custnum'}
 419     or return { 'error' => "no customer record" };
 420
 421   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 422     or return { 'error' => "unknown custnum $custnum" };
 423
 424   my $new = new FS::cust_main { $cust_main->hash };
 425   $new->set( $_ => $p->{$_} )
 426     foreach grep { exists $p->{$_} } @cust_main_editable_fields;
 427
 428   my $payby = '';
 429   if (exists($p->{'payby'})) {
 430     $p->{'payby'} =~ /^([A-Z]{4})$/
 431       or return { 'error' => "illegal_payby " . $p->{'payby'} };
 432     $payby = $1;
 433   }
 434
 435   if ( $payby =~ /^(CARD|DCRD)$/ ) {
 436
 437     $new->paydate($p->{'year'}. '-'. $p->{'month'}. '-01');
 438
 439     if ( $new->payinfo eq $cust_main->paymask ) {
 440       $new->payinfo($cust_main->payinfo);
 441     } else {
 442       $new->payinfo($p->{'payinfo'});
 443     }
 444
 445     $new->set( 'payby' => $p->{'auto'} ? 'CARD' : 'DCRD' );
 446
 447   } elsif ( $payby =~ /^(CHEK|DCHK)$/ ) {
 448
 449     my $payinfo;
 450     $p->{'payinfo1'} =~ /^([\dx]+)$/
 451       or return { 'error' => "illegal account number ". $p->{'payinfo1'} };
 452     my $payinfo1 = $1;
 453      $p->{'payinfo2'} =~ /^([\dx]+)$/
 454       or return { 'error' => "illegal ABA/routing number ". $p->{'payinfo2'} };
 455     my $payinfo2 = $1;
 456     $payinfo = $payinfo1. '@'. $payinfo2;
 457
 458     $new->payinfo( ($payinfo eq $cust_main->paymask)
 459                      ? $cust_main->payinfo
 460                      : $payinfo
 461                  );
 462
 463     $new->set( 'payby' => $p->{'auto'} ? 'CHEK' : 'DCHK' );
 464
 465   } elsif ( $payby =~ /^(BILL)$/ ) {
 466     #no-op
 467   } elsif ( $payby ) {  #notyet ready
 468     return { 'error' => "unknown payby $payby" };
 469   }
 470
 471   my @invoicing_list;
 472   if ( exists $p->{'invoicing_list'} || exists $p->{'postal_invoicing'} ) {
 473     #false laziness with httemplate/edit/process/cust_main.cgi
 474     @invoicing_list = split( /\s*\,\s*/, $p->{'invoicing_list'} );
 475     push @invoicing_list, 'POST' if $p->{'postal_invoicing'};
 476   } else {
 477     @invoicing_list = $cust_main->invoicing_list;
 478   }
 479
 480   my $error = $new->replace($cust_main, \@invoicing_list);
 481   return { 'error' => $error } if $error;
 482   #$cust_main = $new;
 483
 484   return { 'error' => '' };
 485 }
 486
 487 sub payment_info {
 488   my $p = shift;
 489   my $session = _cache->get($p->{'session_id'})
 490     or return { 'error' => "Can't resume session" }; #better error message
 491
 492   ##
 493   #generic
 494   ##
 495
 496   my $conf = new FS::Conf;
 497   use vars qw($payment_info); #cache for performance
 498   unless ( $payment_info ) {
 499
 500     my %states = map { $_->state => 1 }
 501                    qsearch('cust_main_county', {
 502                      'country' => $conf->config('countrydefault') || 'US'
 503                    } );
 504
 505     my %cust_paybys = map { $_ => 1 }
 506                       map { FS::payby->payby2payment($_) }
 507                           $conf->config('signup_server-payby');
 508
 509     my @cust_paybys = keys %cust_paybys;
 510
 511     $payment_info = {
 512
 513       #list all counties/states/countries
 514       'cust_main_county' =>
 515         [ map { $_->hashref } qsearch('cust_main_county', {}) ],
 516
 517       #shortcut for one-country folks
 518       'states' =>
 519         [ sort { $a cmp $b } keys %states ],
 520
 521       'card_types' => card_types(),
 522
 523       'paytypes' => [ @FS::cust_main::paytypes ],
 524
 525       'paybys' => [ $conf->config('signup_server-payby') ],
 526       'cust_paybys' => \@cust_paybys,
 527
 528       'stateid_label' => FS::Msgcat::_gettext('stateid'),
 529       'stateid_state_label' => FS::Msgcat::_gettext('stateid_state'),
 530
 531       'show_ss'  => $conf->exists('show_ss'),
 532       'show_stateid' => $conf->exists('show_stateid'),
 533       'show_paystate' => $conf->exists('show_bankstate'),
 534
 535       'save_unchecked' => $conf->exists('selfservice-save_unchecked'),
 536
 537       'credit_card_surcharge_percentage' => $conf->config('credit-card-surcharge-percentage'),
 538     };
 539
 540   }
 541
 542   ##
 543   #customer-specific
 544   ##
 545
 546   my %return = %$payment_info;
 547
 548   my $custnum = $session->{'custnum'};
 549
 550   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 551     or return { 'error' => "unknown custnum $custnum" };
 552
 553   $return{'hide_payment_fields'} = [
 554     map {
 555       my $pg = payment_gateway($cust_main, $_);
 556       $pg && $pg->gateway_namespace eq 'Business::OnlineThirdPartyPayment';
 557     } @{ $return{cust_paybys} }
 558   ];
 559
 560   $return{balance} = $cust_main->balance; #XXX pkg-balances?
 561
 562   $return{payname} = $cust_main->payname
 563                      || ( $cust_main->first. ' '. $cust_main->get('last') );
 564
 565   $return{$_} = $cust_main->get($_) for qw(address1 address2 city state zip);
 566
 567   $return{payby} = $cust_main->payby;
 568   $return{stateid_state} = $cust_main->stateid_state;
 569
 570   if ( $cust_main->payby =~ /^(CARD|DCRD)$/ ) {
 571     $return{card_type} = cardtype($cust_main->payinfo);
 572     $return{payinfo} = $cust_main->paymask;
 573
 574     @return{'month', 'year'} = $cust_main->paydate_monthyear;
 575
 576   }
 577
 578   if ( $cust_main->payby =~ /^(CHEK|DCHK)$/ ) {
 579     my ($payinfo1, $payinfo2) = split '@', $cust_main->paymask;
 580     $return{payinfo1} = $payinfo1;
 581     $return{payinfo2} = $payinfo2;
 582     $return{paytype}  = $cust_main->paytype;
 583     $return{paystate} = $cust_main->paystate;
 584
 585   }
 586
 587   if ( $conf->config('prepayment_discounts-credit_type') ) {
 588     #need to eval?
 589     $return{discount_terms_hash} = { $cust_main->discount_terms_hash };
 590   }
 591
 592   #doubleclick protection
 593   my $_date = time;
 594   $return{paybatch} = "webui-MyAccount-$_date-$$-". rand() * 2**32;
 595
 596   return { 'error' => '',
 597            %return,
 598          };
 599
 600 };
 601
 602 #some false laziness with httemplate/process/payment.cgi - look there for
 603 #ACH and CVV support stuff
 604 sub process_payment {
 605
 606   my $p = shift;
 607
 608   my $session = _cache->get($p->{'session_id'})
 609     or return { 'error' => "Can't resume session" }; #better error message
 610
 611   my %return;
 612
 613   my $custnum = $session->{'custnum'};
 614
 615   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 616     or return { 'error' => "unknown custnum $custnum" };
 617
 618   $p->{'amount'} =~ /^\s*(\d+(\.\d{2})?)\s*$/
 619     or return { 'error' => gettext('illegal_amount') };
 620   my $amount = $1;
 621   return { error => 'Amount must be greater than 0' } unless $amount > 0;
 622
 623   $p->{'discount_term'} =~ /^\s*(\d*)\s*$/
 624     or return { 'error' => gettext('illegal_discount_term'). ': '. $p->{'discount_term'} };
 625   my $discount_term = $1;
 626
 627   $p->{'payname'} =~ /^([\w \,\.\-\']+)$/
 628     or return { 'error' => gettext('illegal_name'). " payname: ". $p->{'payname'} };
 629   my $payname = $1;
 630
 631   $p->{'paybatch'} =~ /^([\w \!\@\#\$\%\&\(\)\-\+\;\:\'\"\,\.\?\/\=]*)$/
 632     or return { 'error' => gettext('illegal_text'). " paybatch: ". $p->{'paybatch'} };
 633   my $paybatch = $1;
 634
 635   $p->{'payby'} ||= 'CARD';
 636   $p->{'payby'} =~ /^([A-Z]{4})$/
 637     or return { 'error' => "illegal_payby " . $p->{'payby'} };
 638   my $payby = $1;
 639
 640   #false laziness w/process/payment.cgi
 641   my $payinfo;
 642   my $paycvv = '';
 643   my $paynum = '';
 644   if ( $payby eq 'CHEK' || $payby eq 'DCHK' ) {
 645
 646     $p->{'payinfo1'} =~ /^([\dx]+)$/
 647       or return { 'error' => "illegal account number ". $p->{'payinfo1'} };
 648     my $payinfo1 = $1;
 649      $p->{'payinfo2'} =~ /^([\dx]+)$/
 650       or return { 'error' => "illegal ABA/routing number ". $p->{'payinfo2'} };
 651     my $payinfo2 = $1;
 652     $payinfo = $payinfo1. '@'. $payinfo2;
 653
 654     $payinfo = $cust_main->payinfo
 655       if $cust_main->paymask eq $payinfo;
 656
 657   } elsif ( $payby eq 'CARD' || $payby eq 'DCRD' ) {
 658
 659     $payinfo = $p->{'payinfo'};
 660
 661     #more intelligent mathing will be needed here if you change
 662     #card_masking_method and don't remove existing paymasks
 663     $payinfo = $cust_main->payinfo
 664       if $cust_main->paymask eq $payinfo;
 665
 666     $payinfo =~ s/\D//g;
 667     $payinfo =~ /^(\d{13,16})$/
 668       or return { 'error' => gettext('invalid_card') }; # . ": ". $self->payinfo
 669     $payinfo = $1;
 670
 671     validate($payinfo)
 672       or return { 'error' => gettext('invalid_card') }; # . ": ". $self->payinfo
 673     return { 'error' => gettext('unknown_card_type') }
 674       if $payinfo !~ /^99\d{14}$/ && cardtype($payinfo) eq "Unknown";
 675
 676     if ( length($p->{'paycvv'}) && $p->{'paycvv'} !~ /^\s*$/ ) {
 677       if ( cardtype($payinfo) eq 'American Express card' ) {
 678         $p->{'paycvv'} =~ /^\s*(\d{4})\s*$/
 679           or return { 'error' => "CVV2 (CID) for American Express cards is four digits." };
 680         $paycvv = $1;
 681       } else {
 682         $p->{'paycvv'} =~ /^\s*(\d{3})\s*$/
 683           or return { 'error' => "CVV2 (CVC2/CID) is three digits." };
 684         $paycvv = $1;
 685       }
 686     }
 687
 688   } else {
 689     die "unknown payby $payby";
 690   }
 691
 692   my %payby2fields = (
 693     'CARD' => [ qw( paystart_month paystart_year payissue payip
 694                     address1 address2 city state zip country    ) ],
 695     'CHEK' => [ qw( ss paytype paystate stateid stateid_state payip ) ],
 696   );
 697
 698   my $error = $cust_main->realtime_bop( $FS::payby::payby2bop{$payby}, $amount,
 699     'quiet'    => 1,
 700     'payinfo'  => $payinfo,
 701     'paydate'  => $p->{'year'}. '-'. $p->{'month'}. '-01',
 702     'payname'  => $payname,
 703     'paybatch' => $paybatch, #this doesn't actually do anything
 704     'paycvv'   => $paycvv,
 705     'paynum_ref' => \$paynum,
 706     'pkgnum'   => $session->{'pkgnum'},
 707     'discount_term' => $discount_term,
 708     'selfservice' => 1,
 709     map { $_ => $p->{$_} } @{ $payby2fields{$payby} }
 710   );
 711   return { 'error' => $error } if $error;
 712
 713   $cust_main->apply_payments;
 714
 715   if ( $p->{'save'} ) {
 716     my $new = new FS::cust_main { $cust_main->hash };
 717     if ($payby eq 'CARD' || $payby eq 'DCRD') {
 718       $new->set( $_ => $p->{$_} )
 719         foreach qw( payname paystart_month paystart_year payissue payip
 720                     address1 address2 city state zip country );
 721       $new->set( 'payby' => $p->{'auto'} ? 'CARD' : 'DCRD' );
 722     } elsif ($payby eq 'CHEK' || $payby eq 'DCHK') {
 723       $new->set( $_ => $p->{$_} )
 724         foreach qw( payname payip paytype paystate
 725                     stateid stateid_state );
 726       $new->set( 'payby' => $p->{'auto'} ? 'CHEK' : 'DCHK' );
 727     }
 728     $new->set( 'payinfo' => $cust_main->card_token || $payinfo );
 729     $new->set( 'paydate' => $p->{'year'}. '-'. $p->{'month'}. '-01' );
 730     my $error = $new->replace($cust_main);
 731     if ( $error ) {
 732       #no, this causes customers to process their payments again
 733       #return { 'error' => $error };
 734       #XXX just warn verosely for now so i can figure out how these happen in
 735       # the first place, eventually should redirect them to the "change
 736       #address" page but indicate the payment did process??
 737       delete($p->{'payinfo'}); #don't want to log this!
 738       warn "WARNING: error changing customer info when processing payment (not returning to customer as a processing error): $error\n".
 739            "NEW: ". Dumper($new)."\n".
 740            "OLD: ". Dumper($cust_main)."\n".
 741            "PACKET: ". Dumper($p)."\n";
 742     #} else {
 743       #not needed...
 744       #$cust_main = $new;
 745     }
 746   }
 747
 748   my $receipt_html = '';
 749   if($paynum) {
 750       # currently supported for realtime CC only; send receipt data to SS
 751       my $cust_pay = qsearchs('cust_pay', { 'paynum' => $paynum } );
 752       if($cust_pay) {
 753         $receipt_html = qq!
 754 <TABLE BGCOLOR="#cccccc" BORDER=0 CELLSPACING=2>
 755
 756 <TR>
 757   <TD ALIGN="right">Payment#</TD>
 758   <TD BGCOLOR="#FFFFFF"><B>! . $cust_pay->paynum . qq!</B></TD>
 759 </TR>
 760
 761 <TR>
 762   <TD ALIGN="right">Date</TD>
 763
 764   <TD BGCOLOR="#FFFFFF"><B>! .
 765         time2str("%a&nbsp;%b&nbsp;%o,&nbsp;%Y&nbsp;%r", $cust_pay->_date)
 766                                                             . qq!</B></TD>
 767 </TR>
 768
 769
 770 <TR>
 771   <TD ALIGN="right">Amount</TD>
 772   <TD BGCOLOR="#FFFFFF"><B>! . $cust_pay->paid . qq!</B></TD>
 773
 774 </TR>
 775
 776 <TR>
 777   <TD ALIGN="right">Payment method</TD>
 778   <TD BGCOLOR="#FFFFFF"><B>! . $cust_pay->payby_name .' #'. $cust_pay->paymask
 779                                                                 . qq!</B></TD>
 780 </TR>
 781
 782 </TABLE>
 783 !;
 784       }
 785   }
 786
 787   return { 'error' => '', 'receipt_html' => $receipt_html, };
 788
 789 }
 790
 791 sub realtime_collect {
 792   my $p = shift;
 793
 794   my $session = _cache->get($p->{'session_id'})
 795     or return { 'error' => "Can't resume session" }; #better error message
 796
 797   my $custnum = $session->{'custnum'};
 798
 799   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 800     or return { 'error' => "unknown custnum $custnum" };
 801
 802   my $amount;
 803   if ( $p->{'amount'} ) {
 804     $amount = $p->{'amount'};
 805   }
 806   elsif ( $session->{'pkgnum'} ) {
 807     $amount = $cust_main->balance_pkgnum( $session->{'pkgnum'} );
 808   }
 809   else {
 810     $amount = $cust_main->balance;
 811   }
 812
 813   my $error = $cust_main->realtime_collect(
 814     'method'     => $p->{'method'},
 815     'amount'     => $amount,
 816     'pkgnum'     => $session->{'pkgnum'},
 817     'session_id' => $p->{'session_id'},
 818     'apply'      => 1,
 819     'selfservice'=> 1,
 820   );
 821   return { 'error' => $error } unless ref( $error );
 822
 823   return { 'error' => '', amount => $amount, %$error };
 824 }
 825
 826 sub process_payment_order_pkg {
 827   my $p = shift;
 828
 829   my $hr = process_payment($p);
 830   return $hr if $hr->{'error'};
 831
 832   order_pkg($p);
 833 }
 834
 835 sub process_payment_order_renew {
 836   my $p = shift;
 837
 838   my $hr = process_payment($p);
 839   return $hr if $hr->{'error'};
 840
 841   order_renew($p);
 842 }
 843
 844 sub process_prepay {
 845
 846   my $p = shift;
 847
 848   my $session = _cache->get($p->{'session_id'})
 849     or return { 'error' => "Can't resume session" }; #better error message
 850
 851   my %return;
 852
 853   my $custnum = $session->{'custnum'};
 854
 855   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 856     or return { 'error' => "unknown custnum $custnum" };
 857
 858   my( $amount, $seconds, $upbytes, $downbytes, $totalbytes ) = ( 0, 0, 0, 0, 0 );
 859   my $error = $cust_main->recharge_prepay( $p->{'prepaid_cardnum'},
 860                                            \$amount,
 861                                            \$seconds,
 862                                            \$upbytes,
 863                                            \$downbytes,
 864                                            \$totalbytes,
 865                                          );
 866
 867   return { 'error' => $error } if $error;
 868
 869   return { 'error'     => '',
 870            'amount'    => $amount,
 871            'seconds'   => $seconds,
 872            'duration'  => duration_exact($seconds),
 873            'upbytes'   => $upbytes,
 874            'upload'    => FS::UI::bytecount::bytecount_unexact($upbytes),
 875            'downbytes' => $downbytes,
 876            'download'  => FS::UI::bytecount::bytecount_unexact($downbytes),
 877            'totalbytes'=> $totalbytes,
 878            'totalload' => FS::UI::bytecount::bytecount_unexact($totalbytes),
 879          };
 880
 881 }
 882
 883 sub invoice {
 884   my $p = shift;
 885   my $session = _cache->get($p->{'session_id'})
 886     or return { 'error' => "Can't resume session" }; #better error message
 887
 888   my $custnum = $session->{'custnum'};
 889
 890   my $invnum = $p->{'invnum'};
 891
 892   my $cust_bill = qsearchs('cust_bill', { 'invnum'  => $invnum,
 893                                           'custnum' => $custnum } )
 894     or return { 'error' => "Can't find invnum" };
 895
 896   #my %return;
 897
 898   return { 'error'        => '',
 899            'invnum'       => $invnum,
 900            'invoice_text' => join('', $cust_bill->print_text ),
 901            'invoice_html' => $cust_bill->print_html( { unsquelch_cdr => 1 } ),
 902          };
 903
 904 }
 905
 906 sub invoice_logo {
 907   my $p = shift;
 908
 909   #sessioning for this?  how do we get the session id to the backend invoice
 910   # template so it can add it to the link, blah
 911
 912   my $agentnum = '';
 913   if ( $p->{'invnum'} ) {
 914     my $cust_bill = qsearchs('cust_bill', { 'invnum' => $p->{'invnum'} } )
 915       or return { 'error' => 'unknown invnum' };
 916     $agentnum = $cust_bill->cust_main->agentnum;
 917   }
 918
 919   my $templatename = $p->{'template'} || $p->{'templatename'};
 920
 921   #false laziness-ish w/view/cust_bill-logo.cgi
 922
 923   my $conf = new FS::Conf;
 924   if ( $templatename =~ /^([^\.\/]*)$/ && $conf->exists("logo_$1.png") ) {
 925     $templatename = "_$1";
 926   } else {
 927     $templatename = '';
 928   }
 929
 930   my $filename = "logo$templatename.png";
 931
 932   return { 'error'        => '',
 933            'logo'         => $conf->config_binary($filename, $agentnum),
 934            'content_type' => 'image/png', #should allow gif, jpg too
 935          };
 936 }
 937
 938
 939 sub list_invoices {
 940   my $p = shift;
 941   my $session = _cache->get($p->{'session_id'})
 942     or return { 'error' => "Can't resume session" }; #better error message
 943
 944   my $custnum = $session->{'custnum'};
 945
 946   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 947     or return { 'error' => "unknown custnum $custnum" };
 948
 949   my @cust_bill = $cust_main->cust_bill;
 950
 951   return  { 'error'       => '',
 952             'invoices'    =>  [ map { { 'invnum' => $_->invnum,
 953                                         '_date'  => $_->_date,
 954                                         'date'   => time2str("%b %o, %Y", $_->_date),
 955                                       }
 956                                     } @cust_bill
 957                               ]
 958           };
 959 }
 960
 961 sub cancel {
 962   my $p = shift;
 963   my $session = _cache->get($p->{'session_id'})
 964     or return { 'error' => "Can't resume session" }; #better error message
 965
 966   my $custnum = $session->{'custnum'};
 967
 968   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 969     or return { 'error' => "unknown custnum $custnum" };
 970
 971   my @errors = $cust_main->cancel( 'quiet'=>1 );
 972
 973   my $error = scalar(@errors) ? join(' / ', @errors) : '';
 974
 975   return { 'error' => $error };
 976
 977 }
 978
 979 sub list_pkgs {
 980   my $p = shift;
 981
 982   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 983   return { 'error' => $session } if $context eq 'error';
 984
 985   my $search = { 'custnum' => $custnum };
 986   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
 987   my $cust_main = qsearchs('cust_main', $search )
 988     or return { 'error' => "unknown custnum $custnum" };
 989
 990   my $conf = new FS::Conf;
 991
 992 # the duplication below is necessary:
 993 # 1. to maintain the current buggy behaviour wrt the cust_pkg and part_pkg
 994 # hashes overwriting each other (setup and no_auto fields). Fixing that is a
 995 # non-backwards-compatible change breaking the software of anyone using the API
 996 # instead of the stock selfservice
 997 # 2. to return cancelled packages as well - for wholesale and non-wholesale
 998   if( $conf->exists('selfservice_server-view-wholesale') ) {
 999     return { 'svcnum'   => $session->{'svcnum'},
1000             'custnum'  => $custnum,
1001             'cust_pkg' => [ map {
1002                           { $_->hash,
1003                             part_pkg => [ map $_->hashref, $_->part_pkg ],
1004                             part_svc =>
1005                               [ map $_->hashref, $_->available_part_svc ],
1006                             cust_svc =>
1007                               [ map { my $ref = { $_->hash,
1008                                                   label => [ $_->label ],
1009                                                 };
1010                                       $ref->{_password} = $_->svc_x->_password
1011                                         if $context eq 'agent'
1012                                         && $conf->exists('agent-showpasswords')
1013                                         && $_->part_svc->svcdb eq 'svc_acct';
1014                                       $ref;
1015                                     } $_->cust_svc
1016                               ],
1017                           };
1018                         } $cust_main->cust_pkg
1019                   ],
1020     'small_custview' =>
1021       small_custview( $cust_main, $conf->config('countrydefault') ),
1022     'wholesale_view' => 1,
1023     'login_svcpart' => [ $conf->config('selfservice_server-login_svcpart') ],
1024     'date_format' => $conf->config('date_format') || '%m/%d/%Y',
1025     'lnp' => $conf->exists('svc_phone-lnp'),
1026       };
1027   }
1028
1029   { 'svcnum'   => $session->{'svcnum'},
1030     'custnum'  => $custnum,
1031     'cust_pkg' => [ map {
1032                           { $_->hash,
1033                             $_->part_pkg->hash,
1034                             part_svc =>
1035                               [ map $_->hashref, $_->available_part_svc ],
1036                             cust_svc =>
1037                               [ map { my $ref = { $_->hash,
1038                                                   label => [ $_->label ],
1039                                                 };
1040                                       $ref->{_password} = $_->svc_x->_password
1041                                         if $context eq 'agent'
1042                                         && $conf->exists('agent-showpasswords')
1043                                         && $_->part_svc->svcdb eq 'svc_acct';
1044                                       $ref;
1045                                     } $_->cust_svc
1046                               ],
1047                           };
1048                         } $cust_main->ncancelled_pkgs
1049                   ],
1050     'small_custview' =>
1051       small_custview( $cust_main, $conf->config('countrydefault') ),
1052   };
1053
1054 }
1055
1056 sub list_svcs {
1057   my $p = shift;
1058
1059   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1060   return { 'error' => $session } if $context eq 'error';
1061
1062   my $search = { 'custnum' => $custnum };
1063   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1064   my $cust_main = qsearchs('cust_main', $search )
1065     or return { 'error' => "unknown custnum $custnum" };
1066
1067   my @cust_svc = ();
1068   #foreach my $cust_pkg ( $cust_main->ncancelled_pkgs ) {
1069   foreach my $cust_pkg ( $p->{'ncancelled'}
1070                          ? $cust_main->ncancelled_pkgs
1071                          : $cust_main->unsuspended_pkgs ) {
1072     next if $session->{'pkgnum'} && $cust_pkg->pkgnum != $session->{'pkgnum'};
1073     push @cust_svc, @{[ $cust_pkg->cust_svc ]}; #@{[ ]} to force array context
1074   }
1075   if ( $p->{'svcdb'} ) {
1076     my $svcdb = ref($p->{'svcdb'}) eq 'HASH'
1077                   ? $p->{'svcdb'}
1078                   : ref($p->{'svcdb'}) eq 'ARRAY'
1079                     ? { map { $_=>1 } @{ $p->{'svcdb'} } }
1080                     : { $p->{'svcdb'} => 1 };
1081     @cust_svc = grep $svcdb->{ $_->part_svc->svcdb }, @cust_svc
1082   }
1083
1084   #@svc_x = sort { $a->domain cmp $b->domain || $a->username cmp $b->username }
1085   #              @svc_x;
1086
1087   {
1088     'svcnum'   => $session->{'svcnum'},
1089     'custnum'  => $custnum,
1090     'svcs'     => [
1091       map {
1092             my $svc_x = $_->svc_x;
1093             my($label, $value) = $_->label;
1094             my $svcdb = $_->part_svc->svcdb;
1095             my $part_pkg = $_->cust_pkg->part_pkg;
1096
1097             my %hash = (
1098               'svcnum' => $_->svcnum,
1099               'svcdb'  => $svcdb,
1100               'label'  => $label,
1101               'value'  => $value,
1102             );
1103
1104             if ( $svcdb eq 'svc_acct' ) {
1105               %hash = (
1106                 %hash,
1107                 'username'   => $svc_x->username,
1108                 'email'      => $svc_x->email,
1109                 'seconds'    => $svc_x->seconds,
1110                 'upbytes'    => display_bytecount($svc_x->upbytes),
1111                 'downbytes'  => display_bytecount($svc_x->downbytes),
1112                 'totalbytes' => display_bytecount($svc_x->totalbytes),
1113
1114                 'recharge_amount'  => $part_pkg->option('recharge_amount',1),
1115                 'recharge_seconds' => $part_pkg->option('recharge_seconds',1),
1116                 'recharge_upbytes'    =>
1117                   display_bytecount($part_pkg->option('recharge_upbytes',1)),
1118                 'recharge_downbytes'  =>
1119                   display_bytecount($part_pkg->option('recharge_downbytes',1)),
1120                 'recharge_totalbytes' =>
1121                   display_bytecount($part_pkg->option('recharge_totalbytes',1)),
1122                 # more...
1123               );
1124
1125             } elsif ( $svcdb eq 'svc_phone' ) {
1126               %hash = (
1127                 %hash,
1128               );
1129             }
1130
1131             \%hash;
1132           }
1133           @cust_svc
1134     ],
1135   };
1136
1137 }
1138
1139 sub _list_svc_usage {
1140   my($svc_acct, $begin, $end) = @_;
1141   my @usage = ();
1142   foreach my $part_export (
1143     map { qsearch ( 'part_export', { 'exporttype' => $_ } ) }
1144     qw( sqlradius sqlradius_withdomain )
1145   ) {
1146     push @usage, @ { $part_export->usage_sessions($begin, $end, $svc_acct) };
1147   }
1148   (@usage);
1149 }
1150
1151 sub list_svc_usage {
1152   _usage_details(\&_list_svc_usage, @_);
1153 }
1154
1155 sub _list_support_usage {
1156   my($svc_acct, $begin, $end) = @_;
1157   my @usage = ();
1158   foreach ( grep { $begin <= $_->_date && $_->_date <= $end }
1159             qsearch('acct_rt_transaction', { 'svcnum' => $svc_acct->svcnum })
1160           ) {
1161     push @usage, { 'seconds'  => $_->seconds,
1162                    'support'  => $_->support,
1163                    '_date'    => $_->_date,
1164                    'id'       => $_->transaction_id,
1165                    'creator'  => $_->creator,
1166                    'subject'  => $_->subject,
1167                    'status'   => $_->status,
1168                    'ticketid' => $_->ticketid,
1169                  };
1170   }
1171   (@usage);
1172 }
1173
1174 sub list_support_usage {
1175   _usage_details(\&_list_support_usage, @_);
1176 }
1177
1178 sub _list_cdr_usage {
1179   my($svc_phone, $begin, $end) = @_;
1180   map [ $_->downstream_csv('format' => 'default') ], #XXX config for format
1181       $svc_phone->get_cdrs( 'begin'=>$begin, 'end'=>$end, );
1182 }
1183
1184 sub list_cdr_usage {
1185   my $p = shift;
1186   _usage_details( \&_list_cdr_usage, $p,
1187                   'svcdb' => 'svc_phone',
1188                 );
1189 }
1190
1191 sub _usage_details {
1192   my($callback, $p, %opt) = @_;
1193
1194   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1195   return { 'error' => $session } if $context eq 'error';
1196
1197   my $search = { 'svcnum' => $p->{'svcnum'} };
1198   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1199
1200   my $svcdb = $opt{'svcdb'} || 'svc_acct';
1201
1202   my $svc_x = qsearchs( $svcdb, $search );
1203   return { 'error' => 'No service selected in list_svc_usage' }
1204     unless $svc_x;
1205
1206   my $header = $svcdb eq 'svc_phone'
1207                  ? [ split(',', FS::cdr::invoice_header('default') ) ]  #XXX
1208                  : [];
1209
1210   my $cust_pkg = $svc_x->cust_svc->cust_pkg;
1211   my $freq     = $cust_pkg->part_pkg->freq;
1212   my $start    = $cust_pkg->setup;
1213   #my $end      = $cust_pkg->bill; # or time?
1214   my $end      = time;
1215
1216   unless ( $p->{beginning} ) {
1217     $p->{beginning} = $cust_pkg->last_bill;
1218     $p->{ending}    = $end;
1219   }
1220
1221   my (@usage) = &$callback($svc_x, $p->{beginning}, $p->{ending});
1222
1223   #kinda false laziness with FS::cust_main::bill, but perhaps
1224   #we should really change this bit to DateTime and DateTime::Duration
1225   #
1226   #change this bit to use Date::Manip? CAREFUL with timezones (see
1227   # mailing list archive)
1228   my ($nsec,$nmin,$nhour,$nmday,$nmon,$nyear) =
1229     (localtime($p->{ending}) )[0,1,2,3,4,5];
1230   my ($psec,$pmin,$phour,$pmday,$pmon,$pyear) =
1231     (localtime($p->{beginning}) )[0,1,2,3,4,5];
1232
1233   if ( $freq =~ /^\d+$/ ) {
1234     $nmon += $freq;
1235     until ( $nmon < 12 ) { $nmon -= 12; $nyear++; }
1236     $pmon -= $freq;
1237     until ( $pmon >= 0 ) { $pmon += 12; $pyear--; }
1238   } elsif ( $freq =~ /^(\d+)w$/ ) {
1239     my $weeks = $1;
1240     $nmday += $weeks * 7;
1241     $pmday -= $weeks * 7;
1242   } elsif ( $freq =~ /^(\d+)d$/ ) {
1243     my $days = $1;
1244     $nmday += $days;
1245     $pmday -= $days;
1246   } elsif ( $freq =~ /^(\d+)h$/ ) {
1247     my $hours = $1;
1248     $nhour += $hours;
1249     $phour -= $hours;
1250   } else {
1251     return { 'error' => "unparsable frequency: ". $freq };
1252   }
1253
1254   my $previous  = timelocal_nocheck($psec,$pmin,$phour,$pmday,$pmon,$pyear);
1255   my $next      = timelocal_nocheck($nsec,$nmin,$nhour,$nmday,$nmon,$nyear);
1256
1257   {
1258     'error'     => '',
1259     'svcnum'    => $p->{svcnum},
1260     'beginning' => $p->{beginning},
1261     'ending'    => $p->{ending},
1262     'previous'  => ($previous > $start) ? $previous : $start,
1263     'next'      => ($next < $end) ? $next : $end,
1264     'header'    => $header,
1265     'usage'     => \@usage,
1266   };
1267 }
1268
1269 sub order_pkg {
1270   my $p = shift;
1271
1272   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1273   return { 'error' => $session } if $context eq 'error';
1274
1275   my $search = { 'custnum' => $custnum };
1276   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1277   my $cust_main = qsearchs('cust_main', $search )
1278     or return { 'error' => "unknown custnum $custnum" };
1279
1280   my $status = $cust_main->status;
1281   #false laziness w/ClientAPI/Signup.pm
1282
1283   my $cust_pkg = new FS::cust_pkg ( {
1284     'custnum' => $custnum,
1285     'pkgpart' => $p->{'pkgpart'},
1286   } );
1287   my $error = $cust_pkg->check;
1288   return { 'error' => $error } if $error;
1289
1290   my @svc = ();
1291   unless ( $p->{'svcpart'} eq 'none' ) {
1292
1293     my $svcdb;
1294     my $svcpart = '';
1295     if ( $p->{'svcpart'} =~ /^(\d+)$/ ) {
1296       $svcpart = $1;
1297       my $part_svc = qsearchs('part_svc', { 'svcpart' => $svcpart } );
1298       return { 'error' => "Unknown svcpart $svcpart" } unless $part_svc;
1299       $svcdb = $part_svc->svcdb;
1300     } else {
1301       $svcdb = 'svc_acct';
1302     }
1303     $svcpart ||= $cust_pkg->part_pkg->svcpart($svcdb);
1304
1305     my %fields = (
1306       'svc_acct'     => [ qw( username domsvc _password sec_phrase popnum ) ],
1307       'svc_domain'   => [ qw( domain ) ],
1308       'svc_phone'    => [ qw( phonenum pin sip_password phone_name ) ],
1309       'svc_external' => [ qw( id title ) ],
1310       'svc_pbx'      => [ qw( id name ) ],
1311     );
1312
1313     my $svc_x = "FS::$svcdb"->new( {
1314       'svcpart'   => $svcpart,
1315       map { $_ => $p->{$_} } @{$fields{$svcdb}}
1316     } );
1317
1318     if ( $svcdb eq 'svc_acct' && exists($p->{"snarf_machine1"}) ) {
1319       my @acct_snarf;
1320       my $snarfnum = 1;
1321       while ( length($p->{"snarf_machine$snarfnum"}) ) {
1322         my $acct_snarf = new FS::acct_snarf ( {
1323           'machine'   => $p->{"snarf_machine$snarfnum"},
1324           'protocol'  => $p->{"snarf_protocol$snarfnum"},
1325           'username'  => $p->{"snarf_username$snarfnum"},
1326           '_password' => $p->{"snarf_password$snarfnum"},
1327         } );
1328         $snarfnum++;
1329         push @acct_snarf, $acct_snarf;
1330       }
1331       $svc_x->child_objects( \@acct_snarf );
1332     }
1333
1334     my $y = $svc_x->setdefault; # arguably should be in new method
1335     return { 'error' => $y } if $y && !ref($y);
1336
1337     $error = $svc_x->check;
1338     return { 'error' => $error } if $error;
1339
1340     push @svc, $svc_x;
1341
1342   }
1343
1344   use Tie::RefHash;
1345   tie my %hash, 'Tie::RefHash';
1346   %hash = ( $cust_pkg => \@svc );
1347   #msgcat
1348   $error = $cust_main->order_pkgs( \%hash, 'noexport' => 1 );
1349   return { 'error' => $error } if $error;
1350
1351   my $conf = new FS::Conf;
1352   if ( $conf->exists('signup_server-realtime') ) {
1353
1354     my $bill_error = _do_bop_realtime( $cust_main, $status );
1355
1356     if ($bill_error) {
1357       $cust_pkg->cancel('quiet'=>1);
1358       return $bill_error;
1359     } else {
1360       $cust_pkg->reexport;
1361     }
1362
1363   } else {
1364     $cust_pkg->reexport;
1365   }
1366
1367   my $svcnum = $svc[0] ? $svc[0]->svcnum : '';
1368
1369   return { error=>'', pkgnum=>$cust_pkg->pkgnum, svcnum=>$svcnum };
1370
1371 }
1372
1373 sub change_pkg {
1374   my $p = shift;
1375
1376   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1377   return { 'error' => $session } if $context eq 'error';
1378
1379   my $search = { 'custnum' => $custnum };
1380   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1381   my $cust_main = qsearchs('cust_main', $search )
1382     or return { 'error' => "unknown custnum $custnum" };
1383
1384   my $status = $cust_main->status;
1385   my $cust_pkg = qsearchs('cust_pkg', { 'pkgnum' => $p->{pkgnum} } )
1386     or return { 'error' => "unknown package $p->{pkgnum}" };
1387
1388   my @newpkg;
1389   my $error = FS::cust_pkg::order( $custnum,
1390                                    [$p->{pkgpart}],
1391                                    [$p->{pkgnum}],
1392                                    \@newpkg,
1393                                  );
1394
1395   my $conf = new FS::Conf;
1396   if ( $conf->exists('signup_server-realtime') ) {
1397
1398     my $bill_error = _do_bop_realtime( $cust_main, $status );
1399
1400     if ($bill_error) {
1401       $newpkg[0]->suspend;
1402       return $bill_error;
1403     } else {
1404       $newpkg[0]->reexport;
1405     }
1406
1407   } else {
1408     $newpkg[0]->reexport;
1409   }
1410
1411   return { error => '', pkgnum => $cust_pkg->pkgnum };
1412
1413 }
1414
1415 sub order_recharge {
1416   my $p = shift;
1417
1418   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1419   return { 'error' => $session } if $context eq 'error';
1420
1421   my $search = { 'custnum' => $custnum };
1422   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1423   my $cust_main = qsearchs('cust_main', $search )
1424     or return { 'error' => "unknown custnum $custnum" };
1425
1426   my $status = $cust_main->status;
1427   my $cust_svc = qsearchs( 'cust_svc', { 'svcnum' => $p->{'svcnum'} } )
1428     or return { 'error' => "unknown service " . $p->{'svcnum'} };
1429
1430   my $svc_x = $cust_svc->svc_x;
1431   my $part_pkg = $cust_svc->cust_pkg->part_pkg;
1432
1433   my %vhash =
1434     map { $_ =~ /^recharge_(.*)$/; $1, $part_pkg->option($_, 1) }
1435     qw ( recharge_seconds recharge_upbytes recharge_downbytes
1436          recharge_totalbytes );
1437   my $amount = $part_pkg->option('recharge_amount', 1);
1438
1439   my ($l, $v, $d) = $cust_svc->label;  # blah
1440   my $pkg = "Recharge $v";
1441
1442   my $bill_error = $cust_main->charge($amount, $pkg,
1443      "time: $vhash{seconds}, up: $vhash{upbytes}," .
1444      "down: $vhash{downbytes}, total: $vhash{totalbytes}",
1445      $part_pkg->taxclass); #meh
1446
1447   my $conf = new FS::Conf;
1448   if ( $conf->exists('signup_server-realtime') && !$bill_error ) {
1449
1450     $bill_error = _do_bop_realtime( $cust_main, $status );
1451
1452     if ($bill_error) {
1453       return $bill_error;
1454     } else {
1455       my $error = $svc_x->recharge (\%vhash);
1456       return { 'error' => $error } if $error;
1457     }
1458
1459   } else {
1460     my $error = $bill_error;
1461     $error ||= $svc_x->recharge (\%vhash);
1462     return { 'error' => $error } if $error;
1463   }
1464
1465   return { error => '', svc => $cust_svc->part_svc->svc };
1466
1467 }
1468
1469 sub _do_bop_realtime {
1470   my ($cust_main, $status) = (shift, shift);
1471
1472     my $old_balance = $cust_main->balance;
1473
1474     my $bill_error =    $cust_main->bill
1475                      || $cust_main->apply_payments_and_credits
1476                      || $cust_main->realtime_collect('selfservice' => 1);
1477
1478     if (    $cust_main->balance > $old_balance
1479          && $cust_main->balance > 0
1480          && ( $cust_main->payby !~ /^(BILL|DCRD|DCHK)$/ ?
1481               1 : $status eq 'suspended' ) ) {
1482       #this makes sense.  credit is "un-doing" the invoice
1483       my $conf = new FS::Conf;
1484       $cust_main->credit( sprintf("%.2f", $cust_main->balance - $old_balance ),
1485                           'self-service decline',
1486                           'reason_type' => $conf->config('signup_credit_type'),
1487                         );
1488       $cust_main->apply_credits( 'order' => 'newest' );
1489
1490       return { 'error' => '_decline', 'bill_error' => $bill_error };
1491     }
1492
1493     '';
1494 }
1495
1496 sub renew_info {
1497   my $p = shift;
1498
1499   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1500   return { 'error' => $session } if $context eq 'error';
1501
1502   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1503     or return { 'error' => "unknown custnum $custnum" };
1504
1505   my @cust_pkg = sort { $a->bill <=> $b->bill }
1506                  grep { $_->part_pkg->freq ne '0' }
1507                  $cust_main->ncancelled_pkgs;
1508
1509   #return { 'error' => 'No active packages to renew.' } unless @cust_pkg;
1510
1511   my $total = $cust_main->balance;
1512
1513   my @array = map {
1514                     my $bill = $_->bill;
1515                     $total += $_->part_pkg->base_recur($_, \$bill);
1516                     my $renew_date = $_->part_pkg->add_freq($_->bill);
1517                     {
1518                       'pkgnum'             => $_->pkgnum,
1519                       'amount'             => sprintf('%.2f', $total),
1520                       'bill_date'          => $_->bill,
1521                       'bill_date_pretty'   => time2str('%x', $_->bill),
1522                       'renew_date'         => $renew_date,
1523                       'renew_date_pretty'  => time2str('%x', $renew_date),
1524                       'expire_date'        => $_->expire,
1525                       'expire_date_pretty' => time2str('%x', $_->expire),
1526                     };
1527                   }
1528                   @cust_pkg;
1529
1530   return { 'dates' => \@array };
1531
1532 }
1533
1534 sub payment_info_renew_info {
1535   my $p = shift;
1536   my $renew_info   = renew_info($p);
1537   my $payment_info = payment_info($p);
1538   return { %$renew_info,
1539            %$payment_info,
1540          };
1541 }
1542
1543 sub order_renew {
1544   my $p = shift;
1545
1546   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1547   return { 'error' => $session } if $context eq 'error';
1548
1549   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1550     or return { 'error' => "unknown custnum $custnum" };
1551
1552   my $date = $p->{'date'};
1553
1554   my $now = time;
1555
1556   #freeside-daily -n -d $date fs_daily $custnum
1557   $cust_main->bill_and_collect( 'time'         => $date,
1558                                 'invoice_time' => $now,
1559                                 'actual_time'  => $now,
1560                                 'check_freq'   => '1d',
1561                               );
1562
1563   return { 'error' => '' };
1564
1565 }
1566
1567 sub suspend_pkg {
1568   my $p = shift;
1569   my $session = _cache->get($p->{'session_id'})
1570     or return { 'error' => "Can't resume session" }; #better error message
1571
1572   my $custnum = $session->{'custnum'};
1573
1574   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1575     or return { 'error' => "unknown custnum $custnum" };
1576
1577   my $conf = new FS::Conf;
1578   my $reasonnum =
1579     $conf->config('selfservice-self_suspend_reason', $cust_main->agentnum)
1580       or return { 'error' => 'Permission denied' };
1581
1582   my $pkgnum = $p->{'pkgnum'};
1583
1584   my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
1585                                         'pkgnum'  => $pkgnum,   } )
1586     or return { 'error' => "unknown pkgnum $pkgnum" };
1587
1588   my $error = $cust_pkg->suspend(reason => $reasonnum);
1589   return { 'error' => $error };
1590
1591 }
1592
1593 sub cancel_pkg {
1594   my $p = shift;
1595   my $session = _cache->get($p->{'session_id'})
1596     or return { 'error' => "Can't resume session" }; #better error message
1597
1598   my $custnum = $session->{'custnum'};
1599
1600   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1601     or return { 'error' => "unknown custnum $custnum" };
1602
1603   my $pkgnum = $p->{'pkgnum'};
1604
1605   my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
1606                                         'pkgnum'  => $pkgnum,   } )
1607     or return { 'error' => "unknown pkgnum $pkgnum" };
1608
1609   my $error = $cust_pkg->cancel('quiet' => 1);
1610   return { 'error' => $error };
1611
1612 }
1613
1614 sub provision_phone {
1615  my $p = shift;
1616  my @bulkdid;
1617  @bulkdid = @{$p->{'bulkdid'}} if $p->{'bulkdid'};
1618
1619 # single DID LNP
1620  unless($p->{'lnp'}) {
1621     $p->{'lnp_desired_due_date'} = parse_datetime($p->{'lnp_desired_due_date'});
1622     $p->{'lnp_status'} = "portingin";
1623     return _provision( 'FS::svc_phone',
1624                   [qw(lnp_desired_due_date lnp_other_provider
1625                     lnp_other_provider_account phonenum countrycode lnp_status)],
1626                   [qw(phonenum countrycode)],
1627                   $p,
1628                   @_
1629                 );
1630  }
1631
1632 # single DID order
1633  unless (scalar(@bulkdid)) {
1634     return _provision( 'FS::svc_phone',
1635                   [qw(phonenum countrycode)],
1636                   [qw(phonenum countrycode)],
1637                   $p,
1638                   @_
1639                 );
1640  }
1641
1642 # bulk DID order case
1643   my $error;
1644   foreach my $did ( @bulkdid ) {
1645     $did =~ s/[^0-9]//g;
1646     $error = _provision( 'FS::svc_phone',
1647               [qw(phonenum countrycode)],
1648               [qw(phonenum countrycode)],
1649               {
1650                 'pkgnum' => $p->{'pkgnum'},
1651                 'svcpart' => $p->{'svcpart'},
1652                 'phonenum' => $did,
1653                 'countrycode' => $p->{'countrycode'},
1654                 'session_id' => $p->{'session_id'},
1655               }
1656             );
1657     return $error if ($error->{'error'} && length($error->{'error'}) > 1);
1658   }
1659   { 'bulkdid' => [ @bulkdid ], 'svc' => $error->{'svc'} }
1660 }
1661
1662 sub provision_acct {
1663   my $p = shift;
1664   warn "provision_acct called\n"
1665     if $DEBUG;
1666
1667   return { 'error' => gettext('passwords_dont_match') }
1668     if $p->{'_password'} ne $p->{'_password2'};
1669   return { 'error' => gettext('empty_password') }
1670     unless length($p->{'_password'});
1671
1672   if ($p->{'domsvc'}) {
1673     my %domains = domain_select_hash FS::svc_acct(map { $_ => $p->{$_} }
1674                                                   qw ( svcpart pkgnum ) );
1675     return { 'error' => gettext('invalid_domain') }
1676       unless ($domains{$p->{'domsvc'}});
1677   }
1678
1679   warn "provision_acct calling _provision\n"
1680     if $DEBUG;
1681   _provision( 'FS::svc_acct',
1682               [qw(username _password domsvc)],
1683               [qw(username _password domsvc)],
1684               $p,
1685               @_
1686             );
1687 }
1688
1689 sub provision_external {
1690   my $p = shift;
1691   #_provision( 'FS::svc_external', [qw(id title)], [qw(id title)], $p, @_ );
1692   _provision( 'FS::svc_external',
1693               [],
1694               [qw(id title)],
1695               $p,
1696               @_
1697             );
1698 }
1699
1700 sub _provision {
1701   my( $class, $fields, $return_fields, $p ) = splice(@_, 0, 4);
1702   warn "_provision called for $class\n"
1703     if $DEBUG;
1704
1705   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1706   return { 'error' => $session } if $context eq 'error';
1707
1708   my $search = { 'custnum' => $custnum };
1709   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1710   my $cust_main = qsearchs('cust_main', $search )
1711     or return { 'error' => "unknown custnum $custnum" };
1712
1713   my $pkgnum = $p->{'pkgnum'};
1714
1715   warn "searching for custnum $custnum pkgnum $pkgnum\n"
1716     if $DEBUG;
1717   my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
1718                                         'pkgnum'  => $pkgnum,
1719                                                                } )
1720     or return { 'error' => "unknown pkgnum $pkgnum" };
1721
1722   warn "searching for svcpart ". $p->{'svcpart'}. "\n"
1723     if $DEBUG;
1724   my $part_svc = qsearchs('part_svc', { 'svcpart' => $p->{'svcpart'} } )
1725     or return { 'error' => "unknown svcpart $p->{'svcpart'}" };
1726
1727   warn "creating $class record\n"
1728     if $DEBUG;
1729   my $svc_x = $class->new( {
1730     'pkgnum'  => $p->{'pkgnum'},
1731     'svcpart' => $p->{'svcpart'},
1732     map { $_ => $p->{$_} } @$fields
1733   } );
1734   warn "inserting $class record\n"
1735     if $DEBUG;
1736   my $error = $svc_x->insert;
1737
1738   unless ( $error ) {
1739     warn "finding inserted record for svcnum ". $svc_x->svcnum. "\n"
1740       if $DEBUG;
1741     $svc_x = qsearchs($svc_x->table, { 'svcnum' => $svc_x->svcnum })
1742   }
1743
1744   my $return = { 'svc'   => $part_svc->svc,
1745                  'error' => $error,
1746                  map { $_ => $svc_x->get($_) } @$return_fields
1747                };
1748   warn "_provision returning ". Dumper($return). "\n"
1749     if $DEBUG;
1750   return $return;
1751
1752 }
1753
1754 sub part_svc_info {
1755   my $p = shift;
1756
1757   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1758   return { 'error' => $session } if $context eq 'error';
1759
1760   my $search = { 'custnum' => $custnum };
1761   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1762   my $cust_main = qsearchs('cust_main', $search )
1763     or return { 'error' => "unknown custnum $custnum" };
1764
1765   my $pkgnum = $p->{'pkgnum'};
1766
1767   my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
1768                                         'pkgnum'  => $pkgnum,
1769                                                                } )
1770     or return { 'error' => "unknown pkgnum $pkgnum" };
1771
1772   my $svcpart = $p->{'svcpart'};
1773
1774   my $pkg_svc = qsearchs('pkg_svc', { 'pkgpart' => $cust_pkg->pkgpart,
1775                                       'svcpart' => $svcpart,           } )
1776     or return { 'error' => "unknown svcpart $svcpart for pkgnum $pkgnum" };
1777   my $part_svc = $pkg_svc->part_svc;
1778
1779   my $conf = new FS::Conf;
1780
1781   return {
1782     'svc'     => $part_svc->svc,
1783     'svcdb'   => $part_svc->svcdb,
1784     'pkgnum'  => $pkgnum,
1785     'svcpart' => $svcpart,
1786     'custnum' => $custnum,
1787
1788     'security_phrase' => 0, #XXX !
1789     'svc_acct_pop'    => [], #XXX !
1790     'popnum'          => '',
1791     'init_popstate'   => '',
1792     'popac'           => '',
1793     'acstate'         => '',
1794
1795     'small_custview' =>
1796       small_custview( $cust_main, $conf->config('countrydefault') ),
1797
1798   };
1799
1800 }
1801
1802 sub unprovision_svc {
1803   my $p = shift;
1804
1805   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1806   return { 'error' => $session } if $context eq 'error';
1807
1808   my $search = { 'custnum' => $custnum };
1809   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1810   my $cust_main = qsearchs('cust_main', $search )
1811     or return { 'error' => "unknown custnum $custnum" };
1812
1813   my $svcnum = $p->{'svcnum'};
1814
1815   my $cust_svc = qsearchs('cust_svc', { 'svcnum'  => $svcnum, } )
1816     or return { 'error' => "unknown svcnum $svcnum" };
1817
1818   return { 'error' => "Service $svcnum does not belong to customer $custnum" }
1819     unless $cust_svc->cust_pkg->custnum == $custnum;
1820
1821   my $conf = new FS::Conf;
1822
1823   return { 'svc'   => $cust_svc->part_svc->svc,
1824            'error' => $cust_svc->cancel,
1825            'small_custview' =>
1826              small_custview( $cust_main, $conf->config('countrydefault') ),
1827          };
1828
1829 }
1830
1831 sub myaccount_passwd {
1832   my $p = shift;
1833   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1834   return { 'error' => $session } if $context eq 'error';
1835
1836   return { 'error' => "New passwords don't match." }
1837     if $p->{'new_password'} ne $p->{'new_password2'};
1838
1839   return { 'error' => 'Enter new password' }
1840     unless length($p->{'new_password'});
1841
1842   #my $search = { 'custnum' => $custnum };
1843   #$search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1844   $custnum =~ /^(\d+)$/ or die "illegal custnum";
1845   my $search = " AND custnum = $1";
1846   $search .= " AND agentnum = ". $session->{'agentnum'} if $context eq 'agent';
1847
1848   my $svc_acct = qsearchs( {
1849     'table'     => 'svc_acct',
1850     'addl_from' => 'LEFT JOIN cust_svc  USING ( svcnum  ) '.
1851                    'LEFT JOIN cust_pkg  USING ( pkgnum  ) '.
1852                    'LEFT JOIN cust_main USING ( custnum ) ',
1853     'hashref'   => { 'svcnum' => $p->{'svcnum'}, },
1854     'extra_sql' => $search, #important
1855   } )
1856     or return { 'error' => "Service not found" };
1857
1858   $svc_acct->_password($p->{'new_password'});
1859   my $error = $svc_acct->replace();
1860
1861   my($label, $value) = $svc_acct->cust_svc->label;
1862
1863   return { 'error' => $error,
1864            'label' => $label,
1865            'value' => $value,
1866          };
1867
1868 }
1869
1870 sub create_ticket {
1871   my $p = shift;
1872   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1873   return { 'error' => $session } if $context eq 'error';
1874
1875   warn "$me create_ticket: initializing ticket system\n" if $DEBUG;
1876   FS::TicketSystem->init();
1877
1878   my $conf = new FS::Conf;
1879   my $queue = $p->{'queue'}
1880               || $conf->config('ticket_system-selfservice_queueid')
1881               || $conf->config('ticket_system-default_queueid');
1882
1883   warn "$me create_ticket: creating ticket\n" if $DEBUG;
1884   my $err_or_ticket = FS::TicketSystem->create_ticket(
1885     '', #create RT session based on FS CurrentUser (fs_selfservice)
1886     'queue'   => $queue,
1887     'custnum' => $custnum,
1888     'svcnum'  => $session->{'svcnum'},
1889     map { $_ => $p->{$_} } qw( requestor cc subject message mime_type )
1890   );
1891
1892   if ( ref($err_or_ticket) ) {
1893     warn "$me create_ticket: sucessful: ". $err_or_ticket->id. "\n"
1894       if $DEBUG;
1895     return { 'error'     => '',
1896              'ticket_id' => $err_or_ticket->id,
1897            };
1898   } else {
1899     warn "$me create_ticket: unsucessful: $err_or_ticket\n"
1900       if $DEBUG;
1901     return { 'error' => $err_or_ticket };
1902   }
1903
1904
1905 }
1906
1907 sub did_report {
1908   my $p = shift;
1909   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1910   return { 'error' => $session } if $context eq 'error';
1911
1912   return { error => 'requested format not implemented' }
1913     unless ($p->{'format'} eq 'csv' || $p->{'format'} eq 'xls');
1914
1915   my $conf = new FS::Conf;
1916   my $age_threshold = 0;
1917   $age_threshold = time() - $conf->config('selfservice-recent-did-age')
1918     if ($p->{'recentonly'} && $conf->exists('selfservice-recent-did-age'));
1919
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 # does it make more sense to just run one sql query for this instead of all the
1926 # insanity below? would increase performance greately for large data sets?
1927   my @svc_phone = ();
1928   foreach my $cust_pkg ( $cust_main->ncancelled_pkgs ) {
1929         my @part_svc = $cust_pkg->part_svc;
1930         foreach my $part_svc ( @part_svc ) {
1931             if($part_svc->svcdb eq 'svc_phone'){
1932                 my @cust_pkg_svc = @{$part_svc->cust_pkg_svc};
1933                 foreach my $cust_pkg_svc ( @cust_pkg_svc ) {
1934                     push @svc_phone, $cust_pkg_svc->svc_x
1935                         if $cust_pkg_svc->date_inserted >= $age_threshold;
1936                 }
1937             }
1938         }
1939   }
1940
1941   my $csv;
1942   my $xls;
1943   my($xls_r,$xls_c) = (0,0);
1944   my $xls_workbook;
1945   my $content = '';
1946   my @fields = qw( countrycode phonenum pin sip_password phone_name );
1947   if($p->{'format'} eq 'csv') {
1948     $csv = new Text::CSV_XS { 'always_quote' => 1,
1949                                  'eol'          => "\n",
1950                                 };
1951     return { 'error' => 'Unable to create CSV' } unless $csv->combine(@fields);
1952     $content .= $csv->string;
1953   }
1954   elsif($p->{'format'} eq 'xls') {
1955     my $XLS1 = new IO::Scalar \$content;
1956     $xls_workbook = Spreadsheet::WriteExcel->new($XLS1)
1957         or return { 'error' => "Error opening .xls file: $!" };
1958     $xls = $xls_workbook->add_worksheet('DIDs');
1959     foreach ( @fields ) {
1960         $xls->write(0,$xls_c++,$_);
1961     }
1962     $xls_r++;
1963   }
1964
1965   foreach my $svc_phone ( @svc_phone ) {
1966     my @cols = map { $svc_phone->$_ } @fields;
1967     if($p->{'format'} eq 'csv') {
1968         return { 'error' => 'Unable to create CSV' }
1969             unless $csv->combine(@cols);
1970         $content .= $csv->string;
1971     }
1972     elsif($p->{'format'} eq 'xls') {
1973         $xls_c = 0;
1974         foreach ( @cols ) {
1975             $xls->write($xls_r,$xls_c++,$_);
1976         }
1977         $xls_r++;
1978     }
1979   }
1980
1981   $xls_workbook->close() if $p->{'format'} eq 'xls';
1982
1983   { content => $content, format => $p->{'format'}, };
1984 }
1985
1986 sub get_ticket {
1987   my $p = shift;
1988   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1989   return { 'error' => $session } if $context eq 'error';
1990
1991   warn "$me get_ticket: initializing ticket system\n" if $DEBUG;
1992   FS::TicketSystem->init();
1993
1994   if(length($p->{'reply'})) {
1995 # currently this allows anyone to correspond on any ticket as fs_selfservice
1996 # probably bad...
1997       my @err_or_res = FS::TicketSystem->correspond_ticket(
1998         '', #create RT session based on FS CurrentUser (fs_selfservice)
1999         'ticket_id' => $p->{'ticket_id'},
2000         'content' => $p->{'reply'},
2001       );
2002
2003     return { 'error' => 'unable to reply to ticket' }
2004         unless ( $err_or_res[0] != 0 && defined $err_or_res[2] );
2005   }
2006
2007   warn "$me get_ticket: getting ticket\n" if $DEBUG;
2008   my $err_or_ticket = FS::TicketSystem->get_ticket(
2009     '', #create RT session based on FS CurrentUser (fs_selfservice)
2010     'ticket_id' => $p->{'ticket_id'},
2011   );
2012
2013   if ( ref($err_or_ticket) ) {
2014
2015 # since we're bypassing the RT security/permissions model by always using
2016 # fs_selfservice as the RT user (as opposed to a requestor, which we
2017 # can't do since we want all tickets linked to a cust), we check below whether
2018 # the requested ticket was actually linked to this customer
2019     my @custs = @{$err_or_ticket->{'custs'}};
2020     my @txns = @{$err_or_ticket->{'txns'}};
2021     my @filtered_txns;
2022
2023     return { 'error' => 'no customer' } unless ( $custnum && scalar(@custs) );
2024
2025     return { 'error' => 'invalid ticket requested' }
2026         unless grep($_ eq $custnum, @custs);
2027
2028     foreach my $txn ( @txns ) {
2029         push @filtered_txns, $txn
2030             if ($txn->{'type'} eq 'EmailRecord'
2031                 || $txn->{'type'} eq 'Correspond'
2032                 || $txn->{'type'} eq 'Create');
2033     }
2034
2035     warn "$me get_ticket: sucessful: \n"
2036       if $DEBUG;
2037     return { 'error'     => '',
2038              'transactions' => \@filtered_txns,
2039              'ticket_id' => $p->{'ticket_id'},
2040            };
2041   } else {
2042     warn "$me create_ticket: unsucessful: $err_or_ticket\n"
2043       if $DEBUG;
2044     return { 'error' => $err_or_ticket };
2045   }
2046 }
2047
2048
2049 #--
2050
2051 sub _custoragent_session_custnum {
2052   my $p = shift;
2053
2054   my($context, $session, $custnum);
2055   if ( $p->{'session_id'} ) {
2056
2057     $context = 'customer';
2058     $session = _cache->get($p->{'session_id'})
2059       or return ( 'error' => "Can't resume session" ); #better error message
2060     $custnum = $session->{'custnum'};
2061
2062   } elsif ( $p->{'agent_session_id'} ) {
2063
2064     $context = 'agent';
2065     my $agent_cache = new FS::ClientAPI_SessionCache( {
2066       'namespace' => 'FS::ClientAPI::Agent',
2067     } );
2068     $session = $agent_cache->get($p->{'agent_session_id'})
2069       or return ( 'error' => "Can't resume session" ); #better error message
2070     $custnum = $p->{'custnum'};
2071
2072   } else {
2073     $context = 'error';
2074     return ( 'error' => "Can't resume session" ); #better error message
2075   }
2076
2077   ($context, $session, $custnum);
2078
2079 }
2080
2081 1;
2082