sales/includes/db/cust_trans_db.inc

   1 <?php
   2 //------------------------------------------------------------------------------
   3 //      Retreive parent document number(s) for given transaction
   4 //
   5 function get_parent_trans($trans_type, $trans_no) {
   6
   7         $sql = 'SELECT trans_link FROM
   8                         '.TB_PREF.'debtor_trans WHERE
   9                         (trans_no=' .$trans_no. ' AND type='.$trans_type.' AND trans_link!=0)';
  10
  11         $result = db_query($sql, 'Parent document numbers cannot be retrieved');
  12
  13         if (db_num_rows($result)) {
  14                 $link = db_fetch($result);
  15                 return array($link['trans_link']);
  16         }
  17         if ($trans_type!=10) return 0;  // this is credit note with no parent invoice
  18         // invoice: find batch invoice parent trans.
  19         $sql = 'SELECT trans_no FROM
  20                         '.TB_PREF.'debtor_trans WHERE
  21                         (trans_link='.$trans_no.' AND type='. get_parent_type($trans_type) .')';
  22
  23         $result = db_query($sql, 'Delivery links cannot be retrieved');
  24
  25         $delivery = array();
  26         if(db_num_rows($result)>0) {
  27                 while($link = db_fetch($result)) {
  28                         $delivery[] = $link['trans_no'];
  29                 }
  30         }
  31         return count($delivery) ? $delivery : 0;
  32 }
  33
  34 //----------------------------------------------------------------------------------------
  35 // Mark changes in debtor_trans_details
  36 //
  37 function update_customer_trans_version($type, $versions) {
  38
  39         $sql= 'UPDATE '.TB_PREF. 'debtor_trans SET version=version+1
  40                         WHERE type='.$type. ' AND (';
  41
  42         foreach ($versions as $trans_no=>$version)
  43                 $where[] =      '(trans_no='.$trans_no.
  44                         ' AND version='.$version.')';
  45
  46                 $sql .= implode(' OR ', $where) .')';
  47
  48         return  db_query($sql, 'Concurrent editing conflict');
  49 }
  50
  51 //----------------------------------------------------------------------------------------
  52 // Gets document header versions for transaction set of type $type
  53 // $trans_no = array(num1, num2,...);
  54 // returns array(num1=>ver1, num2=>ver2...)
  55 //
  56 function get_customer_trans_version($type, $trans_no) {
  57         if (!is_array($trans_no))
  58                 $trans_no = array( $trans_no );
  59
  60         $sql= 'SELECT trans_no, version FROM '.TB_PREF. 'debtor_trans
  61                         WHERE type='.$type.' AND (';
  62
  63         foreach ($trans_no as $key=>$trans)
  64                 $trans_no[$key] =       'trans_no='.$trans_no[$key];
  65
  66         $sql .= implode(' OR ', $trans_no) . ')';
  67
  68         $res = db_query($sql, 'document version retreival');
  69
  70         $vers = array();
  71         while($mysql=db_fetch($res)) {
  72                 $vers[$mysql['trans_no']] = $mysql['version'];
  73         }
  74         return $vers;
  75 }
  76 //----------------------------------------------------------------------------------------
  77 // $Total, $Tax, $Freight, $discount all in customer's currency
  78 // date_ is display date (non-sql)
  79 function write_customer_trans($trans_type, $trans_no, $debtor_no, $BranchNo,
  80         $date_, $reference, $Total, $discount=0, $Tax=0, $Freight=0, $FreightTax=0,
  81         $sales_type=0, $order_no=0, $trans_link=0, $ship_via=0, $due_date="",
  82         $AllocAmt=0)
  83 {
  84
  85         $curr = get_customer_currency($debtor_no);
  86         $rate = get_exchange_rate_from_home_currency($curr, $date_);
  87
  88         $SQLDate = date2sql($date_);
  89         if ($due_date == "")
  90                 $SQLDueDate = "000-00-00";
  91         else
  92                 $SQLDueDate = date2sql($due_date);
  93
  94         if ($trans_no==0) {
  95         $trans_no = get_next_trans_no($trans_type);
  96
  97         $sql = "INSERT INTO ".TB_PREF."debtor_trans (
  98                 trans_no, type,
  99                 debtor_no, branch_code,
 100                 tran_date, due_date,
 101                 reference, tpe,
 102                 order_, ov_amount, ov_discount,
 103                 ov_gst, ov_freight, ov_freight_tax,
 104                 rate, ship_via, alloc, trans_link
 105                 ) VALUES ($trans_no, $trans_type,
 106                 ".db_escape($debtor_no).", ".db_escape($BranchNo).",
 107                 '$SQLDate', '$SQLDueDate', ".db_escape($reference).",
 108                 ".db_escape($sales_type).", $order_no, $Total, ".db_escape($discount).", $Tax,
 109                 ".db_escape($Freight).",
 110                 $FreightTax, $rate, ".db_escape($ship_via).", $AllocAmt, ".db_escape($trans_link).")";
 111         } else {        // may be optional argument should stay unchanged ?
 112         $sql = "UPDATE ".TB_PREF."debtor_trans SET
 113                 debtor_no=".db_escape($debtor_no)." , branch_code=".db_escape($BranchNo).",
 114                 tran_date='$SQLDate', due_date='$SQLDueDate',
 115                 reference=".db_escape($reference).", tpe=".db_escape($sales_type).", order_=$order_no,
 116                 ov_amount=$Total, ov_discount=".db_escape($discount).", ov_gst=$Tax,
 117                 ov_freight=".db_escape($Freight).", ov_freight_tax=$FreightTax, rate=$rate,
 118                 ship_via=".db_escape($ship_via).", alloc=$AllocAmt, trans_link=$trans_link
 119                 WHERE trans_no=$trans_no AND type=$trans_type";
 120         }
 121         db_query($sql, "The debtor transaction record could not be inserted");
 122
 123         return $trans_no;
 124 }
 125
 126 //----------------------------------------------------------------------------------------
 127
 128 function get_customer_trans($trans_id, $trans_type)
 129 {
 130         $sql = "SELECT ".TB_PREF."debtor_trans.*,
 131                 ov_amount+ov_gst+ov_freight+ov_freight_tax+ov_discount AS Total,
 132                 ".TB_PREF."debtors_master.name AS DebtorName, ".TB_PREF."debtors_master.address, ".TB_PREF."debtors_master.email AS email2,
 133                 ".TB_PREF."debtors_master.curr_code, ".TB_PREF."debtors_master.tax_id, ".TB_PREF."debtors_master.payment_terms ";
 134
 135         if ($trans_type == systypes::cust_payment()) {
 136                 // it's a payment so also get the bank account
 137                 $sql .= ", ".TB_PREF."bank_accounts.bank_name, ".TB_PREF."bank_accounts.bank_account_name,
 138                         ".TB_PREF."bank_trans_types.name AS BankTransType ";
 139         }
 140
 141         if ($trans_type == 10 OR $trans_type == 11 OR $trans_type == 13) {
 142                 // it's an invoice so also get the shipper and salestype
 143                 $sql .= ", ".TB_PREF."shippers.shipper_name, "
 144                 .TB_PREF."sales_types.sales_type, "
 145                 .TB_PREF."sales_types.tax_included, "
 146                 .TB_PREF."cust_branch.*, "
 147                 .TB_PREF."debtors_master.discount, "
 148                 .TB_PREF."tax_groups.name AS tax_group_name, "
 149                 .TB_PREF."tax_groups.id AS tax_group_id ";
 150         }
 151
 152
 153         $sql .= " FROM ".TB_PREF."debtor_trans, ".TB_PREF."debtors_master ";
 154
 155         if ($trans_type == systypes::cust_payment()) {
 156                 // it's a payment so also get the bank account
 157                 $sql .= ", ".TB_PREF."bank_trans, ".TB_PREF."bank_accounts, ".TB_PREF."bank_trans_types ";
 158         }
 159
 160         if ($trans_type == 10 OR $trans_type == 11 OR $trans_type == 13) {
 161                 // it's an invoice so also get the shipper, salestypes
 162                 $sql .= ", ".TB_PREF."shippers, ".TB_PREF."sales_types, ".TB_PREF."cust_branch, ".TB_PREF."tax_groups ";
 163         }
 164
 165         $sql .= " WHERE ".TB_PREF."debtor_trans.trans_no=$trans_id
 166                 AND ".TB_PREF."debtor_trans.type=$trans_type
 167                 AND ".TB_PREF."debtor_trans.debtor_no=".TB_PREF."debtors_master.debtor_no";
 168
 169         if ($trans_type == systypes::cust_payment()) {
 170                 // it's a payment so also get the bank account
 171                 $sql .= " AND ".TB_PREF."bank_trans.trans_no =$trans_id
 172                         AND ".TB_PREF."bank_trans.type=$trans_type
 173                         AND ".TB_PREF."bank_trans_types.id = ".TB_PREF."bank_trans.bank_trans_type_id
 174                         AND ".TB_PREF."bank_accounts.account_code=".TB_PREF."bank_trans.bank_act ";
 175         }
 176         if ($trans_type == 10 OR $trans_type == 11 OR $trans_type == 13) {
 177                 // it's an invoice so also get the shipper
 178                 $sql .= " AND ".TB_PREF."shippers.shipper_id=".TB_PREF."debtor_trans.ship_via
 179                         AND ".TB_PREF."sales_types.id = ".TB_PREF."debtor_trans.tpe
 180                         AND ".TB_PREF."cust_branch.branch_code = ".TB_PREF."debtor_trans.branch_code
 181                         AND ".TB_PREF."cust_branch.tax_group_id = ".TB_PREF."tax_groups.id ";
 182         }
 183
 184         $result = db_query($sql, "Cannot retreive a debtor transaction");
 185
 186         if (db_num_rows($result) == 0) {
 187                 // can't return nothing
 188                 display_db_error("no debtor trans found for given params", $sql, true);
 189                 exit;
 190         }
 191
 192         if (db_num_rows($result) > 1) {
 193                 // can't return multiple
 194                 display_db_error("duplicate debtor transactions found for given params", $sql, true);
 195                 exit;
 196         }
 197
 198         //return db_fetch($result);
 199         $row = db_fetch($result);
 200         $row['email'] = $row['email2'];
 201         return $row;
 202 }
 203
 204 //----------------------------------------------------------------------------------------
 205
 206 function get_customer_transactions($extra_fields=null, $extra_conditions=null, $extra_tables=null)
 207 {
 208         $sql = "SELECT ".TB_PREF."debtor_trans.*,
 209                 ov_amount+ov_gst+ov_freight+ov_freight_tax+ov_discount AS Total,
 210                 ".TB_PREF."debtors_master.name AS DebtorName, ".TB_PREF."debtors_master.address,
 211                 ".TB_PREF."debtors_master.curr_code, ".TB_PREF."debtor_trans.version ";
 212
 213         if ($extra_fields)
 214                 $sql .= ", $extra_fields ";
 215
 216         $sql .= " FROM ".TB_PREF."debtor_trans, ".TB_PREF."debtors_master ";
 217         if ($extra_tables)
 218                 $sql .= ",$extra_tables ";
 219
 220         $sql .= " WHERE ".TB_PREF."debtor_trans.debtor_no=".TB_PREF."debtors_master.debtor_no";
 221
 222         if ($extra_conditions)
 223                 $sql .= " AND $extra_conditions ";
 224
 225         $sql .= " ORDER BY trans_no";
 226
 227         return db_query($sql, "Cannot retreive debtor transactions");
 228 }
 229
 230 //----------------------------------------------------------------------------------------
 231
 232 function exists_customer_trans($type, $type_no)
 233 {
 234         $sql = "SELECT trans_no FROM ".TB_PREF."debtor_trans WHERE type=$type
 235                 AND trans_no=$type_no";
 236
 237         $result = db_query($sql, "Cannot retreive a debtor transaction");
 238
 239         return (db_num_rows($result) > 0);
 240 }
 241
 242 //----------------------------------------------------------------------------------------
 243
 244 // retreives the related sales order for a given trans
 245
 246 function get_customer_trans_order($type, $type_no)
 247 {
 248         $sql = "SELECT order_ FROM ".TB_PREF."debtor_trans WHERE type=$type AND trans_no=$type_no";
 249
 250         $result = db_query($sql, "The debtor transaction could not be queried");
 251
 252         $row = db_fetch_row($result);
 253
 254         return $row[0];
 255 }
 256
 257 //----------------------------------------------------------------------------------------
 258
 259 function get_customer_details_from_trans($type, $type_no)
 260 {
 261         $sql = "SELECT ".TB_PREF."debtors_master.name, ".TB_PREF."debtors_master.curr_code, ".TB_PREF."cust_branch.br_name
 262                 FROM ".TB_PREF."debtors_master,".TB_PREF."cust_branch,".TB_PREF."debtor_trans
 263                 WHERE ".TB_PREF."debtor_trans.type=$type AND ".TB_PREF."debtor_trans.trans_no=$type_no
 264                 AND ".TB_PREF."debtors_master.debtor_no = ".TB_PREF."debtor_trans.debtor_no
 265                 AND     ".TB_PREF."cust_branch.branch_code = ".TB_PREF."debtor_trans.branch_code";
 266
 267         $result = db_query($sql, "could not get customer details from trans");
 268         return db_fetch($result);
 269 }
 270
 271 //----------------------------------------------------------------------------------------
 272
 273 function void_customer_trans($type, $type_no)
 274 {
 275         // clear all values and mark as void
 276         $sql = "UPDATE ".TB_PREF."debtor_trans SET ov_amount=0, ov_discount=0, ov_gst=0, ov_freight=0,
 277                 ov_freight_tax=0, alloc=0, version=version+1 WHERE type=$type AND trans_no=$type_no";
 278
 279         db_query($sql, "could not void debtor transactions for type=$type and trans_no=$type_no");
 280 }
 281
 282 //----------------------------------------------------------------------------------------
 283
 284 function post_void_customer_trans($type, $type_no)
 285 {
 286         switch ($type) {
 287                 case 10 :
 288                 case 11 :
 289                         void_sales_invoice($type, $type_no);
 290                         break;
 291                 case 13 :
 292                         void_sales_delivery($type, $type_no);
 293                         break;
 294                 case 12 :
 295                         void_customer_payment($type, $type_no);
 296                         break;
 297         }
 298 }
 299
 300 //----------------------------------------------------------------------------------------
 301
 302 function get_customer_trans_link($type, $type_no)
 303 {
 304         $row = db_query("SELECT trans_link from ".TB_PREF."debtor_trans
 305                 WHERE type=$type AND trans_no=$type_no",
 306                 "could not get transaction link for type=$type and trans_no=$type_no");
 307         return $row[0];
 308 }
 309 //----------------------------------------------------------------------------------------
 310
 311 ?>