Update from usntable branch.
[fa-stable.git] / purchasing / includes / db / supp_trans_db.inc
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 //-------------------------------------------------------------------------------------------------------------
13
14 function add_supp_trans($type, $supplier_id, $date_, $due_date, $reference, $supp_reference,
15         $amount, $amount_tax, $discount, $err_msg="", $rate=0)
16 {
17         $date = date2sql($date_);
18         if ($due_date == "")
19                 $due_date = "0000-00-00";
20         else
21                 $due_date = date2sql($due_date);
22
23         $trans_no = get_next_trans_no($type);
24
25         $curr = get_supplier_currency($supplier_id);
26         
27         if ($rate == 0)
28                 $rate = get_exchange_rate_from_home_currency($curr, $date_);
29
30
31         $sql = "INSERT INTO ".TB_PREF."supp_trans (trans_no, type, supplier_id, tran_date, due_date,
32                 reference, supp_reference, ov_amount, ov_gst, rate, ov_discount) ";
33         $sql .= "VALUES (".db_escape($trans_no).", ".db_escape($type)
34         .", ".db_escape($supplier_id).", '$date', '$due_date',
35                 ".db_escape($reference).", ".db_escape($supp_reference).", ".db_escape($amount)
36                 .", ".db_escape($amount_tax).", ".db_escape($rate).", ".db_escape($discount).")";
37
38         if ($err_msg == "")
39                 $err_msg = "Cannot insert a supplier transaction record";
40
41         db_query($sql, $err_msg);
42         add_audit_trail($type, $trans_no, $date_);
43
44         return $trans_no;
45 }
46
47 //-------------------------------------------------------------------------------------------------------------
48
49 function get_supp_trans($trans_no, $trans_type=-1)
50 {
51         $sql = "SELECT ".TB_PREF."supp_trans.*, (".TB_PREF."supp_trans.ov_amount+".TB_PREF."supp_trans.ov_gst+".TB_PREF."supp_trans.ov_discount) AS Total,
52                 ".TB_PREF."suppliers.supp_name AS supplier_name, ".TB_PREF."suppliers.curr_code AS SupplierCurrCode ";
53
54         if ($trans_type == ST_SUPPAYMENT)
55         {
56                 // it's a payment so also get the bank account
57                 $sql .= ", ".TB_PREF."bank_accounts.bank_name, ".TB_PREF."bank_accounts.bank_account_name, ".TB_PREF."bank_accounts.bank_curr_code,
58                         ".TB_PREF."bank_accounts.account_type AS BankTransType, ".TB_PREF."bank_trans.amount AS BankAmount,
59                         ".TB_PREF."bank_trans.ref ";
60         }
61
62         $sql .= " FROM ".TB_PREF."supp_trans, ".TB_PREF."suppliers ";
63
64         if ($trans_type == ST_SUPPAYMENT)
65         {
66                 // it's a payment so also get the bank account
67                 $sql .= ", ".TB_PREF."bank_trans, ".TB_PREF."bank_accounts";
68         }
69
70         $sql .= " WHERE ".TB_PREF."supp_trans.trans_no=".db_escape($trans_no)."
71                 AND ".TB_PREF."supp_trans.supplier_id=".TB_PREF."suppliers.supplier_id";
72
73         if ($trans_type > 0)
74                 $sql .= " AND ".TB_PREF."supp_trans.type=".db_escape($trans_type);
75
76         if ($trans_type == ST_SUPPAYMENT)
77         {
78                 // it's a payment so also get the bank account
79                 $sql .= " AND ".TB_PREF."bank_trans.trans_no =".db_escape($trans_no)."
80                         AND ".TB_PREF."bank_trans.type=".db_escape($trans_type)."
81                         AND ".TB_PREF."bank_accounts.id=".TB_PREF."bank_trans.bank_act ";
82         }
83
84         $result = db_query($sql, "Cannot retreive a supplier transaction");
85
86     if (db_num_rows($result) == 0)
87     {
88        // can't return nothing
89        display_db_error("no supplier trans found for given params", $sql, true);
90        exit;
91     }
92
93     if (db_num_rows($result) > 1)
94     {
95        // can't return multiple
96        display_db_error("duplicate supplier transactions found for given params", $sql, true);
97        exit;
98     }
99
100     return db_fetch($result);
101 }
102
103 //----------------------------------------------------------------------------------------
104
105 function exists_supp_trans($type, $type_no)
106 {
107         if ($type == 25)
108                 return exists_grn($type_no);
109
110         $sql = "SELECT trans_no FROM ".TB_PREF."supp_trans WHERE type=".db_escape($type)."
111                 AND trans_no=".db_escape($type_no);
112         $result = db_query($sql, "Cannot retreive a supplier transaction");
113
114     return (db_num_rows($result) > 0);
115 }
116
117 //----------------------------------------------------------------------------------------
118
119 function void_supp_trans($type, $type_no)
120 {
121         $sql = "UPDATE ".TB_PREF."supp_trans SET ov_amount=0, ov_discount=0, ov_gst=0,
122                 alloc=0 WHERE type=".db_escape($type)." AND trans_no=".db_escape($type_no);
123
124         db_query($sql, "could not void supp transactions for type=$type and trans_no=$type_no");
125 }
126
127 //----------------------------------------------------------------------------------------
128
129 function post_void_supp_trans($type, $type_no)
130 {
131         if ($type == ST_SUPPAYMENT)
132         {
133                 void_supp_payment($type, $type_no);
134                 return true;
135         }
136
137         if ($type == ST_SUPPINVOICE || $type == ST_SUPPCREDIT)
138         {
139                 void_supp_invoice($type, $type_no);
140                 return true;
141         }
142
143         if ($type == SUPPRECEIVE)
144         {
145                 return void_grn($type_no);
146         }
147
148         return false;
149 }
150
151 //----------------------------------------------------------------------------------------
152
153 ?>