1 package FS::ClientAPI::MyAccount;
3 use 5.008; #require 5.8+ for Time::Local 1.05+
5 use vars qw( $cache $DEBUG $me );
6 use subs qw( _cache _provision );
9 use Digest::MD5 qw(md5_hex);
10 use Digest::SHA qw(sha512_hex);
13 use Time::Local qw(timelocal_nocheck);
14 use Business::CreditCard 0.35;
17 use Spreadsheet::WriteExcel;
18 use OLE::Storage_Lite;
19 use FS::UI::Web::small_custview qw(small_custview); #less doh
21 use FS::UI::bytecount qw( display_bytecount );
24 use FS::Record qw(qsearch qsearchs dbh);
25 use FS::Msgcat qw(gettext);
26 use FS::Misc qw(card_types money_pretty);
27 use FS::Misc::DateTime qw(parse_datetime);
29 use FS::ClientAPI_SessionCache;
41 use FS::legacy_cust_bill;
42 use FS::cust_main_county;
46 use FS::acct_rt_transaction;
50 use FS::cust_location;
53 # for code organization
54 use FS::ClientAPI::MyAccount::contact;
55 use FS::ClientAPI::MyAccount::quotation;
58 $me = '[FS::ClientAPI::MyAccount]';
60 use vars qw( @cust_main_editable_fields @location_editable_fields );
61 @cust_main_editable_fields = qw(
62 first last company daytime night fax mobile
64 ss stateid stateid_state
66 @location_editable_fields = qw(
67 address1 address2 city county state zip country
71 BEGIN { #preload to reduce time customer_info takes
72 if ( $FS::TicketSystem::system ) {
73 warn "$me: initializing ticket system\n" if $DEBUG;
74 FS::TicketSystem->init();
79 $cache ||= new FS::ClientAPI_SessionCache( {
80 'namespace' => 'FS::ClientAPI::MyAccount',
87 my($context, $session, $custnum) = _custoragent_session_custnum($p);
88 #return { 'error' => $session } if $context eq 'error';
91 if ( $context eq 'customer' && $custnum ) {
93 my $sth = dbh->prepare('SELECT agentnum FROM cust_main WHERE custnum = ?')
96 $sth->execute($custnum) or die $sth->errstr;
98 $agentnum = $sth->fetchrow_arrayref->[0]
99 or die "no agentnum for custnum $custnum";
101 #} elsif ( $context eq 'agent' ) {
102 } elsif ( defined($p->{'agentnum'}) and $p->{'agentnum'} =~ /^(\d+)$/ ) {
105 $p->{'agentnum'} = $agentnum;
107 my $conf = new FS::Conf;
109 #false laziness w/Signup.pm
111 my $skin_info_cache_agent = _cache->get("skin_info_cache_agent$agentnum");
113 if ( $skin_info_cache_agent ) {
115 warn "$me loading cached skin info for agentnum $agentnum\n"
120 warn "$me populating skin info cache for agentnum $agentnum\n"
123 $skin_info_cache_agent = {
124 'agentnum' => $agentnum,
125 ( map { $_ => scalar( $conf->config($_, $agentnum) ) }
126 qw( company_name date_format ) ),
127 ( map { $_ => scalar( $conf->config("selfservice-$_", $agentnum ) ) }
128 qw( body_bgcolor box_bgcolor stripe1_bgcolor stripe2_bgcolor
129 text_color link_color vlink_color hlink_color alink_color
130 font title_color title_align title_size menu_bgcolor menu_fontsize
133 'menu_disable' => [ $conf->config('selfservice-menu_disable',$agentnum) ],
134 ( map { $_ => $conf->exists("selfservice-$_", $agentnum ) }
135 qw( menu_skipblanks menu_skipheadings menu_nounderline no_logo enable_payment_without_balance )
137 ( map { $_ => scalar($conf->config_binary("selfservice-$_", $agentnum)) }
138 qw( title_left_image title_right_image
139 menu_top_image menu_body_image menu_bottom_image
142 'logo' => scalar($conf->config_binary('logo.png', $agentnum )),
143 ( map { $_ => join("\n", $conf->config("selfservice-$_", $agentnum ) ) }
144 qw( head body_header body_footer company_address ) ),
145 'money_char' => $conf->config("money_char") || '$',
146 'menu' => join("\n", $conf->config("ng_selfservice-menu", $agentnum ) ) ||
149 services.php Services
150 services.php My Services
151 services_new.php Order a new service
154 personal.php Personal Information
155 password.php Change Password
158 payment_cc.php Credit Card Payment
159 payment_ach.php Electronic Check Payment
160 payment_paypal.php PayPal Payment
161 payment_webpay.php Webpay Payments
164 usage_data.php Data usage
165 usage_cdr.php Call usage
167 tickets.php Help Desk
168 tickets.php Open Tickets
169 tickets_resolved.php Resolved Tickets
170 ticket_create.php Create a new ticket
178 _cache->set("skin_info_cache_agent$agentnum", $skin_info_cache_agent);
182 #{ %$skin_info_cache_agent };
183 $skin_info_cache_agent;
190 my $conf = new FS::Conf;
194 'phone_login' => $conf->exists('selfservice_server-phone_login'),
195 'single_domain'=> scalar($conf->config('selfservice_server-single_domain')),
196 'banner_url' => scalar($conf->config('selfservice-login_banner_url')),
197 'banner_image_md5' =>
198 md5_hex($conf->config_binary('selfservice-login_banner_image')),
205 sub login_banner_image {
207 my $conf = new FS::Conf;
208 my $image = $conf->config_binary('selfservice-login_banner_image');
210 'md5' => md5_hex($image),
215 #false laziness w/FS::ClientAPI::passwd::passwd
219 my $conf = new FS::Conf;
223 if ( $p->{'domain'} eq 'svc_phone'
224 && $conf->exists('selfservice_server-phone_login') ) {
226 my $svc_phone = qsearchs( 'svc_phone', { 'phonenum' => $p->{'username'} } );
227 return { error => 'Number not found.' } unless $svc_phone;
230 #my $pkg_svc = $svc_acct->cust_svc->pkg_svc;
231 #return { error => 'Only primary user may log in.' }
232 # if $conf->exists('selfservice_server-primary_only')
233 # && ( ! $pkg_svc || $pkg_svc->primary_svc ne 'Y' );
235 return { error => 'Incorrect PIN.' }
236 unless $svc_phone->check_pin($p->{'password'});
240 } elsif ( $p->{email}
241 && (my $contact = FS::contact->by_selfservice_email($p->{email}))
244 return { error => 'Incorrect contact password.' }
245 unless $contact->authenticate_password($p->{'password'});
247 $session->{'contactnum'} = $contact->contactnum;
249 my @cust_contact = grep $_->selfservice_access, $contact->cust_contact;
250 if ( scalar(@cust_contact) == 1 ) {
251 $session->{'custnum'} = $cust_contact[0]->custnum;
252 } elsif ( scalar(@cust_contact) ) {
253 $session->{'customers'} = { map { $_->custnum => $_->cust_main->name }
257 return { error => 'No customer self-service access for contact' }; #??
262 ( $p->{username}, $p->{domain} ) = split('@', $p->{email}) if $p->{email};
264 my $svc_domain = qsearchs('svc_domain', { 'domain' => $p->{'domain'} } )
265 or return { error => 'Domain '. $p->{'domain'}. ' not found' };
267 my @svc_acct = qsearch( 'svc_acct', { 'username' => $p->{'username'},
268 'domsvc' => $svc_domain->svcnum, }
271 if ( $conf->exists('selfservice_server-login_svcpart') ) {
272 my @svcpart = $conf->config('selfservice_server-login_svcpart');
273 @svc_acct = grep { my $svcpart = $_->cust_svc->svcpart;
274 scalar( grep( $_ eq $svcpart, @svcpart ) );
279 if ( $conf->exists('selfservice_server-primary_only') ) {
282 my $cust_svc = $_->cust_svc;
283 $cust_svc->cust_pkg->part_pkg->svcpart([qw( svc_acct svc_phone )])
284 == $cust_svc->svcpart
289 return { error => 'User not found.' } unless @svc_acct;
291 return { error => 'Multiple users.' } if scalar(@svc_acct) > 1;
293 my $svc_acct = $svc_acct[0];
295 if ( $conf->exists('selfservice_server-login_svcpart') ) {
296 my @svcpart = $conf->config('selfservice_server-login_svcpart');
297 my $svcpart = $svc_acct->cust_svc->svcpart;
298 return { error => 'Invalid user.' }
299 unless grep($_ eq $svcpart, @svcpart);
302 return { error => 'Incorrect password.' }
303 unless $svc_acct->check_password($p->{'password'});
311 $session->{'svcnum'} = $svc_x->svcnum;
313 my $cust_svc = $svc_x->cust_svc;
314 my $cust_pkg = $cust_svc->cust_pkg;
316 my $cust_main = $cust_pkg->cust_main;
317 $session->{'custnum'} = $cust_main->custnum;
318 if ( $conf->exists('pkg-balances') ) {
319 my @cust_pkg = grep { $_->part_pkg->freq !~ /^(0|$)/ }
320 $cust_main->ncancelled_pkgs;
321 $session->{'pkgnum'} = $cust_pkg->pkgnum
322 if scalar(@cust_pkg) > 1;
326 #my $pkg_svc = $svc_acct->cust_svc->pkg_svc;
327 #return { error => 'Only primary user may log in.' }
328 # if $conf->exists('selfservice_server-primary_only')
329 # && ( ! $pkg_svc || $pkg_svc->primary_svc ne 'Y' );
330 my $part_pkg = $cust_pkg->part_pkg;
331 return { error => 'Only primary user may log in.' }
332 if $conf->exists('selfservice_server-primary_only')
333 && $cust_svc->svcpart != $part_pkg->svcpart([qw( svc_acct svc_phone )]);
339 $session_id = sha512_hex(time(). {}. rand(). $$)
340 } until ( ! defined _cache->get($session_id) ); #just in case
342 my $timeout = $conf->config('selfservice-session_timeout') || '1 hour';
343 _cache->set( $session_id, $session, $timeout );
345 return { 'error' => '',
346 'session_id' => $session_id,
353 my $skin_info = skin_info($p);
354 if ( $p->{'session_id'} ) {
355 _cache->remove($p->{'session_id'});
356 return { %$skin_info, 'error' => '' };
358 return { %$skin_info, 'error' => "Can't resume session" }; #better error message
365 my($context, $session, $custnum) = _custoragent_session_custnum($p);
366 return { 'error' => $session } if $context eq 'error';
368 my $svc_acct = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_acct' )
369 or return { 'error' => "Service not found" };
371 $session->{'svcnum'} = $svc_acct->svcnum;
373 my $conf = new FS::Conf;
374 my $timeout = $conf->config('selfservice-session_timeout') || '1 hour';
375 _cache->set( $p->{'session_id'}, $session, $timeout );
377 return { 'error' => '' };
383 my($context, $session, $custnum) = _custoragent_session_custnum($p);
384 return { 'error' => $session } if $context eq 'error';
386 $session->{'custnum'} = $p->{'custnum'}
387 if exists $session->{'customers'}{ $p->{'custnum'} };
389 my $conf = new FS::Conf;
390 my $timeout = $conf->config('selfservice-session_timeout') || '1 hour';
391 _cache->set( $p->{'session_id'}, $session, $timeout );
393 return { 'error' => '',
394 %{ customer_info( { session_id=>$p->{'session_id'} } ) },
398 sub payment_gateway {
400 # takes a cust_main and a cust_payby entry, returns the payment_gateway
401 my $conf = new FS::Conf;
402 my $cust_main = shift;
403 my $cust_payby = shift;
404 return '' if ! FS::payby->realtime($cust_payby);
405 my $pg = $cust_main->agent->payment_gateway(
406 'method' => FS::payby->payby2bop($cust_payby),
415 my $conf = new FS::Conf;
417 my $info = skin_info($p);
419 use vars qw( $cust_paybys ); #cache for performance
420 unless ( $cust_paybys ) {
422 my %cust_paybys = map { $_ => 1 }
423 map { FS::payby->payby2payment($_) }
424 $conf->config('signup_server-payby');
426 $cust_paybys = [ keys %cust_paybys ];
429 $info->{'cust_paybys'} = $cust_paybys;
431 my($context, $session, $custnum) = _custoragent_session_custnum($p);
432 return { 'error' => $session } if $context eq 'error';
434 my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } );
436 $info->{'hide_payment_fields'} = [
438 my $pg = $cust_main && payment_gateway($cust_main, $_);
439 $pg && $pg->gateway_namespace eq 'Business::OnlineThirdPartyPayment';
440 } @{ $info->{cust_paybys} }
443 $info->{'self_suspend_reason'} =
444 $conf->config('selfservice-self_suspend_reason',
445 $cust_main ? $cust_main->agentnum : ''
448 $info->{'edit_ticket_subject'} =
449 $conf->exists('ticket_system-selfservice_edit_subject') &&
450 $cust_main && $cust_main->edit_subject;
452 $info->{'timeout'} = $conf->config('selfservice-timeout') || 3600;
454 $info->{'hide_usage'} = $conf->exists('selfservice_hide-usage');
457 'custnum' => $custnum,
458 'access_pkgnum' => $session->{'pkgnum'},
459 'access_svcnum' => $session->{'svcnum'},
466 my($context, $session, $custnum) = _custoragent_session_custnum($p);
467 return { 'error' => $session } if $context eq 'error';
471 my $conf = new FS::Conf;
472 $return{'require_address2'} = $conf->exists('cust_main-require_address2');
474 # if ( $FS::TicketSystem::system ) {
475 # warn "$me customer_info: initializing ticket system\n" if $DEBUG;
476 # FS::TicketSystem->init();
479 if ( $custnum ) { #customer record
481 %return = ( %return, %{ customer_info_short($p) } );
483 #redundant with customer_info_short, but we need it for several things below
484 my $search = { 'custnum' => $custnum };
485 $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
486 my $cust_main = qsearchs('cust_main', $search )
487 or return { 'error' => "customer_info: unknown custnum $custnum" };
489 my $list_tickets = list_tickets($p);
490 $return{'tickets'} = $list_tickets->{'tickets'};
492 if ( $session->{'pkgnum'} ) {
493 #XXX open invoices in the pkg-balances case
495 $return{'money_char'} = $conf->config("money_char") || '$';
498 invnum => $_->invnum,
499 date => time2str("%b %o, %Y", $_->_date),
501 charged => $_->charged,
503 } $cust_main->open_cust_bill;
504 $return{open_invoices} = \@open;
506 my $sql = 'SELECT MAX(_date) FROM cust_bill WHERE custnum = ?';
507 my $sth = dbh->prepare($sql) or die dbh->errstr;
508 $sth->execute($custnum) or die $sth->errstr;
509 $return{'last_invoice_date'} = $sth->fetchrow_arrayref->[0];
510 $return{'last_invoice_date_pretty'} =
511 time2str('%m/%d/%Y', $return{'last_invoice_date'} );
514 #customer_info_short always has nobalance on..
515 $return{small_custview} =
516 small_custview( $cust_main,
517 $return{countrydefault},
518 ( $session->{'pkgnum'} ? 1 : 0 ), #nobalance
521 $return{has_ship_address} = $cust_main->has_ship_address;
522 $return{status} = $cust_main->status_label; #$cust_main->status; #better to break anyone obscurely testing for strings in self-service than to have to upgrade every front-end to get the new status to display
523 $return{statuscolor} = $cust_main->statuscolor;
524 $return{status_label} = $cust_main->status_label;
526 # compatibility: some places in selfservice use this to determine
527 # if there's a ship address
528 if ( $return{has_ship_address} ) {
529 $return{ship_last} = $cust_main->last;
530 $return{ship_first} = $cust_main->first;
533 if (scalar($conf->config('support_packages'))) {
534 my @support_services = ();
535 foreach ($cust_main->support_services) {
536 my $seconds = $_->svc_x->seconds || 0;
537 my $time_remaining = (($seconds < 0) ? '-' : '' ).
538 int(abs($seconds)/3600)."h".
539 sprintf("%02d",(abs($seconds)%3600)/60)."m";
540 my $cust_pkg = $_->cust_pkg;
543 $pkgnum = $cust_pkg->pkgnum if $cust_pkg;
544 $pkg = $cust_pkg->part_pkg->pkg if $cust_pkg;
545 push @support_services, { svcnum => $_->svcnum,
546 time => $time_remaining,
551 $return{support_services} = \@support_services;
554 if ( $conf->config('prepayment_discounts-credit_type') ) {
556 $return{discount_terms_hash} = { $cust_main->discount_terms_hash };
559 } elsif ( $session->{'svcnum'} ) { #no customer record
561 my $svc_acct = qsearchs('svc_acct', { 'svcnum' => $session->{'svcnum'} } )
562 or die "unknown svcnum";
563 $return{name} = $svc_acct->email;
567 return { 'error' => 'Expired session' }; #XXX redirect to login w/this err!
571 return { 'error' => '',
572 'custnum' => $custnum,
578 sub customer_info_short {
581 my($context, $session, $custnum) = _custoragent_session_custnum($p);
582 return { 'error' => $session } if $context eq 'error';
586 my $conf = new FS::Conf;
588 if ( $custnum ) { #customer record
590 my $search = { 'custnum' => $custnum };
591 $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
592 my $cust_main = qsearchs('cust_main', $search )
593 or return { 'error' => "customer_info_short: unknown custnum $custnum" };
595 $return{display_custnum} = $cust_main->display_custnum;
596 $return{max_invnum} = $cust_main->max_invnum;
598 if ( $session->{'pkgnum'} ) {
599 $return{balance} = $cust_main->balance_pkgnum( $session->{'pkgnum'} );
600 #next_bill_date from cust_pkg?
602 $return{balance} = $cust_main->balance;
603 $return{next_bill_date} = $cust_main->next_bill_date;
604 $return{next_bill_date_pretty} =
605 $return{next_bill_date} ? time2str('%m/%d/%Y', $return{next_bill_date} )
608 $return{balance_pretty} = money_pretty($return{balance});
610 $return{countrydefault} = scalar($conf->config('countrydefault'));
612 $return{small_custview} =
613 small_custview( $cust_main,
614 $return{countrydefault},
618 $return{first} = $cust_main->first;
619 $return{'last'} = $cust_main->get('last');
620 $return{name} = $cust_main->first. ' '. $cust_main->get('last');
622 #none of these are terribly expensive if we want 'em...
623 for (@cust_main_editable_fields) {
624 $return{$_} = $cust_main->get($_);
626 #maybe a little more expensive, but it should be cached by now
627 for (@location_editable_fields) {
628 $return{$_} = $cust_main->bill_location->get($_)
629 if $cust_main->bill_locationnum;
630 $return{'ship_'.$_} = $cust_main->ship_location->get($_)
631 if $cust_main->ship_locationnum;
634 my @invoicing_list = $cust_main->invoicing_list;
635 $return{'invoicing_list'} =
636 join(', ', grep { $_ !~ /^(POST|FAX)$/ } @invoicing_list );
637 $return{'postal_invoicing'} =
638 0 < ( grep { $_ eq 'POST' } @invoicing_list );
640 if ( $session->{'svcnum'} ) {
641 my $cust_svc = qsearchs('cust_svc', { 'svcnum' => $session->{'svcnum'} });
642 $return{'svc_label'} = ($cust_svc->label)[1] if $cust_svc;
643 $return{'svcnum'} = $session->{'svcnum'};
646 } elsif ( $session->{'svcnum'} ) { #no customer record
648 #uuh, not supproted yet... die?
649 return { 'error' => 'customer_info_short not yet supported as agent' };
653 return { 'error' => 'Expired session' }; #XXX redirect to login w/this err!
657 # this is here because this routine is called by both fs_ and ng_ main pages, where it appears
658 # it is not customer-specific, though it is only shown to authenticated customers
659 # it is not currently agent-specific, though at some point it might be
660 $return{'announcement'} = join(' ',$conf->config('selfservice-announcement')) || '';
662 return { 'error' => '',
663 'custnum' => $custnum,
668 sub customer_recurring {
671 my($context, $session, $custnum) = _custoragent_session_custnum($p);
672 return { 'error' => $session } if $context eq 'error';
676 my $conf = new FS::Conf;
678 my $search = { 'custnum' => $custnum };
679 $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
680 my $cust_main = qsearchs('cust_main', $search )
681 or return { 'error' => "customer_info_short: unknown custnum $custnum" };
683 $return{'display_recurring'} = [ $cust_main->display_recurring ];
685 return { 'error' => '',
686 'custnum' => $custnum,
691 sub billing_history {
694 my($context, $session, $custnum) = _custoragent_session_custnum($p);
695 return { 'error' => $session } if $context eq 'error';
697 return { 'error' => 'No customer' } unless $custnum;
699 my $search = { 'custnum' => $custnum };
700 $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
701 my $cust_main = qsearchs('cust_main', $search )
702 or return { 'error' => "unknown custnum $custnum" };
706 if ( $session->{'pkgnum'} ) {
707 #$return{balance} = $cust_main->balance_pkgnum( $session->{'pkgnum'} );
708 #next_bill_date from cust_pkg?
709 return { 'error' => 'No history for package' };
712 $return{balance} = $cust_main->balance;
713 $return{balance_pretty} = money_pretty($return{balance});
714 $return{next_bill_date} = $cust_main->next_bill_date;
715 $return{next_bill_date_pretty} =
716 $return{next_bill_date} ? time2str('%m/%d/%Y', $return{next_bill_date} )
719 my $conf = new FS::Conf;
721 $return{'history'} = [
722 $cust_main->payment_history(
723 'line_items' => $conf->exists('selfservice-billing_history-line_items'),
728 $return{'money_char'} = $conf->config("money_char") || '$',
736 my $session = _cache->get($p->{'session_id'})
737 or return { 'error' => "Can't resume session" }; #better error message
739 my $custnum = $session->{'custnum'}
740 or return { 'error' => "no customer record" };
742 my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
743 or return { 'error' => "unknown custnum $custnum" };
745 my $conf = new FS::Conf;
746 if (($p->{payby} eq "CHEK" || $p->{payby} eq "DCHEK") && $conf->exists('selfservice-ACH_info_readonly')) {
747 return { 'error' => "You do not have authority to add a bank account" };
750 my $new = new FS::cust_main { $cust_main->hash };
752 $new->set( $_ => $p->{$_} )
753 foreach grep { exists $p->{$_} } @cust_main_editable_fields;
755 if ( exists($p->{address1}) ) {
756 my $bill_location = FS::cust_location->new({
757 map { $_ => $p->{$_} } @location_editable_fields
759 # if this is unchanged from before, cust_main::replace will ignore it
760 $new->set('bill_location' => $bill_location);
763 if ( exists($p->{ship_address1}) ) {
764 my $ship_location = FS::cust_location->new({
765 map { $_ => $p->{"ship_$_"} } @location_editable_fields
767 if ( !grep { length($p->{"ship_$_"}) } @location_editable_fields ) {
768 # Selfservice unfortunately tries to indicate "same as billing
769 # address" by sending all fields empty. Did this ever work?
770 $ship_location = $cust_main->bill_location;
772 $new->set('ship_location' => $ship_location);
774 # but if it hasn't been passed in at all, leave ship_location alone--
775 # DON'T change it to match bill_location.
778 if ( exists $p->{'invoicing_list'} || exists $p->{'postal_invoicing'} ) {
779 #false laziness with httemplate/edit/process/cust_main.cgi
780 @invoicing_list = split( /\s*\,\s*/, $p->{'invoicing_list'} );
781 push @invoicing_list, 'POST' if $p->{'postal_invoicing'};
783 @invoicing_list = $cust_main->invoicing_list;
786 my $error = $new->replace($cust_main, \@invoicing_list);
787 return { 'error' => $error } if $error;
790 return { 'error' => '' };
795 my $session = _cache->get($p->{'session_id'})
796 or return { 'error' => "Can't resume session" }; #better error message
802 my $conf = new FS::Conf;
803 use vars qw($payment_info); #cache for performance
804 unless ( $payment_info ) {
806 my %states = map { $_->state => 1 }
807 qsearch('cust_main_county', {
808 'country' => $conf->config('countrydefault') || 'US'
811 my %cust_paybys = map { $_ => 1 }
812 map { FS::payby->payby2payment($_) }
813 $conf->config('signup_server-payby');
815 my @cust_paybys = keys %cust_paybys;
819 #list all counties/states/countries
820 'cust_main_county' =>
821 [ map { $_->hashref } qsearch('cust_main_county', {}) ],
823 #shortcut for one-country folks
825 [ sort { $a cmp $b } keys %states ],
827 'card_types' => card_types(),
829 'withcvv' => $conf->exists('selfservice-require_cvv'), #or enable optional cvv?
830 'require_cvv' => $conf->exists('selfservice-require_cvv'),
831 'onfile_require_cvv' => $conf->exists('selfservice-onfile_require_cvv'),
833 'paytypes' => [ FS::cust_payby::paytypes ],
835 'paybys' => [ $conf->config('signup_server-payby') ],
836 'cust_paybys' => \@cust_paybys,
838 'stateid_label' => FS::Msgcat::_gettext('stateid'),
839 'stateid_state_label' => FS::Msgcat::_gettext('stateid_state'),
841 'show_ss' => $conf->exists('show_ss'),
842 'show_stateid' => $conf->exists('show_stateid'),
843 'show_paystate' => $conf->exists('show_bankstate'),
845 'save_unchecked' => $conf->exists('selfservice-save_unchecked'),
846 'ach_read_only' => $conf->exists('selfservice-ACH_info_readonly'),
856 my %return = %$payment_info;
858 delete $return{'cust_main_county'} if $p->{'omit_cust_main_county'};
860 my $custnum = $session->{'custnum'};
862 my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
863 or return { 'error' => "unknown custnum $custnum" };
865 $return{'hide_payment_fields'} = [
867 my $pg = payment_gateway($cust_main, $_);
868 $pg && $pg->gateway_namespace eq 'Business::OnlineThirdPartyPayment';
869 } @{ $return{cust_paybys} }
872 $return{balance} = $cust_main->balance; #XXX pkg-balances?
874 $return{$_} = $cust_main->bill_location->get($_)
875 for qw(address1 address2 city state zip);
877 # look for stored cust_payby info
878 # only if we've been given a clear payment_payby (to avoid payname conflicts)
879 if ($p->{'payment_payby'} =~ /^(CARD|CHEK)$/) {
880 my @search_payby = ($p->{'payment_payby'} eq 'CARD') ? ('CARD','DCRD') : ('CHEK','DCHK');
881 my ($cust_payby) = $cust_main->cust_payby(@search_payby);
883 $return{payname} = $cust_payby->payname
884 || ( $cust_main->first. ' '. $cust_main->get('last') );
886 if ( $cust_payby->payby =~ /^(CARD|DCRD)$/ ) {
887 $return{card_type} = cardtype($cust_payby->payinfo);
888 $return{payinfo} = $cust_payby->paymask;
890 @return{'month', 'year'} = $cust_payby->paydate_monthyear;
894 if ( $cust_payby->payby =~ /^(CHEK|DCHK)$/ ) {
895 my ($payinfo1, $payinfo2) = split '@', $cust_payby->paymask;
896 $return{payinfo1} = $payinfo1;
897 $return{payinfo2} = $payinfo2;
898 $return{paytype} = $cust_payby->paytype;
899 $return{paystate} = $cust_payby->paystate;
900 $return{payname} = $cust_payby->payname; # override 'first/last name' default from above, if any. Is instution-name here. (#15819)
905 if ( $conf->config('prepayment_discounts-credit_type') ) {
907 $return{discount_terms_hash} = { $cust_main->discount_terms_hash };
910 #doubleclick protection
912 $return{payunique} = "webui-MyAccount-$_date-$$-". rand() * 2**32; #new
913 $return{paybatch} = $return{payunique}; #back compat
915 $return{credit_card_surcharge_percentage} = $conf->config('credit-card-surcharge-percentage', $cust_main->agentnum);
917 return { 'error' => '',
923 #some false laziness with httemplate/process/payment.cgi - look there for
924 #ACH and CVV support stuff
926 sub validate_payment {
929 my $session = _cache->get($p->{'session_id'})
930 or return { 'error' => "Can't resume session" }; #better error message
932 my $custnum = $session->{'custnum'};
934 my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
935 or return { 'error' => "unknown custnum $custnum" };
937 $p->{'amount'} =~ /^\s*(\d+(\.\d{2})?)\s*$/
938 or return { 'error' => gettext('illegal_amount') };
940 return { error => 'Amount must be greater than 0' } unless $amount > 0;
942 #false laziness w/tr-amount_fee.html, but we don't want selfservice users
943 #changing the hidden form values
944 my $conf = new FS::Conf;
945 my $fee_display = $conf->config('selfservice_process-display') || 'add';
946 my $fee_pkgpart = $conf->config('selfservice_process-pkgpart', $cust_main->agentnum);
947 my $fee_skip_first = $conf->exists('selfservice_process-skip_first');
948 if ( $fee_display eq 'add'
950 and ! $fee_skip_first || scalar($cust_main->cust_pay)
953 my $fee_pkg = qsearchs('part_pkg', { pkgpart=>$fee_pkgpart } );
954 $amount = sprintf('%.2f', $amount + $fee_pkg->option('setup_fee') );
957 $p->{'discount_term'} =~ /^\s*(\d*)\s*$/
958 or return { 'error' => gettext('illegal_discount_term'). ': '. $p->{'discount_term'} };
959 my $discount_term = $1;
961 $p->{'payname'} =~ /^([\w \,\.\-\']+)$/
962 or return { 'error' => gettext('illegal_name'). " payname: ". $p->{'payname'} };
965 $p->{'payunique'} =~ /^([\w \!\@\#\$\%\&\(\)\-\+\;\:\'\"\,\.\?\/\=]*)$/
966 or return { 'error' => gettext('illegal_text'). " payunique: ". $p->{'payunique'} };
969 $p->{'paybatch'} =~ /^([\w \!\@\#\$\%\&\(\)\-\+\;\:\'\"\,\.\?\/\=]*)$/
970 or return { 'error' => gettext('illegal_text'). " paybatch: ". $p->{'paybatch'} };
973 $payunique = $paybatch if ! length($payunique) && length($paybatch);
975 $p->{'payby'} ||= 'CARD';
976 $p->{'payby'} =~ /^([A-Z]{4})$/
977 or return { 'error' => "illegal_payby " . $p->{'payby'} };
980 #false laziness w/process/payment.cgi
983 my $replace_cust_payby;
984 if ( $payby eq 'CHEK' || $payby eq 'DCHK' ) {
986 $p->{'payinfo1'} =~ /^([\dx]+)$/
987 or return { 'error' => "illegal account number ". $p->{'payinfo1'} };
989 $p->{'payinfo2'} =~ /^([\dx]+)$/
990 or return { 'error' => "illegal ABA/routing number ". $p->{'payinfo2'} };
992 $payinfo = $payinfo1. '@'. $payinfo2;
995 foreach my $cust_payby ($cust_main->cust_payby('CHEK','DCHK')) {
996 if ( $cust_payby->paymask eq $payinfo ) {
997 $payinfo = $cust_payby->payinfo;
998 $replace_cust_payby = $cust_payby;
1004 if ($conf->exists('selfservice-ACH_info_readonly') && !$achonfile) {
1005 return { 'error' => "You are not allowed to change your payment information." };
1008 } elsif ( $payby eq 'CARD' || $payby eq 'DCRD' ) {
1010 $payinfo = $p->{'payinfo'};
1014 #more intelligent matching will be needed here if you change
1015 #card_masking_method and don't remove existing paymasks
1016 foreach my $cust_payby ($cust_main->cust_payby('CARD','DCRD')) {
1017 if ( $cust_payby->paymask eq $payinfo ) {
1018 $payinfo = $cust_payby->payinfo;
1019 $replace_cust_payby = $cust_payby;
1025 $payinfo =~ s/\D//g;
1026 $payinfo =~ /^(\d{13,19}|\d{8,9})$/
1027 or return { 'error' => gettext('invalid_card') }; # . ": ". $self->payinfo
1031 or return { 'error' => gettext('invalid_card') }; # . ": ". $self->payinfo
1032 return { 'error' => gettext('unknown_card_type') }
1033 if !$cust_main->tokenized($payinfo) && cardtype($payinfo) eq "Unknown";
1035 if ( length($p->{'paycvv'}) && $p->{'paycvv'} !~ /^\s*$/ ) {
1036 if ( cardtype($payinfo) eq 'American Express card' ) {
1037 $p->{'paycvv'} =~ /^\s*(\d{4})\s*$/
1038 or return { 'error' => "CVV2 (CID) for American Express cards is four digits." };
1041 $p->{'paycvv'} =~ /^\s*(\d{3})\s*$/
1042 or return { 'error' => "CVV2 (CVC2/CID) is three digits." };
1045 } elsif ( $conf->exists('selfservice-onfile_require_cvv') ) {
1046 return { 'error' => 'CVV2 is required' };
1047 } elsif ( !$onfile && $conf->exists('selfservice-require_cvv') ) {
1048 return { 'error' => 'CVV2 is required' };
1052 die "unknown payby $payby";
1055 my %payby2fields = (
1056 'CARD' => [ qw( paystart_month paystart_year payissue payip
1057 address1 address2 city state zip country ) ],
1058 'CHEK' => [ qw( ss paytype paystate stateid stateid_state payip ) ],
1061 my %replace = ( 'replace' => $replace_cust_payby, );
1064 $card_type = cardtype($payinfo) if $payby eq 'CARD';
1067 'cust_main' => $cust_main, #XXX or just custnum??
1068 'amount' => sprintf('%.2f', $amount),
1070 'payinfo' => $payinfo,
1071 'paymask' => FS::payinfo_Mixin->mask_payinfo( $payby, $payinfo ),
1072 'card_type' => $card_type,
1073 'paydate' => $p->{'year'}. '-'. $p->{'month'}. '-01',
1074 'paydate_pretty' => $p->{'month'}. ' / '. $p->{'year'},
1075 'month' => $p->{'month'},
1076 'year' => $p->{'year'},
1077 'payname' => $payname,
1078 'payunique' => $payunique,
1079 'paybatch' => $paybatch,
1080 'paycvv' => $paycvv,
1081 'payname' => $payname,
1082 'discount_term' => $discount_term,
1083 'pkgnum' => $session->{'pkgnum'},
1085 map { $_ => $p->{$_} } ( @{ $payby2fields{$payby} },
1095 my $validate = validate_payment($p);
1096 return $validate if $validate->{'error'};
1098 my $conf = new FS::Conf;
1099 my $timeout = $conf->config('selfservice-session_timeout') || '1 hour'; #?
1100 _cache->set( 'payment_'.$p->{'session_id'}, $validate, $timeout );
1102 +{ map { $_=>$validate->{$_} }
1103 qw( card_type paymask payname paydate_pretty month year amount
1104 address1 address2 city state zip country
1110 sub process_stored_payment {
1113 my $session_id = $p->{'session_id'};
1115 my $payment_info = _cache->get( "payment_$session_id" )
1116 or return { 'error' => "Can't resume session" }; #better error message
1118 do_process_payment($payment_info);
1122 sub process_payment {
1125 my $payment_info = validate_payment($p);
1126 return $payment_info if $payment_info->{'error'};
1128 do_process_payment($payment_info);
1132 sub do_process_payment {
1133 my $validate = shift;
1135 my $cust_main = $validate->{'cust_main'};
1137 my $amount = delete $validate->{'amount'};
1140 my $payby = delete $validate->{'payby'};
1142 if ( $validate->{'save'} ) {
1145 foreach my $field ( qw( auto payinfo paymask payname payip ) ) {
1146 $saveopt{$field} = $validate->{$field};
1149 if ( $payby eq 'CARD' ) {
1150 my $bill_location = FS::cust_location->new({
1151 map { $_ => $validate->{$_} }
1152 qw(address1 address2 city state country zip)
1154 $saveopt{'bill_location'} = $bill_location;
1155 foreach my $field ( qw( paydate paystart_month paystart_year payissue ) ) {
1156 $saveopt{$field} = $validate->{$field};
1159 # stateid/stateid_state won't be saved, might be broken as of 4.x
1160 foreach my $field ( qw( paytype paystate ) ) {
1161 $saveopt{$field} = $validate->{$field};
1165 my $error = $cust_main->save_cust_payby(
1166 'payment_payby' => $payby,
1167 'replace' => $validate->{'replace'}, # cust_payby object to replace
1172 #no, this causes customers to process their payments again
1173 #return { 'error' => $error };
1174 #XXX just warn verosely for now so i can figure out how these happen in
1175 # the first place, eventually should redirect them to the "change
1176 #address" page but indicate if the payment processed?
1177 delete($validate->{'payinfo'}); #don't want to log this!
1178 warn "WARNING: error changing customer info when processing payment (not returning to customer as a processing error): $error\n".
1180 "SAVEOPT: ".Dumper(\%saveopt)."\n".
1181 "CUST_MAIN: ". Dumper($cust_main)."\n".
1182 "PACKET: ". Dumper($validate)."\n";
1186 my $error = $cust_main->realtime_bop( $FS::payby::payby2bop{$payby}, $amount,
1190 'paynum_ref' => \$paynum,
1193 return { 'error' => $error } if $error;
1195 #no error, so order the fee package if applicable...
1196 my $conf = new FS::Conf;
1197 my $fee_pkgpart = $conf->config('selfservice_process-pkgpart', $cust_main->agentnum);
1198 my $fee_skip_first = $conf->exists('selfservice_process-skip_first');
1200 if ( $fee_pkgpart and ! $fee_skip_first || scalar($cust_main->cust_pay) ) {
1202 my $cust_pkg = new FS::cust_pkg { 'pkgpart' => $fee_pkgpart };
1204 $error = $cust_main->order_pkg( 'cust_pkg' => $cust_pkg );
1205 return { 'error' => "payment processed successfully, but error ordering fee: $error" }
1208 #and generate an invoice for it now too
1209 $error = $cust_main->bill( 'pkg_list' => [ $cust_pkg ] );
1210 return { 'error' => "payment processed and fee ordered successfully, but error billing fee: $error" }
1215 $cust_main->apply_payments;
1218 my $receipt_html = '';
1220 # currently supported for realtime CC only; send receipt data to SS
1221 $cust_pay = qsearchs('cust_pay', { 'paynum' => $paynum } );
1224 <TABLE BGCOLOR="#cccccc" BORDER=0 CELLSPACING=2>
1227 <TD ALIGN="right">Payment#</TD>
1228 <TD BGCOLOR="#FFFFFF"><B>! . $cust_pay->paynum . qq!</B></TD>
1232 <TD ALIGN="right">Date</TD>
1234 <TD BGCOLOR="#FFFFFF"><B>! .
1235 time2str("%a %b %o, %Y %r", $cust_pay->_date)
1241 <TD ALIGN="right">Amount</TD>
1242 <TD BGCOLOR="#FFFFFF"><B>! . sprintf('%.2f', $cust_pay->paid) . qq!</B></TD>
1247 <TD ALIGN="right">Payment method</TD>
1248 <TD BGCOLOR="#FFFFFF"><B>! . $cust_pay->payby_name .' #'. $cust_pay->paymask
1261 'amount' => sprintf('%.2f', $cust_pay->paid),
1262 'date' => $cust_pay->_date,
1263 'date_pretty' => time2str('%Y-%m-%d', $cust_pay->_date),
1264 'time_pretty' => time2str('%T', $cust_pay->_date),
1265 'auth_num' => $cust_pay->auth,
1266 'order_num' => $cust_pay->order_number,
1267 'receipt_html' => $receipt_html,
1274 'receipt_html' => '',
1281 sub realtime_collect {
1284 my $session = _cache->get($p->{'session_id'})
1285 or return { 'error' => "Can't resume session" }; #better error message
1287 my $custnum = $session->{'custnum'};
1289 my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1290 or return { 'error' => "unknown custnum $custnum" };
1293 if ( $p->{'amount'} ) {
1294 $amount = $p->{'amount'};
1296 elsif ( $session->{'pkgnum'} ) {
1297 $amount = $cust_main->balance_pkgnum( $session->{'pkgnum'} );
1300 $amount = $cust_main->balance;
1303 my $error = $cust_main->realtime_collect(
1304 'method' => $p->{'method'},
1305 'amount' => $amount,
1306 'pkgnum' => $session->{'pkgnum'},
1307 'session_id' => $p->{'session_id'},
1311 return { 'error' => $error } unless ref( $error );
1313 return { 'error' => '', amount => $amount, %$error };
1316 sub start_thirdparty {
1318 my $session = _cache->get($p->{'session_id'})
1319 or return { 'error' => "Can't resume session" }; #better error message
1320 my $custnum = $session->{'custnum'};
1321 my $cust_main = FS::cust_main->by_key($custnum);
1323 my $amount = $p->{'amount'}
1324 or return { error => 'no amount' };
1326 my $result = $cust_main->create_payment(
1327 'method' => $p->{'method'},
1328 'amount' => $p->{'amount'},
1329 'pkgnum' => $session->{'pkgnum'},
1330 'session_id' => $p->{'session_id'},
1333 if ( ref($result) ) { # hashref or error
1336 return { error => $result };
1340 sub finish_thirdparty {
1342 my $session_id = delete $p->{'session_id'};
1343 my $session = _cache->get($session_id)
1344 or return { 'error' => "Can't resume session" };
1345 my $custnum = $session->{'custnum'};
1346 my $cust_main = FS::cust_main->by_key($custnum);
1348 if ( $p->{_cancel} ) {
1349 # customer backed out of making a payment
1350 return $cust_main->cancel_payment( $session_id );
1352 my $result = $cust_main->execute_payment( $session_id, %$p );
1353 if ( ref($result) ) {
1356 return { error => $result };
1360 sub process_payment_order_pkg {
1363 my $hr = process_payment($p);
1364 return $hr if $hr->{'error'};
1369 sub process_payment_order_renew {
1372 my $hr = process_payment($p);
1373 return $hr if $hr->{'error'};
1378 sub process_prepay {
1382 my $session = _cache->get($p->{'session_id'})
1383 or return { 'error' => "Can't resume session" }; #better error message
1387 my $custnum = $session->{'custnum'};
1389 my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1390 or return { 'error' => "unknown custnum $custnum" };
1392 my( $amount, $seconds, $upbytes, $downbytes, $totalbytes ) = ( 0, 0, 0, 0, 0 );
1393 my $error = $cust_main->recharge_prepay( $p->{'prepaid_cardnum'},
1401 return { 'error' => $error } if $error;
1403 return { 'error' => '',
1404 'amount' => $amount,
1405 'seconds' => $seconds,
1406 'duration' => duration_exact($seconds),
1407 'upbytes' => $upbytes,
1408 'upload' => FS::UI::bytecount::bytecount_unexact($upbytes),
1409 'downbytes' => $downbytes,
1410 'download' => FS::UI::bytecount::bytecount_unexact($downbytes),
1411 'totalbytes'=> $totalbytes,
1412 'totalload' => FS::UI::bytecount::bytecount_unexact($totalbytes),
1419 my $session = _cache->get($p->{'session_id'})
1420 or return { 'error' => "Can't resume session" }; #better error message
1422 my $custnum = $session->{'custnum'};
1424 my $invnum = $p->{'invnum'};
1426 my $cust_bill = qsearchs('cust_bill', { 'invnum' => $invnum,
1427 'custnum' => $custnum } )
1428 or return { 'error' => "Can't find invnum" };
1432 return { 'error' => '',
1433 'invnum' => $invnum,
1434 'invoice_text' => join('', $cust_bill->print_text ),
1435 'invoice_html' => $cust_bill->print_html( { unsquelch_cdr => 1 } ),
1442 my $session = _cache->get($p->{'session_id'})
1443 or return { 'error' => "Can't resume session" }; #better error message
1445 my $custnum = $session->{'custnum'};
1447 my $invnum = $p->{'invnum'};
1449 my $cust_bill = qsearchs('cust_bill', { 'invnum' => $invnum,
1450 'custnum' => $custnum } )
1451 or return { 'error' => "Can't find invnum" };
1455 return { 'error' => '',
1456 'invnum' => $invnum,
1457 'invoice_pdf' => $cust_bill->print_pdf({
1458 'unsquelch_cdr' => 1,
1459 'locale' => $p->{'locale'},
1465 sub legacy_invoice {
1467 my $session = _cache->get($p->{'session_id'})
1468 or return { 'error' => "Can't resume session" }; #better error message
1470 my $custnum = $session->{'custnum'};
1472 my $legacyinvnum = $p->{'legacyinvnum'};
1475 'legacyinvnum' => $legacyinvnum,
1476 'custnum' => $custnum,
1479 my $legacy_cust_bill =
1480 qsearchs('legacy_cust_bill', { %hash, 'locale' => $p->{'locale'} } )
1481 || qsearchs('legacy_cust_bill', \%hash )
1482 or return { 'error' => "Can't find legacyinvnum" };
1486 return { 'error' => '',
1487 'legacyinvnum' => $legacyinvnum,
1488 'legacyid' => $legacy_cust_bill->legacyid,
1489 'invoice_html' => $legacy_cust_bill->content_html,
1494 sub legacy_invoice_pdf {
1496 my $session = _cache->get($p->{'session_id'})
1497 or return { 'error' => "Can't resume session" }; #better error message
1499 my $custnum = $session->{'custnum'};
1501 my $legacyinvnum = $p->{'legacyinvnum'};
1503 my $legacy_cust_bill = qsearchs('legacy_cust_bill', {
1504 'legacyinvnum' => $legacyinvnum,
1505 'custnum' => $custnum,
1506 }) or return { 'error' => "Can't find legacyinvnum" };
1510 return { 'error' => '',
1511 'legacyinvnum' => $legacyinvnum,
1512 'legacyid' => $legacy_cust_bill->legacyid,
1513 'invoice_pdf' => $legacy_cust_bill->content_pdf,
1521 #sessioning for this? how do we get the session id to the backend invoice
1522 # template so it can add it to the link, blah
1525 if ( $p->{'invnum'} ) {
1526 my $cust_bill = qsearchs('cust_bill', { 'invnum' => $p->{'invnum'} } )
1527 or return { 'error' => 'unknown invnum' };
1528 $agentnum = $cust_bill->cust_main->agentnum;
1531 my $templatename = $p->{'template'} || $p->{'templatename'};
1533 #false laziness-ish w/view/cust_bill-logo.cgi
1535 my $conf = new FS::Conf;
1536 if ( $templatename =~ /^([^\.\/]*)$/ && $conf->exists("logo_$1.png") ) {
1537 $templatename = "_$1";
1542 my $filename = "logo$templatename.png";
1544 return { 'error' => '',
1545 'logo' => $conf->config_binary($filename, $agentnum),
1546 'content_type' => 'image/png', #should allow gif, jpg too
1552 my $session = _cache->get($p->{'session_id'})
1553 or return { 'error' => "Can't resume session" }; #better error message
1555 my $custnum = $session->{'custnum'};
1557 my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1558 or return { 'error' => "unknown custnum $custnum" };
1560 my $conf = new FS::Conf;
1562 my @legacy_cust_bill = $cust_main->legacy_cust_bill;
1564 my @cust_bill = grep ! $_->hide, $cust_main->cust_bill;
1569 #not super efficient, we also run cust_bill_pay/cust_credited inside owed
1570 my @payments_and_credits = sort {$b->_date <=> $a->_date} ($_->cust_bill_pay,$_->cust_credited);
1571 my $owed = $_->owed;
1573 +{ 'invnum' => $_->invnum,
1574 '_date' => $_->_date,
1575 'date' => time2str("%b %o, %Y", $_->_date),
1576 'date_short' => time2str("%m-%d-%Y", $_->_date),
1577 'previous' => sprintf('%.2f', ($_->previous)[0]),
1578 'charged' => sprintf('%.2f', $_->charged),
1579 'owed' => sprintf('%.2f', $owed),
1580 'balance' => sprintf('%.2f', $balance),
1581 'lastpay' => @payments_and_credits
1582 ? time2str("%b %o, %Y", $payments_and_credits[0]->_date)
1588 return { 'error' => '',
1589 'balance' => $cust_main->balance,
1590 'money_char' => $conf->config("money_char") || '$',
1591 'invoices' => $invoices,
1592 'legacy_invoices' => [
1594 +{ 'legacyinvnum' => $_->legacyinvnum,
1595 'legacyid' => $_->legacyid,
1596 '_date' => $_->_date,
1597 'date' => time2str("%b %o, %Y", $_->_date),
1598 'date_short' => time2str("%m-%d-%Y", $_->_date),
1599 'charged' => sprintf('%.2f', $_->charged),
1600 'has_content' => ( length($_->content_pdf)
1601 || length($_->content_html) ),
1611 my $session = _cache->get($p->{'session_id'})
1612 or return { 'error' => "Can't resume session" }; #better error message
1614 my $custnum = $session->{'custnum'};
1616 my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1617 or return { 'error' => "unknown custnum $custnum" };
1619 return { 'error' => '',
1620 'balance' => $cust_main->balance,
1621 'money_char' => FS::Conf->new->config("money_char") || '$',
1622 'payments' => [ map $_->SSAPI_getinfo, $cust_main->cust_pay ],
1626 sub payment_receipt {
1628 my $session = _cache->get($p->{'session_id'})
1629 or return { 'error' => "Can't resume session" }; #better error message
1631 my $custnum = $session->{'custnum'};
1633 my $cust_pay = qsearchs('cust_pay', { 'custnum' => $custnum,
1634 'paynum' => $p->{'paynum'},
1637 or return { 'error' => "unknown payment ". $p->{'paynum'} };
1641 %{ $cust_pay->SSAPI_getinfo },
1648 my($context, $session, $custnum) = _custoragent_session_custnum($p);
1649 return { 'error' => $session } if $context eq 'error';
1651 my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1652 or return { 'error' => "unknown custnum $custnum" };
1656 my $cust_payby = $_;
1658 map { $_ => $cust_payby->$_ }
1659 qw( custpaybynum weight payby paymask paydate
1660 payname paystate paytype
1664 $cust_main->cust_payby
1672 my($context, $session, $custnum) = _custoragent_session_custnum($p);
1673 return { 'error' => $session } if $context eq 'error';
1675 #XXX payinfo1 + payinfo2 for CHEK?
1676 #or take the opportunity to use separate, more well- named fields?
1678 # $p->{'payinfo1'} =~ /^([\dx]+)$/
1679 # or return { 'error' => "illegal account number ". $p->{'payinfo1'} };
1680 # my $payinfo1 = $1;
1681 # $p->{'payinfo2'} =~ /^([\dx\.]+)$/ # . turned on by echeck-country CA ?
1682 # or return { 'error' => "illegal ABA/routing number ". $p->{'payinfo2'} };
1683 # my $payinfo2 = $1;
1684 # $payinfo = $payinfo1. '@'. $payinfo2;
1686 my $cust_payby = new FS::cust_payby {
1687 'custnum' => $custnum,
1688 map { $_ => $p->{$_} } qw( weight payby payinfo paycvv paydate payname
1689 paystate paytype payip
1693 my $error = $cust_payby->insert;
1695 return { 'error' => $error };
1697 return { 'custpaybynum' => $cust_payby->custpaybynum };
1705 my($context, $session, $custnum) = _custoragent_session_custnum($p);
1706 return { 'error' => $session } if $context eq 'error';
1708 my $cust_payby = qsearchs('cust_payby', {
1709 'custnum' => $custnum,
1710 'custpaybynum' => $p->{'custpaybynum'},
1712 or return { 'error' => 'unknown custpaybynum '. $p->{'custpaybynum'} };
1715 qw( weight payby payinfo paycvv paydate payname paystate paytype payip )
1717 next unless exists($p->{$field});
1718 $cust_payby->set($field,$p->{$field});
1721 my $error = $cust_payby->replace;
1723 return { 'error' => $error };
1725 return { 'custpaybynum' => $cust_payby->custpaybynum };
1733 my($context, $session, $custnum) = _custoragent_session_custnum($p);
1734 return { 'error' => $session } if $context eq 'error';
1736 my $cust_payby = qsearchs('cust_payby', {
1737 'custnum' => $custnum,
1738 'custpaybynum' => $p->{'custpaybynum'},
1740 or return { 'error' => 'unknown custpaybynum '. $p->{'custpaybynum'} };
1742 return { 'error' => $cust_payby->verify };
1749 my($context, $session, $custnum) = _custoragent_session_custnum($p);
1750 return { 'error' => $session } if $context eq 'error';
1752 my $cust_payby = qsearchs('cust_payby', {
1753 'custnum' => $custnum,
1754 'custpaybynum' => $p->{'custpaybynum'},
1756 or return { 'error' => 'unknown custpaybynum '. $p->{'custpaybynum'} };
1758 my $conf = new FS::Conf;
1759 if (($cust_payby->payby eq "DCHK" || $cust_payby->payby eq "CHEK") && $conf->exists('selfservice-ACH_info_readonly')) {
1760 return { 'error' => "Sorry you do not have permission to delete bank information." };
1763 return { 'error' => $cust_payby->delete };
1769 my $session = _cache->get($p->{'session_id'})
1770 or return { 'error' => "Can't resume session" }; #better error message
1772 my $custnum = $session->{'custnum'};
1774 my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
1775 or return { 'error' => "unknown custnum $custnum" };
1777 my @errors = $cust_main->cancel( 'quiet'=>1 );
1779 my $error = scalar(@errors) ? join(' / ', @errors) : '';
1781 return { 'error' => $error };
1788 my($context, $session, $custnum) = _custoragent_session_custnum($p);
1789 return { 'error' => $session } if $context eq 'error';
1791 my $pkg = qsearchs({
1792 'table' => 'cust_pkg',
1793 'addl_from' => 'LEFT JOIN part_pkg USING ( pkgpart )',
1795 'custnum' => $custnum,
1796 'pkgnum' => $p->{'pkgnum'},
1799 or return {'error' => 'unknown pkg num $pkgnum'};
1802 pkg_label => $pkg->pkg,
1803 pkgpart => $pkg->pkgpart,
1804 classnum => $pkg->classnum,
1812 my($context, $session, $custnum) = _custoragent_session_custnum($p);
1813 return { 'error' => $session } if $context eq 'error';
1815 my $search = { 'custnum' => $custnum };
1816 $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1817 my $cust_main = qsearchs('cust_main', $search )
1818 or return { 'error' => "unknown custnum $custnum" };
1820 my $conf = new FS::Conf;
1821 my $immutable = $conf->exists('selfservice_immutable-package');
1823 # the duplication below is necessary:
1824 # 1. to maintain the current buggy behaviour wrt the cust_pkg and part_pkg
1825 # hashes overwriting each other (setup and no_auto fields). Fixing that is a
1826 # non-backwards-compatible change breaking the software of anyone using the API
1827 # instead of the stock selfservice
1828 # 2. to return cancelled packages as well - for wholesale and non-wholesale
1829 if( $conf->exists('selfservice_server-view-wholesale') ) {
1830 return { 'svcnum' => $session->{'svcnum'},
1831 'custnum' => $custnum,
1832 'cust_pkg' => [ map {
1834 immutable => $immutable,
1835 part_pkg => [ map $_->hashref, $_->part_pkg ],
1837 [ map $_->hashref, $_->available_part_svc ],
1839 [ map { my $ref = { $_->hash,
1840 label => [ $_->label ],
1842 $ref->{_password} = $_->svc_x->_password
1843 if $context eq 'agent'
1844 && $conf->exists('agent-showpasswords')
1845 && $_->part_svc->svcdb eq 'svc_acct';
1850 } $cust_main->cust_pkg
1853 small_custview( $cust_main, $conf->config('countrydefault') ),
1854 'wholesale_view' => 1,
1855 'login_svcpart' => [ $conf->config('selfservice_server-login_svcpart') ],
1856 'date_format' => $conf->config('date_format') || '%m/%d/%Y',
1857 'lnp' => $conf->exists('svc_phone-lnp'),
1861 { 'svcnum' => $session->{'svcnum'},
1862 'custnum' => $custnum,
1863 'cust_pkg' => [ map {
1864 my $primary_cust_svc = $_->primary_cust_svc;
1867 immutable => $immutable,
1868 pkg_label => $_->pkg_locale,
1869 status => $_->status,
1870 statuscolor => $_->statuscolor,
1872 [ map { $_->hashref }
1873 grep { $_->selfservice_access ne 'hidden' }
1874 $_->available_part_svc
1877 [ map { my $ref = { $_->hash,
1878 label => [ $_->label ],
1880 $ref->{_password} = $_->svc_x->_password
1881 if $context eq 'agent'
1882 && $conf->exists('agent-showpasswords')
1883 && $_->part_svc->svcdb eq 'svc_acct';
1884 $ref->{svchash} = { $_->svc_x->hash } if
1885 $_->part_svc->svcdb eq 'svc_phone';
1886 $ref->{svchash}->{svcpart} = $_->part_svc->svcpart
1887 if $_->part_svc->svcdb eq 'svc_phone'; # hack
1890 grep { $_->part_svc->selfservice_access ne 'hidden' }
1895 ? { $primary_cust_svc->hash,
1896 label => [ $primary_cust_svc->label ],
1897 finger => $primary_cust_svc->svc_x->finger, #uuh
1898 $primary_cust_svc->part_svc->hash,
1902 } $cust_main->ncancelled_pkgs
1905 small_custview( $cust_main, $conf->config('countrydefault') ),
1906 'date_format' => $conf->config('date_format') || '%m/%d/%Y',
1914 my($context, $session, $custnum) = _custoragent_session_custnum($p);
1915 return { 'error' => $session } if $context eq 'error';
1917 my $conf = new FS::Conf;
1919 my $hide_usage = $conf->exists('selfservice_hide-usage') ? 1 : 0;
1920 my $search = { 'custnum' => $custnum };
1921 $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
1922 my $cust_main = qsearchs('cust_main', $search )
1923 or return { 'error' => "unknown custnum $custnum" };
1925 my $pkgnum = $session->{'pkgnum'} || $p->{'pkgnum'} || '';
1926 if ( ! $pkgnum && $p->{'svcnum'} ) {
1927 my $cust_svc = qsearchs('cust_svc', { 'svcnum' => $p->{'svcnum'} } );
1928 $pkgnum = $cust_svc->pkgnum if $cust_svc;
1932 my @cust_pkg_usage = ();
1933 foreach my $cust_pkg ( $p->{'ncancelled'}
1934 ? $cust_main->ncancelled_pkgs
1935 : $cust_main->unsuspended_pkgs ) {
1936 next if $pkgnum && $cust_pkg->pkgnum != $pkgnum;
1937 push @cust_svc, @{[ $cust_pkg->cust_svc ]}; #@{[ ]} to force array context
1938 push @cust_pkg_usage, $cust_pkg->cust_pkg_usage;
1941 @cust_svc = grep { $_->part_svc->selfservice_access ne 'hidden' } @cust_svc;
1944 foreach (@cust_pkg_usage) {
1945 my $part = $_->part_pkg_usage;
1946 my $tag = $part->description . ($part->shared ? 1 : 0);
1947 my $row = $usage_pools{$tag}
1948 ||= [ $part->description, 0, 0, $part->shared ? 1 : 0 ];
1949 $row->[1] += sprintf('%.1f', $_->minutes); # minutes remaining
1950 $row->[2] += $part->minutes; # minutes total
1952 } # otherwise just leave them empty
1954 if ( $p->{'svcdb'} ) {
1955 my $svcdb = ref($p->{'svcdb'}) eq 'HASH'
1957 : ref($p->{'svcdb'}) eq 'ARRAY'
1958 ? { map { $_=>1 } @{ $p->{'svcdb'} } }
1959 : { $p->{'svcdb'} => 1 };
1960 @cust_svc = grep $svcdb->{ $_->part_svc->svcdb }, @cust_svc
1963 #@svc_x = sort { $a->domain cmp $b->domain || $a->username cmp $b->username }
1966 my @svcs; # stuff to return to the client
1967 my %bytes_used_total; # for _used columns only
1968 foreach my $cust_svc (@cust_svc) {
1969 my $svc_x = $cust_svc->svc_x;
1970 my($label, $value) = $cust_svc->label;
1971 my $part_svc = $cust_svc->part_svc;
1972 my $svcdb = $part_svc->svcdb;
1973 my $cust_pkg = $cust_svc->cust_pkg;
1974 my $part_pkg = $cust_pkg->part_pkg;
1977 'svcnum' => $cust_svc->svcnum,
1978 'display_svcnum' => $cust_svc->display_svcnum,
1982 'pkg_label' => $cust_pkg->pkg_locale,
1983 'pkg_status' => $cust_pkg->status,
1984 'readonly' => ($part_svc->selfservice_access eq 'readonly'),
1987 # would it make sense to put this in a svc_* method?
1989 if (!$hide_usage and grep(/^$svcdb$/, qw(svc_acct svc_broadband)) and $part_svc->part_export_usage) {
1990 my $last_bill = $cust_pkg->last_bill || 0;
1992 my $up_used = $cust_svc->attribute_since_sqlradacct($last_bill,$now,'AcctInputOctets');
1993 my $down_used = $cust_svc->attribute_since_sqlradacct($last_bill,$now,'AcctOutputOctets');
1996 'seconds_used' => $cust_svc->seconds_since_sqlradacct($last_bill,$now),
1997 'upbytes_used' => display_bytecount($up_used),
1998 'downbytes_used' => display_bytecount($down_used),
1999 'totalbytes_used' => display_bytecount($up_used + $down_used)
2001 $bytes_used_total{'seconds_used'} += $hash{'seconds_used'};
2002 $bytes_used_total{'upbytes_used'} += $up_used;
2003 $bytes_used_total{'downbytes_used'} += $down_used;
2004 $bytes_used_total{'totalbytes_used'} += $up_used + $down_used;
2007 if ( $svcdb eq 'svc_acct' ) {
2008 foreach (qw(username email finger seconds)) {
2009 $hash{$_} = $svc_x->$_;
2015 'upbytes' => display_bytecount($svc_x->upbytes),
2016 'downbytes' => display_bytecount($svc_x->downbytes),
2017 'totalbytes' => display_bytecount($svc_x->totalbytes),
2019 'recharge_amount' => $part_pkg->option('recharge_amount',1),
2020 'recharge_seconds' => $part_pkg->option('recharge_seconds',1),
2021 'recharge_upbytes' =>
2022 display_bytecount($part_pkg->option('recharge_upbytes',1)),
2023 'recharge_downbytes' =>
2024 display_bytecount($part_pkg->option('recharge_downbytes',1)),
2025 'recharge_totalbytes' =>
2026 display_bytecount($part_pkg->option('recharge_totalbytes',1)),
2031 } elsif ( $svcdb eq 'svc_dsl' ) {
2033 $hash{'phonenum'} = $svc_x->phonenum;
2034 if ( $svc_x->first || $svc_x->get('last') || $svc_x->company ) {
2035 $hash{'name'} = $svc_x->first. ' '. $svc_x->get('last');
2036 $hash{'name'} = $svc_x->company. ' ('. $hash{'name'}. ')'
2039 $hash{'name'} = $cust_main->name;
2041 # no usage to hide here
2043 } elsif ( $svcdb eq 'svc_phone' or $svcdb eq 'svc_pbx' ) {
2045 # could potentially show lots of things...
2046 $hash{'outbound'} = 1;
2047 $hash{'inbound'} = 0;
2048 if ( $svcdb eq 'svc_phone' ) {
2049 if ( $part_pkg->plan eq 'voip_inbound' ) {
2050 $hash{'outbound'} = 0;
2051 $hash{'inbound'} = 1;
2052 } elsif ( $part_pkg->option('selfservice_inbound_format')
2053 or $conf->config('selfservice-default_inbound_cdr_format')
2055 $hash{'inbound'} = 1;
2058 foreach (qw(inbound outbound)) {
2059 # hmm...we can't filter by status here, because there might
2060 # not be cdr_terminations at all. have to go by date.
2061 # find all since the last bill date.
2062 # XXX cdr types? we are going to need them.
2064 my $sum_cdr = $svc_x->sum_cdrs(
2065 'inbound' => ( $_ eq 'inbound' ? 1 : 0 ),
2066 'begin' => ($cust_pkg->last_bill || 0),
2068 'disable_charged_party' => 1,
2070 $hash{$_} = $sum_cdr->hashref;
2073 } # not hiding usage
2077 } # foreach $cust_svc
2079 foreach my $field (keys %bytes_used_total) {
2080 if ($field =~ /bytes/) {
2081 $bytes_used_total{$field} = display_bytecount($bytes_used_total{$field});
2086 'svcnum' => $session->{'svcnum'},
2087 'custnum' => $custnum,
2088 'date_format' => $conf->config('date_format') || '%m/%d/%Y',
2089 'view_usage_nodomain' => $conf->exists('selfservice-view_usage_nodomain'),
2091 'bytes_used_total' => \%bytes_used_total,
2093 map { $usage_pools{$_} }
2097 'hide_usage' => $hide_usage,
2102 sub _customer_svc_x {
2103 my($custnum, $svcnum, $table) = (shift, shift, shift);
2104 my $hashref = ref($svcnum) ? $svcnum : { 'svcnum' => $svcnum };
2106 $custnum =~ /^(\d+)$/ or die "illegal custnum";
2107 my $search = " AND custnum = $1";
2108 #$search .= " AND agentnum = ". $session->{'agentnum'} if $context eq 'agent';
2111 'table' => ($table || 'svc_acct'),
2112 'addl_from' => 'LEFT JOIN cust_svc USING ( svcnum ) '.
2113 'LEFT JOIN cust_pkg USING ( pkgnum ) ',#.
2114 #'LEFT JOIN cust_main USING ( custnum ) ',
2115 'hashref' => $hashref,
2116 'extra_sql' => $search, #important
2121 sub svc_status_html {
2124 my($context, $session, $custnum) = _custoragent_session_custnum($p);
2125 return { 'error' => $session } if $context eq 'error';
2127 #XXX only svc_dsl for now
2128 my $svc_x = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_dsl')
2129 or return { 'error' => "Service not found" };
2131 my $html = $svc_x->getstatus_html;
2133 return { 'html' => $html };
2137 sub svc_status_hash {
2140 my($context, $session, $custnum) = _custoragent_session_custnum($p);
2141 return { 'error' => $session } if $context eq 'error';
2143 #XXX only svc_acct for now
2144 my $svc_x = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_acct')
2145 or return { 'error' => "Service not found" };
2147 my ( $html, $hashref ) = $svc_x->export_getstatus;
2152 sub set_svc_status_hash { _svc_method_X(shift, 'export_setstatus') }
2153 sub set_svc_status_listadd { _svc_method_X(shift, 'export_setstatus_listadd') }
2154 sub set_svc_status_listdel { _svc_method_X(shift, 'export_setstatus_listdel') }
2155 sub set_svc_status_vacationadd { _svc_method_X(shift, 'export_setstatus_vacationadd') }
2156 sub set_svc_status_vacationdel { _svc_method_X(shift, 'export_setstatus_vacationdel') }
2159 my( $p, $method ) = @_;
2161 my($context, $session, $custnum) = _custoragent_session_custnum($p);
2162 return { 'error' => $session } if $context eq 'error';
2164 #XXX only svc_acct for now
2165 my $svc_x = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_acct')
2166 or return { 'error' => "Service not found" };
2168 warn "$method ". join(' / ', map "$_=>".$p->{$_}, keys %$p )
2170 my $error = $svc_x->$method($p); #$p? returns error?
2171 return { 'error' => $error } if $error;
2173 return {}; #? { 'error' => '' }
2177 sub acct_forward_info {
2180 my($context, $session, $custnum) = _custoragent_session_custnum($p);
2181 return { 'error' => $session } if $context eq 'error';
2183 my $svc_forward = _customer_svc_x( $custnum,
2184 { 'srcsvc' => $p->{'svcnum'} },
2187 or return { 'error' => '',
2191 return { 'error' => '',
2192 'dst' => $svc_forward->dst || $svc_forward->dstsvc_acct->email,
2197 sub process_acct_forward {
2199 my($context, $session, $custnum) = _custoragent_session_custnum($p);
2200 return { 'error' => $session } if $context eq 'error';
2202 my $old = _customer_svc_x( $custnum,
2203 { 'srcsvc' => $p->{'svcnum'} },
2207 if ( $p->{'dst'} eq '' ) {
2209 my $error = $old->delete;
2210 return { 'error' => $error };
2212 return { 'error' => '' };
2215 my $new = new FS::svc_forward { 'srcsvc' => $p->{'svcnum'},
2216 'dst' => $p->{'dst'},
2221 $new->svcnum($old->svcnum);
2222 my $cust_svc = $old->cust_svc;
2223 $new->svcpart($old->svcpart);
2224 $new->pkgnuym($old->pkgnum);
2225 $error = $new->replace($old);
2227 my $conf = new FS::Conf;
2228 $new->svcpart($conf->config('selfservice-svc_forward_svcpart'));
2230 my $svc_acct = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_acct' )
2231 or return { 'error' => 'No service' }; #how would we even get here?
2233 $new->pkgnum( $svc_acct->cust_svc->pkgnum );
2235 $error = $new->insert;
2238 return { 'error' => $error };
2242 sub list_dsl_devices {
2245 my($context, $session, $custnum) = _custoragent_session_custnum($p);
2246 return { 'error' => $session } if $context eq 'error';
2248 my $svc_dsl = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_dsl' )
2249 or return { 'error' => "Service not found" };
2252 'devices' => [ map {
2253 +{ 'mac_addr' => $_->mac_addr };
2254 } $svc_dsl->dsl_device
2260 sub add_dsl_device {
2263 my($context, $session, $custnum) = _custoragent_session_custnum($p);
2264 return { 'error' => $session } if $context eq 'error';
2266 my $svc_dsl = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_dsl' )
2267 or return { 'error' => "Service not found" };
2269 return { 'error' => 'No MAC address supplied' }
2270 unless length($p->{'mac_addr'});
2272 my $dsl_device = new FS::dsl_device { 'svcnum' => $svc_dsl->svcnum,
2273 'mac_addr' => scalar($p->{'mac_addr'}),
2275 my $error = $dsl_device->insert;
2276 return { 'error' => $error };
2280 sub delete_dsl_device {
2283 my($context, $session, $custnum) = _custoragent_session_custnum($p);
2284 return { 'error' => $session } if $context eq 'error';
2286 my $svc_dsl = _customer_svc_x( $custnum, $p->{'svcnum'}, 'svc_dsl' )
2287 or return { 'error' => "Service not found" };
2289 my $dsl_device = qsearchs('dsl_device', { 'svcnum' => $svc_dsl->svcnum,
2290 'mac_addr' => scalar($p->{'mac_addr'}),
2293 or return { 'error' => 'Unknown MAC address: '. $p->{'mac_addr'} };
2295 my $error = $dsl_device->delete;
2296 return { 'error' => $error };
2302 _usage_details( \&_port_graph, $p,
2303 'svcdb' => 'svc_port',
2308 my($svc_port, $begin, $end) = @_;
2310 my $pngOrError = $svc_port->graph_png( start=>$begin, end=> $end );
2311 push @usage, { 'png' => $pngOrError };
2315 sub _list_svc_usage {
2316 my($svc_acct, $begin, $end) = @_;
2318 foreach my $part_export (
2319 map { qsearch ( 'part_export', { 'exporttype' => $_ } ) }
2320 qw( sqlradius sqlradius_withdomain )
2322 push @usage, @ { $part_export->usage_sessions($begin, $end, $svc_acct) };
2327 sub list_svc_usage {
2328 _usage_details(\&_list_svc_usage, @_);
2331 sub _list_support_usage {
2332 my($svc_acct, $begin, $end) = @_;
2334 foreach ( grep { $begin <= $_->_date && $_->_date <= $end }
2335 qsearch('acct_rt_transaction', { 'svcnum' => $svc_acct->svcnum })
2337 push @usage, { 'seconds' => $_->seconds,
2338 'support' => $_->support,
2339 '_date' => $_->_date,
2340 'id' => $_->transaction_id,
2341 'creator' => $_->creator,
2342 'subject' => $_->subject,
2343 'status' => $_->status,
2344 'ticketid' => $_->ticketid,
2350 sub list_support_usage {
2351 _usage_details(\&_list_support_usage, @_);
2354 sub _list_cdr_usage {
2355 # XXX CDR type support...
2356 # XXX any way to do a paged search on this?
2357 # we have to return the results all at once...
2358 my($svc_x, $begin, $end, %opt) = @_;
2359 map [ $_->downstream_csv(%opt, 'keeparray' => 1) ],
2363 'disable_charged_party' => 1,
2368 sub list_cdr_usage {
2370 _usage_details( \&_list_cdr_usage, $p );
2373 sub _usage_details {
2374 my($callback, $p, %opt) = @_;
2375 my $conf = FS::Conf->new;
2377 if ( $conf->exists('selfservice_hide-usage') ) {
2378 return { 'error' => 'Viewing usage is not allowed.' };
2381 my($context, $session, $custnum) = _custoragent_session_custnum($p);
2382 return { 'error' => $session } if $context eq 'error';
2384 my $search = { 'svcnum' => $p->{'svcnum'} };
2385 $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
2387 my $cust_svc = qsearchs( 'cust_svc', $search );
2388 return { 'error' => 'No service selected in list_svc_usage' }
2391 my $svc_x = $cust_svc->svc_x;
2392 my $svcdb = $svc_x->table;
2393 my $cust_pkg = $cust_svc->cust_pkg;
2394 my $freq = $cust_pkg->part_pkg->freq;
2397 if ( $svcdb eq 'svc_phone' or $svcdb eq 'svc_pbx' ) {
2399 if ( $p->{inbound} ) {
2400 $format = $cust_pkg->part_pkg->option('selfservice_inbound_format')
2401 || $conf->config('selfservice-default_inbound_cdr_format')
2402 || 'source_default';
2403 $callback_opt{inbound} = 1;
2405 $format = $cust_pkg->part_pkg->option('selfservice_format')
2406 || $conf->config('selfservice-default_cdr_format')
2410 $callback_opt{format} = $format;
2411 $callback_opt{use_clid} = 1;
2412 $header = [ split(',', FS::cdr::invoice_header($format) ) ];
2415 my $start = $cust_pkg->setup;
2416 #my $end = $cust_pkg->bill; # or time?
2419 unless ( $p->{beginning} ) {
2420 $p->{beginning} = $cust_pkg->last_bill;
2421 $p->{ending} = $end;
2424 die "illegal beginning" if $p->{beginning} !~ /^\d*$/;
2425 die "illegal ending" if $p->{ending} !~ /^\d*$/;
2427 my (@usage) = &$callback($svc_x, $p->{beginning}, $p->{ending},
2431 if ( $conf->exists('selfservice-hide_cdr_price') ) {
2432 # ugly kludge, I know
2433 my ($delete_col) = grep { $header->[$_] eq 'Price' } (0..scalar(@$header));
2434 if (defined $delete_col) {
2435 delete($_->[$delete_col]) foreach ($header, @usage);
2439 #kinda false laziness with FS::cust_main::bill, but perhaps
2440 #we should really change this bit to DateTime and DateTime::Duration
2442 #change this bit to use Date::Manip? CAREFUL with timezones (see
2443 # mailing list archive)
2444 my ($nsec,$nmin,$nhour,$nmday,$nmon,$nyear) =
2445 (localtime($p->{ending}) )[0,1,2,3,4,5];
2446 my ($psec,$pmin,$phour,$pmday,$pmon,$pyear) =
2447 (localtime($p->{beginning}) )[0,1,2,3,4,5];
2449 if ( $freq =~ /^\d+$/ ) {
2451 until ( $nmon < 12 ) { $nmon -= 12; $nyear++; }
2453 until ( $pmon >= 0 ) { $pmon += 12; $pyear--; }
2454 } elsif ( $freq =~ /^(\d+)w$/ ) {
2456 $nmday += $weeks * 7;
2457 $pmday -= $weeks * 7;
2458 } elsif ( $freq =~ /^(\d+)d$/ ) {
2462 } elsif ( $freq =~ /^(\d+)h$/ ) {
2467 return { 'error' => "unparsable frequency: ". $freq };
2470 my $previous = timelocal_nocheck($psec,$pmin,$phour,$pmday,$pmon,$pyear);
2471 my $next = timelocal_nocheck($nsec,$nmin,$nhour,$nmday,$nmon,$nyear);
2475 'svcnum' => $p->{svcnum},
2476 'beginning' => $p->{beginning},
2477 'ending' => $p->{ending},
2478 'inbound' => $p->{inbound},
2479 'previous' => ($previous > $start) ? $previous : $start,
2480 'next' => ($next < $end) ? $next : $end,
2481 'header' => $header,
2489 my($context, $session, $custnum) = _custoragent_session_custnum($p);
2490 return { 'error' => $session } if $context eq 'error';
2492 my $search = { 'custnum' => $custnum };
2493 $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
2494 my $cust_main = qsearchs('cust_main', $search )
2495 or return { 'error' => "unknown custnum $custnum" };
2497 my $status = $cust_main->status;
2499 my %order_pkg_options = ();
2500 if ( $p->{locationnum} > 0 ) {
2501 $order_pkg_options{locationnum} = delete($p->{locationnum});
2502 } elsif ( $p->{address1} ) {
2503 $order_pkg_options{'cust_location'} = new FS::cust_location {
2504 map { $_ => $p->{$_} }
2505 qw( address1 address2 city county state zip country )
2509 #false laziness w/ClientAPI/Signup.pm
2511 my $cust_pkg = new FS::cust_pkg ( {
2512 'custnum' => $custnum,
2513 'pkgpart' => $p->{'pkgpart'},
2514 'quantity' => $p->{'quantity'} || 1,
2516 my $error = $cust_pkg->check;
2517 return { 'error' => $error } if $error;
2520 unless ( $p->{'svcpart'} eq 'none' ) {
2524 if ( $p->{'svcpart'} =~ /^(\d+)$/ ) {
2526 my $part_svc = qsearchs('part_svc', { 'svcpart' => $svcpart } );
2527 return { 'error' => "Unknown svcpart $svcpart" } unless $part_svc;
2528 $svcdb = $part_svc->svcdb;
2530 $svcdb = 'svc_acct';
2532 $svcpart ||= $cust_pkg->part_pkg->svcpart($svcdb);
2535 'svc_acct' => [ qw( username domsvc _password sec_phrase popnum ) ],
2536 'svc_domain' => [ qw( domain ) ],
2537 'svc_phone' => [ qw( phonenum pin sip_password phone_name ) ],
2538 'svc_external' => [ qw( id title ) ],
2539 'svc_pbx' => [ qw( id title ) ],
2542 my $svc_x = "FS::$svcdb"->new( {
2543 'svcpart' => $svcpart,
2544 map { $_ => $p->{$_} } @{$fields{$svcdb}}
2547 if ( $svcdb eq 'svc_acct' && exists($p->{"snarf_machine1"}) ) {
2550 while ( length($p->{"snarf_machine$snarfnum"}) ) {
2551 my $acct_snarf = new FS::acct_snarf ( {
2552 'machine' => $p->{"snarf_machine$snarfnum"},
2553 'protocol' => $p->{"snarf_protocol$snarfnum"},
2554 'username' => $p->{"snarf_username$snarfnum"},
2555 '_password' => $p->{"snarf_password$snarfnum"},
2558 push @acct_snarf, $acct_snarf;
2560 $svc_x->child_objects( \@acct_snarf );
2563 my $y = $svc_x->setdefault; # arguably should be in new method
2564 return { 'error' => $y } if $y && !ref($y);
2566 $error = $svc_x->check;
2567 return { 'error' => $error } if $error;
2573 $error = $cust_main->order_pkg(
2574 'cust_pkg' => $cust_pkg,
2579 return { 'error' => $error } if $error;
2581 my $conf = new FS::Conf;
2582 if ( $conf->exists('signup_server-realtime') ) {
2584 my $bill_error = _do_bop_realtime( $cust_main, $status, 'collect'=>$p->{run_bill_events} );
2587 $cust_pkg->cancel('quiet'=>1);
2590 $cust_pkg->reexport;
2594 $cust_pkg->reexport;
2597 my $svcnum = $svc[0] ? $svc[0]->svcnum : '';
2599 return { error=>'', pkgnum=>$cust_pkg->pkgnum, svcnum=>$svcnum };
2606 my($context, $session, $custnum) = _custoragent_session_custnum($p);
2607 return { 'error' => $session } if $context eq 'error';
2609 my $conf = new FS::Conf;
2610 my $immutable = $conf->exists('selfservice_immutable-package');
2611 return { 'error' => "Package modification disabled" } if $immutable;
2613 my $search = { 'custnum' => $custnum };
2614 $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
2615 my $cust_main = qsearchs('cust_main', $search )
2616 or return { 'error' => "unknown custnum $custnum" };
2618 my $status = $cust_main->status;
2619 my $cust_pkg = qsearchs('cust_pkg', { 'pkgnum' => $p->{pkgnum} } )
2620 or return { 'error' => "unknown package $p->{pkgnum}" };
2622 #if someone does need self-service package change of suspended packages,
2623 # figure out how to be more discriminating
2624 return { error=>"Can't change a suspended package", pkgnum=>$cust_pkg->pkgnum}
2625 if $cust_pkg->status eq 'suspended';
2627 my $err_or_cust_pkg = $cust_pkg->change( 'pkgpart' => $p->{'pkgpart'},
2628 'quantity' => $p->{'quantity'} || 1,
2631 my $new_pkg = qsearchs('part_pkg', { 'pkgpart' => $p->{pkgpart} } )
2632 or return { 'error' => "unknown package $p->{pkgpart}" };
2634 return { error=>$err_or_cust_pkg, pkgnum=>$cust_pkg->pkgnum }
2635 unless ref($err_or_cust_pkg);
2638 if ( $conf->exists('signup_server-realtime') ) {
2640 my $bill_error = _do_bop_realtime( $cust_main, $status, 'no_invoice_void'=>1 );
2643 $err_or_cust_pkg->suspend;
2646 $err_or_cust_pkg->reexport;
2650 $err_or_cust_pkg->reexport;
2653 return { error => '', pkg => $new_pkg->pkg, pkgnum => $err_or_cust_pkg->pkgnum };
2657 sub order_recharge {
2660 my($context, $session, $custnum) = _custoragent_session_custnum($p);
2661 return { 'error' => $session } if $context eq 'error';
2663 my $search = { 'custnum' => $custnum };
2664 $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
2665 my $cust_main = qsearchs('cust_main', $search )
2666 or return { 'error' => "unknown custnum $custnum" };
2668 my $status = $cust_main->status;
2669 my $cust_svc = qsearchs( 'cust_svc', { 'svcnum' => $p->{'svcnum'} } )
2670 or return { 'error' => "unknown service " . $p->{'svcnum'} };
2672 my $svc_x = $cust_svc->svc_x;
2673 my $part_pkg = $cust_svc->cust_pkg->part_pkg;
2676 map { $_ =~ /^recharge_(.*)$/; $1, $part_pkg->option($_, 1) }
2677 qw ( recharge_seconds recharge_upbytes recharge_downbytes
2678 recharge_totalbytes );
2679 my $amount = $part_pkg->option('recharge_amount', 1);
2681 my ($l, $v, $d) = $cust_svc->label; # blah
2682 my $pkg = "Recharge $v";
2684 my $bill_error = $cust_main->charge($amount, $pkg,
2685 "time: $vhash{seconds}, up: $vhash{upbytes}," .
2686 "down: $vhash{downbytes}, total: $vhash{totalbytes}",
2687 $part_pkg->taxclass); #meh
2689 my $conf = new FS::Conf;
2690 if ( $conf->exists('signup_server-realtime') && !$bill_error ) {
2692 $bill_error = _do_bop_realtime( $cust_main, $status );
2697 my $error = $svc_x->recharge (\%vhash);
2698 return { 'error' => $error } if $error;
2702 my $error = $bill_error;
2703 $error ||= $svc_x->recharge (\%vhash);
2704 return { 'error' => $error } if $error;
2707 return { error => '', svc => $cust_svc->part_svc->svc };
2711 sub _do_bop_realtime {
2712 my ($cust_main, $status, %opt) = @_;
2714 my $old_balance = $cust_main->balance;
2717 my $bill_error = $cust_main->bill(
2718 'return_bill' => \@cust_bill,
2721 $bill_error ||= $cust_main->apply_payments_and_credits;
2723 $bill_error ||= $cust_main->realtime_collect('selfservice' => 1);
2725 if ( $cust_main->balance > $old_balance
2726 && $cust_main->balance > 0
2727 && ( $cust_main->has_cust_payby_auto || $status eq 'suspended' )
2730 unless ( $opt{'no_invoice_void'} ) {
2732 #this used to apply a credit, but now we can void invoices...
2733 foreach my $cust_bill (@cust_bill) {
2734 my $voiderror = $cust_bill->void('automatic payment failed');
2735 warn "Error voiding cust bill after decline: $voiderror" if $voiderror;
2740 return { 'error' => '_decline', 'bill_error' => $bill_error };
2743 if ( $opt{'collect'} ) {
2744 my $collect_error = $cust_main->collect();
2745 return { 'error' => '_decline', 'bill_error' => $collect_error }
2746 if $collect_error; #?
2755 my($context, $session, $custnum) = _custoragent_session_custnum($p);
2756 return { 'error' => $session } if $context eq 'error';
2758 my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
2759 or return { 'error' => "unknown custnum $custnum" };
2761 my @cust_pkg = sort { $a->bill <=> $b->bill }
2762 grep { $_->part_pkg->freq ne '0' }
2763 $cust_main->ncancelled_pkgs;
2765 #return { 'error' => 'No active packages to renew.' } unless @cust_pkg;
2767 my $total = $cust_main->balance;
2770 my $bill = $_->bill;
2771 $total += $_->part_pkg->base_recur($_, \$bill);
2772 my $renew_date = $_->part_pkg->add_freq($_->bill);
2774 'pkgnum' => $_->pkgnum,
2775 'amount' => sprintf('%.2f', $total),
2776 'bill_date' => $_->bill,
2777 'bill_date_pretty' => time2str('%x', $_->bill),
2778 'renew_date' => $renew_date,
2779 'renew_date_pretty' => time2str('%x', $renew_date),
2780 'expire_date' => $_->expire,
2781 'expire_date_pretty' => time2str('%x', $_->expire),
2786 return { 'dates' => \@array };
2790 sub payment_info_renew_info {
2792 my $renew_info = renew_info($p);
2793 my $payment_info = payment_info($p);
2794 return { %$renew_info,
2802 my($context, $session, $custnum) = _custoragent_session_custnum($p);
2803 return { 'error' => $session } if $context eq 'error';
2805 my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
2806 or return { 'error' => "unknown custnum $custnum" };
2808 my $date = $p->{'date'};
2812 #freeside-daily -n -d $date fs_daily $custnum
2813 $cust_main->bill_and_collect( 'time' => $date,
2814 'invoice_time' => $now,
2815 'actual_time' => $now,
2816 'check_freq' => '1d',
2819 return { 'error' => '' };
2825 my $session = _cache->get($p->{'session_id'})
2826 or return { 'error' => "Can't resume session" }; #better error message
2828 my $custnum = $session->{'custnum'};
2830 my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
2831 or return { 'error' => "unknown custnum $custnum" };
2833 my $conf = new FS::Conf;
2835 $conf->config('selfservice-self_suspend_reason', $cust_main->agentnum)
2836 or return { 'error' => 'Permission denied' };
2838 my $pkgnum = $p->{'pkgnum'};
2840 my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
2841 'pkgnum' => $pkgnum, } )
2842 or return { 'error' => "unknown pkgnum $pkgnum" };
2844 my $error = $cust_pkg->suspend(reason => $reasonnum);
2845 return { 'error' => $error };
2851 my $session = _cache->get($p->{'session_id'})
2852 or return { 'error' => "Can't resume session" }; #better error message
2854 my $custnum = $session->{'custnum'};
2855 my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
2856 or return { 'error' => "unknown custnum $custnum" };
2858 my $pkgnum = $p->{'pkgnum'};
2859 my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
2860 'pkgnum' => $pkgnum, } )
2861 or return { 'error' => "unknown pkgnum $pkgnum" };
2863 my $error = $cust_pkg->cancel( 'quiet' => 1,
2864 'date' => $p->{'date'},
2866 return { 'error' => $error };
2869 sub provision_phone {
2872 @bulkdid = @{$p->{'bulkdid'}} if $p->{'bulkdid'};
2874 #editing an existing phone number
2875 if ( $p->{'svcnum'} && $p->{'svcnum'} =~ /^\d+$/ ) {
2876 my($context, $session, $custnum) = _custoragent_session_custnum($p);
2877 return { 'error' => $session } if $context eq 'error';
2879 my $svc_phone = qsearchs('svc_phone', { svcnum => $p->{'svcnum'} });
2880 return { 'error' => 'service not found' } unless $svc_phone;
2881 return { 'error' => 'invalid svcnum' }
2882 if $svc_phone && $svc_phone->cust_svc->cust_pkg->custnum != $custnum;
2884 $svc_phone->email($p->{'email'})
2885 if $svc_phone->email ne $p->{'email'} && $p->{'email'} =~ /^([\w\.\d@]+|)$/;
2886 $svc_phone->forwarddst($p->{'forwarddst'})
2887 if $svc_phone->forwarddst ne $p->{'forwarddst'}
2888 && $p->{'forwarddst'} =~ /^(\d+|)$/;
2889 return { 'error' => $svc_phone->replace };
2893 unless ( $p->{'lnp'} ) {
2894 $p->{'lnp_desired_due_date'} = parse_datetime($p->{'lnp_desired_due_date'});
2895 $p->{'lnp_status'} = "portingin";
2896 return _provision( 'FS::svc_phone',
2897 [qw(lnp_desired_due_date lnp_other_provider
2898 lnp_other_provider_account phonenum countrycode lnp_status)],
2899 [qw(phonenum countrycode)],
2905 # single DID order (the usual case)
2906 unless (scalar(@bulkdid)) {
2907 return _provision( 'FS::svc_phone',
2908 [qw(phonenum countrycode)],
2909 [qw(phonenum countrycode)],
2915 # bulk DID order case
2917 foreach my $did ( @bulkdid ) {
2918 $did =~ s/[^0-9]//g;
2919 $error = _provision( 'FS::svc_phone',
2920 [qw(phonenum countrycode)],
2921 [qw(phonenum countrycode)],
2923 'pkgnum' => $p->{'pkgnum'},
2924 'svcpart' => $p->{'svcpart'},
2926 'countrycode' => $p->{'countrycode'},
2927 'session_id' => $p->{'session_id'},
2930 return $error if ($error->{'error'} && length($error->{'error'}) > 1);
2932 { 'bulkdid' => [ @bulkdid ], 'svc' => $error->{'svc'} }
2937 warn "provision_pbx called\n"
2940 warn "provision_pbx calling _provision\n"
2942 _provision( 'FS::svc_pbx',
2943 [qw(id title max_extensions max_simultaneous ip_addr)],
2944 [qw(id title max_extensions max_simultaneous ip_addr)],
2950 sub provision_acct {
2952 warn "provision_acct called\n"
2955 return { 'error' => gettext('passwords_dont_match') }
2956 if $p->{'_password'} ne $p->{'_password2'};
2957 return { 'error' => gettext('empty_password') }
2958 unless length($p->{'_password'});
2960 if ($p->{'domsvc'}) {
2961 my %domains = domain_select_hash FS::svc_acct(map { $_ => $p->{$_} }
2962 qw ( svcpart pkgnum ) );
2963 return { 'error' => gettext('invalid_domain') }
2964 unless ($domains{$p->{'domsvc'}});
2967 warn "provision_acct calling _provision\n"
2969 _provision( 'FS::svc_acct',
2970 [qw(username _password domsvc)],
2971 [qw(username _password domsvc)],
2977 sub provision_external {
2979 #_provision( 'FS::svc_external', [qw(id title)], [qw(id title)], $p, @_ );
2980 _provision( 'FS::svc_external',
2988 sub provision_forward {
2990 _provision( 'FS::svc_forward',
2991 ['srcsvc','src','dstsvc','dst'],
2998 my( $class, $fields, $return_fields, $p ) = splice(@_, 0, 4);
2999 warn "_provision called for $class\n"
3002 my($context, $session, $custnum) = _custoragent_session_custnum($p);
3003 return { 'error' => $session } if $context eq 'error';
3005 my $search = { 'custnum' => $custnum };
3006 $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
3007 my $cust_main = qsearchs('cust_main', $search )
3008 or return { 'error' => "unknown custnum $custnum" };
3010 my $pkgnum = $p->{'pkgnum'};
3012 warn "searching for custnum $custnum pkgnum $pkgnum\n"
3014 my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
3015 'pkgnum' => $pkgnum,
3017 or return { 'error' => "unknown pkgnum $pkgnum" };
3019 warn "searching for svcpart ". $p->{'svcpart'}. "\n"
3021 my $part_svc = qsearchs('part_svc', { 'svcpart' => $p->{'svcpart'} } )
3022 or return { 'error' => "unknown svcpart $p->{'svcpart'}" };
3024 return { error=> 'svcpart '. $p->{'svcpart'}. " is not a $class definition" }
3025 if $class ne 'FS::'. $part_svc->svcdb;
3027 warn "creating $class record\n"
3029 my $svc_x = $class->new( {
3030 'pkgnum' => $p->{'pkgnum'},
3031 'svcpart' => $p->{'svcpart'},
3032 map { $_ => $p->{$_} } @$fields
3035 my %insert_args = ();
3036 #i shouldn't be a special case here (pass an option or something)
3037 if ( $class eq 'FS::svc_phone'
3038 && grep length($p->{$_}), @location_editable_fields
3041 $insert_args{'cust_location'} = new FS::cust_location {
3042 map { $_ => $p->{$_} } @location_editable_fields
3046 warn "inserting $class record\n"
3048 my $error = $svc_x->insert(%insert_args);
3051 warn "finding inserted record for svcnum ". $svc_x->svcnum. "\n"
3053 $svc_x = qsearchs($svc_x->table, { 'svcnum' => $svc_x->svcnum })
3056 my $return = { 'svc' => $part_svc->svc,
3058 map { $_ => $svc_x->get($_) } @$return_fields
3060 warn "_provision returning ". Dumper($return). "\n"
3069 my($context, $session, $custnum) = _custoragent_session_custnum($p);
3070 return { 'error' => $session } if $context eq 'error';
3072 my $search = { 'custnum' => $custnum };
3073 $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
3074 my $cust_main = qsearchs('cust_main', $search )
3075 or return { 'error' => "unknown custnum $custnum" };
3077 my $pkgnum = $p->{'pkgnum'};
3079 my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
3080 'pkgnum' => $pkgnum,
3082 or return { 'error' => "unknown pkgnum $pkgnum" };
3084 my $svcpart = $p->{'svcpart'};
3086 my $pkg_svc = qsearchs('pkg_svc', { 'pkgpart' => $cust_pkg->pkgpart,
3087 'svcpart' => $svcpart, } )
3088 or return { 'error' => "unknown svcpart $svcpart for pkgnum $pkgnum" };
3089 my $part_svc = $pkg_svc->part_svc;
3091 my $conf = new FS::Conf;
3094 'svc' => $part_svc->svc,
3095 'svcdb' => $part_svc->svcdb,
3096 'pkgnum' => $pkgnum,
3097 'svcpart' => $svcpart,
3098 'custnum' => $custnum,
3100 'security_phrase' => 0, #XXX !
3101 'svc_acct_pop' => [], #XXX !
3103 'init_popstate' => '',
3108 small_custview( $cust_main, $conf->config('countrydefault') ),
3112 if ($p->{'svcnum'} && $p->{'svcnum'} =~ /^\d+$/
3113 && $ret->{'svcdb'} eq 'svc_phone') {
3114 $ret->{'svcnum'} = $p->{'svcnum'};
3115 my $svc_phone = qsearchs('svc_phone', { svcnum => $p->{'svcnum'} });
3116 if ( $svc_phone && $svc_phone->cust_svc->cust_pkg->custnum == $custnum ) {
3117 $ret->{'email'} = $svc_phone->email;
3118 $ret->{'forwarddst'} = $svc_phone->forwarddst;
3122 if ($ret->{'svcdb'} eq 'svc_forward') {
3123 $ret->{'forward_emails'} = {$cust_pkg->forward_emails()};
3129 sub unprovision_svc {
3132 my($context, $session, $custnum) = _custoragent_session_custnum($p);
3133 return { 'error' => $session } if $context eq 'error';
3135 my $search = { 'custnum' => $custnum };
3136 $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
3137 my $cust_main = qsearchs('cust_main', $search )
3138 or return { 'error' => "unknown custnum $custnum" };
3140 my $svcnum = $p->{'svcnum'};
3142 my $cust_svc = qsearchs('cust_svc', { 'svcnum' => $svcnum, } )
3143 or return { 'error' => "unknown svcnum $svcnum" };
3145 return { 'error' => "Service $svcnum does not belong to customer $custnum" }
3146 unless $cust_svc->cust_pkg->custnum == $custnum;
3148 my $conf = new FS::Conf;
3150 return { 'svc' => $cust_svc->part_svc->svc,
3151 'error' => $cust_svc->cancel,
3153 small_custview( $cust_main, $conf->config('countrydefault') ),
3158 sub myaccount_passwd {
3160 my($context, $session, $custnum) = _custoragent_session_custnum($p);
3161 return { 'error' => $session } if $context eq 'error';
3163 return { 'error' => "New passwords don't match." }
3164 if $p->{'new_password'} ne $p->{'new_password2'};
3166 return { 'error' => 'Enter new password' }
3167 unless length($p->{'new_password'});
3169 #my $search = { 'custnum' => $custnum };
3170 #$search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
3171 $custnum =~ /^(\d+)$/ or die "illegal custnum";
3172 my $search = " AND custnum = $1";
3173 $search .= " AND agentnum = ". $session->{'agentnum'} if $context eq 'agent';
3175 my $svc_acct = qsearchs( {
3176 'table' => 'svc_acct',
3177 'addl_from' => 'LEFT JOIN cust_svc USING ( svcnum ) '.
3178 'LEFT JOIN cust_pkg USING ( pkgnum ) '.
3179 'LEFT JOIN cust_main USING ( custnum ) ',
3180 'hashref' => { 'svcnum' => $p->{'svcnum'}, },
3181 'extra_sql' => $search, #important
3183 or return { 'error' => "Service not found" };
3187 my $conf = new FS::Conf;
3189 return { 'error' => 'Incorrect current password.' }
3190 if ( exists($p->{'old_password'})
3191 || $conf->exists('selfservice-password_change_oldpass')
3193 && ! $svc_acct->check_password($p->{'old_password'});
3195 $error ||= $svc_acct->is_password_allowed($p->{'new_password'})
3196 || $svc_acct->set_password($p->{'new_password'})
3197 || $svc_acct->replace();
3199 #regular pw change in self-service should change contact pw too, otherwise its
3200 #way too confusing. hell its confusing they're separate at all, but alas.
3201 #need to support the "ISP provides email that's used as a contact email" case
3203 my $contact = FS::contact->by_selfservice_email($svc_acct->email);
3204 if ( $contact && qsearchs('cust_contact', { contactnum=> $contact->contactnum,
3205 custnum => $custnum,
3206 selfservice_access => 'Y',
3210 #svc_acct was successful but this one returns an error? "shouldn't happen"
3211 #don't recheck is_password_allowed here; if the svc_acct password was
3212 #legal, that's good enough
3213 $error ||= $contact->change_password($p->{'new_password'});
3216 my($label, $value) = $svc_acct->cust_svc->label;
3218 return { 'error' => $error,
3228 my $info = skin_info($p);
3230 my $conf = new FS::Conf;
3231 my $verification = $conf->config('selfservice-password_reset_verification')
3232 or return { %$info, 'error' => 'Password resets disabled' };
3237 if ( $p->{'email'} ) { #new-style, changes contact and svc_acct
3239 $contact = FS::contact->by_selfservice_email($p->{'email'});
3242 my @cust_contact = grep $_->selfservice_access, $contact->cust_contact;
3243 $cust_main = $cust_contact[0]->cust_main if scalar(@cust_contact) == 1;
3246 #also look for an svc_acct, otherwise it would be super confusing
3248 my($username, $domain) = split('@', $p->{'email'});
3249 my $svc_domain = qsearchs('svc_domain', { 'domain' => $domain } );
3250 if ( $svc_domain ) {
3251 $svc_acct = qsearchs('svc_acct', { 'username' => $username,
3252 'domsvc' => $svc_domain->svcnum }
3255 my $cust_pkg = $svc_acct->cust_svc->cust_pkg;
3256 $cust_main ||= $cust_pkg->cust_main if $cust_pkg;
3258 #precaution: don't change svc_acct password not part of the same
3259 # customer as contact
3260 $svc_acct = '' if ! $cust_pkg
3261 || $cust_pkg->custnum != $cust_main->custnum;
3266 return { %$info, 'error' => 'Email address not found' }
3267 unless $contact || $svc_acct;
3269 } elsif ( $p->{'username'} ) { #old style, looks in svc_acct only
3271 my $svc_domain = qsearchs('svc_domain', { 'domain' => $p->{'domain'} } )
3272 or return { %$info, 'error' => 'Account not found' };
3274 $svc_acct = qsearchs('svc_acct', { 'username' => $p->{'username'},
3275 'domsvc' => $svc_domain->svcnum }
3277 or return { %$info, 'error' => 'Account not found' };
3279 my $cust_pkg = $svc_acct->cust_svc->cust_pkg
3280 or return { %$info, 'error' => 'Account not found' };
3282 $cust_main = $cust_pkg->cust_main;
3286 return { %$info, 'error' => 'Multi-customer contacts incompatible with customer-based verification' }
3287 if ! $cust_main && $verification ne 'email';
3290 'email' => sub { 1; },
3292 my( $p, $cust_main ) = @_;
3293 $cust_main->payby =~ /^(CARD|DCRD|CHEK|DCHK)$/
3294 && $p->{'paymask'} eq substr($cust_main->paymask, -4)
3297 my( $p, $cust_main ) = @_;
3298 my $cust_pay = qsearchs({
3299 'table' => 'cust_pay',
3300 'hashref' => { 'custnum' => $cust_main->custnum },
3301 'order_by' => 'ORDER BY _date DESC LIMIT 1',
3305 $p->{'amount'} == $cust_pay->paid;
3308 my( $p, $cust_main ) = @_;
3309 $p->{'zip'} eq $cust_main->zip
3310 || ( $cust_main->ship_zip && $p->{'zip'} eq $cust_main->ship_zip );
3314 foreach my $verify ( split(',', $verification) ) {
3316 &{ $verify{$verify} }( $p, $cust_main )
3317 or return { %$info, 'error' => 'Account not found' };
3321 #okay, we're verified
3325 my $error = $contact->send_reset_email(
3326 'svcnum' => ($svc_acct ? $svc_acct->svcnum : ''),
3330 return { %$info, 'error' => $error }; #????
3333 } elsif ( $svc_acct ) {
3335 #create a unique session
3337 my $reset_session = {
3338 'svcnum' => $svc_acct->svcnum,
3339 'agentnum' => $svc_acct->cust_main->agentnum,
3342 my $timeout = '1 hour'; #?
3344 my $reset_session_id;
3346 $reset_session_id = sha512_hex(time(). {}. rand(). $$)
3347 } until ( ! defined _cache->get("reset_passwd_$reset_session_id") );
3350 _cache->set( "reset_passwd_$reset_session_id", $reset_session, $timeout );
3354 my $msgnum = $conf->config('selfservice-password_reset_msgnum',
3355 $cust_main->agentnum);
3356 #die "selfservice-password_reset_msgnum unset" unless $msgnum;
3357 return { %$info, 'error' => "selfservice-password_reset_msgnum unset" }
3359 my $msg_template = qsearchs('msg_template', { msgnum => $msgnum } );
3360 my $error = $msg_template->send( 'cust_main' => $cust_main,
3361 'object' => $svc_acct,
3362 'substitutions' => {
3363 'session_id' => $reset_session_id,
3367 return { %$info, 'error' => $error }; #????
3372 return { %$info, 'error' => '' };
3375 sub check_reset_passwd {
3378 my $conf = new FS::Conf;
3379 my $verification = $conf->config('selfservice-password_reset_verification')
3380 or return { 'error' => 'Password resets disabled' };
3382 my $reset_session = _cache->get('reset_passwd_'. $p->{'session_id'})
3383 or return { 'error' => "Can't resume session" }; #better error message
3385 if ( $reset_session->{'svcnum'} ) {
3387 my $svcnum = $reset_session->{'svcnum'};
3389 my $svc_acct = qsearchs('svc_acct', { 'svcnum' => $svcnum } )
3390 or return { 'error' => "Service not found" };
3392 $p->{'agentnum'} = $svc_acct->cust_svc->cust_pkg->cust_main->agentnum;
3393 my $info = skin_info($p);
3397 'session_id' => $p->{'session_id'},
3398 'username' => $svc_acct->username,
3401 } elsif ( $reset_session->{'contactnum'} ) {
3403 my $contactnum = $reset_session->{'contactnum'};
3405 my $contact = qsearchs('contact', { 'contactnum' => $contactnum } )
3406 or return { 'error' => "Contact not found" };
3408 my @contact_email = $contact->contact_email;
3409 return { 'error' => 'No contact email' } unless @contact_email;
3411 my @cust_contact = grep $_->selfservice_access, $contact->cust_contact;
3412 $p->{'agentnum'} = $cust_contact[0]->cust_main->agentnum
3413 if scalar(@cust_contact) == 1;
3414 my $info = skin_info($p);
3418 'session_id' => $p->{'session_id'},
3419 'email' => $contact_email[0]->email, #the first?
3424 return { 'error' => 'No svcnum or contactnum in session' }; #??
3430 sub process_reset_passwd {
3433 my $conf = new FS::Conf;
3434 my $verification = $conf->config('selfservice-password_reset_verification')
3435 or return { 'error' => 'Password resets disabled' };
3437 my $reset_session = _cache->get('reset_passwd_'. $p->{'session_id'})
3438 or return { 'error' => "Can't resume session" }; #better error message
3443 if ( $reset_session->{'svcnum'} ) {
3445 my $svcnum = $reset_session->{'svcnum'};
3447 $svc_acct = qsearchs('svc_acct', { 'svcnum' => $svcnum } )
3448 or return { 'error' => "Service not found" };
3450 $p->{'agentnum'} ||= $svc_acct->cust_svc->cust_pkg->cust_main->agentnum;
3451 $info ||= skin_info($p);
3456 if ( $reset_session->{'contactnum'} ) {
3458 my $contactnum = $reset_session->{'contactnum'};
3460 $contact = qsearchs('contact', { 'contactnum' => $contactnum } )
3461 or return { 'error' => "Contact not found" };
3463 my @cust_contact = grep $_->selfservice_access, $contact->cust_contact;
3464 $p->{'agentnum'} = $cust_contact[0]->cust_main->agentnum
3465 if scalar(@cust_contact) == 1;
3466 $info ||= skin_info($p);
3470 return { %$info, 'error' => "New passwords don't match." }
3471 if $p->{'new_password'} ne $p->{'new_password2'};
3473 return { %$info, 'error' => 'Enter new password' }
3474 unless length($p->{'new_password'});
3478 my $error ||= $svc_acct->is_password_allowed($p->{'new_password'})
3479 || $svc_acct->set_password($p->{'new_password'})
3480 || $svc_acct->replace();
3482 return { %$info, 'error' => $error } if $error;
3484 #my($label, $value) = $svc_acct->cust_svc->label;
3485 #return { 'error' => $error,
3486 # #'label' => $label,
3487 # #'value' => $value,
3494 my $error = $contact->is_password_allowed($p->{'new_password'})
3495 || $contact->change_password($p->{'new_password'});
3497 return { %$info, 'error' => $error }; # if $error;
3501 #password changed ,so remove session, don't want it reused
3502 _cache->remove($p->{'session_id'});
3504 return { %$info, 'error' => '' };
3508 sub validate_passwd {
3512 %result = ( 'fieldid' => $p->{'fieldid'} )
3513 if $p->{'fieldid'} =~ /^\w+$/;
3515 return { %result, 'password_invalid' => 'Enter new password' }
3516 unless length($p->{'check_password'});
3519 if ($p->{'svcnum'}) {
3520 # false laziness with myaccount_passwd
3521 my($context, $session, $custnum) = _custoragent_session_custnum($p);
3522 return { %result, 'error' => $session } if $context eq 'error';
3524 $custnum =~ /^(\d+)$/ or die "illegal custnum";
3525 my $search = " AND custnum = $1";
3526 $search .= " AND agentnum = ". $session->{'agentnum'} if $context eq 'agent';
3528 $svc_acct = qsearchs( {
3529 'table' => 'svc_acct',
3530 'addl_from' => 'LEFT JOIN cust_svc USING ( svcnum ) '.
3531 'LEFT JOIN cust_pkg USING ( pkgnum ) '.
3532 'LEFT JOIN cust_main USING ( custnum ) ',
3533 'hashref' => { 'svcnum' => $p->{'svcnum'}, },
3534 'extra_sql' => $search, #important
3536 or return { %result, 'error' => "Service not found" };
3537 # end false laziness
3540 $svc_acct ||= new FS::svc_acct {};
3542 my $error = $svc_acct->is_password_allowed($p->{'check_password'});
3543 return { %result, 'password_invalid' => $error } if $error;
3544 return { %result, 'password_valid' => 1 };
3549 my($context, $session, $custnum) = _custoragent_session_custnum($p);
3550 return { 'error' => $session } if $context eq 'error';
3553 if ( $session->{'pkgnum'} ) {
3555 #tickets for specific service with pkg-balances on
3556 my $cust_pkg = qsearchs('cust_pkg', { 'custnum' => $custnum,
3557 'pkgnum' => $session->{'pkgnum'} })
3558 or return { 'error' => 'unknown package' };
3559 foreach my $cust_svc ( $cust_pkg->cust_svc ) {
3560 push @tickets, $cust_svc->tickets( $p->{status} );
3565 my $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } )
3566 or return { 'error' => "unknown custnum $custnum" };
3568 @tickets = $cust_main->tickets( $p->{status} );
3571 # unavoidable false laziness w/ httemplate/view/cust_main/tickets.html
3572 if ( $FS::TicketSystem::system && FS::TicketSystem->selfservice_priority ) {
3573 my $conf = new FS::Conf;
3574 my $dir = $conf->exists('ticket_system-priority_reverse') ? -1 : 1;
3578 ($a->{'_selfservice_priority'} eq '') <=>
3579 ($b->{'_selfservice_priority'} eq '')
3582 ($b->{'_selfservice_priority'} <=> $a->{'_selfservice_priority'})
3588 +{ tickets => \@tickets };
3595 my($context, $session, $custnum) = _custoragent_session_custnum($p);
3596 return { 'error' => $session } if $context eq 'error';
3598 warn "$me create_ticket: initializing ticket system\n" if $DEBUG;
3599 FS::TicketSystem->init();
3601 my $conf = new FS::Conf;
3602 my $queue = $p->{'queue'}
3603 || $conf->config('ticket_system-selfservice_queueid')
3604 || $conf->config('ticket_system-default_queueid');
3606 warn "$me create_ticket: creating ticket\n" if $DEBUG;
3607 my $err_or_ticket = FS::TicketSystem->create_ticket(
3608 '', #create RT session based on FS CurrentUser (fs_selfservice)
3610 'custnum' => $custnum,
3611 'svcnum' => $session->{'svcnum'},
3612 map { $_ => $p->{$_} } qw( requestor cc subject message mime_type )
3615 if ( ref($err_or_ticket) ) {
3616 warn "$me create_ticket: successful: ". $err_or_ticket->id. "\n"
3618 return { 'error' => '',
3619 'ticket_id' => $err_or_ticket->id,
3622 warn "$me create_ticket: unsuccessful: $err_or_ticket\n"
3624 return { 'error' => $err_or_ticket };
3632 my($context, $session, $custnum) = _custoragent_session_custnum($p);
3633 return { 'error' => $session } if $context eq 'error';
3635 return { error => 'requested format not implemented' }
3636 unless ($p->{'format'} eq 'csv' || $p->{'format'} eq 'xls');
3638 my $conf = new FS::Conf;
3639 my $age_threshold = 0;
3640 $age_threshold = time() - $conf->config('selfservice-recent-did-age')
3641 if ($p->{'recentonly'} && $conf->exists('selfservice-recent-did-age'));
3643 my $search = { 'custnum' => $custnum };
3644 $search->{'agentnum'} = $session->{'agentnum'} if $context eq 'agent';
3645 my $cust_main = qsearchs('cust_main', $search )
3646 or return { 'error' => "unknown custnum $custnum" };
3648 # does it make more sense to just run one sql query for this instead of all the
3649 # insanity below? would increase performance greately for large data sets?
3651 foreach my $cust_pkg ( $cust_main->ncancelled_pkgs ) {
3652 my @part_svc = $cust_pkg->part_svc;
3653 foreach my $part_svc ( @part_svc ) {
3654 if($part_svc->svcdb eq 'svc_phone'){
3655 my @cust_pkg_svc = @{$part_svc->cust_pkg_svc};
3656 foreach my $cust_pkg_svc ( @cust_pkg_svc ) {
3657 push @svc_phone, $cust_pkg_svc->svc_x
3658 if $cust_pkg_svc->date_inserted >= $age_threshold;
3666 my($xls_r,$xls_c) = (0,0);
3669 my @fields = qw( countrycode phonenum pin sip_password phone_name );
3670 if($p->{'format'} eq 'csv') {
3671 $csv = new Text::CSV_XS { 'always_quote' => 1,
3674 return { 'error' => 'Unable to create CSV' } unless $csv->combine(@fields);
3675 $content .= $csv->string;
3677 elsif($p->{'format'} eq 'xls') {
3678 my $XLS1 = new IO::Scalar \$content;
3679 $xls_workbook = Spreadsheet::WriteExcel->new($XLS1)
3680 or return { 'error' => "Error opening .xls file: $!" };
3681 $xls = $xls_workbook->add_worksheet('DIDs');
3682 foreach ( @fields ) {
3683 $xls->write(0,$xls_c++,$_);
3688 foreach my $svc_phone ( @svc_phone ) {
3689 my @cols = map { $svc_phone->$_ } @fields;
3690 if($p->{'format'} eq 'csv') {
3691 return { 'error' => 'Unable to create CSV' }
3692 unless $csv->combine(@cols);
3693 $content .= $csv->string;
3695 elsif($p->{'format'} eq 'xls') {
3698 $xls->write($xls_r,$xls_c++,$_);
3704 $xls_workbook->close() if $p->{'format'} eq 'xls';
3706 { content => $content, format => $p->{'format'}, };
3711 my($context, $session, $custnum) = _custoragent_session_custnum($p);
3712 return { 'error' => $session } if $context eq 'error';
3714 # warn "$me get_ticket: initializing ticket system\n" if $DEBUG;
3715 # FS::TicketSystem->init();
3716 # return { 'error' => 'get_ticket configuration error' }
3717 # if $FS::TicketSystem::system ne 'RT_Internal';
3719 # check existence and ownership as part of this
3720 warn "$me get_ticket: fetching ticket\n" if $DEBUG;
3721 my $rt_session = FS::TicketSystem->session('');
3722 my $Ticket = FS::TicketSystem->get_ticket_object(
3724 ticket_id => $p->{'ticket_id'},
3727 return { 'error' => 'ticket not found' } if !$Ticket;
3729 if ( length( $p->{'subject'} || '' ) ) {
3731 if ( $p->{'subject'} ne $Ticket->Subject ) {
3732 my ($val, $msg) = $Ticket->SetSubject($p->{'subject'});
3733 return { 'error' => "unable to set subject: $msg" } if !$val;
3737 if(length($p->{'reply'})) {
3738 my @err_or_res = FS::TicketSystem->correspond_ticket(
3740 'ticket_id' => $p->{'ticket_id'},
3741 'content' => $p->{'reply'},
3744 return { 'error' => 'unable to reply to ticket' }
3745 unless ( $err_or_res[0] != 0 && defined $err_or_res[2] );
3748 warn "$me get_ticket: getting ticket history\n" if $DEBUG;
3749 my $err_or_ticket = FS::TicketSystem->get_ticket(
3751 'ticket_id' => $p->{'ticket_id'},
3754 if ( !ref($err_or_ticket) ) { # there is no way this should ever happen
3755 warn "$me get_ticket: unsuccessful: $err_or_ticket\n"
3757 return { 'error' => $err_or_ticket };
3760 my @custs = @{$err_or_ticket->{'custs'}};
3761 my @txns = @{$err_or_ticket->{'txns'}};
3764 # superseded by check in get_ticket_object
3765 #return { 'error' => 'invalid ticket requested' }
3766 #unless grep($_ eq $custnum, @custs);
3768 foreach my $txn ( @txns ) {
3769 push @filtered_txns, $txn
3770 if ($txn->{'type'} eq 'EmailRecord'
3771 || $txn->{'type'} eq 'Correspond'
3772 || $txn->{'type'} eq 'Create');
3775 warn "$me get_ticket: successful: \n"
3777 return { 'error' => '',
3778 'transactions' => \@filtered_txns,
3779 'ticket_fields' => $err_or_ticket->{'fields'},
3780 'ticket_id' => $p->{'ticket_id'},
3784 sub adjust_ticket_priority {
3786 my($context, $session, $custnum) = _custoragent_session_custnum($p);
3787 return { 'error' => $session } if $context eq 'error';
3789 # warn "$me adjust_ticket_priority: initializing ticket system\n" if $DEBUG;
3790 # FS::TicketSystem->init;
3791 my $ss_priority = FS::TicketSystem->selfservice_priority;
3793 return { 'error' => 'adjust_ticket_priority configuration error' }
3794 if $FS::TicketSystem::system ne 'RT_Internal'
3797 my $values = $p->{'values'}; #hashref, id => priority value
3800 foreach my $id (keys %$values) {
3801 warn "$me adjust_ticket_priority: fetching ticket $id\n" if $DEBUG;
3802 my $Ticket = FS::TicketSystem->get_ticket_object('',
3804 'custnum' => $custnum,
3807 $ticket_error{$id} = 'ticket not found';
3811 # RT API stuff--would we gain anything by wrapping this in FS::TicketSystem?
3812 # We're not going to implement it for RT_External.
3813 my $old_value = $Ticket->FirstCustomFieldValue($ss_priority);
3814 my $new_value = $values->{$id};
3815 next if $old_value eq $new_value;
3817 warn "$me adjust_ticket_priority: updating ticket $id\n" if $DEBUG;
3819 # AddCustomFieldValue works fine (replacing any existing value) if it's
3820 # a single-valued custom field, which it should be. If it's not, you're
3821 # doing something wrong.
3823 if ( length($new_value) ) {
3824 ($val, $msg) = $Ticket->AddCustomFieldValue(
3825 Field => $ss_priority,
3826 Value => $new_value,
3830 ($val, $msg) = $Ticket->DeleteCustomFieldValue(
3831 Field => $ss_priority,
3832 Value => $old_value,
3836 $ticket_error{$id} = $msg if !$val;
3837 warn "$me adjust_ticket_priority: $id: $msg\n" if $DEBUG and !$val;
3839 return { 'error' => '',
3840 'ticket_error' => \%ticket_error,
3841 %{ customer_info($p) } # send updated customer info back
3847 sub _custoragent_session_custnum {
3850 my($context, $session, $custnum);
3851 if ( $p->{'session_id'} ) {
3853 $context = 'customer';
3854 $session = _cache->get($p->{'session_id'})
3855 or return ( 'error' => "Can't resume session" ); #better error message
3856 $custnum = $session->{'custnum'};
3858 } elsif ( $p->{'agent_session_id'} ) {
3861 my $agent_cache = new FS::ClientAPI_SessionCache( {
3862 'namespace' => 'FS::ClientAPI::Agent',
3864 $session = $agent_cache->get($p->{'agent_session_id'})
3865 or return ( 'error' => "Can't resume session" ); #better error message
3866 $custnum = $p->{'custnum'};
3870 return ( 'error' => "Can't resume session" ); #better error message
3873 ($context, $session, $custnum);