X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=SL%2FDB%2FHelper%2FPayment.pm;h=dfc5b797f032ee20f8b17415b665b867df27b481;hb=e5097146f785a1b7690dd1be8a9a0aec190a404b;hp=073e0ec52f996e474e6419cd460b2289fd6999b1;hpb=fca946068709229a086497380cdc62d874a8e795;p=kivitendo-erp.git diff --git a/SL/DB/Helper/Payment.pm b/SL/DB/Helper/Payment.pm index 073e0ec52..dfc5b797f 100644 --- a/SL/DB/Helper/Payment.pm +++ b/SL/DB/Helper/Payment.pm @@ -37,18 +37,31 @@ 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')) { + if (ref($params{transdate}) eq 'DateTime') { $transdate_obj = $params{transdate}; } else { - $transdate_obj = $::locale->parse_date_to_object($params{transdate}); + $transdate_obj = $::locale->parse_date_to_object($params{transdate}); }; croak t8('Illegal date') unless ref $transdate_obj; @@ -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; @@ -462,6 +483,12 @@ sub check_skonto_configuration { foreach my $transaction (@{ $self->transactions }) { # find all transactions with an AR_amount or AP_amount link my $tax = SL::DB::Manager::Tax->get_first( where => [taxkey => $transaction->taxkey, id => $transaction->tax_id ]); + + # acc_trans entries for the taxes (chart_link == A[RP]_tax) often + # have combinations of taxkey & tax_id that don't exist in + # tax. Those must be skipped. + next if !$tax && ($transaction->chart_link !~ m{A[RP]_amount}); + croak "no tax for taxkey " . $transaction->{taxkey} unless ref $tax; $transaction->{chartlinks} = { map { $_ => 1 } split(m/:/, $transaction->chart_link) }; @@ -631,22 +658,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 +743,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 +793,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 +892,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 +1143,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