1 #====================================================================
4 # Based on SQL-Ledger Version 2.1.9
5 # Web http://www.lx-office.org
7 #=====================================================================
8 # SQL-Ledger Accounting
9 # Copyright (C) 1999-2003
11 # Author: Dieter Simader
12 # Email: dsimader@sql-ledger.org
13 # Web: http://www.sql-ledger.org
17 # This program is free software; you can redistribute it and/or modify
18 # it under the terms of the GNU General Public License as published by
19 # the Free Software Foundation; either version 2 of the License, or
20 # (at your option) any later version.
22 # This program is distributed in the hope that it will be useful,
23 # but WITHOUT ANY WARRANTY; without even the implied warranty of
24 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
25 # GNU General Public License for more details.
26 # You should have received a copy of the GNU General Public License
27 # along with this program; if not, write to the Free Software
28 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
30 #======================================================================
34 #======================================================================
42 use SL::DB::Inventory;
44 use SL::Locale::String qw(t8);
45 use SL::Util qw(trim);
51 $::lxdebug->enter_sub;
53 my ($self, @args) = @_;
56 $::lxdebug->leave_sub;
60 require SL::DB::TransferType;
62 require SL::DB::Employee;
64 my $employee = SL::DB::Manager::Employee->find_by(login => $::myconfig{login});
65 my ($now) = selectrow_query($::form, $::form->get_standard_dbh, qq|SELECT current_date|);
66 my @directions = (undef, qw(out in transfer));
69 my ($transfer, $field, $class, @find_by) = @_;
71 @find_by = (description => $transfer->{$field}) unless @find_by;
73 if ($transfer->{$field} || $transfer->{"${field}_id"}) {
74 return ref $transfer->{$field} && $transfer->{$field}->isa($class) ? $transfer->{$field}
75 : $transfer->{$field} ? $class->_get_manager_class->find_by(@find_by)
76 : $class->_get_manager_class->find_by(id => $transfer->{"${field}_id"});
83 my $db = SL::DB::Inventory->new->db;
84 $db->with_transaction(sub{
85 while (my $transfer = shift @args) {
87 ($trans_id) = selectrow_query($::form, $::form->get_standard_dbh, qq|SELECT nextval('id')|) if $transfer->{qty};
89 my $part = $objectify->($transfer, 'parts', 'SL::DB::Part');
90 my $unit = $objectify->($transfer, 'unit', 'SL::DB::Unit', name => $transfer->{unit});
91 my $qty = $transfer->{qty};
92 my $src_bin = $objectify->($transfer, 'src_bin', 'SL::DB::Bin');
93 my $dst_bin = $objectify->($transfer, 'dst_bin', 'SL::DB::Bin');
94 my $src_wh = $objectify->($transfer, 'src_warehouse', 'SL::DB::Warehouse');
95 my $dst_wh = $objectify->($transfer, 'dst_warehouse', 'SL::DB::Warehouse');
96 my $project = $objectify->($transfer, 'project', 'SL::DB::Project');
98 $src_wh ||= $src_bin->warehouse if $src_bin;
99 $dst_wh ||= $dst_bin->warehouse if $dst_bin;
101 my $direction = 0; # bit mask
102 $direction |= 1 if $src_bin;
103 $direction |= 2 if $dst_bin;
105 my $transfer_type_id;
106 if ($transfer->{transfer_type_id}) {
107 $transfer_type_id = $transfer->{transfer_type_id};
109 my $transfer_type = $objectify->($transfer, 'transfer_type', 'SL::DB::TransferType', direction => $directions[$direction],
110 description => $transfer->{transfer_type});
111 $transfer_type_id = $transfer_type->id;
114 my $stocktaking_qty = $transfer->{stocktaking_qty};
118 employee => $employee,
119 trans_type_id => $transfer_type_id,
121 trans_id => $trans_id,
122 shippingdate => !$transfer->{shippingdate} || $transfer->{shippingdate} eq 'current_date'
123 ? $now : $transfer->{shippingdate},
124 map { $_ => $transfer->{$_} } qw(chargenumber bestbefore oe_id delivery_order_items_stock_id invoice_id comment),
128 $qty = $unit->convert_to($qty, $part->unit_obj);
129 $stocktaking_qty = $unit->convert_to($stocktaking_qty, $part->unit_obj);
132 $params{chargenumber} ||= '';
135 if ($qty && $direction & 1) {
136 push @inventories, SL::DB::Inventory->new(
138 warehouse => $src_wh,
144 if ($qty && $direction & 2) {
145 push @inventories, SL::DB::Inventory->new(
147 warehouse => $dst_wh->id,
151 # Standardlagerplatz in Stammdaten gleich mitverschieben
152 if (defined($transfer->{change_default_bin})){
153 $part->update_attributes(warehouse_id => $dst_wh->id, bin_id => $dst_bin->id);
157 # Record stocktaking if requested.
158 # This is only possible if transfer was a stock in or stock out,
159 # but not both (transfer).
160 if ($transfer->{record_stocktaking}) {
161 die 'Stocktaking can only be recorded for stock in or stock out, but not on a transfer.' if scalar @inventories > 1;
164 $inventory_id = $inventories[0]->id if $inventories[0];
166 SL::DB::Stocktaking->new(
167 inventory_id => $inventory_id,
168 warehouse => $src_wh || $dst_wh,
169 bin => $src_bin || $dst_bin,
170 parts_id => $part->id,
171 employee_id => $employee->id,
172 qty => $stocktaking_qty,
173 comment => $transfer->{comment},
174 cutoff_date => $transfer->{stocktaking_cutoff_date},
175 chargenumber => $transfer->{chargenumber},
176 bestbefore => $transfer->{bestbefore},
181 push @trans_ids, $trans_id;
186 $::form->error("Warehouse transfer error: " . join("\n", (split(/\n/, $db->error))[0..2]));
189 $::lxdebug->leave_sub;
194 sub transfer_assembly {
195 $main::lxdebug->enter_sub();
199 Common::check_params(\%params, qw(assembly_id dst_warehouse_id login qty unit dst_bin_id chargenumber bestbefore comment));
201 my $myconfig = \%main::myconfig;
202 my $form = $main::form;
203 my $kannNichtFertigen =""; # Falls leer dann erfolgreich
205 SL::DB->client->with_transaction(sub {
206 my $dbh = $params{dbh} || SL::DB->client->dbh;
210 # ... Standard-Check oben Ende. Hier die eigentliche SQL-Abfrage
211 # select parts_id,qty from assembly where id=1064;
212 # Erweiterung für bug 935 am 23.4.09 -
213 # Erzeugnisse können Dienstleistungen enthalten, die ja nicht 'lagerbar' sind.
214 # select parts_id,qty from assembly inner join parts on assembly.parts_id = parts.id
215 # where assembly.id=1066 and inventory_accno_id IS NOT NULL;
217 # Erweiterung für bug 23.4.09 -2 Erzeugnisse in Erzeugnissen können nicht ausgelagert werden,
218 # wenn assembly nicht überprüft wird ...
219 # patch von joachim eingespielt 24.4.2009:
220 # my $query = qq|select parts_id,qty from assembly inner join parts
221 # on assembly.parts_id = parts.id where assembly.id = ? and
222 # (inventory_accno_id IS NOT NULL or parts.assembly = TRUE)|;
224 # Lager in dem die Bestandteile gesucht werden kann entweder das Ziellager sein oder ist per Mandantenkonfig
225 # auf das Standardlager des Bestandteiles schaltbar
227 my $use_default_warehouse = $::instance_conf->get_transfer_default_warehouse_for_assembly;
229 my $query = qq|SELECT assembly.parts_id, assembly.qty, parts.warehouse_id
230 FROM assembly INNER JOIN parts ON assembly.parts_id = parts.id
231 WHERE assembly.id = ? AND parts.part_type != 'service'|;
233 my $sth_part_qty_assembly = prepare_execute_query($form, $dbh, $query, $params{assembly_id});
237 # Hier wird das prepared Statement für die Schleife über alle Lagerplätze vorbereitet
238 my $transferPartSQL = qq|INSERT INTO inventory (parts_id, warehouse_id, bin_id, chargenumber, bestbefore, comment, employee_id, qty,
239 trans_id, trans_type_id, shippingdate)
240 VALUES (?, ?, ?, ?, ?, ?, (SELECT id FROM employee WHERE login = ?), ?, ?,
241 (SELECT id FROM transfer_type WHERE direction = 'out' AND description = 'used'),
242 (SELECT current_date))|;
243 my $sthTransferPartSQL = prepare_query($form, $dbh, $transferPartSQL);
246 # der return-string für die fehlermeldung inkl. welche waren zum fertigen noch fehlen
248 my $schleife_durchlaufen=0; # Falls die Schleife nicht ausgeführt wird -> Keine Einzelteile definiert. Bessere Idee? jan
249 while (my $hash_ref = $sth_part_qty_assembly->fetchrow_hashref()) { #Schleife für select parts_id,(...) from assembly
250 $schleife_durchlaufen=1; # Erzeugnis definiert
252 my $partsQTY = $hash_ref->{qty} * $params{qty}; # benötigte teile * anzahl erzeugnisse
253 my $currentPart_ID = $hash_ref->{parts_id};
255 my $currentPart_WH_ID = $use_default_warehouse && $hash_ref->{warehouse_id} ? $hash_ref->{warehouse_id} : $params{dst_warehouse_id};
258 # Prüfen ob Erzeugnis-Teile Standardlager haben.
259 if ($use_default_warehouse && ! $hash_ref->{warehouse_id}) {
260 # Prüfen ob in Mandantenkonfiguration ein Standardlager aktiviert isti.
261 if ($::instance_conf->get_transfer_default_ignore_onhand) {
262 $currentPart_WH_ID = $::instance_conf->get_warehouse_id_ignore_onhand;
265 $kannNichtFertigen .= "Kein Standardlager: " .
266 " Die Ware " . $self->get_part_description(parts_id => $currentPart_ID) .
267 " hat kein Standardlager definiert " .
268 ", um das Erzeugnis herzustellen. <br>";
272 my $warehouse_info = $self->get_basic_warehouse_info('id'=> $currentPart_WH_ID);
273 my $warehouse_desc = $warehouse_info->{"warehouse_description"};
275 # Fertigen ohne Prüfung nach Bestand
277 my $temppart_bin_id = $::instance_conf->get_bin_id_ignore_onhand;
278 my $temppart_chargenumber = "";
279 my $temppart_bestbefore = localtime();
280 my $temppart_qty = $partsQTY * -1;
281 ($trans_id) = selectrow_query($form, $dbh, qq|SELECT nextval('id')| ) unless $trans_id;
283 do_statement($form, $sthTransferPartSQL, $transferPartSQL, $currentPart_ID, $currentPart_WH_ID,
284 $temppart_bin_id, $temppart_chargenumber, $temppart_bestbefore, 'Verbraucht für ' .
285 $self->get_part_description(parts_id => $params{assembly_id}), $params{login}, $temppart_qty, $trans_id);
288 # Überprüfen, ob diese Anzahl gefertigt werden kann
289 my $max_parts = $self->get_max_qty_parts(parts_id => $currentPart_ID, # $self->method() == this.method()
290 warehouse_id => $currentPart_WH_ID);
292 if ($partsQTY > $max_parts){
293 # Gibt es hier ein Problem mit nicht "escapten" Zeichen?
294 # 25.4.09 Antwort: Ja. Aber erst wenn im Frontend die locales-Funktion aufgerufen wird
296 $kannNichtFertigen .= "Zum Fertigen fehlen: " . abs($partsQTY - $max_parts) .
297 " Einheiten der Ware: " . $self->get_part_description(parts_id => $currentPart_ID) .
298 " im Lager: " . $warehouse_desc .
299 ", um das Erzeugnis herzustellen. <br>"; # Konnte die Menge nicht mit der aktuellen Anzahl der Waren fertigen
300 next; # die weiteren Überprüfungen sind unnötig, daher das nächste elemente prüfen (genaue Ausgabe, was noch fehlt)
303 # Eine kurze Vorabfrage, um den Lagerplatz, Chargennummer und die Mindesthaltbarkeit zu bestimmen
304 # Offen: Die Summe über alle Lagerplätze wird noch nicht gebildet
305 # Gelöst: Wir haben vorher schon die Abfrage durchgeführt, ob wir fertigen können.
306 # Noch besser gelöst: Wir laufen durch alle benötigten Waren zum Fertigen und geben eine Rückmeldung an den Benutzer was noch fehlt
307 # und lösen den Rest dann so wie bei xplace im Barcode-Programm
308 # S.a. Kommentar im bin/mozilla-Code mb übernimmt und macht das in ordentlich
310 my $tempquery = qq|SELECT SUM(qty), bin_id, chargenumber, bestbefore FROM inventory
311 WHERE warehouse_id = ? AND parts_id = ? GROUP BY bin_id, chargenumber, bestbefore having SUM(qty)>0|;
312 my $tempsth = prepare_execute_query($form, $dbh, $tempquery, $currentPart_WH_ID, $currentPart_ID);
314 # Alle Werte zu dem einzelnen Artikel, die wir später auslagern
315 my $tmpPartsQTY = $partsQTY;
317 while (my $temphash_ref = $tempsth->fetchrow_hashref()) {
318 my $temppart_bin_id = $temphash_ref->{bin_id}; # kann man hier den quelllagerplatz beim verbauen angeben?
319 my $temppart_chargenumber = $temphash_ref->{chargenumber};
320 my $temppart_bestbefore = conv_date($temphash_ref->{bestbefore});
321 my $temppart_qty = $temphash_ref->{sum};
323 ($trans_id) = selectrow_query($form, $dbh, qq|SELECT nextval('id')| ) unless $trans_id;
324 if ($tmpPartsQTY > $temppart_qty) { # wir haben noch mehr waren zum wegbuchen.
325 # Wir buchen den kompletten Lagerplatzbestand und zählen die Hilfsvariable runter
326 $tmpPartsQTY = $tmpPartsQTY - $temppart_qty;
327 $temppart_qty = $temppart_qty * -1; # TODO beim analyiseren des sql-trace, war dieser wert positiv,
328 # wenn * -1 als berechnung in der parameter-übergabe angegeben wird.
329 # Dieser Wert IST und BLEIBT positiv!! Hilfe.
330 # Liegt das daran, dass dieser Wert aus einem SQL-Statement stammt?
331 push @trans_ids, $trans_id;
332 do_statement($form, $sthTransferPartSQL, $transferPartSQL, $currentPart_ID, $currentPart_WH_ID,
333 $temppart_bin_id, $temppart_chargenumber, $temppart_bestbefore, 'Verbraucht für ' .
334 $self->get_part_description(parts_id => $params{assembly_id}), $params{login}, $temppart_qty, $trans_id);
336 # hier ist noch ein fehler am besten mit definierten erzeugnissen debuggen 02/2009 jb
337 # idee: ausbuch algorithmus mit rekursion lösen und an- und abschaltbar machen
338 # das problem könnte sein, dass strict nicht an war und sth global eine andere zuweisung bekam
339 # auf jeden fall war der internal-server-error nach aktivierung von strict und warnings plus ein paar my-definitionen weg
340 } else { # okay, wir haben weniger oder gleich Waren die wir wegbuchen müssen, wir können also aufhören
342 do_statement($form, $sthTransferPartSQL, $transferPartSQL, $currentPart_ID, $currentPart_WH_ID,
343 $temppart_bin_id, $temppart_chargenumber, $temppart_bestbefore, 'Verbraucht für ' .
344 $self->get_part_description(parts_id => $params{assembly_id}), $params{login}, $tmpPartsQTY, $trans_id);
345 last; # beendet die schleife (springt zum letzten element)
347 } # ende while SELECT SUM(qty), bin_id, chargenumber, bestbefore FROM inventory WHERE warehouse_id
348 } #ende while select parts_id,qty from assembly where id = ?
350 if ($schleife_durchlaufen==0){ # falls die schleife nicht durchlaufen wurde, wurden auch
351 # keine einzelteile definiert
352 $kannNichtFertigen ="Für dieses Erzeugnis sind keine Einzelteile definiert.
353 Dementsprechend kann auch nichts hergestellt werden";
355 # gibt die Fehlermeldung zurück. A.) Keine Teile definiert
356 # B.) Artikel und Anzahl der fehlenden Teile/Dienstleistungen
357 die "<br><br>" . $kannNichtFertigen if ($kannNichtFertigen);
359 # soweit alles gut. Jetzt noch die wirkliche Lagerbewegung für das Erzeugnis ausführen ...
360 ($trans_id) = selectrow_query($form, $dbh, qq|SELECT nextval('id')| ) unless $trans_id;
361 my $transferAssemblySQL = qq|INSERT INTO inventory (parts_id, warehouse_id, bin_id, chargenumber, bestbefore,
362 comment, employee_id, qty, trans_id, trans_type_id, shippingdate)
363 VALUES (?, ?, ?, ?, ?, ?, (SELECT id FROM employee WHERE login = ?), ?, ?,
364 (SELECT id FROM transfer_type WHERE direction = 'in' AND description = 'assembled'),
365 (select current_date))|;
366 my $sthTransferAssemblySQL = prepare_query($form, $dbh, $transferAssemblySQL);
367 do_statement($form, $sthTransferAssemblySQL, $transferAssemblySQL, $params{assembly_id}, $params{dst_warehouse_id},
368 $params{dst_bin_id}, $params{chargenumber}, conv_date($params{bestbefore}), $params{comment}, $params{login}, $params{qty}, $trans_id);
372 }) or do { return $kannNichtFertigen };
374 $main::lxdebug->leave_sub();
375 return 1; # Alles erfolgreich
378 sub get_warehouse_journal {
379 $main::lxdebug->enter_sub();
384 my $myconfig = \%main::myconfig;
385 my $form = $main::form;
387 my $all_units = AM->retrieve_units($myconfig, $form);
389 # connect to database
390 my $dbh = $form->get_standard_dbh($myconfig);
393 my (@filter_ary, @filter_vars, $joins, %select_tokens, %select);
395 if ($filter{warehouse_id}) {
396 push @filter_ary, "w1.id = ? OR w2.id = ?";
397 push @filter_vars, $filter{warehouse_id}, $filter{warehouse_id};
400 if ($filter{bin_id}) {
401 push @filter_ary, "b1.id = ? OR b2.id = ?";
402 push @filter_vars, $filter{bin_id}, $filter{bin_id};
405 if ($filter{partnumber}) {
406 push @filter_ary, "p.partnumber ILIKE ?";
407 push @filter_vars, like($filter{partnumber});
410 if ($filter{description}) {
411 push @filter_ary, "(p.description ILIKE ?)";
412 push @filter_vars, like($filter{description});
415 if ($filter{classification_id}) {
416 push @filter_ary, "p.classification_id = ?";
417 push @filter_vars, $filter{classification_id};
420 if ($filter{chargenumber}) {
421 push @filter_ary, "i1.chargenumber ILIKE ?";
422 push @filter_vars, like($filter{chargenumber});
425 if (trim($form->{bestbefore})) {
426 push @filter_ary, "?::DATE = i1.bestbefore::DATE";
427 push @filter_vars, trim($form->{bestbefore});
430 if (trim($form->{fromdate})) {
431 push @filter_ary, "? <= i1.shippingdate";
432 push @filter_vars, trim($form->{fromdate});
435 if (trim($form->{todate})) {
436 push @filter_ary, "? >= i1.shippingdate";
437 push @filter_vars, trim($form->{todate});
440 if ($form->{l_employee}) {
444 # prepare qty comparison for later filtering
445 my ($f_qty_op, $f_qty, $f_qty_base_unit);
446 if ($filter{qty_op} && defined($filter{qty}) && $filter{qty_unit} && $all_units->{$filter{qty_unit}}) {
447 $f_qty_op = $filter{qty_op};
448 $f_qty = $filter{qty} * $all_units->{$filter{qty_unit}}->{factor};
449 $f_qty_base_unit = $all_units->{$filter{qty_unit}}->{base_unit};
452 map { $_ = "(${_})"; } @filter_ary;
454 # if of a property number or description is requested,
455 # automatically check the matching id too.
456 map { $form->{"l_${_}id"} = "Y" if ($form->{"l_${_}description"} || $form->{"l_${_}number"}); } qw(warehouse bin);
458 # customize shown entry for not available fields.
459 $filter{na} = '-' unless $filter{na};
461 # make order, search in $filter and $form
462 my $sort_col = $form->{sort};
463 my $sort_order = $form->{order};
465 $sort_col = $filter{sort} unless $sort_col;
466 $sort_col = 'shippingdate' if $sort_col eq 'date';
467 $sort_order = ($sort_col = 'shippingdate') unless $sort_col;
470 'shippingdate' => ['shippingdate', 'r_itime', 'r_parts_id'],
471 'bin_to' => ['bin_to', 'r_itime', 'r_parts_id'],
472 'bin_from' => ['bin_from', 'r_itime', 'r_parts_id'],
473 'warehouse_to' => ['warehouse_to, r_itime, r_parts_id'],
474 'warehouse_from' => ['warehouse_from, r_itime, r_parts_id'],
475 'partnumber' => ['partnumber'],
476 'partdescription'=> ['partdescription'],
477 'partunit' => ['partunit, r_itime, r_parts_id'],
478 'qty' => ['qty, r_itime, r_parts_id'],
479 'oe_id' => ['oe_id'],
480 'comment' => ['comment'],
481 'trans_type' => ['trans_type'],
482 'employee' => ['employee'],
483 'projectnumber' => ['projectnumber'],
484 'chargenumber' => ['chargenumber'],
487 $sort_order = $filter{order} unless $sort_order;
488 my $ASC = ($sort_order ? " DESC" : " ASC");
489 my $sort_spec = join("$ASC , ", @{$orderspecs{$sort_col}}). " $ASC";
491 my $where_clause = @filter_ary ? join(" AND ", @filter_ary) . " AND " : '';
493 $select_tokens{'trans'} = {
494 "parts_id" => "i1.parts_id",
495 "qty" => "ABS(SUM(i1.qty))",
496 "partnumber" => "p.partnumber",
497 "partdescription" => "p.description",
498 "classification_id" => "p.classification_id",
499 "part_type" => "p.part_type",
500 "bindescription" => "b.description",
501 "chargenumber" => "i1.chargenumber",
502 "bestbefore" => "i1.bestbefore",
503 "warehousedescription" => "w.description",
504 "partunit" => "p.unit",
505 "bin_from" => "b1.description",
506 "bin_to" => "b2.description",
507 "warehouse_from" => "w1.description",
508 "warehouse_to" => "w2.description",
509 "comment" => "i1.comment",
510 "trans_type" => "tt.description",
511 "trans_id" => "i1.trans_id",
513 "oe_id" => "COALESCE(i1.oe_id, i2.oe_id)",
514 "invoice_id" => "COALESCE(i1.invoice_id, i2.invoice_id)",
515 "date" => "i1.shippingdate",
516 "itime" => "i1.itime",
517 "shippingdate" => "i1.shippingdate",
518 "employee" => "e.name",
519 "projectnumber" => "COALESCE(pr.projectnumber, '$filter{na}')",
522 $select_tokens{'out'} = {
523 "bin_to" => "'$filter{na}'",
524 "warehouse_to" => "'$filter{na}'",
527 $select_tokens{'in'} = {
528 "bin_from" => "'$filter{na}'",
529 "warehouse_from" => "'$filter{na}'",
532 $form->{l_classification_id} = 'Y';
533 $form->{l_trans_id} = 'Y';
534 $form->{l_part_type} = 'Y';
535 $form->{l_itime} = 'Y';
536 $form->{l_invoice_id} = $form->{l_oe_id} if $form->{l_oe_id};
538 # build the select clauses.
539 # take all the requested ones from the first hash and overwrite them from the out/in hashes if present.
540 for my $i ('trans', 'out', 'in') {
541 $select{$i} = join ', ', map { +/^l_/; ($select_tokens{$i}{"$'"} || $select_tokens{'trans'}{"$'"}) . " AS r_$'" }
542 ( grep( { !/qty$/ and /^l_/ and $form->{$_} eq 'Y' } keys %$form), qw(l_parts_id l_qty l_partunit l_shippingdate) );
545 my $group_clause = join ", ", map { +/^l_/; "r_$'" }
546 ( grep( { !/qty$/ and /^l_/ and $form->{$_} eq 'Y' } keys %$form), qw(l_parts_id l_partunit l_shippingdate l_itime) );
548 $where_clause = defined($where_clause) ? $where_clause : '';
552 SELECT DISTINCT $select{out}
554 LEFT JOIN inventory i2 ON i1.trans_id = i2.trans_id AND i1.id = i2.id
555 LEFT JOIN parts p ON i1.parts_id = p.id
556 LEFT JOIN bin b1 ON i1.bin_id = b1.id
557 LEFT JOIN bin b2 ON i2.bin_id = b2.id
558 LEFT JOIN warehouse w1 ON i1.warehouse_id = w1.id
559 LEFT JOIN warehouse w2 ON i2.warehouse_id = w2.id
560 LEFT JOIN transfer_type tt ON i1.trans_type_id = tt.id
561 LEFT JOIN project pr ON i1.project_id = pr.id
562 LEFT JOIN employee e ON i1.employee_id = e.id
563 WHERE $where_clause i1.qty != 0 AND tt.direction = 'out' AND
564 i1.trans_id IN ( SELECT i.trans_id FROM inventory i GROUP BY i.trans_id HAVING COUNT(i.trans_id) >= 1 )
565 GROUP BY $group_clause
569 SELECT DISTINCT $select{in}
571 LEFT JOIN inventory i2 ON i1.trans_id = i2.trans_id AND i1.id = i2.id
572 LEFT JOIN parts p ON i1.parts_id = p.id
573 LEFT JOIN bin b1 ON i1.bin_id = b1.id
574 LEFT JOIN bin b2 ON i2.bin_id = b2.id
575 LEFT JOIN warehouse w1 ON i1.warehouse_id = w1.id
576 LEFT JOIN warehouse w2 ON i2.warehouse_id = w2.id
577 LEFT JOIN transfer_type tt ON i1.trans_type_id = tt.id
578 LEFT JOIN project pr ON i1.project_id = pr.id
579 LEFT JOIN employee e ON i1.employee_id = e.id
580 WHERE $where_clause i1.qty != 0 AND tt.direction = 'in' AND
581 i1.trans_id IN ( SELECT i.trans_id FROM inventory i GROUP BY i.trans_id HAVING COUNT(i.trans_id) >= 1 )
582 GROUP BY $group_clause
583 ORDER BY r_${sort_spec}) AS lines WHERE r_qty != 0|;
585 my @all_vars = (@filter_vars,@filter_vars);
587 if ($filter{limit}) {
588 $query .= " LIMIT ?";
589 push @all_vars,$filter{limit};
591 if ($filter{offset}) {
592 $query .= " OFFSET ?";
593 push @all_vars, $filter{offset};
596 my $sth = prepare_execute_query($form, $dbh, $query, @all_vars);
598 my ($h_oe_id, $q_oe_id);
599 if ($form->{l_oe_id}) {
601 SELECT dord.id AS id, dord.donumber AS number,
603 WHEN dord.customer_id IS NULL THEN 'purchase_delivery_order'
604 ELSE 'sales_delivery_order'
606 FROM delivery_orders dord
611 SELECT ar.id AS id, ar.invnumber AS number, 'sales_invoice' AS type
613 WHERE ar.id = (SELECT trans_id FROM invoice WHERE id = ?)
617 SELECT ap.id AS id, ap.invnumber AS number, 'purchase_invoice' AS type
619 WHERE ap.id = (SELECT trans_id FROM invoice WHERE id = ?)
621 $h_oe_id = prepare_query($form, $dbh, $q_oe_id);
625 while (my $ref = $sth->fetchrow_hashref("NAME_lc")) {
626 map { /^r_/; $ref->{"$'"} = $ref->{$_} } keys %$ref;
627 my $qty = $ref->{"qty"} * 1;
629 next unless ($qty > 0);
632 my $part_unit = $all_units->{$ref->{"partunit"}};
633 next unless ($part_unit && ($part_unit->{"base_unit"} eq $f_qty_base_unit));
634 $qty *= $part_unit->{"factor"};
635 next if (('=' eq $f_qty_op) && ($qty != $f_qty));
636 next if (('>=' eq $f_qty_op) && ($qty < $f_qty));
637 next if (('<=' eq $f_qty_op) && ($qty > $f_qty));
640 if ($h_oe_id && ($ref->{oe_id} || $ref->{invoice_id})) {
641 do_statement($form, $h_oe_id, $q_oe_id, $ref->{oe_id}, ($ref->{invoice_id}) x 2);
642 $ref->{oe_id_info} = $h_oe_id->fetchrow_hashref() || {};
645 push @contents, $ref;
649 $h_oe_id->finish() if $h_oe_id;
651 $main::lxdebug->leave_sub();
657 # This sub is the primary function to retrieve information about items in warehouses.
658 # $filter is a hashref and supports the following keys:
659 # - warehouse_id - will return matches with this warehouse_id only
660 # - partnumber - will return only matches where the given string is a substring of the partnumber
661 # - partsid - will return matches with this parts_id only
662 # - classification_id - will return matches with this parts with this classification only
663 # - description - will return only matches where the given string is a substring of the description
664 # - chargenumber - will return only matches where the given string is a substring of the chargenumber
665 # - bestbefore - will return only matches with this bestbefore date
666 # - ean - will return only matches where the given string is a substring of the ean as stored in the table parts (article)
667 # - charge_ids - must be an arrayref. will return contents with these ids only
668 # - expires_in - will only return matches that expire within the given number of days
669 # will also add a column named 'has_expired' containing if the match has already expired or not
670 # - hazardous - will return matches with the flag hazardous only
671 # - oil - will return matches with the flag oil only
672 # - qty, qty_op - quantity filter (more info to come)
673 # - sort, order_by - sorting (more to come)
674 # - reservation - will provide an extra column containing the amount reserved of this match
675 # note: reservation flag turns off warehouse_* or bin_* information. both together don't make sense, since reserved info is stored separately
677 sub get_warehouse_report {
678 $main::lxdebug->enter_sub();
683 my $myconfig = \%main::myconfig;
684 my $form = $main::form;
686 my $all_units = AM->retrieve_units($myconfig, $form);
688 # connect to database
689 my $dbh = $form->get_standard_dbh($myconfig);
692 my (@filter_ary, @filter_vars, @wh_bin_filter_ary, @wh_bin_filter_vars);
694 delete $form->{include_empty_bins} unless ($form->{l_warehousedescription} || $form->{l_bindescription});
696 if ($filter{warehouse_id}) {
697 push @wh_bin_filter_ary, "w.id = ?";
698 push @wh_bin_filter_vars, $filter{warehouse_id};
701 if ($filter{bin_id}) {
702 push @wh_bin_filter_ary, "b.id = ?";
703 push @wh_bin_filter_vars, $filter{bin_id};
706 push @filter_ary, @wh_bin_filter_ary;
707 push @filter_vars, @wh_bin_filter_vars;
709 if ($filter{partnumber}) {
710 push @filter_ary, "p.partnumber ILIKE ?";
711 push @filter_vars, like($filter{partnumber});
714 if ($filter{classification_id}) {
715 push @filter_ary, "p.classification_id = ?";
716 push @filter_vars, $filter{classification_id};
719 if ($filter{description}) {
720 push @filter_ary, "p.description ILIKE ?";
721 push @filter_vars, like($filter{description});
724 if ($filter{partsid}) {
725 push @filter_ary, "p.id = ?";
726 push @filter_vars, $filter{partsid};
729 if ($filter{chargenumber}) {
730 push @filter_ary, "i.chargenumber ILIKE ?";
731 push @filter_vars, like($filter{chargenumber});
734 if (trim($form->{bestbefore})) {
735 push @filter_ary, "?::DATE = i.bestbefore::DATE";
736 push @filter_vars, trim($form->{bestbefore});
739 if ($filter{classification_id}) {
740 push @filter_ary, "p.classification_id = ?";
741 push @filter_vars, $filter{classification_id};
745 push @filter_ary, "p.ean ILIKE ?";
746 push @filter_vars, like($filter{ean});
749 if (trim($filter{date})) {
750 push @filter_ary, "i.shippingdate <= ?";
751 push @filter_vars, trim($filter{date});
753 if (!$filter{include_invalid_warehouses}){
754 push @filter_ary, "NOT (w.invalid)";
757 # prepare qty comparison for later filtering
758 my ($f_qty_op, $f_qty, $f_qty_base_unit);
760 if ($filter{qty_op} && defined $filter{qty} && $filter{qty_unit} && $all_units->{$filter{qty_unit}}) {
761 $f_qty_op = $filter{qty_op};
762 $f_qty = $filter{qty} * $all_units->{$filter{qty_unit}}->{factor};
763 $f_qty_base_unit = $all_units->{$filter{qty_unit}}->{base_unit};
766 map { $_ = "(${_})"; } @filter_ary;
768 # if of a property number or description is requested,
769 # automatically check the matching id too.
770 map { $form->{"l_${_}id"} = "Y" if ($form->{"l_${_}description"} || $form->{"l_${_}number"}); } qw(warehouse bin);
772 # make order, search in $filter and $form
773 my $sort_col = $form->{sort};
774 my $sort_order = $form->{order};
776 $sort_col = $filter{sort} unless $sort_col;
777 # falls $sort_col gar nicht in dem Bericht aufgenommen werden soll,
778 # führt ein entsprechenes order by $sort_col zu einem SQL-Fehler
779 # entsprechend parts_id als default lassen, wenn $sort_col UND l_$sort_col
780 # vorhanden sind (bpsw. l_partnumber = 'Y', für in Bericht aufnehmen).
781 # S.a. Bug 1597 jb 12.5.2011
782 $sort_col = "parts_id" unless ($sort_col && $form->{"l_$sort_col"});
783 $sort_order = $filter{order} unless $sort_order;
784 $sort_col =~ s/ASC|DESC//; # kill stuff left in from previous queries
785 my $orderby = $sort_col;
786 my $sort_spec = "${sort_col} " . ($sort_order ? " DESC" : " ASC");
788 my $where_clause = join " AND ", ("1=1", @filter_ary);
790 my %select_tokens = (
791 "parts_id" => "i.parts_id",
792 "qty" => "SUM(i.qty)",
793 "warehouseid" => "i.warehouse_id",
794 "partnumber" => "p.partnumber",
795 "partdescription" => "p.description",
796 "classification_id" => "p.classification_id",
797 "part_type" => "p.part_type",
798 "bindescription" => "b.description",
800 "chargenumber" => "i.chargenumber",
801 "bestbefore" => "i.bestbefore",
803 "chargeid" => "c.id",
804 "warehousedescription" => "w.description",
805 "partunit" => "p.unit",
806 "stock_value" => ($form->{stock_value_basis} // '') eq 'list_price' ? "p.listprice / COALESCE(pfac.factor, 1)" : "p.lastcost / COALESCE(pfac.factor, 1)",
807 "purchase_price" => "p.lastcost",
808 "list_price" => "p.listprice",
810 $form->{l_classification_id} = 'Y';
811 $form->{l_part_type} = 'Y';
813 my $select_clause = join ', ', map { +/^l_/; "$select_tokens{$'} AS $'" }
814 ( grep( { !/qty/ and /^l_/ and $form->{$_} eq 'Y' } keys %$form),
815 qw(l_parts_id l_qty l_partunit) );
817 my $group_clause = join ", ", map { +/^l_/; "$'" }
818 ( grep( { !/qty/ and /^l_/ and $form->{$_} eq 'Y' } keys %$form),
819 qw(l_parts_id l_partunit) );
822 "stock_value" => "LEFT JOIN price_factors pfac ON (p.price_factor_id = pfac.id)",
825 my $joins = join ' ', grep { $_ } map { +/^l_/; $join_tokens{"$'"} }
826 ( grep( { !/qty/ and /^l_/ and $form->{$_} eq 'Y' } keys %$form),
827 qw(l_parts_id l_qty l_partunit) );
830 qq|SELECT * FROM ( SELECT $select_clause
832 LEFT JOIN parts p ON i.parts_id = p.id
833 LEFT JOIN bin b ON i.bin_id = b.id
834 LEFT JOIN warehouse w ON i.warehouse_id = w.id
837 GROUP BY $group_clause
838 ORDER BY $sort_spec ) AS lines WHERE qty<>0|;
840 if ($filter{limit}) {
841 $query .= " LIMIT ?";
842 push @filter_vars,$filter{limit};
844 if ($filter{offset}) {
845 $query .= " OFFSET ?";
846 push @filter_vars, $filter{offset};
848 my $sth = prepare_execute_query($form, $dbh, $query, @filter_vars );
850 my (%non_empty_bins, @all_fields, @contents);
852 while (my $ref = $sth->fetchrow_hashref("NAME_lc")) {
854 my $qty = $ref->{qty};
856 next unless ($qty != 0);
859 my $part_unit = $all_units->{$ref->{partunit}};
860 next if (!$part_unit || ($part_unit->{base_unit} ne $f_qty_base_unit));
861 $qty *= $part_unit->{factor};
862 next if (('=' eq $f_qty_op) && ($qty != $f_qty));
863 next if (('>=' eq $f_qty_op) && ($qty < $f_qty));
864 next if (('<=' eq $f_qty_op) && ($qty > $f_qty));
867 if ($form->{include_empty_bins}) {
868 $non_empty_bins{$ref->{binid}} = 1;
869 @all_fields = keys %{ $ref } unless (@all_fields);
872 $ref->{stock_value} = ($ref->{stock_value} || 0) * $ref->{qty};
874 push @contents, $ref;
879 if ($form->{include_empty_bins}) {
882 w.id AS warehouseid, w.description AS warehousedescription,
883 b.id AS binid, b.description AS bindescription
885 LEFT JOIN warehouse w ON (b.warehouse_id = w.id)|;
887 @filter_ary = @wh_bin_filter_ary;
888 @filter_vars = @wh_bin_filter_vars;
890 my @non_empty_bin_ids = keys %non_empty_bins;
891 if (@non_empty_bin_ids) {
892 push @filter_ary, qq|NOT b.id IN (| . join(', ', map { '?' } @non_empty_bin_ids) . qq|)|;
893 push @filter_vars, @non_empty_bin_ids;
896 $query .= qq| WHERE | . join(' AND ', map { "($_)" } @filter_ary) if (@filter_ary);
898 $sth = prepare_execute_query($form, $dbh, $query, @filter_vars);
900 while (my $ref = $sth->fetchrow_hashref()) {
901 map { $ref->{$_} ||= "" } @all_fields;
902 push @contents, $ref;
906 if (grep { $orderby eq $_ } qw(bindescription warehousedescription)) {
907 @contents = sort { ($a->{$orderby} cmp $b->{$orderby}) * (($form->{order}) ? 1 : -1) } @contents;
911 $main::lxdebug->leave_sub();
917 $main::lxdebug->enter_sub();
919 my ($self, $qty_op) = @_;
921 if (!$qty_op || ($qty_op eq "dontcare")) {
922 $main::lxdebug->leave_sub();
926 if ($qty_op eq "atleast") {
928 } elsif ($qty_op eq "atmost") {
934 $main::lxdebug->leave_sub();
939 sub retrieve_transfer_types {
940 $main::lxdebug->enter_sub();
943 my $direction = shift;
945 my $myconfig = \%main::myconfig;
946 my $form = $main::form;
948 my $dbh = $form->get_standard_dbh($myconfig);
950 my $types = selectall_hashref_query($form, $dbh, qq|SELECT * FROM transfer_type WHERE direction = ? ORDER BY sortkey|, $direction);
952 $main::lxdebug->leave_sub();
957 sub get_basic_bin_info {
958 $main::lxdebug->enter_sub();
963 Common::check_params(\%params, qw(id));
965 my $myconfig = \%main::myconfig;
966 my $form = $main::form;
968 my $dbh = $params{dbh} || $form->get_standard_dbh();
970 my @ids = 'ARRAY' eq ref $params{id} ? @{ $params{id} } : ($params{id});
973 qq|SELECT b.id AS bin_id, b.description AS bin_description,
974 w.id AS warehouse_id, w.description AS warehouse_description
976 LEFT JOIN warehouse w ON (b.warehouse_id = w.id)
977 WHERE b.id IN (| . join(', ', ('?') x scalar(@ids)) . qq|)|;
979 my $result = selectall_hashref_query($form, $dbh, $query, map { conv_i($_) } @ids);
981 if ('' eq ref $params{id}) {
982 $result = $result->[0] || { };
983 $main::lxdebug->leave_sub();
988 $main::lxdebug->leave_sub();
990 return map { $_->{bin_id} => $_ } @{ $result };
993 sub get_basic_warehouse_info {
994 $main::lxdebug->enter_sub();
999 Common::check_params(\%params, qw(id));
1001 my $myconfig = \%main::myconfig;
1002 my $form = $main::form;
1004 my $dbh = $params{dbh} || $form->get_standard_dbh();
1006 my @ids = 'ARRAY' eq ref $params{id} ? @{ $params{id} } : ($params{id});
1009 qq|SELECT w.id AS warehouse_id, w.description AS warehouse_description
1011 WHERE w.id IN (| . join(', ', ('?') x scalar(@ids)) . qq|)|;
1013 my $result = selectall_hashref_query($form, $dbh, $query, map { conv_i($_) } @ids);
1015 if ('' eq ref $params{id}) {
1016 $result = $result->[0] || { };
1017 $main::lxdebug->leave_sub();
1022 $main::lxdebug->leave_sub();
1024 return map { $_->{warehouse_id} => $_ } @{ $result };
1027 # Eingabe: Teilenummer, Lagernummer (warehouse)
1028 # Ausgabe: Die maximale Anzahl der Teile in diesem Lager
1030 sub get_max_qty_parts {
1031 $main::lxdebug->enter_sub();
1036 Common::check_params(\%params, qw(parts_id warehouse_id)); #die brauchen wir
1038 my $myconfig = \%main::myconfig;
1039 my $form = $main::form;
1041 my $dbh = $params{dbh} || $form->get_standard_dbh();
1043 my $query = qq| SELECT SUM(qty), bin_id, chargenumber, bestbefore FROM inventory where parts_id = ? AND warehouse_id = ? GROUP BY bin_id, chargenumber, bestbefore|;
1044 my $sth_QTY = prepare_execute_query($form, $dbh, $query, ,$params{parts_id}, $params{warehouse_id}); #info: aufruf an DBUtils.pm
1047 my $max_qty_parts = 0; #Initialisierung mit 0
1048 while (my $ref = $sth_QTY->fetchrow_hashref()) { # wir laufen über alle Haltbarkeiten, chargen und Lagerorte (s.a. SQL-Query oben)
1049 $max_qty_parts += $ref->{sum};
1052 $main::lxdebug->leave_sub();
1054 return $max_qty_parts;
1058 # Eingabe: Teilenummer, Lagernummer (warehouse)
1059 # Ausgabe: Die Beschreibung der Ware bzw. Erzeugnis
1061 sub get_part_description {
1062 $main::lxdebug->enter_sub();
1067 Common::check_params(\%params, qw(parts_id)); #die brauchen wir
1069 my $myconfig = \%main::myconfig;
1070 my $form = $main::form;
1072 my $dbh = $params{dbh} || $form->get_standard_dbh();
1074 my $query = qq| SELECT partnumber, description FROM parts where id = ? |;
1076 my $sth = prepare_execute_query($form, $dbh, $query, ,$params{parts_id}); #info: aufruf zu DBUtils.pm
1078 my $ref = $sth->fetchrow_hashref();
1079 my $part_description = $ref->{partnumber} . " " . $ref->{description};
1081 $main::lxdebug->leave_sub();
1083 return $part_description;
1086 # Eingabe: Teilenummer, Lagerplatz_Id (bin_id)
1087 # Ausgabe: Die maximale Anzahl der Teile in diesem Lagerplatz
1088 # Bzw. Fehler, falls Chargen oder bestbefore
1089 # bei eingelagerten Teilen definiert sind.
1091 sub get_max_qty_parts_bin {
1092 $main::lxdebug->enter_sub();
1097 Common::check_params(\%params, qw(parts_id bin_id)); #die brauchen wir
1099 my $myconfig = \%main::myconfig;
1100 my $form = $main::form;
1102 my $dbh = $params{dbh} || $form->get_standard_dbh();
1104 my $query = qq| SELECT SUM(qty), chargenumber, bestbefore FROM inventory where parts_id = ?
1105 AND bin_id = ? GROUP BY chargenumber, bestbefore|;
1107 my $sth_QTY = prepare_execute_query($form, $dbh, $query, ,$params{parts_id}, $params{bin_id}); #info: aufruf an DBUtils.pm
1109 my $max_qty_parts = 0; #Initialisierung mit 0
1110 # falls derselbe artikel mehrmals eingelagert ist
1111 # chargennummer, muss entsprechend händisch agiert werden
1114 while (my $ref = $sth_QTY->fetchrow_hashref()) { # wir laufen über alle Haltbarkeiten und Chargen(s.a. SQL-Query oben)
1115 $max_qty_parts += $ref->{sum};
1117 if (($ref->{chargenumber} || $ref->{bestbefore}) && $ref->{sum} != 0){
1121 $main::lxdebug->leave_sub();
1123 return ($max_qty_parts, $error);
1126 sub get_wh_and_bin_for_charge {
1127 $main::lxdebug->enter_sub();
1133 croak t8('Need charge number!') unless $params{chargenumber};
1135 my $inv_items = SL::DB::Manager::Inventory->get_all(where => [chargenumber => $params{chargenumber} ]);
1137 croak t8("Invalid charge number: #1", $params{chargenumber}) unless (ref @{$inv_items}[0] eq 'SL::DB::Inventory');
1138 # add all qty for one bin and add wh_id
1139 ($bin_qty{$_->bin_id}{qty}, $bin_qty{$_->bin_id}{wh}) = ($bin_qty{$_->bin_id}{qty} + $_->qty, $_->warehouse_id) for @{ $inv_items };
1141 while (my ($bin, $value) = each (%bin_qty)) {
1142 if ($value->{qty} > 0) {
1143 $main::lxdebug->leave_sub();
1144 return ($value->{qty}, $value->{wh}, $bin, $params{chargenumber});
1148 $main::lxdebug->leave_sub();
1157 SL::WH - Warehouse backend
1162 WH->transfer(\%params);
1166 Backend for kivitendo warehousing functions.
1170 =head2 transfer \%PARAMS, [ \%PARAMS, ... ]
1172 This is the main function to manipulate warehouse contents. A typical transfer
1173 is called like this:
1178 transfer_type => 'transfer',
1179 src_warehouse_id => 12,
1181 dst_warehouse_id => 25,
1185 It will generate an entry in inventory representing the transfer. Note that
1186 parts_id, qty, and transfer_type are mandatory. Depending on the transfer_type
1187 a destination or a src is mandatory.
1189 transfer accepts more than one transaction parameter, each being a hash ref. If
1190 more than one is supplied, it is guaranteed, that all are processed in the same
1193 It is possible to record stocktakings within this transaction as well.
1194 This is useful if the transfer is the result of stocktaking (see also
1195 C<SL::Controller::Inventory>). To do so the parameters C<record_stocktaking>,
1196 C<stocktaking_qty> and C<stocktaking_cutoff_date> hava to be given.
1197 If stocktaking should be saved, then the transfer quantity can be zero. In this
1198 case no entry in inventory will be made, but only the stocktaking entry.
1200 Here is a full list of parameters. All "_id" parameters except oe and
1201 orderitems can be called without id with RDB objects as well.
1207 The id of the article transferred. Does not check if the article is a service.
1212 Quantity of the transaction. Mandatory.
1216 Unit of the transaction. Optional.
1220 =item transfer_type_id
1222 The type of transaction. The first version is a string describing the
1223 transaction (the types 'transfer' 'in' 'out' and a few others are present on
1224 every system), the id is the hard id of a transfer_type from the database.
1226 Depending of the direction of the transfer_type, source and/or destination must
1229 One of transfer_type or transfer_type_id is mandatory.
1231 =item src_warehouse_id
1235 Warehouse and bin from which to transfer. Mandatory in transfer and out
1236 directions. Ignored in in directions.
1238 =item dst_warehouse_id
1242 Warehouse and bin to which to transfer. Mandatory in transfer and in
1243 directions. Ignored in out directions.
1247 If given, the transfer will transfer only articles with this chargenumber.
1252 Reference to an orderitem for which this transfer happened. Optional
1256 Reference to an order for which this transfer happened. Optional
1260 An optional comment.
1264 An expiration date. Note that this is not by default used by C<warehouse_report>.
1266 =item record_stocktaking
1268 A boolean flag to indicate that a stocktaking entry should be saved.
1270 =item stocktaking_qty
1272 The quantity for the stocktaking entry.
1274 =item stocktaking_cutoff_date
1276 The cutoff date for the stocktaking entry.
1280 =head2 create_assembly \%PARAMS, [ \%PARAMS, ... ]
1282 Creates an assembly if all defined items are available.
1284 Assembly item(s) will be stocked out and the assembly will be stocked in,
1285 taking into account the qty and units which can be defined for each
1286 assembly item separately.
1288 The calling params originate from C<transfer> but only parts_id with the
1289 attribute assembly are processed.
1291 The typical params would be:
1294 'login' => $::myconfig{login},
1295 'dst_warehouse_id' => $form->{warehouse_id},
1296 'dst_bin_id' => $form->{bin_id},
1297 'chargenumber' => $form->{chargenumber},
1298 'bestbefore' => $form->{bestbefore},
1299 'assembly_id' => $form->{parts_id},
1300 'qty' => $form->{qty},
1301 'comment' => $form->{comment}
1305 =head2 get_wh_and_bin_for_charge C<$params{chargenumber}>
1307 Gets the current qty from the inventory entries with the mandatory chargenumber: C<$params{chargenumber}>.
1308 Croaks if the chargenumber is missing or no entry currently exists.
1309 If there is one bin and warehouse with a positive qty, this fields are returned:
1310 C<qty> C<warehouse_id>, C<bin_id>, C<chargenumber>.
1311 Otherwise returns undef.
1314 =head3 Prerequisites
1316 All of these prerequisites have to be trueish, otherwise the function will exit
1317 unsuccessfully with a return value of undef.
1321 =item Mandantory params
1323 assembly_id, qty, login, dst_warehouse_id and dst_bin_id are mandatory.
1325 =item Subset named 'Assembly' of data set 'Part'
1327 assembly_id has to be an id in the table parts with the valid subset assembly.
1329 =item Assembly is composed of assembly item(s)
1331 There has to be at least one data set in the table assembly referenced to this assembly_id.
1333 =item Assembly can be disassembled
1335 Assemblies are like cakes. You cannot disassemble it. NEVER.
1336 But if your assembly is a mechanical cake you may unscrew it.
1337 Assemblies are created in one transaction therefore you can
1338 safely rely on the trans_id in inventory to disassemble the
1339 created assemblies (see action disassemble_assembly in wh.pl).
1341 =item The assembly item(s) have to be in the same warehouse
1343 inventory.warehouse_id equals dst_warehouse_id (client configurable).
1345 =item The assembly item(s) have to be in stock with the qty needed
1347 I can only make a cake by receipt if I have ALL ingredients and
1348 in the needed stock amount.
1349 The qty of stocked in assembly item(s) has to fit into the
1350 number of the qty of the assemblies, which are going to be created (client configurable).
1352 =item assembly item(s) with the parts set 'service' are ignored
1354 The subset 'Services' of part will not transferred for assembly item(s).
1358 Client configurable prerequisites can be changed with different
1359 prerequisites as described in client_config (s.a. next chapter).
1362 =head2 default creation of assembly
1364 The valid state of the assembly item(s) used for the assembly process are
1365 'out' for the general direction and 'used' as the specific reason.
1366 The valid state of the assembly is 'in' for the direction and 'assembled'
1367 as the specific reason.
1369 The method is transaction safe, in case of errors not a single entry will be made
1372 Two prerequisites can be changed with these global parameters
1376 =item $::instance_conf->get_transfer_default_warehouse_for_assembly
1378 If trueish we try to get all the items form the default bins defined in parts
1379 and do not try to find them in the destination warehouse. Returns an
1380 error if not all items have set a default bin in parts.
1382 =item $::instance_conf->get_bin_id_ignore_onhand
1384 If trueish we can create assemblies even if we do not have enough items in stock.
1385 The needed qty will be booked in a special bin, which has to be configured in