2 /**********************************************************************
3 Copyright (C) FrontAccounting, LLC.
4 Released under the terms of the GNU General Public License, GPL,
5 as published by the Free Software Foundation, either version 3
6 of the License, or (at your option) any later version.
7 This program is distributed in the hope that it will be useful,
8 but WITHOUT ANY WARRANTY; without even the implied warranty of
9 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
10 See the License here <http://www.gnu.org/licenses/gpl-3.0.html>.
11 ***********************************************************************/
12 function get_qoh_on_date($stock_id, $location=null, $date_=null)
17 $date = date2sql($date_);
19 $sql = "SELECT SUM(qty) FROM ".TB_PREF."stock_moves
20 WHERE stock_id=".db_escape($stock_id)."
21 AND tran_date <= '$date'";
23 if ($location != null)
24 $sql .= " AND loc_code = ".db_escape($location);
26 $result = db_query($sql, "QOH calculation failed");
28 $myrow = db_fetch_row($result);
31 return $qoh ? $qoh : 0;
35 * Check whether change in stock on date would not cause negative qoh in stock history.
36 * Returns null on success or max. available quantity with respective date otherwise.
37 * Running balance is checked on daily basis only, as we do not control time of transaction.
39 * $delta_qty - tested change in stock qty at $date.
40 * $date - check date; when set to null checks all the stock history.
43 function check_negative_stock($stock_id, $delta_qty, $location=null, $date=null)
47 return null; // qty increese is always safe
52 $date = date2sql($date);
54 // check stock status on date
55 $sql = "SELECT SUM(qty) qty, '$date' tran_date FROM ".TB_PREF."stock_moves
56 WHERE stock_id=".db_escape($stock_id)."
57 AND tran_date <= '$date'";
60 $sql .= " AND loc_code = ".db_escape($location);
62 $result = db_query($sql, "QOH calculation failed");
63 $qos = db_fetch_assoc($result);
65 // check also all stock changes after the date to avoid negative stock in future
66 $sql = TB_PREF."stock_moves WHERE stock_id=".db_escape($stock_id) . " AND tran_date > '$date'";
69 $sql .= " AND loc_code=".db_escape($location);
71 $rt = running_total_sql($sql, 'qty', 'tran_date');
73 $sql = "SELECT {$qos['qty']}+total qty, tran_date FROM ($rt) stock_status ORDER by total, tran_date";
74 $history = db_query($sql, 'cannot check stock history');
75 $min_qos = db_fetch($history);
77 if ($min_qos && ($min_qos['qty'] < $qos['qty']))
80 return -$delta_qty > $qos['qty'] ? $qos : null;
83 //--------------------------------------------------------------------------------------
85 function get_item_edit_info($stock_id)
87 $sql = "SELECT material_cost + labour_cost + overhead_cost AS standard_cost, units, decimals
88 FROM ".TB_PREF."stock_master,".TB_PREF."item_units
89 WHERE stock_id=".db_escape($stock_id)
90 ." AND ".TB_PREF."stock_master.units=".TB_PREF."item_units.abbr";
91 $result = db_query($sql, "The standard cost cannot be retrieved");
93 return db_fetch($result);
96 //--------------------------------------------------------------------------------------
98 function get_standard_cost($stock_id)
100 $sql = "SELECT (material_cost + labour_cost + overhead_cost) AS std_cost
101 FROM ".TB_PREF."stock_master s WHERE stock_id=".db_escape($stock_id);
102 $result = db_query($sql, "The standard cost cannot be retrieved");
104 $myrow = db_fetch_row($result);
109 //--------------------------------------------------------------------------------------
111 function is_inventory_item($stock_id)
113 $sql = "SELECT stock_id FROM ".TB_PREF."stock_master
114 WHERE stock_id=".db_escape($stock_id)." AND mb_flag <> 'D'";
115 $result = db_query($sql, "Cannot query is inventory item or not");
117 return db_num_rows($result) > 0;
120 //-------------------------------------------------------------------
122 function last_negative_stock_begin_date($stock_id, $to)
127 $sql = "SET @flag = 0";
129 $sql = "SELECT SUM(qty), @q:= @q + qty, IF(@q < 0 AND @flag=0, @flag:=1,@flag:=0), IF(@q < 0 AND @flag=1, tran_date,'') AS begin_date
130 FROM ".TB_PREF."stock_moves
131 WHERE stock_id=".db_escape($stock_id)." AND tran_date<='$to'
133 GROUP BY stock_id ORDER BY tran_date";
135 $result = db_query($sql, "The dstock moves could not be retrieved");
136 $row = db_fetch_row($result);
140 //-------------------------------------------------------------------
142 function get_already_delivered($stock_id, $location, $trans_no)
144 $sql = "SELECT ".TB_PREF."stock_moves.qty
145 FROM ".TB_PREF."stock_moves
146 WHERE ".TB_PREF."stock_moves.stock_id = ".db_escape($stock_id)."
147 AND ".TB_PREF."stock_moves.loc_code = ".db_escape($location)."
148 AND type=".ST_CUSTDELIVERY." AND trans_no=".db_escape($trans_no);
149 $result = db_query($sql, "Could not get stock moves");
150 $row = db_fetch_row($result);
154 function last_negative_stock_trans_id($stock_id, $to)
156 $sql = "SELECT * from ".TB_PREF."stock_moves
157 WHERE stock_id=".db_escape($stock_id)."
158 AND qty <> 0 order by trans_id asc";
160 $result = db_query($sql, "The query on stock moves failed.");
164 $negative_trans_id = -1;
166 while ($myrow = db_fetch($result))
168 $qty += $myrow['qty'];
169 if ($qty < 0 && $flag == 0)
172 $negative_trans_id = $myrow['trans_id'];
179 return $negative_trans_id;
184 //-------------------------------------------------------------------
186 function get_deliveries_between($stock_id, $from, $to)
188 $from = date2sql($from);
190 $sql = "SELECT SUM(-qty), SUM(-qty*standard_cost) FROM ".TB_PREF."stock_moves
191 WHERE type=".ST_CUSTDELIVERY." AND stock_id=".db_escape($stock_id)." AND
192 tran_date>='$from' AND tran_date<='$to' GROUP BY stock_id";
194 $result = db_query($sql, "The deliveries could not be updated");
195 return db_fetch_row($result);
198 function get_deliveries_from_trans($stock_id, $from)
200 // -ve qty is delivery either by ST_CUSTDELIVERY or inventory adjustment
201 //Price for GRN and SUPPCREDIT and std_cost for other trans_types
202 $sql = "SELECT SUM(-qty), SUM(-qty*IF(type=".ST_SUPPRECEIVE." OR type=".ST_SUPPCREDIT.", price, standard_cost))
203 FROM ".TB_PREF."stock_moves
204 WHERE stock_id=".db_escape($stock_id)." AND qty < 0 AND
205 trans_id>='$from' GROUP BY stock_id";
206 $result = db_query($sql, "The deliveries could not be updated");
207 $row = db_fetch_row($result);
209 $sql = "SELECT IF(type=".ST_SUPPRECEIVE." OR type=".ST_SUPPCREDIT.", price, standard_cost)
210 FROM ".TB_PREF."stock_moves
211 WHERE stock_id=".db_escape($stock_id)
212 ." AND trans_id ='$from'";
213 $result = db_query($sql, "The deliveries could not be updated");
214 $cost = db_fetch_row($result);
216 // Adjusting QOH valuation
217 $sql = "SELECT SUM(qty) FROM ".TB_PREF."stock_moves
218 WHERE stock_id=".db_escape($stock_id)." AND
219 trans_id<'$from' GROUP BY stock_id";
220 $result = db_query($sql, "The deliveries could not be updated");
221 $qoh = db_fetch_row($result);
223 $qty = $row[0] - $qoh[0]; //QOH prior to -ve stock is subtracted
224 $final_cost = $row[1] - $qoh[0]*$cost[0];
226 return array($qty,$final_cost);
229 function get_purchases_from_trans($stock_id, $from)
231 // Calculate All inward stock moves i.e. qty > 0
232 $sql = "SELECT SUM(qty), SUM(qty*standard_cost) FROM ".TB_PREF."stock_moves
233 WHERE stock_id=".db_escape($stock_id)." AND qty > 0 AND
234 trans_id>'$from' GROUP BY stock_id";
235 $result = db_query($sql, "Could not get get_purchases_from_trans");
236 $row = db_fetch_row($result);
241 //-------------------------------------------------------------------
243 function adjust_deliveries($stock_id, $material_cost, $to)
245 if (!is_inventory_item($stock_id))
248 $from = last_negative_stock_trans_id($stock_id, $to);
249 if ($from == false || $from == -1)
252 $row = get_deliveries_from_trans($stock_id, $from);
256 $old_sales_cost = $row[1];
257 $new_sales_cost = $row[0] * $material_cost;
258 $sales_diff = $new_sales_cost - $old_sales_cost;
260 $row = get_purchases_from_trans($stock_id, $from);
262 $old_purchase_cost = 0;
265 $old_purchase_cost = $row[1];
266 $new_purchase_cost = $row[0] * $material_cost;
267 $purchase_diff = $new_purchase_cost - $old_purchase_cost;
270 $diff = $sales_diff - $purchase_diff;
274 $update_no = get_next_trans_no(ST_COSTUPDATE);
275 if (!is_date_in_fiscalyear($to))
276 $to = end_fiscalyear();
278 $stock_gl_code = get_stock_gl_code($stock_id);
280 $dec = user_price_dec();
281 $old_cost = -round2($old_sales_cost-$old_purchase_cost,$dec);
282 $new_cost = -round2($new_sales_cost-$new_purchase_cost,$dec);
284 $memo_ = sprintf(_("Cost was %s changed to %s x quantity on hand for item '%s'"),
285 number_format2($old_cost, 2), number_format2($new_cost, 2), $stock_id);
286 add_gl_trans_std_cost(ST_COSTUPDATE, $update_no, $to, $stock_gl_code["cogs_account"],
287 $stock_gl_code["dimension_id"], $stock_gl_code["dimension2_id"], $memo_, $diff);
289 add_gl_trans_std_cost(ST_COSTUPDATE, $update_no, $to, $stock_gl_code["inventory_account"], 0, 0, $memo_,
291 add_audit_trail(ST_COSTUPDATE, $update_no, $to);
295 function get_stock_gl_code($stock_id)
297 /*Gets the GL Codes relevant to the item account */
298 $sql = "SELECT mb_flag, inventory_account, cogs_account,
299 adjustment_account, sales_account, assembly_account, dimension_id, dimension2_id FROM
300 ".TB_PREF."stock_master WHERE stock_id = ".db_escape($stock_id);
302 $get = db_query($sql,"retreive stock gl code");
303 return db_fetch($get);
306 //-----------------------------------------------------------------------------------------
308 function handle_negative_inventory($stock_id, $quantity, $standard_cost, $date_)
310 //If negative adjustment result in negative or zero inventory
311 //then difference should be adjusted
312 $qoh = get_qoh_on_date($stock_id);
314 if ($qoh + $quantity <= 0 && $qoh > 0) //Positive inventory turning zero/negative
318 $id = get_next_trans_no(ST_JOURNAL);
319 $ref = $Refs->get_next(ST_JOURNAL);
320 $diff = round($qoh*get_standard_cost($stock_id) + $quantity*$standard_cost, user_price_dec());
324 $stock_gl_code = get_stock_gl_code($stock_id);
325 $memo = _("Zero/negative inventory handling");
326 //Reverse the inventory effect if $qoh <=0
327 add_gl_trans_std_cost(ST_JOURNAL, $id, $date_,
328 $stock_gl_code["inventory_account"],
329 $stock_gl_code['dimension_id'], $stock_gl_code['dimension2_id'], $memo,
331 //GL Posting to inventory adjustment account
332 add_gl_trans_std_cost(ST_JOURNAL, $id, $date_,
333 $stock_gl_code["adjustment_account"],
334 $stock_gl_code['dimension_id'], $stock_gl_code['dimension2_id'], $memo,
337 add_audit_trail(ST_JOURNAL, $id, $date_);
338 add_comments(ST_JOURNAL, $id, $date_, $memo);
339 $Refs->save(ST_JOURNAL, $id, $ref);
344 //--------------------------------------------------------------------------------------
346 // $date_ - display / non-sql date
347 // $std_cost - in HOME currency
348 // $show_or_hide - wil this move be visible in reports, etc
349 // $price - in $person_id's currency
351 function add_stock_move($type, $stock_id, $trans_no, $location,
352 $date_, $reference, $quantity, $std_cost, $person_id=0, $show_or_hide=1,
353 $price=0, $discount_percent=0, $error_msg="")
355 $date = date2sql($date_);
357 $sql = "INSERT INTO ".TB_PREF."stock_moves (stock_id, trans_no, type, loc_code,
358 tran_date, person_id, reference, qty, standard_cost, visible, price,
359 discount_percent) VALUES (".db_escape($stock_id)
360 .", ".db_escape($trans_no).", ".db_escape($type)
361 .", ".db_escape($location).", '$date', "
362 .db_escape($person_id).", ".db_escape($reference).", "
363 .db_escape($quantity).", ".db_escape($std_cost).","
364 .db_escape($show_or_hide).", "
365 .db_escape($price).", ".db_escape($discount_percent).")";
367 if ($error_msg == "")
368 $error_msg = "The stock movement record cannot be inserted";
370 db_query($sql, $error_msg);
372 return db_insert_id();
375 function update_stock_move($type, $trans_no, $stock_id, $cost)
377 $sql = "UPDATE ".TB_PREF."stock_moves SET standard_cost=".db_escape($cost)
378 ." WHERE type=".db_escape($type)
379 ." AND trans_no=".db_escape($trans_no)
380 ." AND stock_id=".db_escape($stock_id);
381 db_query($sql, "The stock movement standard_cost cannot be updated");
384 function update_stock_move_pid($type, $type_no, $stock_id, $pid, $cost)
386 $sql = "UPDATE ".TB_PREF."stock_moves SET standard_cost=".db_escape($cost)
387 ." WHERE type=".db_escape($type)
388 ." AND trans_no=".db_escape($type_no)
389 ." AND stock_id=".db_escape($stock_id)
390 ." AND person_id = ".db_escape($pid);
391 db_query($sql, "The stock movement standard_cost cannot be updated");
394 //--------------------------------------------------------------------------------------------------
396 function get_stock_moves($type, $type_no, $visible=false)
398 $sql = "SELECT ".TB_PREF."stock_moves.*, ".TB_PREF."stock_master.description, "
399 .TB_PREF."stock_master.units,".TB_PREF."locations.location_name,"
400 .TB_PREF."stock_master.material_cost + "
401 .TB_PREF."stock_master.labour_cost + "
402 .TB_PREF."stock_master.overhead_cost AS FixedStandardCost
403 FROM ".TB_PREF."stock_moves,".TB_PREF."locations,".TB_PREF."stock_master
404 WHERE ".TB_PREF."stock_moves.stock_id = ".TB_PREF."stock_master.stock_id
405 AND ".TB_PREF."locations.loc_code=".TB_PREF."stock_moves.loc_code
406 AND type=".db_escape($type)." AND trans_no=".db_escape($type_no)." ORDER BY trans_id";
408 $sql .= " AND ".TB_PREF."stock_moves.visible=1";
410 return db_query($sql, "Could not get stock moves");
413 //--------------------------------------------------------------------------------------------------
415 function void_stock_move($type, $type_no)
417 $sql = "SELECT * from ".TB_PREF."stock_moves WHERE type=".db_escape($type)." AND trans_no=".db_escape($type_no);
418 $result = db_query($sql, "Could not void stock moves");
419 while ($row = db_fetch($result))
421 //Skip cost averaging of service items
422 if (is_inventory_item($row["stock_id"]))
424 // The cost has to be adjusted.
425 // Transaction rates are stored either as price or standard_cost depending on types
426 $types = array(ST_SUPPCREDIT, ST_SUPPRECEIVE);
427 if (in_array($type, $types))
428 $unit_cost = $row["price"];
430 $unit_cost = $row["standard_cost"];
432 update_average_material_cost($row["person_id"], $row["stock_id"],
433 $unit_cost, -$row["qty"], sql2date($row["tran_date"]));
437 $sql = "DELETE FROM ".TB_PREF."stock_moves WHERE type=".db_escape($type)
438 ." AND trans_no=".db_escape($type_no);
439 db_query($sql, "The stock movement cannot be delated");
442 //--------------------------------------------------------------------------------------------------
444 function get_location_name($loc_code)
446 $sql = "SELECT location_name FROM ".TB_PREF."locations WHERE loc_code="
447 .db_escape($loc_code);
449 $result = db_query($sql, "could not retreive the location name for $loc_code");
451 if (db_num_rows($result) == 1)
453 $row = db_fetch_row($result);
457 display_db_error("could not retreive the location name for $loc_code", $sql, true);
460 //--------------------------------------------------------------------------------------------------