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