1 package SL::Controller::Order;
4 use parent qw(SL::Controller::Base);
6 use SL::Helper::Flash qw(flash_later);
7 use SL::Presenter::Tag qw(select_tag hidden_tag);
8 use SL::Locale::String qw(t8);
9 use SL::SessionFile::Random;
13 use SL::Util qw(trim);
20 use SL::DB::RecordLink;
22 use SL::Helper::CreatePDF qw(:all);
23 use SL::Helper::PrintOptions;
25 use SL::Controller::Helper::GetModels;
27 use List::Util qw(first);
28 use List::UtilsBy qw(sort_by uniq_by);
29 use List::MoreUtils qw(any none pairwise first_index);
30 use English qw(-no_match_vars);
34 use Rose::Object::MakeMethods::Generic
36 scalar => [ qw(item_ids_to_delete) ],
37 'scalar --get_set_init' => [ qw(order valid_types type cv p multi_items_models all_price_factors) ],
42 __PACKAGE__->run_before('_check_auth');
44 __PACKAGE__->run_before('_recalc',
45 only => [ qw(save save_as_new save_and_delivery_order save_and_invoice print create_pdf send_email) ]);
47 __PACKAGE__->run_before('_get_unalterable_data',
48 only => [ qw(save save_as_new save_and_delivery_order save_and_invoice print create_pdf send_email) ]);
58 $self->order->transdate(DateTime->now_local());
59 my $extra_days = $self->type eq _sales_quotation_type() ? $::instance_conf->get_reqdate_interval : 1;
60 $self->order->reqdate(DateTime->today_local->next_workday(extra_days => $extra_days)) if !$self->order->reqdate;
65 title => $self->_get_title_for('add'),
66 %{$self->{template_args}}
70 # edit an existing order
79 title => $self->_get_title_for('edit'),
80 %{$self->{template_args}}
88 my $errors = $self->_delete();
90 if (scalar @{ $errors }) {
91 $self->js->flash('error', $_) foreach @{ $errors };
92 return $self->js->render();
95 my $text = $self->type eq _sales_order_type() ? $::locale->text('The order has been deleted')
96 : $self->type eq _purchase_order_type() ? $::locale->text('The order has been deleted')
97 : $self->type eq _sales_quotation_type() ? $::locale->text('The quotation has been deleted')
98 : $self->type eq _request_quotation_type() ? $::locale->text('The rfq has been deleted')
100 flash_later('info', $text);
102 my @redirect_params = (
107 $self->redirect_to(@redirect_params);
114 my $errors = $self->_save();
116 if (scalar @{ $errors }) {
117 $self->js->flash('error', $_) foreach @{ $errors };
118 return $self->js->render();
121 my $text = $self->type eq _sales_order_type() ? $::locale->text('The order has been saved')
122 : $self->type eq _purchase_order_type() ? $::locale->text('The order has been saved')
123 : $self->type eq _sales_quotation_type() ? $::locale->text('The quotation has been saved')
124 : $self->type eq _request_quotation_type() ? $::locale->text('The rfq has been saved')
126 flash_later('info', $text);
128 my @redirect_params = (
131 id => $self->order->id,
134 $self->redirect_to(@redirect_params);
137 # save the order as new document an open it for edit
138 sub action_save_as_new {
141 my $order = $self->order;
144 $self->js->flash('error', t8('This object has not been saved yet.'));
145 return $self->js->render();
148 # load order from db to check if values changed
149 my $saved_order = SL::DB::Order->new(id => $order->id)->load;
152 # Lets assign a new number if the user hasn't changed the previous one.
153 # If it has been changed manually then use it as-is.
154 $new_attrs{number} = (trim($order->number) eq $saved_order->number)
156 : trim($order->number);
158 # Clear transdate unless changed
159 $new_attrs{transdate} = ($order->transdate == $saved_order->transdate)
160 ? DateTime->today_local
163 # Set new reqdate unless changed
164 if ($order->reqdate == $saved_order->reqdate) {
165 my $extra_days = $self->type eq _sales_quotation_type() ? $::instance_conf->get_reqdate_interval : 1;
166 $new_attrs{reqdate} = DateTime->today_local->next_workday(extra_days => $extra_days);
168 $new_attrs{reqdate} = $order->reqdate;
172 $new_attrs{employee} = SL::DB::Manager::Employee->current;
174 # Create new record from current one
175 $self->order(SL::DB::Order->new_from($order, destination_type => $order->type, attributes => \%new_attrs));
177 # no linked records on save as new
178 delete $::form->{$_} for qw(converted_from_oe_id converted_from_orderitems_ids);
181 $self->action_save();
186 # This is called if "print" is pressed in the print dialog.
187 # If PDF creation was requested and succeeded, the pdf is stored in a session
188 # file and the filename is stored as session value with an unique key. A
189 # javascript function with this key is then called. This function calls the
190 # download action below (action_download_pdf), which offers the file for
195 my $format = $::form->{print_options}->{format};
196 my $media = $::form->{print_options}->{media};
197 my $formname = $::form->{print_options}->{formname};
198 my $copies = $::form->{print_options}->{copies};
199 my $groupitems = $::form->{print_options}->{groupitems};
202 if (none { $format eq $_ } qw(pdf)) {
203 return $self->js->flash('error', t8('Format \'#1\' is not supported yet/anymore.', $format))->render;
206 # only screen or printer by now
207 if (none { $media eq $_ } qw(screen printer)) {
208 return $self->js->flash('error', t8('Media \'#1\' is not supported yet/anymore.', $media))->render;
212 $language = SL::DB::Language->new(id => $::form->{print_options}->{language_id})->load if $::form->{print_options}->{language_id};
214 # create a form for generate_attachment_filename
215 my $form = Form->new;
216 $form->{ordnumber} = $self->order->ordnumber;
217 $form->{type} = $self->type;
218 $form->{format} = $format;
219 $form->{formname} = $formname;
220 $form->{language} = '_' . $language->template_code if $language;
221 my $pdf_filename = $form->generate_attachment_filename();
224 my @errors = _create_pdf($self->order, \$pdf, { format => $format,
225 formname => $formname,
226 language => $language,
227 groupitems => $groupitems });
228 if (scalar @errors) {
229 return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render;
232 if ($media eq 'screen') {
234 my $sfile = SL::SessionFile::Random->new(mode => "w");
235 $sfile->fh->print($pdf);
238 my $key = join('_', Time::HiRes::gettimeofday(), int rand 1000000000000);
239 $::auth->set_session_value("Order::create_pdf-${key}" => $sfile->file_name);
242 ->run('kivi.Order.download_pdf', $pdf_filename, $key)
243 ->flash('info', t8('The PDF has been created'));
245 } elsif ($media eq 'printer') {
247 my $printer_id = $::form->{print_options}->{printer_id};
248 SL::DB::Printer->new(id => $printer_id)->load->print_document(
253 $self->js->flash('info', t8('The PDF has been printed'));
256 # copy file to webdav folder
257 if ($self->order->ordnumber && $::instance_conf->get_webdav_documents) {
258 my $webdav = SL::Webdav->new(
260 number => $self->order->ordnumber,
262 my $webdav_file = SL::Webdav::File->new(
264 filename => $pdf_filename,
267 $webdav_file->store(data => \$pdf);
270 $self->js->flash('error', t8('Storing PDF to webdav folder failed: #1', $@));
273 if ($self->order->ordnumber && $::instance_conf->get_doc_storage) {
275 SL::File->save(object_id => $self->order->id,
276 object_type => $self->type,
277 mime_type => 'application/pdf',
279 file_type => 'document',
280 file_name => $pdf_filename,
281 file_contents => $pdf);
284 $self->js->flash('error', t8('Storing PDF in storage backend failed: #1', $@));
290 # offer pdf for download
292 # It needs to get the key for the session value to get the pdf file.
293 sub action_download_pdf {
296 my $key = $::form->{key};
297 my $tmp_filename = $::auth->get_session_value("Order::create_pdf-${key}");
298 return $self->send_file(
300 type => 'application/pdf',
301 name => $::form->{pdf_filename},
305 # open the email dialog
306 sub action_show_email_dialog {
309 my $cv_method = $self->cv;
311 if (!$self->order->$cv_method) {
312 return $self->js->flash('error', $self->cv eq 'customer' ? t8('Cannot send E-mail without customer given') : t8('Cannot send E-mail without vendor given'))
317 $email_form->{to} = $self->order->contact->cp_email if $self->order->contact;
318 $email_form->{to} ||= $self->order->$cv_method->email;
319 $email_form->{cc} = $self->order->$cv_method->cc;
320 $email_form->{bcc} = join ', ', grep $_, $self->order->$cv_method->bcc, SL::DB::Default->get->global_bcc;
321 # Todo: get addresses from shipto, if any
323 my $form = Form->new;
324 $form->{ordnumber} = $self->order->ordnumber;
325 $form->{formname} = $self->type;
326 $form->{type} = $self->type;
327 $form->{language} = 'de';
328 $form->{format} = 'pdf';
330 $email_form->{subject} = $form->generate_email_subject();
331 $email_form->{attachment_filename} = $form->generate_attachment_filename();
332 $email_form->{message} = $form->generate_email_body();
333 $email_form->{js_send_function} = 'kivi.Order.send_email()';
335 my %files = $self->_get_files_for_email_dialog();
336 my $dialog_html = $self->render('common/_send_email_dialog', { output => 0 },
337 email_form => $email_form,
338 show_bcc => $::auth->assert('email_bcc', 'may fail'),
340 is_customer => $self->cv eq 'customer',
344 ->run('kivi.Order.show_email_dialog', $dialog_html)
351 # Todo: handling error messages: flash is not displayed in dialog, but in the main form
352 sub action_send_email {
355 my $email_form = delete $::form->{email_form};
356 my %field_names = (to => 'email');
358 $::form->{ $field_names{$_} // $_ } = $email_form->{$_} for keys %{ $email_form };
360 # for Form::cleanup which may be called in Form::send_email
361 $::form->{cwd} = getcwd();
362 $::form->{tmpdir} = $::lx_office_conf{paths}->{userspath};
364 $::form->{media} = 'email';
366 if (($::form->{attachment_policy} // '') eq 'normal') {
368 $language = SL::DB::Language->new(id => $::form->{print_options}->{language_id})->load if $::form->{print_options}->{language_id};
371 my @errors = _create_pdf($self->order, \$pdf, {media => $::form->{media},
372 format => $::form->{print_options}->{format},
373 formname => $::form->{print_options}->{formname},
374 language => $language,
375 groupitems => $::form->{print_options}->{groupitems}});
376 if (scalar @errors) {
377 return $self->js->flash('error', t8('Conversion to PDF failed: #1', $errors[0]))->render($self);
380 my $sfile = SL::SessionFile::Random->new(mode => "w");
381 $sfile->fh->print($pdf);
384 $::form->{tmpfile} = $sfile->file_name;
385 $::form->{tmpdir} = $sfile->get_path; # for Form::cleanup which may be called in Form::send_email
388 $::form->send_email(\%::myconfig, 'pdf');
391 my $intnotes = $self->order->intnotes;
392 $intnotes .= "\n\n" if $self->order->intnotes;
393 $intnotes .= t8('[email]') . "\n";
394 $intnotes .= t8('Date') . ": " . $::locale->format_date_object(DateTime->now_local, precision => 'seconds') . "\n";
395 $intnotes .= t8('To (email)') . ": " . $::form->{email} . "\n";
396 $intnotes .= t8('Cc') . ": " . $::form->{cc} . "\n" if $::form->{cc};
397 $intnotes .= t8('Bcc') . ": " . $::form->{bcc} . "\n" if $::form->{bcc};
398 $intnotes .= t8('Subject') . ": " . $::form->{subject} . "\n\n";
399 $intnotes .= t8('Message') . ": " . $::form->{message};
402 ->val('#order_intnotes', $intnotes)
403 ->run('kivi.Order.close_email_dialog')
404 ->flash('info', t8('The email has been sent.'))
408 # open the periodic invoices config dialog
410 # If there are values in the form (i.e. dialog was opened before),
411 # then use this values. Create new ones, else.
412 sub action_show_periodic_invoices_config_dialog {
415 my $config = _make_periodic_invoices_config_from_yaml(delete $::form->{config});
416 $config ||= SL::DB::Manager::PeriodicInvoicesConfig->find_by(oe_id => $::form->{id}) if $::form->{id};
417 $config ||= SL::DB::PeriodicInvoicesConfig->new(periodicity => 'm',
418 order_value_periodicity => 'p', # = same as periodicity
419 start_date_as_date => $::form->{transdate} || $::form->current_date,
420 extend_automatically_by => 12,
422 email_subject => GenericTranslations->get(
423 language_id => $::form->{language_id},
424 translation_type =>"preset_text_periodic_invoices_email_subject"),
425 email_body => GenericTranslations->get(
426 language_id => $::form->{language_id},
427 translation_type =>"preset_text_periodic_invoices_email_body"),
429 $config->periodicity('m') if none { $_ eq $config->periodicity } @SL::DB::PeriodicInvoicesConfig::PERIODICITIES;
430 $config->order_value_periodicity('p') if none { $_ eq $config->order_value_periodicity } ('p', @SL::DB::PeriodicInvoicesConfig::ORDER_VALUE_PERIODICITIES);
432 $::form->get_lists(printers => "ALL_PRINTERS",
433 charts => { key => 'ALL_CHARTS',
434 transdate => 'current_date' });
436 $::form->{AR} = [ grep { $_->{link} =~ m/(?:^|:)AR(?::|$)/ } @{ $::form->{ALL_CHARTS} } ];
438 if ($::form->{customer_id}) {
439 $::form->{ALL_CONTACTS} = SL::DB::Manager::Contact->get_all_sorted(where => [ cp_cv_id => $::form->{customer_id} ]);
442 $self->render('oe/edit_periodic_invoices_config', { layout => 0 },
444 popup_js_close_function => 'kivi.Order.close_periodic_invoices_config_dialog()',
445 popup_js_assign_function => 'kivi.Order.assign_periodic_invoices_config()',
450 # assign the values of the periodic invoices config dialog
451 # as yaml in the hidden tag and set the status.
452 sub action_assign_periodic_invoices_config {
455 $::form->isblank('start_date_as_date', $::locale->text('The start date is missing.'));
457 my $config = { active => $::form->{active} ? 1 : 0,
458 terminated => $::form->{terminated} ? 1 : 0,
459 direct_debit => $::form->{direct_debit} ? 1 : 0,
460 periodicity => (any { $_ eq $::form->{periodicity} } @SL::DB::PeriodicInvoicesConfig::PERIODICITIES) ? $::form->{periodicity} : 'm',
461 order_value_periodicity => (any { $_ eq $::form->{order_value_periodicity} } ('p', @SL::DB::PeriodicInvoicesConfig::ORDER_VALUE_PERIODICITIES)) ? $::form->{order_value_periodicity} : 'p',
462 start_date_as_date => $::form->{start_date_as_date},
463 end_date_as_date => $::form->{end_date_as_date},
464 first_billing_date_as_date => $::form->{first_billing_date_as_date},
465 print => $::form->{print} ? 1 : 0,
466 printer_id => $::form->{print} ? $::form->{printer_id} * 1 : undef,
467 copies => $::form->{copies} * 1 ? $::form->{copies} : 1,
468 extend_automatically_by => $::form->{extend_automatically_by} * 1 || undef,
469 ar_chart_id => $::form->{ar_chart_id} * 1,
470 send_email => $::form->{send_email} ? 1 : 0,
471 email_recipient_contact_id => $::form->{email_recipient_contact_id} * 1 || undef,
472 email_recipient_address => $::form->{email_recipient_address},
473 email_sender => $::form->{email_sender},
474 email_subject => $::form->{email_subject},
475 email_body => $::form->{email_body},
478 my $periodic_invoices_config = YAML::Dump($config);
480 my $status = $self->_get_periodic_invoices_status($config);
483 ->remove('#order_periodic_invoices_config')
484 ->insertAfter(hidden_tag('order.periodic_invoices_config', $periodic_invoices_config), '#periodic_invoices_status')
485 ->run('kivi.Order.close_periodic_invoices_config_dialog')
486 ->html('#periodic_invoices_status', $status)
487 ->flash('info', t8('The periodic invoices config has been assigned.'))
491 sub action_get_has_active_periodic_invoices {
494 my $config = _make_periodic_invoices_config_from_yaml(delete $::form->{config});
495 $config ||= SL::DB::Manager::PeriodicInvoicesConfig->find_by(oe_id => $::form->{id}) if $::form->{id};
497 my $has_active_periodic_invoices =
498 $self->type eq _sales_order_type()
501 && (!$config->end_date || ($config->end_date > DateTime->today_local))
502 && $config->get_previous_billed_period_start_date;
504 $_[0]->render(\ !!$has_active_periodic_invoices, { type => 'text' });
507 # save the order and redirect to the frontend subroutine for a new
509 sub action_save_and_delivery_order {
512 my $errors = $self->_save();
514 if (scalar @{ $errors }) {
515 $self->js->flash('error', $_) foreach @{ $errors };
516 return $self->js->render();
519 my $text = $self->type eq _sales_order_type() ? $::locale->text('The order has been saved')
520 : $self->type eq _purchase_order_type() ? $::locale->text('The order has been saved')
521 : $self->type eq _sales_quotation_type() ? $::locale->text('The quotation has been saved')
522 : $self->type eq _request_quotation_type() ? $::locale->text('The rfq has been saved')
524 flash_later('info', $text);
526 my @redirect_params = (
527 controller => 'oe.pl',
528 action => 'oe_delivery_order_from_order',
529 id => $self->order->id,
532 $self->redirect_to(@redirect_params);
535 # save the order and redirect to the frontend subroutine for a new
537 sub action_save_and_invoice {
540 my $errors = $self->_save();
542 if (scalar @{ $errors }) {
543 $self->js->flash('error', $_) foreach @{ $errors };
544 return $self->js->render();
547 my $text = $self->type eq _sales_order_type() ? $::locale->text('The order has been saved')
548 : $self->type eq _purchase_order_type() ? $::locale->text('The order has been saved')
549 : $self->type eq _sales_quotation_type() ? $::locale->text('The quotation has been saved')
550 : $self->type eq _request_quotation_type() ? $::locale->text('The rfq has been saved')
552 flash_later('info', $text);
554 my @redirect_params = (
555 controller => 'oe.pl',
556 action => 'oe_invoice_from_order',
557 id => $self->order->id,
560 $self->redirect_to(@redirect_params);
563 # workflow from sales quotation to sales order
564 sub action_sales_order {
565 $_[0]->_workflow_sales_or_purchase_order();
568 # workflow from rfq to purchase order
569 sub action_purchase_order {
570 $_[0]->_workflow_sales_or_purchase_order();
573 # set form elements in respect to a changed customer or vendor
575 # This action is called on an change of the customer/vendor picker.
576 sub action_customer_vendor_changed {
579 _setup_order_from_cv($self->order);
582 my $cv_method = $self->cv;
584 if ($self->order->$cv_method->contacts && scalar @{ $self->order->$cv_method->contacts } > 0) {
585 $self->js->show('#cp_row');
587 $self->js->hide('#cp_row');
590 if ($self->order->$cv_method->shipto && scalar @{ $self->order->$cv_method->shipto } > 0) {
591 $self->js->show('#shipto_row');
593 $self->js->hide('#shipto_row');
596 $self->js->val( '#order_salesman_id', $self->order->salesman_id) if $self->order->is_sales;
599 ->replaceWith('#order_cp_id', $self->build_contact_select)
600 ->replaceWith('#order_shipto_id', $self->build_shipto_select)
601 ->replaceWith('#business_info_row', $self->build_business_info_row)
602 ->val( '#order_taxzone_id', $self->order->taxzone_id)
603 ->val( '#order_taxincluded', $self->order->taxincluded)
604 ->val( '#order_payment_id', $self->order->payment_id)
605 ->val( '#order_delivery_term_id', $self->order->delivery_term_id)
606 ->val( '#order_intnotes', $self->order->intnotes)
607 ->focus( '#order_' . $self->cv . '_id');
609 $self->_js_redisplay_amounts_and_taxes;
613 # open the dialog for customer/vendor details
614 sub action_show_customer_vendor_details_dialog {
617 my $is_customer = 'customer' eq $::form->{vc};
620 $cv = SL::DB::Customer->new(id => $::form->{vc_id})->load;
622 $cv = SL::DB::Vendor->new(id => $::form->{vc_id})->load;
625 my %details = map { $_ => $cv->$_ } @{$cv->meta->columns};
626 $details{discount_as_percent} = $cv->discount_as_percent;
627 $details{creditlimt} = $cv->creditlimit_as_number;
628 $details{business} = $cv->business->description if $cv->business;
629 $details{language} = $cv->language_obj->description if $cv->language_obj;
630 $details{delivery_terms} = $cv->delivery_term->description if $cv->delivery_term;
631 $details{payment_terms} = $cv->payment->description if $cv->payment;
632 $details{pricegroup} = $cv->pricegroup->pricegroup if $is_customer && $cv->pricegroup;
634 foreach my $entry (@{ $cv->shipto }) {
635 push @{ $details{SHIPTO} }, { map { $_ => $entry->$_ } @{$entry->meta->columns} };
637 foreach my $entry (@{ $cv->contacts }) {
638 push @{ $details{CONTACTS} }, { map { $_ => $entry->$_ } @{$entry->meta->columns} };
641 $_[0]->render('common/show_vc_details', { layout => 0 },
642 is_customer => $is_customer,
647 # called if a unit in an existing item row is changed
648 sub action_unit_changed {
651 my $idx = first_index { $_ eq $::form->{item_id} } @{ $::form->{orderitem_ids} };
652 my $item = $self->order->items_sorted->[$idx];
654 my $old_unit_obj = SL::DB::Unit->new(name => $::form->{old_unit})->load;
655 $item->sellprice($item->unit_obj->convert_to($item->sellprice, $old_unit_obj));
660 ->run('kivi.Order.update_sellprice', $::form->{item_id}, $item->sellprice_as_number);
661 $self->_js_redisplay_line_values;
662 $self->_js_redisplay_amounts_and_taxes;
666 # add an item row for a new item entered in the input row
667 sub action_add_item {
670 my $form_attr = $::form->{add_item};
672 return unless $form_attr->{parts_id};
674 my $item = _new_item($self->order, $form_attr);
676 $self->order->add_items($item);
680 my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
681 my $row_as_html = $self->p->render('order/tabs/_row',
685 ALL_PRICE_FACTORS => $self->all_price_factors
689 ->append('#row_table_id', $row_as_html);
691 if ( $item->part->is_assortment ) {
692 $form_attr->{qty_as_number} = 1 unless $form_attr->{qty_as_number};
693 foreach my $assortment_item ( @{$item->part->assortment_items} ) {
694 my $attr = { parts_id => $assortment_item->parts_id,
695 qty => $assortment_item->qty * $::form->parse_amount(\%::myconfig, $form_attr->{qty_as_number}), # TODO $form_attr->{unit}
696 unit => $assortment_item->unit,
697 description => $assortment_item->part->description,
699 my $item = _new_item($self->order, $attr);
701 # set discount to 100% if item isn't supposed to be charged, overwriting any customer discount
702 $item->discount(1) unless $assortment_item->charge;
704 $self->order->add_items( $item );
706 my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
707 my $row_as_html = $self->p->render('order/tabs/_row',
711 ALL_PRICE_FACTORS => $self->all_price_factors
714 ->append('#row_table_id', $row_as_html);
719 ->val('.add_item_input', '')
720 ->run('kivi.Order.init_row_handlers')
721 ->run('kivi.Order.row_table_scroll_down')
722 ->run('kivi.Order.renumber_positions')
723 ->focus('#add_item_parts_id_name');
725 $self->_js_redisplay_amounts_and_taxes;
729 # open the dialog for entering multiple items at once
730 sub action_show_multi_items_dialog {
731 require SL::DB::PartsGroup;
732 $_[0]->render('order/tabs/_multi_items_dialog', { layout => 0 },
733 all_partsgroups => SL::DB::Manager::PartsGroup->get_all);
736 # update the filter results in the multi item dialog
737 sub action_multi_items_update_result {
740 $::form->{multi_items}->{filter}->{obsolete} = 0;
742 my $count = $_[0]->multi_items_models->count;
745 my $text = SL::Presenter::EscapedText->new(text => $::locale->text('No results.'));
746 $_[0]->render($text, { layout => 0 });
747 } elsif ($count > $max_count) {
748 my $text = SL::Presenter::EscapedText->new(text => $::locale->text('Too many results (#1 from #2).', $count, $max_count));
749 $_[0]->render($text, { layout => 0 });
751 my $multi_items = $_[0]->multi_items_models->get;
752 $_[0]->render('order/tabs/_multi_items_result', { layout => 0 },
753 multi_items => $multi_items);
757 # add item rows for multiple items at once
758 sub action_add_multi_items {
761 my @form_attr = grep { $_->{qty_as_number} } @{ $::form->{add_multi_items} };
762 return $self->js->render() unless scalar @form_attr;
765 foreach my $attr (@form_attr) {
766 my $item = _new_item($self->order, $attr);
768 if ( $item->part->is_assortment ) {
769 foreach my $assortment_item ( @{$item->part->assortment_items} ) {
770 my $attr = { parts_id => $assortment_item->parts_id,
771 qty => $assortment_item->qty * $item->qty, # TODO $form_attr->{unit}
772 unit => $assortment_item->unit,
773 description => $assortment_item->part->description,
775 my $item = _new_item($self->order, $attr);
777 # set discount to 100% if item isn't supposed to be charged, overwriting any customer discount
778 $item->discount(1) unless $assortment_item->charge;
783 $self->order->add_items(@items);
787 foreach my $item (@items) {
788 my $item_id = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
789 my $row_as_html = $self->p->render('order/tabs/_row',
793 ALL_PRICE_FACTORS => $self->all_price_factors
796 $self->js->append('#row_table_id', $row_as_html);
800 ->run('kivi.Order.close_multi_items_dialog')
801 ->run('kivi.Order.init_row_handlers')
802 ->run('kivi.Order.row_table_scroll_down')
803 ->run('kivi.Order.renumber_positions')
804 ->focus('#add_item_parts_id_name');
806 $self->_js_redisplay_amounts_and_taxes;
810 # recalculate all linetotals, amounts and taxes and redisplay them
811 sub action_recalc_amounts_and_taxes {
816 $self->_js_redisplay_line_values;
817 $self->_js_redisplay_amounts_and_taxes;
821 # redisplay item rows if they are sorted by an attribute
822 sub action_reorder_items {
826 partnumber => sub { $_[0]->part->partnumber },
827 description => sub { $_[0]->description },
828 qty => sub { $_[0]->qty },
829 sellprice => sub { $_[0]->sellprice },
830 discount => sub { $_[0]->discount },
833 my $method = $sort_keys{$::form->{order_by}};
834 my @to_sort = map { { old_pos => $_->position, order_by => $method->($_) } } @{ $self->order->items_sorted };
835 if ($::form->{sort_dir}) {
836 @to_sort = sort { $a->{order_by} cmp $b->{order_by} } @to_sort;
838 @to_sort = sort { $b->{order_by} cmp $a->{order_by} } @to_sort;
841 ->run('kivi.Order.redisplay_items', \@to_sort)
845 # show the popup to choose a price/discount source
846 sub action_price_popup {
849 my $idx = first_index { $_ eq $::form->{item_id} } @{ $::form->{orderitem_ids} };
850 my $item = $self->order->items_sorted->[$idx];
852 $self->render_price_dialog($item);
855 # get the longdescription for an item if the dialog to enter/change the
856 # longdescription was opened and the longdescription is empty
858 # If this item is new, get the longdescription from Part.
859 # Otherwise get it from OrderItem.
860 sub action_get_item_longdescription {
863 if ($::form->{item_id}) {
864 $longdescription = SL::DB::OrderItem->new(id => $::form->{item_id})->load->longdescription;
865 } elsif ($::form->{parts_id}) {
866 $longdescription = SL::DB::Part->new(id => $::form->{parts_id})->load->notes;
868 $_[0]->render(\ $longdescription, { type => 'text' });
871 # load the second row for one or more items
873 # This action gets the html code for all items second rows by rendering a template for
874 # the second row and sets the html code via client js.
875 sub action_load_second_rows {
878 $self->_recalc() if $self->order->is_sales; # for margin calculation
880 foreach my $item_id (@{ $::form->{item_ids} }) {
881 my $idx = first_index { $_ eq $item_id } @{ $::form->{orderitem_ids} };
882 my $item = $self->order->items_sorted->[$idx];
884 $self->_js_load_second_row($item, $item_id, 0);
887 $self->js->run('kivi.Order.init_row_handlers') if $self->order->is_sales; # for lastcosts change-callback
892 sub _js_load_second_row {
893 my ($self, $item, $item_id, $do_parse) = @_;
896 # Parse values from form (they are formated while rendering (template)).
897 # Workaround to pre-parse number-cvars (parse_custom_variable_values does not parse number values).
898 # This parsing is not necessary at all, if we assure that the second row/cvars are only loaded once.
899 foreach my $var (@{ $item->cvars_by_config }) {
900 $var->unparsed_value($::form->parse_amount(\%::myconfig, $var->{__unparsed_value})) if ($var->config->type eq 'number' && exists($var->{__unparsed_value}));
902 $item->parse_custom_variable_values;
905 my $row_as_html = $self->p->render('order/tabs/_second_row', ITEM => $item, TYPE => $self->type);
908 ->html('.row_entry:has(#item_' . $item_id . ') [name = "second_row"]', $row_as_html)
909 ->data('.row_entry:has(#item_' . $item_id . ') [name = "second_row"]', 'loaded', 1);
912 sub _js_redisplay_line_values {
915 my $is_sales = $self->order->is_sales;
917 # sales orders with margins
922 $::form->format_amount(\%::myconfig, $_->{linetotal}, 2, 0),
923 $::form->format_amount(\%::myconfig, $_->{marge_total}, 2, 0),
924 $::form->format_amount(\%::myconfig, $_->{marge_percent}, 2, 0),
925 ]} @{ $self->order->items_sorted };
929 $::form->format_amount(\%::myconfig, $_->{linetotal}, 2, 0),
930 ]} @{ $self->order->items_sorted };
934 ->run('kivi.Order.redisplay_line_values', $is_sales, \@data);
937 sub _js_redisplay_amounts_and_taxes {
940 if (scalar @{ $self->{taxes} }) {
941 $self->js->show('#taxincluded_row_id');
943 $self->js->hide('#taxincluded_row_id');
946 if ($self->order->taxincluded) {
947 $self->js->hide('#subtotal_row_id');
949 $self->js->show('#subtotal_row_id');
953 ->html('#netamount_id', $::form->format_amount(\%::myconfig, $self->order->netamount, -2))
954 ->html('#amount_id', $::form->format_amount(\%::myconfig, $self->order->amount, -2))
956 ->insertBefore($self->build_tax_rows, '#amount_row_id');
963 sub init_valid_types {
964 [ _sales_order_type(), _purchase_order_type(), _sales_quotation_type(), _request_quotation_type() ];
970 if (none { $::form->{type} eq $_ } @{$self->valid_types}) {
971 die "Not a valid type for order";
974 $self->type($::form->{type});
980 my $cv = (any { $self->type eq $_ } (_sales_order_type(), _sales_quotation_type())) ? 'customer'
981 : (any { $self->type eq $_ } (_purchase_order_type(), _request_quotation_type())) ? 'vendor'
982 : die "Not a valid type for order";
995 # model used to filter/display the parts in the multi-items dialog
996 sub init_multi_items_models {
997 SL::Controller::Helper::GetModels->new(
1000 with_objects => [ qw(unit_obj) ],
1001 disable_plugin => 'paginated',
1002 source => $::form->{multi_items},
1008 partnumber => t8('Partnumber'),
1009 description => t8('Description')}
1013 sub init_all_price_factors {
1014 SL::DB::Manager::PriceFactor->get_all;
1020 my $right_for = { map { $_ => $_.'_edit' } @{$self->valid_types} };
1022 my $right = $right_for->{ $self->type };
1023 $right ||= 'DOES_NOT_EXIST';
1025 $::auth->assert($right);
1028 # build the selection box for contacts
1030 # Needed, if customer/vendor changed.
1031 sub build_contact_select {
1034 select_tag('order.cp_id', [ $self->order->{$self->cv}->contacts ],
1035 value_key => 'cp_id',
1036 title_key => 'full_name_dep',
1037 default => $self->order->cp_id,
1039 style => 'width: 300px',
1043 # build the selection box for shiptos
1045 # Needed, if customer/vendor changed.
1046 sub build_shipto_select {
1049 select_tag('order.shipto_id', [ $self->order->{$self->cv}->shipto ],
1050 value_key => 'shipto_id',
1051 title_key => 'displayable_id',
1052 default => $self->order->shipto_id,
1054 style => 'width: 300px',
1058 # render the info line for business
1060 # Needed, if customer/vendor changed.
1061 sub build_business_info_row
1063 $_[0]->p->render('order/tabs/_business_info_row', SELF => $_[0]);
1066 # build the rows for displaying taxes
1068 # Called if amounts where recalculated and redisplayed.
1069 sub build_tax_rows {
1073 foreach my $tax (sort { $a->{tax}->rate cmp $b->{tax}->rate } @{ $self->{taxes} }) {
1074 $rows_as_html .= $self->p->render('order/tabs/_tax_row', TAX => $tax, TAXINCLUDED => $self->order->taxincluded);
1076 return $rows_as_html;
1080 sub render_price_dialog {
1081 my ($self, $record_item) = @_;
1083 my $price_source = SL::PriceSource->new(record_item => $record_item, record => $self->order);
1087 'kivi.io.price_chooser_dialog',
1088 t8('Available Prices'),
1089 $self->render('order/tabs/_price_sources_dialog', { output => 0 }, price_source => $price_source)
1094 # $self->js->text('#dialog_flash_error_content', join ' ', @errors);
1095 # $self->js->show('#dialog_flash_error');
1104 return if !$::form->{id};
1106 $self->order(SL::DB::Manager::Order->find_by(id => $::form->{id}));
1109 # load or create a new order object
1111 # And assign changes from the form to this object.
1112 # If the order is loaded from db, check if items are deleted in the form,
1113 # remove them form the object and collect them for removing from db on saving.
1114 # Then create/update items from form (via _make_item) and add them.
1118 # add_items adds items to an order with no items for saving, but they cannot
1119 # be retrieved via items until the order is saved. Adding empty items to new
1120 # order here solves this problem.
1122 $order = SL::DB::Manager::Order->find_by(id => $::form->{id}) if $::form->{id};
1123 $order ||= SL::DB::Order->new(orderitems => [],
1124 quotation => (any { $self->type eq $_ } (_sales_quotation_type(), _request_quotation_type())));
1126 my $cv_id_method = $self->cv . '_id';
1127 if (!$::form->{id} && $::form->{$cv_id_method}) {
1128 $order->$cv_id_method($::form->{$cv_id_method});
1129 _setup_order_from_cv($order);
1132 my $form_orderitems = delete $::form->{order}->{orderitems};
1133 my $form_periodic_invoices_config = delete $::form->{order}->{periodic_invoices_config};
1135 $order->assign_attributes(%{$::form->{order}});
1137 my $periodic_invoices_config = _make_periodic_invoices_config_from_yaml($form_periodic_invoices_config);
1138 $order->periodic_invoices_config($periodic_invoices_config) if $periodic_invoices_config;
1140 # remove deleted items
1141 $self->item_ids_to_delete([]);
1142 foreach my $idx (reverse 0..$#{$order->orderitems}) {
1143 my $item = $order->orderitems->[$idx];
1144 if (none { $item->id == $_->{id} } @{$form_orderitems}) {
1145 splice @{$order->orderitems}, $idx, 1;
1146 push @{$self->item_ids_to_delete}, $item->id;
1152 foreach my $form_attr (@{$form_orderitems}) {
1153 my $item = _make_item($order, $form_attr);
1154 $item->position($pos);
1158 $order->add_items(grep {!$_->id} @items);
1163 # create or update items from form
1165 # Make item objects from form values. For items already existing read from db.
1166 # Create a new item else. And assign attributes.
1168 my ($record, $attr) = @_;
1171 $item = first { $_->id == $attr->{id} } @{$record->items} if $attr->{id};
1173 my $is_new = !$item;
1175 # add_custom_variables adds cvars to an orderitem with no cvars for saving, but
1176 # they cannot be retrieved via custom_variables until the order/orderitem is
1177 # saved. Adding empty custom_variables to new orderitem here solves this problem.
1178 $item ||= SL::DB::OrderItem->new(custom_variables => []);
1180 $item->assign_attributes(%$attr);
1181 $item->longdescription($item->part->notes) if $is_new && !defined $attr->{longdescription};
1182 $item->project_id($record->globalproject_id) if $is_new && !defined $attr->{project_id};
1183 $item->lastcost($record->is_sales ? $item->part->lastcost : 0) if $is_new && !defined $attr->{lastcost_as_number};
1190 # This is used to add one item
1192 my ($record, $attr) = @_;
1194 my $item = SL::DB::OrderItem->new;
1195 $item->assign_attributes(%$attr);
1197 my $part = SL::DB::Part->new(id => $attr->{parts_id})->load;
1198 my $price_source = SL::PriceSource->new(record_item => $item, record => $record);
1200 $item->unit($part->unit) if !$item->unit;
1203 if ( $part->is_assortment ) {
1204 # add assortment items with price 0, as the components carry the price
1205 $price_src = $price_source->price_from_source("");
1206 $price_src->price(0);
1207 } elsif ($item->sellprice) {
1208 $price_src = $price_source->price_from_source("");
1209 $price_src->price($item->sellprice);
1211 $price_src = $price_source->best_price
1212 ? $price_source->best_price
1213 : $price_source->price_from_source("");
1214 $price_src->price(0) if !$price_source->best_price;
1218 if ($item->discount) {
1219 $discount_src = $price_source->discount_from_source("");
1220 $discount_src->discount($item->discount);
1222 $discount_src = $price_source->best_discount
1223 ? $price_source->best_discount
1224 : $price_source->discount_from_source("");
1225 $discount_src->discount(0) if !$price_source->best_discount;
1229 $new_attr{part} = $part;
1230 $new_attr{description} = $part->description if ! $item->description;
1231 $new_attr{qty} = 1.0 if ! $item->qty;
1232 $new_attr{price_factor_id} = $part->price_factor_id if ! $item->price_factor_id;
1233 $new_attr{sellprice} = $price_src->price;
1234 $new_attr{discount} = $discount_src->discount;
1235 $new_attr{active_price_source} = $price_src;
1236 $new_attr{active_discount_source} = $discount_src;
1237 $new_attr{longdescription} = $part->notes if ! defined $attr->{longdescription};
1238 $new_attr{project_id} = $record->globalproject_id;
1239 $new_attr{lastcost} = $record->is_sales ? $part->lastcost : 0;
1241 # add_custom_variables adds cvars to an orderitem with no cvars for saving, but
1242 # they cannot be retrieved via custom_variables until the order/orderitem is
1243 # saved. Adding empty custom_variables to new orderitem here solves this problem.
1244 $new_attr{custom_variables} = [];
1246 $item->assign_attributes(%new_attr);
1251 sub _setup_order_from_cv {
1254 $order->$_($order->customervendor->$_) for (qw(taxzone_id payment_id delivery_term_id));
1256 $order->intnotes($order->customervendor->notes);
1258 if ($order->is_sales) {
1259 $order->salesman_id($order->customer->salesman_id);
1260 $order->taxincluded(defined($order->customer->taxincluded_checked)
1261 ? $order->customer->taxincluded_checked
1262 : $::myconfig{taxincluded_checked});
1267 # recalculate prices and taxes
1269 # Using the PriceTaxCalculator. Store linetotals in the item objects.
1273 # bb: todo: currency later
1274 $self->order->currency_id($::instance_conf->get_currency_id());
1276 my %pat = $self->order->calculate_prices_and_taxes();
1277 $self->{taxes} = [];
1278 foreach my $tax_chart_id (keys %{ $pat{taxes} }) {
1279 my $tax = SL::DB::Manager::Tax->find_by(chart_id => $tax_chart_id);
1281 my @amount_keys = grep { $pat{amounts}->{$_}->{tax_id} == $tax->id } keys %{ $pat{amounts} };
1282 push(@{ $self->{taxes} }, { amount => $pat{taxes}->{$tax_chart_id},
1283 netamount => $pat{amounts}->{$amount_keys[0]}->{amount},
1287 pairwise { $a->{linetotal} = $b->{linetotal} } @{$self->order->items}, @{$pat{items}};
1290 # get data for saving, printing, ..., that is not changed in the form
1292 # Only cvars for now.
1293 sub _get_unalterable_data {
1296 foreach my $item (@{ $self->order->items }) {
1297 # autovivify all cvars that are not in the form (cvars_by_config can do it).
1298 # workaround to pre-parse number-cvars (parse_custom_variable_values does not parse number values).
1299 foreach my $var (@{ $item->cvars_by_config }) {
1300 $var->unparsed_value($::form->parse_amount(\%::myconfig, $var->{__unparsed_value})) if ($var->config->type eq 'number' && exists($var->{__unparsed_value}));
1302 $item->parse_custom_variable_values;
1308 # And remove related files in the spool directory
1313 my $db = $self->order->db;
1315 $db->with_transaction(
1317 my @spoolfiles = grep { $_ } map { $_->spoolfile } @{ SL::DB::Manager::Status->get_all(where => [ trans_id => $self->order->id ]) };
1318 $self->order->delete;
1319 my $spool = $::lx_office_conf{paths}->{spool};
1320 unlink map { "$spool/$_" } @spoolfiles if $spool;
1323 }) || push(@{$errors}, $db->error);
1330 # And delete items that are deleted in the form.
1335 my $db = $self->order->db;
1337 $db->with_transaction(sub {
1338 SL::DB::OrderItem->new(id => $_)->delete for @{$self->item_ids_to_delete};
1339 $self->order->save(cascade => 1);
1342 if ($::form->{converted_from_oe_id}) {
1343 SL::DB::Order->new(id => $::form->{converted_from_oe_id})->load->link_to_record($self->order);
1345 if (scalar @{ $::form->{converted_from_orderitems_ids} || [] }) {
1347 foreach (@{ $self->order->items_sorted }) {
1348 my $from_id = $::form->{converted_from_orderitems_ids}->[$idx];
1350 SL::DB::RecordLink->new(from_table => 'orderitems',
1351 from_id => $from_id,
1352 to_table => 'orderitems',
1360 }) || push(@{$errors}, $db->error);
1365 sub _workflow_sales_or_purchase_order {
1368 my $destination_type = $::form->{type} eq _sales_quotation_type() ? _sales_order_type()
1369 : $::form->{type} eq _request_quotation_type() ? _purchase_order_type()
1370 : $::form->{type} eq _purchase_order_type() ? _sales_order_type()
1371 : $::form->{type} eq _sales_order_type() ? _purchase_order_type()
1374 $self->order(SL::DB::Order->new_from($self->order, destination_type => $destination_type));
1375 $self->{converted_from_oe_id} = delete $::form->{id};
1377 # set item ids to new fake id, to identify them as new items
1378 foreach my $item (@{$self->order->items_sorted}) {
1379 $item->{new_fake_id} = join('_', 'new', Time::HiRes::gettimeofday(), int rand 1000000000000);
1383 $::form->{type} = $destination_type;
1384 $self->type($self->init_type);
1385 $self->cv ($self->init_cv);
1389 $self->_get_unalterable_data();
1390 $self->_pre_render();
1392 # trigger rendering values for second row/longdescription as hidden,
1393 # because they are loaded only on demand. So we need to keep the values
1395 $_->{render_second_row} = 1 for @{ $self->order->items_sorted };
1396 $_->{render_longdescription} = 1 for @{ $self->order->items_sorted };
1400 title => $self->_get_title_for('edit'),
1401 %{$self->{template_args}}
1409 $self->{all_taxzones} = SL::DB::Manager::TaxZone->get_all_sorted();
1410 $self->{all_departments} = SL::DB::Manager::Department->get_all_sorted();
1411 $self->{all_employees} = SL::DB::Manager::Employee->get_all(where => [ or => [ id => $self->order->employee_id,
1414 $self->{all_salesmen} = SL::DB::Manager::Employee->get_all(where => [ or => [ id => $self->order->salesman_id,
1417 $self->{all_projects} = SL::DB::Manager::Project->get_all(where => [ or => [ id => $self->order->globalproject_id,
1419 sort_by => 'projectnumber');
1420 $self->{all_payment_terms} = SL::DB::Manager::PaymentTerm->get_all_sorted(where => [ or => [ id => $self->order->payment_id,
1422 $self->{all_delivery_terms} = SL::DB::Manager::DeliveryTerm->get_all_sorted();
1423 $self->{current_employee_id} = SL::DB::Manager::Employee->current->id;
1424 $self->{periodic_invoices_status} = $self->_get_periodic_invoices_status($self->order->periodic_invoices_config);
1425 $self->{order_probabilities} = [ map { { title => ($_ * 10) . '%', id => $_ * 10 } } (0..10) ];
1427 my $print_form = Form->new('');
1428 $print_form->{type} = $self->type;
1429 $print_form->{printers} = SL::DB::Manager::Printer->get_all_sorted;
1430 $print_form->{languages} = SL::DB::Manager::Language->get_all_sorted;
1431 $self->{print_options} = SL::Helper::PrintOptions->get_print_options(
1432 form => $print_form,
1433 options => {dialog_name_prefix => 'print_options.',
1437 no_opendocument => 1,
1441 foreach my $item (@{$self->order->orderitems}) {
1442 my $price_source = SL::PriceSource->new(record_item => $item, record => $self->order);
1443 $item->active_price_source( $price_source->price_from_source( $item->active_price_source ));
1444 $item->active_discount_source($price_source->discount_from_source($item->active_discount_source));
1447 if ($self->order->ordnumber && $::instance_conf->get_webdav) {
1448 my $webdav = SL::Webdav->new(
1449 type => $self->type,
1450 number => $self->order->ordnumber,
1452 my @all_objects = $webdav->get_all_objects;
1453 @{ $self->{template_args}->{WEBDAV} } = map { { name => $_->filename,
1455 link => File::Spec->catfile($_->full_filedescriptor),
1459 $::request->{layout}->use_javascript("${_}.js") for qw(kivi.SalesPurchase kivi.Order kivi.File ckeditor/ckeditor ckeditor/adapters/jquery edit_periodic_invoices_config calculate_qty);
1460 $self->_setup_edit_action_bar;
1463 sub _setup_edit_action_bar {
1464 my ($self, %params) = @_;
1466 my $deletion_allowed = (any { $self->type eq $_ } (_sales_quotation_type(), _request_quotation_type()))
1467 || (($self->type eq _sales_order_type()) && $::instance_conf->get_sales_order_show_delete)
1468 || (($self->type eq _purchase_order_type()) && $::instance_conf->get_purchase_order_show_delete);
1470 for my $bar ($::request->layout->get('actionbar')) {
1475 call => [ 'kivi.Order.save', 'save', $::instance_conf->get_order_warn_duplicate_parts,
1476 $::instance_conf->get_order_warn_no_deliverydate,
1478 checks => [ 'kivi.Order.check_save_active_periodic_invoices' ],
1482 call => [ 'kivi.Order.save', 'save_as_new', $::instance_conf->get_order_warn_duplicate_parts ],
1483 checks => [ 'kivi.Order.check_save_active_periodic_invoices' ],
1484 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1487 t8('Save and Delivery Order'),
1488 call => [ 'kivi.Order.save', 'save_and_delivery_order', $::instance_conf->get_order_warn_duplicate_parts,
1489 $::instance_conf->get_order_warn_no_deliverydate,
1491 checks => [ 'kivi.Order.check_save_active_periodic_invoices' ],
1492 only_if => (any { $self->type eq $_ } (_sales_order_type(), _purchase_order_type()))
1495 t8('Save and Invoice'),
1496 call => [ 'kivi.Order.save', 'save_and_invoice', $::instance_conf->get_order_warn_duplicate_parts ],
1497 checks => [ 'kivi.Order.check_save_active_periodic_invoices' ],
1499 ], # end of combobox "Save"
1507 submit => [ '#order_form', { action => "Order/sales_order" } ],
1508 only_if => (any { $self->type eq $_ } (_sales_quotation_type(), _purchase_order_type())),
1509 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1512 t8('Purchase Order'),
1513 submit => [ '#order_form', { action => "Order/purchase_order" } ],
1514 only_if => (any { $self->type eq $_ } (_sales_order_type(), _request_quotation_type())),
1515 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1517 ], # end of combobox "Workflow"
1525 call => [ 'kivi.Order.show_print_options' ],
1529 call => [ 'kivi.Order.email' ],
1532 t8('Download attachments of all parts'),
1533 call => [ 'kivi.File.downloadOrderitemsFiles', $::form->{type}, $::form->{id} ],
1534 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1535 only_if => $::instance_conf->get_doc_storage,
1537 ], # end of combobox "Export"
1541 call => [ 'kivi.Order.delete_order' ],
1542 confirm => $::locale->text('Do you really want to delete this object?'),
1543 disabled => !$self->order->id ? t8('This object has not been saved yet.') : undef,
1544 only_if => $deletion_allowed,
1551 my ($order, $pdf_ref, $params) = @_;
1555 my $print_form = Form->new('');
1556 $print_form->{type} = $order->type;
1557 $print_form->{formname} = $params->{formname} || $order->type;
1558 $print_form->{format} = $params->{format} || 'pdf';
1559 $print_form->{media} = $params->{media} || 'file';
1560 $print_form->{groupitems} = $params->{groupitems};
1561 $print_form->{media} = 'file' if $print_form->{media} eq 'screen';
1563 $order->language($params->{language});
1564 $order->flatten_to_form($print_form, format_amounts => 1);
1566 # search for the template
1567 my ($template_file, @template_files) = SL::Helper::CreatePDF->find_template(
1568 name => $print_form->{formname},
1569 email => $print_form->{media} eq 'email',
1570 language => $params->{language},
1571 printer_id => $print_form->{printer_id}, # todo
1574 if (!defined $template_file) {
1575 push @errors, $::locale->text('Cannot find matching template for this print request. Please contact your template maintainer. I tried these: #1.', join ', ', map { "'$_'"} @template_files);
1578 return @errors if scalar @errors;
1580 $print_form->throw_on_error(sub {
1582 $print_form->prepare_for_printing;
1584 $$pdf_ref = SL::Helper::CreatePDF->create_pdf(
1585 template => $template_file,
1586 variables => $print_form,
1587 variable_content_types => {
1588 longdescription => 'html',
1589 partnotes => 'html',
1594 } || push @errors, ref($EVAL_ERROR) eq 'SL::X::FormError' ? $EVAL_ERROR->getMessage : $EVAL_ERROR;
1600 sub _get_files_for_email_dialog {
1603 my %files = map { ($_ => []) } qw(versions files vc_files part_files);
1605 return %files if !$::instance_conf->get_doc_storage;
1607 if ($self->order->id) {
1608 $files{versions} = [ SL::File->get_all_versions(object_id => $self->order->id, object_type => $self->order->type, file_type => 'document') ];
1609 $files{files} = [ SL::File->get_all( object_id => $self->order->id, object_type => $self->order->type, file_type => 'attachment') ];
1610 $files{vc_files} = [ SL::File->get_all( object_id => $self->order->{$self->cv}->id, object_type => $self->cv, file_type => 'attachment') ];
1614 uniq_by { $_->{id} }
1616 +{ id => $_->part->id,
1617 partnumber => $_->part->partnumber }
1618 } @{$self->order->items_sorted};
1620 foreach my $part (@parts) {
1621 my @pfiles = SL::File->get_all(object_id => $part->{id}, object_type => 'part');
1622 push @{ $files{part_files} }, map { +{ %{ $_ }, partnumber => $part->{partnumber} } } @pfiles;
1625 foreach my $key (keys %files) {
1626 $files{$key} = [ sort_by { lc $_->{db_file}->{file_name} } @{ $files{$key} } ];
1632 sub _make_periodic_invoices_config_from_yaml {
1633 my ($yaml_config) = @_;
1635 return if !$yaml_config;
1636 my $attr = YAML::Load($yaml_config);
1637 return if 'HASH' ne ref $attr;
1638 return SL::DB::PeriodicInvoicesConfig->new(%$attr);
1642 sub _get_periodic_invoices_status {
1643 my ($self, $config) = @_;
1645 return if $self->type ne _sales_order_type();
1646 return t8('not configured') if !$config;
1648 my $active = ('HASH' eq ref $config) ? $config->{active}
1649 : ('SL::DB::PeriodicInvoicesConfig' eq ref $config) ? $config->active
1650 : die "Cannot get status of periodic invoices config";
1652 return $active ? t8('active') : t8('inactive');
1655 sub _get_title_for {
1656 my ($self, $action) = @_;
1658 return '' if none { lc($action)} qw(add edit);
1661 # $::locale->text("Add Sales Order");
1662 # $::locale->text("Add Purchase Order");
1663 # $::locale->text("Add Quotation");
1664 # $::locale->text("Add Request for Quotation");
1665 # $::locale->text("Edit Sales Order");
1666 # $::locale->text("Edit Purchase Order");
1667 # $::locale->text("Edit Quotation");
1668 # $::locale->text("Edit Request for Quotation");
1670 $action = ucfirst(lc($action));
1671 return $self->type eq _sales_order_type() ? $::locale->text("$action Sales Order")
1672 : $self->type eq _purchase_order_type() ? $::locale->text("$action Purchase Order")
1673 : $self->type eq _sales_quotation_type() ? $::locale->text("$action Quotation")
1674 : $self->type eq _request_quotation_type() ? $::locale->text("$action Request for Quotation")
1678 sub _sales_order_type {
1682 sub _purchase_order_type {
1686 sub _sales_quotation_type {
1690 sub _request_quotation_type {
1691 'request_quotation';
1702 SL::Controller::Order - controller for orders
1706 This is a new form to enter orders, completely rewritten with the use
1707 of controller and java script techniques.
1709 The aim is to provide the user a better expirience and a faster flow
1710 of work. Also the code should be more readable, more reliable and
1719 One input row, so that input happens every time at the same place.
1723 Use of pickers where possible.
1727 Possibility to enter more than one item at once.
1731 Save order only on "save" (and "save and delivery order"-workflow). No
1732 hidden save on "print" or "email".
1736 Item list in a scrollable area, so that the workflow buttons stay at
1741 Reordering item rows with drag and drop is possible. Sorting item rows is
1742 possible (by partnumber, description, qty, sellprice and discount for now).
1746 No C<update> is necessary. All entries and calculations are managed
1747 with ajax-calls and the page does only reload on C<save>.
1751 User can see changes immediately, because of the use of java script
1762 =item * C<SL/Controller/Order.pm>
1766 =item * C<template/webpages/order/form.html>
1770 =item * C<template/webpages/order/tabs/basic_data.html>
1772 Main tab for basic_data.
1774 This is the only tab here for now. "linked records" and "webdav" tabs are
1775 reused from generic code.
1779 =item * C<template/webpages/order/tabs/_business_info_row.html>
1781 For displaying information on business type
1783 =item * C<template/webpages/order/tabs/_item_input.html>
1785 The input line for items
1787 =item * C<template/webpages/order/tabs/_row.html>
1789 One row for already entered items
1791 =item * C<template/webpages/order/tabs/_tax_row.html>
1793 Displaying tax information
1795 =item * C<template/webpages/order/tabs/_multi_items_dialog.html>
1797 Dialog for entering more than one item at once
1799 =item * C<template/webpages/order/tabs/_multi_items_result.html>
1801 Results for the filter in the multi items dialog
1803 =item * C<template/webpages/order/tabs/_price_sources_dialog.html>
1805 Dialog for selecting price and discount sources
1809 =item * C<js/kivi.Order.js>
1811 java script functions
1823 =item * credit limit
1825 =item * more workflows (save as new, quotation, purchase order)
1827 =item * price sources: little symbols showing better price / better discount
1829 =item * select units in input row?
1831 =item * custom shipto address
1833 =item * check for direct delivery (workflow sales order -> purchase order)
1835 =item * language / part translations
1837 =item * access rights
1839 =item * display weights
1845 =item * optional client/user behaviour
1847 (transactions has to be set - department has to be set -
1848 force project if enabled in client config - transport cost reminder)
1852 =head1 KNOWN BUGS AND CAVEATS
1858 Customer discount is not displayed as a valid discount in price source popup
1859 (this might be a bug in price sources)
1861 (I cannot reproduce this (Bernd))
1865 No indication that <shift>-up/down expands/collapses second row.
1869 Inline creation of parts is not currently supported
1873 Table header is not sticky in the scrolling area.
1877 Sorting does not include C<position>, neither does reordering.
1879 This behavior was implemented intentionally. But we can discuss, which behavior
1880 should be implemented.
1884 C<show_multi_items_dialog> does not use the currently inserted string for
1889 The language selected in print or email dialog is not saved when the order is saved.
1893 =head1 To discuss / Nice to have
1899 How to expand/collapse second row. Now it can be done clicking the icon or
1904 Possibility to change longdescription in input row?
1908 Possibility to select PriceSources in input row?
1912 This controller uses a (changed) copy of the template for the PriceSource
1913 dialog. Maybe there could be used one code source.
1917 Rounding-differences between this controller (PriceTaxCalculator) and the old
1918 form. This is not only a problem here, but also in all parts using the PTC.
1919 There exists a ticket and a patch. This patch should be testet.
1923 An indicator, if the actual inputs are saved (like in an
1924 editor or on text processing application).
1928 A warning when leaving the page without saveing unchanged inputs.
1932 Workflows for delivery order and invoice are in the menu "Save", because the
1933 order is saved before opening the new document form. Nevertheless perhaps these
1934 workflow buttons should be put under "Workflows".
1941 Bernd Bleßmann E<lt>bernd@kivitendo-premium.deE<gt>