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 //--------------------------------------------------------------------------------
14 // Base function for adding a GL transaction
15 // $date_ is display date (non-sql)
16 // $amount is in $currency currency
17 // if $currency is not set, then defaults to no conversion
19 function add_gl_trans($type, $trans_id, $date_, $account, $dimension, $dimension2, $memo_,
20 $amount, $currency=null, $person_type_id=null, $person_id=null, $err_msg="", $rate=0)
22 global $use_audit_trail;
24 $date = date2sql($date_);
25 if ($currency != null)
28 $amount_in_home_currency = to_home_currency($amount, $currency, $date_);
30 $amount_in_home_currency = round2($amount * $rate, user_price_dec());
33 $amount_in_home_currency = round2($amount, user_price_dec());
34 if ($dimension == null || $dimension < 0)
36 if ($dimension2 == null || $dimension2 < 0)
38 if (isset($use_audit_trail) && $use_audit_trail)
40 if ($memo_ == "" || $memo_ == null)
41 $memo_ = $_SESSION["wa_current_user"]->username;
43 $memo_ = $_SESSION["wa_current_user"]->username . " - " . $memo_;
45 $sql = "INSERT INTO ".TB_PREF."gl_trans ( type, type_no, tran_date,
46 account, dimension_id, dimension2_id, memo_, amount";
48 if ($person_type_id != null)
49 $sql .= ", person_type_id, person_id";
53 $sql .= "VALUES ($type, $trans_id, '$date',
54 '$account', $dimension, $dimension2, ".db_escape($memo_).", $amount_in_home_currency";
56 if ($person_type_id != null)
57 $sql .= ", $person_type_id, ". db_escape($person_id);
62 $err_msg = "The GL transaction could not be inserted";
64 db_query($sql, $err_msg);
65 return $amount_in_home_currency;
68 //--------------------------------------------------------------------------------
70 // GL Trans for standard costing, always home currency regardless of person
71 // $date_ is display date (non-sql)
72 // $amount is in HOME currency
74 function add_gl_trans_std_cost($type, $trans_id, $date_, $account, $dimension, $dimension2,
75 $memo_, $amount, $person_type_id=null, $person_id=null, $err_msg="")
78 return add_gl_trans($type, $trans_id, $date_, $account, $dimension, $dimension2, $memo_,
79 $amount, null, $person_type_id, $person_id, $err_msg);
84 // Function for even out rounding problems
85 function add_gl_balance($type, $trans_id, $date_, $amount, $person_type_id=null, $person_id=null)
87 $amount = round2($amount, user_price_dec());
89 return add_gl_trans($type, $trans_id, $date_, get_company_pref('exchange_diff_act'), 0, 0, "",
90 $amount, null, $person_type_id, $person_id, "The balanced GL transaction could not be inserted");
95 //--------------------------------------------------------------------------------
97 function get_gl_transactions($from_date, $to_date, $trans_no=0,
98 $account=null, $dimension=0, $dimension2=0, $filter_type=null)
100 $from = date2sql($from_date);
101 $to = date2sql($to_date);
103 $sql = "SELECT ".TB_PREF."gl_trans.*, ".TB_PREF."chart_master.account_name FROM ".TB_PREF."gl_trans, ".TB_PREF."chart_master
104 WHERE ".TB_PREF."chart_master.account_code=".TB_PREF."gl_trans.account
105 AND tran_date >= '$from'
106 AND tran_date <= '$to'";
108 $sql .= " AND ".TB_PREF."gl_trans.type_no LIKE '%$trans_no'";
110 if ($account != null)
111 $sql .= " AND ".TB_PREF."gl_trans.account = '$account'";
114 $sql .= " AND ".TB_PREF."gl_trans.dimension_id = $dimension";
117 $sql .= " AND ".TB_PREF."gl_trans.dimension2_id = $dimension2";
119 if ($filter_type != null AND is_numeric($filter_type))
120 $sql .= " AND ".TB_PREF."gl_trans.type= $filter_type";
122 $sql .= " ORDER BY tran_date";
124 return db_query($sql, "The transactions for could not be retrieved");
128 //--------------------------------------------------------------------------------
130 function get_gl_trans($type, $trans_id)
132 $sql = "SELECT ".TB_PREF."gl_trans.*, ".TB_PREF."chart_master.account_name FROM ".TB_PREF."gl_trans, ".TB_PREF."chart_master
133 WHERE ".TB_PREF."chart_master.account_code=".TB_PREF."gl_trans.account
134 AND ".TB_PREF."gl_trans.type=$type AND ".TB_PREF."gl_trans.type_no=$trans_id";
136 return db_query($sql, "The gl transactions could not be retrieved");
139 //--------------------------------------------------------------------------------
141 function get_gl_wo_cost_trans($trans_id, $person_id=-1)
143 $sql = "SELECT ".TB_PREF."gl_trans.*, ".TB_PREF."chart_master.account_name FROM ".TB_PREF."gl_trans, ".TB_PREF."chart_master
144 WHERE ".TB_PREF."chart_master.account_code=".TB_PREF."gl_trans.account
145 AND ".TB_PREF."gl_trans.type=".systypes::work_order()." AND ".TB_PREF."gl_trans.type_no=$trans_id
146 AND ".TB_PREF."gl_trans.person_type_id=".payment_person_types::WorkOrder();
147 if ($person_id != -1)
148 $sql .= " AND ".TB_PREF."gl_trans.person_id=$person_id";
149 $sql .= " AND amount < 0";
151 return db_query($sql, "The gl transactions could not be retrieved");
154 function get_gl_balance_from_to($from_date, $to_date, $account, $dimension=0, $dimension2=0)
156 $from = date2sql($from_date);
157 $to = date2sql($to_date);
159 $sql = "SELECT SUM(amount) FROM ".TB_PREF."gl_trans
160 WHERE account='$account'";
161 if ($from_date != "")
162 $sql .= " AND tran_date > '$from'";
164 $sql .= " AND tran_date < '$to'";
166 $sql .= " AND dimension_id = $dimension";
168 $sql .= " AND dimension2_id = $dimension2";
170 $result = db_query($sql, "The starting balance for account $account could not be calculated");
172 $row = db_fetch_row($result);
176 //--------------------------------------------------------------------------------
178 function get_gl_trans_from_to($from_date, $to_date, $account, $dimension=0, $dimension2=0)
180 $from = date2sql($from_date);
181 $to = date2sql($to_date);
183 $sql = "SELECT SUM(amount) FROM ".TB_PREF."gl_trans
184 WHERE account='$account'";
185 if ($from_date != "")
186 $sql .= " AND tran_date >= '$from'";
188 $sql .= " AND tran_date <= '$to'";
190 $sql .= " AND dimension_id = $dimension";
192 $sql .= " AND dimension2_id = $dimension2";
194 $result = db_query($sql, "Transactions for account $account could not be calculated");
196 $row = db_fetch_row($result);
200 //----------------------------------------------------------------------------------------------------
201 function get_balance($account, $dimension, $dimension2, $from, $to, $from_incl=true, $to_incl=true)
203 $sql = "SELECT SUM(IF(amount >= 0, amount, 0)) as debit, SUM(IF(amount < 0, -amount, 0)) as credit, SUM(amount) as balance
204 FROM ".TB_PREF."gl_trans,".TB_PREF."chart_master,".TB_PREF."chart_types, ".TB_PREF."chart_class
205 WHERE ".TB_PREF."gl_trans.account=".TB_PREF."chart_master.account_code AND ".TB_PREF."chart_master.account_type=".TB_PREF."chart_types.id
206 AND ".TB_PREF."chart_types.class_id=".TB_PREF."chart_class.cid AND";
208 if ($account != null)
209 $sql .= " account='$account' AND";
211 $sql .= " dimension_id=$dimension AND";
213 $sql .= " dimension2_id=$dimension2 AND";
214 $from_date = date2sql($from);
216 $sql .= " tran_date >= '$from_date' AND";
218 $sql .= " tran_date > IF(ctype>0 AND ctype<".CL_INCOME.", '0000-00-00', '$from_date') AND";
219 $to_date = date2sql($to);
221 $sql .= " tran_date <= '$to_date' ";
223 $sql .= " tran_date < '$to_date' ";
225 $result = db_query($sql,"No general ledger accounts were returned");
227 return db_fetch($result);
230 //--------------------------------------------------------------------------------
232 function get_budget_trans_from_to($from_date, $to_date, $account, $dimension=0, $dimension2=0)
235 $from = date2sql($from_date);
236 $to = date2sql($to_date);
238 $sql = "SELECT SUM(amount) FROM ".TB_PREF."budget_trans
239 WHERE account='$account' ";
240 if ($from_date != "")
241 $sql .= " AND tran_date >= '$from' ";
243 $sql .= " AND tran_date <= '$to' ";
245 $sql .= " AND dimension_id = $dimension";
247 $sql .= " AND dimension2_id = $dimension2";
248 $result = db_query($sql,"No budget accounts were returned");
250 $row = db_fetch_row($result);
254 //--------------------------------------------------------------------------------
255 // Stores journal/bank transaction tax details if applicable
257 function add_gl_tax_details($gl_code, $trans_type, $trans_no, $amount, $ex_rate, $date, $memo)
259 $tax_type = is_tax_account($gl_code);
260 if(!$tax_type) return; // $gl_code is not tax account
262 $tax = get_tax_type($tax_type);
263 if ($gl_code == $tax['sales_gl_code'])
265 // we have to restore net amount as we cannot know the base amount
266 if ($tax['rate'] == 0) {
267 // display_warning(_("You should not post gl transactions
268 // to tax account with zero tax rate."));
271 // calculate net amount
272 $net_amount = $amount/$tax['rate']*100;
275 add_trans_tax_details($trans_type, $trans_no, $tax['id'], $tax['rate'], 0,
276 $amount, $net_amount, $ex_rate, $date, $memo);
280 //--------------------------------------------------------------------------------
282 // Store transaction tax details for fiscal purposes with 'freezed'
283 // actual tax type rate.
285 function add_trans_tax_details($trans_type, $trans_no, $tax_id, $rate, $included,
286 $amount, $net_amount, $ex_rate, $tran_date, $memo)
289 $sql = "INSERT INTO ".TB_PREF."trans_tax_details
290 (trans_type, trans_no, tran_date, tax_type_id, rate, ex_rate,
291 included_in_price, net_amount, amount, memo)
292 VALUES (".db_escape($trans_type)."," . db_escape($trans_no).",'"
293 .date2sql($tran_date)."',".db_escape($tax_id).","
294 .$rate.",".$ex_rate.",".($included ? 1:0).","
295 .db_escape($net_amount).","
296 .db_escape($amount).",".db_escape($memo).")";
298 db_query($sql, "Cannot save trans tax details");
301 //----------------------------------------------------------------------------------------
303 function get_trans_tax_details($trans_type, $trans_no)
305 $sql = "SELECT ".TB_PREF."trans_tax_details.*, ".TB_PREF."tax_types.name AS tax_type_name
306 FROM ".TB_PREF."trans_tax_details,".TB_PREF."tax_types
307 WHERE trans_type = $trans_type
308 AND trans_no = $trans_no
309 AND (net_amount != 0 OR amount != 0)
310 AND ".TB_PREF."tax_types.id = ".TB_PREF."trans_tax_details.tax_type_id";
312 return db_query($sql, "The transaction tax details could not be retrieved");
315 //----------------------------------------------------------------------------------------
317 function void_trans_tax_details($type, $type_no)
319 $sql = "UPDATE ".TB_PREF."trans_tax_details SET amount=0, net_amount=0
320 WHERE trans_no=$type_no
321 AND trans_type=$type";
323 db_query($sql, "The transaction tax details could not be voided");
326 function get_tax_summary($from, $to)
328 $fromdate = date2sql($from);
329 $todate = date2sql($to);
332 SUM(IF( trans_type=1 || trans_type=11 || trans_type=20,-1,1)*
333 IF(trans_type=0 || trans_type=2 || trans_type=10 || trans_type=11, net_amount*ex_rate,0)) net_output,
334 SUM(IF( trans_type=1 || trans_type=11 || trans_type=20,-1,1)*
335 IF(trans_type=0 || trans_type=2 || trans_type=10 || trans_type=11, amount*ex_rate,0)) payable,
336 SUM(IF( trans_type=1 || trans_type=11 || trans_type=20,-1,1)*
337 IF(trans_type=0 || trans_type=2 || trans_type=10 || trans_type=11, 0, net_amount*ex_rate)) net_input,
338 SUM(IF( trans_type=1 || trans_type=11 || trans_type=20,-1,1)*
339 IF(trans_type=0 || trans_type=2 || trans_type=10 || trans_type=11, 0, amount*ex_rate)) collectible,
343 FROM ".TB_PREF."tax_types ttype,
344 ".TB_PREF."trans_tax_details taxrec
345 WHERE taxrec.tax_type_id=ttype.id
346 AND taxrec.trans_type != 13
347 AND taxrec.tran_date >= '$fromdate'
348 AND taxrec.tran_date <= '$todate'
350 //display_error($sql);
351 return db_query($sql,"Cannot retrieve tax summary");
354 //--------------------------------------------------------------------------------
355 // Write/update journal entries.
357 function write_journal_entries(&$cart, $reverse)
359 $date_ = $cart->tran_date;
360 $ref = $cart->reference;
361 $memo_ = $cart->memo_;
362 $new = $cart->order_id == 0;
363 $trans_type = $cart->trans_type;
364 $trans_id = $new ? get_next_trans_no($trans_type) : $cart->order_id;
369 $cart->order_id = $trans_id;
371 void_journal_trans($trans_type, $trans_id, true);
372 delete_comments($trans_type, $trans_id);
375 foreach ($cart->gl_items as $journal_item)
377 // post to first found bank account using given gl acount code.
378 $is_bank_to = is_bank_account($journal_item->code_id);
380 add_gl_trans($trans_type, $trans_id, $date_, $journal_item->code_id,
381 $journal_item->dimension_id, $journal_item->dimension2_id,
382 $journal_item->reference, $journal_item->amount);
385 add_bank_trans($trans_type, $trans_id, $is_bank_to, $ref,
386 $date_, $journal_item->amount, 0, "", get_company_currency(),
387 "Cannot insert a destination bank transaction");
389 // store tax details if the gl account is a tax account
390 add_gl_tax_details($journal_item->code_id,
391 $trans_type, $trans_id, -$journal_item->amount, 1, $date_, $memo_);
395 add_comments($trans_type, $trans_id, $date_, $memo_);
396 references::save($trans_type, $trans_id, $ref);
398 update_comments($trans_type, $trans_id, null, $memo_);
400 add_audit_trail($trans_type, $trans_id, $date_);
402 commit_transaction();
406 //$reversingDate = date(user_date_display(),
407 // Mktime(0,0,0,get_month($date_)+1,1,get_year($date_)));
408 $reversingDate = begin_month(add_months($date_, 1));
410 $trans_id_reverse = get_next_trans_no($trans_type);
412 foreach ($cart->gl_items as $journal_item)
414 $is_bank_to = is_bank_account($journal_item->code_id);
416 add_gl_trans($trans_type, $trans_id_reverse, $reversingDate,
417 $journal_item->code_id, $journal_item->dimension_id, $journal_item->dimension2_id,
418 $journal_item->reference, -$journal_item->amount);
421 add_bank_trans($trans_type, $trans_id_reverse, $is_bank_to, $ref,
422 $reversingDate, $journal_item->amount,
423 0, "", get_company_currency(),
424 "Cannot insert a destination bank transaction");
426 // store tax details if the gl account is a tax account
427 add_gl_tax_details($journal_item->code_id,
428 $trans_type, $trans_id, $journal_item->amount, 1, $reversingDate, $memo_);
431 add_comments($trans_type, $trans_id_reverse, $reversingDate, $memo_);
433 references::save($trans_type, $trans_id_reverse, $ref);
434 add_audit_trail($trans_type, $trans_id_reverse, $reversingDate);
440 //--------------------------------------------------------------------------------------------------
442 function exists_gl_trans($type, $trans_id)
444 $sql = "SELECT type_no FROM ".TB_PREF."gl_trans WHERE type=$type AND type_no=$trans_id";
445 $result = db_query($sql, "Cannot retreive a gl transaction");
447 return (db_num_rows($result) > 0);
450 //--------------------------------------------------------------------------------------------------
452 function void_gl_trans($type, $trans_id, $nested=false)
457 $sql = "UPDATE ".TB_PREF."gl_trans SET amount=0 WHERE type=$type AND type_no=$trans_id";
459 db_query($sql, "could not void gl transactions for type=$type and trans_no=$trans_id");
462 commit_transaction();
465 //----------------------------------------------------------------------------------------
467 function void_journal_trans($type, $type_no)
471 void_bank_trans($type, $type_no, true);
472 // void_gl_trans($type, $type_no, true); // this is done above
473 // void_trans_tax_details($type, $type_no); // ditto
475 commit_transaction();