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 //----------------------------------------------------------------------------------------
13 // Mark changes in debtor_trans_details
15 function update_customer_trans_version($type, $versions) {
17 $sql= 'UPDATE '.TB_PREF. 'debtor_trans SET version=version+1
18 WHERE type='.db_escape($type).' AND (';
20 foreach ($versions as $trans_no=>$version)
21 $where[] = '(trans_no='.db_escape($trans_no).' AND version='.$version.')';
23 $sql .= implode(' OR ', $where) .')';
25 return db_query($sql, 'Concurrent editing conflict');
28 //----------------------------------------------------------------------------------------
29 // Gets document header versions for transaction set of type $type
30 // $trans_no = array(num1, num2,...);
31 // returns array(num1=>ver1, num2=>ver2...)
33 function get_customer_trans_version($type, $trans_no) {
34 if (!is_array($trans_no))
35 $trans_no = array( $trans_no );
37 $sql= 'SELECT trans_no, version FROM '.TB_PREF. 'debtor_trans
38 WHERE type='.db_escape($type).' AND (';
40 foreach ($trans_no as $key=>$trans)
41 $trans_no[$key] = 'trans_no='.db_escape($trans_no[$key]);
43 $sql .= implode(' OR ', $trans_no) . ')';
45 $res = db_query($sql, 'document version retreival');
48 while($mysql=db_fetch($res)) {
49 $vers[$mysql['trans_no']] = $mysql['version'];
53 //----------------------------------------------------------------------------------------
54 // $Total, $Tax, $Freight, $discount all in customer's currency
55 // date_ is display date (non-sql)
56 function write_customer_trans($trans_type, $trans_no, $debtor_no, $BranchNo,
57 $date_, $reference, $Total, $discount=0, $Tax=0, $Freight=0, $FreightTax=0,
58 $sales_type=0, $order_no=0, $ship_via=0, $due_date="",
59 $AllocAmt=0, $rate=0, $dimension_id=0, $dimension2_id=0, $payment_terms=null, $tax_included=0, $prep_amount=0)
62 $curr = get_customer_currency($debtor_no);
64 $rate = get_exchange_rate_from_home_currency($curr, $date_);
66 $SQLDate = date2sql($date_);
68 $SQLDueDate = "0000-00-00";
70 $SQLDueDate = date2sql($due_date);
72 if ($trans_type == ST_BANKPAYMENT)
75 if ($new || !exists_customer_trans($trans_type, $trans_no))
78 $trans_no = get_next_trans_no($trans_type);
80 $sql = "INSERT INTO ".TB_PREF."debtor_trans (
82 debtor_no, branch_code,
85 order_, ov_amount, ov_discount,
86 ov_gst, ov_freight, ov_freight_tax,
87 rate, ship_via, alloc,
88 dimension_id, dimension2_id, payment_terms, tax_included, prep_amount
89 ) VALUES (".db_escape($trans_no).", ".db_escape($trans_type).",
90 ".db_escape($debtor_no).", ".db_escape($BranchNo).",
91 '$SQLDate', '$SQLDueDate', ".db_escape($reference).",
92 ".db_escape($sales_type).", ".db_escape($order_no).", $Total, ".db_escape($discount).", $Tax,
93 ".db_escape($Freight).",
94 $FreightTax, $rate, ".db_escape($ship_via).", $AllocAmt,
95 ".db_escape($dimension_id).", ".db_escape($dimension2_id).", "
96 .db_escape($payment_terms, true).", "
97 .db_escape($tax_included).", ".db_escape($prep_amount).")";
98 } else { // may be optional argument should stay unchanged ?
99 $sql = "UPDATE ".TB_PREF."debtor_trans SET
100 debtor_no=".db_escape($debtor_no)." , branch_code=".db_escape($BranchNo).",
101 tran_date='$SQLDate', due_date='$SQLDueDate',
102 reference=".db_escape($reference).", tpe=".db_escape($sales_type).", order_=".db_escape($order_no).",
103 ov_amount=$Total, ov_discount=".db_escape($discount).", ov_gst=$Tax,
104 ov_freight=".db_escape($Freight).", ov_freight_tax=$FreightTax, rate=$rate,
105 ship_via=".db_escape($ship_via).", alloc=$AllocAmt,
106 dimension_id=".db_escape($dimension_id).", dimension2_id=".db_escape($dimension2_id).",
107 payment_terms=".db_escape($payment_terms, true).",
108 tax_included=".db_escape($tax_included).",
109 prep_amount =".db_escape($prep_amount)."
110 WHERE trans_no=".db_escape($trans_no)." AND type=".db_escape($trans_type);
112 db_query($sql, "The debtor transaction record could not be inserted");
114 if ($trans_type != ST_JOURNAL) // skip for journal entries
115 add_audit_trail($trans_type, $trans_no, $date_, $new ? '': _("Updated."));
119 //----------------------------------------------------------------------------------------
121 function get_customer_trans($trans_id, $trans_type, $customer_id=null)
125 $sql = "SELECT trans.*,"
126 ."ov_amount+ov_gst+ov_freight+ov_freight_tax+ov_discount AS Total,"
127 ."cust.name AS DebtorName, cust.address, "
130 trans.prep_amount>0 as prepaid,"
133 if ($trans_type == ST_CUSTPAYMENT || $trans_type == ST_BANKDEPOSIT) {
134 // it's a payment so also get the bank account
135 $sql .= ",bank_act,".TB_PREF."bank_accounts.bank_name, ".TB_PREF."bank_accounts.bank_account_name,
136 ".TB_PREF."bank_accounts.account_type AS BankTransType,
137 ".TB_PREF."bank_accounts.bank_curr_code,
138 bt.amount as bank_amount, bt.charge bank_charge";
141 if ($trans_type == ST_SALESINVOICE || $trans_type == ST_CUSTCREDIT || $trans_type == ST_CUSTDELIVERY) {
142 // it's an invoice so also get the shipping method and salestype
143 $sql .= ", IFNULL(ship.description, '-') shipping, "
144 .TB_PREF."sales_types.sales_type, "
145 .TB_PREF."sales_types.tax_included, "
148 .TB_PREF."tax_groups.name AS tax_group_name, "
149 .TB_PREF."tax_groups.id AS tax_group_id ";
152 if ($trans_type == ST_JOURNAL) {
153 $sql .= ", branch.*";
156 $sql .= " FROM ".TB_PREF."debtor_trans trans
157 LEFT JOIN ".TB_PREF."comments com ON trans.type=com.type AND trans.trans_no=com.id
158 LEFT JOIN ".TB_PREF."stock_master ship ON ship.stock_id=trans.ship_via,
159 ".TB_PREF."debtors_master cust";
161 if ($trans_type == ST_CUSTPAYMENT || $trans_type == ST_BANKDEPOSIT) {
162 // it's a payment so also get the bank account
163 $sql .= ", ".TB_PREF."bank_trans bt, ".TB_PREF."bank_accounts";
166 if ($trans_type == ST_SALESINVOICE || $trans_type == ST_CUSTCREDIT || $trans_type == ST_CUSTDELIVERY) {
167 $sql .= ", ".TB_PREF."sales_types, "
168 .TB_PREF."cust_branch branch, "
169 .TB_PREF."tax_groups ";
172 if ($trans_type == ST_JOURNAL) {
173 $sql .= ", ".TB_PREF."cust_branch branch ";
176 $sql .= " WHERE trans.trans_no=".db_escape($trans_id)."
177 AND trans.type=".db_escape($trans_type)."
178 AND trans.debtor_no=cust.debtor_no";
180 if (isset($customer_id))
181 $sql .= " AND trans.debtor_no=".db_escape($customer_id);
183 if ($trans_type == ST_CUSTPAYMENT || $trans_type == ST_BANKDEPOSIT) {
184 // it's a payment so also get the bank account
185 $sql .= " AND bt.trans_no =".db_escape($trans_id)."
186 AND bt.type=$trans_type
188 AND ".TB_PREF."bank_accounts.id=bt.bank_act ";
190 if ($trans_type == ST_SALESINVOICE || $trans_type == ST_CUSTCREDIT || $trans_type == ST_CUSTDELIVERY) {
191 // it's an invoice so also get the shipper
192 $sql .= " AND ".TB_PREF."sales_types.id = trans.tpe
193 AND branch.branch_code = trans.branch_code
194 AND branch.tax_group_id = ".TB_PREF."tax_groups.id ";
196 if ($trans_type == ST_JOURNAL) {
197 $sql .= " AND branch.branch_code = trans.branch_code ";
200 $result = db_query($sql, "Cannot retreive a debtor transaction");
202 if (db_num_rows($result) == 0) {
203 // can't return nothing
204 if ($SysPrefs->go_debug)
206 display_db_error("no debtor trans found for given params", $sql, true);
209 if (db_num_rows($result) > 1) {
210 // can't return multiple
211 if($SysPrefs->go_debug)
213 display_db_error("duplicate debtor transactions found for given params", $sql, true);
217 $row = db_fetch($result);
221 //----------------------------------------------------------------------------------------
223 function exists_customer_trans($type, $type_no)
225 $sql = "SELECT trans_no FROM ".TB_PREF."debtor_trans WHERE type=".db_escape($type)."
226 AND trans_no=".db_escape($type_no);
228 $result = db_query($sql, "Cannot retreive a debtor transaction");
230 return (db_num_rows($result) > 0);
233 //----------------------------------------------------------------------------------------
235 // retreives the related sales order for a given trans
237 function get_customer_trans_order($type, $type_no)
239 $sql = "SELECT order_ FROM ".TB_PREF."debtor_trans WHERE type=".db_escape($type)." AND trans_no=".db_escape($type_no);
241 $result = db_query($sql, "The debtor transaction could not be queried");
243 $row = db_fetch_row($result);
248 //----------------------------------------------------------------------------------------
250 function get_customer_details_from_trans($type, $type_no)
252 $sql = "SELECT debtor.name, debtor.curr_code, branch.br_name
254 .TB_PREF."debtors_master debtor,"
255 .TB_PREF."cust_branch branch,"
256 .TB_PREF."debtor_trans trans
257 WHERE trans.type=".db_escape($type)." AND trans.trans_no=".db_escape($type_no)."
258 AND debtor.debtor_no = trans.debtor_no
259 AND branch.branch_code = trans.branch_code";
261 $result = db_query($sql, "could not get customer details from trans");
262 return db_fetch($result);
265 //----------------------------------------------------------------------------------------
267 function void_customer_trans($type, $type_no)
269 // clear all values and mark as void
270 $sql = "UPDATE ".TB_PREF."debtor_trans SET ov_amount=0, ov_discount=0, ov_gst=0, ov_freight=0,
271 ov_freight_tax=0, alloc=0, prep_amount=0, version=version+1 WHERE type=".db_escape($type)." AND trans_no=".db_escape($type_no);
273 db_query($sql, "could not void debtor transactions for type=$type and trans_no=$type_no");
276 //----------------------------------------------------------------------------------------
278 function clear_customer_trans($type, $type_no)
281 $sql = "DELETE FROM ".TB_PREF."debtor_trans WHERE type=".db_escape($type)." AND trans_no=".db_escape($type_no);
283 db_query($sql, "could not clear debtor transactions for type=$type and trans_no=$type_no");
285 //----------------------------------------------------------------------------------------
287 function post_void_customer_trans($type, $type_no)
290 case ST_SALESINVOICE :
292 void_sales_invoice($type, $type_no);
294 case ST_CUSTDELIVERY :
295 void_sales_delivery($type, $type_no);
297 case ST_CUSTPAYMENT :
298 void_customer_payment($type, $type_no);
303 //----------------------------------------------------------------------------------------
304 function get_sql_for_customer_inquiry($from, $to, $cust_id = ALL_TEXT, $filter = ALL_TEXT, $show_voided = 0)
306 $date_after = date2sql($from);
307 $date_to = date2sql($to);
319 IF(prep_amount, prep_amount, trans.ov_amount + trans.ov_gst + trans.ov_freight
320 + trans.ov_freight_tax + trans.ov_discount) AS TotalAmount,"
321 // if ($filter != ALL_TEXT)
322 // $sql .= "@bal := @bal+IF(prep_amount, prep_amount, trans.ov_amount + trans.ov_gst + trans.ov_freight + trans.ov_freight_tax + trans.ov_discount), ";
325 // $sql .= "IF(trans.type=".ST_CUSTDELIVERY.",'', IF(trans.type=".ST_SALESINVOICE." OR trans.type=".ST_BANKPAYMENT.",@bal := @bal+
326 // (trans.ov_amount + trans.ov_gst + trans.ov_freight + trans.ov_freight_tax + trans.ov_discount), @bal := @bal-
327 // (trans.ov_amount + trans.ov_gst + trans.ov_freight + trans.ov_freight_tax + trans.ov_discount))) , ";
328 . "IF(trans.type IN(".implode(',', array(ST_CUSTCREDIT,ST_CUSTPAYMENT,ST_BANKDEPOSIT))."), -1, 1)
329 *(IF(prep_amount, prep_amount, trans.ov_amount + trans.ov_gst + trans.ov_freight
330 + trans.ov_freight_tax + trans.ov_discount)-trans.alloc) Balance,
333 $sql .= "trans.alloc AS Allocated,
334 ((trans.type = ".ST_SALESINVOICE." || trans.type = ".ST_JOURNAL.")
335 AND trans.due_date < '" . date2sql(Today()) . "') AS OverDue ,
336 Sum(line.quantity-line.qty_done) AS Outstanding,
337 Sum(line.qty_done) AS HasChild,
340 .TB_PREF."debtor_trans as trans
341 LEFT JOIN ".TB_PREF."debtor_trans_details as line
342 ON trans.trans_no=line.debtor_trans_no AND trans.type=line.debtor_trans_type
343 LEFT JOIN ".TB_PREF."voided as v
344 ON trans.trans_no=v.id AND trans.type=v.type
345 LEFT JOIN ".TB_PREF."audit_trail as audit ON (trans.type=audit.type AND trans.trans_no=audit.trans_no)
346 LEFT JOIN ".TB_PREF."users as user ON (audit.user=user.id)
347 LEFT JOIN ".TB_PREF."cust_branch as branch ON trans.branch_code=branch.branch_code,"
348 .TB_PREF."debtors_master as debtor
349 WHERE debtor.debtor_no = trans.debtor_no"; // exclude voided transactions and self-balancing (journal) transactions:
351 $sql .= " AND ISNULL(v.date_) AND (trans.ov_amount + trans.ov_gst + trans.ov_freight + trans.ov_freight_tax + trans.ov_discount) != 0";
354 $sql .= " AND ABS(IF(prep_amount, prep_amount, trans.ov_amount + trans.ov_gst + trans.ov_freight + trans.ov_freight_tax + trans.ov_discount)-trans.alloc)>"
357 $sql .= " AND trans.tran_date >= '$date_after'
358 AND trans.tran_date <= '$date_to'";
361 if ($cust_id != ALL_TEXT)
362 $sql .= " AND trans.debtor_no = ".db_escape($cust_id);
364 if ($filter != ALL_TEXT)
368 $sql .= " AND (trans.type = ".ST_SALESINVOICE.") ";
370 elseif ($filter == '2')
372 $sql .= " AND (trans.type <> ".ST_CUSTDELIVERY.") ";
374 elseif ($filter == '3')
376 $sql .= " AND (trans.type = " . ST_CUSTPAYMENT
377 ." OR trans.type = ".ST_BANKDEPOSIT." OR trans.type = ".ST_BANKPAYMENT.") ";
379 elseif ($filter == '4')
381 $sql .= " AND trans.type = ".ST_CUSTCREDIT." ";
383 elseif ($filter == '5')
385 $sql .= " AND trans.type = ".ST_CUSTDELIVERY." ";
390 $today = date2sql(Today());
391 $sql .= " AND trans.due_date < '$today'
392 AND (trans.ov_amount + trans.ov_gst + trans.ov_freight_tax +
393 trans.ov_freight + trans.ov_discount - trans.alloc > 0) ";
397 $sql .= " GROUP BY trans.trans_no, trans.type";
402 function get_sql_for_sales_deliveries_view($from, $to, $customer_id, $stock_item, $location, $delivery, $outstanding=false)
404 $sql = "SELECT trans.trans_no,
413 (ov_amount+ov_gst+ov_freight+ov_freight_tax) AS DeliveryValue,
415 Sum(line.quantity-line.qty_done) AND sorder.prep_amount=0 AS Outstanding,
416 Sum(line.qty_done) AS Done
418 .TB_PREF."sales_orders as sorder, "
419 .TB_PREF."debtor_trans as trans, "
420 .TB_PREF."debtor_trans_details as line, "
421 .TB_PREF."debtors_master as debtor, "
422 .TB_PREF."cust_branch as branch
424 sorder.order_no = trans.order_ AND
425 trans.debtor_no = debtor.debtor_no
426 AND trans.type = ".ST_CUSTDELIVERY."
427 AND line.debtor_trans_no = trans.trans_no
428 AND line.debtor_trans_type = trans.type
429 AND trans.branch_code = branch.branch_code
430 AND trans.debtor_no = branch.debtor_no ";
432 if ($outstanding == true) {
433 $sql .= " AND line.qty_done < line.quantity ";
436 //figure out the sql required from the inputs available
439 $sql .= " AND trans.trans_no LIKE ".db_escape('%' . $delivery . '%');
440 $sql .= " GROUP BY trans.trans_no";
444 $sql .= " AND trans.tran_date >= '".date2sql($from)."'";
445 $sql .= " AND trans.tran_date <= '".date2sql($to)."'";
447 if ($stock_item != ALL_TEXT)
448 $sql .= " AND line.stock_id=".db_escape($stock_item)." ";
450 if ($location != ALL_TEXT)
451 $sql .= " AND sorder.from_stk_loc = ".db_escape($location)." ";
453 if ($customer_id != ALL_TEXT)
454 $sql .= " AND trans.debtor_no = ".db_escape($customer_id);
456 $sql .= " GROUP BY trans.trans_no ";
458 } //end no delivery number selected