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');
 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
 538   }
 539
 540   ##
 541   #customer-specific
 542   ##
 543
 544   my %return = %$payment_info;
 545
 546   my $custnum = $session->{'custnum'};
 547
 548   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 549     or return { 'error' => "unknown custnum $custnum" };
 550
 551   $return{'hide_payment_fields'} = [
 552     map {
 553       my $pg = payment_gateway($cust_main, $_);
 554       $pg && $pg->gateway_namespace eq 'Business::OnlineThirdPartyPayment';
 555     } @{ $return{cust_paybys} }
 556   ];
 557
 558   $return{balance} = $cust_main->balance; #XXX pkg-balances?
 559
 560   $return{payname} = $cust_main->payname
 561                      || ( $cust_main->first. ' '. $cust_main->get('last') );
 562
 563   $return{$_} = $cust_main->get($_) for qw(address1 address2 city state zip);
 564
 565   $return{payby} = $cust_main->payby;
 566   $return{stateid_state} = $cust_main->stateid_state;
 567
 568   if ( $cust_main->payby =~ /^(CARD|DCRD)$/ ) {
 569     $return{card_type} = cardtype($cust_main->payinfo);
 570     $return{payinfo} = $cust_main->paymask;
 571
 572     @return{'month', 'year'} = $cust_main->paydate_monthyear;
 573
 574   }
 575
 576   if ( $cust_main->payby =~ /^(CHEK|DCHK)$/ ) {
 577     my ($payinfo1, $payinfo2) = split '@', $cust_main->paymask;
 578     $return{payinfo1} = $payinfo1;
 579     $return{payinfo2} = $payinfo2;
 580     $return{paytype}  = $cust_main->paytype;
 581     $return{paystate} = $cust_main->paystate;
 582
 583   }
 584
 585   if ( $conf->config('prepayment_discounts-credit_type') ) {
 586     #need to eval?
 587     $return{discount_terms_hash} = { $cust_main->discount_terms_hash };
 588   }
 589
 590   #doubleclick protection
 591   my $_date = time;
 592   $return{paybatch} = "webui-MyAccount-$_date-$$-". rand() * 2**32;
 593
 594   return { 'error' => '',
 595            %return,
 596          };
 597
 598 };
 599
 600 #some false laziness with httemplate/process/payment.cgi - look there for
 601 #ACH and CVV support stuff
 602 sub process_payment {
 603
 604   my $p = shift;
 605
 606   my $session = _cache->get($p->{'session_id'})
 607     or return { 'error' => "Can't resume session" }; #better error message
 608
 609   my %return;
 610
 611   my $custnum = $session->{'custnum'};
 612
 613   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 614     or return { 'error' => "unknown custnum $custnum" };
 615
 616   $p->{'amount'} =~ /^\s*(\d+(\.\d{2})?)\s*$/
 617     or return { 'error' => gettext('illegal_amount') };
 618   my $amount = $1;
 619   return { error => 'Amount must be greater than 0' } unless $amount > 0;
 620
 621   $p->{'discount_term'} =~ /^\s*(\d*)\s*$/
 622     or return { 'error' => gettext('illegal_discount_term'). ': '. $p->{'discount_term'} };
 623   my $discount_term = $1;
 624
 625   $p->{'payname'} =~ /^([\w \,\.\-\']+)$/
 626     or return { 'error' => gettext('illegal_name'). " payname: ". $p->{'payname'} };
 627   my $payname = $1;
 628
 629   $p->{'paybatch'} =~ /^([\w \!\@\#\$\%\&\(\)\-\+\;\:\'\"\,\.\?\/\=]*)$/
 630     or return { 'error' => gettext('illegal_text'). " paybatch: ". $p->{'paybatch'} };
 631   my $paybatch = $1;
 632
 633   $p->{'payby'} ||= 'CARD';
 634   $p->{'payby'} =~ /^([A-Z]{4})$/
 635     or return { 'error' => "illegal_payby " . $p->{'payby'} };
 636   my $payby = $1;
 637
 638   #false laziness w/process/payment.cgi
 639   my $payinfo;
 640   my $paycvv = '';
 641   my $paynum = '';
 642   if ( $payby eq 'CHEK' || $payby eq 'DCHK' ) {
 643
 644     $p->{'payinfo1'} =~ /^([\dx]+)$/
 645       or return { 'error' => "illegal account number ". $p->{'payinfo1'} };
 646     my $payinfo1 = $1;
 647      $p->{'payinfo2'} =~ /^([\dx]+)$/
 648       or return { 'error' => "illegal ABA/routing number ". $p->{'payinfo2'} };
 649     my $payinfo2 = $1;
 650     $payinfo = $payinfo1. '@'. $payinfo2;
 651
 652     $payinfo = $cust_main->payinfo
 653       if $cust_main->paymask eq $payinfo;
 654
 655   } elsif ( $payby eq 'CARD' || $payby eq 'DCRD' ) {
 656
 657     $payinfo = $p->{'payinfo'};
 658
 659     #more intelligent mathing will be needed here if you change
 660     #card_masking_method and don't remove existing paymasks
 661     $payinfo = $cust_main->payinfo
 662       if $cust_main->paymask eq $payinfo;
 663
 664     $payinfo =~ s/\D//g;
 665     $payinfo =~ /^(\d{13,16})$/
 666       or return { 'error' => gettext('invalid_card') }; # . ": ". $self->payinfo
 667     $payinfo = $1;
 668
 669     validate($payinfo)
 670       or return { 'error' => gettext('invalid_card') }; # . ": ". $self->payinfo
 671     return { 'error' => gettext('unknown_card_type') }
 672       if $payinfo !~ /^99\d{14}$/ && cardtype($payinfo) eq "Unknown";
 673
 674     if ( length($p->{'paycvv'}) && $p->{'paycvv'} !~ /^\s*$/ ) {
 675       if ( cardtype($payinfo) eq 'American Express card' ) {
 676         $p->{'paycvv'} =~ /^\s*(\d{4})\s*$/
 677           or return { 'error' => "CVV2 (CID) for American Express cards is four digits." };
 678         $paycvv = $1;
 679       } else {
 680         $p->{'paycvv'} =~ /^\s*(\d{3})\s*$/
 681           or return { 'error' => "CVV2 (CVC2/CID) is three digits." };
 682         $paycvv = $1;
 683       }
 684     }
 685
 686   } else {
 687     die "unknown payby $payby";
 688   }
 689
 690   my %payby2fields = (
 691     'CARD' => [ qw( paystart_month paystart_year payissue payip
 692                     address1 address2 city state zip country    ) ],
 693     'CHEK' => [ qw( ss paytype paystate stateid stateid_state payip ) ],
 694   );
 695
 696   my $error = $cust_main->realtime_bop( $FS::payby::payby2bop{$payby}, $amount,
 697     'quiet'    => 1,
 698     'payinfo'  => $payinfo,
 699     'paydate'  => $p->{'year'}. '-'. $p->{'month'}. '-01',
 700     'payname'  => $payname,
 701     'paybatch' => $paybatch, #this doesn't actually do anything
 702     'paycvv'   => $paycvv,
 703     'paynum_ref' => \$paynum,
 704     'pkgnum'   => $session->{'pkgnum'},
 705     'discount_term' => $discount_term,
 706     'selfservice' => 1,
 707     map { $_ => $p->{$_} } @{ $payby2fields{$payby} }
 708   );
 709   return { 'error' => $error } if $error;
 710
 711   $cust_main->apply_payments;
 712
 713   if ( $p->{'save'} ) {
 714     my $new = new FS::cust_main { $cust_main->hash };
 715     if ($payby eq 'CARD' || $payby eq 'DCRD') {
 716       $new->set( $_ => $p->{$_} )
 717         foreach qw( payname paystart_month paystart_year payissue payip
 718                     address1 address2 city state zip country );
 719       $new->set( 'payby' => $p->{'auto'} ? 'CARD' : 'DCRD' );
 720     } elsif ($payby eq 'CHEK' || $payby eq 'DCHK') {
 721       $new->set( $_ => $p->{$_} )
 722         foreach qw( payname payip paytype paystate
 723                     stateid stateid_state );
 724       $new->set( 'payby' => $p->{'auto'} ? 'CHEK' : 'DCHK' );
 725     }
 726     $new->set( 'payinfo' => $cust_main->card_token || $payinfo );
 727     $new->set( 'paydate' => $p->{'year'}. '-'. $p->{'month'}. '-01' );
 728     my $error = $new->replace($cust_main);
 729     if ( $error ) {
 730       #no, this causes customers to process their payments again
 731       #return { 'error' => $error };
 732       #XXX just warn verosely for now so i can figure out how these happen in
 733       # the first place, eventually should redirect them to the "change
 734       #address" page but indicate the payment did process??
 735       delete($p->{'payinfo'}); #don't want to log this!
 736       warn "WARNING: error changing customer info when processing payment (not returning to customer as a processing error): $error\n".
 737            "NEW: ". Dumper($new)."\n".
 738            "OLD: ". Dumper($cust_main)."\n".
 739            "PACKET: ". Dumper($p)."\n";
 740     #} else {
 741       #not needed...
 742       #$cust_main = $new;
 743     }
 744   }
 745
 746   my $receipt_html = '';
 747   if($paynum) {
 748       # currently supported for realtime CC only; send receipt data to SS
 749       my $cust_pay = qsearchs('cust_pay', { 'paynum' => $paynum } );
 750       if($cust_pay) {
 751         $receipt_html = qq!
 752 <TABLE BGCOLOR="#cccccc" BORDER=0 CELLSPACING=2>
 753
 754 <TR>
 755   <TD ALIGN="right">Payment#</TD>
 756   <TD BGCOLOR="#FFFFFF"><B>! . $cust_pay->paynum . qq!</B></TD>
 757 </TR>
 758
 759 <TR>
 760   <TD ALIGN="right">Date</TD>
 761
 762   <TD BGCOLOR="#FFFFFF"><B>! .
 763         time2str("%a&nbsp;%b&nbsp;%o,&nbsp;%Y&nbsp;%r", $cust_pay->_date)
 764                                                             . qq!</B></TD>
 765 </TR>
 766
 767
 768 <TR>
 769   <TD ALIGN="right">Amount</TD>
 770   <TD BGCOLOR="#FFFFFF"><B>! . $cust_pay->paid . qq!</B></TD>
 771
 772 </TR>
 773
 774 <TR>
 775   <TD ALIGN="right">Payment method</TD>
 776   <TD BGCOLOR="#FFFFFF"><B>! . $cust_pay->payby_name .' #'. $cust_pay->paymask
 777                                                                 . qq!</B></TD>
 778 </TR>
 779
 780 </TABLE>
 781 !;
 782       }
 783   }
 784
 785   return { 'error' => '', 'receipt_html' => $receipt_html, };
 786
 787 }
 788
 789 sub realtime_collect {
 790   my $p = shift;
 791
 792   my $session = _cache->get($p->{'session_id'})
 793     or return { 'error' => "Can't resume session" }; #better error message
 794
 795   my $custnum = $session->{'custnum'};
 796
 797   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 798     or return { 'error' => "unknown custnum $custnum" };
 799
 800   my $amount;
 801   if ( $p->{'amount'} ) {
 802     $amount = $p->{'amount'};
 803   }
 804   elsif ( $session->{'pkgnum'} ) {
 805     $amount = $cust_main->balance_pkgnum( $session->{'pkgnum'} );
 806   }
 807   else {
 808     $amount = $cust_main->balance;
 809   }
 810
 811   my $error = $cust_main->realtime_collect(
 812     'method'     => $p->{'method'},
 813     'amount'     => $amount,
 814     'pkgnum'     => $session->{'pkgnum'},
 815     'session_id' => $p->{'session_id'},
 816     'apply'      => 1,
 817     'selfservice'=> 1,
 818   );
 819   return { 'error' => $error } unless ref( $error );
 820
 821   return { 'error' => '', amount => $amount, %$error };
 822 }
 823
 824 sub process_payment_order_pkg {
 825   my $p = shift;
 826
 827   my $hr = process_payment($p);
 828   return $hr if $hr->{'error'};
 829
 830   order_pkg($p);
 831 }
 832
 833 sub process_payment_order_renew {
 834   my $p = shift;
 835
 836   my $hr = process_payment($p);
 837   return $hr if $hr->{'error'};
 838
 839   order_renew($p);
 840 }
 841
 842 sub process_prepay {
 843
 844   my $p = shift;
 845
 846   my $session = _cache->get($p->{'session_id'})
 847     or return { 'error' => "Can't resume session" }; #better error message
 848
 849   my %return;
 850
 851   my $custnum = $session->{'custnum'};
 852
 853   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 854     or return { 'error' => "unknown custnum $custnum" };
 855
 856   my( $amount, $seconds, $upbytes, $downbytes, $totalbytes ) = ( 0, 0, 0, 0, 0 );
 857   my $error = $cust_main->recharge_prepay( $p->{'prepaid_cardnum'},
 858                                            \$amount,
 859                                            \$seconds,
 860                                            \$upbytes,
 861                                            \$downbytes,
 862                                            \$totalbytes,
 863                                          );
 864
 865   return { 'error' => $error } if $error;
 866
 867   return { 'error'     => '',
 868            'amount'    => $amount,
 869            'seconds'   => $seconds,
 870            'duration'  => duration_exact($seconds),
 871            'upbytes'   => $upbytes,
 872            'upload'    => FS::UI::bytecount::bytecount_unexact($upbytes),
 873            'downbytes' => $downbytes,
 874            'download'  => FS::UI::bytecount::bytecount_unexact($downbytes),
 875            'totalbytes'=> $totalbytes,
 876            'totalload' => FS::UI::bytecount::bytecount_unexact($totalbytes),
 877          };
 878
 879 }
 880
 881 sub invoice {
 882   my $p = shift;
 883   my $session = _cache->get($p->{'session_id'})
 884     or return { 'error' => "Can't resume session" }; #better error message
 885
 886   my $custnum = $session->{'custnum'};
 887
 888   my $invnum = $p->{'invnum'};
 889
 890   my $cust_bill = qsearchs('cust_bill', { 'invnum'  => $invnum,
 891                                           'custnum' => $custnum } )
 892     or return { 'error' => "Can't find invnum" };
 893
 894   #my %return;
 895
 896   return { 'error'        => '',
 897            'invnum'       => $invnum,
 898            'invoice_text' => join('', $cust_bill->print_text ),
 899            'invoice_html' => $cust_bill->print_html( { unsquelch_cdr => 1 } ),
 900          };
 901
 902 }
 903
 904 sub invoice_logo {
 905   my $p = shift;
 906
 907   #sessioning for this?  how do we get the session id to the backend invoice
 908   # template so it can add it to the link, blah
 909
 910   my $agentnum = '';
 911   if ( $p->{'invnum'} ) {
 912     my $cust_bill = qsearchs('cust_bill', { 'invnum' => $p->{'invnum'} } )
 913       or return { 'error' => 'unknown invnum' };
 914     $agentnum = $cust_bill->cust_main->agentnum;
 915   }
 916
 917   my $templatename = $p->{'template'} || $p->{'templatename'};
 918
 919   #false laziness-ish w/view/cust_bill-logo.cgi
 920
 921   my $conf = new FS::Conf;
 922   if ( $templatename =~ /^([^\.\/]*)$/ && $conf->exists("logo_$1.png") ) {
 923     $templatename = "_$1";
 924   } else {
 925     $templatename = '';
 926   }
 927
 928   my $filename = "logo$templatename.png";
 929
 930   return { 'error'        => '',
 931            'logo'         => $conf->config_binary($filename, $agentnum),
 932            'content_type' => 'image/png', #should allow gif, jpg too
 933          };
 934 }
 935
 936
 937 sub list_invoices {
 938   my $p = shift;
 939   my $session = _cache->get($p->{'session_id'})
 940     or return { 'error' => "Can't resume session" }; #better error message
 941
 942   my $custnum = $session->{'custnum'};
 943
 944   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 945     or return { 'error' => "unknown custnum $custnum" };
 946
 947   my @cust_bill = $cust_main->cust_bill;
 948
 949   return  { 'error'       => '',
 950             'invoices'    =>  [ map { { 'invnum' => $_->invnum,
 951                                         '_date'  => $_->_date,
 952                                         'date'   => time2str("%b %o, %Y", $_->_date),
 953                                       }
 954                                     } @cust_bill
 955                               ]
 956           };
 957 }
 958
 959 sub cancel {
 960   my $p = shift;
 961   my $session = _cache->get($p->{'session_id'})
 962     or return { 'error' => "Can't resume session" }; #better error message
 963
 964   my $custnum = $session->{'custnum'};
 965
 966   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
 967     or return { 'error' => "unknown custnum $custnum" };
 968
 969   my @errors = $cust_main->cancel( 'quiet'=>1 );
 970
 971   my $error = scalar(@errors) ? join(' / ', @errors) : '';
 972
 973   return { 'error' => $error };
 974
 975 }
 976
 977 sub list_pkgs {
 978   my $p = shift;
 979
 980   my($context, $session, $custnum) = _custoragent_session_custnum($p);
 981   return { 'error' => $session } if $context eq 'error';
 982
 983   my $search = { 'custnum' => $custnum };
 984   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
 985   my $cust_main = qsearchs('cust_main', $search )
 986     or return { 'error' => "unknown custnum $custnum" };
 987
 988   my $conf = new FS::Conf;
 989
 990 # the duplication below is necessary:
 991 # 1. to maintain the current buggy behaviour wrt the cust_pkg and part_pkg
 992 # hashes overwriting each other (setup and no_auto fields). Fixing that is a
 993 # non-backwards-compatible change breaking the software of anyone using the API
 994 # instead of the stock selfservice
 995 # 2. to return cancelled packages as well - for wholesale and non-wholesale
 996   if( $conf->exists('selfservice_server-view-wholesale') ) {
 997     return { 'svcnum'   => $session->{'svcnum'},
 998             'custnum'  => $custnum,
 999             'cust_pkg' => [ map {
1000                           { $_->hash,
1001                             part_pkg => [ map $_->hashref, $_->part_pkg ],
1002                             part_svc =>
1003                               [ map $_->hashref, $_->available_part_svc ],
1004                             cust_svc =>
1005                               [ map { my $ref = { $_->hash,
1006                                                   label => [ $_->label ],
1007                                                 };
1008                                       $ref->{_password} = $_->svc_x->_password
1009                                         if $context eq 'agent'
1010                                         && $conf->exists('agent-showpasswords')
1011                                         && $_->part_svc->svcdb eq 'svc_acct';
1012                                       $ref;
1013                                     } $_->cust_svc
1014                               ],
1015                           };
1016                         } $cust_main->cust_pkg
1017                   ],
1018     'small_custview' =>
1019       small_custview( $cust_main, $conf->config('countrydefault') ),
1020     'wholesale_view' => 1,
1021     'login_svcpart' => [ $conf->config('selfservice_server-login_svcpart') ],
1022     'date_format' => $conf->config('date_format') || '%m/%d/%Y',
1023     'lnp' => $conf->exists('svc_phone-lnp'),
1024       };
1025   }
1026
1027   { 'svcnum'   => $session->{'svcnum'},
1028     'custnum'  => $custnum,
1029     'cust_pkg' => [ map {
1030                           { $_->hash,
1031                             $_->part_pkg->hash,
1032                             part_svc =>
1033                               [ map $_->hashref, $_->available_part_svc ],
1034                             cust_svc =>
1035                               [ map { my $ref = { $_->hash,
1036                                                   label => [ $_->label ],
1037                                                 };
1038                                       $ref->{_password} = $_->svc_x->_password
1039                                         if $context eq 'agent'
1040                                         && $conf->exists('agent-showpasswords')
1041                                         && $_->part_svc->svcdb eq 'svc_acct';
1042                                       $ref;
1043                                     } $_->cust_svc
1044                               ],
1045                           };
1046                         } $cust_main->ncancelled_pkgs
1047                   ],
1048     'small_custview' =>
1049       small_custview( $cust_main, $conf->config('countrydefault') ),
1050   };
1051
1052 }
1053
1054 sub list_svcs {
1055   my $p = shift;
1056
1057   my $conf = new FS::Conf;
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     'view_usage_nodomain' => $conf->exists('selfservice-view_usage_nodomain'),
1091     'svcs'     => [
1092       map {
1093             my $svc_x = $_->svc_x;
1094             my($label, $value) = $_->label;
1095             my $svcdb = $_->part_svc->svcdb;
1096             my $part_pkg = $_->cust_pkg->part_pkg;
1097
1098             my %hash = (
1099               'svcnum' => $_->svcnum,
1100               'svcdb'  => $svcdb,
1101               'label'  => $label,
1102               'value'  => $value,
1103             );
1104
1105             if ( $svcdb eq 'svc_acct' ) {
1106               %hash = (
1107                 %hash,
1108                 'username'   => $svc_x->username,
1109                 'email'      => $svc_x->email,
1110                 'seconds'    => $svc_x->seconds,
1111                 'upbytes'    => display_bytecount($svc_x->upbytes),
1112                 'downbytes'  => display_bytecount($svc_x->downbytes),
1113                 'totalbytes' => display_bytecount($svc_x->totalbytes),
1114
1115                 'recharge_amount'  => $part_pkg->option('recharge_amount',1),
1116                 'recharge_seconds' => $part_pkg->option('recharge_seconds',1),
1117                 'recharge_upbytes'    =>
1118                   display_bytecount($part_pkg->option('recharge_upbytes',1)),
1119                 'recharge_downbytes'  =>
1120                   display_bytecount($part_pkg->option('recharge_downbytes',1)),
1121                 'recharge_totalbytes' =>
1122                   display_bytecount($part_pkg->option('recharge_totalbytes',1)),
1123                 # more...
1124               );
1125
1126             } elsif ( $svcdb eq 'svc_phone' ) {
1127               %hash = (
1128                 %hash,
1129               );
1130             }
1131
1132             \%hash;
1133           }
1134           @cust_svc
1135     ],
1136   };
1137
1138 }
1139
1140 sub _list_svc_usage {
1141   my($svc_acct, $begin, $end) = @_;
1142   my @usage = ();
1143   foreach my $part_export (
1144     map { qsearch ( 'part_export', { 'exporttype' => $_ } ) }
1145     qw( sqlradius sqlradius_withdomain )
1146   ) {
1147     push @usage, @ { $part_export->usage_sessions($begin, $end, $svc_acct) };
1148   }
1149   (@usage);
1150 }
1151
1152 sub list_svc_usage {
1153   _usage_details(\&_list_svc_usage, @_);
1154 }
1155
1156 sub _list_support_usage {
1157   my($svc_acct, $begin, $end) = @_;
1158   my @usage = ();
1159   foreach ( grep { $begin <= $_->_date && $_->_date <= $end }
1160             qsearch('acct_rt_transaction', { 'svcnum' => $svc_acct->svcnum })
1161           ) {
1162     push @usage, { 'seconds'  => $_->seconds,
1163                    'support'  => $_->support,
1164                    '_date'    => $_->_date,
1165                    'id'       => $_->transaction_id,
1166                    'creator'  => $_->creator,
1167                    'subject'  => $_->subject,
1168                    'status'   => $_->status,
1169                    'ticketid' => $_->ticketid,
1170                  };
1171   }
1172   (@usage);
1173 }
1174
1175 sub list_support_usage {
1176   _usage_details(\&_list_support_usage, @_);
1177 }
1178
1179 sub _list_cdr_usage {
1180   my($svc_phone, $begin, $end) = @_;
1181   map [ $_->downstream_csv('format' => 'default', 'keeparray' => 1) ], #XXX config for format
1182                        $svc_phone->get_cdrs( 'begin'=>$begin, 'end'=>$end, );
1183 }
1184
1185 sub list_cdr_usage {
1186   my $p = shift;
1187   _usage_details( \&_list_cdr_usage, $p,
1188                   'svcdb' => 'svc_phone',
1189                 );
1190 }
1191
1192 sub _usage_details {
1193   my($callback, $p, %opt) = @_;
1194
1195   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1196   return { 'error' => $session } if $context eq 'error';
1197
1198   my $search = { 'svcnum' => $p->{'svcnum'} };
1199   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1200
1201   my $svcdb = $opt{'svcdb'} || 'svc_acct';
1202
1203   my $svc_x = qsearchs( $svcdb, $search );
1204   return { 'error' => 'No service selected in list_svc_usage' }
1205     unless $svc_x;
1206
1207   my $header = $svcdb eq 'svc_phone'
1208                  ? [ split(',', FS::cdr::invoice_header('default') ) ]  #XXX
1209                  : [];
1210
1211   my $cust_pkg = $svc_x->cust_svc->cust_pkg;
1212   my $freq     = $cust_pkg->part_pkg->freq;
1213   my $start    = $cust_pkg->setup;
1214   #my $end      = $cust_pkg->bill; # or time?
1215   my $end      = time;
1216
1217   unless ( $p->{beginning} ) {
1218     $p->{beginning} = $cust_pkg->last_bill;
1219     $p->{ending}    = $end;
1220   }
1221
1222   my (@usage) = &$callback($svc_x, $p->{beginning}, $p->{ending});
1223
1224   #kinda false laziness with FS::cust_main::bill, but perhaps
1225   #we should really change this bit to DateTime and DateTime::Duration
1226   #
1227   #change this bit to use Date::Manip? CAREFUL with timezones (see
1228   # mailing list archive)
1229   my ($nsec,$nmin,$nhour,$nmday,$nmon,$nyear) =
1230     (localtime($p->{ending}) )[0,1,2,3,4,5];
1231   my ($psec,$pmin,$phour,$pmday,$pmon,$pyear) =
1232     (localtime($p->{beginning}) )[0,1,2,3,4,5];
1233
1234   if ( $freq =~ /^\d+$/ ) {
1235     $nmon += $freq;
1236     until ( $nmon < 12 ) { $nmon -= 12; $nyear++; }
1237     $pmon -= $freq;
1238     until ( $pmon >= 0 ) { $pmon += 12; $pyear--; }
1239   } elsif ( $freq =~ /^(\d+)w$/ ) {
1240     my $weeks = $1;
1241     $nmday += $weeks * 7;
1242     $pmday -= $weeks * 7;
1243   } elsif ( $freq =~ /^(\d+)d$/ ) {
1244     my $days = $1;
1245     $nmday += $days;
1246     $pmday -= $days;
1247   } elsif ( $freq =~ /^(\d+)h$/ ) {
1248     my $hours = $1;
1249     $nhour += $hours;
1250     $phour -= $hours;
1251   } else {
1252     return { 'error' => "unparsable frequency: ". $freq };
1253   }
1254
1255   my $previous  = timelocal_nocheck($psec,$pmin,$phour,$pmday,$pmon,$pyear);
1256   my $next      = timelocal_nocheck($nsec,$nmin,$nhour,$nmday,$nmon,$nyear);
1257
1258   {
1259     'error'     => '',
1260     'svcnum'    => $p->{svcnum},
1261     'beginning' => $p->{beginning},
1262     'ending'    => $p->{ending},
1263     'previous'  => ($previous > $start) ? $previous : $start,
1264     'next'      => ($next < $end) ? $next : $end,
1265     'header'    => $header,
1266     'usage'     => \@usage,
1267   };
1268 }
1269
1270 sub order_pkg {
1271   my $p = shift;
1272
1273   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1274   return { 'error' => $session } if $context eq 'error';
1275
1276   my $search = { 'custnum' => $custnum };
1277   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1278   my $cust_main = qsearchs('cust_main', $search )
1279     or return { 'error' => "unknown custnum $custnum" };
1280
1281   my $status = $cust_main->status;
1282   #false laziness w/ClientAPI/Signup.pm
1283
1284   my $cust_pkg = new FS::cust_pkg ( {
1285     'custnum' => $custnum,
1286     'pkgpart' => $p->{'pkgpart'},
1287   } );
1288   my $error = $cust_pkg->check;
1289   return { 'error' => $error } if $error;
1290
1291   my @svc = ();
1292   unless ( $p->{'svcpart'} eq 'none' ) {
1293
1294     my $svcdb;
1295     my $svcpart = '';
1296     if ( $p->{'svcpart'} =~ /^(\d+)$/ ) {
1297       $svcpart = $1;
1298       my $part_svc = qsearchs('part_svc', { 'svcpart' => $svcpart } );
1299       return { 'error' => "Unknown svcpart $svcpart" } unless $part_svc;
1300       $svcdb = $part_svc->svcdb;
1301     } else {
1302       $svcdb = 'svc_acct';
1303     }
1304     $svcpart ||= $cust_pkg->part_pkg->svcpart($svcdb);
1305
1306     my %fields = (
1307       'svc_acct'     => [ qw( username domsvc _password sec_phrase popnum ) ],
1308       'svc_domain'   => [ qw( domain ) ],
1309       'svc_phone'    => [ qw( phonenum pin sip_password phone_name ) ],
1310       'svc_external' => [ qw( id title ) ],
1311       'svc_pbx'      => [ qw( id name ) ],
1312     );
1313
1314     my $svc_x = "FS::$svcdb"->new( {
1315       'svcpart'   => $svcpart,
1316       map { $_ => $p->{$_} } @{$fields{$svcdb}}
1317     } );
1318
1319     if ( $svcdb eq 'svc_acct' && exists($p->{"snarf_machine1"}) ) {
1320       my @acct_snarf;
1321       my $snarfnum = 1;
1322       while ( length($p->{"snarf_machine$snarfnum"}) ) {
1323         my $acct_snarf = new FS::acct_snarf ( {
1324           'machine'   => $p->{"snarf_machine$snarfnum"},
1325           'protocol'  => $p->{"snarf_protocol$snarfnum"},
1326           'username'  => $p->{"snarf_username$snarfnum"},
1327           '_password' => $p->{"snarf_password$snarfnum"},
1328         } );
1329         $snarfnum++;
1330         push @acct_snarf, $acct_snarf;
1331       }
1332       $svc_x->child_objects( \@acct_snarf );
1333     }
1334
1335     my $y = $svc_x->setdefault; # arguably should be in new method
1336     return { 'error' => $y } if $y && !ref($y);
1337
1338     $error = $svc_x->check;
1339     return { 'error' => $error } if $error;
1340
1341     push @svc, $svc_x;
1342
1343   }
1344
1345   use Tie::RefHash;
1346   tie my %hash, 'Tie::RefHash';
1347   %hash = ( $cust_pkg => \@svc );
1348   #msgcat
1349   $error = $cust_main->order_pkgs( \%hash, 'noexport' => 1 );
1350   return { 'error' => $error } if $error;
1351
1352   my $conf = new FS::Conf;
1353   if ( $conf->exists('signup_server-realtime') ) {
1354
1355     my $bill_error = _do_bop_realtime( $cust_main, $status );
1356
1357     if ($bill_error) {
1358       $cust_pkg->cancel('quiet'=>1);
1359       return $bill_error;
1360     } else {
1361       $cust_pkg->reexport;
1362     }
1363
1364   } else {
1365     $cust_pkg->reexport;
1366   }
1367
1368   my $svcnum = $svc[0] ? $svc[0]->svcnum : '';
1369
1370   return { error=>'', pkgnum=>$cust_pkg->pkgnum, svcnum=>$svcnum };
1371
1372 }
1373
1374 sub change_pkg {
1375   my $p = shift;
1376
1377   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1378   return { 'error' => $session } if $context eq 'error';
1379
1380   my $search = { 'custnum' => $custnum };
1381   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1382   my $cust_main = qsearchs('cust_main', $search )
1383     or return { 'error' => "unknown custnum $custnum" };
1384
1385   my $status = $cust_main->status;
1386   my $cust_pkg = qsearchs('cust_pkg', { 'pkgnum' => $p->{pkgnum} } )
1387     or return { 'error' => "unknown package $p->{pkgnum}" };
1388
1389   my @newpkg;
1390   my $error = FS::cust_pkg::order( $custnum,
1391                                    [$p->{pkgpart}],
1392                                    [$p->{pkgnum}],
1393                                    \@newpkg,
1394                                  );
1395
1396   my $conf = new FS::Conf;
1397   if ( $conf->exists('signup_server-realtime') ) {
1398
1399     my $bill_error = _do_bop_realtime( $cust_main, $status );
1400
1401     if ($bill_error) {
1402       $newpkg[0]->suspend;
1403       return $bill_error;
1404     } else {
1405       $newpkg[0]->reexport;
1406     }
1407
1408   } else {
1409     $newpkg[0]->reexport;
1410   }
1411
1412   return { error => '', pkgnum => $cust_pkg->pkgnum };
1413
1414 }
1415
1416 sub order_recharge {
1417   my $p = shift;
1418
1419   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1420   return { 'error' => $session } if $context eq 'error';
1421
1422   my $search = { 'custnum' => $custnum };
1423   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1424   my $cust_main = qsearchs('cust_main', $search )
1425     or return { 'error' => "unknown custnum $custnum" };
1426
1427   my $status = $cust_main->status;
1428   my $cust_svc = qsearchs( 'cust_svc', { 'svcnum' => $p->{'svcnum'} } )
1429     or return { 'error' => "unknown service " . $p->{'svcnum'} };
1430
1431   my $svc_x = $cust_svc->svc_x;
1432   my $part_pkg = $cust_svc->cust_pkg->part_pkg;
1433
1434   my %vhash =
1435     map { $_ =~ /^recharge_(.*)$/; $1, $part_pkg->option($_, 1) }
1436     qw ( recharge_seconds recharge_upbytes recharge_downbytes
1437          recharge_totalbytes );
1438   my $amount = $part_pkg->option('recharge_amount', 1);
1439
1440   my ($l, $v, $d) = $cust_svc->label;  # blah
1441   my $pkg = "Recharge $v";
1442
1443   my $bill_error = $cust_main->charge($amount, $pkg,
1444      "time: $vhash{seconds}, up: $vhash{upbytes}," .
1445      "down: $vhash{downbytes}, total: $vhash{totalbytes}",
1446      $part_pkg->taxclass); #meh
1447
1448   my $conf = new FS::Conf;
1449   if ( $conf->exists('signup_server-realtime') && !$bill_error ) {
1450
1451     $bill_error = _do_bop_realtime( $cust_main, $status );
1452
1453     if ($bill_error) {
1454       return $bill_error;
1455     } else {
1456       my $error = $svc_x->recharge (\%vhash);
1457       return { 'error' => $error } if $error;
1458     }
1459
1460   } else {
1461     my $error = $bill_error;
1462     $error ||= $svc_x->recharge (\%vhash);
1463     return { 'error' => $error } if $error;
1464   }
1465
1466   return { error => '', svc => $cust_svc->part_svc->svc };
1467
1468 }
1469
1470 sub _do_bop_realtime {
1471   my ($cust_main, $status) = (shift, shift);
1472
1473     my $old_balance = $cust_main->balance;
1474
1475     my $bill_error =    $cust_main->bill
1476                      || $cust_main->apply_payments_and_credits
1477                      || $cust_main->realtime_collect('selfservice' => 1);
1478
1479     if (    $cust_main->balance > $old_balance
1480          && $cust_main->balance > 0
1481          && ( $cust_main->payby !~ /^(BILL|DCRD|DCHK)$/ ?
1482               1 : $status eq 'suspended' ) ) {
1483       #this makes sense.  credit is "un-doing" the invoice
1484       my $conf = new FS::Conf;
1485       $cust_main->credit( sprintf("%.2f", $cust_main->balance - $old_balance ),
1486                           'self-service decline',
1487                           'reason_type' => $conf->config('signup_credit_type'),
1488                         );
1489       $cust_main->apply_credits( 'order' => 'newest' );
1490
1491       return { 'error' => '_decline', 'bill_error' => $bill_error };
1492     }
1493
1494     '';
1495 }
1496
1497 sub renew_info {
1498   my $p = shift;
1499
1500   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1501   return { 'error' => $session } if $context eq 'error';
1502
1503   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1504     or return { 'error' => "unknown custnum $custnum" };
1505
1506   my @cust_pkg = sort { $a->bill <=> $b->bill }
1507                  grep { $_->part_pkg->freq ne '0' }
1508                  $cust_main->ncancelled_pkgs;
1509
1510   #return { 'error' => 'No active packages to renew.' } unless @cust_pkg;
1511
1512   my $total = $cust_main->balance;
1513
1514   my @array = map {
1515                     my $bill = $_->bill;
1516                     $total += $_->part_pkg->base_recur($_, \$bill);
1517                     my $renew_date = $_->part_pkg->add_freq($_->bill);
1518                     {
1519                       'pkgnum'             => $_->pkgnum,
1520                       'amount'             => sprintf('%.2f', $total),
1521                       'bill_date'          => $_->bill,
1522                       'bill_date_pretty'   => time2str('%x', $_->bill),
1523                       'renew_date'         => $renew_date,
1524                       'renew_date_pretty'  => time2str('%x', $renew_date),
1525                       'expire_date'        => $_->expire,
1526                       'expire_date_pretty' => time2str('%x', $_->expire),
1527                     };
1528                   }
1529                   @cust_pkg;
1530
1531   return { 'dates' => \@array };
1532
1533 }
1534
1535 sub payment_info_renew_info {
1536   my $p = shift;
1537   my $renew_info   = renew_info($p);
1538   my $payment_info = payment_info($p);
1539   return { %$renew_info,
1540            %$payment_info,
1541          };
1542 }
1543
1544 sub order_renew {
1545   my $p = shift;
1546
1547   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1548   return { 'error' => $session } if $context eq 'error';
1549
1550   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1551     or return { 'error' => "unknown custnum $custnum" };
1552
1553   my $date = $p->{'date'};
1554
1555   my $now = time;
1556
1557   #freeside-daily -n -d $date fs_daily $custnum
1558   $cust_main->bill_and_collect( 'time'         => $date,
1559                                 'invoice_time' => $now,
1560                                 'actual_time'  => $now,
1561                                 'check_freq'   => '1d',
1562                               );
1563
1564   return { 'error' => '' };
1565
1566 }
1567
1568 # these are basically the same
1569 sub cancel_pkg    { alter_pkg(shift, 'cancel', 'quiet' => 1) }
1570 sub suspend_pkg   {
1571   my $conf = new FS::Conf;
1572   my $reasonnum = $conf->config('selfservice-self_suspend_reason')
1573     or return { 'error' => "Permission denied" };
1574   alter_pkg(shift, 'suspend', 'reason' => $reasonnum)
1575 }
1576
1577 sub alter_pkg {
1578   my $p = shift;
1579   my $method = shift;
1580   my $session = _cache->get($p->{'session_id'})
1581     or return { 'error' => "Can't resume session" }; #better error message
1582
1583   my $custnum = $session->{'custnum'};
1584
1585   my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1586     or return { 'error' => "unknown custnum $custnum" };
1587
1588   my $pkgnum = $p->{'pkgnum'};
1589
1590   my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
1591                                         'pkgnum'  => $pkgnum,   } )
1592     or return { 'error' => "unknown pkgnum $pkgnum" };
1593
1594   my $error = $cust_pkg->$method(@_);
1595   return { 'error' => $error };
1596
1597 }
1598
1599 sub provision_phone {
1600  my $p = shift;
1601  my @bulkdid;
1602  @bulkdid = @{$p->{'bulkdid'}} if $p->{'bulkdid'};
1603
1604 # single DID LNP
1605  unless($p->{'lnp'}) {
1606     $p->{'lnp_desired_due_date'} = parse_datetime($p->{'lnp_desired_due_date'});
1607     $p->{'lnp_status'} = "portingin";
1608     return _provision( 'FS::svc_phone',
1609                   [qw(lnp_desired_due_date lnp_other_provider
1610                     lnp_other_provider_account phonenum countrycode lnp_status)],
1611                   [qw(phonenum countrycode)],
1612                   $p,
1613                   @_
1614                 );
1615  }
1616
1617 # single DID order
1618  unless (scalar(@bulkdid)) {
1619     return _provision( 'FS::svc_phone',
1620                   [qw(phonenum countrycode)],
1621                   [qw(phonenum countrycode)],
1622                   $p,
1623                   @_
1624                 );
1625  }
1626
1627 # bulk DID order case
1628   my $error;
1629   foreach my $did ( @bulkdid ) {
1630     $did =~ s/[^0-9]//g;
1631     $error = _provision( 'FS::svc_phone',
1632               [qw(phonenum countrycode)],
1633               [qw(phonenum countrycode)],
1634               {
1635                 'pkgnum' => $p->{'pkgnum'},
1636                 'svcpart' => $p->{'svcpart'},
1637                 'phonenum' => $did,
1638                 'countrycode' => $p->{'countrycode'},
1639                 'session_id' => $p->{'session_id'},
1640               }
1641             );
1642     return $error if ($error->{'error'} && length($error->{'error'}) > 1);
1643   }
1644   { 'bulkdid' => [ @bulkdid ], 'svc' => $error->{'svc'} }
1645 }
1646
1647 sub provision_acct {
1648   my $p = shift;
1649   warn "provision_acct called\n"
1650     if $DEBUG;
1651
1652   return { 'error' => gettext('passwords_dont_match') }
1653     if $p->{'_password'} ne $p->{'_password2'};
1654   return { 'error' => gettext('empty_password') }
1655     unless length($p->{'_password'});
1656
1657   if ($p->{'domsvc'}) {
1658     my %domains = domain_select_hash FS::svc_acct(map { $_ => $p->{$_} }
1659                                                   qw ( svcpart pkgnum ) );
1660     return { 'error' => gettext('invalid_domain') }
1661       unless ($domains{$p->{'domsvc'}});
1662   }
1663
1664   warn "provision_acct calling _provision\n"
1665     if $DEBUG;
1666   _provision( 'FS::svc_acct',
1667               [qw(username _password domsvc)],
1668               [qw(username _password domsvc)],
1669               $p,
1670               @_
1671             );
1672 }
1673
1674 sub provision_external {
1675   my $p = shift;
1676   #_provision( 'FS::svc_external', [qw(id title)], [qw(id title)], $p, @_ );
1677   _provision( 'FS::svc_external',
1678               [],
1679               [qw(id title)],
1680               $p,
1681               @_
1682             );
1683 }
1684
1685 sub _provision {
1686   my( $class, $fields, $return_fields, $p ) = splice(@_, 0, 4);
1687   warn "_provision called for $class\n"
1688     if $DEBUG;
1689
1690   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1691   return { 'error' => $session } if $context eq 'error';
1692
1693   my $search = { 'custnum' => $custnum };
1694   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1695   my $cust_main = qsearchs('cust_main', $search )
1696     or return { 'error' => "unknown custnum $custnum" };
1697
1698   my $pkgnum = $p->{'pkgnum'};
1699
1700   warn "searching for custnum $custnum pkgnum $pkgnum\n"
1701     if $DEBUG;
1702   my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
1703                                         'pkgnum'  => $pkgnum,
1704                                                                } )
1705     or return { 'error' => "unknown pkgnum $pkgnum" };
1706
1707   warn "searching for svcpart ". $p->{'svcpart'}. "\n"
1708     if $DEBUG;
1709   my $part_svc = qsearchs('part_svc', { 'svcpart' => $p->{'svcpart'} } )
1710     or return { 'error' => "unknown svcpart $p->{'svcpart'}" };
1711
1712   warn "creating $class record\n"
1713     if $DEBUG;
1714   my $svc_x = $class->new( {
1715     'pkgnum'  => $p->{'pkgnum'},
1716     'svcpart' => $p->{'svcpart'},
1717     map { $_ => $p->{$_} } @$fields
1718   } );
1719   warn "inserting $class record\n"
1720     if $DEBUG;
1721   my $error = $svc_x->insert;
1722
1723   unless ( $error ) {
1724     warn "finding inserted record for svcnum ". $svc_x->svcnum. "\n"
1725       if $DEBUG;
1726     $svc_x = qsearchs($svc_x->table, { 'svcnum' => $svc_x->svcnum })
1727   }
1728
1729   my $return = { 'svc'   => $part_svc->svc,
1730                  'error' => $error,
1731                  map { $_ => $svc_x->get($_) } @$return_fields
1732                };
1733   warn "_provision returning ". Dumper($return). "\n"
1734     if $DEBUG;
1735   return $return;
1736
1737 }
1738
1739 sub part_svc_info {
1740   my $p = shift;
1741
1742   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1743   return { 'error' => $session } if $context eq 'error';
1744
1745   my $search = { 'custnum' => $custnum };
1746   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1747   my $cust_main = qsearchs('cust_main', $search )
1748     or return { 'error' => "unknown custnum $custnum" };
1749
1750   my $pkgnum = $p->{'pkgnum'};
1751
1752   my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
1753                                         'pkgnum'  => $pkgnum,
1754                                                                } )
1755     or return { 'error' => "unknown pkgnum $pkgnum" };
1756
1757   my $svcpart = $p->{'svcpart'};
1758
1759   my $pkg_svc = qsearchs('pkg_svc', { 'pkgpart' => $cust_pkg->pkgpart,
1760                                       'svcpart' => $svcpart,           } )
1761     or return { 'error' => "unknown svcpart $svcpart for pkgnum $pkgnum" };
1762   my $part_svc = $pkg_svc->part_svc;
1763
1764   my $conf = new FS::Conf;
1765
1766   return {
1767     'svc'     => $part_svc->svc,
1768     'svcdb'   => $part_svc->svcdb,
1769     'pkgnum'  => $pkgnum,
1770     'svcpart' => $svcpart,
1771     'custnum' => $custnum,
1772
1773     'security_phrase' => 0, #XXX !
1774     'svc_acct_pop'    => [], #XXX !
1775     'popnum'          => '',
1776     'init_popstate'   => '',
1777     'popac'           => '',
1778     'acstate'         => '',
1779
1780     'small_custview' =>
1781       small_custview( $cust_main, $conf->config('countrydefault') ),
1782
1783   };
1784
1785 }
1786
1787 sub unprovision_svc {
1788   my $p = shift;
1789
1790   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1791   return { 'error' => $session } if $context eq 'error';
1792
1793   my $search = { 'custnum' => $custnum };
1794   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1795   my $cust_main = qsearchs('cust_main', $search )
1796     or return { 'error' => "unknown custnum $custnum" };
1797
1798   my $svcnum = $p->{'svcnum'};
1799
1800   my $cust_svc = qsearchs('cust_svc', { 'svcnum'  => $svcnum, } )
1801     or return { 'error' => "unknown svcnum $svcnum" };
1802
1803   return { 'error' => "Service $svcnum does not belong to customer $custnum" }
1804     unless $cust_svc->cust_pkg->custnum == $custnum;
1805
1806   my $conf = new FS::Conf;
1807
1808   return { 'svc'   => $cust_svc->part_svc->svc,
1809            'error' => $cust_svc->cancel,
1810            'small_custview' =>
1811              small_custview( $cust_main, $conf->config('countrydefault') ),
1812          };
1813
1814 }
1815
1816 sub myaccount_passwd {
1817   my $p = shift;
1818   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1819   return { 'error' => $session } if $context eq 'error';
1820
1821   return { 'error' => "New passwords don't match." }
1822     if $p->{'new_password'} ne $p->{'new_password2'};
1823
1824   return { 'error' => 'Enter new password' }
1825     unless length($p->{'new_password'});
1826
1827   #my $search = { 'custnum' => $custnum };
1828   #$search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1829   $custnum =~ /^(\d+)$/ or die "illegal custnum";
1830   my $search = " AND custnum = $1";
1831   $search .= " AND agentnum = ". $session->{'agentnum'} if $context eq 'agent';
1832
1833   my $svc_acct = qsearchs( {
1834     'table'     => 'svc_acct',
1835     'addl_from' => 'LEFT JOIN cust_svc  USING ( svcnum  ) '.
1836                    'LEFT JOIN cust_pkg  USING ( pkgnum  ) '.
1837                    'LEFT JOIN cust_main USING ( custnum ) ',
1838     'hashref'   => { 'svcnum' => $p->{'svcnum'}, },
1839     'extra_sql' => $search, #important
1840   } )
1841     or return { 'error' => "Service not found" };
1842
1843   $svc_acct->_password($p->{'new_password'});
1844   my $error = $svc_acct->replace();
1845
1846   my($label, $value) = $svc_acct->cust_svc->label;
1847
1848   return { 'error' => $error,
1849            'label' => $label,
1850            'value' => $value,
1851          };
1852
1853 }
1854
1855 sub create_ticket {
1856   my $p = shift;
1857   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1858   return { 'error' => $session } if $context eq 'error';
1859
1860   warn "$me create_ticket: initializing ticket system\n" if $DEBUG;
1861   FS::TicketSystem->init();
1862
1863   my $conf = new FS::Conf;
1864   my $queue = $p->{'queue'}
1865               || $conf->config('ticket_system-selfservice_queueid')
1866               || $conf->config('ticket_system-default_queueid');
1867
1868   warn "$me create_ticket: creating ticket\n" if $DEBUG;
1869   my $err_or_ticket = FS::TicketSystem->create_ticket(
1870     '', #create RT session based on FS CurrentUser (fs_selfservice)
1871     'queue'   => $queue,
1872     'custnum' => $custnum,
1873     'svcnum'  => $session->{'svcnum'},
1874     map { $_ => $p->{$_} } qw( requestor cc subject message mime_type )
1875   );
1876
1877   if ( ref($err_or_ticket) ) {
1878     warn "$me create_ticket: sucessful: ". $err_or_ticket->id. "\n"
1879       if $DEBUG;
1880     return { 'error'     => '',
1881              'ticket_id' => $err_or_ticket->id,
1882            };
1883   } else {
1884     warn "$me create_ticket: unsucessful: $err_or_ticket\n"
1885       if $DEBUG;
1886     return { 'error' => $err_or_ticket };
1887   }
1888
1889
1890 }
1891
1892 sub did_report {
1893   my $p = shift;
1894   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1895   return { 'error' => $session } if $context eq 'error';
1896
1897   return { error => 'requested format not implemented' }
1898     unless ($p->{'format'} eq 'csv' || $p->{'format'} eq 'xls');
1899
1900   my $conf = new FS::Conf;
1901   my $age_threshold = 0;
1902   $age_threshold = time() - $conf->config('selfservice-recent-did-age')
1903     if ($p->{'recentonly'} && $conf->exists('selfservice-recent-did-age'));
1904
1905   my $search = { 'custnum' => $custnum };
1906   $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1907   my $cust_main = qsearchs('cust_main', $search )
1908     or return { 'error' => "unknown custnum $custnum" };
1909
1910 # does it make more sense to just run one sql query for this instead of all the
1911 # insanity below? would increase performance greately for large data sets?
1912   my @svc_phone = ();
1913   foreach my $cust_pkg ( $cust_main->ncancelled_pkgs ) {
1914         my @part_svc = $cust_pkg->part_svc;
1915         foreach my $part_svc ( @part_svc ) {
1916             if($part_svc->svcdb eq 'svc_phone'){
1917                 my @cust_pkg_svc = @{$part_svc->cust_pkg_svc};
1918                 foreach my $cust_pkg_svc ( @cust_pkg_svc ) {
1919                     push @svc_phone, $cust_pkg_svc->svc_x
1920                         if $cust_pkg_svc->date_inserted >= $age_threshold;
1921                 }
1922             }
1923         }
1924   }
1925
1926   my $csv;
1927   my $xls;
1928   my($xls_r,$xls_c) = (0,0);
1929   my $xls_workbook;
1930   my $content = '';
1931   my @fields = qw( countrycode phonenum pin sip_password phone_name );
1932   if($p->{'format'} eq 'csv') {
1933     $csv = new Text::CSV_XS { 'always_quote' => 1,
1934                                  'eol'          => "\n",
1935                                 };
1936     return { 'error' => 'Unable to create CSV' } unless $csv->combine(@fields);
1937     $content .= $csv->string;
1938   }
1939   elsif($p->{'format'} eq 'xls') {
1940     my $XLS1 = new IO::Scalar \$content;
1941     $xls_workbook = Spreadsheet::WriteExcel->new($XLS1)
1942         or return { 'error' => "Error opening .xls file: $!" };
1943     $xls = $xls_workbook->add_worksheet('DIDs');
1944     foreach ( @fields ) {
1945         $xls->write(0,$xls_c++,$_);
1946     }
1947     $xls_r++;
1948   }
1949
1950   foreach my $svc_phone ( @svc_phone ) {
1951     my @cols = map { $svc_phone->$_ } @fields;
1952     if($p->{'format'} eq 'csv') {
1953         return { 'error' => 'Unable to create CSV' }
1954             unless $csv->combine(@cols);
1955         $content .= $csv->string;
1956     }
1957     elsif($p->{'format'} eq 'xls') {
1958         $xls_c = 0;
1959         foreach ( @cols ) {
1960             $xls->write($xls_r,$xls_c++,$_);
1961         }
1962         $xls_r++;
1963     }
1964   }
1965
1966   $xls_workbook->close() if $p->{'format'} eq 'xls';
1967
1968   { content => $content, format => $p->{'format'}, };
1969 }
1970
1971 sub get_ticket {
1972   my $p = shift;
1973   my($context, $session, $custnum) = _custoragent_session_custnum($p);
1974   return { 'error' => $session } if $context eq 'error';
1975
1976   warn "$me get_ticket: initializing ticket system\n" if $DEBUG;
1977   FS::TicketSystem->init();
1978
1979   if(length($p->{'reply'})) {
1980 # currently this allows anyone to correspond on any ticket as fs_selfservice
1981 # probably bad...
1982       my @err_or_res = FS::TicketSystem->correspond_ticket(
1983         '', #create RT session based on FS CurrentUser (fs_selfservice)
1984         'ticket_id' => $p->{'ticket_id'},
1985         'content' => $p->{'reply'},
1986       );
1987
1988     return { 'error' => 'unable to reply to ticket' }
1989         unless ( $err_or_res[0] != 0 && defined $err_or_res[2] );
1990   }
1991
1992   warn "$me get_ticket: getting ticket\n" if $DEBUG;
1993   my $err_or_ticket = FS::TicketSystem->get_ticket(
1994     '', #create RT session based on FS CurrentUser (fs_selfservice)
1995     'ticket_id' => $p->{'ticket_id'},
1996   );
1997
1998   if ( ref($err_or_ticket) ) {
1999
2000 # since we're bypassing the RT security/permissions model by always using
2001 # fs_selfservice as the RT user (as opposed to a requestor, which we
2002 # can't do since we want all tickets linked to a cust), we check below whether
2003 # the requested ticket was actually linked to this customer
2004     my @custs = @{$err_or_ticket->{'custs'}};
2005     my @txns = @{$err_or_ticket->{'txns'}};
2006     my @filtered_txns;
2007
2008     return { 'error' => 'no customer' } unless ( $custnum && scalar(@custs) );
2009
2010     return { 'error' => 'invalid ticket requested' }
2011         unless grep($_ eq $custnum, @custs);
2012
2013     foreach my $txn ( @txns ) {
2014         push @filtered_txns, $txn
2015             if ($txn->{'type'} eq 'EmailRecord'
2016                 || $txn->{'type'} eq 'Correspond'
2017                 || $txn->{'type'} eq 'Create');
2018     }
2019
2020     warn "$me get_ticket: sucessful: \n"
2021       if $DEBUG;
2022     return { 'error'     => '',
2023              'transactions' => \@filtered_txns,
2024              'ticket_id' => $p->{'ticket_id'},
2025            };
2026   } else {
2027     warn "$me create_ticket: unsucessful: $err_or_ticket\n"
2028       if $DEBUG;
2029     return { 'error' => $err_or_ticket };
2030   }
2031 }
2032
2033
2034 #--
2035
2036 sub _custoragent_session_custnum {
2037   my $p = shift;
2038
2039   my($context, $session, $custnum);
2040   if ( $p->{'session_id'} ) {
2041
2042     $context = 'customer';
2043     $session = _cache->get($p->{'session_id'})
2044       or return ( 'error' => "Can't resume session" ); #better error message
2045     $custnum = $session->{'custnum'};
2046
2047   } elsif ( $p->{'agent_session_id'} ) {
2048
2049     $context = 'agent';
2050     my $agent_cache = new FS::ClientAPI_SessionCache( {
2051       'namespace' => 'FS::ClientAPI::Agent',
2052     } );
2053     $session = $agent_cache->get($p->{'agent_session_id'})
2054       or return ( 'error' => "Can't resume session" ); #better error message
2055     $custnum = $p->{'custnum'};
2056
2057   } else {
2058     $context = 'error';
2059     return ( 'error' => "Can't resume session" ); #better error message
2060   }
2061
2062   ($context, $session, $custnum);
2063
2064 }
2065
2066 1;
2067