Merge branch 'b-3.6.1' of ../kivitendo-erp_20220811
[kivitendo-erp.git] / SL / Dev / Payment.pm
diff --git a/SL/Dev/Payment.pm b/SL/Dev/Payment.pm
new file mode 100644 (file)
index 0000000..a093ed4
--- /dev/null
@@ -0,0 +1,185 @@
+package SL::Dev::Payment;
+
+use strict;
+use base qw(Exporter);
+our @EXPORT_OK = qw(create_payment_terms create_bank_account create_bank_transaction create_sepa_export create_sepa_export_item);
+our %EXPORT_TAGS = (ALL => \@EXPORT_OK);
+
+use SL::DB::PaymentTerm;
+use SL::DB::BankAccount;
+use SL::DB::Chart;
+use DateTime;
+
+sub create_payment_terms {
+  my (%params) = @_;
+
+  my $payment_terms =  SL::DB::PaymentTerm->new(
+    description      => 'payment',
+    description_long => 'payment',
+    terms_netto      => '30',
+    terms_skonto     => '5',
+    percent_skonto   => '0.05',
+    auto_calculation => 1,
+  );
+  $payment_terms->assign_attributes(%params) if %params;
+  $payment_terms->save;
+}
+
+sub create_bank_account {
+  my (%params) = @_;
+  my $bank_account = SL::DB::BankAccount->new(
+    iban           => 'DE12500105170648489890',
+    account_number => '0648489890',
+    bank           => 'Testbank',
+    chart_id       => delete $params{chart_id} // $::instance_conf->get_ar_paid_accno_id,
+    name           => 'Test bank account',
+    bic            => 'BANK1234',
+    bank_code      => '50010517'
+  );
+  $bank_account->assign_attributes(%params) if %params;
+  $bank_account->save;
+}
+
+sub create_sepa_export {
+  my (%params) = @_;
+  my $sepa_export = SL::DB::SepaExport->new(
+    closed       => 0,
+    employee_id  => $params{employee_id} // SL::DB::Manager::Employee->current->id,
+    executed     => 0,
+    vc           => 'customer',
+  );
+  $sepa_export->assign_attributes(%params) if %params;
+  $sepa_export->save;
+}
+
+sub create_sepa_export_item {
+  my (%params) = @_;
+  my $sepa_exportitem = SL::DB::SepaExportItem->new(
+    chart_id     => delete $params{chart_id} // $::instance_conf->get_ar_paid_accno_id,
+    payment_type => 'without_skonto',
+    our_bic      => 'BANK1234',
+    our_iban     => 'DE12500105170648489890',
+  );
+  $sepa_exportitem->assign_attributes(%params) if %params;
+  $sepa_exportitem->save;
+}
+
+sub create_bank_transaction {
+ my (%params) = @_;
+
+ my $record = delete $params{record};
+ die "bank_transactions can only be created for invoices" unless ref($record) eq 'SL::DB::Invoice' or ref($record) eq 'SL::DB::PurchaseInvoice';
+
+ my $multiplier = $record->is_sales ? 1 : -1;
+ my $amount = (delete $params{amount} || $record->amount) * $multiplier;
+
+ my $bank_chart;
+ if ( $params{bank_chart_id} ) {
+   $bank_chart = SL::DB::Manager::Chart->find_by(id => delete $params{bank_chart_id}) or die "Can't find bank chart";
+ } elsif ( $::instance_conf->get_ar_paid_accno_id ) {
+   $bank_chart   = SL::DB::Manager::Chart->find_by(id => $::instance_conf->get_ar_paid_accno_id);
+ } else {
+   $bank_chart = SL::DB::Manager::Chart->find_by(description => 'Bank') or die "Can't find bank chart";
+ }
+ my $bank_account = SL::DB::Manager::BankAccount->find_by( chart_id => $bank_chart->id );
+ die "bank account missing" unless $bank_account;
+
+ my $bt = SL::DB::BankTransaction->new(
+   local_bank_account_id => $bank_account->id,
+   remote_bank_code      => $record->customervendor->bank_code,
+   remote_account_number => $record->customervendor->account_number,
+   transdate             => DateTime->today,
+   valutadate            => DateTime->today,
+   amount                => $amount,
+   currency              => $record->currency->id,
+   remote_name           => $record->customervendor->depositor,
+   purpose               => $record->invnumber
+ );
+ $bt->assign_attributes(%params) if %params;
+ $bt->save;
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+SL::Dev::Payment - create objects for payment-related testing, with minimal defaults
+
+=head1 FUNCTIONS
+
+=head2 C<create_payment_terms %PARAMS>
+
+Create payment terms.
+
+Minimal example with default values (30days, 5% skonto within 5 days):
+  my $payment_terms = SL::Dev::Payment::create_payment_terms;
+
+=head2 C<create_bank_account %PARAMS>
+
+Required params: chart_id
+
+Example:
+  my $bank_account = SL::Dev::Payment::create_bank_account(chart_id => SL::DB::Manager::Chart->find_by(description => 'Bank')->id);
+
+=head2 C<create_bank_transaction %PARAMS>
+
+Create a bank transaction that matches an existing invoice record, e.g. to be able to
+test the point system.
+
+Required params: record  (an SL::DB::Invoice or SL::DB::PurchaseInvoice object)
+
+Optional params: bank_chart_id : the chart id of a configured bank account
+                 amount        : the amount of the bank transaction
+
+If no bank_chart_id is given, it tries to find a chart via defaults
+(ar_paid_accno_id) or by searching for the chart named "Bank". The chart must
+be connected to an existing BankAccount.
+
+Param amount should always be relative to the absolute amount of the invoice, i.e. use positive
+values for sales and purchases.
+
+Example:
+  my $payment_terms = SL::Dev::Payment::create_payment_terms;
+  my $bank_chart    = SL::DB::Manager::Chart->find_by(description => 'Bank');
+  my $bank_account  = SL::Dev::Payment::create_bank_account(chart_id => $bank_chart->id);
+  my $customer      = SL::Dev::CustomerVendor::create_customer(iban           => 'DE12500105170648489890',
+                                                               bank_code      => 'abc',
+                                                               account_number => '44444',
+                                                               bank           => 'Testbank',
+                                                               bic            => 'foobar',
+                                                               depositor      => 'Name')->save;
+  my $sales_invoice = SL::Dev::Record::create_sales_invoice(customer      => $customer,
+                                                            payment_terms => $payment_terms,
+                                                           );
+  my $bt            = SL::Dev::Payment::create_bank_transaction(record        => $sales_invoice,
+                                                                amount        => $sales_invoice->amount_less_skonto,
+                                                                transdate     => DateTime->today->add(days => 10),
+                                                                bank_chart_id => $bank_chart->id
+                                                               );
+  my ($agreement, $rule_matches) = $bt->get_agreement_with_invoice($sales_invoice);
+  # 14, 'remote_account_number(3) skonto_exact_amount(5) cust_vend_number_in_purpose(1) depositor_matches(2) payment_within_30_days(1) datebonus14(2)'
+
+To create a payment for 3 invoices that were all paid together, all with skonto:
+  my $ar1 = SL::DB::Manager::Invoice->find_by(invnumber=>'20');
+  my $ar2 = SL::DB::Manager::Invoice->find_by(invnumber=>'21');
+  my $ar3 = SL::DB::Manager::Invoice->find_by(invnumber=>'22');
+  SL::Dev::Payment::create_bank_transaction(record  => $ar1
+                                            amount  => ($ar1->amount_less_skonto + $ar2->amount_less_skonto + $ar2->amount_less_skonto),
+                                            purpose => 'Rechnungen 20, 21, 22',
+                                           );
+
+=head1 TODO
+
+Nothing here yet.
+
+=head1 BUGS
+
+Nothing here yet.
+
+=head1 AUTHOR
+
+G. Richardson E<lt>grichardson@kivitendo-premium.deE<gt>
+
+=cut