FS/FS/part_export/ikano.pm

   1 package FS::part_export::ikano;
   2
   3 use strict;
   4 use warnings;
   5 use vars qw(@ISA %info %loopType $me);
   6 use Tie::IxHash;
   7 use Date::Format qw( time2str );
   8 use Date::Parse qw( str2time );
   9 use FS::Record qw(qsearch qsearchs dbh);
  10 use FS::part_export;
  11 use FS::svc_dsl;
  12 use Data::Dumper;
  13
  14 @ISA = qw(FS::part_export);
  15 $me= '[' .  __PACKAGE__ . ']';
  16
  17 tie my %options, 'Tie::IxHash',
  18   'keyid'         => { label=>'Ikano keyid' },
  19   'username'      => { label=>'Ikano username',
  20                         default => 'admin',
  21                         },
  22   'password'      => { label=>'Ikano password' },
  23   'check_networks' => { label => 'Check Networks',
  24                     default => 'ATT,BELLCA',
  25                     },
  26   'debug' => { label => 'Debug Mode',  type => 'checkbox' },
  27 ;
  28
  29 %info = (
  30   'svc'     => 'svc_dsl',
  31   'desc'    => 'Provision DSL to Ikano',
  32   'options' => \%options,
  33   'notes'   => <<'END'
  34 Requires installation of
  35 <a href="http://search.cpan.org/dist/Net-Ikano">Net::Ikano</a> from CPAN.
  36 END
  37 );
  38
  39 %loopType = ( '' => 'Line-share', '0' => 'Standalone' );
  40
  41 sub rebless { shift; }
  42
  43 sub dsl_pull {
  44 # we distinguish between invalid new data (return error) versus data that
  45 # has legitimately changed (may eventually execute hooks; now just update)
  46 # if we do add hooks later, we should work on a copy of svc_dsl and pass
  47 # the old and new svc_dsl to the hooks so they know what changed
  48 #
  49 # current assumptions of what won't change (from their side):
  50 # vendor_order_id, vendor_qual_id, vendor_order_type, pushed, monitored,
  51 # last_pull, address (from qual), contact info, ProductCustomId
  52     my($self, $svc_dsl, $threshold) = (shift, shift, shift);
  53     $self->loadmod;
  54     my $result = $self->valid_order($svc_dsl,'pull');
  55     return $result unless $result eq '';
  56
  57     my $now = time;
  58     if($now - $svc_dsl->last_pull < $threshold) {
  59         warn "$me skipping pull since threshold not reached (svcnum="
  60             . $svc_dsl->svcnum . ",now=$now,threshold=$threshold,last_pull="
  61             . $svc_dsl->last_pull .")" if $self->option('debug');
  62         return '';
  63     }
  64
  65     $result = $self->ikano_command('ORDERSTATUS',
  66         { OrderId => $svc_dsl->vendor_order_id } );
  67     return $result unless ref($result); # scalar (string) is an error
  68
  69     # now we're getting an OrderResponse which should have one Order in it
  70     warn "$me pull OrderResponse hash:\n".Dumper($result)
  71         if $self->option('debug');
  72
  73     return 'Invalid order response' unless defined $result->{'Order'};
  74     $result = $result->{'Order'};
  75
  76     return 'No order id or status returned'
  77         unless defined $result->{'Status'} && defined $result->{'OrderId'};
  78
  79     local $SIG{HUP} = 'IGNORE';
  80     local $SIG{INT} = 'IGNORE';
  81     local $SIG{QUIT} = 'IGNORE';
  82     local $SIG{TERM} = 'IGNORE';
  83     local $SIG{TSTP} = 'IGNORE';
  84     local $SIG{PIPE} = 'IGNORE';
  85
  86     my $oldAutoCommit = $FS::UID::AutoCommit;
  87     local $FS::UID::AutoCommit = 0;
  88     my $dbh = dbh;
  89
  90     # 1. status
  91     my $order_status = grep($_ eq $result->{'Status'}, @Net::Ikano::orderStatus)
  92                             ? $result->{'Status'} : '';
  93     return 'Invalid new status' if $order_status eq '';
  94     $svc_dsl->vendor_order_status($order_status)
  95         if($svc_dsl->vendor_order_status ne $order_status);
  96     $svc_dsl->monitored('')
  97             if ($order_status eq 'CANCELLED' || $order_status eq 'COMPLETED');
  98
  99     # 2. fields we don't care much about
 100     my %justUpdate = ( 'first' => 'FirstName',
 101                     'last' => 'LastName',
 102                     'company' => 'CompanyName',
 103                     'username' => 'Username',
 104                     'password' => 'Password' );
 105
 106     my($fsf, $ikanof);
 107     while (($fsf, $ikanof) = each %justUpdate) {
 108        $svc_dsl->$fsf($result->{$ikanof})
 109             if $result->{$ikanof} ne $svc_dsl->$fsf;
 110     }
 111
 112     # let's look inside the <Product> response element
 113     my @product = $result->{'Product'};
 114     return 'Invalid number of products on order' if scalar(@product) != 1;
 115     my $product = $result->{'Product'}[0];
 116
 117     # 3. phonenum
 118     if($svc_dsl->loop_type eq '') { # line-share
 119 # TN may change only if sub changes it and New or Change order in Completed status
 120         my $tn = $product->{'PhoneNumber'};
 121         if($tn ne $svc_dsl->phonenum) {
 122             if( ($svc_dsl->vendor_order_type eq 'NEW'
 123                 || $svc_dsl->vendor_order_type eq 'CHANGE')
 124                && $svc_dsl->vendor_order_status eq 'COMPLETED' ) {
 125                 $svc_dsl->phonenum($tn);
 126             }
 127             else { return 'TN has changed in an invalid state'; }
 128         }
 129     }
 130     elsif($svc_dsl->loop_type eq '0') { # dry loop
 131 # TN may change only if it's assigned while a New or Change order is in progress
 132         return 'Invalid PhoneNumber value for a dry loop'
 133             if $product->{'PhoneNumber'} ne 'STANDALONE';
 134         my $tn = $product->{'VirtualPhoneNumber'};
 135         if($tn ne $svc_dsl->phonenum) {
 136             if( ($svc_dsl->vendor_order_type eq 'NEW'
 137                 || $svc_dsl->vendor_order_type eq 'CHANGE')
 138               && $svc_dsl->vendor_order_status ne 'COMPLETED'
 139               && $svc_dsl->vendor_order_status ne 'CANCELLED') {
 140                 $svc_dsl->phonenum($tn);
 141             }
 142             else { return 'TN has changed in an invalid state'; }
 143         }
 144     }
 145
 146     # 4. desired_due_date - may change if manually changed
 147     if($svc_dsl->vendor_order_type eq 'NEW'
 148             || $svc_dsl->vendor_order_type eq 'CHANGE'){
 149         my $f = str2time($product->{'DateToOrder'});
 150         return 'Invalid DateToOrder' unless $f;
 151         $svc_dsl->desired_due_date($f) if $svc_dsl->desired_due_date ne $f;
 152         # XXX: optionally sync back to start_date or whatever...
 153     }
 154     elsif($svc_dsl->vendor_order_type eq 'CANCEL'){
 155         my $f = str2time($product->{'DateToDisconnect'});
 156         return 'Invalid DateToDisconnect' unless $f;
 157         $svc_dsl->desired_due_date($f) if $svc_dsl->desired_due_date ne $f;
 158         # XXX: optionally sync back to expire or whatever...
 159     }
 160
 161     # 5. due_date
 162     if($svc_dsl->vendor_order_type eq 'NEW'
 163           || $svc_dsl->vendor_order_type eq 'CHANGE') {
 164         my $f = str2time($product->{'ActivationDate'});
 165         if($svc_dsl->vendor_order_status ne 'NEW'
 166             && $svc_dsl->vendor_order_status ne 'CANCELLED') {
 167             return 'Invalid ActivationDate' unless $f;
 168             $svc_dsl->due_date($f) if $svc_dsl->due_date ne $f;
 169         }
 170     }
 171     # Ikano API does not implement the proper disconnect date,
 172     # so we can't do anything about it
 173
 174     # 6. staticips - for now just comma-separate them
 175     my $tstatics = $result->{'StaticIps'};
 176     my @istatics = defined $tstatics ? @$tstatics : ();
 177     my $ostatics = $svc_dsl->staticips;
 178     my @ostatics = split(',',$ostatics);
 179     # more horrible search/sync code below...
 180     my $staticsChanged = 0;
 181     foreach my $istatic ( @istatics ) { # they have, we don't
 182         unless ( grep($_ eq $istatic, @ostatics) ) {
 183             push @ostatics, $istatic;
 184             $staticsChanged = 1;
 185         }
 186     }
 187     for(my $i=0; $i < scalar(@ostatics); $i++) {
 188         unless ( grep($_ eq $ostatics[$i], @istatics) ) {
 189             splice(@ostatics,$i,1);
 190             $i--;
 191             $staticsChanged = 1;
 192         }
 193     }
 194     $svc_dsl->staticips(join(',',@ostatics)) if $staticsChanged;
 195
 196     # 7. notes - put them into the common format and compare
 197     my $tnotes = $result->{'OrderNotes'};
 198     my @tnotes = defined $tnotes ? @$tnotes : ();
 199     my @inotes = (); # all Ikano OrderNotes as FS::dsl_note objects
 200     my $notesChanged = 0;
 201     foreach my $tnote ( @tnotes ) {
 202         my $inote = $self->ikano2fsnote($tnote,$svc_dsl->svcnum);
 203         return 'Cannot parse note' unless ref($inote);
 204         push @inotes, $inote;
 205     }
 206     my @onotes = $svc_dsl->notes;
 207     # assume notes we already have don't change & no notes added from our side
 208     # so using the horrible code below just find what we're missing and add it
 209     my $error;
 210     foreach my $inote ( @inotes ) {
 211         my $found = 0;
 212         foreach my $onote ( @onotes ) {
 213             if($onote->date == $inote->date && $onote->note eq $inote->note) {
 214                 $found = 1;
 215                 last;
 216             }
 217         }
 218         $error = $inote->insert unless ( $found );
 219         if ( $error ) {
 220           $dbh->rollback if $oldAutoCommit;
 221           return "Cannot add note: $error";
 222         }
 223     }
 224
 225     $svc_dsl->last_pull((time));
 226     local $FS::svc_Common::noexport_hack = 1;
 227     $error = $svc_dsl->replace;
 228     if ( $error ) {
 229       $dbh->rollback if $oldAutoCommit;
 230       return "Cannot update DSL data: $error";
 231     }
 232
 233     $dbh->commit or die $dbh->errstr if $oldAutoCommit;
 234
 235     '';
 236 }
 237
 238 sub ikano2fsnote {
 239     my($self,$n,$svcnum) = (shift,shift,shift);
 240     my @ikanoRequired = qw( HighPriority StaffId Date Text CompanyStaffId );
 241     return '' unless defined $n->{'HighPriority'}
 242                 && defined $n->{'StaffId'}
 243                 && defined $n->{'CompanyStaffId'}
 244                 && defined $n->{'Date'}
 245                 && defined $n->{'Text'}
 246                 ;
 247     my $by = 'Unknown';
 248     $by = "Ikano" if $n->{'CompanyStaffId'} == -1 && $n->{'StaffId'} != -1;
 249     $by = "Us" if $n->{'StaffId'} == -1 && $n->{'CompanyStaffId'} != -1;
 250
 251     new FS::dsl_note( {
 252         'svcnum' => $svcnum,
 253         'author' => $by,
 254         'priority' => $n->{'HighPriority'} eq 'false' ? 'N' : 'H',
 255         '_date' => int(str2time($n->{'Date'})),
 256         'note' => $n->{'Text'},
 257      } );
 258 }
 259
 260 sub qual {
 261     my($self,$qual) = (shift,shift);
 262 # address always required for Ikano qual, TN optional (assume dry if not given)
 263
 264     my %location_hash = $qual->location;
 265     return 'No address provided' unless %location_hash;
 266     my $svctn = $qual->phonenum;
 267
 268     my $result = $self->ikano_command('PREQUAL',
 269       { AddressLine1 => $location_hash{address1},
 270         AddressUnitType => $location_hash{location_type},
 271         AddressUnitValue => $location_hash{location_number},
 272         AddressCity => $location_hash{city},
 273         AddressState => $location_hash{state},
 274         ZipCode => $location_hash{zip},
 275         Country => $location_hash{country},
 276         LocationType => $location_hash{location_kind},
 277         PhoneNumber => length($svctn) > 1 ? $svctn : "STANDALONE",
 278         RequestClientIP => '127.0.0.1',
 279         CheckNetworks => $self->option('check_networks'),
 280       } );
 281     return $result unless ref($result); # error case
 282     return 'Invalid prequal response' unless defined $result->{'PrequalId'};
 283
 284     my $qoptions = {};
 285     # lame data structure traversal...
 286     # don't spend much time here, just get TermsId and ProductCustomId
 287     my $networks = $result->{'Network'};
 288     my @networks = defined $networks ? @$networks : ();
 289     my $netcount = 0;
 290     foreach my $network ( @networks ) {
 291         my $productgroups = $network->{'ProductGroup'};
 292         my @productgroups = defined $productgroups ? @$productgroups : ();
 293         my $pgcount = 0;
 294         foreach my $productgroup ( @productgroups ) {
 295             my $prefix = "ikano_Network_$netcount"."_ProductGroup_$pgcount"."_";
 296             $qoptions->{$prefix."TermsId"} = $productgroup->{'TermsId'};
 297             my $products = $productgroup->{'Product'};
 298             my @products = defined $products ? @$products : ();
 299             my $prodcount = 0;
 300             foreach my $product ( @products ) {
 301                 $qoptions->{$prefix."Product_$prodcount"."_ProductCustomId"} = $product->{'ProductCustomId'};
 302                 $prodcount++;
 303             }
 304             $pgcount++;
 305         }
 306         $netcount++;
 307     }
 308
 309     {   'vendor_qual_id' => $result->{'PrequalId'},
 310         'status' => scalar(@networks) ? 'Q' : 'D',
 311         'options' => $qoptions,
 312     };
 313 }
 314
 315 sub qual_html {
 316     my($self,$qual) = (shift,shift);
 317
 318     my %qual_options = $qual->options;
 319     my @externalids = ();
 320     my( $optionname, $optionvalue );
 321     while (($optionname, $optionvalue) = each %qual_options) {
 322         push @externalids, $optionvalue
 323             if ( $optionname =~ /^ikano_Network_(\d+)_ProductGroup_(\d+)_Product_(\d+)_ProductCustomId$/
 324                 && $optionvalue ne '' );
 325     }
 326
 327     my $list = "<B>Qualifying Packages:</B><UL>";
 328     my @part_pkgs = qsearch( 'part_pkg', { 'disabled' => '' } );
 329     foreach my $part_pkg ( @part_pkgs ) {
 330         my $externalid = $part_pkg->option('externalid',1);
 331         if ( $externalid ) {
 332             $list .= "<LI>".$part_pkg->pkgpart.": ".$part_pkg->pkg." - "
 333                 .$part_pkg->comment."</LI>"
 334               if grep( $_ eq $externalid, @externalids );
 335         }
 336     }
 337     $list .= "</UL>";
 338     $list;
 339 }
 340
 341 sub notes_html {
 342     my($self,$svc_dsl) = (shift,shift);
 343     my $conf = new FS::Conf;
 344     my $date_format = $conf->config('date_format') || '%m/%d/%Y';
 345     my @notes = $svc_dsl->notes;
 346     my $html = '<TABLE border="1" cellspacing="2" cellpadding="2" id="dsl_notes">
 347         <TR><TH>Date</TH><TH>By</TH><TH>Priority</TH><TH>Note</TH></TR>';
 348     foreach my $note ( @notes ) {
 349         $html .= "<TR>
 350             <TD>".time2str("$date_format %H:%M",$note->date)."</TD>
 351             <TD>".$note->by."</TD>
 352             <TD>". ($note->priority eq 'N' ? 'Normal' : 'High') ."</TD>
 353             <TD>".$note->note."</TD></TR>";
 354     }
 355     $html .= '</TABLE>';
 356     $html;
 357 }
 358
 359 sub loop_type_long { # sub, not a method
 360     my($svc_dsl) = (shift);
 361     return $loopType{$svc_dsl->loop_type};
 362 }
 363
 364 sub ikano_command {
 365   my( $self, $command, $args ) = @_;
 366
 367   $self->loadmod;
 368
 369   my $ikano = Net::Ikano->new(
 370     'keyid' => $self->option('keyid'),
 371     'username'  => $self->option('username'),
 372     'password'  => $self->option('password'),
 373     'debug'    => $self->option('debug'),
 374   );
 375
 376   $ikano->$command($args);
 377 }
 378
 379 sub loadmod {
 380   eval "use Net::Ikano;";
 381   die $@ if $@;
 382 }
 383
 384 sub valid_order {
 385   my( $self, $svc_dsl, $action ) = (shift, shift, shift);
 386
 387   $self->loadmod;
 388
 389   warn "$me valid_order action=$action svc_dsl:\n". Dumper($svc_dsl)
 390         if $self->option('debug');
 391
 392   # common to all order types/status/loop_type
 393   my $error = !($svc_dsl->desired_due_date
 394             &&  grep($_ eq $svc_dsl->vendor_order_type, Net::Ikano->orderTypes)
 395             &&  $svc_dsl->first
 396             &&  $svc_dsl->last
 397             &&  defined $svc_dsl->loop_type
 398             &&  $svc_dsl->vendor_qual_id
 399             );
 400   return 'Missing or invalid order data' if $error;
 401
 402   return 'Package does not have an external id configured'
 403     if $svc_dsl->cust_svc->cust_pkg->part_pkg->options('externalid',1) eq '';
 404
 405   return 'No valid qualification for this order'
 406     unless qsearch( 'qual', { 'vendor_qual_id' => $svc_dsl->vendor_qual_id });
 407
 408   # now go by order type
 409   # weird ifs & long lines for readability and ease of understanding - don't change
 410   if($svc_dsl->vendor_order_type eq 'NEW') {
 411     if($svc_dsl->pushed) {
 412         $error = !( ($action eq 'pull' || $action eq 'statuschg'
 413                         || $action eq 'delete')
 414             &&  length($svc_dsl->vendor_order_id) > 0
 415             &&  length($svc_dsl->vendor_order_status) > 0
 416                 );
 417         return 'Invalid order data' if $error;
 418
 419         return 'Phone number required for status change'
 420             if ($action eq 'statuschg' && length($svc_dsl->phonenum) < 1);
 421     }
 422     else { # unpushed New order - cannot do anything other than push it
 423         $error = !($action eq 'insert'
 424             &&  length($svc_dsl->vendor_order_id) < 1
 425             &&  length($svc_dsl->vendor_order_status) < 1
 426             && ( ($svc_dsl->phonenum eq '' && $svc_dsl->loop_type eq '0') # dry
 427               || ($svc_dsl->phonenum ne '' && $svc_dsl->loop_type eq '') # line-share
 428                )
 429             );
 430         return 'Invalid order data' if $error;
 431     }
 432   }
 433   elsif($svc_dsl->vendor_order_type eq 'CANCEL') {
 434   }
 435   elsif($svc_dsl->vendor_order_type eq 'CHANGE') {
 436   }
 437
 438  '';
 439 }
 440
 441 sub qual2termsid {
 442     my ($self,$vendor_qual_id,$ProductCustomId) = (shift,shift,shift);
 443     my $qual = qsearchs( 'qual', { 'vendor_qual_id' => $vendor_qual_id });
 444     return '' unless $qual;
 445     my %qual_options = $qual->options;
 446     my( $optionname, $optionvalue );
 447     while (($optionname, $optionvalue) = each %qual_options) {
 448         if ( $optionname =~ /^ikano_Network_(\d+)_ProductGroup_(\d+)_Product_(\d+)_ProductCustomId$/
 449             && $optionvalue eq $ProductCustomId ) {
 450             my $network = $1;
 451             my $productgroup = $2;
 452             return $qual->option("ikano_Network_".$network."_ProductGroup_".$productgroup."_TermsId");
 453         }
 454     }
 455     '';
 456 }
 457
 458 sub _export_insert {
 459   my( $self, $svc_dsl ) = (shift, shift);
 460
 461   $self->loadmod;
 462
 463   my $result = $self->valid_order($svc_dsl,'insert');
 464   return $result unless $result eq '';
 465
 466   my $isp_chg = $svc_dsl->isp_chg eq 'Y' ? 'YES' : 'NO';
 467   my $contactTN = $svc_dsl->cust_svc->cust_pkg->cust_main->daytime;
 468   $contactTN =~ s/[^0-9]//g;
 469
 470   my $ProductCustomId = $svc_dsl->cust_svc->cust_pkg->part_pkg->option('externalid',1);
 471
 472   my $args = {
 473         orderType => 'NEW',
 474         ProductCustomId => $ProductCustomId,
 475         TermsId => $self->qual2termsid($svc_dsl->vendor_qual_id,$ProductCustomId),
 476         DSLPhoneNumber => $svc_dsl->loop_type eq '0' ? 'STANDALONE'
 477                                                     : $svc_dsl->phonenum,
 478         Password => $svc_dsl->password,
 479         PrequalId => $svc_dsl->vendor_qual_id,
 480         CompanyName => $svc_dsl->company,
 481         FirstName => $svc_dsl->first,
 482         LastName => $svc_dsl->last,
 483         MiddleName => '',
 484         ContactMethod => 'PHONE',
 485         ContactPhoneNumber => $contactTN,
 486         ContactEmail => 'x@x.xx',
 487         ContactFax => '',
 488         DateToOrder => time2str("%Y-%m-%d",$svc_dsl->desired_due_date),
 489         RequestClientIP => '127.0.0.1',
 490         IspChange => $isp_chg,
 491         IspPrevious => $isp_chg eq 'YES' ? $svc_dsl->isp_prev : '',
 492         CurrentProvider => $isp_chg eq 'NO' ? $svc_dsl->isp_prev : '',
 493   };
 494
 495   $result = $self->ikano_command('ORDER',$args);
 496   return $result unless ref($result); # scalar (string) is an error
 497
 498   # now we're getting an OrderResponse which should have one Order in it
 499   warn "$me _export_insert OrderResponse hash:\n".Dumper($result)
 500         if $self->option('debug');
 501
 502   return 'Invalid order response' unless defined $result->{'Order'};
 503   $result = $result->{'Order'};
 504
 505   return 'No/invalid order id or status returned'
 506     unless defined $result->{'Status'} && defined $result->{'OrderId'}
 507         && grep($_ eq $result->{'Status'}, @Net::Ikano::orderStatus);
 508
 509   $svc_dsl->pushed(time);
 510   $svc_dsl->last_pull((time)+1);
 511   $svc_dsl->vendor_order_id($result->{'OrderId'});
 512   $svc_dsl->vendor_order_status($result->{'Status'});
 513   $svc_dsl->username($result->{'Username'});
 514   local $FS::svc_Common::noexport_hack = 1;
 515   $result = $svc_dsl->replace;
 516   return "Error setting DSL fields: $result" if $result;
 517   '';
 518 }
 519
 520 sub _export_replace {
 521   my( $self, $new, $old ) = (shift, shift, shift);
 522 # XXX only supports password changes now, but should return error if
 523 # another change is attempted?
 524
 525   if($new->password ne $old->password) {
 526       my $result = $self->valid_order($new,'statuschg');
 527       return $result unless $result eq '';
 528
 529       $result = $self->ikano_command('PASSWORDCHANGE',
 530             { DSLPhoneNumber => $new->phonenum,
 531               NewPassword => $new->password,
 532             } );
 533       return $result unless ref($result); # scalar (string) is an error
 534
 535       return 'Error changing password' unless defined $result->{'Password'}
 536         && $result->{'Password'} eq $new->password;
 537   }
 538
 539   '';
 540 }
 541
 542 sub _export_delete {
 543   my( $self, $svc_dsl ) = (shift, shift);
 544
 545   my $result = $self->valid_order($svc_dsl,'delete');
 546   return $result unless $result eq '';
 547
 548   # for now allow an immediate cancel only on New orders in New/Pending status
 549   #XXX: add support for Chance and Cancel orders in New/Pending status later
 550
 551   if($svc_dsl->vendor_order_type eq 'NEW') {
 552     if($svc_dsl->vendor_order_status eq 'NEW'
 553             || $svc_dsl->vendor_order_status eq 'PENDING') {
 554         my $result = $self->ikano_command('CANCEL',
 555             { OrderId => $svc_dsl->vendor_order_id, } );
 556         return $result unless ref($result); # scalar (string) is an error
 557         return 'Unable to cancel order' unless $result->{'Order'};
 558         $result = $result->{'Order'};
 559         return 'Invalid cancellation response'
 560             unless $result->{'Status'} eq 'CANCELLED'
 561                 && $result->{'OrderId'} eq $svc_dsl->vendor_order_id;
 562
 563         # we're supposed to do a pull, but it will break everything, so don't
 564         # this is very wrong...
 565     }
 566     else {
 567         return "Cannot cancel a NEW order unless it's in NEW or PENDING status";
 568     }
 569   }
 570   else {
 571     return 'Canceling orders other than NEW orders is not currently implemented';
 572   }
 573
 574   '';
 575 }
 576
 577 sub statuschg {
 578   my( $self, $svc_dsl, $type ) = (shift, shift, shift);
 579
 580   my $result = $self->valid_order($svc_dsl,'statuschg');
 581   return $result unless $result eq '';
 582
 583   # get the DSLServiceId
 584   $result = $self->ikano_command('CUSTOMERLOOKUP',
 585         { PhoneNumber => $svc_dsl->phonenum } );
 586   return $result unless ref($result); # scalar (string) is an error
 587   return 'No DSLServiceId found' unless defined $result->{'DSLServiceId'};
 588   my $DSLServiceId = $result->{'DSLServiceId'};
 589
 590   $result = $self->ikano_command('ACCOUNTSTATUSCHANGE',
 591         { DSLPhoneNumber => $svc_dsl->phonenum,
 592           DSLServiceId => $DSLServiceId,
 593           type => $type,
 594         } );
 595   return $result unless ref($result); # scalar (string) is an error
 596   '';
 597 }
 598
 599 sub _export_suspend {
 600   my( $self, $svc_dsl ) = (shift, shift);
 601   $self->statuschg($svc_dsl,"SUSPEND");
 602 }
 603
 604 sub _export_unsuspend {
 605   my( $self, $svc_dsl ) = (shift, shift);
 606   $self->statuschg($svc_dsl,"UNSUSPEND");
 607 }
 608
 609 1;