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 //-----------------------------------------------------------------------------
14 // Entry/Modify Sales Quotations
15 // Entry/Modify Sales Order
16 // Entry Direct Delivery
17 // Entry Direct Invoice
20 $page_security = 'SA_SALESORDER';
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");
32 if ($use_popup_windows) {
33 $js .= get_js_open_window(900, 500);
36 if ($use_date_picker) {
37 $js .= get_js_date_picker();
40 if (isset($_GET['NewDelivery']) && is_numeric($_GET['NewDelivery'])) {
42 $_SESSION['page_title'] = _("Direct Sales Delivery");
43 create_cart(ST_CUSTDELIVERY, $_GET['NewDelivery']);
45 } elseif (isset($_GET['NewInvoice']) && is_numeric($_GET['NewInvoice'])) {
47 $_SESSION['page_title'] = _("Direct Sales Invoice");
48 create_cart(ST_SALESINVOICE, $_GET['NewInvoice']);
50 } elseif (isset($_GET['ModifyOrderNumber']) && is_numeric($_GET['ModifyOrderNumber'])) {
52 $help_page_title = _('Modifying Sales Order');
53 $_SESSION['page_title'] = sprintf( _("Modifying Sales Order # %d"), $_GET['ModifyOrderNumber']);
54 create_cart(ST_SALESORDER, $_GET['ModifyOrderNumber']);
56 } elseif (isset($_GET['ModifyQuotationNumber']) && is_numeric($_GET['ModifyQuotationNumber'])) {
58 $help_page_title = _('Modifying Sales Quotation');
59 $_SESSION['page_title'] = sprintf( _("Modifying Sales Quotation # %d"), $_GET['ModifyQuotationNumber']);
60 create_cart(ST_SALESQUOTE, $_GET['ModifyQuotationNumber']);
62 } elseif (isset($_GET['NewOrder'])) {
64 $_SESSION['page_title'] = _("New Sales Order Entry");
65 create_cart(ST_SALESORDER, 0);
66 } elseif (isset($_GET['NewQuotation'])) {
68 $_SESSION['page_title'] = _("New Sales Quotation Entry");
69 create_cart(ST_SALESQUOTE, 0);
70 } elseif (isset($_GET['NewQuoteToSalesOrder'])) {
71 $_SESSION['page_title'] = _("Sales Order Entry");
72 create_cart(ST_SALESQUOTE, $_GET['NewQuoteToSalesOrder']);
75 page($_SESSION['page_title'], false, false, "", $js);
76 //-----------------------------------------------------------------------------
78 if (list_updated('branch_id')) {
79 // when branch is selected via external editor also customer can change
80 $br = get_branch(get_post('branch_id'));
81 $_POST['customer_id'] = $br['debtor_no'];
82 $Ajax->activate('customer_id');
85 if (isset($_GET['AddedID'])) {
86 $order_no = $_GET['AddedID'];
87 display_notification_centered(sprintf( _("Order # %d has been entered."),$order_no));
89 submenu_view(_("&View This Order"), ST_SALESORDER, $order_no);
91 submenu_print(_("&Print This Order"), ST_SALESORDER, $order_no, 'prtopt');
92 submenu_print(_("&Email This Order"), ST_SALESORDER, $order_no, null, 1);
95 submenu_option(_("Make &Delivery Against This Order"),
96 "/sales/customer_delivery.php?OrderNumber=$order_no");
98 submenu_option(_("Enter a &New Order"), "/sales/sales_order_entry.php?NewOrder=0");
100 display_footer_exit();
102 } elseif (isset($_GET['UpdatedID'])) {
103 $order_no = $_GET['UpdatedID'];
105 display_notification_centered(sprintf( _("Order # %d has been updated."),$order_no));
107 submenu_view(_("&View This Order"), ST_SALESORDER, $order_no);
109 submenu_print(_("&Print This Order"), ST_SALESORDER, $order_no, 'prtopt');
110 submenu_print(_("&Email This Order"), ST_SALESORDER, $order_no, null, 1);
113 submenu_option(_("Confirm Order Quantities and Make &Delivery"),
114 "/sales/customer_delivery.php?OrderNumber=$order_no");
116 submenu_option(_("Select A Different &Order"),
117 "/sales/inquiry/sales_orders_view.php?OutstandingOnly=1");
119 display_footer_exit();
121 } elseif (isset($_GET['AddedQU'])) {
122 $order_no = $_GET['AddedQU'];
123 display_notification_centered(sprintf( _("Quotation # %d has been entered."),$order_no));
125 submenu_view(_("&View This Quotation"), ST_SALESQUOTE, $order_no);
127 submenu_print(_("&Print This Quotation"), ST_SALESQUOTE, $order_no, 'prtopt');
128 submenu_print(_("&Email This Quotation"), ST_SALESQUOTE, $order_no, null, 1);
131 submenu_option(_("Make &Sales Order Against This Quotation"),
132 "/sales/sales_order_entry.php?NewQuoteToSalesOrder=$order_no");
134 submenu_option(_("Enter a New &Quotation"), "/sales/sales_order_entry.php?NewQuotation=0");
136 display_footer_exit();
138 } elseif (isset($_GET['UpdatedQU'])) {
139 $order_no = $_GET['UpdatedQU'];
141 display_notification_centered(sprintf( _("Quotation # %d has been updated."),$order_no));
143 submenu_view(_("&View This Quotation"), ST_SALESQUOTE, $order_no);
145 submenu_print(_("&Print This Quotation"), ST_SALESQUOTE, $order_no, 'prtopt');
146 submenu_print(_("&Email This Quotation"), ST_SALESQUOTE, $order_no, null, 1);
149 submenu_option(_("Make &Sales Order Against This Quotation"),
150 "/sales/sales_order_entry.php?NewQuoteToSalesOrder=$order_no");
152 submenu_option(_("Select A Different &Quotation"),
153 "/sales/inquiry/sales_orders_view.php?type=".ST_SALESQUOTE);
155 display_footer_exit();
156 } elseif (isset($_GET['AddedDN'])) {
157 $delivery = $_GET['AddedDN'];
159 display_notification_centered(sprintf(_("Delivery # %d has been entered."),$delivery));
161 submenu_view(_("&View This Delivery"), ST_CUSTDELIVERY, $delivery);
163 submenu_print(_("&Print Delivery Note"), ST_CUSTDELIVERY, $delivery, 'prtopt');
164 submenu_print(_("&Email Delivery Note"), ST_CUSTDELIVERY, $delivery, null, 1);
165 submenu_print(_("P&rint as Packing Slip"), ST_CUSTDELIVERY, $delivery, 'prtopt', null, 1);
166 submenu_print(_("E&mail as Packing Slip"), ST_CUSTDELIVERY, $delivery, null, 1, 1);
169 display_note(get_gl_view_str(ST_CUSTDELIVERY, $delivery, _("View the GL Journal Entries for this Dispatch")),0, 1);
171 submenu_option(_("Make &Invoice Against This Delivery"),
172 "/sales/customer_invoice.php?DeliveryNumber=$delivery");
174 if ((isset($_GET['Type']) && $_GET['Type'] == 1))
175 submenu_option(_("Enter a New Template &Delivery"),
176 "/sales/inquiry/sales_orders_view.php?DeliveryTemplates=Yes");
178 submenu_option(_("Enter a &New Delivery"),
179 "/sales/sales_order_entry.php?NewDelivery=0");
181 display_footer_exit();
183 } elseif (isset($_GET['AddedDI'])) {
184 $invoice = $_GET['AddedDI'];
186 display_notification_centered(sprintf(_("Invoice # %d has been entered."), $invoice));
188 submenu_view(_("&View This Invoice"), ST_SALESINVOICE, $invoice);
190 submenu_print(_("&Print Sales Invoice"), ST_SALESINVOICE, $invoice, 'prtopt');
191 submenu_print(_("&Email Sales Invoice"), ST_SALESINVOICE, $invoice, null, 1);
194 display_note(get_gl_view_str(ST_SALESINVOICE, $invoice, _("View the GL &Journal Entries for this Invoice")),0, 1);
196 if ((isset($_GET['Type']) && $_GET['Type'] == 1))
197 submenu_option(_("Enter a &New Template Invoice"),
198 "/sales/inquiry/sales_orders_view.php?InvoiceTemplates=Yes");
200 submenu_option(_("Enter a &New Direct Invoice"),
201 "/sales/sales_order_entry.php?NewInvoice=0");
203 display_footer_exit();
205 check_edit_conflicts();
206 //-----------------------------------------------------------------------------
208 function copy_to_cart()
210 $cart = &$_SESSION['Items'];
212 $cart->reference = $_POST['ref'];
214 $cart->Comments = $_POST['Comments'];
216 $cart->document_date = $_POST['OrderDate'];
217 if ($cart->trans_type == ST_SALESINVOICE)
218 $cart->cash = $_POST['cash'];
220 $cart->due_date = $cart->document_date;
221 $cart->phone = $cart->cust_ref = $cart->delivery_address = '';
222 $cart->freight_cost = 0;
224 $cart->deliver_to = '';//$_POST['deliver_to'];
226 $cart->due_date = $_POST['delivery_date'];
227 $cart->cust_ref = $_POST['cust_ref'];
228 $cart->freight_cost = input_num('freight_cost');
229 $cart->deliver_to = $_POST['deliver_to'];
230 $cart->delivery_address = $_POST['delivery_address'];
231 $cart->phone = $_POST['phone'];
232 $cart->Location = $_POST['Location'];
233 $cart->ship_via = $_POST['ship_via'];
235 if (isset($_POST['email']))
236 $cart->email =$_POST['email'];
239 $cart->customer_id = $_POST['customer_id'];
240 $cart->Branch = $_POST['branch_id'];
241 $cart->sales_type = $_POST['sales_type'];
243 if ($cart->trans_type!=ST_SALESORDER && $cart->trans_type!=ST_SALESQUOTE) { // 2008-11-12 Joe Hunt
244 $cart->dimension_id = $_POST['dimension_id'];
245 $cart->dimension2_id = $_POST['dimension2_id'];
249 //-----------------------------------------------------------------------------
251 function copy_from_cart()
253 $cart = &$_SESSION['Items'];
254 $_POST['ref'] = $cart->reference;
255 $_POST['Comments'] = $cart->Comments;
257 $_POST['OrderDate'] = $cart->document_date;
258 $_POST['delivery_date'] = $cart->due_date;
259 $_POST['cust_ref'] = $cart->cust_ref;
260 $_POST['freight_cost'] = price_format($cart->freight_cost);
262 $_POST['deliver_to'] = $cart->deliver_to;
263 $_POST['delivery_address'] = $cart->delivery_address;
264 $_POST['phone'] = $cart->phone;
265 $_POST['Location'] = $cart->Location;
266 $_POST['ship_via'] = $cart->ship_via;
268 $_POST['customer_id'] = $cart->customer_id;
270 $_POST['branch_id'] = $cart->Branch;
271 $_POST['sales_type'] = $cart->sales_type;
273 if ($cart->trans_type == ST_SALESINVOICE)
274 $_POST['cash'] = $cart->cash;
275 if ($cart->trans_type!=ST_SALESORDER && $cart->trans_type!=ST_SALESQUOTE) { // 2008-11-12 Joe Hunt
276 $_POST['dimension_id'] = $cart->dimension_id;
277 $_POST['dimension2_id'] = $cart->dimension2_id;
279 $_POST['cart_id'] = $cart->cart_id;
282 //--------------------------------------------------------------------------------
284 function line_start_focus() {
287 $Ajax->activate('items_table');
288 set_focus('_stock_id_edit');
291 //--------------------------------------------------------------------------------
292 function can_process() {
295 if (!is_date($_POST['OrderDate'])) {
296 display_error(_("The entered date is invalid."));
297 set_focus('OrderDate');
300 if ($_SESSION['Items']->trans_type!=ST_SALESORDER && $_SESSION['Items']->trans_type!=ST_SALESQUOTE && !is_date_in_fiscalyear($_POST['OrderDate'])) {
301 display_error(_("The entered date is not in fiscal year"));
302 set_focus('OrderDate');
305 if (count($_SESSION['Items']->line_items) == 0) {
306 display_error(_("You must enter at least one non empty item line."));
307 set_focus('AddItem');
310 if ($_SESSION['Items']->cash == 0) {
311 if (strlen($_POST['deliver_to']) <= 1) {
312 display_error(_("You must enter the person or company to whom delivery should be made to."));
313 set_focus('deliver_to');
317 if (strlen($_POST['delivery_address']) <= 1) {
318 display_error( _("You should enter the street address in the box provided. Orders cannot be accepted without a valid street address."));
319 set_focus('delivery_address');
323 if ($_POST['freight_cost'] == "")
324 $_POST['freight_cost'] = price_format(0);
326 if (!check_num('freight_cost',0)) {
327 display_error(_("The shipping cost entered is expected to be numeric."));
328 set_focus('freight_cost');
331 if (!is_date($_POST['delivery_date'])) {
332 if ($_SESSION['Items']->trans_type==ST_SALESQUOTE)
333 display_error(_("The Valid date is invalid."));
335 display_error(_("The delivery date is invalid."));
336 set_focus('delivery_date');
339 //if (date1_greater_date2($_SESSION['Items']->document_date, $_POST['delivery_date'])) {
340 if (date1_greater_date2($_POST['OrderDate'], $_POST['delivery_date'])) {
341 if ($_SESSION['Items']->trans_type==ST_SALESQUOTE)
342 display_error(_("The requested valid date is before the date of the quotation."));
344 display_error(_("The requested delivery date is before the date of the order."));
345 set_focus('delivery_date');
349 if (!$Refs->is_valid($_POST['ref'])) {
350 display_error(_("You must enter a reference."));
357 //-----------------------------------------------------------------------------
359 if (isset($_POST['ProcessOrder']) && can_process()) {
362 $modified = ($_SESSION['Items']->trans_no != 0);
363 $so_type = $_SESSION['Items']->so_type;
364 $_SESSION['Items']->write(1);
365 if (count($messages)) { // abort on failure or error messages are lost
366 $Ajax->activate('_page_body');
367 display_footer_exit();
369 $trans_no = key($_SESSION['Items']->trans_no);
370 $trans_type = $_SESSION['Items']->trans_type;
371 new_doc_date($_SESSION['Items']->document_date);
374 if ($trans_type == ST_SALESQUOTE)
375 meta_forward($_SERVER['PHP_SELF'], "UpdatedQU=$trans_no");
377 meta_forward($_SERVER['PHP_SELF'], "UpdatedID=$trans_no");
378 } elseif ($trans_type == ST_SALESORDER) {
379 meta_forward($_SERVER['PHP_SELF'], "AddedID=$trans_no");
380 } elseif ($trans_type == ST_SALESQUOTE) {
381 meta_forward($_SERVER['PHP_SELF'], "AddedQU=$trans_no");
382 } elseif ($trans_type == ST_SALESINVOICE) {
383 meta_forward($_SERVER['PHP_SELF'], "AddedDI=$trans_no&Type=$so_type");
385 meta_forward($_SERVER['PHP_SELF'], "AddedDN=$trans_no&Type=$so_type");
389 //--------------------------------------------------------------------------------
391 function check_item_data()
395 if (!check_num('qty', 0) || !check_num('Disc', 0, 100)) {
396 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."));
399 } elseif (!check_num('price', 0)) {
400 display_error( _("Price for item must be entered and can not be less than 0"));
403 } elseif (isset($_POST['LineNo']) && isset($_SESSION['Items']->line_items[$_POST['LineNo']])
404 && !check_num('qty', $_SESSION['Items']->line_items[$_POST['LineNo']]->qty_done)) {
407 display_error(_("You attempting to make the quantity ordered a quantity less than has already been delivered. The quantity delivered cannot be modified retrospectively."));
409 } // Joe Hunt added 2008-09-22 -------------------------
410 elseif ($_SESSION['Items']->trans_type!=ST_SALESORDER && $_SESSION['Items']->trans_type!=ST_SALESQUOTE && !$SysPrefs->allow_negative_stock() &&
411 is_inventory_item($_POST['stock_id']))
413 $qoh = get_qoh_on_date($_POST['stock_id'], $_POST['Location'], $_POST['OrderDate']);
414 if (input_num('qty') > $qoh)
416 $stock = get_item($_POST['stock_id']);
417 display_error(_("The delivery cannot be processed because there is an insufficient quantity for item:") .
418 " " . $stock['stock_id'] . " - " . $stock['description'] . " - " .
419 _("Quantity On Hand") . " = " . number_format2($qoh, get_qty_dec($_POST['stock_id'])));
427 //--------------------------------------------------------------------------------
429 function handle_update_item()
431 if ($_POST['UpdateItem'] != '' && check_item_data()) {
432 $_SESSION['Items']->update_cart_item($_POST['LineNo'],
433 input_num('qty'), input_num('price'),
434 input_num('Disc') / 100, $_POST['item_description'] );
439 //--------------------------------------------------------------------------------
441 function handle_delete_item($line_no)
443 if ($_SESSION['Items']->some_already_delivered($line_no) == 0) {
444 $_SESSION['Items']->remove_from_cart($line_no);
446 display_error(_("This item cannot be deleted because some of it has already been delivered."));
451 //--------------------------------------------------------------------------------
453 function handle_new_item()
456 if (!check_item_data()) {
459 add_to_order($_SESSION['Items'], $_POST['stock_id'], input_num('qty'),
460 input_num('price'), input_num('Disc') / 100);
461 $_POST['_stock_id_edit'] = $_POST['stock_id'] = "";
465 //--------------------------------------------------------------------------------
467 function handle_cancel_order()
469 global $path_to_root, $Ajax;
472 if ($_SESSION['Items']->trans_type == ST_CUSTDELIVERY) {
473 display_note(_("Direct delivery entry has been cancelled as requested."), 1);
474 submenu_option(_("Enter a New Sales Delivery"), $_SERVER['PHP_SELF']."?NewDelivery=0");
476 } elseif ($_SESSION['Items']->trans_type == ST_SALESINVOICE) {
477 display_note(_("Direct invoice entry has been cancelled as requested."), 1);
478 submenu_option(_("Enter a New Sales Invoice"), $_SERVER['PHP_SELF']."?NewInvoice=0");
480 if ($_SESSION['Items']->trans_no != 0) {
481 if (sales_order_has_deliveries(key($_SESSION['Items']->trans_no)))
482 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."));
484 delete_sales_order(key($_SESSION['Items']->trans_no), $_SESSION['Items']->trans_type);
485 if ($_SESSION['Items']->trans_type == ST_SALESQUOTE)
487 display_note(_("This sales quotation has been cancelled as requested."), 1);
488 submenu_option(_("Enter a New Sales Quotation"), $_SERVER['PHP_SELF']."?NewQuotation=Yes");
492 display_note(_("This sales order has been cancelled as requested."), 1);
493 submenu_option(_("Enter a New Sales Order"), $_SERVER['PHP_SELF']."?NewOrder=Yes");
498 meta_forward($path_to_root.'/index.php','application=orders');
501 $Ajax->activate('_page_body');
508 //--------------------------------------------------------------------------------
510 function create_cart($type, $trans_no)
517 if (isset($_GET['NewQuoteToSalesOrder']))
519 $trans_no = $_GET['NewQuoteToSalesOrder'];
520 $doc = new Cart(ST_SALESQUOTE, $trans_no);
522 $doc->trans_type = ST_SALESORDER;
523 $doc->reference = $Refs->get_next($doc->trans_type);
524 $doc->document_date = $doc->due_date = new_doc_date();
525 $doc->Comments = _("Sales Quotation") . " # " . $trans_no;
526 $_SESSION['Items'] = $doc;
528 elseif($type != ST_SALESORDER && $type != ST_SALESQUOTE && $trans_no != 0) { // this is template
529 $doc_type = ST_SALESORDER;
531 $doc = new Cart(ST_SALESORDER, array($trans_no));
532 $doc->trans_type = $type;
534 $doc->document_date = new_doc_date();
535 if ($type == ST_SALESINVOICE) {
536 $doc->due_date = get_invoice_duedate($doc->customer_id, $doc->document_date);
537 $doc->pos = user_pos();
538 $pos = get_sales_point($doc->pos);
539 $doc->cash = $pos['cash_sale'];
540 if (!$pos['cash_sale'] || !$pos['credit_sale'])
541 $doc->pos = -1; // mark not editable payment type
543 $doc->cash = date_diff2($doc->due_date, Today(), 'd')<2;
545 $doc->due_date = $doc->document_date;
546 $doc->reference = $Refs->get_next($doc->trans_type);
548 foreach($doc->line_items as $line_no => $line) {
549 $doc->line_items[$line_no]->qty_done = 0;
551 $_SESSION['Items'] = $doc;
553 $_SESSION['Items'] = new Cart($type,array($trans_no));
557 //--------------------------------------------------------------------------------
559 if (isset($_POST['CancelOrder']))
560 handle_cancel_order();
562 $id = find_submit('Delete');
564 handle_delete_item($id);
566 if (isset($_POST['UpdateItem']))
567 handle_update_item();
569 if (isset($_POST['AddItem']))
572 if (isset($_POST['CancelItemChanges'])) {
576 //--------------------------------------------------------------------------------
577 check_db_has_stock_items(_("There are no inventory items defined in the system."));
579 check_db_has_customer_branches(_("There are no customers, or there are no customers with branches. Please define customers and customer branches."));
581 if ($_SESSION['Items']->trans_type == ST_SALESINVOICE) {
582 $idate = _("Invoice Date:");
583 $orderitems = _("Sales Invoice Items");
584 $deliverydetails = _("Enter Delivery Details and Confirm Invoice");
585 $cancelorder = _("Cancel Invoice");
586 $porder = _("Place Invoice");
587 } elseif ($_SESSION['Items']->trans_type == ST_CUSTDELIVERY) {
588 $idate = _("Delivery Date:");
589 $orderitems = _("Delivery Note Items");
590 $deliverydetails = _("Enter Delivery Details and Confirm Dispatch");
591 $cancelorder = _("Cancel Delivery");
592 $porder = _("Place Delivery");
593 } elseif ($_SESSION['Items']->trans_type == ST_SALESQUOTE) {
594 $idate = _("Quotation Date:");
595 $orderitems = _("Sales Quotation Items");
596 $deliverydetails = _("Enter Delivery Details and Confirm Quotation");
597 $cancelorder = _("Cancel Quotation");
598 $porder = _("Place Quotation");
599 $corder = _("Commit Quotations Changes");
601 $idate = _("Order Date:");
602 $orderitems = _("Sales Order Items");
603 $deliverydetails = _("Enter Delivery Details and Confirm Order");
604 $cancelorder = _("Cancel Order");
605 $porder = _("Place Order");
606 $corder = _("Commit Order Changes");
612 $customer_error = display_order_header($_SESSION['Items'],
613 ($_SESSION['Items']->any_already_delivered() == 0), $idate);
615 if ($customer_error == "") {
616 start_table("$table_style width=80%", 10);
618 display_order_summary($orderitems, $_SESSION['Items'], true);
621 display_delivery_details($_SESSION['Items']);
625 if ($_SESSION['Items']->trans_no == 0) {
627 submit_center_first('ProcessOrder', $porder,
628 _('Check entered data and save document'), 'default');
629 submit_js_confirm('CancelOrder', _('You are about to void this Document.\nDo you want to continue?'));
631 submit_center_first('ProcessOrder', $corder,
632 _('Validate changes and update document'), 'default');
635 submit_center_last('CancelOrder', $cancelorder,
636 _('Cancels document entry or removes sales order when editing an old document'));
638 display_error($customer_error);