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_VOIDTRANSACTION';
14 include_once($path_to_root . "/includes/session.inc");
16 include_once($path_to_root . "/includes/date_functions.inc");
17 include_once($path_to_root . "/includes/ui.inc");
18 include_once($path_to_root . "/includes/data_checks.inc");
20 include_once($path_to_root . "/admin/db/voiding_db.inc");
23 $js .= get_js_date_picker();
24 if ($use_popup_windows)
25 $js .= get_js_open_window(800, 500);
27 page(_("Void a Transaction"), false, false, "", $js);
29 //----------------------------------------------------------------------------------------
30 function exist_transaction($type, $type_no)
32 $void_entry = get_voided_entry($type, $type_no);
34 if ($void_entry != null)
39 case ST_JOURNAL : // it's a journal entry
40 if (!exists_gl_trans($type, $type_no))
44 case ST_BANKPAYMENT : // it's a payment
45 case ST_BANKDEPOSIT : // it's a deposit
46 case ST_BANKTRANSFER : // it's a transfer
47 if (!exists_bank_trans($type, $type_no))
51 case ST_SALESINVOICE : // it's a customer invoice
52 case ST_CUSTCREDIT : // it's a customer credit note
53 case ST_CUSTPAYMENT : // it's a customer payment
54 case ST_CUSTDELIVERY : // it's a customer dispatch
55 if (!exists_customer_trans($type, $type_no))
59 case ST_LOCTRANSFER : // it's a stock transfer
60 if (get_stock_transfer_items($type_no) == null)
64 case ST_INVADJUST : // it's a stock adjustment
65 if (get_stock_adjustment_items($type_no) == null)
69 case ST_PURCHORDER : // it's a PO
70 case ST_SUPPRECEIVE : // it's a GRN
72 case ST_SUPPINVOICE : // it's a suppler invoice
73 case ST_SUPPCREDIT : // it's a supplier credit note
74 case ST_SUPPAYMENT : // it's a supplier payment
75 if (!exists_supp_trans($type, $type_no))
79 case ST_WORKORDER : // it's a work order
80 if (!get_work_order($type_no, true))
84 case ST_MANUISSUE : // it's a work order issue
85 if (!exists_work_order_issue($type_no))
89 case ST_MANURECEIVE : // it's a work order production
90 if (!exists_work_order_produce($type_no))
94 case ST_SALESORDER: // it's a sales order
95 case ST_SALESQUOTE: // it's a sales quotation
97 case ST_COSTUPDATE : // it's a stock cost update
105 function voiding_controls()
107 global $table_style2;
111 start_table($table_style2);
113 systypes_list_row(_("Transaction Type:"), "filterType", null, true);
115 text_row(_("Transaction #:"), 'trans_no', null, 12, 12);
117 date_row(_("Voiding Date:"), 'date_');
119 textarea_row(_("Memo:"), 'memo_', null, 30, 4);
123 if (!isset($_POST['ProcessVoiding']))
124 submit_center('ProcessVoiding', _("Void Transaction"), true, '', 'default');
127 if (!exist_transaction($_POST['filterType'],$_POST['trans_no']))
129 display_error(_("The entered transaction does not exist or cannot be voided."));
130 unset($_POST['trans_no']);
131 unset($_POST['memo_']);
132 unset($_POST['date_']);
133 submit_center('ProcessVoiding', _("Void Transaction"), true, '', 'default');
137 display_warning(_("Are you sure you want to void this transaction ? This action cannot be undone."), 0, 1);
138 if ($_POST['filterType'] == ST_JOURNAL) // GL transaction are not included in get_trans_view_str
139 $view_str = get_gl_view_str($_POST['filterType'],$_POST['trans_no'], _("View Transaction"));
141 $view_str = get_trans_view_str($_POST['filterType'],$_POST['trans_no'], _("View Transaction"));
142 display_note($view_str);
144 submit_center_first('ConfirmVoiding', _("Proceed"), '', true);
145 submit_center_last('CancelVoiding', _("Cancel"), '', 'cancel');
152 //----------------------------------------------------------------------------------------
154 function check_valid_entries()
156 if (is_closed_trans($_POST['filterType'],$_POST['trans_no']))
158 display_error(_("The selected transaction was closed for edition and cannot be voided."));
159 set_focus('trans_no');
162 if (!is_date($_POST['date_']))
164 display_error(_("The entered date is invalid."));
168 if (!is_date_in_fiscalyear($_POST['date_']))
170 display_error(_("The entered date is not in fiscal year."));
175 if (!is_numeric($_POST['trans_no']) OR $_POST['trans_no'] <= 0)
177 display_error(_("The transaction number is expected to be numeric and greater than zero."));
178 set_focus('trans_no');
185 //----------------------------------------------------------------------------------------
187 function handle_void_transaction()
189 if (check_valid_entries()==true)
191 $void_entry = get_voided_entry($_POST['filterType'], $_POST['trans_no']);
192 if ($void_entry != null)
194 display_error(_("The selected transaction has already been voided."), true);
195 unset($_POST['trans_no']);
196 unset($_POST['memo_']);
197 unset($_POST['date_']);
198 set_focus('trans_no');
202 $ret = void_transaction($_POST['filterType'], $_POST['trans_no'],
203 $_POST['date_'], $_POST['memo_']);
207 display_notification_centered(_("Selected transaction has been voided."));
208 unset($_POST['trans_no']);
209 unset($_POST['memo_']);
210 unset($_POST['date_']);
213 display_error(_("The entered transaction does not exist or cannot be voided."));
214 set_focus('trans_no');
220 //----------------------------------------------------------------------------------------
222 if (!isset($_POST['date_']))
224 $_POST['date_'] = Today();
225 if (!is_date_in_fiscalyear($_POST['date_']))
226 $_POST['date_'] = end_fiscalyear();
229 if (isset($_POST['ProcessVoiding']))
231 if (!check_valid_entries())
232 unset($_POST['ProcessVoiding']);
233 $Ajax->activate('_page_body');
236 if (isset($_POST['ConfirmVoiding']))
238 handle_void_transaction();
239 $Ajax->activate('_page_body');
242 if (isset($_POST['CancelVoiding']))
244 $Ajax->activate('_page_body');
247 //----------------------------------------------------------------------------------------