.
***********************************************************************/
/*
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;
}