sales/includes/sales_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 include_once($path_to_root . "/includes/banking.inc");
  13 include_once($path_to_root . "/includes/inventory.inc");
  14 include_once($path_to_root . "/includes/db/allocations_db.inc");
  15 include_once($path_to_root . "/sales/includes/db/sales_order_db.inc");
  16 include_once($path_to_root . "/sales/includes/db/sales_credit_db.inc");
  17 include_once($path_to_root . "/sales/includes/db/sales_invoice_db.inc");
  18 include_once($path_to_root . "/sales/includes/db/sales_delivery_db.inc");
  19 include_once($path_to_root . "/sales/includes/db/sales_types_db.inc");
  20 include_once($path_to_root . "/sales/includes/db/sales_points_db.inc");
  21 include_once($path_to_root . "/sales/includes/db/sales_groups_db.inc");
  22 include_once($path_to_root . "/sales/includes/db/recurrent_invoices_db.inc");
  23 include_once($path_to_root . "/sales/includes/db/custalloc_db.inc");
  24 include_once($path_to_root . "/sales/includes/db/cust_trans_db.inc");
  25 include_once($path_to_root . "/sales/includes/db/cust_trans_details_db.inc");
  26 include_once($path_to_root . "/sales/includes/db/payment_db.inc");
  27 include_once($path_to_root . "/sales/includes/db/branches_db.inc");
  28 include_once($path_to_root . "/sales/includes/db/customers_db.inc");
  29
  30 //----------------------------------------------------------------------------------------
  31 // add a debtor-related gl transaction
  32 // $date_ is display date (non-sql)
  33 // $amount is in CUSTOMER'S currency
  34
  35 function add_gl_trans_customer($type, $type_no, $date_, $account, $dimension, $dimension2,
  36         $amount, $customer_id, $err_msg="", $rate=0)
  37 {
  38         if ($err_msg == "")
  39                 $err_msg = "The customer GL transaction could not be inserted";
  40
  41         return add_gl_trans($type, $type_no, $date_, $account, $dimension, $dimension2, "", $amount,
  42                 get_customer_currency($customer_id),
  43                 PT_CUSTOMER, $customer_id, $err_msg, $rate);
  44 }
  45
  46 //----------------------------------------------------------------------------------------
  47
  48 function get_calculated_price($stock_id, $add_pct)
  49 {
  50         $avg = get_standard_cost($stock_id);
  51         if ($avg == 0)
  52                 return 0;
  53         return round2($avg * (1 + $add_pct / 100), user_price_dec());
  54 }
  55
  56 function round_to_nearest($price, $round_to)
  57 {
  58         if ($price == 0)
  59                 return 0;
  60         $pow = pow(10, user_price_dec());
  61         if ($pow >= $round_to)
  62                 $mod = ($pow % $round_to);
  63         else
  64                 $mod = ($round_to % $pow);
  65         if ($mod != 0)
  66                 $price = ceil($price) - ($pow - $round_to) / $pow;
  67         else
  68         $price = ceil($price * ($pow / $round_to)) / ($pow / $round_to);
  69     return $price;
  70
  71 }
  72
  73 function get_price ($stock_id, $currency, $sales_type_id, $factor=null, $date=null)
  74 {
  75         if ($date == null)
  76             $date = new_doc_date();
  77
  78         if ($factor === null)
  79         {
  80                 $myrow = get_sales_type($sales_type_id);
  81                 $factor = $myrow['factor'];
  82         }
  83
  84         $add_pct = get_company_pref('add_pct');
  85         $base_id = get_base_sales_type();
  86     $home_curr = get_company_currency();
  87         //      AND (sales_type_id = $sales_type_id     OR sales_type_id = $base_id)
  88         $sql = "SELECT price, curr_abrev, sales_type_id
  89                 FROM ".TB_PREF."prices
  90                 WHERE stock_id = ".db_escape($stock_id)."
  91                         AND (curr_abrev = ".db_escape($currency)." OR curr_abrev = ".db_escape($home_curr).")";
  92
  93         $result = db_query($sql, "There was a problem retrieving the pricing information for the part $stock_id for customer");
  94         $num_rows = db_num_rows($result);
  95         $rate = round2(get_exchange_rate_from_home_currency($currency, $date),
  96             user_exrate_dec());
  97         $round_to = get_company_pref('round_to');
  98         $prices = array();
  99         while($myrow = db_fetch($result))
 100         {
 101             $prices[$myrow['sales_type_id']][$myrow['curr_abrev']] = $myrow['price'];
 102         }
 103         $price = false;
 104         if (isset($prices[$sales_type_id][$currency]))
 105         {
 106             $price = $prices[$sales_type_id][$currency];
 107         }
 108         elseif (isset($prices[$base_id][$currency]))
 109         {
 110             $price = $prices[$base_id][$currency] * $factor;
 111         }
 112         elseif (isset($prices[$sales_type_id][$home_curr]))
 113         {
 114             $price = $prices[$sales_type_id][$home_curr] / $rate;
 115         }
 116         elseif (isset($prices[$base_id][$home_curr]))
 117         {
 118             $price = $prices[$base_id][$home_curr] * $factor / $rate;
 119         }
 120 /*
 121         if (isset($prices[$sales_type_id][$home_curr]))
 122         {
 123             $price = $prices[$sales_type_id][$home_curr] / $rate;
 124         }
 125         elseif (isset($prices[$base_id][$currency]))
 126         {
 127             $price = $prices[$base_id][$currency] * $factor;
 128         }
 129         elseif (isset($prices[$base_id][$home_curr]))
 130         {
 131             $price = $prices[$base_id][$home_curr] * $factor / $rate;
 132         }
 133 */
 134         elseif ($num_rows == 0 && $add_pct != -1)
 135         {
 136                 $price = get_calculated_price($stock_id, $add_pct);
 137                 if ($currency != $home_curr)
 138                         $price /= $rate;
 139                 if ($factor != 0)
 140                         $price *= $factor;
 141         }
 142         if ($price === false)
 143                 return 0;
 144         elseif ($round_to != 1)
 145                 return round_to_nearest($price, $round_to);
 146         else
 147                 return round2($price, user_price_dec());
 148 }
 149 //----------------------------------------------------------------------------------------
 150 //
 151 //      Get price for given item or kit.
 152 //  When $std==true price is calculated as a sum of all included stock items,
 153 //      otherwise all prices set for kits and items are accepted.
 154 //
 155 function get_kit_price($item_code, $currency, $sales_type_id, $factor=null,
 156         $date=null, $std = false)
 157 {
 158         $kit_price = 0.00;
 159         if (!$std) {
 160                 $kit_price = get_price( $item_code, $currency, $sales_type_id,
 161                         $factor, $date);
 162
 163                 if ($kit_price !== 0) {
 164                         return $kit_price;
 165                 }
 166         }
 167         // no price for kit found, get total value of all items
 168         $kit = get_item_kit($item_code);
 169
 170         while($item = db_fetch($kit)) {
 171                 if ($item['item_code'] != $item['stock_id']) {
 172                         // foreign/kit code
 173                         $kit_price += $item['quantity'] * get_kit_price( $item['stock_id'],
 174                                 $currency, $sales_type_id, $factor, $date, $std);
 175
 176                 } else {
 177                         // stock item
 178                         $kit_price += $item['quantity'] * get_price( $item['stock_id'],
 179                                 $currency, $sales_type_id, $factor, $date);
 180                 }
 181         }
 182         return $kit_price;
 183 }
 184
 185 //--------------------------------------------------------------------------------------------------
 186 function update_parent_line($doc_type, $line_id, $qty_dispatched, $auto=false)
 187 {
 188         $doc_type = get_parent_type($doc_type);
 189
 190         $qty_dispatched = (float)$qty_dispatched;
 191
 192 //      echo "update line: $line_id, $doc_type, $qty_dispatched";
 193         if ($doc_type == 0)
 194                 return false;
 195         else {
 196                 if ($doc_type==ST_SALESORDER || $doc_type==ST_SALESQUOTE)
 197                 {
 198                         $sql = "UPDATE ".TB_PREF."sales_order_details
 199                                 SET qty_sent = qty_sent + $qty_dispatched";
 200                         if ($auto)
 201                                 $sql .= ", quantity = quantity + $qty_dispatched";
 202                         $sql .= " WHERE id=".db_escape($line_id);
 203                 }
 204                 else
 205                         $sql = "UPDATE ".TB_PREF."debtor_trans_details
 206                                 SET qty_done = qty_done + $qty_dispatched
 207                                 WHERE id=".db_escape($line_id);
 208         }
 209         db_query($sql, "The parent document detail record could not be updated");
 210         return true;
 211 }
 212
 213 //--------------------------------------------------------------------------------------------------
 214 // find inventory location for given transaction
 215 //
 216 function get_location(&$cart)
 217 {
 218         $sql = "SELECT ".TB_PREF."locations.* FROM ".TB_PREF."stock_moves,"
 219                 .TB_PREF."locations".
 220                 " WHERE type=".db_escape($cart->trans_type).
 221                 " AND trans_no=".key($cart->trans_no).
 222                 " AND qty!=0 ".
 223                 " AND ".TB_PREF."locations.loc_code=".TB_PREF."stock_moves.loc_code";
 224         $result = db_query($sql, 'Retreiving inventory location');
 225
 226
 227         if (db_num_rows($result)) {
 228                 return db_fetch($result);
 229         }
 230         return null;
 231 }
 232 //--------------------------------------------------------------------------------------------------
 233 // Generic read debtor transaction into cart
 234 //
 235 //      $trans_no - array of trans nums; special case trans_no==0 - new doc
 236 //
 237 function read_sales_trans($doc_type, $trans_no, &$cart)
 238 {
 239         if (!is_array($trans_no) && $trans_no)
 240                         $trans_no = array($trans_no);
 241
 242         $cart->trans_type = $doc_type;
 243         if (!$trans_no) { // new document
 244                 $cart->trans_no = $trans_no;
 245         } else {
 246                 // read header data from first document
 247                 $myrow = get_customer_trans($trans_no[0],$doc_type);
 248                 if (count($trans_no)>1)
 249                         $cart->trans_no = get_customer_trans_version($doc_type, $trans_no);
 250                 else
 251                         $cart->trans_no = array($trans_no[0]=>$myrow["version"]);
 252
 253                 $cart->set_sales_type($myrow["tpe"], $myrow["sales_type"], $myrow["tax_included"],0);
 254
 255                 $cart->set_customer($myrow["debtor_no"], $myrow["DebtorName"],
 256                         $myrow["curr_code"], $myrow["discount"], $myrow["payment_terms"]);
 257
 258                 $cart->set_branch($myrow["branch_code"], $myrow["tax_group_id"],
 259                         $myrow["tax_group_name"]);
 260
 261                 $cart->reference = $myrow["reference"];
 262                 $cart->prepaid = $myrow["prepaid"];
 263                 $cart->order_no = $myrow["order_"];
 264                 $cart->due_date = sql2date($myrow["due_date"]);
 265                 $cart->document_date = sql2date($myrow["tran_date"]);
 266                 $cart->dimension_id = $myrow['dimension_id']; // added 2.1 Joe Hunt 2008-11-12
 267                 $cart->dimension2_id = $myrow['dimension2_id'];
 268                 $cart->Comments = '';
 269                 foreach ( $trans_no as $trans ) {
 270                         $cart->Comments .= get_comments_string($doc_type,$trans);
 271                 }
 272
 273                 // FIX this should be calculated sum() for multiply parents
 274
 275                 $cart->set_delivery($myrow["ship_via"], $myrow["br_name"],
 276                 $myrow["br_address"], $myrow["ov_freight"]);
 277
 278                 $location = 0;
 279                 $myrow = get_location($cart); // find location from movement
 280
 281                 if($myrow!=null) {
 282                         $cart->set_location($myrow['loc_code'], $myrow['location_name']);
 283                 }
 284
 285                 $result = get_customer_trans_details($doc_type,$trans_no);
 286                 if (db_num_rows($result) > 0) {
 287                         for($line_no=0; $myrow = db_fetch($result); $line_no++) {
 288                                 $cart->line_items[$line_no] = new line_details(
 289                                         $myrow["stock_id"],$myrow["quantity"],
 290                                         $myrow["unit_price"], $myrow["discount_percent"],
 291                                         $myrow["qty_done"], $myrow["standard_cost"],
 292                                         $myrow["StockDescription"],$myrow["id"], $myrow["debtor_trans_no"],
 293                                         @$myrow["src_id"]);
 294                         }
 295                 }
 296                 $cart->prepayments = get_payments_for($trans_no, $doc_type);
 297
 298         } // !newdoc
 299
 300         return true;
 301 }
 302 //----------------------------------------------------------------------------------------
 303
 304 function get_sales_child_lines($trans_type, $trans_no, $lines=true)
 305 {
 306         if (!($ctype = get_child_type($trans_type)))
 307                 return false;
 308         if (!is_array($trans_no)) {
 309                 $trans_no = array($trans_no);
 310         }
 311
 312         $par_tbl = $trans_type == ST_SALESORDER ? "sales_order_details" : "debtor_trans_details";
 313         $par_no = $trans_type == ST_SALESORDER ? "trans.order_no" : "trans.debtor_trans_no";
 314
 315         foreach($trans_no as $n => $trans) {
 316                 $trans_no[$n] = db_escape($trans);
 317         }
 318         $sql = "SELECT child.*
 319                         FROM
 320                                 ".TB_PREF."debtor_trans_details child
 321                         LEFT JOIN ".TB_PREF."$par_tbl trans
 322                                 ON child.src_id=trans.id AND child.debtor_trans_type=$ctype
 323                         WHERE $par_no IN(". implode(',', array_values($trans_no)).")";
 324
 325         if (!$lines)
 326                 $sql .= " GROUP BY child.debtor_trans_no";
 327
 328         $sql .= " ORDER BY child.debtor_trans_no";
 329
 330         return db_query($sql, "can't retrieve child trans");
 331 }
 332
 333 function get_sales_child_numbers($trans_type, $trans_no)
 334 {
 335         $trans = array();
 336         $res = get_sales_child_lines($trans_type, $trans_no, false);
 337         while ($line = db_fetch($res)) {
 338                 $trans[] = $line['debtor_trans_no'];
 339         }
 340         return $trans;
 341 }
 342
 343 function get_sales_parent_lines($trans_type, $trans_no, $lines=true)
 344 {
 345         $partype = get_parent_type($trans_type);
 346
 347         if (!$partype)
 348                 return false;
 349
 350         $par_tbl = $partype == ST_SALESORDER ? "sales_order_details" : "debtor_trans_details";
 351         $par_no = $partype == ST_SALESORDER ? "parent.order_no" : "parent.debtor_trans_no";
 352         $sql = "SELECT parent.*
 353                         FROM
 354                                 ".TB_PREF."$par_tbl parent
 355                         LEFT JOIN ".TB_PREF."debtor_trans_details trans
 356                                 ON trans.src_id=parent.id
 357                         WHERE
 358                                 trans.debtor_trans_type=".db_escape($trans_type)
 359                                 ." AND trans.debtor_trans_no=".db_escape($trans_no);
 360         if (!$lines)
 361                 $sql .= " GROUP BY $par_no";
 362
 363         $sql .= " ORDER BY $par_no";
 364
 365         return db_query($sql, "can't retrieve child trans");
 366
 367 }
 368
 369 function get_sales_parent_numbers($trans_type, $trans_no)
 370 {
 371         $trans = array();
 372         $res = get_sales_parent_lines($trans_type, $trans_no, false);
 373         while ($line = db_fetch($res))
 374                 $trans[] = $line[$trans_type==ST_CUSTDELIVERY ? 'order_no' : 'debtor_trans_no'];
 375         return $trans;
 376 }
 377
 378 //----------------------------------------------------------------------------------------
 379
 380 function get_sales_child_documents($trans_type, $trans_no)
 381 {
 382         // FIXME -  credit notes retrieved here should be those linked to invoices containing
 383         // at least one line from related invoice
 384
 385         if (!count($trans_no))
 386                 return false;
 387         $childs = get_sales_child_numbers($trans_type, $trans_no, false);
 388         if (!count($childs))
 389                 return false;
 390
 391         $sql = "SELECT * FROM ".TB_PREF."debtor_trans
 392                 WHERE type=".get_child_type($trans_type)." AND trans_no IN(". implode(',', array_values($childs)).")";
 393
 394         return db_query($sql,"The related credit notes could not be retreived");
 395 }
 396