0e47a97481a05d0a104d6b0cc1753309b240829f
[fa-stable.git] / sales / includes / db / customers_db.inc
1 <?php
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 function add_customer($CustName, $cust_ref, $address, $tax_id, $curr_code,
14         $dimension_id, $dimension2_id, $credit_status, $payment_terms, $discount, $pymt_discount, 
15         $credit_limit, $sales_type, $notes)
16 {
17         $sql = "INSERT INTO ".TB_PREF."debtors_master (name, debtor_ref, address, tax_id,
18                 dimension_id, dimension2_id, curr_code, credit_status, payment_terms, discount, 
19                 pymt_discount,credit_limit, sales_type, notes) VALUES ("
20                 .db_escape($CustName) .", " .db_escape($cust_ref) .", "
21                 .db_escape($address) . ", " . db_escape($tax_id) . ","
22                 .db_escape($dimension_id) . ", " 
23                 .db_escape($dimension2_id) . ", ".db_escape($curr_code) . ", 
24                 " . db_escape($credit_status) . ", ".db_escape($payment_terms) . ", " . $discount . ", 
25                 " . $pymt_discount . ", " . $credit_limit 
26                  .", ".db_escape($sales_type).", ".db_escape($notes) . ")";
27         db_query($sql,"The customer could not be added");
28 }
29
30 function update_customer($customer_id, $CustName, $cust_ref, $address, $tax_id, $curr_code,
31         $dimension_id, $dimension2_id, $credit_status, $payment_terms, $discount, $pymt_discount,
32         $credit_limit, $sales_type, $notes)
33 {
34         $sql = "UPDATE ".TB_PREF."debtors_master SET name=" . db_escape($CustName) . ", 
35                 debtor_ref=" . db_escape($cust_ref) . ",
36                 address=".db_escape($address) . ", 
37                 tax_id=".db_escape($tax_id) . ", 
38                 curr_code=".db_escape($curr_code) . ", 
39                 dimension_id=".db_escape($dimension_id) . ", 
40                 dimension2_id=".db_escape($dimension2_id) . ", 
41                 credit_status=".db_escape($credit_status) . ", 
42                 payment_terms=".db_escape($payment_terms) . ", 
43                 discount=" . $discount . ", 
44                 pymt_discount=" . $pymt_discount . ", 
45                 credit_limit=" . $credit_limit . ", 
46                 sales_type = ".db_escape($sales_type) . ", 
47                 notes=".db_escape($notes) ."
48                 WHERE debtor_no = ".db_escape($customer_id);
49
50         db_query($sql,"The customer could not be updated");
51 }
52
53 function delete_customer($customer_id)
54 {
55         begin_transaction(__FUNCTION__, func_get_args());
56         delete_entity_contacts('customer', $customer_id);
57
58         $sql = "DELETE FROM ".TB_PREF."debtors_master WHERE debtor_no=".db_escape($customer_id);
59         db_query($sql,"cannot delete customer");
60         commit_transaction();
61 }
62
63 /*
64         This function probably should be renamed to get_customer_summary
65 */
66 function get_customer_details($customer_id, $to=null, $all=true)
67 {
68
69         if ($to == null)
70                 $todate = date("Y-m-d");
71         else
72                 $todate = date2sql($to);
73         $past1 = get_company_pref('past_due_days');
74         $past2 = 2 * $past1;
75         // removed - debtor_trans.alloc from all summations
76         $sign = "IF(trans.`type` IN(".implode(',',  array(ST_CUSTCREDIT,ST_CUSTPAYMENT,ST_BANKDEPOSIT))."), -1, 1)";
77         if ($all)
78         $value = "IFNULL($sign*(trans.ov_amount + trans.ov_gst + trans.ov_freight + trans.ov_freight_tax + trans.ov_discount),0)";
79     else                
80         $value = "IFNULL($sign*(trans.ov_amount + trans.ov_gst + trans.ov_freight + trans.ov_freight_tax + trans.ov_discount - 
81                 trans.alloc),0)";
82         $due = "IF (trans.type=".ST_SALESINVOICE.", trans.due_date, trans.tran_date)";
83     $sql = "SELECT debtor.name, debtor.curr_code, terms.terms, debtor.credit_limit,
84                         credit_status.dissallow_invoices, credit_status.reason_description,
85                                 Sum($value) AS Balance,
86                                 Sum(IF ((TO_DAYS('$todate') - TO_DAYS($due)) > 0,$value,0)) AS Due,
87                                 Sum(IF ((TO_DAYS('$todate') - TO_DAYS($due)) > $past1,$value,0)) AS Overdue1,
88                                 Sum(IF ((TO_DAYS('$todate') - TO_DAYS($due)) > $past2,$value,0)) AS Overdue2
89                         FROM ".TB_PREF."debtors_master debtor
90                                  LEFT JOIN ".TB_PREF."debtor_trans trans ON trans.tran_date <= '$todate' AND debtor.debtor_no = trans.debtor_no AND trans.type <> ".ST_CUSTDELIVERY."
91                                  LEFT JOIN ".TB_PREF."payment_terms terms ON debtor.payment_terms = terms.id,"
92                                  .TB_PREF."credit_status credit_status
93                         WHERE
94                                 debtor.credit_status = credit_status.id";
95          if ($customer_id)
96                 $sql .= " AND debtor.debtor_no = ".db_escape($customer_id);
97
98         if (!$all)
99                 $sql .= " AND ABS(trans.ov_amount + trans.ov_gst + trans.ov_freight + trans.ov_freight_tax + trans.ov_discount - trans.alloc) > ".FLOAT_COMP_DELTA;
100         $sql .= " GROUP BY
101                                 debtor.name,
102                                 debtor.credit_limit,
103                                 credit_status.dissallow_invoices,
104                                 credit_status.reason_description";
105     $result = db_query($sql,"The customer details could not be retrieved");
106
107     $customer_record = db_fetch($result);
108
109     return $customer_record;
110
111 }
112
113
114 function get_customer($customer_id)
115 {
116         $sql = "SELECT * FROM ".TB_PREF."debtors_master WHERE debtor_no=".db_escape($customer_id);
117
118         $result = db_query($sql, "could not get customer");
119
120         return db_fetch($result);
121 }
122
123 function get_customer_name($customer_id)
124 {
125         $sql = "SELECT name FROM ".TB_PREF."debtors_master WHERE debtor_no=".db_escape($customer_id);
126
127         $result = db_query($sql, "could not get customer");
128
129         $row = db_fetch_row($result);
130
131         return $row[0];
132 }
133
134 function get_customer_habit($customer_id)
135 {
136         $sql = "SELECT debtor.pymt_discount, credit_status.dissallow_invoices
137                         FROM ".TB_PREF."debtors_master debtor,"
138                                 .TB_PREF."credit_status credit_status
139                         WHERE debtor.credit_status = credit_status.id
140                         AND debtor.debtor_no = ".db_escape($customer_id);
141
142         $result = db_query($sql, "could not query customers");
143
144         return db_fetch($result);
145 }
146
147 function get_customer_contacts($customer_id, $action=null)
148 {
149         $results = array();
150         $res = get_crm_persons('customer', $action, $customer_id);
151         while($contact = db_fetch($res))
152         {
153                 if ($contact['lang'] == 'C') // Fix for improper lang in demo sql files.
154                         $contact['lang'] = '';
155                 $results[] = $contact;
156         }       
157         return $results;
158 }
159
160 function get_current_cust_credit($customer_id)
161 {
162         $custdet = get_customer_details($customer_id);
163
164         return $custdet['credit_limit']-$custdet['Balance'];
165
166 }
167
168 function is_new_customer($id)
169 {
170         $tables = array('cust_branch', 'debtor_trans', 'recurrent_invoices', 'sales_orders');
171
172         return !key_in_foreign_table($id, $tables, 'debtor_no');
173 }
174
175 function get_customer_by_ref($reference)
176 {
177         $sql = "SELECT * FROM ".TB_PREF."debtors_master WHERE debtor_ref=".db_escape($reference);
178
179         $result = db_query($sql, "could not get customer");
180
181         return db_fetch($result);
182 }
183
184 //----------------------------------------------------------------------------------
185
186 function get_customer_currency($customer_id=null, $branch_id=null)
187 {
188     $sql = "SELECT curr_code
189         FROM ".TB_PREF."debtors_master cust
190                 LEFT JOIN ".TB_PREF."cust_branch branch ON branch.debtor_no=cust.debtor_no
191         WHERE " .(isset($branch_id) ? "branch_code = ".db_escape($branch_id) : "cust.debtor_no = ".db_escape($customer_id));
192
193         $result = db_query($sql, "Retreive currency of customer $customer_id");
194
195         $myrow=db_fetch_row($result);
196         return $myrow[0];
197 }
198
199 function get_customers_search($customer)
200 {
201         global $SysPrefs;
202
203         if (isset($SysPrefs->max_rows_in_search))
204                 $limit = $SysPrefs->max_rows_in_search;
205         else
206                 $limit = 10;
207
208         $sql = "SELECT debtor_no, name, debtor_ref, address, tax_id FROM ".TB_PREF."debtors_master 
209           WHERE (  name LIKE " . db_escape("%" . $customer. "%") . " OR 
210                  debtor_ref LIKE " . db_escape("%" . $customer. "%") . " OR 
211                 address LIKE " . db_escape("%" . $customer. "%") . " OR 
212              tax_id LIKE " . db_escape("%" . $customer. "%").")
213           ORDER BY name LIMIT 0,".(int)($limit);
214
215         return db_query($sql, "Failed in retreiving customer list.");
216 }