Security statements update against sql injection attacks.
[fa-stable.git] / purchasing / includes / db / invoice_db.inc
1 <?php
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 . "/purchasing/includes/db/invoice_items_db.inc");
13
14 //--------------------------------------------------------------------------------------------------
15
16 function read_supplier_details_to_trans(&$supp_trans, $supplier_id)
17 {
18         $sql = "SELECT ".TB_PREF."suppliers.supp_name, ".TB_PREF."payment_terms.terms, "
19                 .TB_PREF."payment_terms.days_before_due,
20                 ".TB_PREF."payment_terms.day_in_following_month,
21                 ".TB_PREF."suppliers.tax_group_id, ".TB_PREF."tax_groups.name As tax_group_name
22                 From ".TB_PREF."suppliers, ".TB_PREF."payment_terms, ".TB_PREF."tax_groups
23                 WHERE ".TB_PREF."suppliers.tax_group_id = ".TB_PREF."tax_groups.id
24                 AND ".TB_PREF."suppliers.payment_terms=".TB_PREF."payment_terms.terms_indicator
25                 AND ".TB_PREF."suppliers.supplier_id = ".db_escape($supplier_id);
26
27         $result = db_query($sql, "The supplier record selected: " . $supplier_id . " cannot be retrieved");
28
29         $myrow = db_fetch($result);
30
31     $supp_trans->supplier_id = $supplier_id;
32     $supp_trans->supplier_name = $myrow['supp_name'];
33         $supp_trans->terms_description = $myrow['terms'];
34
35         if ($myrow['days_before_due'] == 0)
36         {
37                 $supp_trans->terms = "1" . $myrow['day_in_following_month'];
38         }
39         else
40         {
41                 $supp_trans->terms = "0" . $myrow['days_before_due'];
42         }
43         $supp_trans->tax_description = $myrow['tax_group_name'];
44         $supp_trans->tax_group_id = $myrow['tax_group_id'];
45
46     if ($supp_trans->tran_date == "")
47     {
48                 $supp_trans->tran_date = Today();
49                 if (!is_date_in_fiscalyear($supp_trans->tran_date))
50                         $supp_trans->tran_date = end_fiscalyear();
51         }
52     //if ($supp_trans->due_date=="") {
53     //  get_duedate_from_terms($supp_trans);
54     //}
55     get_duedate_from_terms($supp_trans);
56 }
57
58 //--------------------------------------------------------------------------------------------------
59
60 function update_supp_received_items_for_invoice($id, $po_detail_item, $qty_invoiced, $chg_price=null)
61 {
62         if ($chg_price != null)
63         {
64                 $sql = "SELECT act_price, unit_price FROM ".TB_PREF."purch_order_details WHERE
65                         po_detail_item = ".db_escape($po_detail_item);
66                 $result = db_query($sql, "The old actual price of the purchase order line could not be retrieved");
67                 $row = db_fetch_row($result);
68                 $ret = $row[0];
69
70                 $unit_price = $row[1]; //Added by Rasmus
71
72                 $sql = "SELECT delivery_date FROM ".TB_PREF."grn_batch,".TB_PREF."grn_items WHERE
73                         ".TB_PREF."grn_batch.id = ".TB_PREF."grn_items.grn_batch_id AND "
74                         .TB_PREF."grn_items.id=".db_escape($id);
75                 $result = db_query($sql, "The old delivery date from the received record cout not be retrieved");
76                 $row = db_fetch_row($result);
77                 $date = $row[0];
78         }
79         else
80         {
81                 $ret = 0;
82                 $date = "";
83                 $unit_price = 0; // Added by Rasmus
84         }
85     $sql = "UPDATE ".TB_PREF."purch_order_details
86                 SET qty_invoiced = qty_invoiced + ".db_escape($qty_invoiced);
87
88         if ($chg_price != null)
89                 $sql .= " , act_price = ".db_escape($chg_price);
90
91         $sql .= " WHERE po_detail_item = ".db_escape($po_detail_item);
92     db_query($sql, "The quantity invoiced of the purchase order line could not be updated");
93
94     $sql = "UPDATE ".TB_PREF."grn_items
95         SET quantity_inv = quantity_inv + ".db_escape($qty_invoiced)."
96         WHERE id = ".db_escape($id);
97         db_query($sql, "The quantity invoiced off the items received record could not be updated");
98         return array($ret, $date, $unit_price);
99 }
100
101 function get_deliveries_between($stock_id, $from, $to)
102 {
103         $from = date2sql($from);
104         $to = date2sql($to);
105         $sql = "SELECT SUM(-qty), SUM(-qty*standard_cost) FROM ".TB_PREF."stock_moves
106                 WHERE type=13 AND stock_id=".db_escape($stock_id)." AND
107                         tran_date>='$from' AND tran_date<='$to' GROUP BY stock_id";
108         $result = db_query($sql, "The deliveries could not be updated");
109         return db_fetch_row($result);
110 }
111
112 function get_diff_in_home_currency($supplier, $old_date, $date, $amount1, $amount2)
113 {
114         $currency = get_supplier_currency($supplier);
115         $amount1 = to_home_currency($amount1, $currency, $old_date);
116         $amount2 = to_home_currency($amount2, $currency, $date);
117         return $amount2 - $amount1;
118 }
119 //----------------------------------------------------------------------------------------
120
121 function add_supp_invoice($supp_trans, $invoice_no=0) // do not receive as ref because we change locally
122 {
123         //$company_currency = get_company_currency();
124         /*Start an sql transaction */
125         begin_transaction();
126
127         $tax_total = 0;
128     $taxes = $supp_trans->get_taxes($supp_trans->tax_group_id);
129
130     foreach ($taxes as $taxitem)
131     {
132                 $taxitem['Value'] =  round2($taxitem['Value'], user_price_dec());
133         $tax_total += $taxitem['Value'];
134     }
135
136     $invoice_items_total = $supp_trans->get_total_charged($supp_trans->tax_group_id);
137
138         if ($supp_trans->is_invoice)
139                 $trans_type = 20;
140         else
141         {
142                 $trans_type = 21;
143                 // let's negate everything because it's a credit note
144                 $invoice_items_total = -$invoice_items_total;
145                 $tax_total = -$tax_total;
146                 $supp_trans->ov_discount = -$supp_trans->ov_discount; // this isn't used at all...
147         }
148
149     $date_ = $supp_trans->tran_date;
150         $ex_rate = get_exchange_rate_from_home_currency(get_supplier_currency($supp_trans->supplier_id), $date_);
151
152     /*First insert the invoice into the supp_trans table*/
153         $invoice_id = add_supp_trans($trans_type, $supp_trans->supplier_id, $date_, $supp_trans->due_date,
154                 $supp_trans->reference, $supp_trans->supp_reference,
155                 $invoice_items_total, $tax_total, $supp_trans->ov_discount);
156
157         $total = 0;
158     /* Now the control account */
159     $supplier_accounts = get_supplier_accounts($supp_trans->supplier_id);
160     $total += add_gl_trans_supplier($trans_type, $invoice_id, $date_, $supplier_accounts["payable_account"], 0, 0,
161                 -($invoice_items_total +  $tax_total + $supp_trans->ov_discount),
162                 $supp_trans->supplier_id,
163                 "The general ledger transaction for the control total could not be added");
164
165     /*Loop through the GL Entries and create a debit posting for each of the accounts entered */
166
167     /*the postings here are a little tricky, the logic goes like this:
168     if its a general ledger amount it goes straight to the account specified
169
170     if its a GRN amount invoiced then :
171
172     The cost as originally credited to GRN suspense on arrival of items is debited to GRN suspense. Any difference
173     between the std cost and the currency cost charged as converted at the ex rate of of the invoice is written off
174     to the purchase price variance account applicable to the item being invoiced.
175     */
176     foreach ($supp_trans->gl_codes as $entered_gl_code)
177     {
178
179             /*GL Items are straight forward - just do the debit postings to the GL accounts specified -
180             the credit is to creditors control act  done later for the total invoice value + tax*/
181
182                 if (!$supp_trans->is_invoice)
183                         $entered_gl_code->amount = -$entered_gl_code->amount;
184
185                 $memo_ = $entered_gl_code->memo_;
186                 $total += add_gl_trans_supplier($trans_type, $invoice_id, $date_, $entered_gl_code->gl_code,
187                         $entered_gl_code->gl_dim, $entered_gl_code->gl_dim2, $entered_gl_code->amount, $supp_trans->supplier_id, "", 0, $memo_);
188
189                 add_supp_invoice_gl_item($trans_type, $invoice_id, $entered_gl_code->gl_code,
190                         $entered_gl_code->amount, $memo_);
191
192                 // store tax details if the gl account is a tax account
193                 if (!$supp_trans->is_invoice)
194                         $entered_gl_code->amount = -$entered_gl_code->amount;
195                 add_gl_tax_details($entered_gl_code->gl_code, 
196                         $trans_type, $invoice_id, $entered_gl_code->amount,
197                         $ex_rate, $date_, $supp_trans->supp_reference);
198     }
199     foreach ($supp_trans->grn_items as $entered_grn)
200     {
201
202         if (!$supp_trans->is_invoice)
203         {
204                         $entered_grn->this_quantity_inv = -$entered_grn->this_quantity_inv;
205                         set_grn_item_credited($entered_grn, $supp_trans->supplier_id, $invoice_id, $date_);
206         }
207
208                 $line_taxfree = $entered_grn->taxfree_charge_price($supp_trans->tax_group_id);
209                 $line_tax = $entered_grn->full_charge_price($supp_trans->tax_group_id) - $line_taxfree;
210                 $stock_gl_code = get_stock_gl_code($entered_grn->item_code);
211
212                 $total += add_gl_trans_supplier($trans_type, $invoice_id, $date_, $stock_gl_code["inventory_account"],
213                         $stock_gl_code['dimension_id'], $stock_gl_code['dimension2_id'],
214                         $entered_grn->this_quantity_inv * $line_taxfree, $supp_trans->supplier_id);
215         // -------------- if price changed since po received. 16 Aug 2008 Joe Hunt
216         if($supp_trans->is_invoice)
217         {
218                 $old = update_supp_received_items_for_invoice($entered_grn->id, $entered_grn->po_detail_item,
219                         $entered_grn->this_quantity_inv, $entered_grn->chg_price);
220                         // Since the standard cost is always calculated on basis of the po unit_price,
221                         // this is also the price that should be the base of calculating the price diff.
222                         // In cases where there is two different po invoices on the same delivery with different unit prices this will not work either
223
224                         //$old_price = $old[0];
225                          
226                         $old_price = $old[2];
227
228                         /*
229                         If statement is removed. Should always check for deliveries nomatter if there has been a price change. 
230                         */
231                         //if ($old_price != $entered_grn->chg_price) // price-change, so update
232                         //{
233                         //$diff = $entered_grn->chg_price - $old_price;
234                         $old_date = sql2date($old[1]);
235                         $diff = get_diff_in_home_currency($supp_trans->supplier_id, $old_date, $date_, $old_price, 
236                                 $entered_grn->chg_price);
237                         // always return due to change in currency.
238                         $mat_cost = update_average_material_cost(null, $entered_grn->item_code,
239                                 $diff, $entered_grn->this_quantity_inv, $old_date, true);
240                         // added 2008-12-08 Joe Hunt. Update the purchase data table
241                         add_or_update_purchase_data($supp_trans->supplier_id, $entered_grn->item_code, $entered_grn->chg_price); 
242                         $deliveries = get_deliveries_between($entered_grn->item_code, $old_date, Today()); // extend the period, if invoice is before any deliveries.
243                         if ($deliveries[0] != 0) // have deliveries been done during the period?
244                         {
245                                 $deliveries[1] /= $deliveries[0];
246                                 $amt = ($mat_cost - $deliveries[1]) * $deliveries[0]; // $amt in home currency
247                                 if ($amt != 0.0)
248                                 {
249                                         add_gl_trans($trans_type, $invoice_id, $date_,  $stock_gl_code["cogs_account"],
250                                                 $stock_gl_code['dimension_id'], $stock_gl_code['dimension2_id'], _("Cost diff."),
251                                                 $amt, null, null, null,
252                                                 "The general ledger transaction could not be added for the price variance of the inventory item");
253                                         add_gl_trans($trans_type, $invoice_id, $date_,  $stock_gl_code["inventory_account"],
254                                                 0, 0, _("Cost diff."), -$amt, null, null, null,
255                                                 "The general ledger transaction could not be added for the price variance of the inventory item");
256                                 }               
257                                 update_stock_move_pid(13, $entered_grn->item_code, $old_date, $date_, 0, $mat_cost);
258                         }
259                         update_stock_move_pid(25, $entered_grn->item_code, $old_date, $old_date, $supp_trans->supplier_id, $mat_cost);
260                 //}
261                 }
262         // ----------------------------------------------------------------------
263
264                 add_supp_invoice_item($trans_type, $invoice_id, $entered_grn->item_code,
265                         $entered_grn->item_description, 0,      $line_taxfree, $line_tax,
266                         $entered_grn->this_quantity_inv, $entered_grn->id, $entered_grn->po_detail_item, "");
267     } /* end of GRN postings */
268     /* Now the TAX account */
269     $taxes = $supp_trans->get_taxes($supp_trans->tax_group_id, 0, false); // 2009.08-18 Joe Hunt. We have already got the gl lines
270     foreach ($taxes as $taxitem)
271     {
272         if ($taxitem['Net'] != 0)
273         {
274
275                 if (!$supp_trans->is_invoice)
276                 {
277                         $taxitem['Net'] = -$taxitem['Net'];
278                         $taxitem['Value'] = -$taxitem['Value'];
279                 }       
280                 // here we suppose that tax is never included in price (we are company customer).
281                         add_trans_tax_details($trans_type, $invoice_id, 
282                                 $taxitem['tax_type_id'], $taxitem['rate'], 0, $taxitem['Value'],
283                                 $taxitem['Net'], $ex_rate, $date_, $supp_trans->supp_reference);
284
285                 if (!$supp_trans->is_invoice)
286                         $taxitem['Value'] = -$taxitem['Value'];
287                 $total += add_gl_trans_supplier($trans_type, $invoice_id, $date_,
288                         $taxitem['purchasing_gl_code'], 0, 0, $taxitem['Value'],
289                         $supp_trans->supplier_id,
290                         "A general ledger transaction for the tax amount could not be added");
291         }
292     }
293         
294         /*Post a balance post if $total != 0 */
295         add_gl_balance($trans_type, $invoice_id, $date_, -$total, payment_person_types::supplier(), $supp_trans->supplier_id);  
296
297         add_comments($trans_type, $invoice_id, $date_, $supp_trans->Comments);
298
299         references::save_last($supp_trans->reference, $trans_type);
300
301         if ($invoice_no != 0)
302         {
303                 $invoice_alloc_balance = get_supp_trans_allocation_balance(20, $invoice_no);
304                 if ($invoice_alloc_balance > 0) 
305                 {       //the invoice is not already fully allocated 
306
307                         $trans = get_supp_trans($invoice_no, 20);
308                         $total = $trans['Total'];
309
310                         $allocate_amount = ($invoice_alloc_balance > $total) ? $total : $invoice_alloc_balance;
311                         /*Now insert the allocation record if > 0 */
312                         if ($allocate_amount != 0) 
313                         {
314                                 update_supp_trans_allocation(20, $invoice_no, $allocate_amount);
315                                 update_supp_trans_allocation(21, $invoice_id, $allocate_amount); // ***
316                                 add_supp_allocation($allocate_amount, 21, $invoice_id, 20, $invoice_no,
317                                         $date_);
318                                 // Exchange Variations Joe Hunt 2008-09-20 ////////////////////////////////////////
319
320                                 exchange_variation(21, $invoice_id, 20, $invoice_no, $date_,
321                                         $allocate_amount, payment_person_types::supplier());
322
323                                 ///////////////////////////////////////////////////////////////////////////
324                         }
325                 }
326         }
327         
328
329     commit_transaction();
330
331     return $invoice_id;
332 }
333
334 //----------------------------------------------------------------------------------------
335
336 // get all the invoices/credits for a given PO - quite long route to get there !
337
338 function get_po_invoices_credits($po_number)
339 {
340         $sql = "SELECT DISTINCT ".TB_PREF."supp_trans.trans_no, ".TB_PREF."supp_trans.type,
341                 ov_amount+ov_discount+ov_gst AS Total,
342                 ".TB_PREF."supp_trans.tran_date
343                 FROM ".TB_PREF."supp_trans, ".TB_PREF."supp_invoice_items, "
344                 .TB_PREF."purch_order_details, ".TB_PREF."purch_orders
345                 WHERE ".TB_PREF."supp_invoice_items.supp_trans_no = ".TB_PREF."supp_trans.trans_no
346                 AND ".TB_PREF."supp_invoice_items.po_detail_item_id = ".TB_PREF."purch_order_details.po_detail_item
347                 AND ".TB_PREF."purch_orders.supplier_id = ".TB_PREF."supp_trans.supplier_id
348                 AND ".TB_PREF."purch_order_details.order_no = ".db_escape($po_number);
349
350         return db_query($sql, "The invoices/credits for the po $po_number could not be retreived");
351 }
352
353 //----------------------------------------------------------------------------------------
354
355 function read_supp_invoice($trans_no, $trans_type, &$supp_trans)
356 {
357         $sql = "SELECT ".TB_PREF."supp_trans.*, supp_name FROM ".TB_PREF."supp_trans,".TB_PREF."suppliers
358                 WHERE trans_no = ".db_escape($trans_no)." AND type = ".db_escape($trans_type)."
359                 AND ".TB_PREF."suppliers.supplier_id=".TB_PREF."supp_trans.supplier_id";
360         $result = db_query($sql, "Cannot retreive a supplier transaction");
361
362         if (db_num_rows($result) == 1)
363         {
364                 $trans_row = db_fetch($result);
365
366                 $supp_trans->supplier_id = $trans_row["supplier_id"];
367                 $supp_trans->supplier_name = $trans_row["supp_name"];
368                 $supp_trans->tran_date = sql2date($trans_row["tran_date"]);
369                 $supp_trans->due_date = sql2date($trans_row["due_date"]);
370                 //$supp_trans->Comments = $trans_row["TransText"];
371                 $supp_trans->Comments = "";
372                 $supp_trans->reference = $trans_row["reference"];
373                 $supp_trans->supp_reference = $trans_row["supp_reference"];
374                 $supp_trans->ov_amount = $trans_row["ov_amount"];
375                 $supp_trans->ov_discount = $trans_row["ov_discount"];
376                 $supp_trans->ov_gst = $trans_row["ov_gst"];
377
378                 $id = $trans_row["trans_no"];
379
380                 $result = get_supp_invoice_items($trans_type, $id);
381
382                 if (db_num_rows($result) > 0)
383                 {
384
385             while ($details_row = db_fetch($result))
386             {
387
388                 if ($details_row["gl_code"] == 0)
389                 {
390                         $supp_trans->add_grn_to_trans($details_row["grn_item_id"], $details_row["po_detail_item_id"], $details_row["stock_id"],
391                                         $details_row["description"], 0, 0, $details_row["quantity"], 0, $details_row["FullUnitPrice"],
392                                         false, 0, 0);
393                 }
394                 else
395                 {
396                         $supp_trans->add_gl_codes_to_trans($details_row["gl_code"], get_gl_account_name($details_row["gl_code"]), 0, 0,
397                                         $details_row["FullUnitPrice"], $details_row["memo_"]);
398                 }
399             }
400         }
401         else
402         {
403                         return display_db_error("Invalid supptrans details for supptrans number : $trans_no and type : $trans_type", $sql, true);
404                 }
405
406         }
407         else
408         {
409                 return display_db_error("Invalid supptrans number : $trans_no and type : $trans_type", $sql, true);
410         }
411 }
412
413 //----------------------------------------------------------------------------------------
414
415 function get_matching_invoice_item($stock_id, $po_item_id)
416 {
417         $sql = "SELECT *, tran_date FROM ".TB_PREF."supp_invoice_items, ".TB_PREF."supp_trans
418                 WHERE supp_trans_type = 20 AND stock_id = "
419                 .db_escape($stock_id)." AND po_detail_item_id = ".db_escape($po_item_id)."
420                 AND supp_trans_no = trans_no";
421         $result = db_query($sql, "Cannot retreive supplier transaction detail records");
422         return db_fetch($result);  
423 }
424
425 function void_supp_invoice($type, $type_no)
426 {
427         begin_transaction();
428
429         $trans = get_supp_trans($type_no, $type);
430
431         void_bank_trans($type, $type_no, true);
432
433         void_gl_trans($type, $type_no, true);
434
435         void_supp_allocations($type, $type_no);
436
437         void_supp_trans($type, $type_no);
438
439         $result = get_supp_invoice_items($type, $type_no);
440
441         // now remove this invoice/credit from any GRNs/POs that it's related to
442         if (db_num_rows($result) > 0)
443         {
444                 $date_ = Today();
445         while ($details_row = db_fetch($result))
446         {
447                 if ((int)$details_row["grn_item_id"] > 0) // it can be empty for GL items
448                 {
449                         // Changed 2008-10-17 by Joe Hunt to get the avg. material cost updated
450                                 $old = update_supp_received_items_for_invoice($details_row["grn_item_id"],
451                                         $details_row["po_detail_item_id"], -$details_row["quantity"], $details_row["FullUnitPrice"]); 
452                                 
453                                 //$diff = $details_row["FullUnitPrice"] - $old[2];
454                                 $old_date = sql2date($old[1]);
455                                 
456                                 $batch = get_grn_batch_from_item($details_row["grn_item_id"]);  
457                                 $grn = get_grn_batch($batch);
458                         if ($type == 21) // credit note 2009-06-14 Joe Hunt Must restore the po and grn
459                         {       // We must get the corresponding invoice item to check for price chg.
460                                         $match = get_matching_invoice_item($details_row["stock_id"], $details_row["po_detail_item_id"]);
461                                         if ($match !== false)
462                                                 $mat_cost = update_average_material_cost($grn["supplier_id"], $details_row["stock_id"],  
463                                                         $match["unit_price"], -$details_row["quantity"], sql2date($match['tran_date']), $match['tran_date'] !== $trans['tran_date']);
464                                         else            
465                                                 $mat_cost = update_average_material_cost($grn["supplier_id"], $details_row["stock_id"],  
466                                                         $details_row["FullUnitPrice"], -$details_row["quantity"], $old_date, $old[1] !== $trans['tran_date']);
467                                         $sql = "UPDATE ".TB_PREF."purch_order_details
468                                         SET quantity_ordered = quantity_ordered + ".-$details_row["quantity"].", ";
469                                 if ($match !== false)
470                                         $sql .= "act_price=".$match['unit_price'].", ";
471                                 $sql .= "quantity_received = quantity_received + ".-$details_row["quantity"]."
472                                     WHERE po_detail_item = ".$details_row["po_detail_item_id"];
473                                         db_query($sql, "a purchase order details record could not be updated. This receipt of goods has not been processed ");
474                                         $sql = "UPDATE ".TB_PREF."grn_items SET qty_recd=qty_recd+".-$details_row["quantity"]."
475                                                 WHERE id=".$details_row["grn_item_id"];
476                                         db_query($sql);
477                         }
478                         else
479                         {
480                                         $diff = get_diff_in_home_currency($grn["supplier_id"], $old_date, sql2date($trans['tran_date']), $old[2], 
481                                                 $details_row["FullUnitPrice"]);
482                                         // Only adjust the avg for the diff
483                                         $mat_cost = update_average_material_cost(null, $details_row["stock_id"],
484                                                 $diff, -$details_row["quantity"], $old_date, true);
485                                 }
486                                 $deliveries = get_deliveries_between($details_row["stock_id"], $old_date, $date_);
487                                 if ($deliveries[0] != 0) // have deliveries been done during the period?
488                                 {
489                                         update_stock_move_pid(13, $details_row["stock_id"], $old_date, $date_, 0, $mat_cost);
490                                 }
491                                 update_stock_move_pid(25, $details_row["stock_id"], $old_date, $old_date, $grn['supplier_id'], $mat_cost);
492                 }
493         }
494         }
495
496         if ($type == 21) // void the credits in stock moves
497                 void_stock_move(21, $type_no); 
498         void_supp_invoice_items($type, $type_no);
499         void_trans_tax_details($type, $type_no);
500
501         commit_transaction();
502 }
503
504 //----------------------------------------------------------------------------------------
505
506
507 ?>