projekt kivitendo

sub new_from {

  my ($class, $source, %params) = @_;

  croak("Unsupported source object type '" . ref($source) . "'") unless ref($source) eq 'SL::DB::Order';

  my $terms = $source->can('payment_id') && $source->payment_id ? $source->payment_terms->terms_netto : 0;

  my %args = ( map({ ( $_ => $source->$_ ) } qw(cp_id currency_id customer_id cusordnumber department_id employee_id globalproject_id intnotes language_id notes

                                                ordnumber reqdate salesman_id shippingpoint shipvia taxincluded taxzone_id transaction_description vendor_id

                                             )),

               closed    => 0,

               is_sales  => !!$source->customer_id,

               delivered => 0,

               terms     => $terms,

               transdate => DateTime->today_local,

            );

  # Custom shipto addresses (the ones specific to the sales/purchase

  # record and not to the customer/vendor) are only linked from

  # shipto -> delivery_orders. Meaning delivery_orders.shipto_id

  # will not be filled in that case. Therefore we have to return the

  # new shipto object as a separate object so that the caller can

  # save it, too.

  my $custom_shipto;

  if (!$source->shipto_id && $source->id) {

    require SL::DB::Shipto;

    my $old = SL::DB::Manager::Shipto->find_by(trans_id => $source->id);

    if ($old) {

      $custom_shipto = SL::DB::Shipto->new(

        map  { +($_ => $old->$_) }

        grep { !m{^ (?: itime | mtime | shipto_id | trans_id ) $}x }

        map  { $_->name }

        @{ $old->meta->columns }

      );

    }

  } else {

    $args{shipto_id} = $source->shipto_id;

  }

  my $delivery_order = $class->new(%args, %params);

  my @items = map {

    my $source_item = $_;

    SL::DB::DeliveryOrderItem->new(map({ ( $_ => $source_item->$_ ) }

                                   qw(base_qty cusordnumber description discount lastcost longdescription marge_price_factor ordnumber parts_id price_factor price_factor_id

                                      project_id qty reqdate sellprice serialnumber transdate unit

                                   )));

  } @{ $source->items_sorted };

  $delivery_order->items(\@items);

  return ($delivery_order, $custom_shipto);

}

__END__

=pod

=encoding utf8

=head1 NAME

SL::DB::DeliveryOrder - Rose model for delivery orders (table

"delivery_orders")

=head1 FUNCTIONS

=over 4

=item C<date>

An alias for L</transdate> for compatibility with other sales/purchase models.

=item C<displayable_state>

Returns a human-readable description of the state regarding being

closed and delivered.

=item C<items>

An alias for L</deliver_orer_items> for compatibility with other

sales/purchase models.

=item C<items_sorted>

Returns the delivery order items sorted by their ID (same order they

appear in the frontend delivery order masks).

=item C<new_from $source>

Creates a new C<SL::DB::DeliveryOrder> instance and copies as much

information from C<$source> as possible. At the moment only instances

of C<SL::DB::Order> (sales quotations, sales orders, requests for

quotations and purchase orders) are supported as sources.

The conversion copies order items into delivery order items. Dates are copied

as appropriate, e.g. the C<transdate> field will be set to the current date.

Returns one or two objects depending on the context. In list context

the new delivery order instance and a shipto instance will be

returned. In scalar instance only the delivery order instance is

returned.

Custom shipto addresses (the ones specific to the sales/purchase

record and not to the customer/vendor) are only linked from C<shipto>

to C<delivery_orders>. Meaning C<delivery_orders.shipto_id> will not

be filled in that case. That's why a separate shipto object is created

and returned.

The objects returned are not saved.

=item C<sales_order>

TODO: Describe sales_order

=item C<type>

Returns a stringdescribing this record's type: either

C<sales_delivery_order> or C<purchase_delivery_order>.

=back

=head1 BUGS

Nothing here yet.

=head1 AUTHOR

Moritz Bunkus E<lt>m.bunkus@linet-services.deE<gt>

=cut

sub convert_to_delivery_order {

  my ($self, %params) = @_;

  my ($delivery_order, $custom_shipto);

  if (!$self->db->do_transaction(sub {

    require SL::DB::DeliveryOrder;

    ($delivery_order, $custom_shipto) = SL::DB::DeliveryOrder->new_from($self);

    $delivery_order->save;

    $custom_shipto->save if $custom_shipto;

    $self->link_to_record($delivery_order);

    # die;

  })) {

    return undef;

  }

  return wantarray ? ($delivery_order, $custom_shipto) : $delivery_order;

}

=head2 C<convert_to_delivery_order %params>

Creates a new delivery order with C<$self> as the basis by calling

L<SL::DB::DeliveryOrder::new_from>. That delivery order is saved, and

C<$self> is linked to the new invoice via L<SL::DB::RecordLink>.

The arguments in C<%params> are passed to

L<SL::DB::DeliveryOrder::new_from>.

Returns C<undef> on failure. Otherwise the return value depends on the

context. In list context the new delivery order and a shipto instance

will be returned. In scalar instance only the delivery order instance

is returned.

Custom shipto addresses (the ones specific to the sales/purchase

record and not to the customer/vendor) are only linked from C<shipto>

to C<delivery_orders>. Meaning C<delivery_orders.shipto_id> will not

be filled in that case. That's why a separate shipto object is created

and returned.