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