sales/sales_order_entry.php

   1 <?php
   2 //-----------------------------------------------------------------------------
   3 //
   4 //      Entry/Modify Sales Order
   5 //      Entry Direct Delivery
   6 //      Entry Direct Invoice
   7 //
   8
   9 $page_security = 1;
  10 $path_to_root="..";
  11
  12 include_once($path_to_root . "/sales/includes/cart_class.inc");
  13 include_once($path_to_root . "/includes/session.inc");
  14 include_once($path_to_root . "/sales/includes/sales_ui.inc");
  15 include_once($path_to_root . "/sales/includes/ui/sales_order_ui.inc");
  16 include_once($path_to_root . "/sales/includes/sales_db.inc");
  17 include_once($path_to_root . "/sales/includes/db/sales_types_db.inc");
  18 include_once($path_to_root . "/reporting/includes/reporting.inc");
  19 $js = '';
  20
  21 if ($use_popup_windows) {
  22         $js .= get_js_open_window(900, 500);
  23 }
  24
  25 if ($use_date_picker) {
  26         $js .= get_js_date_picker();
  27 }
  28
  29 if (isset($_GET['NewDelivery']) && is_numeric($_GET['NewDelivery'])) {
  30
  31         $_SESSION['page_title'] = _("Direct Sales Delivery");
  32         create_cart(13, $_GET['NewDelivery']);
  33
  34 } elseif (isset($_GET['NewInvoice']) && is_numeric($_GET['NewInvoice'])) {
  35
  36         $_SESSION['page_title'] = _("Direct Sales Invoice");
  37         create_cart(10, $_GET['NewInvoice']);
  38
  39 } elseif (isset($_GET['ModifyOrderNumber']) && is_numeric($_GET['ModifyOrderNumber'])) {
  40
  41         $help_page_title = _('Modifying Sales Order');
  42         $_SESSION['page_title'] = sprintf( _("Modifying Sales Order # %d"), $_GET['ModifyOrderNumber']);
  43         create_cart(30, $_GET['ModifyOrderNumber']);
  44
  45 } elseif (isset($_GET['NewOrder'])) {
  46
  47         $_SESSION['page_title'] = _("New Sales Order Entry");
  48         create_cart(30, 0);
  49 }
  50
  51 page($_SESSION['page_title'], false, false, "", $js);
  52 //-----------------------------------------------------------------------------
  53
  54 if (isset($_GET['AddedID'])) {
  55         $order_no = $_GET['AddedID'];
  56         print_hidden_script(30);
  57
  58         display_notification_centered(sprintf( _("Order # %d has been entered."),$order_no));
  59
  60         display_note(get_trans_view_str(30, $order_no, _("View This Order")));
  61         echo '<br>';
  62         display_note(print_document_link($order_no, _("Print This Order"), true, 30));
  63
  64         hyperlink_params($path_to_root . "/sales/customer_delivery.php",
  65                 _("Make Delivery Against This Order"), "OrderNumber=$order_no");
  66
  67         hyperlink_params($_SERVER['PHP_SELF'], _("Enter a New Order"), "NewOrder=0");
  68
  69         display_footer_exit();
  70
  71 } elseif (isset($_GET['UpdatedID'])) {
  72         $order_no = $_GET['UpdatedID'];
  73         print_hidden_script(30);
  74
  75         display_notification_centered(sprintf( _("Order # %d has been updated."),$order_no));
  76
  77         display_note(get_trans_view_str(30, $order_no, _("View This Order")));
  78         echo '<br>';
  79         display_note(print_document_link($order_no, _("Print This Order"), true, 30));
  80
  81         hyperlink_params($path_to_root . "/sales/customer_delivery.php",
  82                 _("Confirm Order Quantities and Make Delivery"), "OrderNumber=$order_no");
  83
  84         hyperlink_params($path_to_root . "/sales/inquiry/sales_orders_view.php",
  85                 _("Select A Different Order"), "OutstandingOnly=1");
  86
  87         display_footer_exit();
  88
  89 } elseif (isset($_GET['AddedDN'])) {
  90         $delivery = $_GET['AddedDN'];
  91         print_hidden_script(13);
  92
  93         display_notification_centered(sprintf(_("Delivery # %d has been entered."),$delivery));
  94
  95         display_note(get_trans_view_str(13, $delivery, _("View This Delivery")));
  96         echo '<br>';
  97         display_note(print_document_link($delivery, _("Print Delivery Note"), true, 13));
  98
  99         hyperlink_params($path_to_root . "/sales/customer_invoice.php",
 100         _("Make Invoice Against This Delivery"), "DeliveryNumber=$delivery");
 101
 102         if ((isset($_GET['Type']) && $_GET['Type'] == 1))
 103         hyperlink_params("inquiry/sales_orders_view.php",
 104                 _("Enter a New Template Delivery"), "DeliveryTemplates=Yes");
 105         else
 106         hyperlink_params($_SERVER['PHP_SELF'], _("Enter a New Delivery"), "NewDelivery=0");
 107
 108         display_footer_exit();
 109
 110 } elseif (isset($_GET['AddedDI'])) {
 111         $invoice = $_GET['AddedDI'];
 112         print_hidden_script(10);
 113
 114         display_notification_centered(sprintf(_("Invoice # %d has been entered."),$invoice));
 115
 116         display_note(get_trans_view_str(10, $invoice, _("View This Invoice")));
 117         echo '<br>';
 118         display_note(print_document_link($invoice, _("Print Sales Invoice"), true, 10));
 119
 120         if ((isset($_GET['Type']) && $_GET['Type'] == 1))
 121         hyperlink_params("inquiry/sales_orders_view.php",
 122                 _("Enter a New Template Invoice"), "InvoiceTemplates=Yes");
 123         else
 124         hyperlink_params($_SERVER['PHP_SELF'], _("Enter a New Direct Invoice"), "NewInvoice=0");
 125
 126         display_footer_exit();
 127 }
 128
 129 //-----------------------------------------------------------------------------
 130
 131 function copy_to_cart()
 132 {
 133         $cart = &$_SESSION['Items'];
 134
 135         if ($cart->trans_type!=30) {
 136                 $cart->reference = $_POST['ref'];
 137         }
 138         $cart->Comments =  $_POST['Comments'];
 139
 140         $cart->document_date = $_POST['OrderDate'];
 141         $cart->due_date = $_POST['delivery_date'];
 142         $cart->cust_ref = $_POST['cust_ref'];
 143         $cart->freight_cost = input_num('freight_cost');
 144         $cart->deliver_to = $_POST['deliver_to'];
 145         $cart->delivery_address = $_POST['delivery_address'];
 146         $cart->phone = $_POST['phone'];
 147         $cart->Location = $_POST['Location'];
 148         $cart->ship_via = $_POST['ship_via'];
 149
 150         if (isset($_POST['email']))
 151                 $cart->email =$_POST['email'];
 152         else
 153                 $cart->email = '';
 154         $cart->customer_id      = $_POST['customer_id'];
 155         $cart->Branch = $_POST['branch_id'];
 156         $cart->sales_type = $_POST['sales_type'];
 157 }
 158
 159 //-----------------------------------------------------------------------------
 160
 161 function copy_from_cart()
 162 {
 163         $cart = &$_SESSION['Items'];
 164         if ($cart->trans_type!=30) {
 165                 $_POST['ref'] = $cart->reference;
 166         }
 167         $_POST['Comments'] = $cart->Comments;
 168
 169         $_POST['OrderDate'] = $cart->document_date;
 170         $_POST['delivery_date'] = $cart->due_date;
 171         $_POST['cust_ref'] = $cart->cust_ref;
 172         $_POST['freight_cost'] = price_format($cart->freight_cost);
 173
 174         $_POST['deliver_to'] = $cart->deliver_to;
 175         $_POST['delivery_address'] = $cart->delivery_address;
 176         $_POST['phone'] = $cart->phone;
 177         $_POST['Location'] = $cart->Location;
 178         $_POST['ship_via'] = $cart->ship_via;
 179
 180         $_POST['customer_id'] = $cart->customer_id;
 181
 182         $_POST['branch_id'] = $cart->Branch;
 183         $_POST['sales_type'] = $cart->sales_type;
 184 }
 185 //--------------------------------------------------------------------------------
 186
 187 function line_start_focus() {
 188   global        $Ajax;
 189
 190   $Ajax->activate('items_table');
 191   set_focus('_stock_id_edit');
 192 }
 193 //--------------------------------------------------------------------------------
 194
 195 function can_process() {
 196         if (!is_date($_POST['OrderDate'])) {
 197                 display_error(_("The entered date is invalid."));
 198                 set_focus('OrderDate');
 199                 return false;
 200         }
 201         if ($_SESSION['Items']->trans_type!=30 && !is_date_in_fiscalyear($_POST['OrderDate'])) {
 202                 display_error(_("The entered date is not in fiscal year"));
 203                 set_focus('OrderDate');
 204                 return false;
 205         }
 206         if (count($_SESSION['Items']->line_items) == 0) {
 207                 display_error(_("You must enter at least one non empty item line."));
 208                 set_focus('AddItem');
 209                 return false;
 210         }
 211         if (strlen($_POST['deliver_to']) <= 1) {
 212                 display_error(_("You must enter the person or company to whom delivery should be made to."));
 213                 set_focus('deliver_to');
 214                 return false;
 215         }
 216         if (strlen($_POST['delivery_address']) <= 1) {
 217                 display_error( _("You should enter the street address in the box provided. Orders cannot be accepted without a valid street address."));
 218                 set_focus('delivery_address');
 219                 return false;
 220         }
 221
 222         if ($_POST['freight_cost'] == "")
 223                 $_POST['freight_cost'] = price_format(0);
 224
 225         if (!check_num('freight_cost',0)) {
 226                 display_error(_("The shipping cost entered is expected to be numeric."));
 227                 set_focus('freight_cost');
 228                 return false;
 229         }
 230         if (!is_date($_POST['delivery_date'])) {
 231                 display_error(_("The delivery date is invalid."));
 232                 set_focus('delivery_date');
 233                 return false;
 234         }
 235         //if (date1_greater_date2($_SESSION['Items']->document_date, $_POST['delivery_date'])) {
 236         if (date1_greater_date2($_POST['OrderDate'], $_POST['delivery_date'])) {
 237                 display_error(_("The requested delivery date is before the date of the order."));
 238                 set_focus('delivery_date');
 239                 return false;
 240         }
 241         if ($_SESSION['Items']->trans_type != 30 && !references::is_valid($_POST['ref'])) {
 242                 display_error(_("You must enter a reference."));
 243                 set_focus('ref');
 244                 return false;
 245         }
 246         return true;
 247 }
 248
 249 //-----------------------------------------------------------------------------
 250
 251 if (isset($_POST['ProcessOrder']) && can_process()) {
 252         copy_to_cart();
 253
 254         $modified = ($_SESSION['Items']->trans_no != 0);
 255         $so_type = $_SESSION['Items']->so_type;
 256
 257         $_SESSION['Items']->write(1);
 258         if (count($messages)) { // abort on failure or error messages are lost
 259                 $Ajax->activate('_page_body');
 260                 display_footer_exit();
 261         }
 262         $trans_no = key($_SESSION['Items']->trans_no);
 263         $trans_type = $_SESSION['Items']->trans_type;
 264
 265         processing_end();
 266         if ($modified) {
 267                 meta_forward($_SERVER['PHP_SELF'], "UpdatedID=$trans_no");
 268         } elseif ($trans_type == 30) {
 269                 meta_forward($_SERVER['PHP_SELF'], "AddedID=$trans_no");
 270         } elseif ($trans_type == 10) {
 271                 meta_forward($_SERVER['PHP_SELF'], "AddedDI=$trans_no&Type=$so_type");
 272         } else {
 273                 meta_forward($_SERVER['PHP_SELF'], "AddedDN=$trans_no&Type=$so_type");
 274         }
 275 }
 276
 277 //--------------------------------------------------------------------------------
 278
 279 function check_item_data()
 280 {
 281
 282         if (!check_num('qty', 0) || !check_num('Disc', 0, 100)) {
 283                 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."));
 284                 set_focus('qty');
 285                 return false;
 286         } elseif (!check_num('price', 0)) {
 287                 display_error( _("Price for item must be entered and can not be less than 0"));
 288                 set_focus('price');
 289                 return false;
 290         } elseif (isset($_POST['LineNo']) && isset($_SESSION['Items']->line_items[$_POST['LineNo']])
 291             && !check_num('qty', $_SESSION['Items']->line_items[$_POST['LineNo']]->qty_done)) {
 292
 293                 set_focus('qty');
 294                 display_error(_("You attempting to make the quantity ordered a quantity less than has already been delivered. The quantity delivered cannot be modified retrospectively."));
 295                 return false;
 296         }
 297         return true;
 298 }
 299
 300 //--------------------------------------------------------------------------------
 301
 302 function handle_update_item()
 303 {
 304         if ($_POST['UpdateItem'] != '' && check_item_data()) {
 305                 $_SESSION['Items']->update_cart_item($_POST['LineNo'],
 306                  input_num('qty'), input_num('price'),
 307                  input_num('Disc') / 100 );
 308         }
 309   line_start_focus();
 310 }
 311
 312 //--------------------------------------------------------------------------------
 313
 314 function handle_delete_item($line_no)
 315 {
 316     if ($_SESSION['Items']->some_already_delivered($line_no) == 0) {
 317             $_SESSION['Items']->remove_from_cart($line_no);
 318     } else {
 319         display_error(_("This item cannot be deleted because some of it has already been delivered."));
 320     }
 321     line_start_focus();
 322 }
 323
 324 //--------------------------------------------------------------------------------
 325
 326 function handle_new_item()
 327 {
 328
 329         if (!check_item_data()) {
 330                         return;
 331         }
 332         add_to_order($_SESSION['Items'], $_POST['stock_id'], input_num('qty'),
 333                 input_num('price'), input_num('Disc') / 100);
 334         $_POST['_stock_id_edit'] = $_POST['stock_id']   = "";
 335         line_start_focus();
 336 }
 337
 338 //--------------------------------------------------------------------------------
 339
 340 function  handle_cancel_order()
 341 {
 342         global $path_to_root;
 343
 344         if ($_POST['CancelOrder'] != "") {
 345
 346         if ($_SESSION['Items']->trans_type == 13) {
 347                         display_note(_("Direct delivery entry has been cancelled as requested."), 1);
 348                         hyperlink_params($path_to_root . "/sales/sales_order_entry.php",
 349                                         _("Enter a New Sales Delivery"), SID . "&NewDelivery=0");
 350         } elseif ($_SESSION['Items']->trans_type == 10) {
 351                         display_note(_("Direct invoice entry has been cancelled as requested."), 1);
 352                         hyperlink_params($path_to_root . "/sales/sales_order_entry.php",
 353                                         _("Enter a New Sales Delivery"), SID . "&NewDelivery=0");
 354         } else {
 355                 if ($_SESSION['Items']->trans_no != 0) {
 356                         if (sales_order_has_deliveries(key($_SESSION['Items']->trans_no)))
 357                                 display_error(_("This order cannot be cancelled because some of it has already been invoiced or dispatched. However, the line item quantities may be modified."));
 358                         else
 359                                 delete_sales_order(key($_SESSION['Items']->trans_no));
 360                 }
 361
 362                         display_note(_("This sales order has been cancelled as requested."), 1);
 363                                 hyperlink_params($path_to_root . "/sales/sales_order_entry.php",
 364                                 _("Enter a New Sales Order"), SID . "&NewOrder=Yes");
 365                 }
 366                 processing_end();
 367                 br(1);
 368                 end_page();
 369                 exit;
 370         }
 371 }
 372
 373 //--------------------------------------------------------------------------------
 374
 375 function create_cart($type, $trans_no)
 376 {
 377         processing_start();
 378         $doc_type = $type;
 379
 380         if($type != 30 && $trans_no != 0) { // this is template
 381                 $doc_type = 30;
 382
 383                 $doc = new Cart(30, array($trans_no));
 384                 $doc->trans_type = $type;
 385                 $doc->trans_no = 0;
 386                 $doc->document_date = Today(); // 2006-06-15. Added so Invoices and Deliveries get current day
 387                 if ($type == 10)
 388                         $doc->due_date = get_invoice_duedate($doc->customer_id, $doc->document_date);
 389                 else
 390                         $doc->due_date = $doc->document_date;
 391                 $doc->reference = references::get_next($doc->trans_type);
 392                 $doc->Comments='';
 393                 foreach($doc->line_items as $line_no => $line) {
 394                         $doc->line_items[$line_no]->qty_done = 0;
 395                 }
 396                 $_SESSION['Items'] = $doc;
 397         } else
 398                 $_SESSION['Items'] = new Cart($type,array($trans_no));
 399         copy_from_cart();
 400 }
 401
 402 //--------------------------------------------------------------------------------
 403
 404 if (isset($_POST['CancelOrder']))
 405         handle_cancel_order();
 406
 407 $id = find_submit('Delete');
 408 if ($id!=-1)
 409         handle_delete_item($id);
 410
 411 if (isset($_POST['UpdateItem']))
 412         handle_update_item();
 413
 414 if (isset($_POST['AddItem']))
 415         handle_new_item();
 416
 417 if (isset($_POST['CancelItemChanges'])) {
 418         line_start_focus();
 419 }
 420
 421 //--------------------------------------------------------------------------------
 422 check_db_has_stock_items(_("There are no inventory items defined in the system."));
 423
 424 check_db_has_customer_branches(_("There are no customers, or there are no customers with branches. Please define customers and customer branches."));
 425
 426 if ($_SESSION['Items']->trans_type == 10) {
 427         $idate = _("Invoice Date:");
 428         $orderitems = _("Sales Invoice Items");
 429         $deliverydetails = _("Enter Delivery Details and Confirm Invoice");
 430         $cancelorder = _("Cancel Invoice");
 431         $porder = _("Place Invoice");
 432 } elseif ($_SESSION['Items']->trans_type == 13) {
 433         $idate = _("Delivery Date:");
 434         $orderitems = _("Delivery Note Items");
 435         $deliverydetails = _("Enter Delivery Details and Confirm Dispatch");
 436         $cancelorder = _("Cancel Delivery");
 437         $porder = _("Place Delivery");
 438 } else {
 439         $idate = _("Order Date:");
 440         $orderitems = _("Sales Order Items");
 441         $deliverydetails = _("Enter Delivery Details and Confirm Order");
 442         $cancelorder = _("Cancel Order");
 443         $porder = _("Place Order");
 444         $corder = _("Commit Order Changes");
 445 }
 446 start_form(false, true);
 447
 448 $customer_error = display_order_header($_SESSION['Items'],
 449         ($_SESSION['Items']->any_already_delivered() == 0), $idate);
 450
 451 if ($customer_error == "") {
 452         start_table("$table_style width=80%", 10);
 453         echo "<tr><td>";
 454         display_order_summary($orderitems, $_SESSION['Items'], true);
 455         echo "</td></tr>";
 456         echo "<tr><td>";
 457         display_delivery_details($_SESSION['Items']);
 458         echo "</td></tr>";
 459         end_table(1);
 460
 461         if ($_SESSION['Items']->trans_no == 0) {
 462
 463                 submit_center_first('ProcessOrder', $porder,
 464                     _('Check entered data and save document'), true);
 465         } else {
 466                 submit_center_first('ProcessOrder', $corder,
 467                     _('Validate changes and update document'), true);
 468         }
 469
 470         submit_center_last('CancelOrder', $cancelorder,
 471            _('Cancels document entry or removes sales order when editing an old document'));
 472 } else {
 473         display_error($customer_error);
 474 }
 475 end_form();
 476 end_page();
 477
 478 ?>