blob: 157cfdd7f747da666e16ce3ea95619d01feee324 [file] [log] [blame]
Anand Doshi885e0742015-03-03 14:55:30 +05301# Copyright (c) 2015, Frappe Technologies Pvt. Ltd. and Contributors
Rushabh Mehtae67d1fb2013-08-05 14:59:54 +05302# License: GNU General Public License v3. See license.txt
Nabin Hait23941aa2013-01-29 11:32:38 +05303
Nabin Hait23941aa2013-01-29 11:32:38 +05304
Saqib90517352021-10-04 11:44:46 +05305from json import loads
Ankush Menat2535d5e2022-06-14 18:20:33 +05306from typing import TYPE_CHECKING, List, Optional, Tuple
Saqib90517352021-10-04 11:44:46 +05307
Chillar Anand915b3432021-09-02 16:44:59 +05308import frappe
Nabin Hait9b20e072017-04-25 12:10:24 +05309import frappe.defaults
ruthra kumar451cf3a2022-05-16 14:29:58 +053010from frappe import _, qb, throw
Nabin Haitb99c77b2020-12-25 18:12:35 +053011from frappe.model.meta import get_field_precision
ruthra kumar8c876742022-06-14 17:46:04 +053012from frappe.query_builder import AliasedQuery, Criterion, Table
ruthra kumar60435da2023-11-03 17:58:19 +053013from frappe.query_builder.functions import Round, Sum
Gavin D'souza0727d1d2022-06-13 12:39:28 +053014from frappe.query_builder.utils import DocType
Ankush Menat5c6f22f2022-06-15 19:30:26 +053015from frappe.utils import (
16 cint,
17 create_batch,
18 cstr,
19 flt,
20 formatdate,
21 get_number_format_info,
22 getdate,
23 now,
24 nowdate,
25)
Gavin D'souza0727d1d2022-06-13 12:39:28 +053026from pypika import Order
27from pypika.terms import ExistsCriterion
Anand Doshicd0989e2015-09-28 13:31:17 +053028
Chillar Anand915b3432021-09-02 16:44:59 +053029import erpnext
30
31# imported to enable erpnext.accounts.utils.get_account_currency
32from erpnext.accounts.doctype.account.account import get_account_currency # noqa
ruthra kumar451cf3a2022-05-16 14:29:58 +053033from erpnext.accounts.doctype.accounting_dimension.accounting_dimension import get_dimensions
Anurag Mishraa11e7382019-10-31 15:55:03 +053034from erpnext.stock import get_warehouse_account_map
Chillar Anand915b3432021-09-02 16:44:59 +053035from erpnext.stock.utils import get_stock_value_on
36
Ankush Menat2535d5e2022-06-14 18:20:33 +053037if TYPE_CHECKING:
38 from erpnext.stock.doctype.repost_item_valuation.repost_item_valuation import RepostItemValuation
39
Anurag Mishraa11e7382019-10-31 15:55:03 +053040
Ankush Menat494bd9e2022-03-28 18:52:46 +053041class FiscalYearError(frappe.ValidationError):
42 pass
43
44
45class PaymentEntryUnlinkError(frappe.ValidationError):
46 pass
47
Nabin Hait2b06aaa2013-08-22 18:25:43 +053048
Ankush Menat2535d5e2022-06-14 18:20:33 +053049GL_REPOSTING_CHUNK = 100
50
51
Neil Trini Lasrado78fa6952014-10-03 17:43:02 +053052@frappe.whitelist()
Ankush Menat494bd9e2022-03-28 18:52:46 +053053def get_fiscal_year(
Deepesh Garg0aadb682023-03-19 12:46:42 +053054 date=None, fiscal_year=None, label="Date", verbose=1, company=None, as_dict=False, boolean=False
Ankush Menat494bd9e2022-03-28 18:52:46 +053055):
ruthra kumarc31ee8e2023-11-14 06:44:49 +053056 if isinstance(boolean, str):
57 boolean = frappe.json.loads(boolean)
58
Deepesh Garg0aadb682023-03-19 12:46:42 +053059 fiscal_years = get_fiscal_years(
60 date, fiscal_year, label, verbose, company, as_dict=as_dict, boolean=boolean
61 )
62 if boolean:
63 return fiscal_years
64 else:
65 return fiscal_years[0]
Nabin Hait23941aa2013-01-29 11:32:38 +053066
Ankush Menat494bd9e2022-03-28 18:52:46 +053067
68def get_fiscal_years(
Deepesh Garg0aadb682023-03-19 12:46:42 +053069 transaction_date=None,
70 fiscal_year=None,
71 label="Date",
72 verbose=1,
73 company=None,
74 as_dict=False,
75 boolean=False,
Ankush Menat494bd9e2022-03-28 18:52:46 +053076):
Nabin Hait9784d272016-12-30 16:21:35 +053077 fiscal_years = frappe.cache().hget("fiscal_years", company) or []
Rushabh Mehtad50da782017-07-28 11:39:01 +053078
79 if not fiscal_years:
Nabin Hait9784d272016-12-30 16:21:35 +053080 # if year start date is 2012-04-01, year end date should be 2013-03-31 (hence subdate)
Gavin D'souza0727d1d2022-06-13 12:39:28 +053081 FY = DocType("Fiscal Year")
Nabin Haitfff3ab72015-01-14 16:27:13 +053082
Gavin D'souza0727d1d2022-06-13 12:39:28 +053083 query = (
84 frappe.qb.from_(FY)
85 .select(FY.name, FY.year_start_date, FY.year_end_date)
86 .where(FY.disabled == 0)
Ankush Menat494bd9e2022-03-28 18:52:46 +053087 )
Rushabh Mehtad50da782017-07-28 11:39:01 +053088
Gavin D'souza0727d1d2022-06-13 12:39:28 +053089 if fiscal_year:
90 query = query.where(FY.name == fiscal_year)
91
92 if company:
93 FYC = DocType("Fiscal Year Company")
94 query = query.where(
95 ExistsCriterion(frappe.qb.from_(FYC).select(FYC.name).where(FYC.parent == FY.name)).negate()
96 | ExistsCriterion(
97 frappe.qb.from_(FYC)
98 .select(FYC.company)
99 .where(FYC.parent == FY.name)
100 .where(FYC.company == company)
101 )
102 )
103
Shridhar Patil69efd2e2022-10-03 11:07:24 +0530104 query = query.orderby(FY.year_start_date, order=Order.desc)
Gavin D'souza0727d1d2022-06-13 12:39:28 +0530105 fiscal_years = query.run(as_dict=True)
106
Nabin Hait9784d272016-12-30 16:21:35 +0530107 frappe.cache().hset("fiscal_years", company, fiscal_years)
Nabin Haitfff3ab72015-01-14 16:27:13 +0530108
Prssanna Desai82ddef52020-06-18 18:18:41 +0530109 if not transaction_date and not fiscal_year:
110 return fiscal_years
111
Nabin Hait9784d272016-12-30 16:21:35 +0530112 if transaction_date:
113 transaction_date = getdate(transaction_date)
Anand Doshicd71e1d2014-04-08 13:53:35 +0530114
Nabin Hait9784d272016-12-30 16:21:35 +0530115 for fy in fiscal_years:
116 matched = False
117 if fiscal_year and fy.name == fiscal_year:
118 matched = True
Anand Doshicd71e1d2014-04-08 13:53:35 +0530119
Ankush Menat494bd9e2022-03-28 18:52:46 +0530120 if (
121 transaction_date
122 and getdate(fy.year_start_date) <= transaction_date
123 and getdate(fy.year_end_date) >= transaction_date
124 ):
Nabin Hait9784d272016-12-30 16:21:35 +0530125 matched = True
Rushabh Mehtad50da782017-07-28 11:39:01 +0530126
Nabin Hait9784d272016-12-30 16:21:35 +0530127 if matched:
128 if as_dict:
129 return (fy,)
130 else:
131 return ((fy.name, fy.year_start_date, fy.year_end_date),)
132
Ankush Menat494bd9e2022-03-28 18:52:46 +0530133 error_msg = _("""{0} {1} is not in any active Fiscal Year""").format(
134 label, formatdate(transaction_date)
135 )
Anuja P2e4faf92020-12-05 13:36:43 +0530136 if company:
Anuja P550cb9c2020-12-07 11:11:00 +0530137 error_msg = _("""{0} for {1}""").format(error_msg, frappe.bold(company))
rohitwaghchaured60ff832021-02-16 09:12:27 +0530138
Deepesh Garg0aadb682023-03-19 12:46:42 +0530139 if boolean:
140 return False
141
Ankush Menat494bd9e2022-03-28 18:52:46 +0530142 if verbose == 1:
143 frappe.msgprint(error_msg)
Deepesh Garg0aadb682023-03-19 12:46:42 +0530144
cclauss68487082017-07-27 07:08:35 +0200145 raise FiscalYearError(error_msg)
Nabin Hait9784d272016-12-30 16:21:35 +0530146
Ankush Menat494bd9e2022-03-28 18:52:46 +0530147
Prssanna Desai82ddef52020-06-18 18:18:41 +0530148@frappe.whitelist()
149def get_fiscal_year_filter_field(company=None):
Ankush Menat494bd9e2022-03-28 18:52:46 +0530150 field = {"fieldtype": "Select", "options": [], "operator": "Between", "query_value": True}
Prssanna Desai82ddef52020-06-18 18:18:41 +0530151 fiscal_years = get_fiscal_years(company=company)
152 for fiscal_year in fiscal_years:
Ankush Menat494bd9e2022-03-28 18:52:46 +0530153 field["options"].append(
154 {
155 "label": fiscal_year.name,
156 "value": fiscal_year.name,
157 "query_value": [
158 fiscal_year.year_start_date.strftime("%Y-%m-%d"),
159 fiscal_year.year_end_date.strftime("%Y-%m-%d"),
160 ],
161 }
162 )
Prssanna Desai82ddef52020-06-18 18:18:41 +0530163 return field
164
Ankush Menat494bd9e2022-03-28 18:52:46 +0530165
Nabin Hait8bf58362017-03-27 12:30:01 +0530166def validate_fiscal_year(date, fiscal_year, company, label="Date", doc=None):
167 years = [f[0] for f in get_fiscal_years(date, label=_(label), company=company)]
Rushabh Mehtac2563ef2013-02-05 23:25:37 +0530168 if fiscal_year not in years:
Rushabh Mehtad60acb92015-02-19 14:51:58 +0530169 if doc:
170 doc.fiscal_year = years[0]
171 else:
172 throw(_("{0} '{1}' not in Fiscal Year {2}").format(label, formatdate(date), fiscal_year))
Nabin Hait23941aa2013-01-29 11:32:38 +0530173
Ankush Menat494bd9e2022-03-28 18:52:46 +0530174
Rushabh Mehta793ba6b2014-02-14 15:47:51 +0530175@frappe.whitelist()
Ankush Menat494bd9e2022-03-28 18:52:46 +0530176def get_balance_on(
177 account=None,
178 date=None,
179 party_type=None,
180 party=None,
181 company=None,
182 in_account_currency=True,
183 cost_center=None,
184 ignore_account_permission=False,
RitvikSardanab86afb22023-08-04 22:05:30 +0530185 account_type=None,
Gursheen Anand52305e32023-11-22 18:38:33 +0530186 start_date=None,
Ankush Menat494bd9e2022-03-28 18:52:46 +0530187):
Rushabh Mehta793ba6b2014-02-14 15:47:51 +0530188 if not account and frappe.form_dict.get("account"):
189 account = frappe.form_dict.get("account")
Nabin Hait6f17cf92014-09-17 14:11:22 +0530190 if not date and frappe.form_dict.get("date"):
Rushabh Mehta793ba6b2014-02-14 15:47:51 +0530191 date = frappe.form_dict.get("date")
Nabin Hait6f17cf92014-09-17 14:11:22 +0530192 if not party_type and frappe.form_dict.get("party_type"):
193 party_type = frappe.form_dict.get("party_type")
194 if not party and frappe.form_dict.get("party"):
195 party = frappe.form_dict.get("party")
Sanjay Kumar1b49f3a2018-09-06 13:09:35 +0400196 if not cost_center and frappe.form_dict.get("cost_center"):
197 cost_center = frappe.form_dict.get("cost_center")
198
Nabin Hait98372852020-07-30 20:52:20 +0530199 cond = ["is_cancelled=0"]
Gursheen Anand52305e32023-11-22 18:38:33 +0530200 if start_date:
201 cond.append("posting_date >= %s" % frappe.db.escape(cstr(start_date)))
Nabin Hait23941aa2013-01-29 11:32:38 +0530202 if date:
Suraj Shettybfc195d2018-09-21 10:20:52 +0530203 cond.append("posting_date <= %s" % frappe.db.escape(cstr(date)))
Nabin Hait23941aa2013-01-29 11:32:38 +0530204 else:
205 # get balance of all entries that exist
206 date = nowdate()
Anand Doshicd71e1d2014-04-08 13:53:35 +0530207
Deepesh Garg8c217032019-07-16 09:41:01 +0530208 if account:
209 acc = frappe.get_doc("Account", account)
210
Nabin Hait23941aa2013-01-29 11:32:38 +0530211 try:
Deepesh Garg96d40ec2020-07-03 22:59:00 +0530212 year_start_date = get_fiscal_year(date, company=company, verbose=0)[1]
Rushabh Mehta9f0d6252014-04-14 19:20:45 +0530213 except FiscalYearError:
Nabin Hait23941aa2013-01-29 11:32:38 +0530214 if getdate(date) > getdate(nowdate()):
215 # if fiscal year not found and the date is greater than today
216 # get fiscal year for today's date and its corresponding year start date
217 year_start_date = get_fiscal_year(nowdate(), verbose=1)[1]
218 else:
219 # this indicates that it is a date older than any existing fiscal year.
220 # hence, assuming balance as 0.0
221 return 0.0
Anand Doshicd71e1d2014-04-08 13:53:35 +0530222
deepeshgarg0072ddbebf2019-07-20 14:52:59 +0530223 if account:
deepeshgarg007e097d4f2019-07-20 14:49:32 +0530224 report_type = acc.report_type
deepeshgarg0071ee3d042019-07-20 14:46:59 +0530225 else:
226 report_type = ""
227
Ankush Menat494bd9e2022-03-28 18:52:46 +0530228 if cost_center and report_type == "Profit and Loss":
Sanjay Kumar1b49f3a2018-09-06 13:09:35 +0400229 cc = frappe.get_doc("Cost Center", cost_center)
230 if cc.is_group:
Ankush Menat494bd9e2022-03-28 18:52:46 +0530231 cond.append(
232 """ exists (
Sanjay Kumar1b49f3a2018-09-06 13:09:35 +0400233 select 1 from `tabCost Center` cc where cc.name = gle.cost_center
234 and cc.lft >= %s and cc.rgt <= %s
Ankush Menat494bd9e2022-03-28 18:52:46 +0530235 )"""
236 % (cc.lft, cc.rgt)
237 )
Sanjay Kumar1b49f3a2018-09-06 13:09:35 +0400238
239 else:
Deepesh Garg6d87cfe2024-02-02 18:08:33 +0530240 cond.append("""gle.cost_center = %s """ % (frappe.db.escape(cost_center),))
Sanjay Kumar1b49f3a2018-09-06 13:09:35 +0400241
Nabin Hait6f17cf92014-09-17 14:11:22 +0530242 if account:
Ankush Menat494bd9e2022-03-28 18:52:46 +0530243 if not (frappe.flags.ignore_account_permission or ignore_account_permission):
Rushabh Mehta2e7f9d22015-10-15 16:31:16 +0530244 acc.check_permission("read")
Anand Doshicd71e1d2014-04-08 13:53:35 +0530245
Nabin Hait6f17cf92014-09-17 14:11:22 +0530246 # different filter for group and ledger - improved performance
Rushabh Mehta38c6b522015-04-23 13:14:17 +0530247 if acc.is_group:
Ankush Menat494bd9e2022-03-28 18:52:46 +0530248 cond.append(
249 """exists (
Nabin Hait6b01abe2015-06-14 17:49:29 +0530250 select name from `tabAccount` ac where ac.name = gle.account
Nabin Hait6f17cf92014-09-17 14:11:22 +0530251 and ac.lft >= %s and ac.rgt <= %s
Ankush Menat494bd9e2022-03-28 18:52:46 +0530252 )"""
253 % (acc.lft, acc.rgt)
254 )
Anand Doshicd0989e2015-09-28 13:31:17 +0530255
256 # If group and currency same as company,
Nabin Hait59f4fa92015-09-17 13:57:42 +0530257 # always return balance based on debit and credit in company currency
Ankush Menat494bd9e2022-03-28 18:52:46 +0530258 if acc.account_currency == frappe.get_cached_value("Company", acc.company, "default_currency"):
Nabin Hait59f4fa92015-09-17 13:57:42 +0530259 in_account_currency = False
Nabin Hait6f17cf92014-09-17 14:11:22 +0530260 else:
Deepesh Garg6d87cfe2024-02-02 18:08:33 +0530261 cond.append("""gle.account = %s """ % (frappe.db.escape(account),))
Anand Doshic75c1d72016-03-11 14:56:19 +0530262
RitvikSardanab86afb22023-08-04 22:05:30 +0530263 if account_type:
264 accounts = frappe.db.get_all(
265 "Account",
266 filters={"company": company, "account_type": account_type, "is_group": 0},
267 pluck="name",
268 order_by="lft",
269 )
270
271 cond.append(
272 """
273 gle.account in (%s)
274 """
275 % (", ".join([frappe.db.escape(account) for account in accounts]))
276 )
277
Nabin Hait6f17cf92014-09-17 14:11:22 +0530278 if party_type and party:
Ankush Menat494bd9e2022-03-28 18:52:46 +0530279 cond.append(
280 """gle.party_type = %s and gle.party = %s """
Deepesh Garg6d87cfe2024-02-02 18:08:33 +0530281 % (frappe.db.escape(party_type), frappe.db.escape(party))
Ankush Menat494bd9e2022-03-28 18:52:46 +0530282 )
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530283
Nabin Hait85648d92016-07-20 11:26:45 +0530284 if company:
Deepesh Garg6d87cfe2024-02-02 18:08:33 +0530285 cond.append("""gle.company = %s """ % (frappe.db.escape(company)))
Anand Doshi0b031cd2015-09-16 12:46:54 +0530286
RitvikSardanab86afb22023-08-04 22:05:30 +0530287 if account or (party_type and party) or account_type:
Dany Roberta8949172023-12-09 09:30:17 +0530288 precision = get_currency_precision()
Nabin Haitc0e3b1a2015-09-04 13:26:23 +0530289 if in_account_currency:
Dany Robert383a4b12023-11-21 12:46:56 +0000290 select_field = (
291 "sum(round(debit_in_account_currency, %s)) - sum(round(credit_in_account_currency, %s))"
292 )
Nabin Haitc0e3b1a2015-09-04 13:26:23 +0530293 else:
Dany Robert383a4b12023-11-21 12:46:56 +0000294 select_field = "sum(round(debit, %s)) - sum(round(credit, %s))"
295
Ankush Menat494bd9e2022-03-28 18:52:46 +0530296 bal = frappe.db.sql(
297 """
Nabin Haitc0e3b1a2015-09-04 13:26:23 +0530298 SELECT {0}
Nabin Haitdc768232015-08-17 11:27:00 +0530299 FROM `tabGL Entry` gle
Ankush Menat494bd9e2022-03-28 18:52:46 +0530300 WHERE {1}""".format(
301 select_field, " and ".join(cond)
Dany Robert383a4b12023-11-21 12:46:56 +0000302 ),
303 (precision, precision),
Ankush Menat494bd9e2022-03-28 18:52:46 +0530304 )[0][0]
Nabin Haitdc768232015-08-17 11:27:00 +0530305 # if bal is None, return 0
306 return flt(bal)
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530307
Ankush Menat494bd9e2022-03-28 18:52:46 +0530308
RobertSchouten8d43b322016-09-20 13:41:39 +0800309def get_count_on(account, fieldname, date):
Nabin Hait98372852020-07-30 20:52:20 +0530310 cond = ["is_cancelled=0"]
RobertSchouten8d43b322016-09-20 13:41:39 +0800311 if date:
Suraj Shettybfc195d2018-09-21 10:20:52 +0530312 cond.append("posting_date <= %s" % frappe.db.escape(cstr(date)))
RobertSchouten8d43b322016-09-20 13:41:39 +0800313 else:
314 # get balance of all entries that exist
315 date = nowdate()
316
317 try:
318 year_start_date = get_fiscal_year(date, verbose=0)[1]
319 except FiscalYearError:
320 if getdate(date) > getdate(nowdate()):
321 # if fiscal year not found and the date is greater than today
322 # get fiscal year for today's date and its corresponding year start date
323 year_start_date = get_fiscal_year(nowdate(), verbose=1)[1]
324 else:
325 # this indicates that it is a date older than any existing fiscal year.
326 # hence, assuming balance as 0.0
327 return 0.0
328
329 if account:
330 acc = frappe.get_doc("Account", account)
331
332 if not frappe.flags.ignore_account_permission:
333 acc.check_permission("read")
334
335 # for pl accounts, get balance within a fiscal year
Ankush Menat494bd9e2022-03-28 18:52:46 +0530336 if acc.report_type == "Profit and Loss":
337 cond.append(
338 "posting_date >= '%s' and voucher_type != 'Period Closing Voucher'" % year_start_date
339 )
RobertSchouten8d43b322016-09-20 13:41:39 +0800340
341 # different filter for group and ledger - improved performance
342 if acc.is_group:
Ankush Menat494bd9e2022-03-28 18:52:46 +0530343 cond.append(
344 """exists (
RobertSchouten8d43b322016-09-20 13:41:39 +0800345 select name from `tabAccount` ac where ac.name = gle.account
346 and ac.lft >= %s and ac.rgt <= %s
Ankush Menat494bd9e2022-03-28 18:52:46 +0530347 )"""
348 % (acc.lft, acc.rgt)
349 )
RobertSchouten8d43b322016-09-20 13:41:39 +0800350 else:
Deepesh Garg6d87cfe2024-02-02 18:08:33 +0530351 cond.append("""gle.account = %s """ % (frappe.db.escape(account),))
RobertSchouten8d43b322016-09-20 13:41:39 +0800352
Ankush Menat494bd9e2022-03-28 18:52:46 +0530353 entries = frappe.db.sql(
354 """
RobertSchouten8d43b322016-09-20 13:41:39 +0800355 SELECT name, posting_date, account, party_type, party,debit,credit,
356 voucher_type, voucher_no, against_voucher_type, against_voucher
357 FROM `tabGL Entry` gle
Ankush Menat494bd9e2022-03-28 18:52:46 +0530358 WHERE {0}""".format(
359 " and ".join(cond)
360 ),
361 as_dict=True,
362 )
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530363
RobertSchouten8d43b322016-09-20 13:41:39 +0800364 count = 0
365 for gle in entries:
Ankush Menat494bd9e2022-03-28 18:52:46 +0530366 if fieldname not in ("invoiced_amount", "payables"):
RobertSchouten8d43b322016-09-20 13:41:39 +0800367 count += 1
368 else:
369 dr_or_cr = "debit" if fieldname == "invoiced_amount" else "credit"
370 cr_or_dr = "credit" if fieldname == "invoiced_amount" else "debit"
Ankush Menat494bd9e2022-03-28 18:52:46 +0530371 select_fields = (
372 "ifnull(sum(credit-debit),0)"
373 if fieldname == "invoiced_amount"
374 else "ifnull(sum(debit-credit),0)"
375 )
RobertSchouten8d43b322016-09-20 13:41:39 +0800376
Ankush Menat494bd9e2022-03-28 18:52:46 +0530377 if (
378 (not gle.against_voucher)
379 or (gle.against_voucher_type in ["Sales Order", "Purchase Order"])
380 or (gle.against_voucher == gle.voucher_no and gle.get(dr_or_cr) > 0)
381 ):
382 payment_amount = frappe.db.sql(
383 """
RobertSchouten8d43b322016-09-20 13:41:39 +0800384 SELECT {0}
385 FROM `tabGL Entry` gle
386 WHERE docstatus < 2 and posting_date <= %(date)s and against_voucher = %(voucher_no)s
Ankush Menat494bd9e2022-03-28 18:52:46 +0530387 and party = %(party)s and name != %(name)s""".format(
388 select_fields
389 ),
390 {"date": date, "voucher_no": gle.voucher_no, "party": gle.party, "name": gle.name},
391 )[0][0]
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530392
RobertSchouten8d43b322016-09-20 13:41:39 +0800393 outstanding_amount = flt(gle.get(dr_or_cr)) - flt(gle.get(cr_or_dr)) - payment_amount
394 currency_precision = get_currency_precision() or 2
Ankush Menat494bd9e2022-03-28 18:52:46 +0530395 if abs(flt(outstanding_amount)) > 0.1 / 10**currency_precision:
RobertSchouten8d43b322016-09-20 13:41:39 +0800396 count += 1
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530397
RobertSchouten8d43b322016-09-20 13:41:39 +0800398 return count
399
Ankush Menat494bd9e2022-03-28 18:52:46 +0530400
Rushabh Mehta793ba6b2014-02-14 15:47:51 +0530401@frappe.whitelist()
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530402def add_ac(args=None):
Saurabh2f021012017-01-11 12:41:01 +0530403 from frappe.desk.treeview import make_tree_args
404
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530405 if not args:
Rushabh Mehta793ba6b2014-02-14 15:47:51 +0530406 args = frappe.local.form_dict
Saurabh2f021012017-01-11 12:41:01 +0530407
Nabin Hait02d987e2017-02-17 15:50:26 +0530408 args.doctype = "Account"
Saurabh2f021012017-01-11 12:41:01 +0530409 args = make_tree_args(**args)
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530410
Anand Doshi3e41fd12014-04-22 18:54:54 +0530411 ac = frappe.new_doc("Account")
Rushabh Mehta0dcb8612016-05-31 07:22:37 +0530412
Nabin Hait665568d2016-05-13 15:56:00 +0530413 if args.get("ignore_permissions"):
414 ac.flags.ignore_permissions = True
415 args.pop("ignore_permissions")
Rushabh Mehta0dcb8612016-05-31 07:22:37 +0530416
Anand Doshi3e41fd12014-04-22 18:54:54 +0530417 ac.update(args)
Saurabh0e47bfe2016-05-30 17:54:16 +0530418
419 if not ac.parent_account:
420 ac.parent_account = args.get("parent")
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530421
Anand Doshif78d1ae2014-03-28 13:55:00 +0530422 ac.old_parent = ""
423 ac.freeze_account = "No"
Nabin Haita1ec7f12016-05-11 12:37:22 +0530424 if cint(ac.get("is_root")):
425 ac.parent_account = None
Rushabh Mehta0dcb8612016-05-31 07:22:37 +0530426 ac.flags.ignore_mandatory = True
427
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530428 ac.insert()
Anand Doshi3e41fd12014-04-22 18:54:54 +0530429
Anand Doshif78d1ae2014-03-28 13:55:00 +0530430 return ac.name
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530431
Ankush Menat494bd9e2022-03-28 18:52:46 +0530432
Rushabh Mehta793ba6b2014-02-14 15:47:51 +0530433@frappe.whitelist()
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530434def add_cc(args=None):
Saurabh2f021012017-01-11 12:41:01 +0530435 from frappe.desk.treeview import make_tree_args
436
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530437 if not args:
Rushabh Mehta793ba6b2014-02-14 15:47:51 +0530438 args = frappe.local.form_dict
Rushabh Mehtad50da782017-07-28 11:39:01 +0530439
Nabin Hait02d987e2017-02-17 15:50:26 +0530440 args.doctype = "Cost Center"
Saurabh2f021012017-01-11 12:41:01 +0530441 args = make_tree_args(**args)
Anand Doshicd71e1d2014-04-08 13:53:35 +0530442
Zarrar7ab70ca2018-06-08 14:33:15 +0530443 if args.parent_cost_center == args.company:
Ankush Menat494bd9e2022-03-28 18:52:46 +0530444 args.parent_cost_center = "{0} - {1}".format(
445 args.parent_cost_center, frappe.get_cached_value("Company", args.company, "abbr")
446 )
Zarrar7ab70ca2018-06-08 14:33:15 +0530447
Anand Doshi3e41fd12014-04-22 18:54:54 +0530448 cc = frappe.new_doc("Cost Center")
449 cc.update(args)
Saurabh0e47bfe2016-05-30 17:54:16 +0530450
451 if not cc.parent_cost_center:
452 cc.parent_cost_center = args.get("parent")
453
Anand Doshif78d1ae2014-03-28 13:55:00 +0530454 cc.old_parent = ""
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530455 cc.insert()
Anand Doshif78d1ae2014-03-28 13:55:00 +0530456 return cc.name
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530457
Ankush Menat494bd9e2022-03-28 18:52:46 +0530458
ruthra kumarc44eb432024-01-18 14:35:06 +0530459def _build_dimensions_dict_for_exc_gain_loss(
460 entry: dict | object = None, active_dimensions: list = None
461):
462 dimensions_dict = frappe._dict()
463 if entry and active_dimensions:
464 for dim in active_dimensions:
465 dimensions_dict[dim.fieldname] = entry.get(dim.fieldname)
466 return dimensions_dict
467
468
469def reconcile_against_document(
470 args, skip_ref_details_update_for_pe=False, active_dimensions=None
471): # nosemgrep
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530472 """
Ankush Menat494bd9e2022-03-28 18:52:46 +0530473 Cancel PE or JV, Update against document, split if required and resubmit
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530474 """
Anuja Pawar3e404f12021-08-31 18:59:29 +0530475 # To optimize making GL Entry for PE or JV with multiple references
476 reconciled_entries = {}
477 for row in args:
478 if not reconciled_entries.get((row.voucher_type, row.voucher_no)):
479 reconciled_entries[(row.voucher_type, row.voucher_no)] = []
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530480
Anuja Pawar3e404f12021-08-31 18:59:29 +0530481 reconciled_entries[(row.voucher_type, row.voucher_no)].append(row)
482
483 for key, entries in reconciled_entries.items():
484 voucher_type = key[0]
485 voucher_no = key[1]
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530486
Nabin Hait28a05282016-06-27 17:41:39 +0530487 # cancel advance entry
Anuja Pawar3e404f12021-08-31 18:59:29 +0530488 doc = frappe.get_doc(voucher_type, voucher_no)
Subin Tomb8845b92021-07-30 16:30:18 +0530489 frappe.flags.ignore_party_validation = True
ruthra kumar78ab11f2023-09-20 13:05:04 +0530490
ruthra kumarecb533c2023-11-28 17:04:07 +0530491 # For payments with `Advance` in separate account feature enabled, only new ledger entries are posted for each reference.
492 # No need to cancel/delete payment ledger entries
ruthra kumar78ab11f2023-09-20 13:05:04 +0530493 if not (voucher_type == "Payment Entry" and doc.book_advance_payments_in_separate_party_account):
494 _delete_pl_entries(voucher_type, voucher_no)
Anand Doshicd71e1d2014-04-08 13:53:35 +0530495
Anuja Pawar3e404f12021-08-31 18:59:29 +0530496 for entry in entries:
497 check_if_advance_entry_modified(entry)
498 validate_allocated_amount(entry)
Anand Doshicd71e1d2014-04-08 13:53:35 +0530499
ruthra kumarc44eb432024-01-18 14:35:06 +0530500 dimensions_dict = _build_dimensions_dict_for_exc_gain_loss(entry, active_dimensions)
501
Anuja Pawar3e404f12021-08-31 18:59:29 +0530502 # update ref in advance entry
503 if voucher_type == "Journal Entry":
ruthra kumar79c6f012023-09-01 14:57:12 +0530504 referenced_row = update_reference_in_journal_entry(entry, doc, do_not_save=False)
ruthra kumar7b516f82023-06-26 17:34:28 +0530505 # advance section in sales/purchase invoice and reconciliation tool,both pass on exchange gain/loss
506 # amount and account in args
ruthra kumar79c6f012023-09-01 14:57:12 +0530507 # referenced_row is used to deduplicate gain/loss journal
508 entry.update({"referenced_row": referenced_row})
ruthra kumarc44eb432024-01-18 14:35:06 +0530509 doc.make_exchange_gain_loss_journal([entry], dimensions_dict)
Anuja Pawar3e404f12021-08-31 18:59:29 +0530510 else:
ruthra kumarecb533c2023-11-28 17:04:07 +0530511 referenced_row = update_reference_in_payment_entry(
ruthra kumarc44eb432024-01-18 14:35:06 +0530512 entry,
513 doc,
514 do_not_save=True,
515 skip_ref_details_update_for_pe=skip_ref_details_update_for_pe,
516 dimensions_dict=dimensions_dict,
ruthra kumared14d1c2023-04-22 17:24:35 +0530517 )
Anuja Pawar3e404f12021-08-31 18:59:29 +0530518
519 doc.save(ignore_permissions=True)
Nabin Hait28a05282016-06-27 17:41:39 +0530520 # re-submit advance entry
Anuja Pawar3e404f12021-08-31 18:59:29 +0530521 doc = frappe.get_doc(entry.voucher_type, entry.voucher_no)
ruthra kumar78ab11f2023-09-20 13:05:04 +0530522
523 if voucher_type == "Payment Entry" and doc.book_advance_payments_in_separate_party_account:
ruthra kumarecb533c2023-11-28 17:04:07 +0530524 # both ledgers must be posted to for `Advance` in separate account feature
525 doc.make_advance_gl_entries(referenced_row, update_outstanding="No")
ruthra kumar78ab11f2023-09-20 13:05:04 +0530526 else:
527 gl_map = doc.build_gl_map()
528 create_payment_ledger_entry(gl_map, update_outstanding="No", cancel=0, adv_adj=1)
Deepesh Garg1894dc82023-06-23 21:53:34 +0530529
ruthra kumar11cf6942023-01-14 12:22:22 +0530530 # Only update outstanding for newly linked vouchers
531 for entry in entries:
532 update_voucher_outstanding(
533 entry.against_voucher_type, entry.against_voucher, entry.account, entry.party_type, entry.party
534 )
ruthra kumar524c1752022-05-26 16:00:40 +0530535
Subin Tomb8845b92021-07-30 16:30:18 +0530536 frappe.flags.ignore_party_validation = False
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530537
Ankush Menat494bd9e2022-03-28 18:52:46 +0530538
Nabin Hait28a05282016-06-27 17:41:39 +0530539def check_if_advance_entry_modified(args):
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530540 """
Ankush Menat494bd9e2022-03-28 18:52:46 +0530541 check if there is already a voucher reference
542 check if amount is same
543 check if jv is submitted
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530544 """
Ankush Menat494bd9e2022-03-28 18:52:46 +0530545 if not args.get("unreconciled_amount"):
546 args.update({"unreconciled_amount": args.get("unadjusted_amount")})
Anuja Pawar3e404f12021-08-31 18:59:29 +0530547
Nabin Hait28a05282016-06-27 17:41:39 +0530548 ret = None
549 if args.voucher_type == "Journal Entry":
Gursheen Anand74619262023-06-02 17:13:51 +0530550 journal_entry = frappe.qb.DocType("Journal Entry")
551 journal_acc = frappe.qb.DocType("Journal Entry Account")
552
Gursheen Anand4ee16372023-06-08 13:15:23 +0530553 q = (
554 frappe.qb.from_(journal_entry)
Deepesh Garg3aead052023-06-22 11:41:43 +0530555 .inner_join(journal_acc)
Gursheen Anand74619262023-06-02 17:13:51 +0530556 .on(journal_entry.name == journal_acc.parent)
Deepesh Gargd81d6062023-06-22 18:28:16 +0530557 .select(journal_acc[args.get("dr_or_cr")])
558 .where(
559 (journal_acc.account == args.get("account"))
560 & ((journal_acc.party_type == args.get("party_type")))
561 & ((journal_acc.party == args.get("party")))
562 & (
563 (journal_acc.reference_type.isnull())
564 | (journal_acc.reference_type.isin(["", "Sales Order", "Purchase Order"]))
565 )
566 & ((journal_entry.name == args.get("voucher_no")))
567 & ((journal_acc.name == args.get("voucher_detail_no")))
568 & ((journal_entry.docstatus == 1))
Gursheen Anand4ee16372023-06-08 13:15:23 +0530569 )
Gursheen Anand74619262023-06-02 17:13:51 +0530570 )
571
Nabin Hait28a05282016-06-27 17:41:39 +0530572 else:
ruthra kumar60435da2023-11-03 17:58:19 +0530573 precision = frappe.get_precision("Payment Entry", "unallocated_amount")
574
Gursheen Anand74619262023-06-02 17:13:51 +0530575 payment_entry = frappe.qb.DocType("Payment Entry")
576 payment_ref = frappe.qb.DocType("Payment Entry Reference")
577
Gursheen Anand4ee16372023-06-08 13:15:23 +0530578 q = (
579 frappe.qb.from_(payment_entry)
Gursheen Anand74619262023-06-02 17:13:51 +0530580 .select(payment_entry.name)
581 .where(payment_entry.name == args.get("voucher_no"))
582 .where(payment_entry.docstatus == 1)
583 .where(payment_entry.party_type == args.get("party_type"))
584 .where(payment_entry.party == args.get("party"))
Ankush Menat494bd9e2022-03-28 18:52:46 +0530585 )
rohitwaghchauree8358f32018-05-16 11:02:26 +0530586
Nabin Hait28a05282016-06-27 17:41:39 +0530587 if args.voucher_detail_no:
Gursheen Anand4ee16372023-06-08 13:15:23 +0530588 q = (
589 q.inner_join(payment_ref)
Gursheen Anand74619262023-06-02 17:13:51 +0530590 .on(payment_entry.name == payment_ref.parent)
591 .where(payment_ref.name == args.get("voucher_detail_no"))
Gursheen Anand4ee16372023-06-08 13:15:23 +0530592 .where(payment_ref.reference_doctype.isin(("", "Sales Order", "Purchase Order")))
Gursheen Anand74619262023-06-02 17:13:51 +0530593 .where(payment_ref.allocated_amount == args.get("unreconciled_amount"))
Gursheen Anand4ee16372023-06-08 13:15:23 +0530594 )
Nabin Hait28a05282016-06-27 17:41:39 +0530595 else:
ruthra kumar60435da2023-11-03 17:58:19 +0530596 q = q.where(
597 Round(payment_entry.unallocated_amount, precision)
598 == Round(args.get("unreconciled_amount"), precision)
599 )
Gursheen Anand4ee16372023-06-08 13:15:23 +0530600
Gursheen Anand74619262023-06-02 17:13:51 +0530601 ret = q.run(as_dict=True)
Anand Doshicd71e1d2014-04-08 13:53:35 +0530602
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530603 if not ret:
Akhilesh Darjee4f721562014-01-29 16:31:38 +0530604 throw(_("""Payment Entry has been modified after you pulled it. Please pull it again."""))
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530605
Ankush Menat494bd9e2022-03-28 18:52:46 +0530606
Nabin Hait576f0252014-04-30 19:30:50 +0530607def validate_allocated_amount(args):
Ankush Menat494bd9e2022-03-28 18:52:46 +0530608 precision = args.get("precision") or frappe.db.get_single_value(
609 "System Settings", "currency_precision"
610 )
Nabin Hait28a05282016-06-27 17:41:39 +0530611 if args.get("allocated_amount") < 0:
Kenneth Sequeiraa29ed402019-05-27 11:47:07 +0530612 throw(_("Allocated amount cannot be negative"))
Deepesh Gargf54d5962021-03-31 14:06:02 +0530613 elif flt(args.get("allocated_amount"), precision) > flt(args.get("unadjusted_amount"), precision):
Kenneth Sequeiraa29ed402019-05-27 11:47:07 +0530614 throw(_("Allocated amount cannot be greater than unadjusted amount"))
Nabin Hait576f0252014-04-30 19:30:50 +0530615
Ankush Menat494bd9e2022-03-28 18:52:46 +0530616
Anuja Pawar3e404f12021-08-31 18:59:29 +0530617def update_reference_in_journal_entry(d, journal_entry, do_not_save=False):
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530618 """
Ankush Menat494bd9e2022-03-28 18:52:46 +0530619 Updates against document, if partial amount splits into rows
Nabin Haitfb3fd6e2013-01-30 19:16:13 +0530620 """
Anuja Pawar3e404f12021-08-31 18:59:29 +0530621 jv_detail = journal_entry.get("accounts", {"name": d["voucher_detail_no"]})[0]
Rushabh Mehta1828c122015-08-10 17:04:07 +0530622
marination426350e2023-09-13 14:24:56 +0530623 # Update Advance Paid in SO/PO since they might be getting unlinked
David Arnoldc88ce552024-01-22 22:04:30 +0100624 advance_payment_doctypes = frappe.get_hooks(
ruthra kumar9fcd89d2024-01-24 13:27:31 +0530625 "advance_payment_receivable_doctypes"
626 ) + frappe.get_hooks("advance_payment_payable_doctypes")
David Arnoldc88ce552024-01-22 22:04:30 +0100627 if jv_detail.get("reference_type") in advance_payment_doctypes:
marination426350e2023-09-13 14:24:56 +0530628 frappe.get_doc(jv_detail.reference_type, jv_detail.reference_name).set_total_advance_paid()
629
Ankush Menat494bd9e2022-03-28 18:52:46 +0530630 if flt(d["unadjusted_amount"]) - flt(d["allocated_amount"]) != 0:
Anuja Pawar3e404f12021-08-31 18:59:29 +0530631 # adjust the unreconciled balance
Ankush Menat494bd9e2022-03-28 18:52:46 +0530632 amount_in_account_currency = flt(d["unadjusted_amount"]) - flt(d["allocated_amount"])
Anuja Pawar3e404f12021-08-31 18:59:29 +0530633 amount_in_company_currency = amount_in_account_currency * flt(jv_detail.exchange_rate)
Ankush Menat494bd9e2022-03-28 18:52:46 +0530634 jv_detail.set(d["dr_or_cr"], amount_in_account_currency)
635 jv_detail.set(
636 "debit" if d["dr_or_cr"] == "debit_in_account_currency" else "credit",
637 amount_in_company_currency,
638 )
Anuja Pawar3e404f12021-08-31 18:59:29 +0530639 else:
640 journal_entry.remove(jv_detail)
Anand Doshi0b031cd2015-09-16 12:46:54 +0530641
Anuja Pawar3e404f12021-08-31 18:59:29 +0530642 # new row with references
643 new_row = journal_entry.append("accounts")
Anuja Pawar1a6e98e2021-10-29 20:52:47 +0530644
ruthra kumar72f577a2023-07-13 15:04:44 +0530645 # Copy field values into new row
646 [
647 new_row.set(field, jv_detail.get(field))
648 for field in frappe.get_meta("Journal Entry Account").get_fieldnames_with_value()
649 ]
Rushabh Mehta2e7f9d22015-10-15 16:31:16 +0530650
Anuja Pawar3e404f12021-08-31 18:59:29 +0530651 new_row.set(d["dr_or_cr"], d["allocated_amount"])
Ankush Menat494bd9e2022-03-28 18:52:46 +0530652 new_row.set(
653 "debit" if d["dr_or_cr"] == "debit_in_account_currency" else "credit",
654 d["allocated_amount"] * flt(jv_detail.exchange_rate),
655 )
Rushabh Mehta2e7f9d22015-10-15 16:31:16 +0530656
Ankush Menat494bd9e2022-03-28 18:52:46 +0530657 new_row.set(
658 "credit_in_account_currency"
659 if d["dr_or_cr"] == "debit_in_account_currency"
660 else "debit_in_account_currency",
661 0,
662 )
663 new_row.set("credit" if d["dr_or_cr"] == "debit_in_account_currency" else "debit", 0)
Rushabh Mehta2e7f9d22015-10-15 16:31:16 +0530664
Anuja Pawar3e404f12021-08-31 18:59:29 +0530665 new_row.set("reference_type", d["against_voucher_type"])
666 new_row.set("reference_name", d["against_voucher"])
667
668 new_row.against_account = cstr(jv_detail.against_account)
669 new_row.is_advance = cstr(jv_detail.is_advance)
670 new_row.docstatus = 1
Anand Doshicd71e1d2014-04-08 13:53:35 +0530671
672 # will work as update after submit
Anuja Pawar3e404f12021-08-31 18:59:29 +0530673 journal_entry.flags.ignore_validate_update_after_submit = True
674 if not do_not_save:
675 journal_entry.save(ignore_permissions=True)
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530676
ruthra kumar79c6f012023-09-01 14:57:12 +0530677 return new_row.name
678
Ankush Menat494bd9e2022-03-28 18:52:46 +0530679
ruthra kumared14d1c2023-04-22 17:24:35 +0530680def update_reference_in_payment_entry(
ruthra kumarc44eb432024-01-18 14:35:06 +0530681 d, payment_entry, do_not_save=False, skip_ref_details_update_for_pe=False, dimensions_dict=None
ruthra kumared14d1c2023-04-22 17:24:35 +0530682):
Nabin Hait28a05282016-06-27 17:41:39 +0530683 reference_details = {
684 "reference_doctype": d.against_voucher_type,
685 "reference_name": d.against_voucher,
686 "total_amount": d.grand_total,
687 "outstanding_amount": d.outstanding_amount,
688 "allocated_amount": d.allocated_amount,
ruthra kumar5eeb6502023-12-15 11:46:12 +0530689 "exchange_rate": d.exchange_rate
690 if d.difference_amount is not None
691 else payment_entry.get_exchange_rate(),
692 "exchange_gain_loss": d.difference_amount,
Gursheen Anandb65e58c2023-06-08 18:15:37 +0530693 "account": d.account,
ruthra kumar5dc22e12023-12-20 17:19:27 +0530694 "dimensions": d.dimensions,
Nabin Hait28a05282016-06-27 17:41:39 +0530695 }
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530696
Nabin Hait28a05282016-06-27 17:41:39 +0530697 if d.voucher_detail_no:
698 existing_row = payment_entry.get("references", {"name": d["voucher_detail_no"]})[0]
marination426350e2023-09-13 14:24:56 +0530699
700 # Update Advance Paid in SO/PO since they are getting unlinked
David Arnoldc88ce552024-01-22 22:04:30 +0100701 advance_payment_doctypes = frappe.get_hooks(
ruthra kumar9fcd89d2024-01-24 13:27:31 +0530702 "advance_payment_receivable_doctypes"
703 ) + frappe.get_hooks("advance_payment_payable_doctypes")
David Arnoldc88ce552024-01-22 22:04:30 +0100704 if existing_row.get("reference_doctype") in advance_payment_doctypes:
marination426350e2023-09-13 14:24:56 +0530705 frappe.get_doc(
706 existing_row.reference_doctype, existing_row.reference_name
707 ).set_total_advance_paid()
708
ruthra kumar23df4202023-10-19 11:32:21 +0530709 if d.allocated_amount <= existing_row.allocated_amount:
710 existing_row.allocated_amount -= d.allocated_amount
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530711
Nabin Hait28a05282016-06-27 17:41:39 +0530712 new_row = payment_entry.append("references")
713 new_row.docstatus = 1
Achilles Rasquinhaefb73192018-05-23 01:01:24 -0500714 for field in list(reference_details):
ruthra kumar23df4202023-10-19 11:32:21 +0530715 new_row.set(field, reference_details[field])
ruthra kumarecb533c2023-11-28 17:04:07 +0530716 row = new_row
Nabin Hait28a05282016-06-27 17:41:39 +0530717 else:
718 new_row = payment_entry.append("references")
719 new_row.docstatus = 1
720 new_row.update(reference_details)
ruthra kumarecb533c2023-11-28 17:04:07 +0530721 row = new_row
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530722
Devin Slauenwhite98c39c42023-01-01 22:25:12 -0500723 payment_entry.flags.ignore_validate_update_after_submit = True
ruthra kumar23df4202023-10-19 11:32:21 +0530724 payment_entry.clear_unallocated_reference_document_rows()
Devin Slauenwhite98c39c42023-01-01 22:25:12 -0500725 payment_entry.setup_party_account_field()
726 payment_entry.set_missing_values()
ruthra kumared14d1c2023-04-22 17:24:35 +0530727 if not skip_ref_details_update_for_pe:
728 payment_entry.set_missing_ref_details()
Devin Slauenwhite98c39c42023-01-01 22:25:12 -0500729 payment_entry.set_amounts()
ruthra kumarc44eb432024-01-18 14:35:06 +0530730
ruthra kumar7e600a62023-10-22 20:26:45 +0530731 payment_entry.make_exchange_gain_loss_journal(
ruthra kumarc44eb432024-01-18 14:35:06 +0530732 frappe._dict({"difference_posting_date": d.difference_posting_date}), dimensions_dict
ruthra kumar7e600a62023-10-22 20:26:45 +0530733 )
Devin Slauenwhite98c39c42023-01-01 22:25:12 -0500734
Rohit Waghchaurea2408a62019-06-24 01:52:48 +0530735 if not do_not_save:
736 payment_entry.save(ignore_permissions=True)
ruthra kumarecb533c2023-11-28 17:04:07 +0530737 return row
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530738
Ankush Menat494bd9e2022-03-28 18:52:46 +0530739
ruthra kumar5dbcf7d2023-09-05 09:52:36 +0530740def cancel_exchange_gain_loss_journal(
741 parent_doc: dict | object, referenced_dt: str = None, referenced_dn: str = None
742) -> None:
ruthra kumar81cd7872023-04-27 09:46:54 +0530743 """
744 Cancel Exchange Gain/Loss for Sales/Purchase Invoice, if they have any.
745 """
ruthra kumar6e18bb62023-07-11 12:21:10 +0530746 if parent_doc.doctype in ["Sales Invoice", "Purchase Invoice", "Payment Entry", "Journal Entry"]:
ruthra kumar81cd7872023-04-27 09:46:54 +0530747 journals = frappe.db.get_all(
748 "Journal Entry Account",
749 filters={
750 "reference_type": parent_doc.doctype,
751 "reference_name": parent_doc.name,
752 "docstatus": 1,
753 },
754 fields=["parent"],
755 as_list=1,
756 )
ruthra kumard9d68562023-07-27 08:02:46 +0530757
ruthra kumar81cd7872023-04-27 09:46:54 +0530758 if journals:
ruthra kumard9d68562023-07-27 08:02:46 +0530759 gain_loss_journals = frappe.db.get_all(
ruthra kumar81cd7872023-04-27 09:46:54 +0530760 "Journal Entry",
761 filters={
762 "name": ["in", [x[0] for x in journals]],
763 "voucher_type": "Exchange Gain Or Loss",
764 "docstatus": 1,
765 },
766 as_list=1,
767 )
ruthra kumard9d68562023-07-27 08:02:46 +0530768 for doc in gain_loss_journals:
ruthra kumar5dbcf7d2023-09-05 09:52:36 +0530769 gain_loss_je = frappe.get_doc("Journal Entry", doc[0])
770 if referenced_dt and referenced_dn:
771 references = [(x.reference_type, x.reference_name) for x in gain_loss_je.accounts]
772 if (
773 len(references) == 2
774 and (referenced_dt, referenced_dn) in references
775 and (parent_doc.doctype, parent_doc.name) in references
776 ):
777 # only cancel JE generated against parent_doc and referenced_dn
778 gain_loss_je.cancel()
779 else:
780 gain_loss_je.cancel()
ruthra kumar81cd7872023-04-27 09:46:54 +0530781
782
ruthra kumar9b6eac22023-08-30 16:44:25 +0530783def update_accounting_ledgers_after_reference_removal(
784 ref_type: str = None, ref_no: str = None, payment_name: str = None
785):
ruthra kumar0130aea2023-08-30 13:25:23 +0530786 # General Ledger
787 gle = qb.DocType("GL Entry")
ruthra kumar9b6eac22023-08-30 16:44:25 +0530788 gle_update_query = (
789 qb.update(gle)
790 .set(gle.against_voucher_type, None)
791 .set(gle.against_voucher, None)
792 .set(gle.modified, now())
793 .set(gle.modified_by, frappe.session.user)
794 .where((gle.against_voucher_type == ref_type) & (gle.against_voucher == ref_no))
Ankush Menat494bd9e2022-03-28 18:52:46 +0530795 )
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530796
ruthra kumar9b6eac22023-08-30 16:44:25 +0530797 if payment_name:
798 gle_update_query = gle_update_query.where(gle.voucher_no == payment_name)
799 gle_update_query.run()
Nabin Hait297d74a2016-11-23 15:58:51 +0530800
ruthra kumar0130aea2023-08-30 13:25:23 +0530801 # Payment Ledger
ruthra kumar537d9532022-10-10 10:17:19 +0530802 ple = qb.DocType("Payment Ledger Entry")
ruthra kumar9b6eac22023-08-30 16:44:25 +0530803 ple_update_query = (
804 qb.update(ple)
805 .set(ple.against_voucher_type, ple.voucher_type)
806 .set(ple.against_voucher_no, ple.voucher_no)
807 .set(ple.modified, now())
808 .set(ple.modified_by, frappe.session.user)
809 .where(
810 (ple.against_voucher_type == ref_type)
811 & (ple.against_voucher_no == ref_no)
812 & (ple.delinked == 0)
813 )
814 )
ruthra kumar537d9532022-10-10 10:17:19 +0530815
ruthra kumar9b6eac22023-08-30 16:44:25 +0530816 if payment_name:
817 ple_update_query = ple_update_query.where(ple.voucher_no == payment_name)
818 ple_update_query.run()
ruthra kumar537d9532022-10-10 10:17:19 +0530819
ruthra kumar0130aea2023-08-30 13:25:23 +0530820
821def remove_ref_from_advance_section(ref_doc: object = None):
ruthra kumar9b6eac22023-08-30 16:44:25 +0530822 # TODO: this might need some testing
Nabin Hait297d74a2016-11-23 15:58:51 +0530823 if ref_doc.doctype in ("Sales Invoice", "Purchase Invoice"):
824 ref_doc.set("advances", [])
ruthra kumar0130aea2023-08-30 13:25:23 +0530825 adv_type = qb.DocType(f"{ref_doc.doctype} Advance")
826 qb.from_(adv_type).delete().where(adv_type.parent == ref_doc.name).run()
Ankush Menat494bd9e2022-03-28 18:52:46 +0530827
Anand Doshicd71e1d2014-04-08 13:53:35 +0530828
ruthra kumar9b6eac22023-08-30 16:44:25 +0530829def unlink_ref_doc_from_payment_entries(ref_doc: object = None, payment_name: str = None):
830 remove_ref_doc_link_from_jv(ref_doc.doctype, ref_doc.name, payment_name)
831 remove_ref_doc_link_from_pe(ref_doc.doctype, ref_doc.name, payment_name)
832 update_accounting_ledgers_after_reference_removal(ref_doc.doctype, ref_doc.name, payment_name)
833 remove_ref_from_advance_section(ref_doc)
Anand Doshicd71e1d2014-04-08 13:53:35 +0530834
Rushabh Mehta1828c122015-08-10 17:04:07 +0530835
ruthra kumar9b6eac22023-08-30 16:44:25 +0530836def remove_ref_doc_link_from_jv(
837 ref_type: str = None, ref_no: str = None, payment_name: str = None
838):
ruthra kumar0130aea2023-08-30 13:25:23 +0530839 jea = qb.DocType("Journal Entry Account")
840
841 linked_jv = (
842 qb.from_(jea)
843 .select(jea.parent)
ruthra kumar9a1588f2023-08-30 20:50:16 +0530844 .where((jea.reference_type == ref_type) & (jea.reference_name == ref_no) & (jea.docstatus.lt(2)))
ruthra kumar0130aea2023-08-30 13:25:23 +0530845 .run(as_list=1)
Ankush Menat494bd9e2022-03-28 18:52:46 +0530846 )
ruthra kumar0130aea2023-08-30 13:25:23 +0530847 linked_jv = convert_to_list(linked_jv)
ruthra kumar9b6eac22023-08-30 16:44:25 +0530848 # remove reference only from specified payment
849 linked_jv = [x for x in linked_jv if x == payment_name] if payment_name else linked_jv
Nabin Haitdc15b4f2014-01-20 16:48:49 +0530850
851 if linked_jv:
ruthra kumar9b6eac22023-08-30 16:44:25 +0530852 update_query = (
853 qb.update(jea)
854 .set(jea.reference_type, None)
855 .set(jea.reference_name, None)
856 .set(jea.modified, now())
857 .set(jea.modified_by, frappe.session.user)
858 .where((jea.reference_type == ref_type) & (jea.reference_name == ref_no))
Ankush Menat494bd9e2022-03-28 18:52:46 +0530859 )
Anand Doshicd71e1d2014-04-08 13:53:35 +0530860
ruthra kumar9b6eac22023-08-30 16:44:25 +0530861 if payment_name:
862 update_query = update_query.where(jea.parent == payment_name)
863
864 update_query.run()
Anand Doshi7da72dd2013-03-20 17:00:41 +0530865
Suraj Shetty48e9bc32020-01-29 15:06:18 +0530866 frappe.msgprint(_("Journal Entries {0} are un-linked").format("\n".join(linked_jv)))
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530867
Ankush Menat494bd9e2022-03-28 18:52:46 +0530868
ruthra kumar0130aea2023-08-30 13:25:23 +0530869def convert_to_list(result):
870 """
871 Convert tuple to list
872 """
873 return [x[0] for x in result]
874
875
ruthra kumar9b6eac22023-08-30 16:44:25 +0530876def remove_ref_doc_link_from_pe(
877 ref_type: str = None, ref_no: str = None, payment_name: str = None
878):
ruthra kumar0130aea2023-08-30 13:25:23 +0530879 per = qb.DocType("Payment Entry Reference")
880 pay = qb.DocType("Payment Entry")
881
882 linked_pe = (
883 qb.from_(per)
884 .select(per.parent)
885 .where(
886 (per.reference_doctype == ref_type) & (per.reference_name == ref_no) & (per.docstatus.lt(2))
887 )
888 .run(as_list=1)
Ankush Menat494bd9e2022-03-28 18:52:46 +0530889 )
ruthra kumar0130aea2023-08-30 13:25:23 +0530890 linked_pe = convert_to_list(linked_pe)
ruthra kumar9b6eac22023-08-30 16:44:25 +0530891 # remove reference only from specified payment
892 linked_pe = [x for x in linked_pe if x == payment_name] if payment_name else linked_pe
Anand Doshicd71e1d2014-04-08 13:53:35 +0530893
Nabin Haite0cc87d2016-07-21 18:30:03 +0530894 if linked_pe:
ruthra kumar9b6eac22023-08-30 16:44:25 +0530895 update_query = (
896 qb.update(per)
897 .set(per.allocated_amount, 0)
898 .set(per.modified, now())
899 .set(per.modified_by, frappe.session.user)
900 .where(
901 (per.docstatus.lt(2) & (per.reference_doctype == ref_type) & (per.reference_name == ref_no))
902 )
Ankush Menat494bd9e2022-03-28 18:52:46 +0530903 )
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530904
ruthra kumar9b6eac22023-08-30 16:44:25 +0530905 if payment_name:
906 update_query = update_query.where(per.parent == payment_name)
907
908 update_query.run()
Nabin Haite0cc87d2016-07-21 18:30:03 +0530909
910 for pe in linked_pe:
Deepesh Gargc5276f32021-08-01 17:48:50 +0530911 try:
Deepesh Garg1894dc82023-06-23 21:53:34 +0530912 pe_doc = frappe.get_doc("Payment Entry", pe)
Deepesh Garg71418602021-08-10 22:21:28 +0530913 pe_doc.set_amounts()
ruthra kumarecb533c2023-11-28 17:04:07 +0530914
915 # Call cancel on only removed reference
916 references = [
917 x for x in pe_doc.references if x.reference_doctype == ref_type and x.reference_name == ref_no
918 ]
919 [pe_doc.make_advance_gl_entries(x, cancel=1) for x in references]
920
Deepesh Gargb5162392021-08-10 14:52:24 +0530921 pe_doc.clear_unallocated_reference_document_rows()
922 pe_doc.validate_payment_type_with_outstanding()
Deepesh Gargc5276f32021-08-01 17:48:50 +0530923 except Exception as e:
924 msg = _("There were issues unlinking payment entry {0}.").format(pe_doc.name)
Ankush Menat494bd9e2022-03-28 18:52:46 +0530925 msg += "<br>"
Deepesh Garg188bba82021-08-10 14:04:31 +0530926 msg += _("Please cancel payment entry manually first")
Deepesh Garg71418602021-08-10 22:21:28 +0530927 frappe.throw(msg, exc=PaymentEntryUnlinkError, title=_("Payment Unlink Error"))
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530928
ruthra kumar0130aea2023-08-30 13:25:23 +0530929 qb.update(pay).set(pay.total_allocated_amount, pe_doc.total_allocated_amount).set(
930 pay.base_total_allocated_amount, pe_doc.base_total_allocated_amount
931 ).set(pay.unallocated_amount, pe_doc.unallocated_amount).set(pay.modified, now()).set(
932 pay.modified_by, frappe.session.user
933 ).where(
934 pay.name == pe
935 ).run()
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +0530936
Suraj Shetty48e9bc32020-01-29 15:06:18 +0530937 frappe.msgprint(_("Payment Entries {0} are un-linked").format("\n".join(linked_pe)))
Nabin Hait0fc24542013-03-25 11:06:00 +0530938
Ankush Menat494bd9e2022-03-28 18:52:46 +0530939
Rushabh Mehta793ba6b2014-02-14 15:47:51 +0530940@frappe.whitelist()
Rohit Waghchaure2a14f252021-07-30 12:36:35 +0530941def get_company_default(company, fieldname, ignore_validation=False):
Ankush Menat494bd9e2022-03-28 18:52:46 +0530942 value = frappe.get_cached_value("Company", company, fieldname)
Anand Doshicd71e1d2014-04-08 13:53:35 +0530943
Rohit Waghchaure2a14f252021-07-30 12:36:35 +0530944 if not ignore_validation and not value:
Ankush Menat494bd9e2022-03-28 18:52:46 +0530945 throw(
946 _("Please set default {0} in Company {1}").format(
947 frappe.get_meta("Company").get_label(fieldname), company
948 )
949 )
Anand Doshicd71e1d2014-04-08 13:53:35 +0530950
Nabin Hait0fc24542013-03-25 11:06:00 +0530951 return value
Nabin Hait8b509f52013-05-28 16:52:30 +0530952
Ankush Menat494bd9e2022-03-28 18:52:46 +0530953
Nabin Hait8b509f52013-05-28 16:52:30 +0530954def fix_total_debit_credit():
Ankush Menat494bd9e2022-03-28 18:52:46 +0530955 vouchers = frappe.db.sql(
956 """select voucher_type, voucher_no,
Anand Doshicd71e1d2014-04-08 13:53:35 +0530957 sum(debit) - sum(credit) as diff
958 from `tabGL Entry`
Nabin Hait8b509f52013-05-28 16:52:30 +0530959 group by voucher_type, voucher_no
Ankush Menat494bd9e2022-03-28 18:52:46 +0530960 having sum(debit) != sum(credit)""",
961 as_dict=1,
962 )
Anand Doshicd71e1d2014-04-08 13:53:35 +0530963
Nabin Hait8b509f52013-05-28 16:52:30 +0530964 for d in vouchers:
965 if abs(d.diff) > 0:
966 dr_or_cr = d.voucher_type == "Sales Invoice" and "credit" or "debit"
Anand Doshicd71e1d2014-04-08 13:53:35 +0530967
Ankush Menat494bd9e2022-03-28 18:52:46 +0530968 frappe.db.sql(
969 """update `tabGL Entry` set %s = %s + %s
970 where voucher_type = %s and voucher_no = %s and %s > 0 limit 1"""
971 % (dr_or_cr, dr_or_cr, "%s", "%s", "%s", dr_or_cr),
972 (d.diff, d.voucher_type, d.voucher_no),
973 )
974
Anand Doshicd71e1d2014-04-08 13:53:35 +0530975
Rushabh Mehtad50da782017-07-28 11:39:01 +0530976def get_currency_precision():
Nabin Hait9b20e072017-04-25 12:10:24 +0530977 precision = cint(frappe.db.get_default("currency_precision"))
978 if not precision:
979 number_format = frappe.db.get_default("number_format") or "#,###.##"
980 precision = get_number_format_info(number_format)[2]
Rushabh Mehtad50da782017-07-28 11:39:01 +0530981
Nabin Hait9b20e072017-04-25 12:10:24 +0530982 return precision
Rushabh Mehtad50da782017-07-28 11:39:01 +0530983
Nabin Hait9a0c46f2014-08-07 15:10:05 +0530984
tundebabzyad08d4c2018-05-16 07:01:41 +0100985def get_held_invoices(party_type, party):
986 """
987 Returns a list of names Purchase Invoices for the given party that are on hold
988 """
989 held_invoices = None
990
Ankush Menat494bd9e2022-03-28 18:52:46 +0530991 if party_type == "Supplier":
tundebabzyad08d4c2018-05-16 07:01:41 +0100992 held_invoices = frappe.db.sql(
mergify[bot]872a23c2023-07-10 20:34:54 +0530993 "select name from `tabPurchase Invoice` where on_hold = 1 and release_date IS NOT NULL and release_date > CURDATE()",
Ankush Menat494bd9e2022-03-28 18:52:46 +0530994 as_dict=1,
tundebabzyad08d4c2018-05-16 07:01:41 +0100995 )
Ankush Menat494bd9e2022-03-28 18:52:46 +0530996 held_invoices = set(d["name"] for d in held_invoices)
tundebabzyad08d4c2018-05-16 07:01:41 +0100997
998 return held_invoices
999
1000
ruthra kumar8c876742022-06-14 17:46:04 +05301001def get_outstanding_invoices(
ruthra kumar5f1562c2022-07-28 11:57:27 +05301002 party_type,
1003 party,
1004 account,
1005 common_filter=None,
1006 posting_date=None,
1007 min_outstanding=None,
1008 max_outstanding=None,
ruthra kumar6d9d7302022-12-14 16:05:15 +05301009 accounting_dimensions=None,
Deepesh Garg299e32b2023-08-24 18:02:06 +05301010 vouchers=None, # list of dicts [{'voucher_type': '', 'voucher_no': ''}] for filtering
1011 limit=None, # passed by reconciliation tool
1012 voucher_no=None, # filter passed by reconciliation tool
ruthra kumar8c876742022-06-14 17:46:04 +05301013):
1014
1015 ple = qb.DocType("Payment Ledger Entry")
Anand Doshid40d1e92015-11-12 17:05:29 +05301016 outstanding_invoices = []
Nabin Haitac184982019-02-04 21:13:43 +05301017 precision = frappe.get_precision("Sales Invoice", "outstanding_amount") or 2
Anand Doshid40d1e92015-11-12 17:05:29 +05301018
Nabin Hait9db9edc2019-11-19 18:44:32 +05301019 if account:
Ankush Menat494bd9e2022-03-28 18:52:46 +05301020 root_type, account_type = frappe.get_cached_value(
1021 "Account", account, ["root_type", "account_type"]
1022 )
Nabin Hait9db9edc2019-11-19 18:44:32 +05301023 party_account_type = "Receivable" if root_type == "Asset" else "Payable"
Saqib9291df42020-01-24 16:22:49 +05301024 party_account_type = account_type or party_account_type
Nabin Hait9db9edc2019-11-19 18:44:32 +05301025 else:
1026 party_account_type = erpnext.get_party_account_type(party_type)
1027
tundebabzyad08d4c2018-05-16 07:01:41 +01001028 held_invoices = get_held_invoices(party_type, party)
1029
ruthra kumar8c876742022-06-14 17:46:04 +05301030 common_filter = common_filter or []
1031 common_filter.append(ple.account_type == party_account_type)
1032 common_filter.append(ple.account == account)
1033 common_filter.append(ple.party_type == party_type)
1034 common_filter.append(ple.party == party)
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301035
ruthra kumar8c876742022-06-14 17:46:04 +05301036 ple_query = QueryPaymentLedger()
1037 invoice_list = ple_query.get_voucher_outstandings(
ruthra kumardeb0d712023-08-15 05:17:01 +05301038 vouchers=vouchers,
ruthra kumar8c876742022-06-14 17:46:04 +05301039 common_filter=common_filter,
ruthra kumar5f1562c2022-07-28 11:57:27 +05301040 posting_date=posting_date,
ruthra kumar8c876742022-06-14 17:46:04 +05301041 min_outstanding=min_outstanding,
1042 max_outstanding=max_outstanding,
1043 get_invoices=True,
ruthra kumar6d9d7302022-12-14 16:05:15 +05301044 accounting_dimensions=accounting_dimensions or [],
ruthra kumar7a381af2023-05-03 20:45:12 +05301045 limit=limit,
1046 voucher_no=voucher_no,
Ankush Menat494bd9e2022-03-28 18:52:46 +05301047 )
tundec4b0d172017-09-26 00:48:30 +01001048
Nabin Haitac184982019-02-04 21:13:43 +05301049 for d in invoice_list:
ruthra kumar21985532022-06-30 15:14:38 +05301050 payment_amount = d.invoice_amount_in_account_currency - d.outstanding_in_account_currency
1051 outstanding_amount = d.outstanding_in_account_currency
Nabin Haitac184982019-02-04 21:13:43 +05301052 if outstanding_amount > 0.5 / (10**precision):
Ankush Menat494bd9e2022-03-28 18:52:46 +05301053 if (
ruthra kumar8c876742022-06-14 17:46:04 +05301054 min_outstanding
1055 and max_outstanding
barredterraeb9ee3f2023-12-05 11:22:55 +01001056 and (outstanding_amount < min_outstanding or outstanding_amount > max_outstanding)
Ankush Menat494bd9e2022-03-28 18:52:46 +05301057 ):
Rohit Waghchaure0f065d52019-05-02 00:06:04 +05301058 continue
Nabin Haitac184982019-02-04 21:13:43 +05301059
barredterraeb9ee3f2023-12-05 11:22:55 +01001060 if d.voucher_type != "Purchase Invoice" or d.voucher_no not in held_invoices:
Nabin Haitac184982019-02-04 21:13:43 +05301061 outstanding_invoices.append(
Ankush Menat494bd9e2022-03-28 18:52:46 +05301062 frappe._dict(
1063 {
1064 "voucher_no": d.voucher_no,
1065 "voucher_type": d.voucher_type,
1066 "posting_date": d.posting_date,
ruthra kumar21985532022-06-30 15:14:38 +05301067 "invoice_amount": flt(d.invoice_amount_in_account_currency),
Ankush Menat494bd9e2022-03-28 18:52:46 +05301068 "payment_amount": payment_amount,
1069 "outstanding_amount": outstanding_amount,
1070 "due_date": d.due_date,
1071 "currency": d.currency,
Gursheen Anand4ee16372023-06-08 13:15:23 +05301072 "account": d.account,
Ankush Menat494bd9e2022-03-28 18:52:46 +05301073 }
1074 )
Nabin Haitac184982019-02-04 21:13:43 +05301075 )
Rushabh Mehtae9d9b8e2016-12-15 11:27:35 +05301076
Ankush Menat494bd9e2022-03-28 18:52:46 +05301077 outstanding_invoices = sorted(
1078 outstanding_invoices, key=lambda k: k["due_date"] or getdate(nowdate())
1079 )
Anand Doshid40d1e92015-11-12 17:05:29 +05301080 return outstanding_invoices
Saurabh3a268292016-02-22 15:18:40 +05301081
1082
Ankush Menat494bd9e2022-03-28 18:52:46 +05301083def get_account_name(
1084 account_type=None, root_type=None, is_group=None, account_currency=None, company=None
1085):
Saurabh3a268292016-02-22 15:18:40 +05301086 """return account based on matching conditions"""
Ankush Menat494bd9e2022-03-28 18:52:46 +05301087 return frappe.db.get_value(
1088 "Account",
1089 {
1090 "account_type": account_type or "",
1091 "root_type": root_type or "",
1092 "is_group": is_group or 0,
1093 "account_currency": account_currency or frappe.defaults.get_defaults().currency,
1094 "company": company or frappe.defaults.get_defaults().company,
1095 },
1096 "name",
1097 )
1098
Saurabha9ba7342016-06-21 12:33:12 +05301099
1100@frappe.whitelist()
1101def get_companies():
1102 """get a list of companies based on permission"""
Ankush Menat494bd9e2022-03-28 18:52:46 +05301103 return [d.name for d in frappe.get_list("Company", fields=["name"], order_by="name")]
1104
Saurabha9ba7342016-06-21 12:33:12 +05301105
1106@frappe.whitelist()
Gursheen Kaur Anandb7f283b2023-12-29 12:55:37 +05301107def get_children(doctype, parent, company, is_root=False, include_disabled=False):
1108 if isinstance(include_disabled, str):
1109 include_disabled = frappe.json.loads(include_disabled)
Nabin Haitaf98f5d2018-04-02 10:14:32 +05301110 from erpnext.accounts.report.financial_statements import sort_accounts
Rushabh Mehtad50da782017-07-28 11:39:01 +05301111
Ankush Menat494bd9e2022-03-28 18:52:46 +05301112 parent_fieldname = "parent_" + doctype.lower().replace(" ", "_")
1113 fields = ["name as value", "is_group as expandable"]
1114 filters = [["docstatus", "<", 2]]
Gursheen Kaur Anandb7f283b2023-12-29 12:55:37 +05301115 if frappe.db.has_column(doctype, "disabled") and not include_disabled:
1116 filters.append(["disabled", "=", False])
Suraj Shettyfbb6b3d2018-05-16 13:53:31 +05301117
Ankush Menat494bd9e2022-03-28 18:52:46 +05301118 filters.append(['ifnull(`{0}`,"")'.format(parent_fieldname), "=", "" if is_root else parent])
Suraj Shetty084b0b32018-05-26 09:12:59 +05301119
Rushabh Mehta43133262017-11-10 18:52:21 +05301120 if is_root:
Ankush Menat494bd9e2022-03-28 18:52:46 +05301121 fields += ["root_type", "report_type", "account_currency"] if doctype == "Account" else []
1122 filters.append(["company", "=", company])
Suraj Shetty084b0b32018-05-26 09:12:59 +05301123
Saurabha9ba7342016-06-21 12:33:12 +05301124 else:
Ankush Menat494bd9e2022-03-28 18:52:46 +05301125 fields += ["root_type", "account_currency"] if doctype == "Account" else []
1126 fields += [parent_fieldname + " as parent"]
Suraj Shetty084b0b32018-05-26 09:12:59 +05301127
1128 acc = frappe.get_list(doctype, fields=fields, filters=filters)
Saurabha9ba7342016-06-21 12:33:12 +05301129
Ankush Menat494bd9e2022-03-28 18:52:46 +05301130 if doctype == "Account":
Nabin Haitaf98f5d2018-04-02 10:14:32 +05301131 sort_accounts(acc, is_root, key="value")
Saurabha9ba7342016-06-21 12:33:12 +05301132
1133 return acc
Saurabhb835fef2016-09-09 11:19:22 +05301134
Ankush Menat494bd9e2022-03-28 18:52:46 +05301135
Saqib90517352021-10-04 11:44:46 +05301136@frappe.whitelist()
1137def get_account_balances(accounts, company):
1138
Ankush Menat8fe5feb2021-11-04 19:48:32 +05301139 if isinstance(accounts, str):
Saqib90517352021-10-04 11:44:46 +05301140 accounts = loads(accounts)
1141
1142 if not accounts:
1143 return []
1144
Ankush Menat494bd9e2022-03-28 18:52:46 +05301145 company_currency = frappe.get_cached_value("Company", company, "default_currency")
Saqib90517352021-10-04 11:44:46 +05301146
1147 for account in accounts:
1148 account["company_currency"] = company_currency
Ankush Menat494bd9e2022-03-28 18:52:46 +05301149 account["balance"] = flt(
1150 get_balance_on(account["value"], in_account_currency=False, company=company)
1151 )
Saqib90517352021-10-04 11:44:46 +05301152 if account["account_currency"] and account["account_currency"] != company_currency:
1153 account["balance_in_account_currency"] = flt(get_balance_on(account["value"], company=company))
1154
1155 return accounts
1156
Ankush Menat494bd9e2022-03-28 18:52:46 +05301157
Mangesh-Khairnar97ab96c2020-09-22 12:58:32 +05301158def create_payment_gateway_account(gateway, payment_channel="Email"):
Deepesh Garga72589c2021-05-29 23:54:51 +05301159 from erpnext.setup.setup_wizard.operations.install_fixtures import create_bank_account
Saurabhb835fef2016-09-09 11:19:22 +05301160
Daizy Modifdfe5cb2022-11-17 19:14:10 +05301161 company = frappe.get_cached_value("Global Defaults", "Global Defaults", "default_company")
Saurabhb835fef2016-09-09 11:19:22 +05301162 if not company:
1163 return
1164
1165 # NOTE: we translate Payment Gateway account name because that is going to be used by the end user
Ankush Menat494bd9e2022-03-28 18:52:46 +05301166 bank_account = frappe.db.get_value(
1167 "Account",
1168 {"account_name": _(gateway), "company": company},
1169 ["name", "account_currency"],
1170 as_dict=1,
1171 )
Saurabhb835fef2016-09-09 11:19:22 +05301172
1173 if not bank_account:
1174 # check for untranslated one
Ankush Menat494bd9e2022-03-28 18:52:46 +05301175 bank_account = frappe.db.get_value(
1176 "Account",
1177 {"account_name": gateway, "company": company},
1178 ["name", "account_currency"],
1179 as_dict=1,
1180 )
Saurabhb835fef2016-09-09 11:19:22 +05301181
1182 if not bank_account:
1183 # try creating one
1184 bank_account = create_bank_account({"company_name": company, "bank_account": _(gateway)})
1185
1186 if not bank_account:
1187 frappe.msgprint(_("Payment Gateway Account not created, please create one manually."))
1188 return
1189
1190 # if payment gateway account exists, return
Ankush Menat494bd9e2022-03-28 18:52:46 +05301191 if frappe.db.exists(
1192 "Payment Gateway Account",
1193 {"payment_gateway": gateway, "currency": bank_account.account_currency},
1194 ):
Saurabhb835fef2016-09-09 11:19:22 +05301195 return
1196
1197 try:
Ankush Menat494bd9e2022-03-28 18:52:46 +05301198 frappe.get_doc(
1199 {
1200 "doctype": "Payment Gateway Account",
1201 "is_default": 1,
1202 "payment_gateway": gateway,
1203 "payment_account": bank_account.name,
1204 "currency": bank_account.account_currency,
1205 "payment_channel": payment_channel,
1206 }
1207 ).insert(ignore_permissions=True, ignore_if_duplicate=True)
Saurabhb835fef2016-09-09 11:19:22 +05301208
1209 except frappe.DuplicateEntryError:
1210 # already exists, due to a reinstall?
cclauss68487082017-07-27 07:08:35 +02001211 pass
Zarrar44175902018-06-08 16:35:21 +05301212
Ankush Menat494bd9e2022-03-28 18:52:46 +05301213
Zarrar44175902018-06-08 16:35:21 +05301214@frappe.whitelist()
Deepesh Garg817cbc42020-06-15 12:07:04 +05301215def update_cost_center(docname, cost_center_name, cost_center_number, company, merge):
Ankush Menat494bd9e2022-03-28 18:52:46 +05301216 """
1217 Renames the document by adding the number as a prefix to the current name and updates
1218 all transaction where it was present.
1219 """
Saqiba8779872020-04-30 11:28:43 +05301220 validate_field_number("Cost Center", docname, cost_center_number, company, "cost_center_number")
Zarrar44175902018-06-08 16:35:21 +05301221
Saqiba8779872020-04-30 11:28:43 +05301222 if cost_center_number:
1223 frappe.db.set_value("Cost Center", docname, "cost_center_number", cost_center_number.strip())
1224 else:
1225 frappe.db.set_value("Cost Center", docname, "cost_center_number", "")
Zarrar44175902018-06-08 16:35:21 +05301226
Saqiba8779872020-04-30 11:28:43 +05301227 frappe.db.set_value("Cost Center", docname, "cost_center_name", cost_center_name.strip())
Zarrar44175902018-06-08 16:35:21 +05301228
Nabin Haitaf21a112022-09-15 12:09:18 +05301229 new_name = get_autoname_with_number(cost_center_number, cost_center_name, company)
Saqiba8779872020-04-30 11:28:43 +05301230 if docname != new_name:
Deepesh Garg817cbc42020-06-15 12:07:04 +05301231 frappe.rename_doc("Cost Center", docname, new_name, force=1, merge=merge)
Zarrar44175902018-06-08 16:35:21 +05301232 return new_name
1233
Ankush Menat494bd9e2022-03-28 18:52:46 +05301234
Saqiba8779872020-04-30 11:28:43 +05301235def validate_field_number(doctype_name, docname, number_value, company, field_name):
Ankush Menat494bd9e2022-03-28 18:52:46 +05301236 """Validate if the number entered isn't already assigned to some other document."""
Zlash651aeca1d2018-07-06 17:15:33 +05301237 if number_value:
Saqiba8779872020-04-30 11:28:43 +05301238 filters = {field_name: number_value, "name": ["!=", docname]}
Zarrar44175902018-06-08 16:35:21 +05301239 if company:
Saqiba8779872020-04-30 11:28:43 +05301240 filters["company"] = company
1241
1242 doctype_with_same_number = frappe.db.get_value(doctype_name, filters)
1243
Zarrar44175902018-06-08 16:35:21 +05301244 if doctype_with_same_number:
Ankush Menat494bd9e2022-03-28 18:52:46 +05301245 frappe.throw(
1246 _("{0} Number {1} is already used in {2} {3}").format(
1247 doctype_name, number_value, doctype_name.lower(), doctype_with_same_number
1248 )
1249 )
1250
Zarrar44175902018-06-08 16:35:21 +05301251
Nabin Haitaf21a112022-09-15 12:09:18 +05301252def get_autoname_with_number(number_value, doc_title, company):
Ankush Menat494bd9e2022-03-28 18:52:46 +05301253 """append title with prefix as number and suffix as company's abbreviation separated by '-'"""
Nabin Haitaf21a112022-09-15 12:09:18 +05301254 company_abbr = frappe.get_cached_value("Company", company, "abbr")
1255 parts = [doc_title.strip(), company_abbr]
1256
Zlash651aeca1d2018-07-06 17:15:33 +05301257 if cstr(number_value).strip():
1258 parts.insert(0, cstr(number_value).strip())
Nabin Haitaf21a112022-09-15 12:09:18 +05301259
Ankush Menat494bd9e2022-03-28 18:52:46 +05301260 return " - ".join(parts)
1261
Zarrar254ce642018-06-28 14:15:34 +05301262
Deepesh Garg62706072023-07-16 12:58:42 +05301263def parse_naming_series_variable(doc, variable):
1264 if variable == "FY":
Gughan Ravikumar89d109e2023-07-27 23:12:11 +05301265 if doc:
Gursheen Anandd96a7772024-01-10 22:05:02 +05301266 date = doc.get("posting_date") or doc.get("transaction_date") or getdate()
Gughan Ravikumar89d109e2023-07-27 23:12:11 +05301267 company = doc.get("company")
1268 else:
1269 date = getdate()
1270 company = None
Gughan Ravikumarcdf100d2023-08-15 09:38:29 +05301271 return get_fiscal_year(date=date, company=company)[0]
Deepesh Garg62706072023-07-16 12:58:42 +05301272
1273
Zarrar254ce642018-06-28 14:15:34 +05301274@frappe.whitelist()
David Arnoldd066b5c2023-07-23 22:43:41 -05001275def get_coa(doctype, parent, is_root=None, chart=None):
Chillar Anand915b3432021-09-02 16:44:59 +05301276 from erpnext.accounts.doctype.account.chart_of_accounts.chart_of_accounts import (
1277 build_tree_from_json,
1278 )
Zarrar254ce642018-06-28 14:15:34 +05301279
1280 # add chart to flags to retrieve when called from expand all function
1281 chart = chart if chart else frappe.flags.chart
1282 frappe.flags.chart = chart
1283
Ankush Menat494bd9e2022-03-28 18:52:46 +05301284 parent = None if parent == _("All Accounts") else parent
1285 accounts = build_tree_from_json(chart) # returns alist of dict in a tree render-able form
Zarrar254ce642018-06-28 14:15:34 +05301286
1287 # filter out to show data for the selected node only
Ankush Menat494bd9e2022-03-28 18:52:46 +05301288 accounts = [d for d in accounts if d["parent_account"] == parent]
Zarrar254ce642018-06-28 14:15:34 +05301289
1290 return accounts
Sanjay Kumar1b49f3a2018-09-06 13:09:35 +04001291
Ankush Menat494bd9e2022-03-28 18:52:46 +05301292
1293def update_gl_entries_after(
1294 posting_date,
1295 posting_time,
1296 for_warehouses=None,
1297 for_items=None,
1298 warehouse_account=None,
1299 company=None,
1300):
1301 stock_vouchers = get_future_stock_vouchers(
1302 posting_date, posting_time, for_warehouses, for_items, company
1303 )
Nabin Hait9b178bc2021-02-16 14:57:00 +05301304 repost_gle_for_stock_vouchers(stock_vouchers, posting_date, company, warehouse_account)
1305
1306
Ankush Menat494bd9e2022-03-28 18:52:46 +05301307def repost_gle_for_stock_vouchers(
Ankush Menat2535d5e2022-06-14 18:20:33 +05301308 stock_vouchers: List[Tuple[str, str]],
1309 posting_date: str,
1310 company: Optional[str] = None,
1311 warehouse_account=None,
1312 repost_doc: Optional["RepostItemValuation"] = None,
Ankush Menat494bd9e2022-03-28 18:52:46 +05301313):
Ankush Menat67c26322022-06-04 14:46:35 +05301314
1315 from erpnext.accounts.general_ledger import toggle_debit_credit_if_negative
1316
Ankush Menat700e8642022-04-19 13:24:29 +05301317 if not stock_vouchers:
1318 return
1319
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301320 if not warehouse_account:
1321 warehouse_account = get_warehouse_account_map(company)
1322
Ankush Menat2535d5e2022-06-14 18:20:33 +05301323 stock_vouchers = sort_stock_vouchers_by_posting_date(stock_vouchers)
1324 if repost_doc and repost_doc.gl_reposting_index:
1325 # Restore progress
1326 stock_vouchers = stock_vouchers[cint(repost_doc.gl_reposting_index) :]
1327
Rohit Waghchaurebc8c9de2021-02-23 17:50:49 +05301328 precision = get_field_precision(frappe.get_meta("GL Entry").get_field("debit")) or 2
1329
Ankush Menat5c6f22f2022-06-15 19:30:26 +05301330 for stock_vouchers_chunk in create_batch(stock_vouchers, GL_REPOSTING_CHUNK):
Ankush Menat2535d5e2022-06-14 18:20:33 +05301331 gle = get_voucherwise_gl_entries(stock_vouchers_chunk, posting_date)
1332
1333 for voucher_type, voucher_no in stock_vouchers_chunk:
1334 existing_gle = gle.get((voucher_type, voucher_no), [])
1335 voucher_obj = frappe.get_doc(voucher_type, voucher_no)
1336 # Some transactions post credit as negative debit, this is handled while posting GLE
1337 # but while comparing we need to make sure it's flipped so comparisons are accurate
1338 expected_gle = toggle_debit_credit_if_negative(voucher_obj.get_gl_entries(warehouse_account))
1339 if expected_gle:
1340 if not existing_gle or not compare_existing_and_expected_gle(
1341 existing_gle, expected_gle, precision
1342 ):
ruthra kumar9209ec52022-10-21 15:18:40 +05301343 _delete_accounting_ledger_entries(voucher_type, voucher_no)
Ankush Menat2535d5e2022-06-14 18:20:33 +05301344 voucher_obj.make_gl_entries(gl_entries=expected_gle, from_repost=True)
1345 else:
ruthra kumar9209ec52022-10-21 15:18:40 +05301346 _delete_accounting_ledger_entries(voucher_type, voucher_no)
Ankush Menat86919d22022-06-15 21:19:09 +05301347
1348 if not frappe.flags.in_test:
1349 frappe.db.commit()
Ankush Menat2535d5e2022-06-14 18:20:33 +05301350
1351 if repost_doc:
1352 repost_doc.db_set(
1353 "gl_reposting_index",
Ankush Menat5c6f22f2022-06-15 19:30:26 +05301354 cint(repost_doc.gl_reposting_index) + len(stock_vouchers_chunk),
Ankush Menat2535d5e2022-06-14 18:20:33 +05301355 )
1356
1357
ruthra kumar9209ec52022-10-21 15:18:40 +05301358def _delete_pl_entries(voucher_type, voucher_no):
ruthra kumar65992302022-10-04 16:17:56 +05301359 ple = qb.DocType("Payment Ledger Entry")
1360 qb.from_(ple).delete().where(
1361 (ple.voucher_type == voucher_type) & (ple.voucher_no == voucher_no)
1362 ).run()
Ankush Menateb53a972022-06-04 18:19:44 +05301363
Ankush Menat494bd9e2022-03-28 18:52:46 +05301364
ruthra kumar9209ec52022-10-21 15:18:40 +05301365def _delete_gl_entries(voucher_type, voucher_no):
1366 gle = qb.DocType("GL Entry")
1367 qb.from_(gle).delete().where(
1368 (gle.voucher_type == voucher_type) & (gle.voucher_no == voucher_no)
1369 ).run()
1370
1371
1372def _delete_accounting_ledger_entries(voucher_type, voucher_no):
1373 """
1374 Remove entries from both General and Payment Ledger for specified Voucher
1375 """
1376 _delete_gl_entries(voucher_type, voucher_no)
1377 _delete_pl_entries(voucher_type, voucher_no)
1378
1379
Ankush Menat700e8642022-04-19 13:24:29 +05301380def sort_stock_vouchers_by_posting_date(
1381 stock_vouchers: List[Tuple[str, str]]
1382) -> List[Tuple[str, str]]:
1383 sle = frappe.qb.DocType("Stock Ledger Entry")
1384 voucher_nos = [v[1] for v in stock_vouchers]
1385
1386 sles = (
1387 frappe.qb.from_(sle)
1388 .select(sle.voucher_type, sle.voucher_no, sle.posting_date, sle.posting_time, sle.creation)
1389 .where((sle.is_cancelled == 0) & (sle.voucher_no.isin(voucher_nos)))
1390 .groupby(sle.voucher_type, sle.voucher_no)
Rohit Waghchaured80ca522024-02-07 21:56:21 +05301391 .orderby(sle.posting_datetime)
Ankush Menat2535d5e2022-06-14 18:20:33 +05301392 .orderby(sle.creation)
Ankush Menat700e8642022-04-19 13:24:29 +05301393 ).run(as_dict=True)
1394 sorted_vouchers = [(sle.voucher_type, sle.voucher_no) for sle in sles]
1395
1396 unknown_vouchers = set(stock_vouchers) - set(sorted_vouchers)
1397 if unknown_vouchers:
1398 sorted_vouchers.extend(unknown_vouchers)
1399
1400 return sorted_vouchers
1401
1402
Ankush Menat494bd9e2022-03-28 18:52:46 +05301403def get_future_stock_vouchers(
1404 posting_date, posting_time, for_warehouses=None, for_items=None, company=None
1405):
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301406
1407 values = []
1408 condition = ""
1409 if for_items:
1410 condition += " and item_code in ({})".format(", ".join(["%s"] * len(for_items)))
1411 values += for_items
1412
1413 if for_warehouses:
1414 condition += " and warehouse in ({})".format(", ".join(["%s"] * len(for_warehouses)))
1415 values += for_warehouses
1416
rohitwaghchaured60ff832021-02-16 09:12:27 +05301417 if company:
Nabin Hait9b178bc2021-02-16 14:57:00 +05301418 condition += " and company = %s"
rohitwaghchaured60ff832021-02-16 09:12:27 +05301419 values.append(company)
1420
Ankush Menat494bd9e2022-03-28 18:52:46 +05301421 future_stock_vouchers = frappe.db.sql(
1422 """select distinct sle.voucher_type, sle.voucher_no
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301423 from `tabStock Ledger Entry` sle
Nabin Haita77b8c92020-12-21 14:45:50 +05301424 where
1425 timestamp(sle.posting_date, sle.posting_time) >= timestamp(%s, %s)
1426 and is_cancelled = 0
1427 {condition}
Ankush Menat494bd9e2022-03-28 18:52:46 +05301428 order by timestamp(sle.posting_date, sle.posting_time) asc, creation asc for update""".format(
1429 condition=condition
1430 ),
1431 tuple([posting_date, posting_time] + values),
1432 as_dict=True,
1433 )
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301434
Ankush91527152021-08-11 11:17:50 +05301435 return [(d.voucher_type, d.voucher_no) for d in future_stock_vouchers]
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301436
Ankush Menat494bd9e2022-03-28 18:52:46 +05301437
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301438def get_voucherwise_gl_entries(future_stock_vouchers, posting_date):
Ankush Menat494bd9e2022-03-28 18:52:46 +05301439 """Get voucherwise list of GL entries.
Ankush91527152021-08-11 11:17:50 +05301440
1441 Only fetches GLE fields required for comparing with new GLE.
1442 Check compare_existing_and_expected_gle function below.
rohitwaghchaure058d9832021-09-07 12:14:40 +05301443
1444 returns:
Ankush Menat494bd9e2022-03-28 18:52:46 +05301445 Dict[Tuple[voucher_type, voucher_no], List[GL Entries]]
Ankush91527152021-08-11 11:17:50 +05301446 """
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301447 gl_entries = {}
Ankush91527152021-08-11 11:17:50 +05301448 if not future_stock_vouchers:
1449 return gl_entries
1450
1451 voucher_nos = [d[1] for d in future_stock_vouchers]
1452
Ankush Menat494bd9e2022-03-28 18:52:46 +05301453 gles = frappe.db.sql(
1454 """
rohitwaghchaure058d9832021-09-07 12:14:40 +05301455 select name, account, credit, debit, cost_center, project, voucher_type, voucher_no
Ankush91527152021-08-11 11:17:50 +05301456 from `tabGL Entry`
1457 where
Ankush Menat494bd9e2022-03-28 18:52:46 +05301458 posting_date >= %s and voucher_no in (%s)"""
1459 % ("%s", ", ".join(["%s"] * len(voucher_nos))),
1460 tuple([posting_date] + voucher_nos),
1461 as_dict=1,
1462 )
Ankush91527152021-08-11 11:17:50 +05301463
1464 for d in gles:
1465 gl_entries.setdefault((d.voucher_type, d.voucher_no), []).append(d)
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301466
Prssanna Desai82ddef52020-06-18 18:18:41 +05301467 return gl_entries
Nabin Haita77b8c92020-12-21 14:45:50 +05301468
Ankush Menat494bd9e2022-03-28 18:52:46 +05301469
Rohit Waghchaurebc8c9de2021-02-23 17:50:49 +05301470def compare_existing_and_expected_gle(existing_gle, expected_gle, precision):
Ankush91527152021-08-11 11:17:50 +05301471 if len(existing_gle) != len(expected_gle):
1472 return False
1473
Nabin Haita77b8c92020-12-21 14:45:50 +05301474 matched = True
1475 for entry in expected_gle:
1476 account_existed = False
1477 for e in existing_gle:
1478 if entry.account == e.account:
1479 account_existed = True
Ankush Menat494bd9e2022-03-28 18:52:46 +05301480 if (
1481 entry.account == e.account
1482 and (not entry.cost_center or not e.cost_center or entry.cost_center == e.cost_center)
1483 and (
1484 flt(entry.debit, precision) != flt(e.debit, precision)
1485 or flt(entry.credit, precision) != flt(e.credit, precision)
1486 )
1487 ):
Nabin Haita77b8c92020-12-21 14:45:50 +05301488 matched = False
1489 break
1490 if not account_existed:
1491 matched = False
1492 break
Nabin Haitb99c77b2020-12-25 18:12:35 +05301493 return matched
1494
Ankush Menat494bd9e2022-03-28 18:52:46 +05301495
Nabin Haitb99c77b2020-12-25 18:12:35 +05301496def get_stock_accounts(company, voucher_type=None, voucher_no=None):
Ankush Menat494bd9e2022-03-28 18:52:46 +05301497 stock_accounts = [
1498 d.name
1499 for d in frappe.db.get_all(
1500 "Account", {"account_type": "Stock", "company": company, "is_group": 0}
1501 )
1502 ]
Nabin Haitb99c77b2020-12-25 18:12:35 +05301503 if voucher_type and voucher_no:
1504 if voucher_type == "Journal Entry":
Ankush Menat494bd9e2022-03-28 18:52:46 +05301505 stock_accounts = [
1506 d.account
1507 for d in frappe.db.get_all(
1508 "Journal Entry Account", {"parent": voucher_no, "account": ["in", stock_accounts]}, "account"
1509 )
1510 ]
Nabin Haitb99c77b2020-12-25 18:12:35 +05301511
1512 else:
Ankush Menat494bd9e2022-03-28 18:52:46 +05301513 stock_accounts = [
1514 d.account
1515 for d in frappe.db.get_all(
1516 "GL Entry",
1517 {"voucher_type": voucher_type, "voucher_no": voucher_no, "account": ["in", stock_accounts]},
1518 "account",
1519 )
1520 ]
Nabin Haitb99c77b2020-12-25 18:12:35 +05301521
1522 return stock_accounts
1523
Ankush Menat494bd9e2022-03-28 18:52:46 +05301524
Nabin Haitb99c77b2020-12-25 18:12:35 +05301525def get_stock_and_account_balance(account=None, posting_date=None, company=None):
Ankush Menat494bd9e2022-03-28 18:52:46 +05301526 if not posting_date:
1527 posting_date = nowdate()
Nabin Haitb99c77b2020-12-25 18:12:35 +05301528
1529 warehouse_account = get_warehouse_account_map(company)
1530
Ankush Menat494bd9e2022-03-28 18:52:46 +05301531 account_balance = get_balance_on(
1532 account, posting_date, in_account_currency=False, ignore_account_permission=True
1533 )
Nabin Haitb99c77b2020-12-25 18:12:35 +05301534
Ankush Menat494bd9e2022-03-28 18:52:46 +05301535 related_warehouses = [
1536 wh
1537 for wh, wh_details in warehouse_account.items()
1538 if wh_details.account == account and not wh_details.is_group
1539 ]
Nabin Haitb99c77b2020-12-25 18:12:35 +05301540
s-aga-re782a052023-04-25 13:54:36 +05301541 total_stock_value = get_stock_value_on(related_warehouses, posting_date)
Nabin Haitb99c77b2020-12-25 18:12:35 +05301542
1543 precision = frappe.get_precision("Journal Entry Account", "debit_in_account_currency")
1544 return flt(account_balance, precision), flt(total_stock_value, precision), related_warehouses
1545
Ankush Menat494bd9e2022-03-28 18:52:46 +05301546
Nabin Haitb99c77b2020-12-25 18:12:35 +05301547def get_journal_entry(account, stock_adjustment_account, amount):
Ankush Menat494bd9e2022-03-28 18:52:46 +05301548 db_or_cr_warehouse_account = (
1549 "credit_in_account_currency" if amount < 0 else "debit_in_account_currency"
1550 )
1551 db_or_cr_stock_adjustment_account = (
1552 "debit_in_account_currency" if amount < 0 else "credit_in_account_currency"
1553 )
Nabin Haitb99c77b2020-12-25 18:12:35 +05301554
1555 return {
Ankush Menat494bd9e2022-03-28 18:52:46 +05301556 "accounts": [
1557 {"account": account, db_or_cr_warehouse_account: abs(amount)},
1558 {"account": stock_adjustment_account, db_or_cr_stock_adjustment_account: abs(amount)},
1559 ]
Nabin Haitb99c77b2020-12-25 18:12:35 +05301560 }
Shadrak Gurupnor74337572021-08-27 18:00:16 +05301561
Ankush Menat494bd9e2022-03-28 18:52:46 +05301562
Shadrak Gurupnor74337572021-08-27 18:00:16 +05301563def check_and_delete_linked_reports(report):
Ankush Menat494bd9e2022-03-28 18:52:46 +05301564 """Check if reports are referenced in Desktop Icon"""
1565 icons = frappe.get_all("Desktop Icon", fields=["name"], filters={"_report": report})
Shadrak Gurupnor74337572021-08-27 18:00:16 +05301566 if icons:
1567 for icon in icons:
1568 frappe.delete_doc("Desktop Icon", icon)
ruthra kumar451cf3a2022-05-16 14:29:58 +05301569
1570
ruthra kumar4f51c5a2023-07-03 14:35:33 +05301571def create_err_and_its_journals(companies: list = None) -> None:
1572 if companies:
1573 for company in companies:
1574 err = frappe.new_doc("Exchange Rate Revaluation")
1575 err.company = company.name
1576 err.posting_date = nowdate()
1577 err.rounding_loss_allowance = 0.0
1578
1579 err.fetch_and_calculate_accounts_data()
1580 if err.accounts:
1581 err.save().submit()
1582 response = err.make_jv_entries()
1583
1584 if company.submit_err_jv:
1585 jv = response.get("revaluation_jv", None)
1586 jv and frappe.get_doc("Journal Entry", jv).submit()
1587 jv = response.get("zero_balance_jv", None)
1588 jv and frappe.get_doc("Journal Entry", jv).submit()
1589
1590
1591def auto_create_exchange_rate_revaluation_daily() -> None:
1592 """
1593 Executed by background job
1594 """
1595 companies = frappe.db.get_all(
1596 "Company",
1597 filters={"auto_exchange_rate_revaluation": 1, "auto_err_frequency": "Daily"},
1598 fields=["name", "submit_err_jv"],
1599 )
1600 create_err_and_its_journals(companies)
1601
1602
1603def auto_create_exchange_rate_revaluation_weekly() -> None:
1604 """
1605 Executed by background job
1606 """
1607 companies = frappe.db.get_all(
1608 "Company",
1609 filters={"auto_exchange_rate_revaluation": 1, "auto_err_frequency": "Weekly"},
1610 fields=["name", "submit_err_jv"],
1611 )
1612 create_err_and_its_journals(companies)
1613
1614
ruthra kumar9b502212022-10-13 14:13:48 +05301615def get_payment_ledger_entries(gl_entries, cancel=0):
1616 ple_map = []
ruthra kumar451cf3a2022-05-16 14:29:58 +05301617 if gl_entries:
1618 ple = None
1619
1620 # companies
1621 account = qb.DocType("Account")
1622 companies = list(set([x.company for x in gl_entries]))
1623
1624 # receivable/payable account
1625 accounts_with_types = (
1626 qb.from_(account)
1627 .select(account.name, account.account_type)
1628 .where(
1629 (account.account_type.isin(["Receivable", "Payable"]) & (account.company.isin(companies)))
1630 )
1631 .run(as_dict=True)
1632 )
1633 receivable_or_payable_accounts = [y.name for y in accounts_with_types]
1634
1635 def get_account_type(account):
1636 for entry in accounts_with_types:
1637 if entry.name == account:
1638 return entry.account_type
1639
1640 dr_or_cr = 0
1641 account_type = None
1642 for gle in gl_entries:
1643 if gle.account in receivable_or_payable_accounts:
1644 account_type = get_account_type(gle.account)
1645 if account_type == "Receivable":
1646 dr_or_cr = gle.debit - gle.credit
1647 dr_or_cr_account_currency = gle.debit_in_account_currency - gle.credit_in_account_currency
1648 elif account_type == "Payable":
1649 dr_or_cr = gle.credit - gle.debit
1650 dr_or_cr_account_currency = gle.credit_in_account_currency - gle.debit_in_account_currency
1651
1652 if cancel:
1653 dr_or_cr *= -1
1654 dr_or_cr_account_currency *= -1
1655
ruthra kumar9b502212022-10-13 14:13:48 +05301656 ple = frappe._dict(
1657 doctype="Payment Ledger Entry",
1658 posting_date=gle.posting_date,
1659 company=gle.company,
1660 account_type=account_type,
1661 account=gle.account,
1662 party_type=gle.party_type,
1663 party=gle.party,
1664 cost_center=gle.cost_center,
1665 finance_book=gle.finance_book,
1666 due_date=gle.due_date,
1667 voucher_type=gle.voucher_type,
1668 voucher_no=gle.voucher_no,
Deepesh Garg1e078d02023-06-29 12:18:25 +05301669 voucher_detail_no=gle.voucher_detail_no,
ruthra kumar9b502212022-10-13 14:13:48 +05301670 against_voucher_type=gle.against_voucher_type
1671 if gle.against_voucher_type
1672 else gle.voucher_type,
1673 against_voucher_no=gle.against_voucher if gle.against_voucher else gle.voucher_no,
1674 account_currency=gle.account_currency,
1675 amount=dr_or_cr,
1676 amount_in_account_currency=dr_or_cr_account_currency,
1677 delinked=True if cancel else False,
1678 remarks=gle.remarks,
ruthra kumar451cf3a2022-05-16 14:29:58 +05301679 )
1680
1681 dimensions_and_defaults = get_dimensions()
1682 if dimensions_and_defaults:
1683 for dimension in dimensions_and_defaults[0]:
ruthra kumar9b502212022-10-13 14:13:48 +05301684 ple[dimension.fieldname] = gle.get(dimension.fieldname)
ruthra kumar451cf3a2022-05-16 14:29:58 +05301685
ruthra kumar9b502212022-10-13 14:13:48 +05301686 ple_map.append(ple)
1687 return ple_map
1688
1689
1690def create_payment_ledger_entry(
Deepesh Garg1e078d02023-06-29 12:18:25 +05301691 gl_entries, cancel=0, adv_adj=0, update_outstanding="Yes", from_repost=0, partial_cancel=False
ruthra kumar9b502212022-10-13 14:13:48 +05301692):
1693 if gl_entries:
1694 ple_map = get_payment_ledger_entries(gl_entries, cancel=cancel)
1695
1696 for entry in ple_map:
1697
1698 ple = frappe.get_doc(entry)
1699
1700 if cancel:
Deepesh Garg1e078d02023-06-29 12:18:25 +05301701 delink_original_entry(ple, partial_cancel=partial_cancel)
ruthra kumar9b502212022-10-13 14:13:48 +05301702
1703 ple.flags.ignore_permissions = 1
1704 ple.flags.adv_adj = adv_adj
1705 ple.flags.from_repost = from_repost
1706 ple.flags.update_outstanding = update_outstanding
1707 ple.submit()
ruthra kumar451cf3a2022-05-16 14:29:58 +05301708
1709
ruthra kumar7312f222022-05-29 21:33:08 +05301710def update_voucher_outstanding(voucher_type, voucher_no, account, party_type, party):
1711 ple = frappe.qb.DocType("Payment Ledger Entry")
1712 vouchers = [frappe._dict({"voucher_type": voucher_type, "voucher_no": voucher_no})]
1713 common_filter = []
1714 if account:
1715 common_filter.append(ple.account == account)
1716
1717 if party_type:
1718 common_filter.append(ple.party_type == party_type)
1719
1720 if party:
1721 common_filter.append(ple.party == party)
1722
1723 ple_query = QueryPaymentLedger()
1724
1725 # on cancellation outstanding can be an empty list
1726 voucher_outstanding = ple_query.get_voucher_outstandings(vouchers, common_filter=common_filter)
ruthra kumar43b80682022-10-18 09:33:37 +05301727 if (
1728 voucher_type in ["Sales Invoice", "Purchase Invoice", "Fees"]
1729 and party_type
1730 and party
1731 and voucher_outstanding
1732 ):
ruthra kumar7312f222022-05-29 21:33:08 +05301733 outstanding = voucher_outstanding[0]
1734 ref_doc = frappe.get_doc(voucher_type, voucher_no)
1735
1736 # Didn't use db_set for optimisation purpose
ruthra kumarb9a7ff72023-02-12 14:06:40 +05301737 ref_doc.outstanding_amount = outstanding["outstanding_in_account_currency"] or 0.0
ruthra kumar7312f222022-05-29 21:33:08 +05301738 frappe.db.set_value(
ruthra kumarb9a7ff72023-02-12 14:06:40 +05301739 voucher_type,
1740 voucher_no,
1741 "outstanding_amount",
1742 outstanding["outstanding_in_account_currency"] or 0.0,
ruthra kumar7312f222022-05-29 21:33:08 +05301743 )
1744
1745 ref_doc.set_status(update=True)
1746
1747
Deepesh Garg1e078d02023-06-29 12:18:25 +05301748def delink_original_entry(pl_entry, partial_cancel=False):
ruthra kumar451cf3a2022-05-16 14:29:58 +05301749 if pl_entry:
1750 ple = qb.DocType("Payment Ledger Entry")
1751 query = (
1752 qb.update(ple)
1753 .set(ple.delinked, True)
1754 .set(ple.modified, now())
1755 .set(ple.modified_by, frappe.session.user)
1756 .where(
1757 (ple.company == pl_entry.company)
1758 & (ple.account_type == pl_entry.account_type)
1759 & (ple.account == pl_entry.account)
1760 & (ple.party_type == pl_entry.party_type)
1761 & (ple.party == pl_entry.party)
1762 & (ple.voucher_type == pl_entry.voucher_type)
1763 & (ple.voucher_no == pl_entry.voucher_no)
1764 & (ple.against_voucher_type == pl_entry.against_voucher_type)
1765 & (ple.against_voucher_no == pl_entry.against_voucher_no)
1766 )
1767 )
Deepesh Garg1e078d02023-06-29 12:18:25 +05301768
1769 if partial_cancel:
1770 query = query.where(ple.voucher_detail_no == pl_entry.voucher_detail_no)
1771
ruthra kumar451cf3a2022-05-16 14:29:58 +05301772 query.run()
ruthra kumar7b383882022-05-25 15:51:16 +05301773
1774
1775class QueryPaymentLedger(object):
1776 """
1777 Helper Class for Querying Payment Ledger Entry
1778 """
1779
1780 def __init__(self):
1781 self.ple = qb.DocType("Payment Ledger Entry")
1782
1783 # query result
1784 self.voucher_outstandings = []
1785
1786 # query filters
1787 self.vouchers = []
1788 self.common_filter = []
ruthra kumar5f1562c2022-07-28 11:57:27 +05301789 self.voucher_posting_date = []
ruthra kumar7b383882022-05-25 15:51:16 +05301790 self.min_outstanding = None
1791 self.max_outstanding = None
ruthra kumar7a381af2023-05-03 20:45:12 +05301792 self.limit = self.voucher_no = None
ruthra kumar7b383882022-05-25 15:51:16 +05301793
1794 def reset(self):
1795 # clear filters
1796 self.vouchers.clear()
1797 self.common_filter.clear()
ruthra kumar7a381af2023-05-03 20:45:12 +05301798 self.min_outstanding = self.max_outstanding = self.limit = None
ruthra kumar7b383882022-05-25 15:51:16 +05301799
1800 # clear result
1801 self.voucher_outstandings.clear()
1802
1803 def query_for_outstanding(self):
1804 """
1805 Database query to fetch voucher amount and voucher outstanding using Common Table Expression
1806 """
1807
1808 ple = self.ple
1809
1810 filter_on_voucher_no = []
1811 filter_on_against_voucher_no = []
ruthra kumar7a381af2023-05-03 20:45:12 +05301812
ruthra kumar7b383882022-05-25 15:51:16 +05301813 if self.vouchers:
1814 voucher_types = set([x.voucher_type for x in self.vouchers])
1815 voucher_nos = set([x.voucher_no for x in self.vouchers])
1816
1817 filter_on_voucher_no.append(ple.voucher_type.isin(voucher_types))
1818 filter_on_voucher_no.append(ple.voucher_no.isin(voucher_nos))
1819
1820 filter_on_against_voucher_no.append(ple.against_voucher_type.isin(voucher_types))
1821 filter_on_against_voucher_no.append(ple.against_voucher_no.isin(voucher_nos))
1822
ruthra kumar7a381af2023-05-03 20:45:12 +05301823 if self.voucher_no:
1824 filter_on_voucher_no.append(ple.voucher_no.like(f"%{self.voucher_no}%"))
1825 filter_on_against_voucher_no.append(ple.against_voucher_no.like(f"%{self.voucher_no}%"))
1826
ruthra kumar7b383882022-05-25 15:51:16 +05301827 # build outstanding amount filter
1828 filter_on_outstanding_amount = []
1829 if self.min_outstanding:
1830 if self.min_outstanding > 0:
1831 filter_on_outstanding_amount.append(
1832 Table("outstanding").amount_in_account_currency >= self.min_outstanding
1833 )
1834 else:
1835 filter_on_outstanding_amount.append(
1836 Table("outstanding").amount_in_account_currency <= self.min_outstanding
1837 )
1838 if self.max_outstanding:
1839 if self.max_outstanding > 0:
1840 filter_on_outstanding_amount.append(
1841 Table("outstanding").amount_in_account_currency <= self.max_outstanding
1842 )
1843 else:
1844 filter_on_outstanding_amount.append(
1845 Table("outstanding").amount_in_account_currency >= self.max_outstanding
1846 )
1847
ruthra kumar8b04c1d2023-11-22 09:59:32 +05301848 if self.limit and self.get_invoices:
1849 outstanding_vouchers = (
1850 qb.from_(ple)
1851 .select(
1852 ple.against_voucher_no.as_("voucher_no"),
1853 Sum(ple.amount_in_account_currency).as_("amount_in_account_currency"),
1854 )
1855 .where(ple.delinked == 0)
1856 .where(Criterion.all(filter_on_against_voucher_no))
1857 .where(Criterion.all(self.common_filter))
ruthra kumarcfd32302023-11-30 12:22:55 +05301858 .where(Criterion.all(self.dimensions_filter))
1859 .where(Criterion.all(self.voucher_posting_date))
ruthra kumar8b04c1d2023-11-22 09:59:32 +05301860 .groupby(ple.against_voucher_type, ple.against_voucher_no, ple.party_type, ple.party)
1861 .orderby(ple.posting_date, ple.voucher_no)
1862 .having(qb.Field("amount_in_account_currency") > 0)
1863 .limit(self.limit)
1864 .run()
1865 )
1866 if outstanding_vouchers:
1867 filter_on_voucher_no.append(ple.voucher_no.isin([x[0] for x in outstanding_vouchers]))
1868 filter_on_against_voucher_no.append(
1869 ple.against_voucher_no.isin([x[0] for x in outstanding_vouchers])
1870 )
1871
ruthra kumar7b383882022-05-25 15:51:16 +05301872 # build query for voucher amount
1873 query_voucher_amount = (
1874 qb.from_(ple)
1875 .select(
1876 ple.account,
1877 ple.voucher_type,
1878 ple.voucher_no,
1879 ple.party_type,
1880 ple.party,
1881 ple.posting_date,
1882 ple.due_date,
1883 ple.account_currency.as_("currency"),
ruthra kumard6a3b9a2023-09-03 07:21:09 +05301884 ple.cost_center.as_("cost_center"),
ruthra kumar7b383882022-05-25 15:51:16 +05301885 Sum(ple.amount).as_("amount"),
1886 Sum(ple.amount_in_account_currency).as_("amount_in_account_currency"),
1887 )
1888 .where(ple.delinked == 0)
1889 .where(Criterion.all(filter_on_voucher_no))
1890 .where(Criterion.all(self.common_filter))
ruthra kumar6d9d7302022-12-14 16:05:15 +05301891 .where(Criterion.all(self.dimensions_filter))
ruthra kumar5f1562c2022-07-28 11:57:27 +05301892 .where(Criterion.all(self.voucher_posting_date))
ruthra kumar7b383882022-05-25 15:51:16 +05301893 .groupby(ple.voucher_type, ple.voucher_no, ple.party_type, ple.party)
1894 )
1895
1896 # build query for voucher outstanding
1897 query_voucher_outstanding = (
1898 qb.from_(ple)
1899 .select(
1900 ple.account,
1901 ple.against_voucher_type.as_("voucher_type"),
1902 ple.against_voucher_no.as_("voucher_no"),
1903 ple.party_type,
1904 ple.party,
1905 ple.posting_date,
1906 ple.due_date,
1907 ple.account_currency.as_("currency"),
1908 Sum(ple.amount).as_("amount"),
1909 Sum(ple.amount_in_account_currency).as_("amount_in_account_currency"),
1910 )
1911 .where(ple.delinked == 0)
1912 .where(Criterion.all(filter_on_against_voucher_no))
1913 .where(Criterion.all(self.common_filter))
1914 .groupby(ple.against_voucher_type, ple.against_voucher_no, ple.party_type, ple.party)
1915 )
1916
1917 # build CTE for combining voucher amount and outstanding
1918 self.cte_query_voucher_amount_and_outstanding = (
1919 qb.with_(query_voucher_amount, "vouchers")
1920 .with_(query_voucher_outstanding, "outstanding")
1921 .from_(AliasedQuery("vouchers"))
1922 .left_join(AliasedQuery("outstanding"))
1923 .on(
1924 (AliasedQuery("vouchers").account == AliasedQuery("outstanding").account)
1925 & (AliasedQuery("vouchers").voucher_type == AliasedQuery("outstanding").voucher_type)
1926 & (AliasedQuery("vouchers").voucher_no == AliasedQuery("outstanding").voucher_no)
1927 & (AliasedQuery("vouchers").party_type == AliasedQuery("outstanding").party_type)
1928 & (AliasedQuery("vouchers").party == AliasedQuery("outstanding").party)
1929 )
1930 .select(
1931 Table("vouchers").account,
1932 Table("vouchers").voucher_type,
1933 Table("vouchers").voucher_no,
1934 Table("vouchers").party_type,
1935 Table("vouchers").party,
1936 Table("vouchers").posting_date,
1937 Table("vouchers").amount.as_("invoice_amount"),
1938 Table("vouchers").amount_in_account_currency.as_("invoice_amount_in_account_currency"),
1939 Table("outstanding").amount.as_("outstanding"),
1940 Table("outstanding").amount_in_account_currency.as_("outstanding_in_account_currency"),
1941 (Table("vouchers").amount - Table("outstanding").amount).as_("paid_amount"),
1942 (
1943 Table("vouchers").amount_in_account_currency - Table("outstanding").amount_in_account_currency
1944 ).as_("paid_amount_in_account_currency"),
1945 Table("vouchers").due_date,
1946 Table("vouchers").currency,
ruthra kumard6a3b9a2023-09-03 07:21:09 +05301947 Table("vouchers").cost_center.as_("cost_center"),
ruthra kumar7b383882022-05-25 15:51:16 +05301948 )
1949 .where(Criterion.all(filter_on_outstanding_amount))
1950 )
1951
1952 # build CTE filter
1953 # only fetch invoices
1954 if self.get_invoices:
1955 self.cte_query_voucher_amount_and_outstanding = (
1956 self.cte_query_voucher_amount_and_outstanding.having(
1957 qb.Field("outstanding_in_account_currency") > 0
1958 )
1959 )
1960 # only fetch payments
1961 elif self.get_payments:
1962 self.cte_query_voucher_amount_and_outstanding = (
1963 self.cte_query_voucher_amount_and_outstanding.having(
1964 qb.Field("outstanding_in_account_currency") < 0
1965 )
1966 )
1967
ruthra kumar7a381af2023-05-03 20:45:12 +05301968 if self.limit:
1969 self.cte_query_voucher_amount_and_outstanding = (
1970 self.cte_query_voucher_amount_and_outstanding.limit(self.limit)
1971 )
1972
ruthra kumar7b383882022-05-25 15:51:16 +05301973 # execute SQL
1974 self.voucher_outstandings = self.cte_query_voucher_amount_and_outstanding.run(as_dict=True)
1975
1976 def get_voucher_outstandings(
1977 self,
1978 vouchers=None,
1979 common_filter=None,
ruthra kumar5f1562c2022-07-28 11:57:27 +05301980 posting_date=None,
ruthra kumar7b383882022-05-25 15:51:16 +05301981 min_outstanding=None,
1982 max_outstanding=None,
1983 get_payments=False,
1984 get_invoices=False,
ruthra kumar6d9d7302022-12-14 16:05:15 +05301985 accounting_dimensions=None,
ruthra kumar7a381af2023-05-03 20:45:12 +05301986 limit=None,
1987 voucher_no=None,
ruthra kumar7b383882022-05-25 15:51:16 +05301988 ):
1989 """
1990 Fetch voucher amount and outstanding amount from Payment Ledger using Database CTE
1991
1992 vouchers - dict of vouchers to get
1993 common_filter - array of criterions
1994 min_outstanding - filter on minimum total outstanding amount
1995 max_outstanding - filter on maximum total outstanding amount
1996 get_invoices - only fetch vouchers(ledger entries with +ve outstanding)
1997 get_payments - only fetch payments(ledger entries with -ve outstanding)
1998 """
1999
2000 self.reset()
2001 self.vouchers = vouchers
2002 self.common_filter = common_filter or []
ruthra kumar6d9d7302022-12-14 16:05:15 +05302003 self.dimensions_filter = accounting_dimensions or []
ruthra kumar5f1562c2022-07-28 11:57:27 +05302004 self.voucher_posting_date = posting_date or []
ruthra kumar7b383882022-05-25 15:51:16 +05302005 self.min_outstanding = min_outstanding
2006 self.max_outstanding = max_outstanding
2007 self.get_payments = get_payments
2008 self.get_invoices = get_invoices
ruthra kumar7a381af2023-05-03 20:45:12 +05302009 self.limit = limit
2010 self.voucher_no = voucher_no
ruthra kumar7b383882022-05-25 15:51:16 +05302011 self.query_for_outstanding()
2012
2013 return self.voucher_outstandings
ruthra kumar1ea1bfe2023-07-26 16:19:38 +05302014
2015
2016def create_gain_loss_journal(
2017 company,
ruthra kumarf7865da2023-09-04 20:38:10 +05302018 posting_date,
ruthra kumar1ea1bfe2023-07-26 16:19:38 +05302019 party_type,
2020 party,
2021 party_account,
2022 gain_loss_account,
2023 exc_gain_loss,
2024 dr_or_cr,
2025 reverse_dr_or_cr,
2026 ref1_dt,
2027 ref1_dn,
2028 ref1_detail_no,
2029 ref2_dt,
2030 ref2_dn,
2031 ref2_detail_no,
ruthra kumard6a3b9a2023-09-03 07:21:09 +05302032 cost_center,
ruthra kumar5dc22e12023-12-20 17:19:27 +05302033 dimensions,
ruthra kumar1ea1bfe2023-07-26 16:19:38 +05302034) -> str:
2035 journal_entry = frappe.new_doc("Journal Entry")
2036 journal_entry.voucher_type = "Exchange Gain Or Loss"
2037 journal_entry.company = company
ruthra kumarf7865da2023-09-04 20:38:10 +05302038 journal_entry.posting_date = posting_date or nowdate()
ruthra kumar1ea1bfe2023-07-26 16:19:38 +05302039 journal_entry.multi_currency = 1
ruthra kumar79c6f012023-09-01 14:57:12 +05302040 journal_entry.is_system_generated = True
ruthra kumar1ea1bfe2023-07-26 16:19:38 +05302041
2042 party_account_currency = frappe.get_cached_value("Account", party_account, "account_currency")
2043
2044 if not gain_loss_account:
2045 frappe.throw(_("Please set default Exchange Gain/Loss Account in Company {}").format(company))
2046 gain_loss_account_currency = get_account_currency(gain_loss_account)
2047 company_currency = frappe.get_cached_value("Company", company, "default_currency")
2048
2049 if gain_loss_account_currency != company_currency:
2050 frappe.throw(_("Currency for {0} must be {1}").format(gain_loss_account, company_currency))
2051
2052 journal_account = frappe._dict(
2053 {
2054 "account": party_account,
2055 "party_type": party_type,
2056 "party": party,
2057 "account_currency": party_account_currency,
2058 "exchange_rate": 0,
ruthra kumard6a3b9a2023-09-03 07:21:09 +05302059 "cost_center": cost_center or erpnext.get_default_cost_center(company),
ruthra kumar1ea1bfe2023-07-26 16:19:38 +05302060 "reference_type": ref1_dt,
2061 "reference_name": ref1_dn,
2062 "reference_detail_no": ref1_detail_no,
2063 dr_or_cr: abs(exc_gain_loss),
2064 dr_or_cr + "_in_account_currency": 0,
2065 }
2066 )
ruthra kumarec0f17c2024-01-22 11:59:20 +05302067 if dimensions:
2068 journal_account.update(dimensions)
ruthra kumar1ea1bfe2023-07-26 16:19:38 +05302069 journal_entry.append("accounts", journal_account)
2070
2071 journal_account = frappe._dict(
2072 {
2073 "account": gain_loss_account,
2074 "account_currency": gain_loss_account_currency,
2075 "exchange_rate": 1,
ruthra kumard6a3b9a2023-09-03 07:21:09 +05302076 "cost_center": cost_center or erpnext.get_default_cost_center(company),
ruthra kumar1ea1bfe2023-07-26 16:19:38 +05302077 "reference_type": ref2_dt,
2078 "reference_name": ref2_dn,
2079 "reference_detail_no": ref2_detail_no,
2080 reverse_dr_or_cr + "_in_account_currency": 0,
2081 reverse_dr_or_cr: abs(exc_gain_loss),
2082 }
2083 )
ruthra kumarec0f17c2024-01-22 11:59:20 +05302084 if dimensions:
2085 journal_account.update(dimensions)
ruthra kumar1ea1bfe2023-07-26 16:19:38 +05302086 journal_entry.append("accounts", journal_account)
2087
2088 journal_entry.save()
2089 journal_entry.submit()
2090 return journal_entry.name
Gursheen Anand40157232023-11-03 11:58:25 +05302091
2092
2093def get_party_types_from_account_type(account_type):
Gursheen Anand2984a862023-11-08 12:30:24 +05302094 return frappe.db.get_all("Party Type", {"account_type": account_type}, pluck="name")