Transaction references extended with parametrized patterns, added check_reference...
[fa-stable.git] / inventory / transfers.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_LOCATIONTRANSFER';
13 $path_to_root = "..";
14 include_once($path_to_root . "/includes/ui/items_cart.inc");
15
16 include_once($path_to_root . "/includes/session.inc");
17
18 include_once($path_to_root . "/includes/date_functions.inc");
19 include_once($path_to_root . "/includes/data_checks.inc");
20
21 include_once($path_to_root . "/inventory/includes/stock_transfers_ui.inc");
22 include_once($path_to_root . "/inventory/includes/inventory_db.inc");
23 $js = "";
24 if ($SysPrefs->use_popup_windows)
25         $js .= get_js_open_window(800, 500);
26 if (user_use_date_picker())
27         $js .= get_js_date_picker();
28 page(_($help_context = "Inventory Location Transfers"), false, false, "", $js);
29
30 //-----------------------------------------------------------------------------------------------
31
32 check_db_has_costable_items(_("There are no inventory items defined in the system (Purchased or manufactured items)."));
33
34 //-----------------------------------------------------------------------------------------------
35
36 if (isset($_GET['AddedID'])) 
37 {
38         $trans_no = $_GET['AddedID'];
39         $trans_type = ST_LOCTRANSFER;
40
41         display_notification_centered(_("Inventory transfer has been processed"));
42         display_note(get_trans_view_str($trans_type, $trans_no, _("&View this transfer")));
43
44         hyperlink_no_params($_SERVER['PHP_SELF'], _("Enter &Another Inventory Transfer"));
45
46         display_footer_exit();
47 }
48 //--------------------------------------------------------------------------------------------------
49
50 function line_start_focus() {
51   global        $Ajax;
52
53   $Ajax->activate('items_table');
54   set_focus('_stock_id_edit');
55 }
56 //-----------------------------------------------------------------------------------------------
57
58 function handle_new_order()
59 {
60         if (isset($_SESSION['transfer_items']))
61         {
62                 $_SESSION['transfer_items']->clear_items();
63                 unset ($_SESSION['transfer_items']);
64         }
65
66         $_SESSION['transfer_items'] = new items_cart(ST_LOCTRANSFER);
67         $_POST['AdjDate'] = new_doc_date();
68         if (!is_date_in_fiscalyear($_POST['AdjDate']))
69                 $_POST['AdjDate'] = end_fiscalyear();
70         $_SESSION['transfer_items']->tran_date = $_POST['AdjDate'];     
71 }
72
73 //-----------------------------------------------------------------------------------------------
74
75 if (isset($_POST['Process']))
76 {
77
78         $tr = &$_SESSION['transfer_items'];
79         $input_error = 0;
80
81         if (count($tr->line_items) == 0)        {
82                 display_error(_("You must enter at least one non empty item line."));
83                 set_focus('stock_id');
84                 $input_error = 1;
85         }
86         if (!check_reference($_POST['ref'], ST_LOCTRANSFER))
87         {
88                 set_focus('ref');
89                 $input_error = 1;
90         } 
91         elseif (!is_date($_POST['AdjDate'])) 
92         {
93                 display_error(_("The entered transfer date is invalid."));
94                 set_focus('AdjDate');
95                 $input_error = 1;
96         } 
97         elseif (!is_date_in_fiscalyear($_POST['AdjDate'])) 
98         {
99                 display_error(_("The entered date is out of fiscal year or is closed for further data entry."));
100                 set_focus('AdjDate');
101                 $input_error = 1;
102         } 
103         elseif ($_POST['FromStockLocation'] == $_POST['ToStockLocation'])
104         {
105                 display_error(_("The locations to transfer from and to must be different."));
106                 set_focus('FromStockLocation');
107                 $input_error = 1;
108         }
109         elseif (!$SysPrefs->allow_negative_stock())
110         {
111                 $low_stock = $tr->check_qoh($_POST['FromStockLocation'], $_POST['AdjDate'], true);
112
113                 if ($low_stock)
114                 {
115                 display_error(_("The transfer cannot be processed because it would cause negative inventory balance in source location for marked items as of document date or later."));
116                         $input_error = 1;
117                 }
118         }
119
120         if ($input_error == 1)
121                 unset($_POST['Process']);
122 }
123
124 //-------------------------------------------------------------------------------
125
126 if (isset($_POST['Process']))
127 {
128
129         $trans_no = add_stock_transfer($_SESSION['transfer_items']->line_items,
130                 $_POST['FromStockLocation'], $_POST['ToStockLocation'],
131                 $_POST['AdjDate'], $_POST['ref'], $_POST['memo_']);
132         new_doc_date($_POST['AdjDate']);
133         $_SESSION['transfer_items']->clear_items();
134         unset($_SESSION['transfer_items']);
135
136         meta_forward($_SERVER['PHP_SELF'], "AddedID=$trans_no");
137 } /*end of process credit note */
138
139 //-----------------------------------------------------------------------------------------------
140
141 function check_item_data()
142 {
143         if (!check_num('qty', 0) || input_num('qty') == 0)
144         {
145                 display_error(_("The quantity entered must be a positive number."));
146                 set_focus('qty');
147                 return false;
148         }
149         return true;
150 }
151
152 //-----------------------------------------------------------------------------------------------
153
154 function handle_update_item()
155 {
156         $id = $_POST['LineNo'];
157         if (!isset($_POST['std_cost']))
158                 $_POST['std_cost'] = $_SESSION['transfer_items']->line_items[$id]->standard_cost;
159         $_SESSION['transfer_items']->update_cart_item($id, input_num('qty'), $_POST['std_cost']);
160         line_start_focus();
161 }
162
163 //-----------------------------------------------------------------------------------------------
164
165 function handle_delete_item($id)
166 {
167         $_SESSION['transfer_items']->remove_from_cart($id);
168         line_start_focus();
169 }
170
171 //-----------------------------------------------------------------------------------------------
172
173 function handle_new_item()
174 {
175         if (!isset($_POST['std_cost']))
176                 $_POST['std_cost'] = 0;
177         add_to_order($_SESSION['transfer_items'], $_POST['stock_id'], input_num('qty'), $_POST['std_cost']);
178         line_start_focus();
179 }
180
181 //-----------------------------------------------------------------------------------------------
182 $id = find_submit('Delete');
183 if ($id != -1)
184         handle_delete_item($id);
185         
186 if (isset($_POST['AddItem']) && check_item_data())
187         handle_new_item();
188
189 if (isset($_POST['UpdateItem']) && check_item_data())
190         handle_update_item();
191
192 if (isset($_POST['CancelItemChanges'])) {
193         line_start_focus();
194 }
195 //-----------------------------------------------------------------------------------------------
196
197 if (isset($_GET['NewTransfer']) || !isset($_SESSION['transfer_items']))
198 {
199         handle_new_order();
200 }
201
202 //-----------------------------------------------------------------------------------------------
203 start_form();
204
205 display_order_header($_SESSION['transfer_items']);
206
207 start_table(TABLESTYLE, "width='70%'", 10);
208 start_row();
209 echo "<td>";
210 display_transfer_items(_("Items"), $_SESSION['transfer_items']);
211 transfer_options_controls();
212 echo "</td>";
213 end_row();
214 end_table(1);
215
216 submit_center_first('Update', _("Update"), '', null);
217 submit_center_last('Process', _("Process Transfer"), '',  'default');
218
219 end_form();
220 end_page();
221