X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=SL%2FDB%2FPaymentTerm.pm;h=2f62bd9ac5790fb8b8b059918c6c2341bd31433f;hb=b74d1c197c8365b14587838d999244274de12884;hp=3630a709431a60bc3ebe6a5a97af005b8d88fe3f;hpb=5fd2cf413e611047a3b8d667378a258a7955941e;p=kivitendo-erp.git diff --git a/SL/DB/PaymentTerm.pm b/SL/DB/PaymentTerm.pm index 3630a7094..2f62bd9ac 100644 --- a/SL/DB/PaymentTerm.pm +++ b/SL/DB/PaymentTerm.pm @@ -2,11 +2,15 @@ package SL::DB::PaymentTerm; use strict; +use List::Util qw(max); + use SL::DB::MetaSetup::PaymentTerm; use SL::DB::Manager::PaymentTerm; use SL::DB::Helper::ActsAsList; use SL::DB::Helper::TranslatedAttributes; +__PACKAGE__->meta->initialize; + sub validate { my ($self) = @_; @@ -17,4 +21,107 @@ sub validate { return @errors; } +sub calc_date { + my ($self, %params) = @_; + + my $reference_date = $params{reference_date} || DateTime->today_local; + $reference_date = DateTime->from_kivitendo($reference_date) unless ref($reference_date) eq 'DateTime'; + + if (!$self->auto_calculation) { + my $due_date = $params{due_date} || $reference_date; + $due_date = DateTime->from_kivitendo($due_date) unless ref($due_date) eq 'DateTime'; + + return max $due_date, $reference_date; + } + + my $terms = ($params{terms} // 'net') eq 'discount' ? 'terms_skonto' : 'terms_netto'; + my $date = $reference_date->clone->add(days => $self->$terms); + + my $dow = $date->day_of_week; + $date = $date->add(days => 8 - $dow) if $dow > 5; + + return $date; +} + 1; +__END__ + +=pod + +=encoding utf8 + +=head1 NAME + +SL::DB::PaymentTerm - Rose model for the payment_terms table + +=head1 SYNOPSIS + + my $terms = SL::DB::PaymentTerm->new(id => $::form->{payment_id})->load; + my $due_date_net = $terms->calc_date(terms => 'net'); # uses terms_netto + my $due_date_discount = $terms->calc_date(terms => 'discount'); # uses terms_skonto + + # Calculate due date taking the existing invoice date and the due + # date entered by the user into account: + my $due_date = $terms->calc_date( + reference_date => $::form->{invdate}, + due_date => $::form->{duedate}, + ); + +=head1 FUNCTIONS + +=over 4 + +=item C + +Calculates and returns a due date as an instance of L by +adding one of C<$self>'s terms fields if automatic calculation is on; +otherwise returns the currently-set due date (which must be provided) +or the reference date, whichever is later. + +Note that for automatic calculation the resulting date will be the +following Monday if the result falls on a weekend. + +C<%params> can contain the following parameters: + +=over 4 + +=item C + +The reference date from which the due date will be calculated. Can be +either an instance of L or a scalar in which case the scalar +is parsed via L. + +Defaults to the current date if unset. + +=item C + +A currently set due date. If automatic calculation is off then this +date will be returned if it is provided and greater than or equal to +the C. Otherwise the reference date will be returned. + +=item C + +Can be either C or C. For C the number of days to +add to the reference date are C<$self-Eterms_netto>. For +C C<$self-Eterms_skonto> is used. + +Defaults to C if unset. + +=back + +=item C + +Validates before saving and returns an array of human-readable error +messages in case of an error. + +=back + +=head1 BUGS + +Nothing here yet. + +=head1 AUTHOR + +Moritz Bunkus Em.bunkus@linet-services.deE + +=cut