X-Git-Url: http://git.freeside.biz/gitweb/?p=freeside.git;a=blobdiff_plain;f=FS%2FFS%2Fcust_refund.pm;h=7df7a557a7b4e163f77736f11e0dc02b1258fb60;hp=9cd9bf845347b5c6a5458d84080cc7299dcf67fb;hb=aed8ec35ccb9cdeb7ea0cb6ff2946f9d83d582f6;hpb=b89c7f126690704c8d1558dba06d5fabd7470528 diff --git a/FS/FS/cust_refund.pm b/FS/FS/cust_refund.pm index 9cd9bf845..7df7a557a 100644 --- a/FS/FS/cust_refund.pm +++ b/FS/FS/cust_refund.pm @@ -1,17 +1,17 @@ package FS::cust_refund; use strict; -use vars qw( @ISA @encrypted_fields ); +use base qw( FS::otaker_Mixin FS::payinfo_transaction_Mixin FS::cust_main_Mixin + FS::Record ); +use vars qw( @encrypted_fields ); use Business::CreditCard; -use FS::Record qw( qsearch qsearchs dbh ); use FS::UID qw(getotaker); +use FS::Record qw( qsearch qsearchs dbh ); +use FS::CurrentUser; use FS::cust_credit; use FS::cust_credit_refund; use FS::cust_pay_refund; use FS::cust_main; -use FS::payinfo_Mixin; - -@ISA = qw( FS::Record FS::payinfo_Mixin ); @encrypted_fields = ('payinfo'); @@ -42,28 +42,50 @@ inherits from FS::Record. The following fields are currently supported: =over 4 -=item refundnum - primary key (assigned automatically for new refunds) +=item refundnum + +primary key (assigned automatically for new refunds) + +=item custnum + +customer (see L) + +=item refund -=item custnum - customer (see L) +Amount of the refund -=item refund - Amount of the refund +=item reason -=item reason - Reason for the refund +Reason for the refund -=item _date - specified as a UNIX timestamp; see L. Also see +=item _date + +specified as a UNIX timestamp; see L. Also see L and L for conversion functions. -=item payby - Payment Type (See L for valid payby values) +=item payby + +Payment Type (See L for valid payby values) + +=item payinfo + +Payment Information (See L for data format) + +=item paymask + +Masked payinfo (See L for how this works) + +=item paybatch -=item payinfo - Payment Information (See L for data format) +text field for tracking card processing -=item paymask - Masked payinfo (See L for how this works) +=item usernum -=item paybatch - text field for tracking card processing +order taker (see L -=item otaker - order taker (assigned automatically, see L) +=item closed -=item closed - books closed flag, empty or `Y' +books closed flag, empty or `Y' =back @@ -216,12 +238,18 @@ sub delete { =item replace OLD_RECORD -Currently unimplemented (accounting reasons). +You can, but probably shouldn't modify refunds... + +Replaces the OLD_RECORD with this one in the database, or, if OLD_RECORD is not +supplied, replaces this record. If there is an error, returns the error, +otherwise returns false. =cut sub replace { - return "Can't (yet?) modify cust_refund records!"; + my $self = shift; + return "Can't modify closed refund" if $self->closed =~ /^Y/i; + $self->SUPER::replace(@_); } =item check @@ -234,10 +262,13 @@ returns the error, otherwise returns false. Called by the insert method. sub check { my $self = shift; + $self->usernum($FS::CurrentUser::CurrentUser->usernum) unless $self->usernum; + my $error = $self->ut_numbern('refundnum') || $self->ut_numbern('custnum') || $self->ut_money('refund') + || $self->ut_alphan('otaker') || $self->ut_text('reason') || $self->ut_numbern('_date') || $self->ut_textn('paybatch') @@ -256,8 +287,6 @@ sub check { $error = $self->payinfo_check; return $error if $error; - $self->otaker(getotaker); - $self->SUPER::check; } @@ -270,6 +299,7 @@ refund. sub cust_credit_refund { my $self = shift; + map { $_ } #return $self->num_cust_credit_refund unless wantarray; sort { $a->_date <=> $b->_date } qsearch( 'cust_credit_refund', { 'refundnum' => $self->refundnum } ) ; @@ -284,6 +314,7 @@ refund. sub cust_pay_refund { my $self = shift; + map { $_ } #return $self->num_cust_pay_refund unless wantarray; sort { $a->_date <=> $b->_date } qsearch( 'cust_pay_refund', { 'refundnum' => $self->refundnum } ) ; @@ -307,6 +338,48 @@ sub unapplied { =back +=head1 CLASS METHODS + +=over 4 + +=item unapplied_sql + +Returns an SQL fragment to retreive the unapplied amount. + +=cut + +sub unapplied_sql { + my ($class, $start, $end) = @_; + my $credit_start = $start ? "AND cust_credit_refund._date <= $start" : ''; + my $credit_end = $end ? "AND cust_credit_refund._date > $end" : ''; + my $pay_start = $start ? "AND cust_pay_refund._date <= $start" : ''; + my $pay_end = $end ? "AND cust_pay_refund._date > $end" : ''; + + "refund + - COALESCE( + ( SELECT SUM(amount) FROM cust_credit_refund + WHERE cust_refund.refundnum = cust_credit_refund.refundnum + $credit_start $credit_end ) + ,0 + ) + - COALESCE( + ( SELECT SUM(amount) FROM cust_pay_refund + WHERE cust_refund.refundnum = cust_pay_refund.refundnum + $pay_start $pay_end ) + ,0 + ) + "; + +} + +# Used by FS::Upgrade to migrate to a new database. +sub _upgrade_data { # class method + my ($class, %opts) = @_; + $class->_upgrade_otaker(%opts); +} + +=back + =head1 BUGS Delete and replace methods.