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