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 ***********************************************************************/
13 Write/update customer payment.
15 function write_customer_payment($trans_no, $customer_id, $branch_id, $bank_account,
16 $date_, $ref, $amount, $discount, $memo_, $rate=0, $charge=0)
22 $company_record = get_company_prefs();
24 $payment_no = write_customer_trans(ST_CUSTPAYMENT, $trans_no, $customer_id, $branch_id,
25 $date_, $ref, $amount, $discount, 0, 0, 0, 0, 0, 0, "", 0, $rate);
27 $bank_gl_account = get_bank_gl_account($bank_account);
30 delete_comments(ST_CUSTPAYMENT, $trans_no);
31 void_bank_trans(ST_CUSTPAYMENT, $trans_no, true);
32 void_gl_trans(ST_CUSTPAYMENT, $trans_no, true);
33 void_cust_allocations(ST_CUSTPAYMENT, $trans_no, $date_);
36 /* Bank account entry first */
37 $total += add_gl_trans_customer(ST_CUSTPAYMENT, $payment_no, $date_,
38 $bank_gl_account, 0, 0, $amount - $charge, $customer_id,
39 "Cannot insert a GL transaction for the bank account debit", $rate);
41 if ($branch_id != ANY_NUMERIC) {
43 $branch_data = get_branch_accounts($branch_id);
45 $debtors_account = $branch_data["receivables_account"];
46 $discount_account = $branch_data["payment_discount_account"];
49 $debtors_account = $company_record["debtors_act"];
50 $discount_account = $company_record["default_prompt_payment_act"];
53 if (($discount + $amount) != 0) {
54 /* Now Credit Debtors account with receipts + discounts */
55 $total += add_gl_trans_customer(ST_CUSTPAYMENT, $payment_no, $date_,
56 $debtors_account, 0, 0, -($discount + $amount), $customer_id,
57 "Cannot insert a GL transaction for the debtors account credit", $rate);
60 /* Now Debit discount account with discounts allowed*/
61 $total += add_gl_trans_customer(ST_CUSTPAYMENT, $payment_no, $date_,
62 $discount_account, 0, 0, $discount, $customer_id,
63 "Cannot insert a GL transaction for the payment discount debit", $rate);
67 /* Now Debit bank charge account with charges */
68 $charge_act = get_company_pref('bank_charge_act');
69 $total += add_gl_trans_customer(ST_CUSTPAYMENT, $payment_no, $date_,
70 $charge_act, 0, 0, $charge, $customer_id,
71 "Cannot insert a GL transaction for the payment bank charge debit", $rate);
73 /*Post a balance post if $total != 0 */
74 add_gl_balance(ST_CUSTPAYMENT, $payment_no, $date_, -$total, PT_CUSTOMER, $customer_id);
76 /*now enter the bank_trans entry */
77 add_bank_trans(ST_CUSTPAYMENT, $payment_no, $bank_account, $ref,
78 $date_, $amount - $charge, PT_CUSTOMER, $customer_id,
79 get_customer_currency($customer_id), "", $rate);
81 add_comments(ST_CUSTPAYMENT, $payment_no, $date_, $memo_);
83 $Refs->save(ST_CUSTPAYMENT, $payment_no, $ref);
90 //-------------------------------------------------------------------------------------------------
92 function void_customer_payment($type, $type_no)
96 void_bank_trans($type, $type_no, true);
97 void_gl_trans($type, $type_no, true);
98 void_cust_allocations($type, $type_no);
99 void_customer_trans($type, $type_no);
101 commit_transaction();