purchasing/supplier_credit.php

   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 $page_security = 'SA_SUPPLIERCREDIT';
  13 $path_to_root = "..";
  14
  15 include_once($path_to_root . "/purchasing/includes/supp_trans_class.inc");
  16
  17 include_once($path_to_root . "/includes/session.inc");
  18
  19 include_once($path_to_root . "/includes/data_checks.inc");
  20
  21 include_once($path_to_root . "/purchasing/includes/purchasing_db.inc");
  22 include_once($path_to_root . "/purchasing/includes/purchasing_ui.inc");
  23 $js = "";
  24 if ($use_popup_windows)
  25         $js .= get_js_open_window(900, 500);
  26 if ($use_date_picker)
  27         $js .= get_js_date_picker();
  28 page(_($help_context = "Supplier Credit Note"), false, false, "", $js);
  29
  30 //----------------------------------------------------------------------------------------
  31
  32 check_db_has_suppliers(_("There are no suppliers defined in the system."));
  33
  34 //---------------------------------------------------------------------------------------------------------------
  35
  36 if (isset($_GET['AddedID']))
  37 {
  38         $invoice_no = $_GET['AddedID'];
  39         $trans_type = ST_SUPPCREDIT;
  40
  41
  42     echo "<center>";
  43     display_notification_centered(_("Supplier credit note has been processed."));
  44     display_note(get_trans_view_str($trans_type, $invoice_no, _("View this Credit Note")));
  45
  46         display_note(get_gl_view_str($trans_type, $invoice_no, _("View the GL Journal Entries for this Credit Note")), 1);
  47
  48     hyperlink_params($_SERVER['PHP_SELF'], _("Enter Another Credit Note"), "New=1");
  49         hyperlink_params("$path_to_root/admin/attachments.php", _("Add an Attachment"), "filterType=$trans_type&trans_no=$invoice_no");
  50
  51         display_footer_exit();
  52 }
  53
  54 //---------------------------------------------------------------------------------------------------
  55
  56 if (isset($_GET['New']))
  57 {
  58         if (isset( $_SESSION['supp_trans']))
  59         {
  60                 unset ($_SESSION['supp_trans']->grn_items);
  61                 unset ($_SESSION['supp_trans']->gl_codes);
  62                 unset ($_SESSION['supp_trans']);
  63         }
  64
  65         $_SESSION['supp_trans'] = new supp_trans(ST_SUPPCREDIT);
  66         if (isset($_GET['invoice_no']))
  67         {
  68                 $_SESSION['supp_trans']->supp_reference = $_POST['invoice_no'] = $_GET['invoice_no'];
  69         }
  70 }
  71
  72 function clear_fields()
  73 {
  74         global $Ajax;
  75
  76         unset($_POST['gl_code']);
  77         unset($_POST['dimension_id']);
  78         unset($_POST['dimension2_id']);
  79         unset($_POST['amount']);
  80         unset($_POST['memo_']);
  81         unset($_POST['AddGLCodeToTrans']);
  82         $Ajax->activate('gl_items');
  83         set_focus('gl_code');
  84 }
  85
  86 function reset_tax_input()
  87 {
  88         global $Ajax;
  89
  90         unset($_POST['mantax']);
  91         $Ajax->activate('inv_tot');
  92 }
  93
  94 //------------------------------------------------------------------------------------------------
  95 //      GL postings are often entered in the same form to two accounts
  96 //  so fileds are cleared only on user demand.
  97 //
  98 if (isset($_POST['ClearFields']))
  99 {
 100         clear_fields();
 101 }
 102
 103 if (isset($_POST['AddGLCodeToTrans'])){
 104
 105         $Ajax->activate('gl_items');
 106         $input_error = false;
 107
 108         $result = get_gl_account_info($_POST['gl_code']);
 109         if (db_num_rows($result) == 0)
 110         {
 111                 display_error(_("The account code entered is not a valid code, this line cannot be added to the transaction."));
 112                 set_focus('gl_code');
 113                 $input_error = true;
 114         }
 115         else
 116         {
 117                 $myrow = db_fetch_row($result);
 118                 $gl_act_name = $myrow[1];
 119                 if (!check_num('amount'))
 120                 {
 121                         display_error(_("The amount entered is not numeric. This line cannot be added to the transaction."));
 122                         set_focus('amount');
 123                         $input_error = true;
 124                 }
 125         }
 126
 127         if (!is_tax_gl_unique(get_post('gl_code'))) {
 128                 display_error(_("Cannot post to GL account used by more than one tax type."));
 129                 set_focus('gl_code');
 130                 $input_error = true;
 131         }
 132
 133         if ($input_error == false)
 134         {
 135                 $_SESSION['supp_trans']->add_gl_codes_to_trans($_POST['gl_code'], $gl_act_name,
 136                         $_POST['dimension_id'], $_POST['dimension2_id'],
 137                         input_num('amount'), $_POST['memo_']);
 138                 reset_tax_input();
 139                 set_focus('gl_code');
 140         }
 141 }
 142
 143
 144 //---------------------------------------------------------------------------------------------------
 145
 146 function check_data()
 147 {
 148         global $total_grn_value, $total_gl_value, $Refs, $SysPrefs;
 149
 150         if (!$_SESSION['supp_trans']->is_valid_trans_to_post())
 151         {
 152                 display_error(_("The credit note cannot be processed because the there are no items or values on the invoice.  Credit notes are expected to have a charge."));
 153                 set_focus('');
 154                 return false;
 155         }
 156
 157         if (!$Refs->is_valid($_SESSION['supp_trans']->reference))
 158         {
 159                 display_error(_("You must enter an credit note reference."));
 160                 set_focus('reference');
 161                 return false;
 162         }
 163
 164         if (!is_new_reference($_SESSION['supp_trans']->reference, ST_SUPPCREDIT))
 165         {
 166                 display_error(_("The entered reference is already in use."));
 167                 set_focus('reference');
 168                 return false;
 169         }
 170
 171         if (!$Refs->is_valid($_SESSION['supp_trans']->supp_reference))
 172         {
 173                 display_error(_("You must enter a supplier's credit note reference."));
 174                 set_focus('supp_reference');
 175                 return false;
 176         }
 177
 178         if (!is_date($_SESSION['supp_trans']->tran_date))
 179         {
 180                 display_error(_("The credit note as entered cannot be processed because the date entered is not valid."));
 181                 set_focus('tran_date');
 182                 return false;
 183         }
 184         elseif (!is_date_in_fiscalyear($_SESSION['supp_trans']->tran_date))
 185         {
 186                 display_error(_("The entered date is not in fiscal year."));
 187                 set_focus('tran_date');
 188                 return false;
 189         }
 190         if (!is_date( $_SESSION['supp_trans']->due_date))
 191         {
 192                 display_error(_("The invoice as entered cannot be processed because the due date is in an incorrect format."));
 193                 set_focus('due_date');
 194                 return false;
 195         }
 196
 197         if ($_SESSION['supp_trans']->ov_amount < ($total_gl_value + $total_grn_value))
 198         {
 199                 display_error(_("The credit note total as entered is less than the sum of the the general ledger entires (if any) and the charges for goods received. There must be a mistake somewhere, the credit note as entered will not be processed."));
 200                 return false;
 201         }
 202
 203         if (!$SysPrefs->allow_negative_stock()) {
 204                 foreach ($_SESSION['supp_trans']->grn_items as $n => $item) {
 205                         if (is_inventory_item($item->item_code))
 206                         {
 207                                 if (check_negative_stock($item->item_code, -$item->this_quantity_inv, null, $_SESSION['supp_trans']->tran_date))
 208                                 {
 209                                         $stock = get_item($item->item_code);
 210                                         display_error(_("The return cannot be processed because there is an insufficient quantity for item:") .
 211                                                 " " . $stock['stock_id'] . " - " . $stock['description'] . " - " .
 212                                                 _("Quantity On Hand") . " = " . number_format2(get_qoh_on_date($stock['stock_id'], null,
 213                                                 $_SESSION['supp_trans']->tran_date), get_qty_dec($stock['stock_id'])));
 214                                         return false;
 215                                 }
 216                         }
 217                 }
 218         }
 219         return true;
 220 }
 221
 222 //---------------------------------------------------------------------------------------------------
 223
 224 function handle_commit_credit_note()
 225 {
 226         copy_to_trans($_SESSION['supp_trans']);
 227
 228         if (!check_data())
 229                 return;
 230
 231         if (isset($_POST['invoice_no']))
 232                 $invoice_no = add_supp_invoice($_SESSION['supp_trans'], $_POST['invoice_no']);
 233         else
 234                 $invoice_no = add_supp_invoice($_SESSION['supp_trans']);
 235
 236     $_SESSION['supp_trans']->clear_items();
 237     unset($_SESSION['supp_trans']);
 238
 239         meta_forward($_SERVER['PHP_SELF'], "AddedID=$invoice_no");
 240 }
 241
 242 //--------------------------------------------------------------------------------------------------
 243
 244 if (isset($_POST['PostCreditNote']))
 245 {
 246         handle_commit_credit_note();
 247 }
 248
 249 function check_item_data($n)
 250 {
 251
 252         if (!check_num('This_QuantityCredited'.$n, 0))
 253         {
 254                 display_error(_("The quantity to credit must be numeric and greater than zero."));
 255                 set_focus('This_QuantityCredited'.$n);
 256                 return false;
 257         }
 258
 259         if (!check_num('ChgPrice'.$n, 0))
 260         {
 261                 display_error(_("The price is either not numeric or negative."));
 262                 set_focus('ChgPrice'.$n);
 263                 return false;
 264         }
 265
 266         return true;
 267 }
 268
 269 function commit_item_data($n)
 270 {
 271         if (check_item_data($n))
 272         {
 273                 $_SESSION['supp_trans']->add_grn_to_trans($n,
 274                 $_POST['po_detail_item'.$n], $_POST['item_code'.$n],
 275                 $_POST['item_description'.$n], $_POST['qty_recd'.$n],
 276                 $_POST['prev_quantity_inv'.$n], input_num('This_QuantityCredited'.$n),
 277                 $_POST['order_price'.$n], input_num('ChgPrice'.$n),
 278                 $_POST['std_cost_unit'.$n], "");
 279                 reset_tax_input();
 280         }
 281 }
 282
 283 //-----------------------------------------------------------------------------------------
 284
 285 $id = find_submit('grn_item_id');
 286 if ($id != -1)
 287 {
 288         commit_item_data($id);
 289 }
 290
 291 if (isset($_POST['InvGRNAll']))
 292 {
 293         foreach($_POST as $postkey=>$postval )
 294     {
 295                 if (strpos($postkey, "qty_recd") === 0)
 296                 {
 297                         $id = substr($postkey, strlen("qty_recd"));
 298                         $id = (int)$id;
 299                         commit_item_data($id);
 300                 }
 301     }
 302 }
 303
 304
 305 //--------------------------------------------------------------------------------------------------
 306 $id3 = find_submit('Delete');
 307 if ($id3 != -1)
 308 {
 309         $_SESSION['supp_trans']->remove_grn_from_trans($id3);
 310         $Ajax->activate('grn_items');
 311         reset_tax_input();
 312 }
 313
 314 $id4 = find_submit('Delete2');
 315 if ($id4 != -1)
 316 {
 317         $_SESSION['supp_trans']->remove_gl_codes_from_trans($id4);
 318         clear_fields();
 319         reset_tax_input();
 320         $Ajax->activate('gl_items');
 321 }
 322 if (isset($_POST['RefreshInquiry']))
 323 {
 324         $Ajax->activate('grn_items');
 325         reset_tax_input();
 326 }
 327
 328 if (isset($_POST['go']))
 329 {
 330         $Ajax->activate('gl_items');
 331         display_quick_entries($_SESSION['supp_trans'], $_POST['qid'], input_num('totamount'), QE_SUPPINV);
 332         $_POST['totamount'] = price_format(0); $Ajax->activate('totamount');
 333         reset_tax_input();
 334 }
 335
 336
 337 //--------------------------------------------------------------------------------------------------
 338
 339 start_form();
 340
 341 invoice_header($_SESSION['supp_trans']);
 342 if ($_POST['supplier_id']=='')
 343         display_error('No supplier found for entered search text');
 344 else {
 345         $total_grn_value = display_grn_items($_SESSION['supp_trans'], 1);
 346
 347         $total_gl_value = display_gl_items($_SESSION['supp_trans'], 1);
 348
 349         div_start('inv_tot');
 350         invoice_totals($_SESSION['supp_trans']);
 351         div_end();
 352 }
 353
 354 if ($id != -1)
 355 {
 356         $Ajax->activate('grn_items');
 357         $Ajax->activate('inv_tot');
 358 }
 359
 360 if (get_post('AddGLCodeToTrans'))
 361         $Ajax->activate('inv_tot');
 362
 363 br();
 364 submit_center('PostCreditNote', _("Enter Credit Note"), true, '', 'default');
 365 br();
 366
 367 end_form();
 368 end_page();
 369 ?>