2 /**********************************************************************
3 Copyright (C) FrontAccounting, LLC.
4 Released under the terms of the GNU Affero General Public License,
5 AGPL, as published by the Free Software Foundation, either version
6 3 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/agpl-3.0.html>.
11 ***********************************************************************/
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 0 : // it's a journal entry
40 if (!exists_gl_trans($type, $type_no))
44 case 1 : // it's a payment
45 case 2 : // it's a deposit
46 case 4 : // it's a transfer
47 if (!exists_bank_trans($type, $type_no))
51 case 10 : // it's a customer invoice
52 case 11 : // it's a customer credit note
53 case 12 : // it's a customer payment
54 case 13 : // it's a customer dispatch
55 if (!exists_customer_trans($type, $type_no))
59 case systypes::location_transfer() : // it's a stock transfer
60 if (get_stock_transfer_items($type_no) == null)
64 case systypes::inventory_adjustment() : // it's a stock adjustment
65 if (get_stock_adjustment_items($type_no) == null)
69 case 25 : // it's a GRN
71 case 20 : // it's a suppler invoice
72 case 21 : // it's a supplier credit note
73 case 22 : // it's a supplier payment
74 if (!exists_supp_trans($type, $type_no))
78 case systypes::work_order() : // it's a work order
79 if (!get_work_order($type_no, true))
83 case 28 : // it's a work order issue
84 if (!exists_work_order_issue($type_no))
88 case 29 : // it's a work order production
89 if (!exists_work_order_produce($type_no))
93 case systypes::cost_update() : // it's a stock cost update
101 function voiding_controls()
103 global $table_style2;
105 start_form(false, true);
107 start_table($table_style2);
109 systypes_list_row(_("Transaction Type:"), "filterType", null, true);
111 text_row(_("Transaction #:"), 'trans_no', null, 12, 12);
113 date_row(_("Voiding Date:"), 'date_');
115 textarea_row(_("Memo:"), 'memo_', null, 30, 4);
119 if (!isset($_POST['ProcessVoiding']))
120 submit_center('ProcessVoiding', _("Void Transaction"), true, '', true);
123 if (!exist_transaction($_POST['filterType'],$_POST['trans_no']))
125 display_error(_("The entered transaction does not exist or cannot be voided."));
126 unset($_POST['trans_no']);
127 unset($_POST['memo_']);
128 unset($_POST['date_']);
129 submit_center('ProcessVoiding', _("Void Transaction"), true, '', true);
133 display_notification_centered(_("Are you sure you want to void this transaction ? This action cannot be undone."), 0, 1);
134 if ($_POST['filterType'] == 0) // GL transaction are not included in get_trans_view_str
135 $view_str = get_gl_view_str($_POST['filterType'],$_POST['trans_no'], _("View Transaction"));
137 $view_str = get_trans_view_str($_POST['filterType'],$_POST['trans_no'], _("View Transaction"));
138 display_note($view_str);
140 submit_center_first('ConfirmVoiding', _("Proceed"), '', true);
141 submit_center_last('CancelVoiding', _("Cancel"), '', true);
148 //----------------------------------------------------------------------------------------
150 function check_valid_entries()
152 if (!is_date($_POST['date_']))
154 display_error(_("The entered date is invalid."));
158 if (!is_date_in_fiscalyear($_POST['date_']))
160 display_error(_("The entered date is not in fiscal year."));
165 if (!is_numeric($_POST['trans_no']) OR $_POST['trans_no'] <= 0)
167 display_error(_("The transaction number is expected to be numeric and greater than zero."));
168 set_focus('trans_no');
175 //----------------------------------------------------------------------------------------
177 function handle_void_transaction()
179 if (check_valid_entries()==true)
182 $void_entry = get_voided_entry($_POST['filterType'], $_POST['trans_no']);
183 if ($void_entry != null)
185 display_error(_("The selected transaction has already been voided."), true);
186 unset($_POST['trans_no']);
187 unset($_POST['memo_']);
188 unset($_POST['date_']);
189 set_focus('trans_no');
193 $ret = void_transaction($_POST['filterType'], $_POST['trans_no'],
194 $_POST['date_'], $_POST['memo_']);
198 display_notification_centered(_("Selected transaction has been voided."));
199 unset($_POST['trans_no']);
200 unset($_POST['memo_']);
201 unset($_POST['date_']);
204 display_error(_("The entered transaction does not exist or cannot be voided."));
205 set_focus('trans_no');
211 //----------------------------------------------------------------------------------------
213 if (!isset($_POST['date_']))
215 $_POST['date_'] = Today();
216 if (!is_date_in_fiscalyear($_POST['date_']))
217 $_POST['date_'] = end_fiscalyear();
220 if (isset($_POST['ProcessVoiding']))
222 if (!check_valid_entries())
223 unset($_POST['ProcessVoiding']);
224 $Ajax->activate('_page_body');
227 if (isset($_POST['ConfirmVoiding']))
229 handle_void_transaction();
230 $Ajax->activate('_page_body');
233 if (isset($_POST['CancelVoiding']))
235 $Ajax->activate('_page_body');
238 //----------------------------------------------------------------------------------------