show credit balance on invoices, #11564

[freeside.git] / FS / FS / qual.pm

diff --git a/FS/FS/qual.pm b/FS/FS/qual.pm
index 30f8e69..8f58389 100644 (file)
--- a/FS/FS/qual.pm
+++ b/FS/FS/qual.pm
@@ -1,7 +1,7 @@
 package FS::qual;
 
 use strict;
-use base qw( FS::Record );
+use base qw( FS::option_Common );
 use FS::Record qw( qsearch qsearchs );
 
 =head1 NAME
@@ -32,12 +32,16 @@ FS::Record.  The following fields are currently supported:
 
 =item qualnum - primary key
 
-=item contactnum - Contact (Prospect/Customer) - see L<FS::contact>
+=item prospectnum
 
-=item svctn - Service Telephone Number
+=item custnum 
 
-=item svcdb - table used for this service.  See L<FS::svc_dsl> and
-L<FS::svc_broadband>, among others.
+=item locationnum
+
+=item phonenum - Service Telephone Number
+
+=item exportnum - export instance providing service-qualification capabilities,
+see L<FS::part_export>
 
 =item vendor_qual_id - qualification id from vendor/telco
 
@@ -105,22 +109,88 @@ sub check {
 
   my $error = 
     $self->ut_numbern('qualnum')
-    || $self->ut_number('contactnum')
-    || $self->ut_numbern('svctn')
-    || $self->ut_alpha('svcdb')
+    || $self->ut_foreign_keyn('custnum', 'cust_main', 'qualnum')
+    || $self->ut_foreign_keyn('prospectnum', 'prospect_main', 'prospectnum')
+    || $self->ut_foreign_keyn('locationnum', 'cust_location', 'locationnum')
+    || $self->ut_numbern('phonenum')
+    || $self->ut_foreign_keyn('exportnum', 'part_export', 'exportnum')
     || $self->ut_textn('vendor_qual_id')
     || $self->ut_alpha('status')
   ;
   return $error if $error;
 
+  return "Invalid prospect/customer/location combination" if (
+   ( $self->locationnum && $self->prospectnum && $self->custnum ) ||
+   ( !$self->locationnum && !$self->prospectnum && !$self->custnum )
+  );
+
   $self->SUPER::check;
 }
 
-=back
+sub part_export {
+    my $self = shift;
+    if ( $self->exportnum ) {
+       return qsearchs('part_export', { exportnum => $self->exportnum } )
+               or die 'invalid exportnum';
+    }
+    '';
+}
 
-=head1 BUGS
+sub location {
+    my $self = shift;
+    if ( $self->locationnum ) {
+       my $l = qsearchs( 'cust_location', 
+                   { 'locationnum' => $self->locationnum });
+       if ( $l ) {
+           my %loc_hash = $l->location_hash;
+           $loc_hash{locationnum} = $self->locationnum;
+           return %loc_hash;
+       }
+    }
+    if ( $self->custnum ) {
+       my $c = qsearchs( 'cust_main', { 'custnum' => $self->custnum });
+       
+       if($c) {
+           # always override location_kind as it would never be known in the 
+           # case of cust_main "default service address"
+           my %loc_hash = $c->location_hash;
+           $loc_hash{location_kind} = $c->company ? 'B' : 'R';
+           return %loc_hash;
+       }
+    }
+  # prospectnum does not imply any particular address! must specify locationnum
+
+    '';
+}
 
-This doesn't do anything yet.
+sub cust_or_prospect {
+    my $self = shift;
+    if ( $self->locationnum ) {
+       my $l = qsearchs( 'cust_location', 
+                   { 'locationnum' => $self->locationnum });
+       return qsearchs('cust_main',{ 'custnum' => $l->custnum })
+           if $l->custnum;
+       return qsearchs('prospect_main',{ 'prospectnum' => $l->prospectnum })
+           if $l->prospectnum;
+    }
+    return qsearchs('cust_main', { 'custnum' => $self->custnum }) 
+       if $self->custnum;
+    return qsearchs('prospect_main', { 'prospectnum' => $self->prospectnum })
+       if $self->prospectnum;
+}
+
+sub status_long {
+    my $self = shift;
+    my $s = {
+       'Q' => 'Qualified',
+       'D' => 'Does not Qualify',
+       'N' => 'New',
+    };
+    return $s->{$self->status} if defined $s->{$self->status};
+    return 'Unknown';
+}
+
+=back
 
 =head1 SEE ALSO