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 include_once($path_to_root . "/purchasing/includes/db/invoice_items_db.inc");
14 //--------------------------------------------------------------------------------------------------
16 function read_supplier_details_to_trans(&$supp_trans, $supplier_id)
18 $sql = "SELECT ".TB_PREF."suppliers.supp_name, ".TB_PREF."payment_terms.terms, "
19 .TB_PREF."payment_terms.days_before_due,
20 ".TB_PREF."payment_terms.day_in_following_month,
21 ".TB_PREF."suppliers.tax_group_id, ".TB_PREF."tax_groups.name As tax_group_name
22 From ".TB_PREF."suppliers, ".TB_PREF."payment_terms, ".TB_PREF."tax_groups
23 WHERE ".TB_PREF."suppliers.tax_group_id = ".TB_PREF."tax_groups.id
24 AND ".TB_PREF."suppliers.payment_terms=".TB_PREF."payment_terms.terms_indicator
25 AND ".TB_PREF."suppliers.supplier_id = ".db_escape($supplier_id);
27 $result = db_query($sql, "The supplier record selected: " . $supplier_id . " cannot be retrieved");
29 $myrow = db_fetch($result);
31 $supp_trans->supplier_id = $supplier_id;
32 $supp_trans->supplier_name = $myrow['supp_name'];
33 $supp_trans->terms_description = $myrow['terms'];
35 if ($myrow['days_before_due'] == 0)
37 $supp_trans->terms = "1" . $myrow['day_in_following_month'];
41 $supp_trans->terms = "0" . $myrow['days_before_due'];
43 $supp_trans->tax_description = $myrow['tax_group_name'];
44 $supp_trans->tax_group_id = $myrow['tax_group_id'];
46 if ($supp_trans->tran_date == "")
48 $supp_trans->tran_date = Today();
49 if (!is_date_in_fiscalyear($supp_trans->tran_date))
50 $supp_trans->tran_date = end_fiscalyear();
52 //if ($supp_trans->due_date=="") {
53 // get_duedate_from_terms($supp_trans);
55 get_duedate_from_terms($supp_trans);
58 //--------------------------------------------------------------------------------------------------
60 function update_supp_received_items_for_invoice($id, $po_detail_item, $qty_invoiced, $chg_price=null)
62 if ($chg_price != null)
64 $sql = "SELECT act_price, unit_price FROM ".TB_PREF."purch_order_details WHERE
65 po_detail_item = ".db_escape($po_detail_item);
66 $result = db_query($sql, "The old actual price of the purchase order line could not be retrieved");
67 $row = db_fetch_row($result);
70 $unit_price = $row[1]; //Added by Rasmus
72 $sql = "SELECT delivery_date FROM ".TB_PREF."grn_batch,".TB_PREF."grn_items WHERE
73 ".TB_PREF."grn_batch.id = ".TB_PREF."grn_items.grn_batch_id AND "
74 .TB_PREF."grn_items.id=".db_escape($id);
75 $result = db_query($sql, "The old delivery date from the received record cout not be retrieved");
76 $row = db_fetch_row($result);
83 $unit_price = 0; // Added by Rasmus
85 $sql = "UPDATE ".TB_PREF."purch_order_details
86 SET qty_invoiced = qty_invoiced + ".db_escape($qty_invoiced);
88 if ($chg_price != null)
89 $sql .= " , act_price = ".db_escape($chg_price);
91 $sql .= " WHERE po_detail_item = ".db_escape($po_detail_item);
92 db_query($sql, "The quantity invoiced of the purchase order line could not be updated");
94 $sql = "UPDATE ".TB_PREF."grn_items
95 SET quantity_inv = quantity_inv + ".db_escape($qty_invoiced)."
96 WHERE id = ".db_escape($id);
97 db_query($sql, "The quantity invoiced off the items received record could not be updated");
98 return array($ret, $date, $unit_price);
101 function get_diff_in_home_currency($supplier, $old_date, $date, $amount1, $amount2)
103 $dec = user_price_dec();
104 price_decimal_format($amount2, $dec);
105 $currency = get_supplier_currency($supplier);
106 $ex_rate = get_exchange_rate_to_home_currency($currency, $old_date);
107 $amount1 = $amount1 / $ex_rate;
108 $ex_rate = get_exchange_rate_to_home_currency($currency, $date);
109 $amount2 = $amount2 / $ex_rate;
110 $diff = $amount2 - $amount1;
111 return round2($diff, $dec);
113 //----------------------------------------------------------------------------------------
115 function add_supp_invoice($supp_trans, $invoice_no=0) // do not receive as ref because we change locally
119 //$company_currency = get_company_currency();
120 /*Start an sql transaction */
124 $taxes = $supp_trans->get_taxes($supp_trans->tax_group_id);
126 foreach ($taxes as $taxitem)
128 $taxitem['Value'] = round2($taxitem['Value'], user_price_dec());
129 $tax_total += $taxitem['Value'];
132 $invoice_items_total = $supp_trans->get_total_charged($supp_trans->tax_group_id);
134 $trans_type = $supp_trans->trans_type;
136 if ($trans_type == ST_SUPPCREDIT)
138 // let's negate everything because it's a credit note
139 $invoice_items_total = -$invoice_items_total;
140 $tax_total = -$tax_total;
141 $supp_trans->ov_discount = -$supp_trans->ov_discount; // this isn't used at all...
144 $date_ = $supp_trans->tran_date;
145 $ex_rate = get_exchange_rate_from_home_currency(get_supplier_currency($supp_trans->supplier_id), $date_);
147 /*First insert the invoice into the supp_trans table*/
148 $invoice_id = add_supp_trans($trans_type, $supp_trans->supplier_id, $date_, $supp_trans->due_date,
149 $supp_trans->reference, $supp_trans->supp_reference,
150 $invoice_items_total, $tax_total, $supp_trans->ov_discount);
153 /* Now the control account */
154 $supplier_accounts = get_supplier_accounts($supp_trans->supplier_id);
155 $total += add_gl_trans_supplier($trans_type, $invoice_id, $date_, $supplier_accounts["payable_account"], 0, 0,
156 -($invoice_items_total + $tax_total + $supp_trans->ov_discount),
157 $supp_trans->supplier_id,
158 "The general ledger transaction for the control total could not be added");
160 /*Loop through the GL Entries and create a debit posting for each of the accounts entered */
162 /*the postings here are a little tricky, the logic goes like this:
163 if its a general ledger amount it goes straight to the account specified
165 if its a GRN amount invoiced then :
167 The cost as originally credited to GRN suspense on arrival of items is debited to GRN suspense. Any difference
168 between the std cost and the currency cost charged as converted at the ex rate of of the invoice is written off
169 to the purchase price variance account applicable to the item being invoiced.
171 foreach ($supp_trans->gl_codes as $entered_gl_code)
174 /*GL Items are straight forward - just do the debit postings to the GL accounts specified -
175 the credit is to creditors control act done later for the total invoice value + tax*/
177 if ($trans_type == ST_SUPPCREDIT)
178 $entered_gl_code->amount = -$entered_gl_code->amount;
180 $memo_ = $entered_gl_code->memo_;
181 $total += add_gl_trans_supplier($trans_type, $invoice_id, $date_, $entered_gl_code->gl_code,
182 $entered_gl_code->gl_dim, $entered_gl_code->gl_dim2, $entered_gl_code->amount, $supp_trans->supplier_id, "", 0, $memo_);
184 add_supp_invoice_gl_item($trans_type, $invoice_id, $entered_gl_code->gl_code,
185 $entered_gl_code->amount, $memo_);
187 // store tax details if the gl account is a tax account
188 if ($trans_type == ST_SUPPCREDIT)
189 $entered_gl_code->amount = -$entered_gl_code->amount;
190 add_gl_tax_details($entered_gl_code->gl_code,
191 $trans_type, $invoice_id, $entered_gl_code->amount,
192 $ex_rate, $date_, $supp_trans->supp_reference);
194 foreach ($supp_trans->grn_items as $entered_grn)
197 if ($trans_type == ST_SUPPCREDIT)
199 $entered_grn->this_quantity_inv = -$entered_grn->this_quantity_inv;
200 set_grn_item_credited($entered_grn, $supp_trans->supplier_id, $invoice_id, $date_);
202 $line_taxfree = $entered_grn->taxfree_charge_price($supp_trans->tax_group_id);
203 $line_tax = $entered_grn->full_charge_price($supp_trans->tax_group_id) - $line_taxfree;
204 $stock_gl_code = get_stock_gl_code($entered_grn->item_code);
205 $iv_act = (is_inventory_item($entered_grn->item_code) ? $stock_gl_code["inventory_account"] : $stock_gl_code["cogs_account"]);
206 $total += add_gl_trans_supplier($trans_type, $invoice_id, $date_, $iv_act,
207 $stock_gl_code['dimension_id'], $stock_gl_code['dimension2_id'],
208 $entered_grn->this_quantity_inv * $line_taxfree, $supp_trans->supplier_id);
209 // -------------- if price changed since po received. 16 Aug 2008 Joe Hunt
210 if ($trans_type == ST_SUPPINVOICE)
212 $old = update_supp_received_items_for_invoice($entered_grn->id, $entered_grn->po_detail_item,
213 $entered_grn->this_quantity_inv, $entered_grn->chg_price);
214 // Since the standard cost is always calculated on basis of the po unit_price,
215 // this is also the price that should be the base of calculating the price diff.
216 // In cases where there is two different po invoices on the same delivery with different unit prices this will not work either
218 //$old_price = $old[0];
220 $old_price = $old[2];
223 If statement is removed. Should always check for deliveries nomatter if there has been a price change.
225 //if ($old_price != $entered_grn->chg_price) // price-change, so update
227 //$diff = $entered_grn->chg_price - $old_price;
228 $old_date = sql2date($old[1]);
229 $diff = get_diff_in_home_currency($supp_trans->supplier_id, $old_date, $date_, $old_price,
230 $entered_grn->chg_price);
231 // always return due to change in currency.
232 $mat_cost = update_average_material_cost(null, $entered_grn->item_code,
233 $diff, $entered_grn->this_quantity_inv, $old_date, true);
234 // added 2008-12-08 Joe Hunt. Update the purchase data table
235 add_or_update_purchase_data($supp_trans->supplier_id, $entered_grn->item_code, $entered_grn->chg_price);
236 $deliveries = get_deliveries_between($entered_grn->item_code, $old_date, Today()); // extend the period, if invoice is before any deliveries.
237 if ($deliveries[0] != 0) // have deliveries been done during the period?
239 $deliveries[1] /= $deliveries[0];
240 $amt = ($mat_cost - $deliveries[1]) * $deliveries[0]; // $amt in home currency
243 $_s = $entered_grn->item_code;
244 $_d = $deliveries[0];
246 $_cd = $mat_cost - $deliveries[1];
247 $memo = _("Cost difference adjustment for $_s. $_d items delivered since $_od. The cost difference is $_cd");
248 add_gl_trans($trans_type, $invoice_id, $date_, $stock_gl_code["cogs_account"],
249 $stock_gl_code['dimension_id'], $stock_gl_code['dimension2_id'], $memo,
250 $amt, null, null, null,
251 "The general ledger transaction could not be added for the price variance of the inventory item");
252 add_gl_trans($trans_type, $invoice_id, $date_, $iv_act,
253 0, 0, $memo, -$amt, null, null, null,
254 "The general ledger transaction could not be added for the price variance of the inventory item");
256 update_stock_move_pid(ST_CUSTDELIVERY, $entered_grn->item_code, $old_date, $date_, 0, $mat_cost);
258 update_stock_move_pid(ST_SUPPRECEIVE, $entered_grn->item_code, $old_date, $old_date, $supp_trans->supplier_id, $mat_cost);
261 // ----------------------------------------------------------------------
263 add_supp_invoice_item($trans_type, $invoice_id, $entered_grn->item_code,
264 $entered_grn->item_description, 0, $line_taxfree, $line_tax,
265 $entered_grn->this_quantity_inv, $entered_grn->id, $entered_grn->po_detail_item, "");
266 } /* end of GRN postings */
267 /* Now the TAX account */
268 $taxes = $supp_trans->get_taxes($supp_trans->tax_group_id, 0, false); // 2009.08-18 Joe Hunt. We have already got the gl lines
269 foreach ($taxes as $taxitem)
271 if ($taxitem['Net'] != 0)
274 if ($trans_type == ST_SUPPCREDIT)
276 $taxitem['Net'] = -$taxitem['Net'];
277 $taxitem['Value'] = -$taxitem['Value'];
279 // here we suppose that tax is never included in price (we are company customer).
280 add_trans_tax_details($trans_type, $invoice_id,
281 $taxitem['tax_type_id'], $taxitem['rate'], 0, $taxitem['Value'],
282 $taxitem['Net'], $ex_rate, $date_, $supp_trans->supp_reference);
284 if ($trans_type == ST_SUPPCREDIT)
285 $taxitem['Value'] = -$taxitem['Value'];
286 $total += add_gl_trans_supplier($trans_type, $invoice_id, $date_,
287 $taxitem['purchasing_gl_code'], 0, 0, $taxitem['Value'],
288 $supp_trans->supplier_id,
289 "A general ledger transaction for the tax amount could not be added");
293 /*Post a balance post if $total != 0 */
294 add_gl_balance($trans_type, $invoice_id, $date_, -$total, PT_SUPPLIER, $supp_trans->supplier_id);
296 add_comments($trans_type, $invoice_id, $date_, $supp_trans->Comments);
298 $Refs->save($trans_type, $invoice_id, $supp_trans->reference);
300 if ($invoice_no != 0)
302 $invoice_alloc_balance = get_supp_trans_allocation_balance(ST_SUPPINVOICE, $invoice_no);
303 if ($invoice_alloc_balance > 0)
304 { //the invoice is not already fully allocated
306 $trans = get_supp_trans($invoice_no, ST_SUPPINVOICE);
307 $total = $trans['Total'];
309 $allocate_amount = ($invoice_alloc_balance > $total) ? $total : $invoice_alloc_balance;
310 /*Now insert the allocation record if > 0 */
311 if ($allocate_amount != 0)
313 update_supp_trans_allocation(ST_SUPPINVOICE, $invoice_no, $allocate_amount);
314 update_supp_trans_allocation(ST_SUPPCREDIT, $invoice_id, $allocate_amount); // ***
315 add_supp_allocation($allocate_amount, ST_SUPPCREDIT, $invoice_id, ST_SUPPINVOICE, $invoice_no,
317 // Exchange Variations Joe Hunt 2008-09-20 ////////////////////////////////////////
319 exchange_variation(ST_SUPPCREDIT, $invoice_id, ST_SUPPINVOICE, $invoice_no, $date_,
320 $allocate_amount, PT_SUPPLIER);
322 ///////////////////////////////////////////////////////////////////////////
328 commit_transaction();
333 //----------------------------------------------------------------------------------------
335 // get all the invoices/credits for a given PO - quite long route to get there !
337 function get_po_invoices_credits($po_number)
339 $sql = "SELECT DISTINCT ".TB_PREF."supp_trans.trans_no, ".TB_PREF."supp_trans.type,
340 ov_amount+ov_discount+ov_gst AS Total,
341 ".TB_PREF."supp_trans.tran_date
342 FROM ".TB_PREF."supp_trans, ".TB_PREF."supp_invoice_items, "
343 .TB_PREF."purch_order_details, ".TB_PREF."purch_orders
344 WHERE ".TB_PREF."supp_invoice_items.supp_trans_no = ".TB_PREF."supp_trans.trans_no
345 AND ".TB_PREF."supp_invoice_items.po_detail_item_id = ".TB_PREF."purch_order_details.po_detail_item
346 AND ".TB_PREF."purch_orders.supplier_id = ".TB_PREF."supp_trans.supplier_id
347 AND ".TB_PREF."purch_order_details.order_no = ".db_escape($po_number);
349 return db_query($sql, "The invoices/credits for the po $po_number could not be retreived");
352 //----------------------------------------------------------------------------------------
354 function read_supp_invoice($trans_no, $trans_type, &$supp_trans)
356 $sql = "SELECT ".TB_PREF."supp_trans.*, supp_name FROM ".TB_PREF."supp_trans,".TB_PREF."suppliers
357 WHERE trans_no = ".db_escape($trans_no)." AND type = ".db_escape($trans_type)."
358 AND ".TB_PREF."suppliers.supplier_id=".TB_PREF."supp_trans.supplier_id";
359 $result = db_query($sql, "Cannot retreive a supplier transaction");
361 if (db_num_rows($result) == 1)
363 $trans_row = db_fetch($result);
365 $supp_trans->supplier_id = $trans_row["supplier_id"];
366 $supp_trans->supplier_name = $trans_row["supp_name"];
367 $supp_trans->tran_date = sql2date($trans_row["tran_date"]);
368 $supp_trans->due_date = sql2date($trans_row["due_date"]);
369 //$supp_trans->Comments = $trans_row["TransText"];
370 $supp_trans->Comments = get_comments_string($trans_type, $trans_no);
371 $supp_trans->reference = $trans_row["reference"];
372 $supp_trans->supp_reference = $trans_row["supp_reference"];
373 $supp_trans->ov_amount = $trans_row["ov_amount"];
374 $supp_trans->ov_discount = $trans_row["ov_discount"];
375 $supp_trans->ov_gst = $trans_row["ov_gst"];
377 $id = $trans_row["trans_no"];
379 $result = get_supp_invoice_items($trans_type, $id);
381 if (db_num_rows($result) > 0)
384 while ($details_row = db_fetch($result))
387 if ($details_row["gl_code"] == 0)
389 $supp_trans->add_grn_to_trans($details_row["grn_item_id"], $details_row["po_detail_item_id"], $details_row["stock_id"],
390 $details_row["description"], 0, 0, $details_row["quantity"], 0, $details_row["FullUnitPrice"],
395 $supp_trans->add_gl_codes_to_trans($details_row["gl_code"], get_gl_account_name($details_row["gl_code"]), 0, 0,
396 $details_row["FullUnitPrice"], $details_row["memo_"]);
402 return display_db_error("Invalid supptrans details for supptrans number : $trans_no and type : $trans_type", $sql, true);
408 return display_db_error("Invalid supptrans number : $trans_no and type : $trans_type", $sql, true);
412 //----------------------------------------------------------------------------------------
414 function get_matching_invoice_item($stock_id, $po_item_id)
416 $sql = "SELECT *, tran_date FROM ".TB_PREF."supp_invoice_items, ".TB_PREF."supp_trans
417 WHERE supp_trans_type = ".ST_SUPPINVOICE." AND stock_id = "
418 .db_escape($stock_id)." AND po_detail_item_id = ".db_escape($po_item_id)."
419 AND supp_trans_no = trans_no";
420 $result = db_query($sql, "Cannot retreive supplier transaction detail records");
421 return db_fetch($result);
424 function void_supp_invoice($type, $type_no)
428 $trans = get_supp_trans($type_no, $type);
430 void_bank_trans($type, $type_no, true);
432 void_gl_trans($type, $type_no, true);
434 void_supp_allocations($type, $type_no);
436 void_supp_trans($type, $type_no);
438 $result = get_supp_invoice_items($type, $type_no);
440 // now remove this invoice/credit from any GRNs/POs that it's related to
441 if (db_num_rows($result) > 0)
444 while ($details_row = db_fetch($result))
446 if ((int)$details_row["grn_item_id"] > 0) // it can be empty for GL items
448 // Changed 2008-10-17 by Joe Hunt to get the avg. material cost updated
449 $old = update_supp_received_items_for_invoice($details_row["grn_item_id"],
450 $details_row["po_detail_item_id"], -$details_row["quantity"], $details_row["FullUnitPrice"]);
452 //$diff = $details_row["FullUnitPrice"] - $old[2];
453 $old_date = sql2date($old[1]);
455 $batch = get_grn_batch_from_item($details_row["grn_item_id"]);
456 $grn = get_grn_batch($batch);
457 if ($type == ST_SUPPCREDIT) // credit note 2009-06-14 Joe Hunt Must restore the po and grn
458 { // We must get the corresponding invoice item to check for price chg.
459 $match = get_matching_invoice_item($details_row["stock_id"], $details_row["po_detail_item_id"]);
460 if ($match !== false)
461 $mat_cost = update_average_material_cost($grn["supplier_id"], $details_row["stock_id"],
462 $match["unit_price"], -$details_row["quantity"], sql2date($match['tran_date']), $match['tran_date'] !== $trans['tran_date']);
464 $mat_cost = update_average_material_cost($grn["supplier_id"], $details_row["stock_id"],
465 $details_row["FullUnitPrice"], -$details_row["quantity"], $old_date, $old[1] !== $trans['tran_date']);
466 $sql = "UPDATE ".TB_PREF."purch_order_details
467 SET quantity_ordered = quantity_ordered + ".-$details_row["quantity"].", ";
468 if ($match !== false)
469 $sql .= "act_price=".$match['unit_price'].", ";
470 $sql .= "quantity_received = quantity_received + ".-$details_row["quantity"]."
471 WHERE po_detail_item = ".$details_row["po_detail_item_id"];
472 db_query($sql, "a purchase order details record could not be updated. This receipt of goods has not been processed ");
473 $sql = "UPDATE ".TB_PREF."grn_items SET qty_recd=qty_recd+".-$details_row["quantity"]."
474 WHERE id=".$details_row["grn_item_id"];
479 $diff = get_diff_in_home_currency($grn["supplier_id"], $old_date, sql2date($trans['tran_date']), $old[2],
480 $details_row["FullUnitPrice"]);
481 // Only adjust the avg for the diff
482 $mat_cost = update_average_material_cost(null, $details_row["stock_id"],
483 $diff, -$details_row["quantity"], $old_date, true);
485 $deliveries = get_deliveries_between($details_row["stock_id"], $old_date, $date_);
486 if ($deliveries[0] != 0) // have deliveries been done during the period?
488 update_stock_move_pid(ST_CUSTDELIVERY, $details_row["stock_id"], $old_date, $date_, 0, $mat_cost);
490 update_stock_move_pid(ST_SUPPRECEIVE, $details_row["stock_id"], $old_date, $old_date, $grn['supplier_id'], $mat_cost);
495 if ($type == ST_SUPPCREDIT) // void the credits in stock moves
496 void_stock_move($type, $type_no);
497 void_supp_invoice_items($type, $type_no);
498 void_trans_tax_details($type, $type_no);
500 commit_transaction();
503 //----------------------------------------------------------------------------------------
504 function get_gl_account_info($acc)
506 $sql = "SELECT account_code, account_name FROM ".TB_PREF."chart_master WHERE account_code=".db_escape($acc);
507 return db_query($sql,"get account information");
510 function is_reference_already_there($supplier_id, $supp_reference)
512 $sql = "SELECT Count(*) FROM ".TB_PREF."supp_trans WHERE supplier_id="
513 .db_escape($supplier_id) . " AND supp_reference="
514 .db_escape($supp_reference)
515 . " AND ov_amount!=0"; // ignore voided invoice references
517 $result=db_query($sql,"The sql to check for the previous entry of the same invoice failed");
519 $myrow = db_fetch_row($result);
520 return ($myrow[0] == 1);
523 function remove_not_invoice_item($id)
527 $myrow = get_grn_item_detail($id);
529 $grn = get_grn_batch($myrow['grn_batch_id']);
531 $sql = "UPDATE ".TB_PREF."purch_order_details
532 SET quantity_received = qty_invoiced, quantity_ordered = qty_invoiced WHERE po_detail_item = ".$myrow["po_detail_item"];
533 db_query($sql, "The quantity invoiced of the purchase order line could not be updated");
535 $sql = "UPDATE ".TB_PREF."grn_items
536 SET qty_recd = quantity_inv WHERE id = ".$myrow["id"];
537 db_query($sql, "The quantity invoiced off the items received record could not be updated");
539 update_average_material_cost($grn["supplier_id"], $myrow["item_code"],
540 $myrow["unit_price"], -$myrow["QtyOstdg"], Today());
542 add_stock_move(ST_SUPPRECEIVE, $myrow["item_code"], $myrow['grn_batch_id'], $grn['loc_code'], sql2date($grn["delivery_date"]), "",
543 -$myrow["QtyOstdg"], $myrow['std_cost_unit'], $grn["supplier_id"], 1, $myrow['unit_price']);
545 commit_transaction();