8 use List::Util qw(max);
10 use SL::DB::MetaSetup::Order;
11 use SL::DB::Manager::Order;
12 use SL::DB::Helper::AttrHTML;
13 use SL::DB::Helper::AttrSorted;
14 use SL::DB::Helper::FlattenToForm;
15 use SL::DB::Helper::LinkedRecords;
16 use SL::DB::Helper::PriceTaxCalculator;
17 use SL::DB::Helper::PriceUpdater;
18 use SL::DB::Helper::TransNumberGenerator;
20 use Rose::DB::Object::Helpers qw(as_tree);
22 __PACKAGE__->meta->add_relationship(
24 type => 'one to many',
25 class => 'SL::DB::OrderItem',
26 column_map => { id => 'trans_id' },
28 with_objects => [ 'part' ]
31 periodic_invoices_config => {
33 class => 'SL::DB::PeriodicInvoicesConfig',
34 column_map => { id => 'oe_id' },
38 class => 'SL::DB::Shipto',
39 column_map => { id => 'trans_id' },
40 query_args => [ module => 'OE' ],
44 __PACKAGE__->meta->initialize;
46 __PACKAGE__->attr_html('notes');
47 __PACKAGE__->attr_sorted('items');
49 __PACKAGE__->before_save('_before_save_set_ord_quo_number');
53 sub _before_save_set_ord_quo_number {
56 # ordnumber is 'NOT NULL'. Therefore make sure it's always set to at
57 # least an empty string, even if we're saving a quotation.
58 $self->ordnumber('') if !$self->ordnumber;
60 my $field = $self->quotation ? 'quonumber' : 'ordnumber';
61 $self->create_trans_number if !$self->$field;
68 sub items { goto &orderitems; }
69 sub add_items { goto &add_orderitems; }
74 return 'sales_order' if $self->customer_id && ! $self->quotation;
75 return 'purchase_order' if $self->vendor_id && ! $self->quotation;
76 return 'sales_quotation' if $self->customer_id && $self->quotation;
77 return 'request_quotation' if $self->vendor_id && $self->quotation;
83 return shift->type eq shift;
86 sub displayable_type {
87 my $type = shift->type;
89 return $::locale->text('Sales quotation') if $type eq 'sales_quotation';
90 return $::locale->text('Request quotation') if $type eq 'request_quotation';
91 return $::locale->text('Sales Order') if $type eq 'sales_order';
92 return $::locale->text('Purchase Order') if $type eq 'purchase_order';
99 croak 'not an accessor' if @_ > 1;
100 return !!shift->customer_id;
107 if ($self->quotation) {
110 require SL::DB::Invoice;
111 return SL::DB::Manager::Invoice->get_all(
113 ordnumber => $self->ordnumber,
114 @{ $params{query} || [] },
120 sub displayable_state {
123 return $self->closed ? $::locale->text('closed') : $::locale->text('open');
126 sub abschlag_invoices {
127 return shift()->invoices(query => [ abschlag => 1 ]);
131 return shift()->invoices(query => [ abschlag => 0 ]);
134 sub convert_to_invoice {
135 my ($self, %params) = @_;
137 croak("Conversion to invoices is only supported for sales records") unless $self->customer_id;
140 if (!$self->db->with_transaction(sub {
141 require SL::DB::Invoice;
142 $invoice = SL::DB::Invoice->new_from($self)->post(%params) || die;
143 $self->link_to_record($invoice);
144 $self->update_attributes(closed => 1);
153 sub convert_to_delivery_order {
154 my ($self, @args) = @_;
156 my ($delivery_order, $custom_shipto);
157 if (!$self->db->with_transaction(sub {
158 require SL::DB::DeliveryOrder;
159 ($delivery_order, $custom_shipto) = SL::DB::DeliveryOrder->new_from($self, @args);
160 $delivery_order->save;
161 $custom_shipto->save if $custom_shipto;
162 $self->link_to_record($delivery_order);
163 $self->update_attributes(delivered => 1);
166 return wantarray ? () : undef;
169 return wantarray ? ($delivery_order, $custom_shipto) : $delivery_order;
175 my %number_method = (
176 sales_order => 'ordnumber',
177 sales_quotation => 'quonumber',
178 purchase_order => 'ordnumber',
179 request_quotation => 'quonumber',
182 return $self->${ \ $number_method{$self->type} }(@_);
186 $_[0]->is_sales ? $_[0]->customer : $_[0]->vendor;
199 SL::DB::Order - Order Datenbank Objekt.
205 Returns one of the following string types:
213 =item sales_quotation
215 =item request_quotation
219 =head2 C<is_type TYPE>
221 Returns true if the order is of the given type.
223 =head2 C<convert_to_delivery_order %params>
225 Creates a new delivery order with C<$self> as the basis by calling
226 L<SL::DB::DeliveryOrder::new_from>. That delivery order is saved, and
227 C<$self> is linked to the new invoice via
228 L<SL::DB::RecordLink>. C<$self>'s C<delivered> attribute is set to
229 C<true>, and C<$self> is saved.
231 The arguments in C<%params> are passed to
232 L<SL::DB::DeliveryOrder::new_from>.
234 Returns C<undef> on failure. Otherwise the return value depends on the
235 context. In list context the new delivery order and a shipto instance
236 will be returned. In scalar instance only the delivery order instance
239 Custom shipto addresses (the ones specific to the sales/purchase
240 record and not to the customer/vendor) are only linked from C<shipto>
241 to C<delivery_orders>. Meaning C<delivery_orders.shipto_id> will not
242 be filled in that case. That's why a separate shipto object is created
245 =head2 C<convert_to_invoice %params>
247 Creates a new invoice with C<$self> as the basis by calling
248 L<SL::DB::Invoice::new_from>. That invoice is posted, and C<$self> is
249 linked to the new invoice via L<SL::DB::RecordLink>. C<$self>'s
250 C<closed> attribute is set to C<true>, and C<$self> is saved.
252 The arguments in C<%params> are passed to L<SL::DB::Invoice::post>.
254 Returns the new invoice instance on success and C<undef> on
255 failure. The whole process is run inside a transaction. On failure
256 nothing is created or changed in the database.
258 At the moment only sales quotations and sales orders can be converted.
260 =head2 C<create_sales_process>
262 Creates and saves a new sales process. Can only be called for sales
265 The newly created process will be linked bidirectionally to both
266 C<$self> and to all sales quotations that are linked to C<$self>.
268 Returns the newly created process instance.
276 Sven Schöling <s.schoeling@linet-services.de>