Automatic first field focus on page start, preserved focus sequence
[fa-stable.git] / 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
20 $js = '';
21 if ($use_popup_windows) {
22         $js .= get_js_open_window(900, 500);
23 }
24 if ($use_date_picker) {
25         $js .= get_js_date_picker();
26 }
27
28 if (isset($_GET['NewDelivery']) && is_numeric($_GET['NewDelivery'])) {
29
30         $_SESSION['page_title'] = _("Direct Sales Delivery");
31         create_cart(13, $_GET['NewDelivery']);
32
33 } elseif (isset($_GET['NewInvoice']) && is_numeric($_GET['NewInvoice'])) {
34
35         $_SESSION['page_title'] = _("Direct Sales Invoice");
36         create_cart(10, $_GET['NewInvoice']);
37
38 } elseif (isset($_GET['ModifyOrderNumber']) && is_numeric($_GET['ModifyOrderNumber'])) {
39
40         $help_page_title = _('Modifying Sales Order');
41         $_SESSION['page_title'] = sprintf( _("Modifying Sales Order # %d"), $_GET['ModifyOrderNumber']);
42         create_cart(30, $_GET['ModifyOrderNumber']);
43
44 } elseif (isset($_GET['NewOrder'])) {
45
46         $_SESSION['page_title'] = _("New Sales Order Entry");
47         create_cart(30, 0);
48 }
49
50 page($_SESSION['page_title'], false, false, "", $js);
51
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 =  str_replace("'", "\\'", $_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         $_POST['branch_id'] = $cart->Branch;
182         $_POST['sales_type'] = $cart->sales_type;
183 }
184
185 //--------------------------------------------------------------------------------
186
187 function can_process() {
188         if (!is_date($_POST['OrderDate'])) {
189                 display_error(_("The entered date is invalid."));
190                 return false;
191         }
192         if ($_SESSION['Items']->trans_type!=30 && !is_date_in_fiscalyear($_POST['OrderDate'])) {
193                 display_error(_("The entered date is not in fiscal year"));
194                 return false;
195         }
196         if (count($_SESSION['Items']->line_items) == 0) {
197                 display_error(_("You must enter at least one non empty item line."));
198                 return false;
199         }
200         if (strlen($_POST['deliver_to']) <= 1) {
201                 display_error(_("You must enter the person or company to whom delivery should be made to."));
202                 return false;
203         }
204         if (strlen($_POST['delivery_address']) <= 1) {
205                 display_error( _("You should enter the street address in the box provided. Orders cannot be accepted without a valid street address."));
206                 return false;
207         }
208
209         if ($_POST['freight_cost'] == "")
210                 $_POST['freight_cost'] = price_format(0);
211
212         if (!check_num('freight_cost',0)) {
213                 display_error(_("The shipping cost entered is expected to be numeric."));
214                 return false;
215         }
216         if (!is_date($_POST['delivery_date'])) {
217                 display_error(_("The delivery date is invalid."));
218                 return false;
219         }
220         if (date1_greater_date2($_SESSION['Items']->document_date, $_POST['delivery_date'])) {
221                 display_error(_("The requested delivery date is before the date of the order."));
222                 return false;
223         }
224         if ($_SESSION['Items']->trans_type != 30 && !references::is_valid($_POST['ref'])) {
225                 display_error(_("You must enter a reference."));
226                 return false;
227         }
228
229         return true;
230 }
231
232 //-----------------------------------------------------------------------------
233
234 if (isset($_POST['ProcessOrder']) && can_process()) {
235         copy_to_cart();
236
237         $modified = ($_SESSION['Items']->trans_no != 0);
238         $so_type = $_SESSION['Items']->so_type;
239
240         $_SESSION['Items']->write(1);
241
242         $trans_no = key($_SESSION['Items']->trans_no);
243         $trans_type = $_SESSION['Items']->trans_type;
244
245         processing_end();
246         if ($modified) {
247                 meta_forward($_SERVER['PHP_SELF'], "UpdatedID=$trans_no");
248         } elseif ($trans_type == 30) {
249                 meta_forward($_SERVER['PHP_SELF'], "AddedID=$trans_no");
250         } elseif ($trans_type == 10) {
251                 meta_forward($_SERVER['PHP_SELF'], "AddedDI=$trans_no&Type=$so_type");
252         } else {
253                 meta_forward($_SERVER['PHP_SELF'], "AddedDN=$trans_no&Type=$so_type");
254         }
255 }
256
257 //--------------------------------------------------------------------------------
258
259 function check_item_data()
260 {
261
262         if (!check_num('qty', 0) || !check_num('Disc', 0, 100)) {
263                 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."));
264                 return false;
265         } elseif (!check_num('price', 0)) {
266                 display_error( _("Price for item must be entered and can not be less than 0"));
267                 return false;
268         } elseif (isset($_POST['LineNo']) && isset($_SESSION['Items']->line_items[$_POST['LineNo']])
269             && !check_num('qty', $_SESSION['Items']->line_items[$_POST['LineNo']]->qty_done)) {
270
271                 display_error(_("You attempting to make the quantity ordered a quantity less than has already been delivered. The quantity delivered cannot be modified retrospectively."));
272                 return false;
273         }
274         return true;
275 }
276
277 //--------------------------------------------------------------------------------
278
279 function handle_update_item()
280 {
281         if ($_POST['UpdateItem'] != '' && check_item_data()) {
282                 $_SESSION['Items']->update_cart_item($_POST['LineNo'],
283                  input_num('qty'), input_num('price'), 
284                  input_num('Disc') / 100 );
285         }
286   copy_from_cart();
287   set_focus('StockID2');
288 }
289
290 //--------------------------------------------------------------------------------
291
292 function handle_delete_item($line_no)
293 {
294     if ($_SESSION['Items']->some_already_delivered($line_no) == 0) {
295         $_SESSION['Items']->remove_from_cart($line_no);
296     } else {
297         display_error(_("This item cannot be deleted because some of it has already been delivered."));
298     }
299     set_focus('StockID2');
300 }
301
302 //--------------------------------------------------------------------------------
303
304 function handle_new_item()
305 {
306         if (!check_item_data()) {
307                         return;
308         }
309         add_to_order($_SESSION['Items'], $_POST['stock_id'], input_num('qty'),
310                 input_num('price'), input_num('Disc') / 100);
311
312         $_POST['StockID2'] = $_POST['stock_id'] = "";
313         set_focus('StockID2');
314 }
315
316 //--------------------------------------------------------------------------------
317
318 function  handle_cancel_order()
319 {
320         global $path_to_root;
321
322         if ($_POST['CancelOrder'] != "") {
323
324         if ($_SESSION['Items']->trans_type == 13) {
325                         display_note(_("Direct delivery entry has been cancelled as requested."), 1);
326                         hyperlink_params($path_to_root . "/sales/sales_order_entry.php",
327                                         _("Enter a New Sales Delivery"), SID . "&NewDelivery=0");
328         } elseif ($_SESSION['Items']->trans_type == 10) {
329                         display_note(_("Direct invoice entry has been cancelled as requested."), 1);
330                         hyperlink_params($path_to_root . "/sales/sales_order_entry.php",
331                                         _("Enter a New Sales Delivery"), SID . "&NewDelivery=0");
332         } else {
333                 if ($_SESSION['Items']->trans_no != 0) {
334                         if (sales_order_has_deliveries(key($_SESSION['Items']->trans_no)))
335                                 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."));
336                         else
337                                 delete_sales_order(key($_SESSION['Items']->trans_no));
338                 }
339
340                         display_note(_("This sales order has been cancelled as requested."), 1);
341                                 hyperlink_params($path_to_root . "/sales/sales_order_entry.php",
342                                 _("Enter a New Sales Order"), SID . "&NewOrder=Yes");
343                 }
344                 processing_end();
345                 br(1);
346                 end_page();
347                 exit;
348         }
349 }
350
351 //--------------------------------------------------------------------------------
352
353 function create_cart($type, $trans_no)
354 {
355         processing_start();
356         $doc_type = $type;
357
358         if($type != 30 && $trans_no != 0) { // this is template
359                 $doc_type = 30;
360
361                 $doc = new Cart(30, array($trans_no));
362                 $doc->trans_type = $type;
363                 $doc->trans_no = 0;
364                 if ($type == 10)
365                         $doc->due_date = get_invoice_duedate($doc->customer_id, $doc->document_date);
366                 else
367                         $doc->due_date = $doc->document_date = Today();
368                 $doc->reference = references::get_next($doc->trans_type);
369                 $doc->Comments='';
370                 foreach($doc->line_items as $line_no => $line) {
371                         $doc->line_items[$line_no]->qty_done = 0;
372                 }
373                 $_SESSION['Items'] = $doc;
374         } else
375                 $_SESSION['Items'] = new Cart($type,array($trans_no));
376
377         copy_from_cart();
378 }
379
380 //--------------------------------------------------------------------------------
381
382
383 //if (isset($_GET['Delete']) || isset($_GET['Edit']))
384 //      copy_from_cart(); // GET method need form restore
385
386 if (isset($_POST['CancelOrder']))
387         handle_cancel_order();
388
389 $id = find_submit('Delete');
390 if ($id!=-1)
391         handle_delete_item($id);
392
393 if (isset($_POST['UpdateItem']))
394         handle_update_item();
395
396 if (isset($_POST['AddItem']))
397         handle_new_item();
398
399 if (isset($_POST['CancelItemChanges']) || isset($_POST['UpdateItem']))
400         set_focus('StockID2');
401
402 //--------------------------------------------------------------------------------
403
404 check_db_has_stock_items(_("There are no inventory items defined in the system."));
405
406 check_db_has_customer_branches(_("There are no customers, or there are no customers with branches. Please define customers and customer branches."));
407
408 if ($_SESSION['Items']->trans_type == 10) {
409         $idate = _("Invoice Date:");
410         $orderitems = _("Sales Invoice Items");
411         $deliverydetails = _("Enter Delivery Details and Confirm Invoice");
412         $cancelorder = _("Cancel Invoice");
413         $porder = _("Place Invoice");
414 } elseif ($_SESSION['Items']->trans_type == 13) {
415         $idate = _("Delivery Date:");
416         $orderitems = _("Delivery Note Items");
417         $deliverydetails = _("Enter Delivery Details and Confirm Dispatch");
418         $cancelorder = _("Cancel Delivery");
419         $porder = _("Place Delivery");
420 } else {
421         $idate = _("Order Date:");
422         $orderitems = _("Sales Order Items");
423         $deliverydetails = _("Enter Delivery Details and Confirm Order");
424         $cancelorder = _("Cancel Order");
425         $porder = _("Place Order");
426         $corder = _("Commit Order Changes");
427 }
428 start_form(false, true);
429
430 $customer_error = display_order_header($_SESSION['Items'],
431         ($_SESSION['Items']->any_already_delivered() == 0), $idate);
432
433 if ($customer_error == "") {
434         start_table("$table_style width=80%", 10);
435         echo "<tr><td>";
436         display_order_summary($orderitems, $_SESSION['Items'], true);
437         echo "</td></tr>";
438         echo "<tr><td>";
439         display_delivery_details($_SESSION['Items']);
440         echo "</td></tr>";
441         end_table(1);
442
443         if ($_SESSION['Items']->trans_no == 0) {
444                 submit_center_first('ProcessOrder', $porder);
445         } else {
446                 submit_center_first('ProcessOrder', $corder);
447         }
448
449         submit_center_last('CancelOrder', $cancelorder);
450 } else {
451         display_error($customer_error);
452 }
453 end_form();
454 //--------------------------------------------------------------------------------
455 end_page();
456 ?>