BUG-Fix: Kreditorenbuchungen: Währung wird nicht übernommen.
[kivitendo-erp.git] / bin / mozilla / ar.pl
1 #=====================================================================
2 # LX-Office ERP
3 # Copyright (C) 2004
4 # Based on SQL-Ledger Version 2.1.9
5 # Web http://www.lx-office.org
6 #
7 #=====================================================================
8 # SQL-Ledger Accounting
9 # Copyright (c) 2001
10 #
11 #  Author: Dieter Simader
12 #   Email: dsimader@sql-ledger.org
13 #     Web: http://www.sql-ledger.org
14 #
15 #
16 # This program is free software; you can redistribute it and/or modify
17 # it under the terms of the GNU General Public License as published by
18 # the Free Software Foundation; either version 2 of the License, or
19 # (at your option) any later version.
20 #
21 # This program is distributed in the hope that it will be useful,
22 # but WITHOUT ANY WARRANTY; without even the implied warranty of
23 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
24 # GNU General Public License for more details.
25 # You should have received a copy of the GNU General Public License
26 # along with this program; if not, write to the Free Software
27 # Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
28 #======================================================================
29 #
30 # Accounts Receivables
31 #
32 #======================================================================
33
34 use POSIX qw(strftime);
35 use List::Util qw(sum first max);
36 use List::UtilsBy qw(sort_by);
37
38 use SL::AR;
39 use SL::FU;
40 use SL::IS;
41 use SL::PE;
42 use SL::DB::Default;
43 use SL::DB::Invoice;
44 use SL::ReportGenerator;
45
46 require "bin/mozilla/arap.pl";
47 require "bin/mozilla/common.pl";
48 require "bin/mozilla/reportgenerator.pl";
49
50 use strict;
51 #use warnings;
52
53 # this is for our long dates
54 # $locale->text('January')
55 # $locale->text('February')
56 # $locale->text('March')
57 # $locale->text('April')
58 # $locale->text('May ')
59 # $locale->text('June')
60 # $locale->text('July')
61 # $locale->text('August')
62 # $locale->text('September')
63 # $locale->text('October')
64 # $locale->text('November')
65 # $locale->text('December')
66
67 # this is for our short month
68 # $locale->text('Jan')
69 # $locale->text('Feb')
70 # $locale->text('Mar')
71 # $locale->text('Apr')
72 # $locale->text('May')
73 # $locale->text('Jun')
74 # $locale->text('Jul')
75 # $locale->text('Aug')
76 # $locale->text('Sep')
77 # $locale->text('Oct')
78 # $locale->text('Nov')
79 # $locale->text('Dec')
80
81 sub add {
82   $main::lxdebug->enter_sub();
83
84   $main::auth->assert('general_ledger');
85
86   my $form     = $main::form;
87   my %myconfig = %main::myconfig;
88
89   # saving the history
90   if(!exists $form->{addition} && ($form->{id} ne "")) {
91     $form->{snumbers} = qq|invnumber_| . $form->{invnumber};
92     $form->{addition} = "ADDED";
93     $form->save_history;
94   }
95   # /saving the history
96
97   $form->{title}    = "Add";
98   $form->{callback} = "ar.pl?action=add" unless $form->{callback};
99
100   AR->get_transdate(\%myconfig, $form);
101   $form->{initial_transdate} = $form->{transdate};
102   create_links(dont_save => 1);
103   $form->{transdate} = $form->{initial_transdate};
104   &display_form;
105   $main::lxdebug->leave_sub();
106 }
107
108 sub edit {
109   $main::lxdebug->enter_sub();
110
111   $main::auth->assert('general_ledger');
112
113   my $form     = $main::form;
114
115   # show history button
116   $form->{javascript} = qq|<script type="text/javascript" src="js/show_history.js"></script>|;
117   #/show hhistory button
118   $form->{javascript} .= qq|<script type="text/javascript" src="js/common.js"></script>|;
119   $form->{title} = "Edit";
120
121   create_links();
122   &display_form;
123
124   $main::lxdebug->leave_sub();
125 }
126
127 sub display_form {
128   $main::lxdebug->enter_sub();
129
130   $main::auth->assert('general_ledger');
131
132   my $form     = $main::form;
133
134   &form_header;
135   &form_footer;
136
137   $main::lxdebug->leave_sub();
138 }
139
140 sub _retrieve_invoice_object {
141   return undef if !$::form->{id};
142   return $::form->{invoice_obj} if $::form->{invoice_obj} && $::form->{invoice_obj}->id == $::form->{id};
143   return SL::DB::Invoice->new(id => $::form->{id})->load;
144 }
145
146 sub create_links {
147   $main::lxdebug->enter_sub();
148
149   $main::auth->assert('general_ledger');
150
151   my %params   = @_;
152   my $form     = $main::form;
153   my %myconfig = %main::myconfig;
154
155   $form->create_links("AR", \%myconfig, "customer");
156   $form->{invoice_obj} = _retrieve_invoice_object();
157
158   my %saved;
159   if (!$params{dont_save}) {
160     %saved = map { ($_ => $form->{$_}) } qw(direct_debit id taxincluded);
161     $saved{duedate} = $form->{duedate} if $form->{duedate};
162     $saved{currency} = $form->{currency} if $form->{currency};
163   }
164
165   IS->get_customer(\%myconfig, \%$form);
166
167   $form->{$_}          = $saved{$_} for keys %saved;
168   $form->{oldcustomer} = "$form->{customer}--$form->{customer_id}";
169   $form->{rowcount}    = 1;
170
171   # currencies
172   $form->{defaultcurrency} = $form->get_default_currency(\%myconfig);
173
174   map { $form->{selectcurrency} .= "<option>$_\n" } $form->get_all_currencies(\%myconfig);
175
176   # customers
177   if (@{ $form->{all_customer} || [] }) {
178     $form->{customer} = "$form->{customer}--$form->{customer_id}";
179     map { $form->{selectcustomer} .= "<option>$_->{name}--$_->{id}\n" }
180       (@{ $form->{all_customer} });
181   }
182
183   # departments
184   if (@{ $form->{all_departments} || [] }) {
185     $form->{selectdepartment} = "<option>\n";
186     $form->{department}       = "$form->{department}--$form->{department_id}";
187
188     map {
189       $form->{selectdepartment} .=
190         "<option>$_->{description}--$_->{id}\n"
191     } (@{ $form->{all_departments} || [] });
192   }
193
194   $form->{employee} = "$form->{employee}--$form->{employee_id}";
195
196   # sales staff
197   if (@{ $form->{all_employees} || [] }) {
198     $form->{selectemployee} = "";
199     map { $form->{selectemployee} .= "<option>$_->{name}--$_->{id}\n" }
200       (@{ $form->{all_employees} || [] });
201   }
202
203   # build the popup menus
204   $form->{taxincluded} = ($form->{id}) ? $form->{taxincluded} : "checked";
205
206   AR->setup_form($form);
207
208   $form->{locked} =
209     ($form->datetonum($form->{transdate}, \%myconfig) <=
210      $form->datetonum($form->{closedto}, \%myconfig));
211
212   $main::lxdebug->leave_sub();
213 }
214
215 sub form_header {
216   $main::lxdebug->enter_sub();
217
218   $main::auth->assert('general_ledger');
219
220   my $form     = $main::form;
221   my %myconfig = %main::myconfig;
222   my $locale   = $main::locale;
223   my $cgi      = $::request->{cgi};
224
225   $form->{invoice_obj} = _retrieve_invoice_object();
226
227   my ($title, $readonly, $exchangerate, $rows);
228   my ($notes, $department, $customer, $employee, $amount, $project);
229   my ($ARselected);
230
231
232   $title = $form->{title};
233   # $locale->text('Add Accounts Receivables Transaction')
234   # $locale->text('Edit Accounts Receivables Transaction')
235   $form->{title} = $locale->text("$title Accounts Receivables Transaction");
236
237   $form->{javascript} = qq|<script type="text/javascript">
238   <!--
239   function setTaxkey(accno, row) {
240     var taxkey = accno.options[accno.selectedIndex].value;
241     var reg = /--([0-9]*)/;
242     var found = reg.exec(taxkey);
243     var index = found[1];
244     index = parseInt(index);
245     var tax = 'taxchart_' + row;
246     for (var i = 0; i < document.getElementById(tax).options.length; ++i) {
247       var reg2 = new RegExp("^"+ index, "");
248       if (reg2.exec(document.getElementById(tax).options[i].value)) {
249         document.getElementById(tax).options[i].selected = true;
250         break;
251       }
252     }
253   };
254   //-->
255   </script>|;
256   # show history button js
257   $form->{javascript} .= qq|<script type="text/javascript" src="js/show_history.js"></script>|;
258   #/show history button js
259   $readonly = ($form->{id}) ? "readonly" : "";
260
261   $form->{radier} = ($::instance_conf->get_ar_changeable == 2)
262                       ? ($form->current_date(\%myconfig) eq $form->{gldate})
263                       : ($::instance_conf->get_ar_changeable == 1);
264   $readonly = ($form->{radier}) ? "" : $readonly;
265
266   # set option selected
267   foreach my $item (qw(customer currency department employee)) {
268     $form->{"select$item"} =~ s/ selected//;
269     $form->{"select$item"} =~ s/option>\Q$form->{$item}\E/option selected>$form->{$item}/;
270   }
271
272   $form->{forex}        = $form->check_exchangerate( \%myconfig, $form->{currency}, $form->{transdate}, 'buy');
273   $form->{exchangerate} = $form->{forex} if $form->{forex};
274
275   # format exchangerate
276   $form->{exchangerate}    = $form->{exchangerate} ? $form->format_amount(\%myconfig, $form->{exchangerate}) : '';
277
278   $rows = max 2, $form->numtextrows($form->{notes}, 50);
279
280   my @old_project_ids = grep { $_ } map { $form->{"project_id_$_"} } 1..$form->{rowcount};
281
282   $form->get_lists("projects"  => { "key"       => "ALL_PROJECTS",
283                                     "all"       => 0,
284                                     "old_id"    => \@old_project_ids },
285                    "charts"    => { "key"       => "ALL_CHARTS",
286                                     "transdate" => $form->{transdate} },
287                    "taxcharts" => { "key"       => "ALL_TAXCHARTS",
288                                     "module"    => "AR" },);
289
290   $_->{link_split} = { map { $_ => 1 } split/:/, $_->{link} } for @{ $form->{ALL_CHARTS} };
291
292   my %project_labels = map { $_->{id} => $_->{projectnumber} } @{ $form->{"ALL_PROJECTS"} };
293
294   my (@AR_amount_values);
295   my (@AR_values);
296   my (@AR_paid_values);
297   my %chart_labels;
298   my %charts;
299   my $taxchart_init;
300
301   foreach my $item (@{ $form->{ALL_CHARTS} }) {
302     if ($item->{link_split}{AR_amount}) {
303       $taxchart_init = $item->{tax_id} if ($taxchart_init eq "");
304       my $key = "$item->{accno}--$item->{tax_id}";
305       push(@AR_amount_values, $key);
306     } elsif ($item->{link_split}{AR}) {
307       push(@AR_values, $item->{accno});
308     } elsif ($item->{link_split}{AR_paid}) {
309       push(@AR_paid_values, $item->{accno});
310     }
311
312     # weirdness for AR_amount
313     $chart_labels{$item->{accno}} = "$item->{accno}--$item->{description}";
314     $chart_labels{"$item->{accno}--$item->{tax_id}"} = "$item->{accno}--$item->{description}";
315
316     $charts{$item->{accno}} = $item;
317   }
318
319   my %taxchart_labels = ();
320   my @taxchart_values = ();
321   my %taxcharts = ();
322   foreach my $item (@{ $form->{ALL_TAXCHARTS} }) {
323     my $key = "$item->{id}--$item->{rate}";
324     $taxchart_init = $key if ($taxchart_init eq $item->{id});
325     push(@taxchart_values, $key);
326     $taxchart_labels{$key} = "$item->{taxdescription} " . ($item->{rate} * 100) . ' %';
327     $taxcharts{$item->{id}} = $item;
328   }
329
330   my $follow_up_vc         =  $form->{customer};
331   $follow_up_vc            =~ s/--.*?//;
332   my $follow_up_trans_info =  "$form->{invnumber} ($follow_up_vc)";
333
334   $form->{javascript} .=
335     qq|<script type="text/javascript" src="js/show_vc_details.js"></script>| .
336     qq|<script type="text/javascript" src="js/follow_up.js"></script>| .
337     qq|<script type="text/javascript" src="js/kivi.Draft.js"></script>|;
338
339 #  $amount  = $locale->text('Amount');
340 #  $project = $locale->text('Project');
341
342   my @transactions;
343   for my $i (1 .. $form->{rowcount}) {
344     my $transaction = {
345       amount     => $form->{"amount_$i"},
346       tax        => $form->{"tax_$i"},
347       project_id => ($i==$form->{rowcount}) ? $form->{globalproject_id} : $form->{"project_id_$i"},
348     };
349
350     my $selected_accno_full;
351     my ($accno_row) = split(/--/, $form->{"AR_amount_$i"});
352     my $item = $charts{$accno_row};
353     $selected_accno_full = "$item->{accno}--$item->{tax_id}";
354
355     my $selected_taxchart = $form->{"taxchart_$i"};
356     my ($selected_accno, $selected_tax_id) = split(/--/, $selected_accno_full);
357     my ($previous_accno, $previous_tax_id) = split(/--/, $form->{"previous_AR_amount_$i"});
358
359     if ($previous_accno &&
360         ($previous_accno eq $selected_accno) &&
361         ($previous_tax_id ne $selected_tax_id)) {
362       my $item = $taxcharts{$selected_tax_id};
363       $selected_taxchart = "$item->{id}--$item->{rate}";
364     }
365
366     if (!$form->{"taxchart_$i"}) {
367       if ($form->{"AR_amount_$i"} =~ m/.--./) {
368         $selected_taxchart = join '--', map { ($_->{id}, $_->{rate}) } first { $_->{id} == $item->{tax_id} } @{ $form->{ALL_TAXCHARTS} };
369       } else {
370         $selected_taxchart = $taxchart_init;
371       }
372     }
373
374     $transaction->{selectAR_amount} =
375       NTI($cgi->popup_menu('-name' => "AR_amount_$i",
376                            '-id' => "AR_amount_$i",
377                            '-style' => 'width:400px',
378                            '-onChange' => "setTaxkey(this, $i)",
379                            '-values' => \@AR_amount_values,
380                            '-labels' => \%chart_labels,
381                            '-default' => $selected_accno_full))
382       . $cgi->hidden('-name' => "previous_AR_amount_$i",
383                      '-default' => $selected_accno_full);
384
385     $transaction->{taxchart} =
386       NTI($cgi->popup_menu('-name' => "taxchart_$i",
387                            '-id' => "taxchart_$i",
388                            '-style' => 'width:200px',
389                            '-values' => \@taxchart_values,
390                            '-labels' => \%taxchart_labels,
391                            '-default' => $selected_taxchart));
392
393     push @transactions, $transaction;
394   }
395
396   $form->{invtotal_unformatted} = $form->{invtotal};
397
398   $ARselected =
399     NTI($cgi->popup_menu('-name' => "ARselected", '-id' => "ARselected",
400                          '-style' => 'width:400px',
401                          '-values' => \@AR_values, '-labels' => \%chart_labels,
402                          '-default' => $form->{ARselected}));
403
404
405   $form->{paidaccounts}++ if ($form->{"paid_$form->{paidaccounts}"});
406
407   my $now = $form->current_date(\%myconfig);
408
409   my @payments;
410   for my $i (1 .. $form->{paidaccounts}) {
411     my $payment = {
412       paid             => $form->{"paid_$i"},
413       exchangerate     => $form->{"exchangerate_$i"} || '',
414       gldate           => $form->{"gldate_$i"},
415       acc_trans_id     => $form->{"acc_trans_id_$i"},
416       source           => $form->{"source_$i"},
417       memo             => $form->{"memo_$i"},
418       AR_paid          => $form->{"AR_paid_$i"},
419       forex            => $form->{"forex_$i"},
420       datepaid         => $form->{"datepaid_$i"},
421       paid_project_id  => $form->{"paid_project_id_$i"},
422       gldate           => $form->{"gldate_$i"},
423     };
424
425     # default account for current assets (i.e. 1801 - SKR04) if no account is selected
426     $form->{accno_arap} = IS->get_standard_accno_current_assets(\%myconfig, \%$form);
427
428     $payment->{selectAR_paid} =
429       NTI($cgi->popup_menu('-name' => "AR_paid_$i",
430                            '-id' => "AR_paid_$i",
431                            '-values' => \@AR_paid_values,
432                            '-labels' => \%chart_labels,
433                            '-default' => $payment->{AR_paid} || $form->{accno_arap}));
434
435
436
437     $payment->{changeable} =
438         SL::DB::Default->get->payments_changeable == 0 ? !$payment->{acc_trans_id} # never
439       : SL::DB::Default->get->payments_changeable == 2 ? $payment->{gldate} eq '' || $payment->{gldate} eq $now
440       :                                                           1;
441
442     #deaktivieren von gebuchten Zahlungen ausserhalb der Bücherkontrolle, vorher prüfen ob heute eingegeben
443     if ($form->date_closed($payment->{"gldate_$i"})) {
444         $payment->{changeable} = 0;
445     }
446
447     push @payments, $payment;
448   }
449
450   my @empty = grep { $_->{paid} eq '' } @payments;
451   @payments = (
452     (sort_by { DateTime->from_kivitendo($_->{datepaid}) } grep { $_->{paid} ne '' } @payments),
453     @empty,
454   );
455
456   $form->{totalpaid} = sum map { $_->{paid} } @payments;
457
458   $form->header;
459   print $::form->parse_html_template('ar/form_header', {
460     paid_missing         => $::form->{invtotal} - $::form->{totalpaid},
461     show_exch            => ($::form->{defaultcurrency} && ($::form->{currency} ne $::form->{defaultcurrency})),
462     payments             => \@payments,
463     transactions         => \@transactions,
464     project_labels       => \%project_labels,
465     rows                 => $rows,
466     ARselected           => $ARselected,
467     title_str            => $title,
468     follow_up_trans_info => $follow_up_trans_info,
469     today                => DateTime->today,
470   });
471
472   $main::lxdebug->leave_sub();
473 }
474
475 sub form_footer {
476   $main::lxdebug->enter_sub();
477
478   $main::auth->assert('general_ledger');
479
480   my $form     = $main::form;
481   my %myconfig = %main::myconfig;
482   my $locale   = $main::locale;
483   my $cgi      = $::request->{cgi};
484
485   if ( $form->{id} ) {
486     my $follow_ups = FU->follow_ups('trans_id' => $form->{id});
487     if ( @{ $follow_ups} ) {
488       $form->{follow_up_length} = scalar(@{$follow_ups});
489       $form->{follow_up_due_length} = sum(map({ $_->{due} * 1 } @{ $follow_ups }));
490     }
491   }
492
493   my $transdate = $form->datetonum($form->{transdate}, \%myconfig);
494   my $closedto  = $form->datetonum($form->{closedto},  \%myconfig);
495
496   $form->{is_closed} = $transdate <= $closedto;
497
498   # ToDO: - insert a global check for stornos, so that a storno is only possible a limited time after saving it
499   $form->{show_storno_button} =
500     $form->{id} &&
501     !IS->has_storno(\%myconfig, $form, 'ar') &&
502     !IS->is_storno(\%myconfig, $form, 'ar') &&
503     ($form->{totalpaid} == 0 || $form->{totalpaid} eq "");
504
505   $form->{show_mark_as_paid_button} = $form->{id} && $::instance_conf->get_ar_show_mark_as_paid();
506
507   print $::form->parse_html_template('ar/form_footer');
508
509   $main::lxdebug->leave_sub();
510 }
511
512 sub mark_as_paid {
513   $main::lxdebug->enter_sub();
514
515   $main::auth->assert('general_ledger');
516
517   my $form     = $main::form;
518   my %myconfig = %main::myconfig;
519
520   &mark_as_paid_common(\%myconfig,"ar");
521
522   $main::lxdebug->leave_sub();
523 }
524
525 sub update {
526   $main::lxdebug->enter_sub();
527
528   $main::auth->assert('general_ledger');
529
530   my $form     = $main::form;
531   my %myconfig = %main::myconfig;
532
533   my $display = shift;
534
535   my ($totaltax, $exchangerate);
536
537   $form->{invtotal} = 0;
538
539   delete @{ $form }{ grep { m/^tax_\d+$/ } keys %{ $form } };
540
541   map { $form->{$_} = $form->parse_amount(\%myconfig, $form->{$_}) }
542     qw(exchangerate creditlimit creditremaining);
543
544   my @flds  = qw(amount AR_amount projectnumber oldprojectnumber project_id);
545   my $count = 0;
546   my @a     = ();
547
548   for my $i (1 .. $form->{rowcount}) {
549     $form->{"amount_$i"} = $form->parse_amount(\%myconfig, $form->{"amount_$i"});
550     if ($form->{"amount_$i"}) {
551       push @a, {};
552       my $j = $#a;
553       my ($taxkey, $rate) = split(/--/, $form->{"taxchart_$i"});
554
555       my $tmpnetamount;
556       ($tmpnetamount,$form->{"tax_$i"}) = $form->calculate_tax($form->{"amount_$i"},$rate,$form->{taxincluded},2);
557
558       $totaltax += $form->{"tax_$i"};
559       map { $a[$j]->{$_} = $form->{"${_}_$i"} } @flds;
560       $count++;
561     }
562   }
563
564   $form->redo_rows(\@flds, \@a, $count, $form->{rowcount});
565   $form->{rowcount} = $count + 1;
566   map { $form->{invtotal} += $form->{"amount_$_"} } (1 .. $form->{rowcount});
567
568   $form->{forex}        = $form->check_exchangerate( \%myconfig, $form->{currency}, $form->{transdate}, 'buy');
569   $form->{exchangerate} = $form->{forex} if $form->{forex};
570
571   $form->{invdate} = $form->{transdate};
572
573   my %saved_variables = map +( $_ => $form->{$_} ), qw(AR AR_amount_1 taxchart_1 customer_id notes);
574
575   &check_name("customer");
576
577   $form->{AR} = $saved_variables{AR};
578   if ($saved_variables{AR_amount_1} =~ m/.--./) {
579     map { $form->{$_} = $saved_variables{$_} } qw(AR_amount_1 taxchart_1);
580   } else {
581     delete $form->{taxchart_1};
582   }
583
584   $form->{invtotal} =
585     ($form->{taxincluded}) ? $form->{invtotal} : $form->{invtotal} + $totaltax;
586
587   for my $i (1 .. $form->{paidaccounts}) {
588     if ($form->parse_amount(\%myconfig, $form->{"paid_$i"})) {
589       map {
590         $form->{"${_}_$i"} =
591           $form->parse_amount(\%myconfig, $form->{"${_}_$i"})
592       } qw(paid exchangerate);
593
594       $form->{totalpaid} += $form->{"paid_$i"};
595
596       $form->{"forex_$i"}        = $form->check_exchangerate( \%myconfig, $form->{currency}, $form->{"datepaid_$i"}, 'buy');
597       $form->{"exchangerate_$i"} = $form->{"forex_$i"} if $form->{"forex_$i"};
598     }
599   }
600
601   $form->{creditremaining} -=
602     ($form->{invtotal} - $form->{totalpaid} + $form->{oldtotalpaid} -
603      $form->{oldinvtotal});
604   $form->{oldinvtotal}  = $form->{invtotal};
605   $form->{oldtotalpaid} = $form->{totalpaid};
606
607   &display_form;
608
609   $main::lxdebug->leave_sub();
610 }
611
612 #
613 # ToDO: fix $closedto and $invdate
614 #
615 sub post_payment {
616   $main::lxdebug->enter_sub();
617
618   $main::auth->assert('general_ledger');
619
620   my $form     = $main::form;
621   my %myconfig = %main::myconfig;
622   my $locale   = $main::locale;
623
624   $form->mtime_ischanged('ar');
625   $form->{defaultcurrency} = $form->get_default_currency(\%myconfig);
626
627   my $invdate = $form->datetonum($form->{transdate}, \%myconfig);
628
629   for my $i (1 .. $form->{paidaccounts}) {
630
631     if ($form->parse_amount(\%myconfig, $form->{"paid_$i"})) {
632       my $datepaid = $form->datetonum($form->{"datepaid_$i"}, \%myconfig);
633
634       $form->isblank("datepaid_$i", $locale->text('Payment date missing!'));
635
636       $form->error($locale->text('Cannot post transaction above the maximum future booking date!'))
637         if ($form->date_max_future($form->{"datepaid_$i"}, \%myconfig));
638
639       #Zusätzlich noch das Buchungsdatum in die Bücherkontrolle einbeziehen
640       # (Dient zur Prüfung ob ZE oder ZA geprüft werden soll)
641       $form->error($locale->text('Cannot post payment for a closed period!'))
642         if ($form->date_closed($form->{"datepaid_$i"})  && !$form->date_closed($form->{"gldate_$i"}, \%myconfig));
643
644       if ($form->{defaultcurrency} && ($form->{currency} ne $form->{defaultcurrency})) {
645 #        $form->{"exchangerate_$i"} = $form->{exchangerate} if ($invdate == $datepaid);
646         $form->isblank("exchangerate_$i", $locale->text('Exchangerate for payment missing!'));
647       }
648     }
649   }
650
651   ($form->{AR})      = split /--/, $form->{AR};
652   ($form->{AR_paid}) = split /--/, $form->{AR_paid};
653   if (AR->post_payment(\%myconfig, \%$form)) {
654     $form->{snumbers}  = qq|invnumber_| . $form->{invnumber};
655     $form->{what_done} = 'invoice';
656     $form->{addition}  = "PAYMENT POSTED";
657     $form->save_history;
658     $form->redirect($locale->text('Payment posted!'))
659   } else {
660     $form->error($locale->text('Cannot post payment!'));
661   };
662
663   $main::lxdebug->leave_sub();
664 }
665
666 sub _post {
667
668   $main::auth->assert('general_ledger');
669
670   my $form     = $main::form;
671
672   # inline post
673   post(1);
674 }
675
676 sub post {
677   $main::lxdebug->enter_sub();
678
679   $main::auth->assert('general_ledger');
680
681   my $form     = $main::form;
682   my %myconfig = %main::myconfig;
683   my $locale   = $main::locale;
684
685   my ($inline) = @_;
686
687   $form->mtime_ischanged('ar');
688
689   my ($datepaid);
690
691   # check if there is an invoice number, invoice and due date
692   $form->isblank("transdate", $locale->text('Invoice Date missing!'));
693   $form->isblank("duedate",   $locale->text('Due Date missing!'));
694   $form->isblank("customer",  $locale->text('Customer missing!'));
695
696   if ($myconfig{mandatory_departments} && !$form->{department}) {
697     $form->{saved_message} = $::locale->text('You have to specify a department.');
698     update();
699     exit;
700   }
701
702   my $closedto  = $form->datetonum($form->{closedto},  \%myconfig);
703   my $transdate = $form->datetonum($form->{transdate}, \%myconfig);
704
705   $form->error($locale->text('Cannot post transaction above the maximum future booking date!'))
706     if ($form->date_max_future($transdate, \%myconfig));
707
708   $form->error($locale->text('Cannot post transaction for a closed period!')) if ($form->date_closed($form->{"transdate"}, \%myconfig));
709
710   $form->error($locale->text('Zero amount posting!'))
711     unless grep $_*1, map $form->parse_amount(\%myconfig, $form->{"amount_$_"}), 1..$form->{rowcount};
712
713   $form->isblank("exchangerate", $locale->text('Exchangerate missing!'))
714     if ($form->{defaultcurrency} && ($form->{currency} ne $form->{defaultcurrency}));
715
716   delete($form->{AR});
717
718   for my $i (1 .. $form->{paidaccounts}) {
719     if ($form->parse_amount(\%myconfig, $form->{"paid_$i"})) {
720       $datepaid = $form->datetonum($form->{"datepaid_$i"}, \%myconfig);
721
722       $form->isblank("datepaid_$i", $locale->text('Payment date missing!'));
723
724       $form->error($locale->text('Cannot post transaction above the maximum future booking date!'))
725         if ($form->date_max_future($form->{"datepaid_$i"}, \%myconfig));
726
727       #Zusätzlich noch das Buchungsdatum in die Bücherkontrolle einbeziehen
728       # (Dient zur Prüfung ob ZE oder ZA geprüft werden soll)
729       $form->error($locale->text('Cannot post payment for a closed period!'))
730         if ($form->date_closed($form->{"datepaid_$i"})  && !$form->date_closed($form->{"gldate_$i"}, \%myconfig));
731
732       if ($form->{defaultcurrency} && ($form->{currency} ne $form->{defaultcurrency})) {
733         $form->{"exchangerate_$i"} = $form->{exchangerate} if ($transdate == $datepaid);
734         $form->isblank("exchangerate_$i", $locale->text('Exchangerate for payment missing!'));
735       }
736     }
737   }
738
739   # if oldcustomer ne customer redo form
740   my ($customer) = split /--/, $form->{customer};
741   if ($form->{oldcustomer} ne "$customer--$form->{customer_id}") {
742     update();
743     $::dispatcher->end_request;
744   }
745
746   $form->{AR}{receivables} = $form->{ARselected};
747   $form->{storno}          = 0;
748
749   $form->{id} = 0 if $form->{postasnew};
750   $form->error($locale->text('Cannot post transaction!')) unless AR->post_transaction(\%myconfig, \%$form);
751
752   # saving the history
753   if(!exists $form->{addition} && $form->{id} ne "") {
754     $form->{snumbers}  = "invnumber_$form->{invnumber}";
755     $form->{what_done} = "invoice";
756     $form->{addition}  = "POSTED";
757     $form->save_history;
758   }
759   # /saving the history
760
761   $form->redirect($locale->text('Transaction posted!')) unless $inline;
762
763   $main::lxdebug->leave_sub();
764 }
765
766 sub post_as_new {
767   $main::lxdebug->enter_sub();
768
769   $main::auth->assert('general_ledger');
770
771   my $form     = $main::form;
772   my %myconfig = %main::myconfig;
773
774   $form->{postasnew} = 1;
775   # saving the history
776   if(!exists $form->{addition} && $form->{id} ne "") {
777     $form->{snumbers}  = qq|invnumber_| . $form->{invnumber};
778     $form->{what_done} = "invoice";
779     $form->{addition}  = "POSTED AS NEW";
780     $form->save_history;
781   }
782   # /saving the history
783   &post;
784
785   $main::lxdebug->leave_sub();
786 }
787
788 sub use_as_new {
789   $main::lxdebug->enter_sub();
790
791   $main::auth->assert('general_ledger');
792
793   my $form     = $main::form;
794   my %myconfig = %main::myconfig;
795
796   map { delete $form->{$_} } qw(printed emailed queued invnumber invdate deliverydate id datepaid_1 gldate_1 acc_trans_id_1 source_1 memo_1 paid_1 exchangerate_1 AP_paid_1 storno);
797   $form->{paidaccounts} = 1;
798   $form->{rowcount}--;
799   $form->{invdate} = $form->current_date(\%myconfig);
800   &update;
801
802   $main::lxdebug->leave_sub();
803 }
804
805 sub delete {
806   $main::lxdebug->enter_sub();
807
808   $main::auth->assert('general_ledger');
809
810   my $form     = $main::form;
811   my $locale   = $main::locale;
812
813   $form->{title} = $locale->text('Confirm!');
814
815   $form->header;
816
817   delete $form->{header};
818
819   print qq|
820 <form method=post action=$form->{script}>
821 |;
822
823   foreach my $key (keys %$form) {
824     next if (($key eq 'login') || ($key eq 'password') || ('' ne ref $form->{$key}));
825     $form->{$key} =~ s/\"/&quot;/g;
826     print qq|<input type=hidden name=$key value="$form->{$key}">\n|;
827   }
828
829   print qq|
830 <h2 class=confirm>$form->{title}</h2>
831
832 <h4>|
833     . $locale->text('Are you sure you want to delete Transaction')
834     . qq| $form->{invnumber}</h4>
835
836 <input name=action class=submit type=submit value="|
837     . $locale->text('Yes') . qq|">
838 </form>
839 |;
840
841   $main::lxdebug->leave_sub();
842 }
843
844 sub yes {
845   $main::lxdebug->enter_sub();
846
847   $main::auth->assert('general_ledger');
848
849   my $form     = $main::form;
850   my %myconfig = %main::myconfig;
851   my $locale   = $main::locale;
852
853   if (AR->delete_transaction(\%myconfig, \%$form)) {
854     # saving the history
855     if(!exists $form->{addition}) {
856       $form->{snumbers}  = qq|invnumber_| . $form->{invnumber};
857       $form->{what_done} = "invoice";
858       $form->{addition}  = "DELETED";
859       $form->save_history;
860     }
861     # /saving the history
862     $form->redirect($locale->text('Transaction deleted!'));
863   }
864   $form->error($locale->text('Cannot delete transaction!'));
865
866   $main::lxdebug->leave_sub();
867 }
868
869 sub search {
870   $main::lxdebug->enter_sub();
871
872   $main::auth->assert('invoice_edit');
873
874   my $form     = $main::form;
875   my %myconfig = %main::myconfig;
876   my $locale   = $main::locale;
877   my $cgi      = $::request->{cgi};
878
879   # setup customer selection
880   $form->all_vc(\%myconfig, "customer", "AR");
881
882   $form->{title}    = $locale->text('AR Transactions');
883
884   # Auch in Rechnungsübersicht nach Kundentyp filtern - jan
885   $form->get_lists("projects"       => { "key" => "ALL_PROJECTS", "all" => 1 },
886                    "departments"    => "ALL_DEPARTMENTS",
887                    "customers"      => "ALL_VC",
888                    "business_types" => "ALL_BUSINESS_TYPES");
889   $form->{ALL_EMPLOYEES} = SL::DB::Manager::Employee->get_all_sorted(query => [ deleted => 0 ]);
890   $form->{SHOW_BUSINESS_TYPES} = scalar @{ $form->{ALL_BUSINESS_TYPES} } > 0;
891
892   $form->{CT_CUSTOM_VARIABLES}                  = CVar->get_configs('module' => 'CT');
893   ($form->{CT_CUSTOM_VARIABLES_FILTER_CODE},
894    $form->{CT_CUSTOM_VARIABLES_INCLUSION_CODE}) = CVar->render_search_options('variables'      => $form->{CT_CUSTOM_VARIABLES},
895                                                                               'include_prefix' => 'l_',
896                                                                               'include_value'  => 'Y');
897
898   # constants and subs for template
899   $form->{vc_keys}   = sub { "$_[0]->{name}--$_[0]->{id}" };
900
901   $form->header;
902   print $form->parse_html_template('ar/search', { %myconfig });
903
904   $main::lxdebug->leave_sub();
905 }
906
907 sub create_subtotal_row {
908   $main::lxdebug->enter_sub();
909
910   my ($totals, $columns, $column_alignment, $subtotal_columns, $class) = @_;
911
912   my $form     = $main::form;
913   my %myconfig = %main::myconfig;
914
915   my $row = { map { $_ => { 'data' => '', 'class' => $class, 'align' => $column_alignment->{$_}, } } @{ $columns } };
916
917   map { $row->{$_}->{data} = $form->format_amount(\%myconfig, $totals->{$_}, 2) } @{ $subtotal_columns };
918
919   $row->{tax}->{data} = $form->format_amount(\%myconfig, $totals->{amount} - $totals->{netamount}, 2);
920
921   map { $totals->{$_} = 0 } @{ $subtotal_columns };
922
923   $main::lxdebug->leave_sub();
924
925   return $row;
926 }
927
928 sub ar_transactions {
929   $main::lxdebug->enter_sub();
930
931   $main::auth->assert('invoice_edit');
932
933   my $form     = $main::form;
934   my %myconfig = %main::myconfig;
935   my $locale   = $main::locale;
936
937   my ($callback, $href, @columns);
938
939   ($form->{customer}, $form->{customer_id}) = split(/--/, $form->{customer});
940
941   report_generator_set_default_sort('transdate', 1);
942
943   AR->ar_transactions(\%myconfig, \%$form);
944
945   $form->{title} = $locale->text('AR Transactions');
946
947   my $report = SL::ReportGenerator->new(\%myconfig, $form);
948
949   @columns =
950     qw(ids transdate id type invnumber ordnumber cusordnumber name netamount tax amount paid
951        datepaid due duedate transaction_description notes salesman employee shippingpoint shipvia
952        marge_total marge_percent globalprojectnumber customernumber country ustid taxzone payment_terms charts customertype direct_debit dunning_description);
953
954   my $ct_cvar_configs                 = CVar->get_configs('module' => 'CT');
955   my @ct_includeable_custom_variables = grep { $_->{includeable} } @{ $ct_cvar_configs };
956   my @ct_searchable_custom_variables  = grep { $_->{searchable} }  @{ $ct_cvar_configs };
957
958   my %column_defs_cvars = map { +"cvar_$_->{name}" => { 'text' => $_->{description} } } @ct_includeable_custom_variables;
959   push @columns, map { "cvar_$_->{name}" } @ct_includeable_custom_variables;
960
961   my @hidden_variables = map { "l_${_}" } @columns;
962   push @hidden_variables, "l_subtotal", qw(open closed customer invnumber ordnumber cusordnumber transaction_description notes project_id transdatefrom transdateto duedatefrom duedateto
963                                            employee_id salesman_id business_id parts_partnumber parts_description);
964   push @hidden_variables, map { "cvar_$_->{name}" } @ct_searchable_custom_variables;
965
966   $href = build_std_url('action=ar_transactions', grep { $form->{$_} } @hidden_variables);
967
968   my %column_defs = (
969     'ids'                     => { raw_header_data => $::request->presenter->checkbox_tag("", id => "check_all", checkall => "[data-checkall=1]"), align => 'center' },
970     'transdate'               => { 'text' => $locale->text('Date'), },
971     'id'                      => { 'text' => $locale->text('ID'), },
972     'type'                    => { 'text' => $locale->text('Type'), },
973     'invnumber'               => { 'text' => $locale->text('Invoice'), },
974     'ordnumber'               => { 'text' => $locale->text('Order'), },
975     'cusordnumber'            => { 'text' => $locale->text('Customer Order Number'), },
976     'name'                    => { 'text' => $locale->text('Customer'), },
977     'netamount'               => { 'text' => $locale->text('Amount'), },
978     'tax'                     => { 'text' => $locale->text('Tax'), },
979     'amount'                  => { 'text' => $locale->text('Total'), },
980     'paid'                    => { 'text' => $locale->text('Paid'), },
981     'datepaid'                => { 'text' => $locale->text('Date Paid'), },
982     'due'                     => { 'text' => $locale->text('Amount Due'), },
983     'duedate'                 => { 'text' => $locale->text('Due Date'), },
984     'transaction_description' => { 'text' => $locale->text('Transaction description'), },
985     'notes'                   => { 'text' => $locale->text('Notes'), },
986     'salesman'                => { 'text' => $locale->text('Salesperson'), },
987     'employee'                => { 'text' => $locale->text('Employee'), },
988     'shippingpoint'           => { 'text' => $locale->text('Shipping Point'), },
989     'shipvia'                 => { 'text' => $locale->text('Ship via'), },
990     'globalprojectnumber'     => { 'text' => $locale->text('Document Project Number'), },
991     'marge_total'             => { 'text' => $locale->text('Ertrag'), },
992     'marge_percent'           => { 'text' => $locale->text('Ertrag prozentual'), },
993     'customernumber'          => { 'text' => $locale->text('Customer Number'), },
994     'country'                 => { 'text' => $locale->text('Country'), },
995     'ustid'                   => { 'text' => $locale->text('USt-IdNr.'), },
996     'taxzone'                 => { 'text' => $locale->text('Steuersatz'), },
997     'payment_terms'           => { 'text' => $locale->text('Payment Terms'), },
998     'charts'                  => { 'text' => $locale->text('Buchungskonto'), },
999     'customertype'            => { 'text' => $locale->text('Customer type'), },
1000     'direct_debit'            => { 'text' => $locale->text('direct debit'), },
1001     dunning_description       => { 'text' => $locale->text('Dunning level'), },
1002     %column_defs_cvars,
1003   );
1004
1005   foreach my $name (qw(id transdate duedate invnumber ordnumber cusordnumber name datepaid employee shippingpoint shipvia transaction_description direct_debit)) {
1006     my $sortdir                 = $form->{sort} eq $name ? 1 - $form->{sortdir} : $form->{sortdir};
1007     $column_defs{$name}->{link} = $href . "&sort=$name&sortdir=$sortdir";
1008   }
1009
1010   my %column_alignment = map { $_ => 'right' } qw(netamount tax amount paid due);
1011
1012   $form->{"l_type"} = "Y";
1013   map { $column_defs{$_}->{visible} = $form->{"l_${_}"} ? 1 : 0 } @columns;
1014
1015   $column_defs{ids}->{visible} = 'HTML';
1016
1017   $report->set_columns(%column_defs);
1018   $report->set_column_order(@columns);
1019
1020   $report->set_export_options('ar_transactions', @hidden_variables, qw(sort sortdir));
1021
1022   $report->set_sort_indicator($form->{sort}, $form->{sortdir});
1023
1024   CVar->add_custom_variables_to_report('module'         => 'CT',
1025                                        'trans_id_field' => 'customer_id',
1026                                        'configs'        => $ct_cvar_configs,
1027                                        'column_defs'    => \%column_defs,
1028                                        'data'           => $form->{AR});
1029
1030   my @options;
1031   if ($form->{customer}) {
1032     push @options, $locale->text('Customer') . " : $form->{customer}";
1033   }
1034   if ($form->{cp_name}) {
1035     push @options, $locale->text('Contact Person') . " : $form->{cp_name}";
1036   }
1037   if ($form->{department}) {
1038     my ($department) = split /--/, $form->{department};
1039     push @options, $locale->text('Department') . " : $department";
1040   }
1041   if ($form->{department_id}) {
1042     push @options, $locale->text('Department Id') . " : $form->{department_id}";
1043   }
1044   if ($form->{invnumber}) {
1045     push @options, $locale->text('Invoice Number') . " : $form->{invnumber}";
1046   }
1047   if ($form->{ordnumber}) {
1048     push @options, $locale->text('Order Number') . " : $form->{ordnumber}";
1049   }
1050   if ($form->{cusordnumber}) {
1051     push @options, $locale->text('Customer Order Number') . " : $form->{cusordnumber}";
1052   }
1053   if ($form->{notes}) {
1054     push @options, $locale->text('Notes') . " : $form->{notes}";
1055   }
1056   if ($form->{transaction_description}) {
1057     push @options, $locale->text('Transaction description') . " : $form->{transaction_description}";
1058   }
1059   if ($form->{parts_partnumber}) {
1060     push @options, $locale->text('Part Number') . " : $form->{parts_partnumber}";
1061   }
1062   if ($form->{parts_description}) {
1063     push @options, $locale->text('Part Description') . " : $form->{parts_description}";
1064   }
1065   if ($form->{transdatefrom}) {
1066     push @options, $locale->text('From') . " " . $locale->date(\%myconfig, $form->{transdatefrom}, 1);
1067   }
1068   if ($form->{transdateto}) {
1069     push @options, $locale->text('Bis') . " " . $locale->date(\%myconfig, $form->{transdateto}, 1);
1070   }
1071   if ($form->{open}) {
1072     push @options, $locale->text('Open');
1073   }
1074   if ($form->{employee_id}) {
1075     my $employee = SL::DB::Employee->new(id => $form->{employee_id})->load;
1076     push @options, $locale->text('Employee') . ' : ' . $employee->name;
1077   }
1078   if ($form->{salesman_id}) {
1079     my $salesman = SL::DB::Employee->new(id => $form->{salesman_id})->load;
1080     push @options, $locale->text('Salesman') . ' : ' . $salesman->name;
1081   }
1082   if ($form->{closed}) {
1083     push @options, $locale->text('Closed');
1084   }
1085
1086   $form->{ALL_PRINTERS} = SL::DB::Manager::Printer->get_all_sorted;
1087
1088   $report->set_options('top_info_text'        => join("\n", @options),
1089                        'raw_top_info_text'    => $form->parse_html_template('ar/ar_transactions_header'),
1090                        'raw_bottom_info_text' => $form->parse_html_template('ar/ar_transactions_bottom'),
1091                        'output_format'        => 'HTML',
1092                        'title'                => $form->{title},
1093                        'attachment_basename'  => $locale->text('invoice_list') . strftime('_%Y%m%d', localtime time),
1094     );
1095   $report->set_options_from_form();
1096   $locale->set_numberformat_wo_thousands_separator(\%myconfig) if lc($report->{options}->{output_format}) eq 'csv';
1097
1098   # add sort and escape callback, this one we use for the add sub
1099   $form->{callback} = $href .= "&sort=$form->{sort}";
1100
1101   # escape callback for href
1102   $callback = $form->escape($href);
1103
1104   my @subtotal_columns = qw(netamount amount paid due marge_total marge_percent);
1105
1106   my %totals    = map { $_ => 0 } @subtotal_columns;
1107   my %subtotals = map { $_ => 0 } @subtotal_columns;
1108
1109   my $idx = 0;
1110
1111   foreach my $ar (@{ $form->{AR} }) {
1112     $ar->{tax} = $ar->{amount} - $ar->{netamount};
1113     $ar->{due} = $ar->{amount} - $ar->{paid};
1114
1115     map { $subtotals{$_} += $ar->{$_};
1116           $totals{$_}    += $ar->{$_} } @subtotal_columns;
1117
1118     $subtotals{marge_percent} = $subtotals{netamount} ? ($subtotals{marge_total} * 100 / $subtotals{netamount}) : 0;
1119     $totals{marge_percent}    = $totals{netamount}    ? ($totals{marge_total}    * 100 / $totals{netamount}   ) : 0;
1120
1121     map { $ar->{$_} = $form->format_amount(\%myconfig, $ar->{$_}, 2) } qw(netamount tax amount paid due marge_total marge_percent);
1122
1123     my $is_storno  = $ar->{storno} &&  $ar->{storno_id};
1124     my $has_storno = $ar->{storno} && !$ar->{storno_id};
1125
1126     $ar->{type} =
1127       $has_storno       ? $locale->text("Invoice with Storno (abbreviation)") :
1128       $is_storno        ? $locale->text("Storno (one letter abbreviation)") :
1129       $ar->{amount} < 0 ? $locale->text("Credit note (one letter abbreviation)") :
1130       $ar->{invoice}    ? $locale->text("Invoice (one letter abbreviation)") :
1131                           $locale->text("AR Transaction (abbreviation)");
1132
1133     $ar->{direct_debit} = $ar->{direct_debit} ? $::locale->text('yes') : $::locale->text('no');
1134
1135     my $row = { };
1136
1137     foreach my $column (@columns) {
1138       $row->{$column} = {
1139         'data'  => $ar->{$column},
1140         'align' => $column_alignment{$column},
1141       };
1142     }
1143
1144     $row->{invnumber}->{link} = build_std_url("script=" . ($ar->{invoice} ? 'is.pl' : 'ar.pl'), 'action=edit')
1145       . "&id=" . E($ar->{id}) . "&callback=${callback}";
1146
1147     $row->{ids} = {
1148       raw_data =>  $::request->presenter->checkbox_tag("id[]", value => $ar->{id}, "data-checkall" => 1),
1149       valign   => 'center',
1150       align    => 'center',
1151     };
1152
1153     my $row_set = [ $row ];
1154
1155     if (($form->{l_subtotal} eq 'Y')
1156         && (($idx == (scalar @{ $form->{AR} } - 1))
1157             || ($ar->{ $form->{sort} } ne $form->{AR}->[$idx + 1]->{ $form->{sort} }))) {
1158       push @{ $row_set }, create_subtotal_row(\%subtotals, \@columns, \%column_alignment, \@subtotal_columns, 'listsubtotal');
1159     }
1160
1161     $report->add_data($row_set);
1162
1163     $idx++;
1164   }
1165
1166   $report->add_separator();
1167   $report->add_data(create_subtotal_row(\%totals, \@columns, \%column_alignment, \@subtotal_columns, 'listtotal'));
1168
1169   $report->generate_with_headers();
1170
1171   $main::lxdebug->leave_sub();
1172 }
1173
1174 sub storno {
1175   $main::lxdebug->enter_sub();
1176
1177   $main::auth->assert('general_ledger');
1178
1179   my $form     = $main::form;
1180   my %myconfig = %main::myconfig;
1181   my $locale   = $main::locale;
1182
1183   # don't cancel cancelled transactions
1184   if (IS->has_storno(\%myconfig, $form, 'ar')) {
1185     $form->{title} = $locale->text("Cancel Accounts Receivables Transaction");
1186     $form->error($locale->text("Transaction has already been cancelled!"));
1187   }
1188
1189   AR->storno($form, \%myconfig, $form->{id});
1190
1191   # saving the history
1192   if(!exists $form->{addition} && $form->{id} ne "") {
1193     $form->{snumbers}  = qq|invnumber_| . $form->{invnumber};
1194     $form->{addition}  = "STORNO";
1195     $form->{what_done} = "invoice";
1196     $form->save_history;
1197   }
1198   # /saving the history
1199
1200   $form->redirect(sprintf $locale->text("Transaction %d cancelled."), $form->{storno_id});
1201
1202   $main::lxdebug->leave_sub();
1203 }
1204
1205 1;