X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=SL%2FDB%2FHelper%2FPayment.pm;h=3522e64f611dc68f24c33aaf96332866dc019a51;hb=53e988b8907baa17f684ee66c6b7aa90fe7c27fb;hp=073e0ec52f996e474e6419cd460b2289fd6999b1;hpb=fca946068709229a086497380cdc62d874a8e795;p=kivitendo-erp.git diff --git a/SL/DB/Helper/Payment.pm b/SL/DB/Helper/Payment.pm index 073e0ec52..3522e64f6 100644 --- a/SL/DB/Helper/Payment.pm +++ b/SL/DB/Helper/Payment.pm @@ -37,12 +37,25 @@ sub pay_invoice { $params{payment_type} = 'without_skonto' unless $params{payment_type}; validate_payment_type($params{payment_type}); - # check for required parameters + # check for required parameters and optional params depending on payment_type Common::check_params(\%params, qw(chart_id transdate)); if ( $params{'payment_type'} eq 'without_skonto' && abs($params{'amount'}) < 0) { croak "invalid amount for payment_type 'without_skonto': $params{'amount'}\n"; } - + if ($params{'payment_type'} eq 'free_skonto') { + # we dont like too much automagic for this payment type. + # we force caller input for amount and skonto amount + Common::check_params(\%params, qw(amount skonto_amount)); + # secondly we dont want to handle credit notes and purchase credit notes + croak("Cannot use 'free skonto' for credit or debit notes") if ($params{amount} <= 0 || $params{skonto_amount} <= 0); + # both amount have to be rounded + $params{skonto_amount} = _round($params{skonto_amount}); + $params{amount} = _round($params{amount}); + # lastly skonto_amount has to be smaller than the open invoice amount or payment amount ;-) + if ($params{skonto_amount} > abs($self->open_amount) || $params{skonto_amount} > $params{amount}) { + croak("Skonto amount higher than the payment or invoice amount"); + } + } my $transdate_obj; if (ref($params{transdate} eq 'DateTime')) { @@ -130,7 +143,7 @@ sub pay_invoice { # taxkey 0 unless ( $params{payment_type} eq 'difference_as_skonto' ) { - # cases with_skonto_pt and without_skonto + # cases with_skonto_pt, free_skonto and without_skonto # for case with_skonto_pt we need to know the corrected amount at this # stage if we are going to use $params{amount} @@ -198,16 +211,18 @@ sub pay_invoice { } } } - - if ( $params{payment_type} eq 'difference_as_skonto' or $params{payment_type} eq 'with_skonto_pt' ) { + # better everything except without_skonto + if ($params{payment_type} eq 'difference_as_skonto' or $params{payment_type} eq 'with_skonto_pt' + or $params{payment_type} eq 'free_skonto' ) { my $total_skonto_amount; if ( $params{payment_type} eq 'with_skonto_pt' ) { $total_skonto_amount = $self->skonto_amount; } elsif ( $params{payment_type} eq 'difference_as_skonto' ) { $total_skonto_amount = $self->open_amount; - }; - + } elsif ( $params{payment_type} eq 'free_skonto') { + $total_skonto_amount = $params{skonto_amount}; + } my @skonto_bookings = $self->skonto_charts($total_skonto_amount); # error checking: @@ -256,6 +271,10 @@ sub pay_invoice { # with_skonto_pt for completely unpaid invoices we just use the value # from the invoice $arap_amount = $total_open_amount; + } elsif ( $params{payment_type} eq 'free_skonto' ) { + # we forced positive values and forced rounding at the beginning + # therefore the above comment can be safely applied for this payment type + $arap_amount = $params{amount} + $params{skonto_amount}; } # regardless of payment_type there is always only exactly one arap booking @@ -442,6 +461,8 @@ sub percent_skonto { sub amount_less_skonto { # amount that has to be paid if skonto applies, always return positive rounded values + # no, rare case, but credit_notes and negative ap have negative amounts + # and therefore this comment may be misguiding # the result is rounded so we can directly compare it with the user input my $self = shift; @@ -631,22 +652,26 @@ sub get_payment_select_options_for_bank_transaction { # CAVEAT template code expects with_skonto_pt at position 1 for visual help + # due to skonto_charts, we cannot offer skonto for credit notes and neg ap + my $skontoable = $self->amount > 0 ? 1 : 0; my @options; if(!$self->skonto_date) { push(@options, { payment_type => 'without_skonto', display => t8('without skonto'), selected => 1 }); # wrong call to presenter or not implemented? disabled option is ignored # push(@options, { payment_type => 'with_skonto_pt', display => t8('with skonto acc. to pt'), disabled => 1 }); + push(@options, { payment_type => 'free_skonto', display => t8('free skonto') }) if $skontoable; return @options; } # valid skonto date, check if skonto is preferred my $bt = SL::DB::BankTransaction->new(id => $bt_id)->load; if ($self->skonto_date && $self->within_skonto_period($bt->transdate)) { push(@options, { payment_type => 'without_skonto', display => t8('without skonto') }); - push(@options, { payment_type => 'with_skonto_pt', display => t8('with skonto acc. to pt'), selected => 1 }); + push(@options, { payment_type => 'with_skonto_pt', display => t8('with skonto acc. to pt'), selected => 1 }) if $skontoable; } else { push(@options, { payment_type => 'without_skonto', display => t8('without skonto') , selected => 1 }); - push(@options, { payment_type => 'with_skonto_pt', display => t8('with skonto acc. to pt')}); + push(@options, { payment_type => 'with_skonto_pt', display => t8('with skonto acc. to pt')}) if $skontoable; } + push(@options, { payment_type => 'free_skonto', display => t8('free skonto') }) if $skontoable; return @options; } @@ -712,7 +737,7 @@ sub get_payment_suggestions { sub validate_payment_type { my $payment_type = shift; - my %allowed_payment_types = map { $_ => 1 } qw(without_skonto with_skonto_pt difference_as_skonto); + my %allowed_payment_types = map { $_ => 1 } qw(without_skonto with_skonto_pt difference_as_skonto free_skonto); croak "illegal payment type: $payment_type, must be one of: " . join(' ', keys %allowed_payment_types) unless $allowed_payment_types{ $payment_type }; return 1; @@ -762,6 +787,9 @@ This function deals with all the acc_trans entries and also updates paid and dat The params C and C are mandantory. If the default payment ('without_skonto') is used the param amount is also mandantory. +If the payment type ('free_skonto') is used the number params skonto_amount and amount +are as well mandantory and need to be positive. Furthermore the skonto amount has +to be lower than the payment or open invoice amount. Transdate can either be a date object or a date string. Chart_id is the id of the payment booking chart. @@ -858,6 +886,7 @@ invoice is assumed to be the payment currency. If successful the return value will be 1 in scalar context or in list context the two ids (acc_trans_id) of the newly created bookings. + =item C Returns a chart object which is the chart of the invoice with link AR or AP. @@ -1108,6 +1137,12 @@ Returns 1 if record uses a different currency, 0 if the default currency is used when looking at open amount, maybe consider that there may already be queued amounts in SEPA Export +=item * C + +Cannot handle negative skonto amounts, will always calculate the skonto amount +for credit notes or negative ap transactions with a positive sign. + + =back =head1 AUTHOR