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_);
18 $sql = "SELECT SUM(qty)
19 FROM ".TB_PREF."stock_moves st
20 LEFT JOIN ".TB_PREF."voided v ON st.type=v.type AND st.trans_no=v.id
22 AND stock_id=".db_escape($stock_id)."
23 AND tran_date <= '$date'";
25 if ($location != null)
26 $sql .= " AND loc_code = ".db_escape($location);
28 $result = db_query($sql, "QOH calculation failed");
30 $myrow = db_fetch_row($result);
33 return $qoh ? $qoh : 0;
37 * Check whether change in stock on date would not cause negative qoh in stock history.
38 * Returns null on success or max. available quantity with respective date otherwise.
39 * Running balance is checked on daily basis only, as we do not control time of transaction.
41 * $delta_qty - tested change in stock qty at $date.
42 * $date - check date; when set to null checks all the stock history.
45 function check_negative_stock($stock_id, $delta_qty, $location=null, $date=null)
49 return null; // qty increese is always safe
54 $date = date2sql($date);
56 // check stock status on date
57 $sql = "SELECT SUM(qty) qty, '$date' tran_date FROM ".TB_PREF."stock_moves
58 WHERE stock_id=".db_escape($stock_id)."
59 AND tran_date <= '$date'";
62 $sql .= " AND loc_code = ".db_escape($location);
64 $result = db_query($sql, "QOH calculation failed");
65 $qos = db_fetch_assoc($result);
67 // check also all stock changes after the date to avoid negative stock in future
68 $sql = TB_PREF."stock_moves WHERE stock_id=".db_escape($stock_id) . " AND tran_date > '$date'";
71 $sql .= " AND loc_code=".db_escape($location);
73 $rt = running_total_sql($sql, 'qty', 'tran_date');
75 $sql = "SELECT {$qos['qty']}+total qty, tran_date FROM ($rt) stock_status ORDER by total, tran_date";
76 $history = db_query($sql, 'cannot check stock history');
77 $min_qos = db_fetch($history);
79 if ($min_qos && ($min_qos['qty'] < $qos['qty']))
82 return -$delta_qty > $qos['qty'] ? $qos : null;
85 //--------------------------------------------------------------------------------------
87 function get_item_edit_info($stock_id)
89 $sql = "SELECT item.material_cost, item.units, unit.decimals
90 FROM ".TB_PREF."stock_master item,"
91 .TB_PREF."item_units unit
92 WHERE stock_id=".db_escape($stock_id)
93 ." AND item.units=unit.abbr";
94 $result = db_query($sql, "The standard cost cannot be retrieved");
96 $row = db_fetch($result);
97 if (is_array($row) && $row['decimals'] == -1)
98 $row['decimals'] = user_qty_dec();
102 //--------------------------------------------------------------------------------------
104 function get_unit_cost($stock_id)
106 $sql = "SELECT material_cost
107 FROM ".TB_PREF."stock_master
108 WHERE stock_id=".db_escape($stock_id);
109 $result = db_query($sql, "The standard cost cannot be retrieved");
111 $myrow = db_fetch_row($result);
113 return is_array($myrow) ? $myrow[0] : false;
116 //--------------------------------------------------------------------------------------
118 function get_purchase_cost($stock_id)
120 $sql = "SELECT purchase_cost
121 FROM ".TB_PREF."stock_master
122 WHERE stock_id=".db_escape($stock_id);
123 $result = db_query($sql, "The purchase cost cannot be retrieved");
125 $myrow = db_fetch_row($result);
127 return is_array($myrow) ? $myrow[0] : false;
130 //--------------------------------------------------------------------------------------
132 function is_inventory_item($stock_id)
134 $sql = "SELECT stock_id FROM "
135 .TB_PREF."stock_master
136 WHERE stock_id=".db_escape($stock_id)." AND mb_flag <> 'D'";
137 $result = db_query($sql, "Cannot query is inventory item or not");
139 return db_num_rows($result) > 0;
142 //-------------------------------------------------------------------
144 function last_negative_stock_begin_date($stock_id, $to)
149 $sql = "SET @flag = 0";
151 $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
152 FROM ".TB_PREF."stock_moves
153 WHERE stock_id=".db_escape($stock_id)." AND tran_date<='$to'
155 GROUP BY stock_id ORDER BY tran_date";
157 $result = db_query($sql, "The dstock moves could not be retrieved");
158 $row = db_fetch_row($result);
162 //-------------------------------------------------------------------
164 function get_already_delivered($stock_id, $location, $trans_no)
167 FROM ".TB_PREF."stock_moves
168 WHERE stock_id = ".db_escape($stock_id)."
169 AND loc_code = ".db_escape($location)."
170 AND type=".ST_CUSTDELIVERY." AND trans_no=".db_escape($trans_no);
171 $result = db_query($sql, "Could not get stock moves");
172 $row = db_fetch_row($result);
173 return is_array($row) ? $row[0] : false;
176 Returns start move_id in latest negative status period for $stock_id
179 function last_negative_stock_trans_id($stock_id, $to)
181 $sql = "SELECT * from ".TB_PREF."stock_moves
182 WHERE stock_id=".db_escape($stock_id)."
183 AND qty <> 0 order by trans_id asc";
185 $result = db_query($sql, "The query on stock moves failed.");
189 $negative_trans_id = -1;
191 while ($myrow = db_fetch($result))
193 $qty += $myrow['qty'];
194 if ($qty < 0 && $flag == 0)
197 $negative_trans_id = $myrow['trans_id'];
204 return $negative_trans_id;
209 //-------------------------------------------------------------------
211 function get_deliveries_between($stock_id, $from, $to)
213 $from = date2sql($from);
215 $sql = "SELECT SUM(-qty), SUM(-qty*standard_cost) FROM ".TB_PREF."stock_moves
216 WHERE type=".ST_CUSTDELIVERY." AND stock_id=".db_escape($stock_id)." AND
217 tran_date>='$from' AND tran_date<='$to' GROUP BY stock_id";
219 $result = db_query($sql, "The deliveries could not be updated");
220 return db_fetch_row($result);
224 Returns quantity and total cost of $stock_id sales, entered after record with $move_id
226 function get_deliveries_from_trans($stock_id, $move_id)
228 // -ve qty is delivery either by ST_CUSTDELIVERY or inventory adjustment
229 //Price for GRN and SUPPCREDIT and std_cost for other trans_types
230 $sql = "SELECT SUM(-qty), SUM(-qty*IF(type=".ST_SUPPRECEIVE." OR type=".ST_SUPPCREDIT.", price, standard_cost))
231 FROM ".TB_PREF."stock_moves
232 WHERE stock_id=".db_escape($stock_id)." AND qty < 0 AND
233 trans_id>='$move_id' GROUP BY stock_id";
234 $result = db_query($sql, "The deliveries could not be updated");
235 $row = db_fetch_row($result);
237 $sql = "SELECT IF(type=".ST_SUPPRECEIVE." OR type=".ST_SUPPCREDIT.", price, standard_cost)
238 FROM ".TB_PREF."stock_moves
239 WHERE stock_id=".db_escape($stock_id)
240 ." AND trans_id ='$move_id'";
241 $result = db_query($sql, "The deliveries could not be updated");
242 $cost = db_fetch_row($result);
244 // Adjusting QOH valuation
245 $sql = "SELECT SUM(qty)
246 FROM ".TB_PREF."stock_moves
247 WHERE stock_id=".db_escape($stock_id)." AND
248 trans_id<'$move_id' GROUP BY stock_id";
249 $result = db_query($sql, "The deliveries could not be updated");
250 $qoh = db_fetch_row($result);
252 $qty = $row[0] - $qoh[0]; //QOH prior to -ve stock is subtracted
253 $final_cost = $row[1] - $qoh[0]*$cost[0];
255 return array($qty,$final_cost);
259 Returns quantity and total cost of $stock_id purchases, entered after record with $move_id
261 function get_purchases_from_trans($stock_id, $move_id)
263 // Calculate All inward stock moves i.e. qty > 0
264 $sql = "SELECT SUM(qty), SUM(qty*standard_cost)
265 FROM ".TB_PREF."stock_moves
266 WHERE stock_id=".db_escape($stock_id)." AND qty > 0 AND
267 trans_id>'$move_id' GROUP BY stock_id";
268 $result = db_query($sql, "Could not get get_purchases_from_trans");
269 $row = db_fetch_row($result);
274 //-------------------------------------------------------------------
276 This routine fixes stock and COGS balances for all $stock_id sales made during negative inventory status.
277 This is called when delivery is received causing inventory status to be positive again.
279 function adjust_deliveries($stock_id, $material_cost, $to)
283 if (!is_inventory_item($stock_id))
286 $move_id = last_negative_stock_trans_id($stock_id, $to);
287 if ($move_id == false || $move_id == -1)
290 $row = get_deliveries_from_trans($stock_id, $move_id);
294 $old_sales_cost = $row[1];
295 $new_sales_cost = $row[0] * $material_cost;
296 $sales_diff = $new_sales_cost - $old_sales_cost;
298 $row = get_purchases_from_trans($stock_id, $move_id);
300 $old_purchase_cost = $new_purchase_cost = 0;
303 $old_purchase_cost = $row[1];
304 $new_purchase_cost = $row[0] * $material_cost;
305 $purchase_diff = $new_purchase_cost - $old_purchase_cost;
308 $diff = $sales_diff - $purchase_diff;
312 $stock_gl_code = get_stock_gl_code($stock_id);
314 $dec = user_price_dec();
315 $old_cost = -round2($old_sales_cost-$old_purchase_cost,$dec);
316 $new_cost = -round2($new_sales_cost-$new_purchase_cost,$dec);
318 $cart = new items_cart(ST_COSTUPDATE);
319 $cart->tran_date = $cart->doc_date = $cart->event_date = $to;
320 if (!is_date_in_fiscalyear($cart->tran_date))
321 $cart->tran_date = end_fiscalyear();
322 $cart->reference = $Refs->get_next(ST_COSTUPDATE, null, $cart->tran_date, $to);
324 $cart->memo_ = _("Cost was ") . $old_cost. _(" changed to ") . $new_cost . _(" for item ")."'$stock_id'";
326 $cart->add_gl_item($stock_gl_code["cogs_account"], $stock_gl_code["dimension_id"], $stock_gl_code["dimension2_id"], $diff);
327 $cart->add_gl_item($stock_gl_code["inventory_account"], 0, 0, -$diff);
329 write_journal_entries($cart);
333 function get_stock_gl_code($stock_id)
335 /*Gets the GL Codes relevant to the item account */
336 $sql = "SELECT mb_flag, inventory_account, cogs_account,
337 adjustment_account, sales_account, wip_account, dimension_id, dimension2_id FROM
338 ".TB_PREF."stock_master WHERE stock_id = ".db_escape($stock_id);
340 $get = db_query($sql,"retreive stock gl code");
341 return db_fetch($get);
344 function get_purchase_value($stock_id)
346 $sql = "SELECT purchase_cost FROM
347 ".TB_PREF."stock_master WHERE stock_id = ".db_escape($stock_id);
349 $result = db_query($sql,"retreive stock purchase price");
350 $row = db_fetch_row($result);
351 return is_array($row) ? $row[0] : false;
354 function update_purchase_value($stock_id, $price)
356 $price = round2($price, user_price_dec());
357 $sql = "UPDATE ".TB_PREF."stock_master SET purchase_cost=".db_escape($price)
358 ." WHERE stock_id=".db_escape($stock_id);
359 db_query($sql, "The stock master purchase_cost cannot be updated");
361 //-----------------------------------------------------------------------------------------
363 function handle_negative_inventory($stock_id, $quantity, $standard_cost, $date_)
365 //If negative adjustment result in negative or zero inventory
366 //then difference should be adjusted
367 $qoh = get_qoh_on_date($stock_id);
369 if ($qoh + $quantity <= 0 && $qoh > 0) //Positive inventory turning zero/negative
373 $id = get_next_trans_no(ST_JOURNAL);
374 $ref = $Refs->get_next(ST_JOURNAL, null, $date_);
375 $diff = round($qoh*get_unit_cost($stock_id) + $quantity*$standard_cost, user_price_dec());
380 add_journal(ST_JOURNAL, $id, $diff, $date_, get_company_currency(), $ref);
381 $Refs->save(ST_JOURNAL, $id, $ref);
383 $stock_gl_code = get_stock_gl_code($stock_id);
384 $memo = _("Zero/negative inventory handling");
385 //Reverse the inventory effect if $qoh <=0
386 add_gl_trans_std_cost(ST_JOURNAL, $id, $date_,
387 $stock_gl_code["inventory_account"],
388 $stock_gl_code['dimension_id'], $stock_gl_code['dimension2_id'], $memo,
390 //GL Posting to inventory adjustment account
391 add_gl_trans_std_cost(ST_JOURNAL, $id, $date_,
392 $stock_gl_code["adjustment_account"],
393 $stock_gl_code['dimension_id'], $stock_gl_code['dimension2_id'], $memo,
396 add_audit_trail(ST_JOURNAL, $id, $date_);
397 add_comments(ST_JOURNAL, $id, $date_, $memo);
398 $Refs->save(ST_JOURNAL, $id, $ref);
399 commit_transaction();
404 //--------------------------------------------------------------------------------------
406 // $date_ - display / non-sql date
407 // $std_cost - in HOME currency
408 // $price - in transaction currency
410 function add_stock_move($type, $stock_id, $trans_no, $location,
411 $date_, $reference, $quantity, $std_cost, $price=0)
413 $date = date2sql($date_);
415 $sql = "INSERT INTO ".TB_PREF."stock_moves (stock_id, trans_no, type, loc_code,
416 tran_date, reference, qty, standard_cost, price) VALUES ("
417 .db_escape($stock_id).", ".db_escape($trans_no).", "
418 .db_escape($type).", ".db_escape($location).", '$date', "
419 .db_escape($reference).", "
420 .db_escape($quantity).", ".db_escape($std_cost)."," .db_escape($price).")";
422 db_query($sql, "The stock movement record cannot be inserted");
424 return db_insert_id();
427 function update_stock_move($type, $trans_no, $stock_id, $cost)
429 $sql = "UPDATE ".TB_PREF."stock_moves SET standard_cost=".db_escape($cost)
430 ." WHERE type=".db_escape($type)
431 ." AND trans_no=".db_escape($trans_no)
432 ." AND stock_id=".db_escape($stock_id);
433 db_query($sql, "The stock movement standard_cost cannot be updated");
436 //--------------------------------------------------------------------------------------------------
438 function get_stock_moves($type, $type_no)
440 $sql = "SELECT move.*, item.description, item.mb_flag, item.units, stock.location_name
441 FROM ".TB_PREF."stock_moves move,"
442 .TB_PREF."locations stock,"
443 .TB_PREF."stock_master item
444 WHERE move.stock_id = item.stock_id
445 AND stock.loc_code=move.loc_code
446 AND type=".db_escape($type)
447 ." AND trans_no=".db_escape($type_no)
448 ." ORDER BY trans_id";
450 return db_query($sql, "Could not get stock moves");
453 //--------------------------------------------------------------------------------------------------
455 function void_stock_move($type, $type_no)
457 $sql = "SELECT move.*, supplier.supplier_id
458 FROM ".TB_PREF."stock_moves move
459 LEFT JOIN ".TB_PREF."supp_trans credit ON credit.trans_no=move.trans_no AND credit.type=move.type
460 LEFT JOIN ".TB_PREF."grn_batch grn ON grn.id=move.trans_no AND 25=move.type
461 LEFT JOIN ".TB_PREF."suppliers supplier ON IFNULL(grn.supplier_id, credit.supplier_id)=supplier.supplier_id
462 WHERE move.type=".db_escape($type)." AND move.trans_no=".db_escape($type_no);
464 $result = db_query($sql, "Could not void stock moves");
465 while ($row = db_fetch($result))
467 //Skip cost averaging of service items
468 if (is_inventory_item($row["stock_id"]))
470 // The cost has to be adjusted.
471 // Transaction rates are stored either as price or standard_cost depending on types
472 $types = array(ST_SUPPCREDIT, ST_SUPPRECEIVE);
473 if (in_array($type, $types))
474 $unit_cost = $row["price"];
476 $unit_cost = $row["standard_cost"];
478 update_average_material_cost($row["supplier_id"], $row["stock_id"],
479 $unit_cost, -$row["qty"], sql2date($row["tran_date"]));
482 $sql = "DELETE FROM ".TB_PREF."stock_moves
483 WHERE type=".db_escape($type)
484 ." AND trans_no=".db_escape($type_no);
485 db_query($sql, "The stock movement cannot be delated");
488 //--------------------------------------------------------------------------------------------------
490 function get_location_name($loc_code)
492 $sql = "SELECT location_name FROM ".TB_PREF."locations
493 WHERE loc_code=".db_escape($loc_code);
495 $result = db_query($sql, "could not retreive the location name for $loc_code");
497 if (db_num_rows($result) == 1)
499 $row = db_fetch_row($result);
503 display_db_error("could not retreive the location name for $loc_code", $sql, true);
506 function get_mb_flag($stock_id)
508 $sql = "SELECT mb_flag FROM ".TB_PREF."stock_master
509 WHERE stock_id = ".db_escape($stock_id);
510 $result = db_query($sql, "retreive mb_flag from item");
512 if (db_num_rows($result) == 0)
515 $myrow = db_fetch_row($result);