2 /**********************************************************************
3 Copyright (C) FrontAccounting, LLC.
4 Released under the terms of the GNU General Public License, GPL,
5 as published by the Free Software Foundation, either version 3
6 of the License, or (at your option) any later version.
7 This program is distributed in the hope that it will be useful,
8 but WITHOUT ANY WARRANTY; without even the implied warranty of
9 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
10 See the License here <http://www.gnu.org/licenses/gpl-3.0.html>.
11 ***********************************************************************/
12 include_once($path_to_root . "/sales/includes/cart_class.inc");
13 include_once($path_to_root . "/includes/manufacturing.inc");
15 //--------------------------------------------------------------------------------
16 function add_to_order(&$order, $new_item, $new_item_qty, $price, $discount)
18 // calculate item price to sum of kit element prices factor for
19 // value distribution over all exploded kit items
20 $std_price = get_kit_price($new_item, $order->customer_currency,
21 $order->sales_type, $order->price_factor, get_post('OrderDate'), true);
26 $price_factor = $price/$std_price;
28 $kit = get_item_kit($new_item);
29 $item_num = db_num_rows($kit);
31 while($item = db_fetch($kit)) {
32 $std_price = get_kit_price($item['stock_id'], $order->customer_currency,
33 $order->sales_type, $order->price_factor, get_post('OrderDate'), true);
35 // rounding differences are included in last price item in kit
38 $price -= $item['quantity']*$std_price*$price_factor;
39 $item_price = $std_price*$price_factor;
41 if ($item['quantity'])
42 $price = $price/$item['quantity'];
45 $item_price = round($item_price, user_price_dec());
47 if (!$item['is_foreign'] && $item['item_code'] != $item['stock_id'])
48 { // this is sales kit - recurse
49 add_to_order($order, $item['stock_id'], $new_item_qty*$item['quantity'],
50 $item_price, $discount, $std_price);
53 { // stock item record eventually with foreign code
55 // check duplicate stock item
56 foreach ($order->line_items as $order_item)
58 if (strcasecmp($order_item->stock_id, $item['stock_id']) == 0)
60 display_warning(_("For Part :").$item['stock_id']. " "
61 . _("This item is already on this document. You have been warned."));
65 $order->add_to_cart (count($order->line_items), $item['stock_id'],
66 $new_item_qty*$item['quantity'], $item_price, $discount);
70 //---------------------------------------------------------------------------------
72 function get_customer_details_to_order(&$order, $customer_id, $branch_id)
76 $myrow = get_customer_to_order($customer_id);
78 $name = $myrow['name'];
80 if ($myrow['dissallow_invoices'] == 1)
81 $ret_error = _("The selected customer account is currently on hold. Please contact the credit control personnel to discuss.");
83 $deliver = $myrow['address']; // in case no branch address use company address
85 $order->set_customer($customer_id, $name, $myrow['curr_code'],
86 $myrow['discount'], $myrow['pymt_discount']);
88 // the sales type determines the price list to be used by default
89 $order->set_sales_type($myrow['salestype'], $myrow['sales_type'], $myrow['tax_included'],
92 if ($order->trans_type != ST_SALESORDER && $order->trans_type != ST_SALESQUOTE)
94 $order->dimension_id = $myrow['dimension_id'];
95 $order->dimension2_id = $myrow['dimension2_id'];
97 $result = get_branch_to_order($customer_id, $branch_id);
99 if (db_num_rows($result) == 0)
101 return _("The selected customer and branch are not valid, or the customer does not have any branches.");
104 $myrow = db_fetch($result);
106 $order->set_branch($branch_id, $myrow["tax_group_id"],
107 $myrow["tax_group_name"], $myrow["phone"], $myrow["email"]);
109 $address = trim($myrow["br_post_address"]) != '' ? $myrow["br_post_address"]
110 : (trim($myrow["br_address"]) != '' ? $myrow["br_address"]:$deliver);
112 $order->set_delivery($myrow["default_ship_via"], $myrow["br_name"],
114 if ($order->trans_type == ST_SALESINVOICE) {
115 $order->due_date = get_invoice_duedate($customer_id, $order->document_date);
116 if ($order->pos != -1)
117 $order->cash = date_diff2($order->due_date, Today(), 'd')<2;
120 if($order->pos != -1) {
121 $paym = get_sales_point($order->pos);
122 $order->set_location($paym["pos_location"], $paym["location_name"]);
125 $order->set_location($myrow["default_location"], $myrow["location_name"]);
130 //---------------------------------------------------------------------------------
132 function display_order_summary($title, &$order, $editable_items=false)
134 global $table_style, $path_to_root, $SysPrefs;
136 display_heading($title);
138 div_start('items_table');
139 start_table("$table_style colspan=7 width=90%");
140 $th = array(_("Item Code"), _("Item Description"), _("Quantity"),
142 _("Unit"), _("Price"), _("Discount %"), _("Total"), "");
144 if ($order->trans_no == 0) {
148 if (count($order->line_items))
154 $k = 0; //row colour counter
156 $id = find_submit('Edit');
158 foreach ($order->line_items as $line_no=>$stock_item)
161 $line_total = round($stock_item->qty_dispatched * $stock_item->price * (1 - $stock_item->discount_percent),
165 if (!$editable_items || $id != $line_no)
167 if (!$SysPrefs->allow_negative_stock() && is_inventory_item($stock_item->stock_id)) {
168 $qoh = get_qoh_on_date($stock_item->stock_id,
169 $_POST['Location'], $_POST['OrderDate']);
170 if ($stock_item->qty_dispatched > $qoh)
172 // oops, we don't have enough of one of the component items
173 start_row("class='stockmankobg'");
174 $qoh_msg .= $stock_item->stock_id . " - " . $stock_item->item_description . ": " .
175 _("Quantity On Hand") . " = "
176 . number_format2($qoh, get_qty_dec($stock_item->stock_id)) . '<br>';
179 alt_table_row_color($k);
181 alt_table_row_color($k);
184 view_stock_status_cell($stock_item->stock_id);
186 //label_cell($stock_item->item_description, "nowrap" );
187 label_cell($stock_item->item_description );
188 $dec = get_qty_dec($stock_item->stock_id);
189 qty_cell($stock_item->qty_dispatched, false, $dec);
191 if ($order->trans_no!=0)
192 qty_cell($stock_item->qty_done, false, $dec);
194 label_cell($stock_item->units);
195 amount_cell($stock_item->price);
197 percent_cell($stock_item->discount_percent * 100);
198 amount_cell($line_total);
202 edit_button_cell("Edit$line_no", _("Edit"),
203 _('Edit document line'));
204 delete_button_cell("Delete$line_no", _("Delete"),
205 _('Remove line from document'));
211 sales_order_item_controls($order, $k, $line_no);
214 $total += $line_total;
217 if ($id==-1 && $editable_items)
218 sales_order_item_controls($order, $k);
221 if ($order->trans_no!=0)
224 label_cell(_("Shipping Charge"), "colspan=$colspan align=right");
225 small_amount_cells(null, 'freight_cost', price_format(get_post('freight_cost',0)));
226 label_cell('', 'colspan=2');
228 $display_sub_total = price_format($total + input_num('freight_cost'));
229 label_row(_("Sub-total"), $display_sub_total, "colspan=$colspan align=right","align=right", 2);
230 $taxes = $order->get_taxes(input_num('freight_cost'));
231 $tax_total = display_edit_tax_items($taxes, $colspan, $order->tax_included, 2);
233 $display_total = price_format(($total + input_num('freight_cost') + $tax_total));
236 label_cells(_("Amount Total"), $display_total, "colspan=$colspan align=right","align=right");
237 submit_cells('update', _("Update"), "colspan=2", _("Refresh"), true);
242 display_note(_("Marked items have insufficient quantities in stock as on day of delivery."), 0, 1, "class='stockmankofg'");
243 if ($order->trans_type!=30 && !$SysPrefs->allow_negative_stock())
244 display_error(_("The delivery cannot be processed because there is an insufficient quantity for item:")
250 // ------------------------------------------------------------------------------
252 function display_order_header(&$order, $editable, $date_text, $display_tax_group=false)
254 global $table_style2, $Ajax, $SysPrefs;
256 start_outer_table("width=80% $table_style2");
260 $customer_error = "";
263 if (isset($order) && !$editable)
265 // can't change the customer/branch if items already received on this order
266 //echo $order->customer_name . " - " . $order->deliver_to;
267 label_row(null, $order->customer_name . " - " . $order->deliver_to);
268 hidden('customer_id', $order->customer_id);
269 hidden('branch_id', $order->Branch);
270 hidden('sales_type', $order->sales_type);
271 if ($order->trans_type != ST_SALESORDER && $order->trans_type != ST_SALESQUOTE) {
272 hidden('dimension_id', $order->dimension_id); // 2008-11-12 Joe Hunt
273 hidden('dimension2_id', $order->dimension2_id);
278 customer_list_row(_("Customer:"), 'customer_id', null, false, true, false, true);
280 if ($order->customer_id != get_post('customer_id', -1))
282 // customer has changed
283 $Ajax->activate('branch_id');
285 customer_branches_list_row(_("Branch:"),
286 $_POST['customer_id'], 'branch_id', null, false, true, true, true);
288 if( ($order->customer_id != get_post('customer_id', -1)) ||
289 ($order->Branch != get_post('branch_id', -1)) ||
290 list_updated('customer_id'))
293 if (!isset($_POST['branch_id']) || $_POST['branch_id'] == "")
295 // ignore errors on customer search box call
296 if ($_POST['customer_id'] == '')
297 $customer_error = _("No customer found for entered text.");
299 $customer_error = _("The selected customer does not have any branches. Please create at least one branch.");
300 unset($_POST['branch_id']);
306 $old_order = (PHP_VERSION<5) ? $order : clone( $order );
308 $customer_error = get_customer_details_to_order($order, $_POST['customer_id'], $_POST['branch_id']);
309 $_POST['Location'] = $order->Location;
310 $_POST['deliver_to'] = $order->deliver_to;
311 $_POST['delivery_address'] = $order->delivery_address;
312 $_POST['phone'] = $order->phone;
313 if (get_post('cash') !== $order->cash) {
314 $_POST['cash'] = $order->cash;
315 $Ajax->activate('delivery');
316 $Ajax->activate('cash');
318 if ($order->trans_type == ST_SALESINVOICE)
320 $_POST['delivery_date'] = $order->due_date;
321 $Ajax->activate('delivery_date');
323 $Ajax->activate('Location');
324 $Ajax->activate('deliver_to');
325 $Ajax->activate('phone');
326 $Ajax->activate('delivery_address');
328 // change prices if necessary
329 // what about discount in template case?
330 if ($old_order->customer_currency != $order->customer_currency) {
333 if ($old_order->sales_type != $order->sales_type) {
334 // || $old_order->default_discount!=$order->default_discount
335 $_POST['sales_type'] = $order->sales_type;
336 $Ajax->activate('sales_type');
339 if ($old_order->dimension_id != $order->dimension_id) {
340 $_POST['dimension_id'] = $order->dimension_id;
341 $Ajax->activate('dimension_id');
343 if ($old_order->dimension2_id != $order->dimension2_id) {
344 $_POST['dimension2_id'] = $order->dimension2_id;
345 $Ajax->activate('dimension2_id');
349 set_global_customer($_POST['customer_id']);
353 $row = get_customer_to_order($_POST['customer_id']);
354 if ($row['dissallow_invoices'] == 1)
355 $customer_error = _("The selected customer account is currently on hold. Please contact the credit control personnel to discuss.");
360 ref_row(_("Reference").':', 'ref', _('Reference number unique for this document type'), null, '');
362 if (!is_company_currency($order->customer_currency))
366 label_row(_("Customer Currency:"), $order->customer_currency);
367 exchange_rate_display($order->customer_currency, get_company_currency(),
368 ($editable ? $_POST['OrderDate'] : $order->document_date));
372 if ($order->trans_type == ST_SALESINVOICE && $order->pos != -1) {
373 sale_payment_list_cells(_('Payment:'), 'cash', null, true);
374 $cash_payment = get_post('cash', 0);
375 // current user can issue both credit and cash invoices
376 if ($order->cash != $cash_payment) {
377 $order->cash = $cash_payment;
379 $paym = get_sales_point(user_pos());
380 $order->cash_account = $paym['pos_account'];
381 $order->account_name = $paym['bank_account_name'];
382 $_POST['Location'] = $order->Location = $paym['pos_location'];
383 $order->location_name = $paym['location_name'];
385 $Ajax->activate('items_table');
386 $Ajax->activate('delivery');
387 set_focus($order->pos == -1 ? 'delivery_date' : 'account');
390 hidden('cash', $order->cash);
393 $str = sales_types_list_row(_("Price List"), 'sales_type', null, true);
395 label_row(_("Price List:"), $order->sales_type_name);
397 if ($order->sales_type != $_POST['sales_type']) {
398 $myrow = get_sales_type($_POST['sales_type']);
399 $order->set_sales_type($myrow['id'], $myrow['sales_type'],
400 $myrow['tax_included'], $myrow['factor']);
401 $Ajax->activate('sales_type');
405 label_row(_("Customer Discount:"), ($order->default_discount * 100) . "%");
411 if (!isset($_POST['OrderDate']) || $_POST['OrderDate'] == "")
412 $_POST['OrderDate'] = $order->document_date;
414 date_row($date_text, 'OrderDate', _('Date of order receive'),
415 $order->trans_no==0, 0, 0, 0, null, true);
416 if (isset($_POST['_OrderDate_changed'])) {
417 if (!is_company_currency($order->customer_currency)
418 && (get_base_sales_type()>0)) {
421 $Ajax->activate('_ex_rate');
422 if ($order->trans_type == ST_SALESINVOICE) {
423 $_POST['delivery_date'] = get_invoice_duedate(get_post('customer_id'), get_post('OrderDate'));
425 $_POST['delivery_date'] = add_days(get_post('OrderDate'), $SysPrefs->default_delivery_required_by());
426 $Ajax->activate('items_table');
427 $Ajax->activate('delivery_date');
429 if ($order->trans_type != ST_SALESORDER && $order->trans_type != ST_SALESQUOTE)
430 { // 2008-11-12 Joe Hunt added dimensions
431 $dim = get_company_pref('use_dimension');
433 dimensions_list_row(_("Dimension").":", 'dimension_id',
434 null, true, ' ', false, 1, false);
436 hidden('dimension_id', 0);
438 dimensions_list_row(_("Dimension")." 2:", 'dimension2_id',
439 null, true, ' ', false, 2, false);
441 hidden('dimension2_id', 0);
446 label_row($date_text, $order->document_date);
447 hidden('OrderDate', $order->document_date);
450 if ($display_tax_group)
452 label_row(_("Tax Group:"), $order->tax_group_name);
453 hidden('tax_group_id', $order->tax_group_id);
456 end_outer_table(1); // outer table
458 if ($change_prices != 0) {
459 foreach ($order->line_items as $line_no=>$item) {
460 $line = &$order->line_items[$line_no];
461 $line->price = get_kit_price($line->stock_id, $order->customer_currency,
462 $order->sales_type, $order->price_factor, get_post('OrderDate'));
463 // $line->discount_percent = $order->default_discount;
465 $Ajax->activate('items_table');
468 return $customer_error;
471 //--------------------------------------------------------------------------------
473 function sales_order_item_controls(&$order, &$rowcounter, $line_no=-1)
477 alt_table_row_color($rowcounter);
479 $id = find_submit('Edit');
480 if ($line_no!=-1 && $line_no == $id) // edit old line
482 $_POST['stock_id'] = $order->line_items[$id]->stock_id;
483 $dec = get_qty_dec($_POST['stock_id']);
484 $_POST['qty'] = number_format2($order->line_items[$id]->qty_dispatched, $dec);
485 $_POST['price'] = price_format($order->line_items[$id]->price);
486 $_POST['Disc'] = percent_format($order->line_items[$id]->discount_percent*100);
487 $_POST['item_description'] = $order->line_items[$id]->item_description;
488 $units = $order->line_items[$id]->units;
489 hidden('stock_id', $_POST['stock_id']);
490 label_cell($_POST['stock_id']);
491 text_cells(null,'item_description', null, 45, 150);
492 //label_cell($order->line_items[$line_no]->item_description, "nowrap");
493 $Ajax->activate('items_table');
495 else // prepare new line
497 sales_items_list_cells(null,'stock_id', null, false, true);
498 if (list_updated('stock_id')) {
499 $Ajax->activate('price');
500 $Ajax->activate('units');
501 $Ajax->activate('qty');
502 $Ajax->activate('line_total');
505 $item_info = get_item_edit_info($_POST['stock_id']);
506 $units = $item_info["units"];
507 $dec = $item_info['decimals'];
508 $_POST['qty'] = number_format2(1, $dec);
509 $price = get_kit_price($_POST['stock_id'],
510 $order->customer_currency, $order->sales_type,
511 $order->price_factor, get_post('OrderDate'));
512 $_POST['price'] = price_format($price);
513 // default to the customer's discount %
514 $_POST['Disc'] = percent_format($order->default_discount * 100);
517 qty_cells(null, 'qty', $_POST['qty'], null, null, $dec);
519 if ($order->trans_no!=0) {
520 qty_cell($line_no==-1 ? 0 :$order->line_items[$line_no]->qty_done, false, $dec);
523 label_cell($units, '', 'units');
525 $str = amount_cells(null, 'price');
527 small_amount_cells(null, 'Disc', percent_format($_POST['Disc']), null, null, user_percent_dec());
529 $line_total = input_num('qty') * input_num('price') * (1 - input_num('Disc') / 100);
531 amount_cell($line_total, false, '','line_total');
535 button_cell('UpdateItem', _("Update"),
536 _('Confirm changes'), ICON_UPDATE);
537 button_cell('CancelItemChanges', _("Cancel"),
538 _('Cancel changes'), ICON_CANCEL);
539 hidden('LineNo', $line_no);
544 submit_cells('AddItem', _("Add Item"), "colspan=2",
545 _('Add new item to document'), true);
551 //--------------------------------------------------------------------------------
553 function display_delivery_details(&$order)
555 global $table_style2, $Ajax;
557 div_start('delivery');
559 if (get_post('cash', 0)) { // Direct payment sale
560 $Ajax->activate('items_table');
561 display_heading(_('Cash payment'));
562 start_table("$table_style2 width=60%");
563 label_row(_("Deliver from Location:"), $order->location_name);
565 hidden('Location', $order->Location);
566 label_row(_("Cash account:"), $order->account_name);
567 textarea_row(_("Comments:"), "Comments", $order->Comments, 31, 5);
571 if ($order->trans_type==ST_SALESINVOICE)
573 $title = _("Delivery Details");
574 $delname = _("Due Date").':';
576 elseif ($order->trans_type==ST_CUSTDELIVERY)
578 $title = _("Invoice Delivery Details");
579 $delname = _("Invoice before").':';
581 elseif ($order->trans_type==ST_SALESQUOTE)
583 $title = _("Quotation Delivery Details");
584 $delname = _("Valid until").':';
588 $title = _("Order Delivery Details");
589 $delname = _("Required Delivery Date").':';
591 display_heading($title);
592 start_outer_table("$table_style2 width=90%");
595 locations_list_row(_("Deliver from Location:"), 'Location', null,
597 if (list_updated('Location'))
598 $Ajax->activate('items_table');
601 date_row($delname, 'delivery_date',
602 $order->trans_type==ST_SALESORDER ? _('Enter requested day of delivery') : $order->trans_type==ST_SALESQUOTE ? _('Enter Valid until Date') : '');
603 text_row(_("Deliver To:"), 'deliver_to', $order->deliver_to, 40, 40,
604 _('Additional identifier for delivery e.g. name of receiving person'));
606 textarea_row(_("Address:"), 'delivery_address', $order->delivery_address, 35, 5,
607 _('Delivery address. Default is address of customer branch'));
611 text_row(_("Contact Phone Number:"), 'phone', $order->phone, 25, 25,
612 _('Phone number of ordering person. Defaults to branch phone number'));
613 text_row(_("Customer Reference:"), 'cust_ref', $order->cust_ref, 25, 25,
614 _('Customer reference number for this order (if any)'));
615 textarea_row(_("Comments:"), "Comments", $order->Comments, 31, 5);
617 shippers_list_row(_("Shipping Company:"), 'ship_via', $order->ship_via);