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");
14 //--------------------------------------------------------------------------------
15 function add_to_order(&$order, $new_item, $new_item_qty, $price, $discount, $description='')
17 // calculate item price to sum of kit element prices factor for
18 // value distribution over all exploded kit items
19 $std_price = get_kit_price($new_item, $order->customer_currency,
20 $order->sales_type, $order->price_factor, get_post('OrderDate'), true);
25 $price_factor = $price/$std_price;
27 $kit = get_item_kit($new_item);
28 $item_num = db_num_rows($kit);
30 while($item = db_fetch($kit)) {
31 $std_price = get_kit_price($item['stock_id'], $order->customer_currency,
32 $order->sales_type, $order->price_factor, get_post('OrderDate'), true);
34 // rounding differences are included in last price item in kit
37 $price -= $item['quantity']*$std_price*$price_factor;
38 $item_price = $std_price*$price_factor;
40 if ($item['quantity'])
41 $price = $price/$item['quantity'];
44 $item_price = round($item_price, user_price_dec());
46 if (!$item['is_foreign'] && $item['item_code'] != $item['stock_id'])
47 { // this is sales kit - recurse
48 add_to_order($order, $item['stock_id'], $new_item_qty*$item['quantity'],
49 $item_price, $discount);
52 { // stock item record eventually with foreign code
54 // check duplicate stock item
55 foreach ($order->line_items as $order_item)
57 if (strcasecmp($order_item->stock_id, $item['stock_id']) == 0)
59 display_warning(_("For Part :").$item['stock_id']. " "
60 . _("This item is already on this document. You have been warned."));
64 $order->add_to_cart (count($order->line_items), $item['stock_id'],
65 $new_item_qty*$item['quantity'], $item_price, $discount, 0,0, $description);
70 //---------------------------------------------------------------------------------
72 function get_customer_details_to_order(&$order, $customer_id, $branch_id)
78 $myrow = get_customer_to_order($customer_id);
80 $name = $myrow['name'];
82 if ($myrow['dissallow_invoices'] == 1)
83 $ret_error = _("The selected customer account is currently on hold. Please contact the credit control personnel to discuss.");
85 $deliver = $myrow['address']; // in case no branch address use company address
87 $order->set_customer($customer_id, $name, $myrow['curr_code'],
88 $myrow['discount'], $myrow['payment_terms']);
90 // the sales type determines the price list to be used by default
91 $order->set_sales_type($myrow['salestype'], $myrow['sales_type'], $myrow['tax_included'],
94 $order->credit = $myrow['cur_credit'];
96 if ($order->trans_type != ST_SALESORDER && $order->trans_type != ST_SALESQUOTE)
98 $order->dimension_id = $myrow['dimension_id'];
99 $order->dimension2_id = $myrow['dimension2_id'];
101 $result = get_branch_to_order($customer_id, $branch_id);
103 if (db_num_rows($result) == 0)
105 return _("The selected customer and branch are not valid, or the customer does not have any branches.");
108 $myrow = db_fetch($result);
110 // FIX - implement editable contact selector in sales order
111 $contact = get_branch_contacts($branch_id, 'order', $customer_id);
112 $order->set_branch($branch_id, $myrow["tax_group_id"],
113 $myrow["tax_group_name"], @$contact["phone"], @$contact["email"]);
115 $address = trim($myrow["br_post_address"]) != '' ? $myrow["br_post_address"]
116 : (trim($myrow["br_address"]) != '' ? $myrow["br_address"]:$deliver);
118 $order->set_delivery($myrow["default_ship_via"], $myrow["br_name"],
120 if ($order->trans_type == ST_SALESINVOICE) {
121 $order->due_date = get_invoice_duedate($order->payment, $order->document_date);
123 elseif ($order->trans_type == ST_SALESORDER)
124 $order->due_date = add_days($order->document_date, $SysPrefs->default_delivery_required_by());
125 elseif ($order->trans_type == ST_SALESQUOTE)
126 $order->due_date = add_days($order->document_date, $SysPrefs->default_quote_valid_days());
128 if($order->payment_terms['type'] == PTT_CASH) {
129 $order->set_location($order->pos["pos_location"], $order->pos["location_name"]);
131 $order->set_location($myrow["default_location"], $myrow["location_name"]);
136 //---------------------------------------------------------------------------------
138 function display_order_summary($title, &$order, $editable_items=false)
141 display_heading($title);
143 div_start('items_table');
144 start_table(TABLESTYLE, "width='90%'");
146 $th = array(_("Item Code"), _("Item Description"), _("Quantity"),
148 _("Unit"), $order->tax_included ? _("Price after Tax") : _("Price before Tax"), _("Discount %"), _("Total"), "");
150 if ($order->trans_no == 0) {
154 if (count($order->line_items))
160 $k = 0; //row colour counter
162 $id = find_submit('Edit');
164 $low_stock = $order->check_qoh($_POST['OrderDate'], $_POST['Location']);
165 foreach ($order->get_items() as $line_no=>$stock_item)
168 $line_total = round($stock_item->qty_dispatched * $stock_item->price * (1 - $stock_item->discount_percent),
172 if (!$editable_items || $id != $line_no)
174 if (in_array($stock_item->stock_id, $low_stock))
175 start_row("class='stockmankobg'"); // notice low stock status
177 alt_table_row_color($k);
179 view_stock_status_cell($stock_item->stock_id);
181 label_cell($stock_item->item_description );
182 $dec = get_qty_dec($stock_item->stock_id);
183 qty_cell($stock_item->qty_dispatched, false, $dec);
185 if ($order->trans_no!=0)
186 qty_cell($stock_item->qty_done, false, $dec);
188 label_cell($stock_item->units);
189 amount_cell($stock_item->price);
191 percent_cell($stock_item->discount_percent * 100);
192 amount_cell($line_total);
196 edit_button_cell("Edit$line_no", _("Edit"),
197 _('Edit document line'));
198 delete_button_cell("Delete$line_no", _("Delete"),
199 _('Remove line from document'));
205 sales_order_item_controls($order, $k, $line_no);
208 $total += $line_total;
211 if ($id==-1 && $editable_items)
212 sales_order_item_controls($order, $k);
215 if ($order->trans_no!=0)
219 label_cell(_("Shipping method:") . shipping_methods_list('ship_via', null, _("None"), true), "colspan=$colspan align=right");
221 if (get_post('ship_via') !== ALL_TEXT)
223 small_amount_cells(null, 'freight_cost', price_format(get_post('freight_cost',0)));
224 label_cell('', 'colspan=2');
226 label_cell('', 'colspan=3');
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 align='center'", _("Refresh"), true);
242 display_note(_("Marked items have insufficient quantities in stock as on day of delivery."), 0, 1, "class='stockmankofg'");
247 // ------------------------------------------------------------------------------
249 function display_order_header(&$order, $editable, $date_text)
251 global $Ajax, $SysPrefs;
253 start_outer_table(TABLESTYLE2, "width='80%'");
257 $customer_error = "";
260 if (isset($order) && !$editable)
262 label_row(null, $order->customer_name . " - " . $order->deliver_to);
263 hidden('customer_id', $order->customer_id);
264 hidden('branch_id', $order->Branch);
265 hidden('sales_type', $order->sales_type);
266 if ($order->trans_type != ST_SALESORDER && $order->trans_type != ST_SALESQUOTE) {
267 hidden('dimension_id', $order->dimension_id); // 2008-11-12 Joe Hunt
268 hidden('dimension2_id', $order->dimension2_id);
273 customer_list_row(_("Customer:"), 'customer_id', null, false, true, false, true);
275 if ($order->customer_id != get_post('customer_id', -1))
277 // customer has changed
278 $Ajax->activate('branch_id');
280 customer_branches_list_row(_("Branch:"),
281 $_POST['customer_id'], 'branch_id', null, false, true, true, true);
283 if( ($order->customer_id != get_post('customer_id', -1)) ||
284 ($order->Branch != get_post('branch_id', -1)) ||
285 list_updated('customer_id'))
288 if (!isset($_POST['branch_id']) || $_POST['branch_id'] == "")
290 // ignore errors on customer search box call
291 if ($_POST['customer_id'] == '')
292 $customer_error = _("No customer found for entered text.");
294 $customer_error = _("The selected customer does not have any branches. Please create at least one branch.");
295 unset($_POST['branch_id']);
301 $old_order = (PHP_VERSION<5) ? $order : clone $order;
303 $customer_error = get_customer_details_to_order($order, $_POST['customer_id'], $_POST['branch_id']);
304 $_POST['Location'] = $order->Location;
305 $_POST['deliver_to'] = $order->deliver_to;
306 $_POST['delivery_address'] = $order->delivery_address;
307 $_POST['phone'] = $order->phone;
308 $_POST['delivery_date'] = $order->due_date;
310 if (!in_array($order->trans_type, array(ST_SALESQUOTE, ST_SALESORDER))
311 && ($order->pos['cash_sale'] != $order->pos['credit_sale'])
312 && (($order->payment_terms['type'] == PTT_CASH && !$order->pos['cash_sale']) ||
313 (!$order->payment_terms['type'] != PTT_CASH && !$order->pos['credit_sale']))) {
314 // force payment terms refresh if terms are editable
315 // and pos have no permitions for terms selected in customer record.
316 // Terms are set to first terms in allowed category below.
318 sprintf(_("Customer's payment terms '%s' cannot be selected on this POS"),
319 $order->payment_terms['terms']));
320 $order->payment = '';
321 } elseif (get_post('payment') !== $order->payment) {
322 $_POST['payment'] = $order->payment;
323 $Ajax->activate('delivery');
324 $Ajax->activate('payment');
326 if ($order->trans_type == ST_SALESINVOICE)
328 $_POST['delivery_date'] = $order->due_date;
329 $Ajax->activate('delivery_date');
331 $Ajax->activate('Location');
332 $Ajax->activate('deliver_to');
333 $Ajax->activate('phone');
334 $Ajax->activate('delivery_address');
336 // change prices if necessary
337 // what about discount in template case?
338 if ($old_order->customer_currency != $order->customer_currency) {
341 if ($old_order->sales_type != $order->sales_type) {
342 // || $old_order->default_discount!=$order->default_discount
343 $_POST['sales_type'] = $order->sales_type;
344 $Ajax->activate('sales_type');
347 if ($old_order->dimension_id != $order->dimension_id) {
348 $_POST['dimension_id'] = $order->dimension_id;
349 $Ajax->activate('dimension_id');
351 if ($old_order->dimension2_id != $order->dimension2_id) {
352 $_POST['dimension2_id'] = $order->dimension2_id;
353 $Ajax->activate('dimension2_id');
357 set_global_customer($_POST['customer_id']);
361 $row = get_customer_to_order($_POST['customer_id']);
362 if ($row['dissallow_invoices'] == 1)
363 $customer_error = _("The selected customer account is currently on hold. Please contact the credit control personnel to discuss.");
367 ref_row(_("Reference").':', 'ref', _('Reference number unique for this document type'), null, '', $order->trans_type, array('date'=> @$_POST['OrderDate']));
371 if (!is_company_currency($order->customer_currency) && in_array($order->trans_type, array(ST_SALESINVOICE, ST_CUSTDELIVERY)))
373 label_row(_("Customer Currency:"), $order->customer_currency);
374 exchange_rate_display(get_company_currency(), $order->customer_currency,
375 ($editable ? $_POST['OrderDate'] : $order->document_date));
378 customer_credit_row($_POST['customer_id'], $order->credit);
380 label_row(_("Customer Discount:"), ($order->default_discount * 100) . "%");
384 if (($order->pos['cash_sale'] || $order->pos['credit_sale'])
385 && !$order->is_started()) {
386 // editable payment type
387 if (get_post('payment') !== $order->payment) {
388 $order->payment = get_post('payment');
389 $order->payment_terms = get_payment_terms($order->payment);
390 $order->due_date = get_invoice_duedate($order->payment, $order->document_date);
391 if ($order->payment_terms['type'] == PTT_CASH) {
392 $_POST['Location'] = $order->Location = $order->pos['pos_location'];
393 $order->location_name = $order->pos['location_name'];
395 $Ajax->activate('items_table');
396 $Ajax->activate('delivery');
398 $paymcat = !$order->pos['cash_sale'] ? PM_CREDIT :
399 (!$order->pos['credit_sale'] ? PM_CASH : PM_ANY);
400 // all terms are available for SO
401 $is_order = in_array($order->trans_type, array(ST_SALESQUOTE, ST_SALESORDER));
402 sale_payment_list_cells(_('Payment:'), 'payment', $is_order ? PM_ANY : $paymcat, null, true, $is_order);
404 label_cells(_('Payment:'), $order->payment_terms['terms'], "class='label'");
409 $str = sales_types_list_row(_("Price List:"), 'sales_type', null, true);
411 label_row(_("Price List:"), $order->sales_type_name);
413 if ($order->sales_type != $_POST['sales_type']) {
414 $myrow = get_sales_type($_POST['sales_type']);
415 $order->set_sales_type($myrow['id'], $myrow['sales_type'],
416 $myrow['tax_included'], $myrow['factor']);
417 $Ajax->activate('sales_type');
425 if (!isset($_POST['OrderDate']) || $_POST['OrderDate'] == "")
426 $_POST['OrderDate'] = $order->document_date;
428 date_row($date_text, 'OrderDate', _('Date of order receive'),
429 $order->trans_no==0, 0, 0, 0, null, true);
430 if (isset($_POST['_OrderDate_changed']) || list_updated('payment')) {
431 if (!is_company_currency($order->customer_currency)
432 && (get_base_sales_type()>0)) {
435 $Ajax->activate('_ex_rate');
436 if ($order->trans_type == ST_SALESINVOICE) {
437 $_POST['delivery_date'] = get_invoice_duedate(get_post('payment'), get_post('OrderDate'));
439 $_POST['delivery_date'] = add_days(get_post('OrderDate'), $SysPrefs->default_delivery_required_by());
440 $Ajax->activate('items_table');
441 $Ajax->activate('delivery_date');
443 if ($order->trans_type != ST_SALESORDER && $order->trans_type != ST_SALESQUOTE)
444 { // 2008-11-12 Joe Hunt added dimensions
445 $dim = get_company_pref('use_dimension');
447 dimensions_list_row(_("Dimension").":", 'dimension_id',
448 null, true, ' ', false, 1, false);
450 hidden('dimension_id', 0);
452 dimensions_list_row(_("Dimension")." 2:", 'dimension2_id',
453 null, true, ' ', false, 2, false);
455 hidden('dimension2_id', 0);
460 label_row($date_text, $order->document_date);
461 hidden('OrderDate', $order->document_date);
464 end_outer_table(1); // outer table
466 if (list_updated('ship_via')) {
467 $_SESSION['Items']->ship_via = get_post('ship_via');
468 $_POST['freight_cost'] = price_format(get_price(get_post('ship_via'), $_SESSION['Items']->customer_currency, get_post('sales_type')));
469 $Ajax->activate('items_table');
473 if ($change_prices != 0) {
474 foreach ($order->line_items as $line_no=>$item) {
475 $line = &$order->line_items[$line_no];
476 $line->price = get_kit_price($line->stock_id, $order->customer_currency,
477 $order->sales_type, $order->price_factor, get_post('OrderDate'));
480 if ($change_prices != 0 || list_updated('ship_via')) {
481 $_POST['freight_cost'] = price_format(get_price(get_post('ship_via'), $_SESSION['Items']->customer_currency, get_post('sales_type')));
482 $Ajax->activate('items_table');
485 return $customer_error;
488 //--------------------------------------------------------------------------------
490 function sales_order_item_controls(&$order, &$rowcounter, $line_no=-1)
494 alt_table_row_color($rowcounter);
496 $id = find_submit('Edit');
497 if ($line_no!=-1 && $line_no == $id) // edit old line
499 $_POST['stock_id'] = $order->line_items[$id]->stock_id;
500 $dec = get_qty_dec($_POST['stock_id']);
501 $_POST['qty'] = number_format2($order->line_items[$id]->qty_dispatched, $dec);
502 $_POST['price'] = price_format($order->line_items[$id]->price);
503 $_POST['Disc'] = percent_format($order->line_items[$id]->discount_percent*100);
504 $units = $order->line_items[$id]->units;
505 $_POST['item_description'] = $order->line_items[$id]->item_description;
506 hidden('stock_id', $_POST['stock_id']);
507 label_cell($_POST['stock_id']);
508 if ($order->line_items[$id]->descr_editable)
509 text_cells(null,'item_description', null, 45, 50);
511 hidden('item_description', $_POST['item_description']);
512 label_cell($_POST['item_description']);
514 $Ajax->activate('items_table');
516 else // prepare new line
518 if ($order->fixed_asset)
519 stock_disposable_fa_list_cells(null,'stock_id', null, _('[Select item]'), true, $order->line_items);
521 if (!isset($_POST['stock_id'])) { // Check if stock_id dosesn't exist
522 $_POST['stock_id'] = last_sales_order_detail($order, 'stk_code'); //get the llast sales stock id.
524 sales_items_list_cells(null,'stock_id', $_POST['stock_id'], false, true, true);
526 if (list_updated('stock_id')) {
527 $Ajax->activate('price');
528 $Ajax->activate('units');
529 $Ajax->activate('qty');
530 $Ajax->activate('line_total');
533 $item_info = get_item_edit_info($_POST['stock_id']);
534 $units = $item_info["units"];
535 $dec = $item_info['decimals'];
536 $_POST['qty'] = number_format2(1, $dec);
537 $price = get_kit_price($_POST['stock_id'],
538 $order->customer_currency, $order->sales_type,
539 $order->price_factor, get_post('OrderDate'));
540 $_POST['price'] = price_format($price);
541 // default to the customer's discount %
542 $_POST['Disc'] = percent_format($order->default_discount * 100);
545 if ($order->fixed_asset) {
546 label_cell(1, '', 'qty');
549 qty_cells(null, 'qty', $_POST['qty'], null, null, $dec);
551 if ($order->trans_no!=0) {
552 qty_cell($line_no==-1 ? 0 :$order->line_items[$line_no]->qty_done, false, $dec);
555 label_cell($units, '', 'units');
557 amount_cells(null, 'price');
559 small_amount_cells(null, 'Disc', percent_format($_POST['Disc']), null, null, user_percent_dec());
561 $line_total = input_num('qty') * input_num('price') * (1 - input_num('Disc') / 100);
563 amount_cell($line_total, false, '','line_total');
567 button_cell('UpdateItem', _("Update"),
568 _('Confirm changes'), ICON_UPDATE);
569 button_cell('CancelItemChanges', _("Cancel"),
570 _('Cancel changes'), ICON_CANCEL);
571 hidden('LineNo', $line_no);
576 submit_cells('AddItem', _("Add Item"), "colspan=2 align='center'",
577 _('Add new item to document'), true);
583 //--------------------------------------------------------------------------------
585 function display_delivery_details(&$order)
589 div_start('delivery');
592 if ($order->payment_terms['type'] == PTT_CASH) { // Direct payment sale
593 $Ajax->activate('items_table');
594 display_heading(_('Cash payment'));
595 start_table(TABLESTYLE2, "width='60%'");
597 locations_list_row(_("Deliver from Location:"), 'Location', null, false, true);
598 if (list_updated('Location'))
599 $Ajax->activate('items_table');
600 label_row(_("Cash account:"), $order->pos['bank_account_name']);
601 textarea_row(_("Comments:"), "Comments", $order->Comments, 31, 5);
603 hidden('delivery_date', $order->due_date);
605 if ($order->trans_type==ST_SALESINVOICE)
607 $title = _("Delivery Details");
608 $delname = _("Due Date").':';
610 elseif ($order->trans_type==ST_CUSTDELIVERY)
612 $title = _("Invoice Delivery Details");
613 $delname = _("Invoice before").':';
615 elseif ($order->trans_type==ST_SALESQUOTE)
617 $title = _("Quotation Delivery Details");
618 $delname = _("Valid until").':';
622 $title = _("Order Delivery Details");
623 $delname = _("Required Delivery Date").':';
625 display_heading($title);
626 start_outer_table(TABLESTYLE2, "width='90%'");
629 locations_list_row(_("Deliver from Location:"), 'Location', null, false, true, $order->fixed_asset);
630 if ($order->payment_terms['type'] == PTT_PREPAY)
632 $Ajax->addUpdate('items_table', 'prep_amount', price_format($order->get_trans_total())); // bind to items_table update
633 if (!$order->is_started())
634 amount_row(_("Pre-Payment Required:"), 'prep_amount');
636 label_row(_("Pre-Payment Required:"), price_format($order->prep_amount), "class='label'");
638 if (list_updated('Location'))
639 $Ajax->activate('items_table');
642 date_row($delname, 'delivery_date',
643 $order->trans_type==ST_SALESORDER ? _('Enter requested day of delivery')
644 : $order->trans_type==ST_SALESQUOTE ? _('Enter Valid until Date') : '');
645 text_row(_("Deliver To:"), 'deliver_to', $order->deliver_to, 50, 60,
646 _('Additional identifier for delivery e.g. name of receiving person'));
648 textarea_row(_("Address:"), 'delivery_address', $order->delivery_address, 35, 5,
649 _('Delivery address. Default is address of customer branch'));
653 text_row(_("Contact Phone Number:"), 'phone', $order->phone, 25, 25,
654 _('Phone number of ordering person. Defaults to branch phone number'));
655 text_row(_("Customer Reference:"), 'cust_ref', $order->cust_ref, 25, 25,
656 _('Customer reference number for this order (if any)'));
657 textarea_row(_("Comments:"), "Comments", $order->Comments, 31, 5);