sales/sales_order_entry.php

   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 //
  14 //      Entry/Modify Sales Quotations
  15 //      Entry/Modify Sales Order
  16 //      Entry Direct Delivery
  17 //      Entry Direct Invoice
  18 //
  19
  20 $path_to_root = "..";
  21 $page_security = 'SA_SALESORDER';
  22
  23 include_once($path_to_root . "/sales/includes/cart_class.inc");
  24 include_once($path_to_root . "/includes/session.inc");
  25 include_once($path_to_root . "/sales/includes/sales_ui.inc");
  26 include_once($path_to_root . "/sales/includes/ui/sales_order_ui.inc");
  27 include_once($path_to_root . "/sales/includes/sales_db.inc");
  28 include_once($path_to_root . "/sales/includes/db/sales_types_db.inc");
  29 include_once($path_to_root . "/reporting/includes/reporting.inc");
  30
  31 set_page_security( @$_SESSION['Items']->trans_type,
  32         array(  ST_SALESORDER=>'SA_SALESORDER',
  33                         ST_SALESQUOTE => 'SA_SALESQUOTE',
  34                         ST_CUSTDELIVERY => 'SA_SALESDELIVERY',
  35                         ST_SALESINVOICE => 'SA_SALESINVOICE'),
  36         array(  'NewOrder' => 'SA_SALESORDER',
  37                         'ModifyOrderNumber' => 'SA_SALESORDER',
  38                         'AddedID' => 'SA_SALESORDER',
  39                         'UpdatedID' => 'SA_SALESORDER',
  40                         'NewQuotation' => 'SA_SALESQUOTE',
  41                         'ModifyQuotationNumber' => 'SA_SALESQUOTE',
  42                         'NewQuoteToSalesOrder' => 'SA_SALESQUOTE',
  43                         'AddedQU' => 'SA_SALESQUOTE',
  44                         'UpdatedQU' => 'SA_SALESQUOTE',
  45                         'NewDelivery' => 'SA_SALESDELIVERY',
  46                         'AddedDN' => 'SA_SALESDELIVERY',
  47                         'NewInvoice' => 'SA_SALESINVOICE',
  48                         'AddedDI' => 'SA_SALESINVOICE'
  49                         )
  50 );
  51
  52 $js = '';
  53
  54 if ($SysPrefs->use_popup_windows) {
  55         $js .= get_js_open_window(900, 500);
  56 }
  57
  58 if (user_use_date_picker()) {
  59         $js .= get_js_date_picker();
  60 }
  61
  62 if (isset($_GET['NewDelivery']) && is_numeric($_GET['NewDelivery'])) {
  63
  64         $_SESSION['page_title'] = _($help_context = "Direct Sales Delivery");
  65         create_cart(ST_CUSTDELIVERY, $_GET['NewDelivery']);
  66
  67 } elseif (isset($_GET['NewInvoice']) && is_numeric($_GET['NewInvoice'])) {
  68
  69         create_cart(ST_SALESINVOICE, $_GET['NewInvoice']);
  70
  71         if (isset($_GET['FixedAsset'])) {
  72                 $_SESSION['page_title'] = _($help_context = "Fixed Assets Sale");
  73                 $_SESSION['Items']->fixed_asset = true;
  74         } else
  75                 $_SESSION['page_title'] = _($help_context = "Direct Sales Invoice");
  76
  77 } elseif (isset($_GET['ModifyOrderNumber']) && is_numeric($_GET['ModifyOrderNumber'])) {
  78
  79         $help_context = 'Modifying Sales Order';
  80         $_SESSION['page_title'] = sprintf( _("Modifying Sales Order # %d"), $_GET['ModifyOrderNumber']);
  81         create_cart(ST_SALESORDER, $_GET['ModifyOrderNumber']);
  82
  83 } elseif (isset($_GET['ModifyQuotationNumber']) && is_numeric($_GET['ModifyQuotationNumber'])) {
  84
  85         $help_context = 'Modifying Sales Quotation';
  86         $_SESSION['page_title'] = sprintf( _("Modifying Sales Quotation # %d"), $_GET['ModifyQuotationNumber']);
  87         create_cart(ST_SALESQUOTE, $_GET['ModifyQuotationNumber']);
  88
  89 } elseif (isset($_GET['NewOrder'])) {
  90
  91         $_SESSION['page_title'] = _($help_context = "New Sales Order Entry");
  92         create_cart(ST_SALESORDER, 0);
  93 } elseif (isset($_GET['NewQuotation'])) {
  94
  95         $_SESSION['page_title'] = _($help_context = "New Sales Quotation Entry");
  96         create_cart(ST_SALESQUOTE, 0);
  97 } elseif (isset($_GET['NewQuoteToSalesOrder'])) {
  98         $_SESSION['page_title'] = _($help_context = "Sales Order Entry");
  99         create_cart(ST_SALESQUOTE, $_GET['NewQuoteToSalesOrder']);
 100 }
 101
 102 page($_SESSION['page_title'], false, false, "", $js);
 103
 104 if (isset($_GET['ModifyOrderNumber']) && is_prepaid_order_open($_GET['ModifyOrderNumber']))
 105 {
 106         display_error(_("This order cannot be edited because there are invoices or payments related to it, and prepayment terms were used."));
 107         end_page(); exit;
 108 }
 109 if (isset($_GET['ModifyOrderNumber']))
 110         check_is_editable(ST_SALESORDER, $_GET['ModifyOrderNumber']);
 111 elseif (isset($_GET['ModifyQuotationNumber']))
 112         check_is_editable(ST_SALESQUOTE, $_GET['ModifyQuotationNumber']);
 113
 114 //-----------------------------------------------------------------------------
 115
 116 if (list_updated('branch_id')) {
 117         // when branch is selected via external editor also customer can change
 118         $br = get_branch(get_post('branch_id'));
 119         $_POST['customer_id'] = $br['debtor_no'];
 120         $Ajax->activate('customer_id');
 121 }
 122
 123 if (isset($_GET['AddedID'])) {
 124         $order_no = $_GET['AddedID'];
 125         display_notification_centered(sprintf( _("Order # %d has been entered."),$order_no));
 126
 127         submenu_view(_("&View This Order"), ST_SALESORDER, $order_no);
 128
 129         submenu_print(_("&Print This Order"), ST_SALESORDER, $order_no, 'prtopt');
 130         submenu_print(_("&Email This Order"), ST_SALESORDER, $order_no, null, 1);
 131         set_focus('prtopt');
 132
 133         submenu_option(_("Make &Delivery Against This Order"),
 134                 "/sales/customer_delivery.php?OrderNumber=$order_no");
 135
 136         submenu_option(_("Work &Order Entry"),  "/manufacturing/work_order_entry.php?");
 137
 138         submenu_option(_("Enter a &New Order"), "/sales/sales_order_entry.php?NewOrder=0");
 139
 140         display_footer_exit();
 141
 142 } elseif (isset($_GET['UpdatedID'])) {
 143         $order_no = $_GET['UpdatedID'];
 144
 145         display_notification_centered(sprintf( _("Order # %d has been updated."),$order_no));
 146
 147         submenu_view(_("&View This Order"), ST_SALESORDER, $order_no);
 148
 149         submenu_print(_("&Print This Order"), ST_SALESORDER, $order_no, 'prtopt');
 150         submenu_print(_("&Email This Order"), ST_SALESORDER, $order_no, null, 1);
 151         set_focus('prtopt');
 152
 153         submenu_option(_("Confirm Order Quantities and Make &Delivery"),
 154                 "/sales/customer_delivery.php?OrderNumber=$order_no");
 155
 156         submenu_option(_("Select A Different &Order"),
 157                 "/sales/inquiry/sales_orders_view.php?OutstandingOnly=1");
 158
 159         display_footer_exit();
 160
 161 } elseif (isset($_GET['AddedQU'])) {
 162         $order_no = $_GET['AddedQU'];
 163         display_notification_centered(sprintf( _("Quotation # %d has been entered."),$order_no));
 164
 165         submenu_view(_("&View This Quotation"), ST_SALESQUOTE, $order_no);
 166
 167         submenu_print(_("&Print This Quotation"), ST_SALESQUOTE, $order_no, 'prtopt');
 168         submenu_print(_("&Email This Quotation"), ST_SALESQUOTE, $order_no, null, 1);
 169         set_focus('prtopt');
 170
 171         submenu_option(_("Make &Sales Order Against This Quotation"),
 172                 "/sales/sales_order_entry.php?NewQuoteToSalesOrder=$order_no");
 173
 174         submenu_option(_("Enter a New &Quotation"),     "/sales/sales_order_entry.php?NewQuotation=0");
 175
 176         display_footer_exit();
 177
 178 } elseif (isset($_GET['UpdatedQU'])) {
 179         $order_no = $_GET['UpdatedQU'];
 180
 181         display_notification_centered(sprintf( _("Quotation # %d has been updated."),$order_no));
 182
 183         submenu_view(_("&View This Quotation"), ST_SALESQUOTE, $order_no);
 184
 185         submenu_print(_("&Print This Quotation"), ST_SALESQUOTE, $order_no, 'prtopt');
 186         submenu_print(_("&Email This Quotation"), ST_SALESQUOTE, $order_no, null, 1);
 187         set_focus('prtopt');
 188
 189         submenu_option(_("Make &Sales Order Against This Quotation"),
 190                 "/sales/sales_order_entry.php?NewQuoteToSalesOrder=$order_no");
 191
 192         submenu_option(_("Select A Different &Quotation"),
 193                 "/sales/inquiry/sales_orders_view.php?type=".ST_SALESQUOTE);
 194
 195         display_footer_exit();
 196 } elseif (isset($_GET['AddedDN'])) {
 197         $delivery = $_GET['AddedDN'];
 198
 199         display_notification_centered(sprintf(_("Delivery # %d has been entered."),$delivery));
 200
 201         submenu_view(_("&View This Delivery"), ST_CUSTDELIVERY, $delivery);
 202
 203         submenu_print(_("&Print Delivery Note"), ST_CUSTDELIVERY, $delivery, 'prtopt');
 204         submenu_print(_("&Email Delivery Note"), ST_CUSTDELIVERY, $delivery, null, 1);
 205         submenu_print(_("P&rint as Packing Slip"), ST_CUSTDELIVERY, $delivery, 'prtopt', null, 1);
 206         submenu_print(_("E&mail as Packing Slip"), ST_CUSTDELIVERY, $delivery, null, 1, 1);
 207         set_focus('prtopt');
 208
 209         display_note(get_gl_view_str(ST_CUSTDELIVERY, $delivery, _("View the GL Journal Entries for this Dispatch")),0, 1);
 210
 211         submenu_option(_("Make &Invoice Against This Delivery"),
 212                 "/sales/customer_invoice.php?DeliveryNumber=$delivery");
 213
 214         if ((isset($_GET['Type']) && $_GET['Type'] == 1))
 215                 submenu_option(_("Enter a New Template &Delivery"),
 216                         "/sales/inquiry/sales_orders_view.php?DeliveryTemplates=Yes");
 217         else
 218                 submenu_option(_("Enter a &New Delivery"),
 219                         "/sales/sales_order_entry.php?NewDelivery=0");
 220
 221         display_footer_exit();
 222
 223 } elseif (isset($_GET['AddedDI'])) {
 224         $invoice = $_GET['AddedDI'];
 225
 226         display_notification_centered(sprintf(_("Invoice # %d has been entered."), $invoice));
 227
 228         submenu_view(_("&View This Invoice"), ST_SALESINVOICE, $invoice);
 229
 230         submenu_print(_("&Print Sales Invoice"), ST_SALESINVOICE, $invoice."-".ST_SALESINVOICE, 'prtopt');
 231         submenu_print(_("&Email Sales Invoice"), ST_SALESINVOICE, $invoice."-".ST_SALESINVOICE, null, 1);
 232         set_focus('prtopt');
 233
 234         $row = db_fetch(get_allocatable_from_cust_transactions(null, $invoice, ST_SALESINVOICE));
 235         if ($row !== false)
 236                 submenu_print(_("Print &Receipt"), $row['type'], $row['trans_no']."-".$row['type'], 'prtopt');
 237
 238         display_note(get_gl_view_str(ST_SALESINVOICE, $invoice, _("View the GL &Journal Entries for this Invoice")),0, 1);
 239
 240         if ((isset($_GET['Type']) && $_GET['Type'] == 1))
 241                 submenu_option(_("Enter a &New Template Invoice"),
 242                         "/sales/inquiry/sales_orders_view.php?InvoiceTemplates=Yes");
 243         else
 244                 submenu_option(_("Enter a &New Direct Invoice"),
 245                         "/sales/sales_order_entry.php?NewInvoice=0");
 246
 247         if ($row === false)
 248                 submenu_option(_("Entry &customer payment for this invoice"), "/sales/customer_payments.php?SInvoice=".$invoice);
 249
 250         submenu_option(_("Add an Attachment"), "/admin/attachments.php?filterType=".ST_SALESINVOICE."&trans_no=$invoice");
 251
 252         display_footer_exit();
 253 } else
 254         check_edit_conflicts(get_post('cart_id'));
 255 //-----------------------------------------------------------------------------
 256
 257 function copy_to_cart()
 258 {
 259         $cart = &$_SESSION['Items'];
 260
 261         $cart->reference = $_POST['ref'];
 262
 263         $cart->Comments =  $_POST['Comments'];
 264
 265         $cart->document_date = $_POST['OrderDate'];
 266
 267         $newpayment = false;
 268
 269         if (isset($_POST['payment']) && ($cart->payment != $_POST['payment'])) {
 270                 $cart->payment = $_POST['payment'];
 271                 $cart->payment_terms = get_payment_terms($_POST['payment']);
 272                 $newpayment = true;
 273         }
 274         if ($cart->payment_terms['cash_sale']) {
 275                 if ($newpayment) {
 276                         $cart->due_date = $cart->document_date;
 277                         $cart->phone = $cart->cust_ref = $cart->delivery_address = '';
 278                         $cart->ship_via = 0;
 279                         $cart->deliver_to = '';
 280                         $cart->prep_amount = 0;
 281                 }
 282         } else {
 283                 $cart->due_date = $_POST['delivery_date'];
 284                 $cart->cust_ref = $_POST['cust_ref'];
 285                 $cart->deliver_to = $_POST['deliver_to'];
 286                 $cart->delivery_address = $_POST['delivery_address'];
 287                 $cart->phone = $_POST['phone'];
 288                 $cart->ship_via = $_POST['ship_via'];
 289                 if (!$cart->trans_no || ($cart->trans_type == ST_SALESORDER && !$cart->is_started()))
 290                         $cart->prep_amount = input_num('prep_amount', 0);
 291         }
 292         $cart->Location = $_POST['Location'];
 293         $cart->freight_cost = input_num('freight_cost');
 294         if (isset($_POST['email']))
 295                 $cart->email =$_POST['email'];
 296         else
 297                 $cart->email = '';
 298         $cart->customer_id      = $_POST['customer_id'];
 299         $cart->Branch = $_POST['branch_id'];
 300         $cart->sales_type = $_POST['sales_type'];
 301
 302         if ($cart->trans_type!=ST_SALESORDER && $cart->trans_type!=ST_SALESQUOTE) { // 2008-11-12 Joe Hunt
 303                 $cart->dimension_id = $_POST['dimension_id'];
 304                 $cart->dimension2_id = $_POST['dimension2_id'];
 305         }
 306         $cart->ex_rate = input_num('_ex_rate', null);
 307 }
 308
 309 //-----------------------------------------------------------------------------
 310
 311 function copy_from_cart()
 312 {
 313         $cart = &$_SESSION['Items'];
 314         $_POST['ref'] = $cart->reference;
 315         $_POST['Comments'] = $cart->Comments;
 316
 317         $_POST['OrderDate'] = $cart->document_date;
 318         $_POST['delivery_date'] = $cart->due_date;
 319         $_POST['cust_ref'] = $cart->cust_ref;
 320         $_POST['freight_cost'] = price_format($cart->freight_cost);
 321
 322         $_POST['deliver_to'] = $cart->deliver_to;
 323         $_POST['delivery_address'] = $cart->delivery_address;
 324         $_POST['phone'] = $cart->phone;
 325         $_POST['Location'] = $cart->Location;
 326         $_POST['ship_via'] = $cart->ship_via;
 327
 328         $_POST['customer_id'] = $cart->customer_id;
 329
 330         $_POST['branch_id'] = $cart->Branch;
 331         $_POST['sales_type'] = $cart->sales_type;
 332         $_POST['prep_amount'] = price_format($cart->prep_amount);
 333         // POS
 334         $_POST['payment'] = $cart->payment;
 335         if ($cart->trans_type!=ST_SALESORDER && $cart->trans_type!=ST_SALESQUOTE) { // 2008-11-12 Joe Hunt
 336                 $_POST['dimension_id'] = $cart->dimension_id;
 337                 $_POST['dimension2_id'] = $cart->dimension2_id;
 338         }
 339         $_POST['cart_id'] = $cart->cart_id;
 340         $_POST['_ex_rate'] = $cart->ex_rate;
 341 }
 342 //--------------------------------------------------------------------------------
 343
 344 function line_start_focus() {
 345         global  $Ajax;
 346
 347         $Ajax->activate('items_table');
 348         set_focus('_stock_id_edit');
 349 }
 350
 351 //--------------------------------------------------------------------------------
 352 function can_process() {
 353
 354         global $Refs, $SysPrefs;
 355
 356         copy_to_cart();
 357
 358         if (!get_post('customer_id'))
 359         {
 360                 display_error(_("There is no customer selected."));
 361                 set_focus('customer_id');
 362                 return false;
 363         }
 364
 365         if (!get_post('branch_id'))
 366         {
 367                 display_error(_("This customer has no branch defined."));
 368                 set_focus('branch_id');
 369                 return false;
 370         }
 371
 372         if (!is_date($_POST['OrderDate'])) {
 373                 display_error(_("The entered date is invalid."));
 374                 set_focus('OrderDate');
 375                 return false;
 376         }
 377         if ($_SESSION['Items']->trans_type!=ST_SALESORDER && $_SESSION['Items']->trans_type!=ST_SALESQUOTE && !is_date_in_fiscalyear($_POST['OrderDate'])) {
 378                 display_error(_("The entered date is out of fiscal year or is closed for further data entry."));
 379                 set_focus('OrderDate');
 380                 return false;
 381         }
 382         if (count($_SESSION['Items']->line_items) == 0) {
 383                 display_error(_("You must enter at least one non empty item line."));
 384                 set_focus('AddItem');
 385                 return false;
 386         }
 387         if (!$SysPrefs->allow_negative_stock() && ($low_stock = $_SESSION['Items']->check_qoh()))
 388         {
 389                 display_error(_("This document cannot be processed because there is insufficient quantity for items marked."));
 390                 return false;
 391         }
 392         if ($_SESSION['Items']->payment_terms['cash_sale'] == 0) {
 393                 if (!$_SESSION['Items']->is_started() && ($_SESSION['Items']->payment_terms['days_before_due'] == -1) && ((input_num('prep_amount')<=0) ||
 394                         input_num('prep_amount')>$_SESSION['Items']->get_trans_total())) {
 395                         display_error(_("Pre-payment required have to be positive and less than total amount."));
 396                         set_focus('prep_amount');
 397                         return false;
 398                 }
 399                 if (strlen($_POST['deliver_to']) <= 1) {
 400                         display_error(_("You must enter the person or company to whom delivery should be made to."));
 401                         set_focus('deliver_to');
 402                         return false;
 403                 }
 404
 405                 if ($_SESSION['Items']->trans_type != ST_SALESQUOTE && strlen($_POST['delivery_address']) <= 1) {
 406                         display_error( _("You should enter the street address in the box provided. Orders cannot be accepted without a valid street address."));
 407                         set_focus('delivery_address');
 408                         return false;
 409                 }
 410
 411                 if ($_POST['freight_cost'] == "")
 412                         $_POST['freight_cost'] = price_format(0);
 413
 414                 if (!check_num('freight_cost',0)) {
 415                         display_error(_("The shipping cost entered is expected to be numeric."));
 416                         set_focus('freight_cost');
 417                         return false;
 418                 }
 419                 if (!is_date($_POST['delivery_date'])) {
 420                         if ($_SESSION['Items']->trans_type==ST_SALESQUOTE)
 421                                 display_error(_("The Valid date is invalid."));
 422                         else
 423                                 display_error(_("The delivery date is invalid."));
 424                         set_focus('delivery_date');
 425                         return false;
 426                 }
 427                 if (date1_greater_date2($_POST['OrderDate'], $_POST['delivery_date'])) {
 428                         if ($_SESSION['Items']->trans_type==ST_SALESQUOTE)
 429                                 display_error(_("The requested valid date is before the date of the quotation."));
 430                         else
 431                                 display_error(_("The requested delivery date is before the date of the order."));
 432                         set_focus('delivery_date');
 433                         return false;
 434                 }
 435         }
 436         else
 437         {
 438                 if (!db_has_cash_accounts())
 439                 {
 440                         display_error(_("You need to define a cash account for your Sales Point."));
 441                         return false;
 442                 }
 443         }
 444         if (!$Refs->is_valid($_POST['ref'], $_SESSION['Items']->trans_type)) {
 445                 display_error(_("You must enter a reference."));
 446                 set_focus('ref');
 447                 return false;
 448         }
 449         if (!db_has_currency_rates($_SESSION['Items']->customer_currency, $_POST['OrderDate']))
 450                 return false;
 451
 452         if ($_SESSION['Items']->get_items_total() < 0) {
 453                 display_error("Invoice total amount cannot be less than zero.");
 454                 return false;
 455         }
 456         return true;
 457 }
 458
 459 //-----------------------------------------------------------------------------
 460
 461 if (isset($_POST['update'])) {
 462         copy_to_cart();
 463         $Ajax->activate('items_table');
 464 }
 465
 466 if (isset($_POST['ProcessOrder']) && can_process()) {
 467
 468         $modified = ($_SESSION['Items']->trans_no != 0);
 469         $so_type = $_SESSION['Items']->so_type;
 470
 471         $ret = $_SESSION['Items']->write(1);
 472         if ($ret == -1)
 473         {
 474                 display_error(_("The entered reference is already in use."));
 475                 $ref = $Refs->get_next($_SESSION['Items']->trans_type, null, array('date' => Today()));
 476                 if ($ref != $_SESSION['Items']->reference)
 477                 {
 478                         display_error(_("The reference number field has been increased. Please save the document again."));
 479                         $_POST['ref'] = $_SESSION['Items']->reference = $ref;
 480                         $Ajax->activate('ref');
 481                 }
 482                 set_focus('ref');
 483         }
 484         else
 485         {
 486                 if (count($messages)) { // abort on failure or error messages are lost
 487                         $Ajax->activate('_page_body');
 488                         display_footer_exit();
 489                 }
 490                 $trans_no = key($_SESSION['Items']->trans_no);
 491                 $trans_type = $_SESSION['Items']->trans_type;
 492                 new_doc_date($_SESSION['Items']->document_date);
 493                 processing_end();
 494                 if ($modified) {
 495                         if ($trans_type == ST_SALESQUOTE)
 496                                 meta_forward($_SERVER['PHP_SELF'], "UpdatedQU=$trans_no");
 497                         else
 498                                 meta_forward($_SERVER['PHP_SELF'], "UpdatedID=$trans_no");
 499                 } elseif ($trans_type == ST_SALESORDER) {
 500                         meta_forward($_SERVER['PHP_SELF'], "AddedID=$trans_no");
 501                 } elseif ($trans_type == ST_SALESQUOTE) {
 502                         meta_forward($_SERVER['PHP_SELF'], "AddedQU=$trans_no");
 503                 } elseif ($trans_type == ST_SALESINVOICE) {
 504                         meta_forward($_SERVER['PHP_SELF'], "AddedDI=$trans_no&Type=$so_type");
 505                 } else {
 506                         meta_forward($_SERVER['PHP_SELF'], "AddedDN=$trans_no&Type=$so_type");
 507                 }
 508         }
 509 }
 510
 511 //--------------------------------------------------------------------------------
 512
 513 function check_item_data()
 514 {
 515         global $SysPrefs;
 516
 517         $is_inventory_item = is_inventory_item(get_post('stock_id'));
 518         if(!get_post('stock_id_text', true)) {
 519                 display_error( _("Item description cannot be empty."));
 520                 set_focus('stock_id_edit');
 521                 return false;
 522         }
 523         elseif (!check_num('qty', 0) || !check_num('Disc', 0, 100)) {
 524                 display_error( _("The item could not be updated because you are attempting to set the quantity ordered to less than 0, or the discount percent to more than 100."));
 525                 set_focus('qty');
 526                 return false;
 527         } elseif (!check_num('price', 0) && (!$SysPrefs->allow_negative_prices() || $is_inventory_item)) {
 528                 display_error( _("Price for inventory item must be entered and can not be less than 0"));
 529                 set_focus('price');
 530                 return false;
 531         } elseif (isset($_POST['LineNo']) && isset($_SESSION['Items']->line_items[$_POST['LineNo']])
 532             && !check_num('qty', $_SESSION['Items']->line_items[$_POST['LineNo']]->qty_done)) {
 533
 534                 set_focus('qty');
 535                 display_error(_("You attempting to make the quantity ordered a quantity less than has already been delivered. The quantity delivered cannot be modified retrospectively."));
 536                 return false;
 537         }
 538
 539         $cost_home = get_unit_cost(get_post('stock_id')); // Added 2011-03-27 Joe Hunt
 540         $cost = $cost_home / get_exchange_rate_from_home_currency($_SESSION['Items']->customer_currency, $_SESSION['Items']->document_date);
 541         if (input_num('price') < $cost)
 542         {
 543                 $dec = user_price_dec();
 544                 $curr = $_SESSION['Items']->customer_currency;
 545                 $price = number_format2(input_num('price'), $dec);
 546                 if ($cost_home == $cost)
 547                         $std_cost = number_format2($cost_home, $dec);
 548                 else
 549                 {
 550                         $price = $curr . " " . $price;
 551                         $std_cost = $curr . " " . number_format2($cost, $dec);
 552                 }
 553                 display_warning(sprintf(_("Price %s is below Standard Cost %s"), $price, $std_cost));
 554         }
 555         return true;
 556 }
 557
 558 //--------------------------------------------------------------------------------
 559
 560 function handle_update_item()
 561 {
 562         if ($_POST['UpdateItem'] != '' && check_item_data()) {
 563                 $_SESSION['Items']->update_cart_item($_POST['LineNo'],
 564                  input_num('qty'), input_num('price'),
 565                  input_num('Disc') / 100, $_POST['item_description'] );
 566         }
 567         page_modified();
 568   line_start_focus();
 569 }
 570
 571 //--------------------------------------------------------------------------------
 572
 573 function handle_delete_item($line_no)
 574 {
 575     if ($_SESSION['Items']->some_already_delivered($line_no) == 0) {
 576             $_SESSION['Items']->remove_from_cart($line_no);
 577     } else {
 578                 display_error(_("This item cannot be deleted because some of it has already been delivered."));
 579     }
 580     line_start_focus();
 581 }
 582
 583 //--------------------------------------------------------------------------------
 584
 585 function handle_new_item()
 586 {
 587
 588         if (!check_item_data()) {
 589                         return;
 590         }
 591         add_to_order($_SESSION['Items'], get_post('stock_id'), input_num('qty'),
 592                 input_num('price'), input_num('Disc') / 100, get_post('stock_id_text'));
 593
 594         unset($_POST['_stock_id_edit'], $_POST['stock_id']);
 595         page_modified();
 596         line_start_focus();
 597 }
 598
 599 //--------------------------------------------------------------------------------
 600
 601 function  handle_cancel_order()
 602 {
 603         global $path_to_root, $Ajax;
 604
 605
 606         if ($_SESSION['Items']->trans_type == ST_CUSTDELIVERY) {
 607                 display_notification(_("Direct delivery entry has been cancelled as requested."), 1);
 608                 submenu_option(_("Enter a New Sales Delivery"), "/sales/sales_order_entry.php?NewDelivery=1");
 609         } elseif ($_SESSION['Items']->trans_type == ST_SALESINVOICE) {
 610                 display_notification(_("Direct invoice entry has been cancelled as requested."), 1);
 611                 submenu_option(_("Enter a New Sales Invoice"),  "/sales/sales_order_entry.php?NewInvoice=1");
 612         } elseif ($_SESSION['Items']->trans_type == ST_SALESQUOTE)
 613         {
 614                 if ($_SESSION['Items']->trans_no != 0)
 615                         delete_sales_order(key($_SESSION['Items']->trans_no), $_SESSION['Items']->trans_type);
 616                 display_notification(_("This sales quotation has been cancelled as requested."), 1);
 617                 submenu_option(_("Enter a New Sales Quotation"), "/sales/sales_order_entry.php?NewQuotation=Yes");
 618         } else { // sales order
 619                 if ($_SESSION['Items']->trans_no != 0) {
 620                         $order_no = key($_SESSION['Items']->trans_no);
 621                         if (sales_order_has_deliveries($order_no))
 622                         {
 623                                 close_sales_order($order_no);
 624                                 display_notification(_("Undelivered part of order has been cancelled as requested."), 1);
 625                                 submenu_option(_("Select Another Sales Order for Edition"), "/sales/inquiry/sales_orders_view.php?type=".ST_SALESORDER);
 626                         } else {
 627                                 delete_sales_order(key($_SESSION['Items']->trans_no), $_SESSION['Items']->trans_type);
 628
 629                                 display_notification(_("This sales order has been cancelled as requested."), 1);
 630                                 submenu_option(_("Enter a New Sales Order"), "/sales/sales_order_entry.php?NewOrder=Yes");
 631                         }
 632                 } else {
 633                         processing_end();
 634                         meta_forward($path_to_root.'/index.php','application=orders');
 635                 }
 636         }
 637         processing_end();
 638         display_footer_exit();
 639 }
 640
 641 //--------------------------------------------------------------------------------
 642
 643 function create_cart($type, $trans_no)
 644 {
 645         global $Refs, $SysPrefs;
 646
 647         if (!$SysPrefs->db_ok) // create_cart is called before page() where the check is done
 648                 return;
 649
 650         processing_start();
 651
 652         if (isset($_GET['NewQuoteToSalesOrder']))
 653         {
 654                 $trans_no = $_GET['NewQuoteToSalesOrder'];
 655                 $doc = new Cart(ST_SALESQUOTE, $trans_no, true);
 656                 $doc->Comments = _("Sales Quotation") . " # " . $trans_no;
 657                 $_SESSION['Items'] = $doc;
 658         }
 659         elseif($type != ST_SALESORDER && $type != ST_SALESQUOTE && $trans_no != 0) { // this is template
 660
 661                 $doc = new Cart(ST_SALESORDER, array($trans_no));
 662                 $doc->trans_type = $type;
 663                 $doc->trans_no = 0;
 664                 $doc->document_date = new_doc_date();
 665                 if ($type == ST_SALESINVOICE) {
 666                         $doc->due_date = get_invoice_duedate($doc->payment, $doc->document_date);
 667                         $doc->pos = get_sales_point(user_pos());
 668                 } else
 669                         $doc->due_date = $doc->document_date;
 670                 $doc->reference = $Refs->get_next($doc->trans_type, null, array('date' => Today()));
 671                 //$doc->Comments='';
 672                 foreach($doc->line_items as $line_no => $line) {
 673                         $doc->line_items[$line_no]->qty_done = 0;
 674                 }
 675                 $_SESSION['Items'] = $doc;
 676         } else
 677                 $_SESSION['Items'] = new Cart($type, array($trans_no));
 678         copy_from_cart();
 679 }
 680
 681 //--------------------------------------------------------------------------------
 682
 683 if (isset($_POST['CancelOrder']))
 684         handle_cancel_order();
 685
 686 $id = find_submit('Delete');
 687 if ($id!=-1)
 688         handle_delete_item($id);
 689
 690 if (isset($_POST['UpdateItem']))
 691         handle_update_item();
 692
 693 if (isset($_POST['AddItem']))
 694         handle_new_item();
 695
 696 if (isset($_POST['CancelItemChanges'])) {
 697         line_start_focus();
 698 }
 699
 700 //--------------------------------------------------------------------------------
 701 if ($_SESSION['Items']->fixed_asset)
 702         check_db_has_disposable_fixed_assets(_("There are no fixed assets defined in the system."));
 703 else
 704         check_db_has_stock_items(_("There are no inventory items defined in the system."));
 705
 706 check_db_has_customer_branches(_("There are no customers, or there are no customers with branches. Please define customers and customer branches."));
 707
 708 if ($_SESSION['Items']->trans_type == ST_SALESINVOICE) {
 709         $idate = _("Invoice Date:");
 710         $orderitems = _("Sales Invoice Items");
 711         $deliverydetails = _("Enter Delivery Details and Confirm Invoice");
 712         $cancelorder = _("Cancel Invoice");
 713         $porder = _("Place Invoice");
 714 } elseif ($_SESSION['Items']->trans_type == ST_CUSTDELIVERY) {
 715         $idate = _("Delivery Date:");
 716         $orderitems = _("Delivery Note Items");
 717         $deliverydetails = _("Enter Delivery Details and Confirm Dispatch");
 718         $cancelorder = _("Cancel Delivery");
 719         $porder = _("Place Delivery");
 720 } elseif ($_SESSION['Items']->trans_type == ST_SALESQUOTE) {
 721         $idate = _("Quotation Date:");
 722         $orderitems = _("Sales Quotation Items");
 723         $deliverydetails = _("Enter Delivery Details and Confirm Quotation");
 724         $cancelorder = _("Cancel Quotation");
 725         $porder = _("Place Quotation");
 726         $corder = _("Commit Quotations Changes");
 727 } else {
 728         $idate = _("Order Date:");
 729         $orderitems = _("Sales Order Items");
 730         $deliverydetails = _("Enter Delivery Details and Confirm Order");
 731         $cancelorder = _("Cancel Order");
 732         $porder = _("Place Order");
 733         $corder = _("Commit Order Changes");
 734 }
 735 start_form();
 736
 737 hidden('cart_id');
 738 $customer_error = display_order_header($_SESSION['Items'], !$_SESSION['Items']->is_started(), $idate);
 739
 740 if ($customer_error == "") {
 741         start_table(TABLESTYLE, "width='80%'", 10);
 742         echo "<tr><td>";
 743         display_order_summary($orderitems, $_SESSION['Items'], true);
 744         echo "</td></tr>";
 745         echo "<tr><td>";
 746         display_delivery_details($_SESSION['Items']);
 747         echo "</td></tr>";
 748         end_table(1);
 749
 750         if ($_SESSION['Items']->trans_no == 0) {
 751
 752                 submit_center_first('ProcessOrder', $porder,
 753                     _('Check entered data and save document'), 'default');
 754                 submit_center_last('CancelOrder', $cancelorder,
 755                         _('Cancels document entry or removes sales order when editing an old document'));
 756                 submit_js_confirm('CancelOrder', _('You are about to void this Document.\nDo you want to continue?'));
 757         } else {
 758                 submit_center_first('ProcessOrder', $corder,
 759                     _('Validate changes and update document'), 'default');
 760                 submit_center_last('CancelOrder', $cancelorder,
 761                         _('Cancels document entry or removes sales order when editing an old document'));
 762                 if ($_SESSION['Items']->trans_type==ST_SALESORDER)
 763                         submit_js_confirm('CancelOrder', _('You are about to cancel undelivered part of this order.\nDo you want to continue?'));
 764                 else
 765                         submit_js_confirm('CancelOrder', _('You are about to void this Document.\nDo you want to continue?'));
 766         }
 767
 768 } else {
 769         display_error($customer_error);
 770 }
 771
 772 end_form();
 773 end_page();