sales/includes/ui/sales_order_ui.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 . "/sales/includes/cart_class.inc");
  13 include_once($path_to_root . "/includes/manufacturing.inc");
  14
  15 //--------------------------------------------------------------------------------
  16 function add_to_order(&$order, $new_item, $new_item_qty, $price, $discount)
  17 {
  18         // calculate item price to sum of kit element prices factor for
  19         // value distribution over all exploded kit items
  20          $std_price = get_kit_price($new_item, $order->customer_currency,
  21                 $order->sales_type,     $order->price_factor, get_post('OrderDate'), true);
  22
  23         if ($std_price == 0)
  24                 $price_factor = 0;
  25         else
  26                 $price_factor = $price/$std_price;
  27
  28         $kit = get_item_kit($new_item);
  29         $item_num = db_num_rows($kit);
  30
  31         while($item = db_fetch($kit)) {
  32                 $std_price = get_kit_price($item['stock_id'], $order->customer_currency,
  33                         $order->sales_type,     $order->price_factor, get_post('OrderDate'), true);
  34
  35                 // rounding differences are included in last price item in kit
  36                 $item_num--;
  37                 if ($item_num) {
  38                         $price -= $item['quantity']*$std_price*$price_factor;
  39                         $item_price = $std_price*$price_factor;
  40                 } else {
  41                         if ($item['quantity'])
  42                                 $price = $price/$item['quantity'];
  43                         $item_price = $price;
  44                 }
  45                 $item_price = round($item_price, user_price_dec());
  46
  47          if (!$item['is_foreign'] && $item['item_code'] != $item['stock_id'])
  48          {      // this is sales kit - recurse
  49                 add_to_order($order, $item['stock_id'], $new_item_qty*$item['quantity'],
  50                         $item_price, $discount, $std_price);
  51          }
  52          else
  53          {      // stock item record eventually with foreign code
  54
  55                 // check duplicate stock item
  56                 foreach ($order->line_items as $order_item)
  57                 {
  58                         if (strcasecmp($order_item->stock_id, $item['stock_id']) == 0)
  59                         {
  60                                 display_warning(_("For Part :").$item['stock_id']. " "
  61                                         . _("This item is already on this order. You have been warned."));
  62                                 break;
  63                         }
  64                 }
  65                 $order->add_to_cart (count($order->line_items), $item['stock_id'],
  66                         $new_item_qty*$item['quantity'], $item_price, $discount);
  67          }
  68         }
  69 }
  70 //---------------------------------------------------------------------------------
  71
  72 function get_customer_details_to_order(&$order, $customer_id, $branch_id)
  73 {
  74         $ret_error = "";
  75
  76         $myrow = get_customer_to_order($customer_id);
  77
  78         $name = $myrow['name'];
  79
  80         if ($myrow['dissallow_invoices'] == 1)
  81                 $ret_error = _("The selected customer account is currently on hold. Please contact the credit control personnel to discuss.");
  82
  83         $deliver = $myrow['address']; // in case no branch address use company address
  84
  85         $order->set_customer($customer_id, $name, $myrow['curr_code'],
  86                 $myrow['discount'], $myrow['pymt_discount']);
  87
  88         // the sales type determines the price list to be used by default
  89         $order->set_sales_type($myrow['salestype'], $myrow['sales_type'], $myrow['tax_included'],
  90             $myrow['factor']);
  91
  92         if ($order->trans_type != 30)
  93         {
  94                 $order->dimension_id = $myrow['dimension_id'];
  95                 $order->dimension2_id = $myrow['dimension2_id'];
  96         }
  97         $result = get_branch_to_order($customer_id, $branch_id);
  98
  99         if (db_num_rows($result) == 0)
 100         {
 101                 return _("The selected customer and branch are not valid, or the customer does not have any branches.");
 102         }
 103
 104         $myrow = db_fetch($result);
 105
 106         $order->set_branch($branch_id, $myrow["tax_group_id"],
 107         $myrow["tax_group_name"], $myrow["phone"], $myrow["email"]);
 108
 109         $address = trim($myrow["br_post_address"]) != '' ? $myrow["br_post_address"]
 110                 : (trim($myrow["br_address"]) != '' ? $myrow["br_address"]:$deliver);
 111
 112         $order->set_delivery($myrow["default_ship_via"], $myrow["br_name"],
 113                 $address);
 114         if ($order->trans_type == 10) {
 115                 $order->due_date = get_invoice_duedate($customer_id, $order->document_date);
 116                 if ($order->pos != -1)
 117                         $order->cash = date_diff($order->due_date, Today(), 'd')<2;
 118         }
 119         if($order->cash ) {
 120                 if($order->pos != -1) {
 121                 $paym = get_sales_point($order->pos);
 122                 $order->set_location($paym["pos_location"], $paym["location_name"]);
 123                 }
 124         } else
 125                 $order->set_location($myrow["default_location"], $myrow["location_name"]);
 126
 127         return $ret_error;
 128 }
 129
 130 //---------------------------------------------------------------------------------
 131
 132 function display_order_summary($title, &$order, $editable_items=false)
 133 {
 134         global $table_style, $path_to_root;
 135
 136         display_heading($title);
 137
 138     div_start('items_table');
 139         start_table("$table_style colspan=7 width=90%");
 140         $th = array(_("Item Code"), _("Item Description"), _("Quantity"),
 141                 _("Delivered"),
 142                 _("Unit"), _("Price"), _("Discount %"), _("Total"), "");
 143
 144         if ($order->trans_no == 0) {
 145         unset( $th[3] );
 146         }
 147
 148         if (count($order->line_items))
 149              $th[]= '';
 150
 151         table_header($th);
 152
 153         $total = 0;
 154         $k = 0;  //row colour counter
 155
 156         $id = find_submit('Edit');
 157         $has_marked = false;
 158         foreach ($order->line_items as $line_no=>$stock_item)
 159         {
 160
 161                 $line_total = round($stock_item->qty_dispatched * $stock_item->price * (1 - $stock_item->discount_percent),
 162                    user_price_dec());
 163
 164                 $qoh_msg = '';
 165                 if (!$editable_items || $id != $line_no)
 166                 {
 167                         if (!sys_prefs::allow_negative_stock() && is_inventory_item($stock_item->stock_id)) {
 168                                 $qoh = get_qoh_on_date($stock_item->stock_id,
 169                                         $_POST['Location'], $_POST['OrderDate']);
 170                                 if ($stock_item->qty_dispatched > $qoh)
 171                                 {
 172                                         // oops, we don't have enough of one of the component items
 173                                         start_row("class='stockmankobg'");
 174                                         $qoh_msg .= $stock_item->stock_id . " - " . $stock_item->item_description . ": " .
 175                                         _("Quantity On Hand") . " = "
 176                                         . number_format2($qoh, get_qty_dec($stock_item->stock_id)) . '<br>';
 177                                         $has_marked = true;
 178                                  } else
 179                                         alt_table_row_color($k);
 180                         } else {
 181                                 alt_table_row_color($k);
 182                         }
 183
 184                         view_stock_status_cell($stock_item->stock_id);
 185
 186                         //label_cell($stock_item->item_description, "nowrap" );
 187                         label_cell($stock_item->item_description );
 188                         qty_cell($stock_item->qty_dispatched, false, get_qty_dec($stock_item->stock_id));
 189
 190                         if ($order->trans_no!=0)
 191                                 amount_cell($stock_item->qty_done);
 192
 193                         label_cell($stock_item->units);
 194                         amount_cell($stock_item->price);
 195
 196                         percent_cell($stock_item->discount_percent * 100);
 197                         amount_cell($line_total);
 198
 199                         if ($editable_items)
 200                         {
 201                                 edit_button_cell("Edit$line_no", _("Edit"),
 202                                 _('Edit document line'));
 203                                 delete_button_cell("Delete$line_no", _("Delete"),
 204                                 _('Remove line from document'));
 205                         }
 206                         end_row();
 207                 }
 208                 else
 209                 {
 210                         sales_order_item_controls($order, $k,  $line_no);
 211                 }
 212
 213                 $total += $line_total;
 214         }
 215
 216         if ($id==-1 && $editable_items)
 217                 sales_order_item_controls($order, $k);
 218
 219         $display_total = price_format($total);
 220         label_row(_("Total Excluding Shipping"), $display_total, "colspan=6 align=right",
 221                 "nowrap align=right", 2);
 222
 223         end_table();
 224         if ($has_marked) {
 225                 display_note(_("Marked items have insufficient quantities in stock as on day of delivery."), 0, 1, "class='stockmankofg'");
 226                 if ($order->trans_type!=30 && !sys_prefs::allow_negative_stock())
 227                         display_error(_("The delivery cannot be processed because there is an insufficient quantity for item:")
 228                                 . '<br>'. $qoh_msg);
 229         }
 230     div_end();
 231 }
 232
 233 // ------------------------------------------------------------------------------
 234
 235 function display_order_header(&$order, $editable, $date_text, $display_tax_group=false)
 236 {
 237         global $table_style, $Ajax;
 238
 239         start_outer_table("width=80% $table_style");
 240
 241         table_section(1);
 242
 243         $customer_error = "";
 244         $change_prices = 0;
 245
 246         if (isset($order) && !$editable)
 247         {
 248                 // can't change the customer/branch if items already received on this order
 249                 //echo $order->customer_name . " - " . $order->deliver_to;
 250                 label_row(null, $order->customer_name . " - " . $order->deliver_to);
 251                 hidden('customer_id', $order->customer_id);
 252                 hidden('branch_id', $order->Branch);
 253                 hidden('sales_type', $order->sales_type);
 254                 if ($order->trans_type != 30) {
 255                         hidden('dimension_id', $order->dimension_id); // 2008-11-12 Joe Hunt
 256                         hidden('dimension2_id', $order->dimension2_id);
 257                 }
 258         }
 259         else
 260         {
 261                 customer_list_row(_("Customer:"), 'customer_id', null, false, true);
 262
 263                 if ($order->customer_id != get_post('customer_id', -1))
 264                 {
 265                         // customer has changed
 266                         $Ajax->activate('branch_id');
 267                 }
 268                 customer_branches_list_row(_("Branch:"),
 269                   $_POST['customer_id'], 'branch_id', null, false, true, true);
 270
 271                 if( ($order->customer_id != get_post('customer_id', -1)) ||
 272                         ($order->Branch != get_post('branch_id', -1)) ||
 273                         list_updated('customer_id'))
 274                 {
 275
 276                         if (!isset($_POST['branch_id']) || $_POST['branch_id'] == "")
 277                         {
 278                                 // ignore errors on customer search box call
 279                                 if ($_POST['customer_id'] == '')
 280                                         $customer_error = _("No customer found for entered text.");
 281                                 else
 282                                         $customer_error = _("The selected customer does not have any branches. Please create at least one branch.");
 283                                 unset($_POST['branch_id']);
 284                                 $order->Branch = 0;
 285                         }
 286                         else
 287                         {
 288
 289                                 $old_order = (PHP_VERSION<5) ? $order : clone( $order );
 290
 291                                 $customer_error = get_customer_details_to_order($order, $_POST['customer_id'], $_POST['branch_id']);
 292                                 $_POST['Location'] = $order->Location;
 293                                 $_POST['deliver_to'] = $order->deliver_to;
 294                                 $_POST['delivery_address'] = $order->delivery_address;
 295                                 $_POST['phone'] = $order->phone;
 296                                 if (get_post('cash') !== $order->cash) {
 297                                         $_POST['cash'] = $order->cash;
 298                                         $Ajax->activate('delivery');
 299                                         $Ajax->activate('cash');
 300                                 } else {
 301                                         if ($order->trans_type == 10)
 302                                         {
 303                                                 $_POST['delivery_date'] = $order->due_date;
 304                                                 $Ajax->activate('delivery_date');
 305                                         }
 306                                         $Ajax->activate('Location');
 307                                         $Ajax->activate('deliver_to');
 308                                         $Ajax->activate('phone');
 309                                         $Ajax->activate('delivery_address');
 310                                 }
 311                                 // change prices if necessary
 312                                 // what about discount in template case?
 313                                 if ($old_order->customer_currency != $order->customer_currency) {
 314                                         $change_prices = 1;
 315                                 }
 316                                 if ($old_order->sales_type != $order->sales_type) {
 317                                 //  || $old_order->default_discount!=$order->default_discount
 318                                         $_POST['sales_type'] = $order->sales_type;
 319                                         $Ajax->activate('sales_type');
 320                                         $change_prices = 1;
 321                                 }
 322                                 if ($old_order->dimension_id != $order->dimension_id) {
 323                                         $_POST['dimension_id'] = $order->dimension_id;
 324                                     $Ajax->activate('dimension_id');
 325                                 }
 326                                 if ($old_order->dimension2_id != $order->dimension2_id) {
 327                                         $_POST['dimension2_id'] = $order->dimension2_id;
 328                                     $Ajax->activate('dimension2_id');
 329                                 }
 330                                 unset($old_order);
 331                         }
 332                         set_global_customer($_POST['customer_id']);
 333                 } // changed branch
 334                 else
 335                 {
 336                         $row = get_customer_to_order($_POST['customer_id']);
 337                         if ($row['dissallow_invoices'] == 1)
 338                                 $customer_error = _("The selected customer account is currently on hold. Please contact the credit control personnel to discuss.");
 339
 340                 }
 341         }
 342
 343         if ($order->trans_type != 30) {
 344                 ref_cells(_("Reference").':', 'ref', _('Reference number unique for this document type'), null, '');
 345         }
 346
 347         if (!is_company_currency($order->customer_currency))
 348         {
 349             table_section(2);
 350
 351                 label_row(_("Customer Currency:"), $order->customer_currency);
 352                 exchange_rate_display($order->customer_currency, get_company_currency(),
 353                         ($editable ? $_POST['OrderDate'] : $order->document_date));
 354         }
 355         table_section(3);
 356
 357         if ($order->trans_type == 10 && $order->pos != -1) {
 358                 sale_payment_list_cells(_('Payment:'), 'cash', null, true);
 359                 $cash_payment = get_post('cash', 0);
 360                 // current user can issue both credit and cash invoices
 361                 if ($order->cash != $cash_payment) {
 362                         $order->cash = $cash_payment;
 363                         if ($cash_payment) {
 364                                 $paym = get_sales_point(user_pos());
 365                                 $order->cash_account = $paym['pos_account'];
 366                                 $order->account_name = $paym['bank_account_name'];
 367                                 $_POST['Location'] = $order->Location = $paym['pos_location'];
 368                                 $order->location_name = $paym['location_name'];
 369                         }
 370                         $Ajax->activate('items_table');
 371                         $Ajax->activate('delivery');
 372                         set_focus($order->pos == -1 ? 'delivery_date' : 'account');
 373                 }
 374         } else
 375                 hidden('cash', $order->cash);
 376
 377         if($editable) {
 378                 $str = sales_types_list_row(_("Price List"), 'sales_type', null, true);
 379         } else {
 380                 label_row(_("Price List:"), $order->sales_type_name);
 381         }
 382         if ($order->sales_type != $_POST['sales_type']) {
 383                 $myrow = get_sales_type($_POST['sales_type']);
 384                 $order->set_sales_type($myrow['id'], $myrow['sales_type'],
 385                         $myrow['tax_included'], $myrow['factor']);
 386                 $Ajax->activate('sales_type');
 387                 $change_prices = 1;
 388         }
 389
 390         label_row(_("Customer Discount:"), ($order->default_discount * 100) . "%");
 391
 392         table_section(4);
 393
 394         if ($editable)
 395         {
 396                 if (!isset($_POST['OrderDate']) || $_POST['OrderDate'] == "")
 397                         $_POST['OrderDate'] = $order->document_date;
 398
 399                 date_row($date_text, 'OrderDate', _('Date of order receive'),
 400                         $order->trans_no==0, 0, 0, 0, null, true);
 401                 if (isset($_POST['_OrderDate_changed'])) {
 402                         if (!is_company_currency($order->customer_currency)
 403                                 && (get_base_sales_type()>0)) {
 404                                         $change_prices = 1;
 405                         }
 406                         $Ajax->activate('_ex_rate');
 407                         if ($order->trans_type == 10) {
 408                                 $_POST['delivery_date'] = get_invoice_duedate(get_post('customer_id'), get_post('OrderDate'));
 409                         } else
 410                                 $_POST['delivery_date'] = add_days(get_post('OrderDate'), sys_prefs::default_delivery_required_by());
 411                         $Ajax->activate('items_table');
 412                         $Ajax->activate('delivery_date');
 413                 }
 414                 if ($order->trans_type != 30)
 415                 {       // 2008-11-12 Joe Hunt added dimensions
 416                         $dim = get_company_pref('use_dimension');
 417                         if ($dim > 0)
 418                                 dimensions_list_row(_("Dimension").":", 'dimension_id',
 419                                         null, true, ' ', false, 1, false);
 420                         else
 421                                 hidden('dimension_id', 0);
 422                         if ($dim > 1)
 423                                 dimensions_list_row(_("Dimension")." 2:", 'dimension2_id',
 424                                         null, true, ' ', false, 2, false);
 425                         else
 426                                 hidden('dimension2_id', 0);
 427                 }
 428         }
 429         else
 430         {
 431                 label_row($date_text, $order->document_date);
 432                 hidden('OrderDate', $order->document_date);
 433         }
 434
 435         if ($display_tax_group)
 436         {
 437             label_row(_("Tax Group:"), $order->tax_group_name);
 438             hidden('tax_group_id', $order->tax_group_id);
 439         }
 440
 441         end_outer_table(1); // outer table
 442
 443         if ($change_prices != 0) {
 444                 foreach ($order->line_items as $line_no=>$item) {
 445                         $line = &$order->line_items[$line_no];
 446                         $line->price = get_kit_price($line->stock_id, $order->customer_currency,
 447                                 $order->sales_type, $order->price_factor, get_post('OrderDate'));
 448                 //              $line->discount_percent = $order->default_discount;
 449                 }
 450             $Ajax->activate('items_table');
 451         }
 452
 453         return $customer_error;
 454 }
 455
 456 //--------------------------------------------------------------------------------
 457
 458 function sales_order_item_controls(&$order, &$rowcounter, $line_no=-1)
 459 {
 460     global $Ajax;
 461
 462         alt_table_row_color($rowcounter);
 463
 464         $id = find_submit('Edit');
 465         if ($line_no!=-1 && $line_no == $id) // edit old line
 466         {
 467                 $_POST['stock_id'] = $order->line_items[$id]->stock_id;
 468                 $dec = get_qty_dec($_POST['stock_id']);
 469                 $_POST['qty'] = number_format2($order->line_items[$id]->qty_dispatched, $dec);
 470                 $_POST['price'] = price_format($order->line_items[$id]->price);
 471                 $_POST['Disc'] = percent_format($order->line_items[$id]->discount_percent*100);
 472                 $_POST['item_description'] = $order->line_items[$id]->item_description;
 473                 $units = $order->line_items[$id]->units;
 474                 hidden('stock_id', $_POST['stock_id']);
 475                 label_cell($_POST['stock_id']);
 476                 text_cells(null,'item_description', null, 45, 150);
 477                 //label_cell($order->line_items[$line_no]->item_description, "nowrap");
 478             $Ajax->activate('items_table');
 479         }
 480         else    // prepare new line
 481         {
 482                 sales_items_list_cells(null,'stock_id', null, false, true);
 483                 if (list_updated('stock_id')) {
 484                             $Ajax->activate('price');
 485                             $Ajax->activate('units');
 486                             $Ajax->activate('qty');
 487                             $Ajax->activate('line_total');
 488                 }
 489
 490                 $item_info = get_item_edit_info($_POST['stock_id']);
 491                 $units = $item_info["units"];
 492                 $dec = $item_info['decimals'];
 493                 $_POST['qty'] = number_format2(1, $dec);
 494                 $price = get_kit_price($_POST['stock_id'],
 495                         $order->customer_currency, $order->sales_type,
 496                         $order->price_factor, get_post('OrderDate'));
 497                 $_POST['price'] = price_format($price);
 498                 // default to the customer's discount %
 499                 $_POST['Disc'] = percent_format($order->default_discount * 100);
 500         }
 501
 502         qty_cells(null, 'qty', $_POST['qty'], null, null, $dec);
 503
 504         if ($order->trans_no!=0) {
 505                 qty_cell($line_no==-1 ? 0 :$order->line_items[$line_no]->qty_done, false, $dec);
 506         }
 507
 508         label_cell($units, '', 'units');
 509
 510         $str = amount_cells(null, 'price');
 511
 512         small_amount_cells(null, 'Disc', percent_format($_POST['Disc']), null, null, user_percent_dec());
 513
 514         $line_total = input_num('qty') * input_num('price') * (1 - input_num('Disc') / 100);
 515
 516         amount_cell($line_total, false, '','line_total');
 517
 518         if ($id!=-1)
 519         {
 520                 button_cell('UpdateItem', _("Update"),
 521                                 _('Confirm changes'), ICON_UPDATE);
 522                 button_cell('CancelItemChanges', _("Cancel"),
 523                                 _('Cancel changes'), ICON_CANCEL);
 524                 hidden('LineNo', $line_no);
 525                 set_focus('qty');
 526         }
 527         else
 528         {
 529                 submit_cells('AddItem', _("Add Item"), "colspan=2",
 530                     _('Add new item to document'), true);
 531         }
 532
 533         end_row();
 534 }
 535
 536 //--------------------------------------------------------------------------------
 537
 538 function display_delivery_details(&$order)
 539 {
 540         global $table_style2, $Ajax;
 541
 542         div_start('delivery');
 543
 544         if (get_post('cash', 0)) {      // Direct payment sale
 545                 $Ajax->activate('items_table');
 546                 display_heading(_('Cash payment'));
 547                 start_table("$table_style2 width=60%");
 548                 label_row(_("Deliver from Location:"), $order->location_name);
 549
 550                 hidden('Location', $order->Location);
 551                 label_row(_("Cash account:"), $order->account_name);
 552                 textarea_row(_("Comments:"), "Comments", $order->Comments, 31, 5);
 553                 end_table();
 554         } else {
 555
 556                 if ($order->trans_type==10)
 557                 {
 558                         $title = _("Delivery Details");
 559                         $delname = _("Due Date").':';
 560                 }
 561                 elseif ($order->trans_type==13)
 562                 {
 563                         $title = _("Invoice Delivery Details");
 564                         $delname = _("Invoice before").':';
 565                 }
 566                 else
 567                 {
 568                         $title = _("Order Delivery Details");
 569                         $delname = _("Required Delivery Date").':';
 570                 }
 571                 display_heading($title);
 572                 start_outer_table("$table_style2 width=90%");
 573                 table_section(1);
 574
 575                 locations_list_row(_("Deliver from Location:"), 'Location', null,
 576                         false, true);
 577                 if (list_updated('Location'))
 578                         $Ajax->activate('items_table');
 579
 580
 581                 date_row($delname, 'delivery_date',
 582                         $order->trans_type==30 ?  _('Enter requested day of delivery') : '');
 583                 text_row(_("Deliver To:"), 'deliver_to', $order->deliver_to, 40, 40,
 584                         _('Additional identifier for delivery e.g. name of receiving person'));
 585
 586                 textarea_row(_("Address:"), 'delivery_address', $order->delivery_address, 35, 5,
 587                         _('Delivery address. Default is address of customer branch'));
 588                 text_row(_("Contact Phone Number:"), 'phone', $order->phone, 25, 25,
 589                     _('Phone number of ordering person. Defaults to branch phone number'));
 590
 591                 table_section(2);
 592
 593                 text_row(_("Customer Reference:"), 'cust_ref', $order->cust_ref, 25, 25,
 594                   _('Customer reference number for this order (if any)'));
 595                 textarea_row(_("Comments:"), "Comments", $order->Comments, 31, 5);
 596
 597                 small_amount_row(_("Shipping Charge:"), 'freight_cost',
 598                 price_format(get_post('freight_cost',0)));
 599
 600                 shippers_list_row(_("Shipping Company:"), 'ship_via', $order->ship_via);
 601
 602                 end_outer_table(1);
 603         }
 604         div_end();
 605 }
 606
 607 ?>