. ***********************************************************************/ /* Class for supplier/customer payment/credit allocations edition and related helpers. */ //----------------------------------------------------------------------------------- class allocation { var $trans_no; var $type; var $person_id = ''; var $person_name = ''; var $person_type; // PT_SUPPLIER/PT_CUSTOMER var $person_curr; var $date_; var $amount = 0; /*Total amount of the transaction in FX */ var $currency; var $allocs; /*array of transactions allocated to */ function __construct($type, $trans_no, $person_id = null, $person_type_id=null) { $this->allocs = array(); $this->trans_no = $trans_no; $this->type = $type; if ($person_id) $this->set_person($person_id, $person_type_id); $this->read($type, $trans_no, $person_id, $person_type_id); // read payment or credit } function set_person($person_id, $person_type) { $this->person_id = $person_id; $this->person_type = $person_type; $this->person_curr = $person_type == PT_SUPPLIER ? get_supplier_currency($person_id) : get_customer_currency($person_id); return $this->person_curr; } function add_item($type, $type_no, $date_, $due_date, $amount, $amount_allocated, $current_allocated, $ref, $early_discount=0, $early_days=0, $discount=0) { if (floatcmp($amount, 0)) { $this->allocs[count($this->allocs)] = new allocation_item($type, $type_no, $date_, $due_date, $amount, $amount_allocated, $current_allocated, $ref, $early_discount, $early_days, $discount); return $this->allocs[count($this->allocs)-1]; } else { return false; } } function update_item($index, $type, $type_no, $date_, $due_date, $amount, $amount_allocated, $current_allocated, $ref, $early_discount=0, $early_days=0, $discount=0) { if (floatcmp($amount, 0)) { $this->allocs[$index] = new allocation_item($type, $type_no, $date_, $due_date, $amount, $amount_allocated, $current_allocated, $ref, $early_discount, $early_days, $discount); return $this->allocs[$index]; } else { return false; } } function add_or_update_item($type, $type_no, $date_, $due_date, $amount, $amount_allocated, $current_allocated, $ref, $early_discount=0, $early_days=0, $discount=0) { for ($i = 0; $i < count($this->allocs); $i++) { $item = $this->allocs[$i]; if (($item->type == $type) && ($item->type_no == $type_no)) { return $this->update_item($i, $type, $type_no, $date_, $due_date, $amount, $amount_allocated, $current_allocated, $ref, $early_discount, $early_days, $discount); } } return $this->add_item($type, $type_no, $date_, $due_date, $amount, $amount_allocated, $current_allocated, $ref, $early_discount, $early_days, $discount); } // // Read payment or credit current/available allocations to cart. // // FIXME - read all transactions below twice seems to be suboptimal // function read($type = null, $trans_no = 0, $person_id=null, $person_type_id=null) { if ($type !== null) { // otherwise re-read $type = $this->type; $trans_no = $this->trans_no; if (isset($person_type_id)) { $this->person_type = $person_type_id; $this->person_id = $person_id; } else { // guess person_type_id if (in_array($type, array(ST_BANKPAYMENT, ST_BANKDEPOSIT))) { $bank_trans = db_fetch(get_bank_trans($type, $trans_no)); $this->person_type = $bank_trans['person_type_id']; } else $this->person_type = in_array($type, array(ST_SUPPCREDIT, ST_SUPPAYMENT)) ? PT_SUPPLIER : PT_CUSTOMER; } if ($trans_no) { $trans = $this->person_type == PT_SUPPLIER ? get_supp_trans($trans_no, $type, $person_id) : get_customer_trans($trans_no, $type, $person_id); $this->person_id = $trans[$this->person_type == PT_SUPPLIER ? 'supplier_id':'debtor_no']; $this->person_name = $trans[$this->person_type == PT_SUPPLIER ? "supplier_name":"DebtorName"]; $this->date_ = sql2date($trans["tran_date"]); $this->person_curr = $trans['curr_code']; $this->currency = isset($trans['bank_curr_code']) ? $trans['bank_curr_code'] : $trans['curr_code']; $this->bank_amount = isset($trans["bank_amount"]) ? $trans["bank_amount"] : $trans["Total"]; // not set for journal entry $this->amount = $trans["Total"]; } } /* Now populate the array of possible (and previous actual) allocations for this customer/supplier. First get the transactions that have outstanding balances ie Total-alloc >0 */ $this->allocs = array(); if ($this->person_id) { if ($this->person_type==PT_SUPPLIER) $trans_items = get_allocatable_to_supp_transactions($this->person_id, $this->trans_no, $this->type); else $trans_items = get_allocatable_to_cust_transactions($this->person_id, $this->trans_no, $this->type); while ($myrow = db_fetch($trans_items)) { $this->add_or_update_item ($myrow["type"], $myrow["trans_no"], sql2date($myrow["tran_date"]), sql2date($myrow["due_date"]), $myrow["Total"], $myrow["alloc"]-$myrow["amt"], $myrow["amt"], $myrow["reference"], $myrow["early_discount"], $myrow["early_days"], $myrow["discount"]); } } } // // Update allocations in database. // function write() { global $no_exchange_variations; begin_transaction(); if ($this->person_type == PT_SUPPLIER) clear_supp_alloctions($this->type, $this->trans_no, $this->person_id, $this->date_); else clear_cust_alloctions($this->type, $this->trans_no, $this->person_id, $this->date_); // now add the new allocations $total_allocated = 0; $dec = user_price_dec(); foreach ($this->allocs as $alloc_item) { if ($alloc_item->current_allocated > 0) { $amount = round($alloc_item->current_allocated, $dec); if ($this->person_type == PT_SUPPLIER) { add_supp_allocation($amount, $this->type, $this->trans_no, $alloc_item->type, $alloc_item->type_no, $this->person_id, $this->date_, round2($alloc_item->early_discount*abs($alloc_item->amount), user_price_dec())); update_supp_trans_allocation($alloc_item->type, $alloc_item->type_no, $this->person_id); } else { add_cust_allocation($amount, $this->type, $this->trans_no, $alloc_item->type, $alloc_item->type_no, $this->person_id, $this->date_, round2($alloc_item->early_discount*abs($alloc_item->amount), user_price_dec())); update_debtor_trans_allocation($alloc_item->type, $alloc_item->type_no, $this->person_id); } // Exchange Variations Joe Hunt 2008-09-20 //////////////////// if ($alloc_item->type != ST_SALESORDER && !@$no_exchange_variations && $alloc_item->type != ST_PURCHORDER && $alloc_item->type != ST_JOURNAL && $this->type != ST_JOURNAL) exchange_variation($this->type, $this->trans_no, $alloc_item->type, $alloc_item->type_no, $this->date_, $amount, $this->person_type); ////////////////////////////////////////////////////////////// $total_allocated += $alloc_item->current_allocated; } } /*end of the loop through the array of allocations made */ if ($this->person_type == PT_SUPPLIER) update_supp_trans_allocation($this->type, $this->trans_no, $this->person_id); else update_debtor_trans_allocation($this->type, $this->trans_no, $this->person_id); commit_transaction(); } } //----------------------------------------------------------------------------------- class allocation_item { var $type; var $type_no; var $date_; var $due_date; var $amount_allocated; var $amount; var $ref; var $current_allocated; var $early_discount; // nominal early payment discount according to payment terms var $early_days; // days for early payment var $discount_confirmed = false; function __construct($type, $type_no, $date_, $due_date, $amount, $amount_allocated, $current_allocated, $ref, $early_discount=0, $early_days=0) { $this->type = $type; $this->type_no = $type_no; $this->ref = $ref; $this->date_ = $date_; $this->due_date = $due_date; $this->amount = $amount; $this->amount_allocated = $amount_allocated; $this->current_allocated = $current_allocated; $this->early_discount = $early_discount; $this->early_days = $early_days; } function confirm_discount($confirmed) { $this->discount_confirmed = $confirmed; } } //-------------------------------------------------------------------------------- function show_allocatable($reallocation) { global $systypes_array; $k = $total_allocated = $total_discount = 0; $cart = $_SESSION['alloc']; $supp_ref = in_array($cart->type, array(ST_SUPPCREDIT, ST_SUPPAYMENT, ST_BANKPAYMENT)); if (count($cart->allocs)) { display_heading(sprintf(_("Allocated amounts in %s:"), $cart->person_curr)); start_table(TABLESTYLE, "width='60%'"); $th = array(_("Transaction Type"), _("#"), $supp_ref ? _("Supplier Ref"): _("Ref"), _("Date"), _("Due Date"), _("Amount"), _("Other Allocations"), _("Left to Allocate"), _("Early Payment Discount"), _("This Allocation"),'',''); table_header($th); $doc_ids = array(); foreach ($cart->allocs as $id => $alloc_item) { $doc_ids[] = $id; $early_discount = $alloc_item->early_discount != 0 && !date1_greater_date2($cart->date_, add_days($alloc_item->date_, $alloc_item->early_days)); alt_table_row_color($k); label_cell($systypes_array[$alloc_item->type]); label_cell(get_trans_view_str($alloc_item->type, $alloc_item->type_no), "nowrap align='right'"); label_cell($alloc_item->ref); label_cell($alloc_item->date_, "align=right"); label_cell($alloc_item->due_date, "align=right"); amount_cell(abs($alloc_item->amount)); amount_cell($alloc_item->amount_allocated); $_POST['amount' . $id] = price_format($alloc_item->current_allocated); $un_allocated = round((abs($alloc_item->amount) - $alloc_item->amount_allocated), 6); amount_cell($un_allocated-$alloc_item->current_allocated, false,'', 'left'.$id); if ($early_discount) { $discount = round2($alloc_item->early_discount*abs($alloc_item->amount),user_price_dec()); check_cells(null, 'early_disc'.$id, price_format($discount), false, false, 'align=center'); $total_discount += $discount; } else { label_cell(_("N/A"), 'align=center', 'early_disc'.$id); hidden('early_disc'.$id, 0); } amount_cells(null, "amount" . $id); label_cell("" . _("All") . ""); label_cell("" . _("None") . "".hidden("un_allocated".$id, price_format($un_allocated), false)); end_row(); $total_allocated += input_num('amount' . $id); } add_js_source('var docs=['.implode(',', $doc_ids).']'); if ($reallocation) { label_row(_("Total Allocated"), price_format($total_allocated), "colspan=9 align=right", "align=right id='total_allocated'", 3); label_row(_("Total Discount"), price_format($total_discount), "colspan=9 align=right", "align=right id='total_discount'", 3); $amount = abs($cart->amount); if (floatcmp($amount, $total_allocated) < 0) { $font1 = ""; $font2 = ""; } else $font1 = $font2 = ""; $left_to_allocate = price_format($amount - $total_allocated); label_row(_("Left to Allocate"), $font1 . $left_to_allocate . $font2, "colspan=9 align=right", "nowrap align=right id='left_to_allocate'", 3); } end_table(1); } hidden('TotalNumberOfAllocs', count($cart->allocs)); } //-------------------------------------------------------------------------------- function check_allocations() { global $SysPrefs; $total_allocated = $discount=0; for ($counter = 0; $counter < get_post("TotalNumberOfAllocs"); $counter++) { if (!isset($_POST['amount'.$counter])) continue; if (!check_num('amount' . $counter, 0)) { display_error(_("The entry for one or more amounts is invalid or negative.")); set_focus('amount'.$counter); return false; } /* Now check to see that the AllocAmt is no greater than the amount left to be allocated against the transaction under review; skip check if no allocation is set to avoid deadlock on mistakenly overallocated transactions*/ $allocated = input_num('amount' . $counter); if ($allocated && ($allocated > input_num('un_allocated' . $counter))) { display_error(_("At least one transaction is overallocated.")); set_focus('amount'.$counter); return false; } $_SESSION['alloc']->allocs[$counter]->current_allocated = input_num('amount' . $counter); $total_allocated += input_num('amount' . $counter); $_SESSION['alloc']->allocs[$counter]->discount_confirmed = check_value('early_disc'.$counter) != 0; $discount += check_value('early_disc'.$counter) ? round2($_SESSION['alloc']->allocs[$counter]->early_discount*input_num('amount' . $counter), user_price_dec()) : 0; } $amount = abs($_SESSION['alloc']->amount); if ($total_allocated - ($amount + $discount) > $SysPrefs->allocation_settled_allowance()) { display_error(_("These allocations cannot be processed because the amount allocated is more than the total amount left to allocate.")); return false; } return true; } //---------------------------------------------------------------------------------------- // // Returns sales or purchase invoice allocations to be reallocated after invoice edition. // function get_inv_allocations($trans_no, $trans_type, $person_id) { $allocs = array(); if ($trans_type == ST_SUPPINVOICE || $trans_type == ST_SUPPCREDIT) $result = get_allocatable_from_supp_transactions($person_id, $trans_no, $trans_type); else $result = get_allocatable_from_cust_transactions($person_id, $trans_no, $trans_type); while($dat = db_fetch($result)) { $allocs[] = array('type'=> $dat['type'], 'trans_no'=> $dat['trans_no'], 'amount'=>$dat['alloc']); } return $allocs; }