blob: 9f82af9b37dcd34fb0376cbe839819be5239f18f [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 Hait2df4d542013-01-29 11:34:39 +05303
4from __future__ import unicode_literals
Rushabh Mehtacc8b2b22017-03-31 12:44:29 +05305import frappe, erpnext
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08006import json
Rushabh Mehta793ba6b2014-02-14 15:47:51 +05307from frappe import _, throw
rohitwaghchaurea85ddf22019-11-19 18:47:48 +05308from frappe.utils import (today, flt, cint, fmt_money, formatdate,
9 getdate, add_days, add_months, get_last_day, nowdate, get_link_to_form)
Saqib6db92fb2020-09-14 19:54:17 +053010from frappe.model.workflow import get_workflow_name, is_transition_condition_satisfied, WorkflowPermissionError
rohitwaghchaurea85ddf22019-11-19 18:47:48 +053011from erpnext.stock.get_item_details import get_conversion_factor, get_item_details
Rushabh Mehtacc8b2b22017-03-31 12:44:29 +053012from erpnext.setup.utils import get_exchange_rate
Nabin Hait2ed0b592016-03-29 13:14:17 +053013from erpnext.accounts.utils import get_fiscal_years, validate_fiscal_year, get_account_currency
Nabin Hait436f5262014-02-10 14:47:54 +053014from erpnext.utilities.transaction_base import TransactionBase
Doridel Cahanap6f06cc22018-05-17 16:28:58 +080015from erpnext.buying.utils import update_last_purchase_rate
Nabin Hait3cf67a42015-07-24 13:26:36 +053016from erpnext.controllers.sales_and_purchase_return import validate_return
shreyas29b565f2016-01-25 17:30:49 +053017from erpnext.accounts.party import get_party_account_currency, validate_party_frozen_disabled
rohitwaghchaurea85ddf22019-11-19 18:47:48 +053018from erpnext.accounts.doctype.pricing_rule.utils import (apply_pricing_rule_on_transaction,
19 apply_pricing_rule_for_free_items, get_applied_pricing_rules)
shreyasf76853a2016-01-25 21:25:11 +053020from erpnext.exceptions import InvalidCurrency
Achilles Rasquinha90509982018-03-08 12:55:41 +053021from six import text_type
deepeshgarg007d83cf652019-05-12 18:34:23 +053022from erpnext.accounts.doctype.accounting_dimension.accounting_dimension import get_accounting_dimensions
marination698d9832020-08-19 14:59:46 +053023from erpnext.stock.get_item_details import get_item_warehouse, _get_item_tax_template, get_item_tax_map
Marica3dee5272020-06-23 10:33:47 +053024from erpnext.stock.doctype.packed_item.packed_item import make_packing_list
prssanna71e5b602020-10-29 14:19:34 +053025from erpnext.controllers.print_settings import set_print_templates_for_item_table, set_print_templates_for_taxes
Nabin Hait1d218422015-07-17 15:19:02 +053026
marination53b1a9a2020-11-03 15:45:25 +053027class AccountMissingError(frappe.ValidationError): pass
28
Rohit Waghchaurebde159a2021-03-22 23:36:48 +053029force_item_fields = ("item_group", "brand", "stock_uom", "is_fixed_asset", "item_tax_rate",
30 "pricing_rules", "weight_per_unit", "weight_uom", "total_weight")
Doridel Cahanap6f06cc22018-05-17 16:28:58 +080031
Nabin Haitbf495c92013-01-30 12:49:08 +053032class AccountsController(TransactionBase):
Nabin Hait7eba1a32017-10-02 15:59:27 +053033 def __init__(self, *args, **kwargs):
34 super(AccountsController, self).__init__(*args, **kwargs)
Anand Doshi979326b2015-09-11 16:22:37 +053035
prssanna71e5b602020-10-29 14:19:34 +053036 def get_print_settings(self):
37 print_setting_fields = []
38 items_field = self.meta.get_field('items')
39
40 if items_field and items_field.fieldtype == 'Table':
41 print_setting_fields += ['compact_item_print', 'print_uom_after_quantity']
42
43 taxes_field = self.meta.get_field('taxes')
44 if taxes_field and taxes_field.fieldtype == 'Table':
45 print_setting_fields += ['print_taxes_with_zero_amount']
46
47 return print_setting_fields
48
Nabin Hait4ffd7f32015-08-27 12:28:36 +053049 @property
50 def company_currency(self):
51 if not hasattr(self, "__company_currency"):
Rushabh Mehtacc8b2b22017-03-31 12:44:29 +053052 self.__company_currency = erpnext.get_company_currency(self.company)
Anand Doshi979326b2015-09-11 16:22:37 +053053
Nabin Hait4ffd7f32015-08-27 12:28:36 +053054 return self.__company_currency
Anand Doshi979326b2015-09-11 16:22:37 +053055
Rohit Waghchaure7d529892016-10-06 14:35:04 +053056 def onload(self):
Nabin Hait34c551d2019-07-03 10:34:31 +053057 self.set_onload("make_payment_via_journal_entry",
58 frappe.db.get_single_value('Accounts Settings', 'make_payment_via_journal_entry'))
Nabin Hait0551f7b2017-11-21 19:58:16 +053059
tundee52bb822017-09-25 09:02:23 +010060 if self.is_new():
Nabin Hait0551f7b2017-11-21 19:58:16 +053061 relevant_docs = ("Quotation", "Purchase Order", "Sales Order",
Doridel Cahanap6f06cc22018-05-17 16:28:58 +080062 "Purchase Invoice", "Sales Invoice")
tundee52bb822017-09-25 09:02:23 +010063 if self.doctype in relevant_docs:
64 self.set_payment_schedule()
Rohit Waghchaure7d529892016-10-06 14:35:04 +053065
tundebabzyad08d4c2018-05-16 07:01:41 +010066 def ensure_supplier_is_not_blocked(self):
67 is_supplier_payment = self.doctype == 'Payment Entry' and self.party_type == 'Supplier'
68 is_buying_invoice = self.doctype in ['Purchase Invoice', 'Purchase Order']
69 supplier = None
70 supplier_name = None
71
72 if is_buying_invoice or is_supplier_payment:
73 supplier_name = self.supplier if is_buying_invoice else self.party
74 supplier = frappe.get_doc('Supplier', supplier_name)
75
76 if supplier and supplier_name and supplier.on_hold:
77 if (is_buying_invoice and supplier.hold_type in ['All', 'Invoices']) or \
78 (is_supplier_payment and supplier.hold_type in ['All', 'Payments']):
79 if not supplier.release_date or getdate(nowdate()) <= supplier.release_date:
80 frappe.msgprint(
Suraj Shetty48e9bc32020-01-29 15:06:18 +053081 _('{0} is blocked so this transaction cannot proceed').format(supplier_name), raise_exception=1)
tundebabzyad08d4c2018-05-16 07:01:41 +010082
Saurabh6f753182013-03-20 12:55:28 +053083 def validate(self):
Deepesh Gargd301d262019-07-31 15:58:19 +053084 if not self.get('is_return'):
85 self.validate_qty_is_not_zero()
86
nabinhait23cce732014-07-03 12:25:06 +053087 if self.get("_action") and self._action != "update_after_submit":
Nabin Hait704a4532014-06-05 16:55:31 +053088 self.set_missing_values(for_validate=True)
tunde62af5c52017-09-22 15:16:38 +010089
tundebabzyad08d4c2018-05-16 07:01:41 +010090 self.ensure_supplier_is_not_blocked()
91
Nabin Haitcfecd2b2013-07-11 17:49:18 +053092 self.validate_date_with_fiscal_year()
Deepesh Garg4c8d15b2021-04-26 15:24:34 +053093 self.validate_party_accounts()
94
Deepesh Gargb4be2922021-01-28 13:09:56 +053095 self.validate_inter_company_reference()
96
97 self.set_incoming_rate()
Rushabh Mehtab16b9cd2015-08-03 16:13:33 +053098
Anand Doshi3543f302013-05-24 19:25:01 +053099 if self.meta.get_field("currency"):
Anand Doshi923d41d2013-05-28 17:23:36 +0530100 self.calculate_taxes_and_totals()
Rohit Waghchaure6087fe12016-04-09 14:31:09 +0530101
Nabin Hait1d218422015-07-17 15:19:02 +0530102 if not self.meta.get_field("is_return") or not self.is_return:
103 self.validate_value("base_grand_total", ">=", 0)
Rushabh Mehtab16b9cd2015-08-03 16:13:33 +0530104
Nabin Hait3cf67a42015-07-24 13:26:36 +0530105 validate_return(self)
Anand Doshi3543f302013-05-24 19:25:01 +0530106 self.set_total_in_words()
Anand Doshid2946502014-04-08 20:10:03 +0530107
tunde62af5c52017-09-22 15:16:38 +0100108 self.validate_all_documents_schedule()
Anand Doshid2946502014-04-08 20:10:03 +0530109
ankitjavalkarwork6c29d872014-10-06 13:20:53 +0530110 if self.meta.get_field("taxes_and_charges"):
111 self.validate_enabled_taxes_and_charges()
Nabin Haita2426fc2018-01-15 17:45:46 +0530112 self.validate_tax_account_company()
Rushabh Mehtab16b9cd2015-08-03 16:13:33 +0530113
Neil Trini Lasrado3fbbb712015-07-17 12:10:12 +0530114 self.validate_party()
Nabin Hait895029d2015-08-20 14:55:39 +0530115 self.validate_currency()
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +0530116
Rohit Waghchaure6087fe12016-04-09 14:31:09 +0530117 if self.doctype == 'Purchase Invoice':
Mangesh-Khairnar7bcb24e2019-09-11 10:49:33 +0530118 self.calculate_paid_amount()
Deepesh Garg911818a2021-06-09 22:55:10 +0530119 # apply tax withholding only if checked and applicable
120 self.set_tax_withholding()
Rohit Waghchaure6087fe12016-04-09 14:31:09 +0530121
Nabin Hait041a5c22018-08-01 18:07:39 +0530122 if self.doctype in ['Purchase Invoice', 'Sales Invoice']:
Nabin Hait4a994d42019-04-25 17:47:26 +0530123 pos_check_field = "is_pos" if self.doctype=="Sales Invoice" else "is_paid"
124 if cint(self.allocate_advances_automatically) and not cint(self.get(pos_check_field)):
Nabin Hait041a5c22018-08-01 18:07:39 +0530125 self.set_advances()
126
Saqiba20999c2021-07-12 14:33:23 +0530127 self.set_advance_gain_or_loss()
128
Nabin Hait041a5c22018-08-01 18:07:39 +0530129 if self.is_return:
130 self.validate_qty()
Nabin Haitacdd5082019-12-04 15:30:01 +0530131 else:
132 self.validate_deferred_start_and_end_date()
rohitwaghchaure70489252018-06-11 12:02:14 +0530133
Deepesh Gargf17ea2c2020-12-11 21:30:39 +0530134 self.set_inter_company_account()
135
Gauravf1e28e02019-02-13 16:46:24 +0530136 validate_regional(self)
Deepesh Garg7c300852020-12-26 20:14:51 +0530137
Rohit Waghchaure8bfe3302019-03-18 14:34:19 +0530138 if self.doctype != 'Material Request':
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530139 apply_pricing_rule_on_transaction(self)
Gauravf1e28e02019-02-13 16:46:24 +0530140
Saqib8e556772021-01-28 12:26:45 +0530141 def on_trash(self):
142 # delete sl and gl entries on deletion of transaction
143 if frappe.db.get_single_value('Accounts Settings', 'delete_linked_ledger_entries'):
144 frappe.db.sql("delete from `tabGL Entry` where voucher_type=%s and voucher_no=%s", (self.doctype, self.name))
145 frappe.db.sql("delete from `tabStock Ledger Entry` where voucher_type=%s and voucher_no=%s", (self.doctype, self.name))
Nabin Hait0551f7b2017-11-21 19:58:16 +0530146
Nabin Haitacdd5082019-12-04 15:30:01 +0530147 def validate_deferred_start_and_end_date(self):
148 for d in self.items:
149 if d.get("enable_deferred_revenue") or d.get("enable_deferred_expense"):
150 if not (d.service_start_date and d.service_end_date):
151 frappe.throw(_("Row #{0}: Service Start and End Date is required for deferred accounting").format(d.idx))
152 elif getdate(d.service_start_date) > getdate(d.service_end_date):
153 frappe.throw(_("Row #{0}: Service Start Date cannot be greater than Service End Date").format(d.idx))
154 elif getdate(self.posting_date) > getdate(d.service_end_date):
155 frappe.throw(_("Row #{0}: Service End Date cannot be before Invoice Posting Date").format(d.idx))
156
tunde62af5c52017-09-22 15:16:38 +0100157 def validate_invoice_documents_schedule(self):
Nabin Hait0551f7b2017-11-21 19:58:16 +0530158 self.validate_payment_schedule_dates()
159 self.set_due_date()
Nabin Hait0551f7b2017-11-21 19:58:16 +0530160 self.set_payment_schedule()
161 self.validate_payment_schedule_amount()
Deepesh Gargbd709f82021-08-23 19:05:52 +0530162 if not self.get('ignore_default_payment_terms_template'):
163 self.validate_due_date()
tunde62af5c52017-09-22 15:16:38 +0100164 self.validate_advance_entries()
165
166 def validate_non_invoice_documents_schedule(self):
Nabin Hait0551f7b2017-11-21 19:58:16 +0530167 self.set_payment_schedule()
Nabin Hait2f9f4f92017-12-20 12:24:59 +0530168 self.validate_payment_schedule_dates()
Nabin Hait0551f7b2017-11-21 19:58:16 +0530169 self.validate_payment_schedule_amount()
tunde62af5c52017-09-22 15:16:38 +0100170
171 def validate_all_documents_schedule(self):
172 if self.doctype in ("Sales Invoice", "Purchase Invoice") and not self.is_return:
173 self.validate_invoice_documents_schedule()
174 elif self.doctype in ("Quotation", "Purchase Order", "Sales Order"):
175 self.validate_non_invoice_documents_schedule()
176
prssanna71e5b602020-10-29 14:19:34 +0530177 def before_print(self, settings=None):
Zarrarb9f54ca2018-05-28 17:41:09 +0530178 if self.doctype in ['Purchase Order', 'Sales Order', 'Sales Invoice', 'Purchase Invoice',
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800179 'Supplier Quotation', 'Purchase Receipt', 'Delivery Note', 'Quotation']:
KanchanChauhan49a50fe2016-11-18 13:57:53 +0530180 if self.get("group_same_items"):
181 self.group_similar_items()
182
Zarrar5be6d192018-11-08 12:16:26 +0530183 df = self.meta.get_field("discount_amount")
184 if self.get("discount_amount") and hasattr(self, "taxes") and not len(self.taxes):
185 df.set("print_hide", 0)
186 self.discount_amount = -self.discount_amount
187 else:
188 df.set("print_hide", 1)
189
prssanna71e5b602020-10-29 14:19:34 +0530190 set_print_templates_for_item_table(self, settings)
191 set_print_templates_for_taxes(self, settings)
192
Mangesh-Khairnar7bcb24e2019-09-11 10:49:33 +0530193 def calculate_paid_amount(self):
Saurabh43520f92016-03-21 18:32:48 +0530194 if hasattr(self, "is_pos") or hasattr(self, "is_paid"):
195 is_paid = self.get("is_pos") or self.get("is_paid")
Mangesh-Khairnar7bcb24e2019-09-11 10:49:33 +0530196
197 if is_paid:
198 if not self.cash_bank_account:
199 # show message that the amount is not paid
200 frappe.throw(_("Note: Payment Entry will not be created since 'Cash or Bank Account' was not specified"))
Marica23d7b092019-09-25 17:17:36 +0530201
Mangesh-Khairnar7bcb24e2019-09-11 10:49:33 +0530202 if cint(self.is_return) and self.grand_total > self.paid_amount:
203 self.paid_amount = flt(flt(self.grand_total), self.precision("paid_amount"))
204
205 elif not flt(self.paid_amount) and flt(self.outstanding_amount) > 0:
206 self.paid_amount = flt(flt(self.outstanding_amount), self.precision("paid_amount"))
207
208 self.base_paid_amount = flt(self.paid_amount * self.conversion_rate,
209 self.precision("base_paid_amount"))
Saurabh43520f92016-03-21 18:32:48 +0530210
Anand Doshiabc10032013-06-14 17:44:03 +0530211 def set_missing_values(self, for_validate=False):
Rohit Waghchaure5d97d892016-05-12 12:58:29 +0530212 if frappe.flags.in_test:
tunde62af5c52017-09-22 15:16:38 +0100213 for fieldname in ["posting_date", "transaction_date"]:
Rohit Waghchaure5d97d892016-05-12 12:58:29 +0530214 if self.meta.get_field(fieldname) and not self.get(fieldname):
215 self.set(fieldname, today())
216 break
Anand Doshid2946502014-04-08 20:10:03 +0530217
Nabin Hait3237c752015-02-17 11:11:11 +0530218 def calculate_taxes_and_totals(self):
Nabin Haitfe81da22015-02-18 12:23:18 +0530219 from erpnext.controllers.taxes_and_totals import calculate_taxes_and_totals
220 calculate_taxes_and_totals(self)
Nabin Hait3237c752015-02-17 11:11:11 +0530221
222 if self.doctype in ["Quotation", "Sales Order", "Delivery Note", "Sales Invoice"]:
223 self.calculate_commission()
224 self.calculate_contribution()
225
Nabin Haitcfecd2b2013-07-11 17:49:18 +0530226 def validate_date_with_fiscal_year(self):
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800227 if self.meta.get_field("fiscal_year"):
Rohan Bansal1e3a3b22021-05-26 15:18:10 +0530228 date_field = None
Nabin Haitcfecd2b2013-07-11 17:49:18 +0530229 if self.meta.get_field("posting_date"):
230 date_field = "posting_date"
231 elif self.meta.get_field("transaction_date"):
232 date_field = "transaction_date"
Anand Doshid2946502014-04-08 20:10:03 +0530233
Rushabh Mehtaf2227d02014-03-31 23:37:40 +0530234 if date_field and self.get(date_field):
Rushabh Mehta66958302017-01-16 16:57:53 +0530235 validate_fiscal_year(self.get(date_field), self.fiscal_year, self.company,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800236 self.meta.get_label(date_field), self)
Anand Doshid2946502014-04-08 20:10:03 +0530237
Deepesh Garg4c8d15b2021-04-26 15:24:34 +0530238 def validate_party_accounts(self):
239 if self.doctype not in ('Sales Invoice', 'Purchase Invoice'):
240 return
241
242 if self.doctype == 'Sales Invoice':
243 party_account_field = 'debit_to'
244 item_field = 'income_account'
245 else:
246 party_account_field = 'credit_to'
247 item_field = 'expense_account'
248
249 for item in self.get('items'):
250 if item.get(item_field) == self.get(party_account_field):
251 frappe.throw(_("Row {0}: {1} {2} cannot be same as {3} (Party Account) {4}").format(item.idx,
252 frappe.bold(frappe.unscrub(item_field)), item.get(item_field),
253 frappe.bold(frappe.unscrub(party_account_field)), self.get(party_account_field)))
254
Deepesh Gargb4be2922021-01-28 13:09:56 +0530255 def validate_inter_company_reference(self):
256 if self.doctype not in ('Purchase Invoice', 'Purchase Receipt', 'Purchase Order'):
257 return
258
259 if self.is_internal_transfer():
260 if not (self.get('inter_company_reference') or self.get('inter_company_invoice_reference')
261 or self.get('inter_company_order_reference')):
Deepesh Garg4c8d15b2021-04-26 15:24:34 +0530262 msg = _("Internal Sale or Delivery Reference missing.")
Deepesh Gargb4be2922021-01-28 13:09:56 +0530263 msg += _("Please create purchase from internal sale or delivery document itself")
264 frappe.throw(msg, title=_("Internal Sales Reference Missing"))
265
Nabin Haite9daefe2014-08-27 16:46:33 +0530266 def validate_due_date(self):
rohitwaghchaureea943c62018-07-06 12:28:58 +0530267 if self.get('is_pos'): return
268
Nabin Haite9daefe2014-08-27 16:46:33 +0530269 from erpnext.accounts.party import validate_due_date
270 if self.doctype == "Sales Invoice":
Nabin Hait04d244a2015-07-22 17:47:49 +0530271 if not self.due_date:
272 frappe.throw(_("Due Date is mandatory"))
Rushabh Mehtab16b9cd2015-08-03 16:13:33 +0530273
rohitwaghchaure3ffe8962018-07-13 17:40:48 +0530274 validate_due_date(self.posting_date, self.due_date,
275 "Customer", self.customer, self.company, self.payment_terms_template)
Nabin Haite9daefe2014-08-27 16:46:33 +0530276 elif self.doctype == "Purchase Invoice":
Rohit Waghchaured1a85a32018-11-26 18:42:29 +0530277 validate_due_date(self.bill_date or self.posting_date, self.due_date,
Saurabhd7897f12018-07-18 17:08:16 +0530278 "Supplier", self.supplier, self.company, self.bill_date, self.payment_terms_template)
Nabin Haite9daefe2014-08-27 16:46:33 +0530279
Nabin Hait096d3632013-10-17 17:01:14 +0530280 def set_price_list_currency(self, buying_or_selling):
Nabin Hait1cc55fb2016-12-08 14:09:23 +0530281 if self.meta.get_field("posting_date"):
Nabin Hait288a18e2016-12-08 15:36:23 +0530282 transaction_date = self.posting_date
Nabin Hait1cc55fb2016-12-08 14:09:23 +0530283 else:
Nabin Hait288a18e2016-12-08 15:36:23 +0530284 transaction_date = self.transaction_date
Rushabh Mehta66958302017-01-16 16:57:53 +0530285
Rushabh Mehta4a404e92013-08-09 18:11:35 +0530286 if self.meta.get_field("currency"):
Nabin Hait7a75e102013-09-17 10:21:20 +0530287 # price list part
Shreya3f778522018-05-15 16:59:20 +0530288 if buying_or_selling.lower() == "selling":
289 fieldname = "selling_price_list"
290 args = "for_selling"
291 else:
292 fieldname = "buying_price_list"
293 args = "for_buying"
294
Anand Doshif78d1ae2014-03-28 13:55:00 +0530295 if self.meta.get_field(fieldname) and self.get(fieldname):
296 self.price_list_currency = frappe.db.get_value("Price List",
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800297 self.get(fieldname), "currency")
Anand Doshid2946502014-04-08 20:10:03 +0530298
Nabin Hait6e439a52015-08-28 19:24:22 +0530299 if self.price_list_currency == self.company_currency:
Anand Doshif78d1ae2014-03-28 13:55:00 +0530300 self.plc_conversion_rate = 1.0
Nabin Hait11f41952013-09-24 14:36:55 +0530301
Anand Doshif78d1ae2014-03-28 13:55:00 +0530302 elif not self.plc_conversion_rate:
Rushabh Mehta66958302017-01-16 16:57:53 +0530303 self.plc_conversion_rate = get_exchange_rate(self.price_list_currency,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800304 self.company_currency, transaction_date, args)
Anand Doshid2946502014-04-08 20:10:03 +0530305
Nabin Hait7a75e102013-09-17 10:21:20 +0530306 # currency
Anand Doshif78d1ae2014-03-28 13:55:00 +0530307 if not self.currency:
308 self.currency = self.price_list_currency
309 self.conversion_rate = self.plc_conversion_rate
Nabin Hait6e439a52015-08-28 19:24:22 +0530310 elif self.currency == self.company_currency:
Anand Doshif78d1ae2014-03-28 13:55:00 +0530311 self.conversion_rate = 1.0
312 elif not self.conversion_rate:
Anand Doshidffec8f2014-07-01 17:45:15 +0530313 self.conversion_rate = get_exchange_rate(self.currency,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800314 self.company_currency, transaction_date, args)
Nabin Hait7a75e102013-09-17 10:21:20 +0530315
Nabin Haitcccc45e2016-10-05 17:15:43 +0530316 def set_missing_item_details(self, for_validate=False):
Anand Doshi3543f302013-05-24 19:25:01 +0530317 """set missing item values"""
Nabin Haitf37d43d2017-07-18 12:14:42 +0530318 from erpnext.stock.doctype.serial_no.serial_no import get_serial_nos
Rushabh Mehtab46069d2016-01-15 16:59:26 +0530319
Nabin Haitdd38a262014-12-26 13:15:21 +0530320 if hasattr(self, "items"):
Nabin Hait444f9562014-06-20 15:59:49 +0530321 parent_dict = {}
Pratik Vyasf7daab72014-04-10 17:53:30 +0530322 for fieldname in self.meta.get_valid_columns():
323 parent_dict[fieldname] = self.get(fieldname)
324
mbauskara52472c2016-03-05 15:10:25 +0530325 if self.doctype in ["Quotation", "Sales Order", "Delivery Note", "Sales Invoice"]:
326 document_type = "{} Item".format(self.doctype)
mbauskarc97becb2016-01-18 16:28:21 +0530327 parent_dict.update({"document_type": document_type})
328
Nabin Hait34c551d2019-07-03 10:34:31 +0530329 # party_name field used for customer in quotation
330 if self.doctype == "Quotation" and self.quotation_to == "Customer" and parent_dict.get("party_name"):
331 parent_dict.update({"customer": parent_dict.get("party_name")})
332
Rohit Waghchaurea248dfb2020-07-16 17:27:26 +0530333 self.pricing_rules = []
Nabin Haitdd38a262014-12-26 13:15:21 +0530334 for item in self.get("items"):
Rushabh Mehtaf14b8092014-04-03 14:30:42 +0530335 if item.get("item_code"):
Nabin Hait444f9562014-06-20 15:59:49 +0530336 args = parent_dict.copy()
337 args.update(item.as_dict())
Rushabh Mehtab46069d2016-01-15 16:59:26 +0530338
Nabin Hait34d28222016-01-19 15:45:49 +0530339 args["doctype"] = self.doctype
340 args["name"] = self.name
Rohit Waghchaure8bfe3302019-03-18 14:34:19 +0530341 args["child_docname"] = item.name
Saqibac9e6ff2021-01-28 17:58:55 +0530342 args["ignore_pricing_rule"] = self.ignore_pricing_rule if hasattr(self, 'ignore_pricing_rule') else 0
Rushabh Mehtab46069d2016-01-15 16:59:26 +0530343
Nabin Haite2f054c2015-03-09 14:54:37 +0530344 if not args.get("transaction_date"):
345 args["transaction_date"] = args.get("posting_date")
Anand Doshi2b2b6392015-03-20 14:18:09 +0530346
347 if self.get("is_subcontracted"):
348 args["is_subcontracted"] = self.is_subcontracted
Rohit Waghchaure8bfe3302019-03-18 14:34:19 +0530349
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530350 ret = get_item_details(args, self, for_validate=True, overwrite_warehouse=False)
Rohit Waghchaure8bfe3302019-03-18 14:34:19 +0530351
Rushabh Mehtaf14b8092014-04-03 14:30:42 +0530352 for fieldname, value in ret.items():
Anand Doshi602e8252015-11-16 19:05:46 +0530353 if item.meta.get_field(fieldname) and value is not None:
354 if (item.get(fieldname) is None or fieldname in force_item_fields):
Rushabh Mehtaf14b8092014-04-03 14:30:42 +0530355 item.set(fieldname, value)
Anand Doshid2946502014-04-08 20:10:03 +0530356
Rohit Waghchauredc981dc2017-04-03 14:17:08 +0530357 elif fieldname in ['cost_center', 'conversion_factor'] and not item.get(fieldname):
Anand Doshi602e8252015-11-16 19:05:46 +0530358 item.set(fieldname, value)
359
Rohit Waghchauredc981dc2017-04-03 14:17:08 +0530360 elif fieldname == "serial_no":
Alchez9155e402018-07-09 16:57:42 +0530361 # Ensure that serial numbers are matched against Stock UOM
362 item_conversion_factor = item.get("conversion_factor") or 1.0
363 item_qty = abs(item.get("qty")) * item_conversion_factor
Alchez8f2a0f32018-07-06 14:36:52 +0530364
365 if item_qty != len(get_serial_nos(item.get('serial_no'))):
Rohit Waghchauredc981dc2017-04-03 14:17:08 +0530366 item.set(fieldname, value)
Nabin Haita74468b2014-12-30 18:33:52 +0530367
Rohit Waghchauref6f503a2018-12-19 15:06:44 +0530368 if self.doctype in ["Purchase Invoice", "Sales Invoice"] and item.meta.get_field('is_fixed_asset'):
369 item.set('is_fixed_asset', ret.get('is_fixed_asset', 0))
370
Deepesh Garga60c3082021-05-11 16:38:33 +0530371 # Double check for cost center
372 # Items add via promotional scheme may not have cost center set
373 if hasattr(item, 'cost_center') and not item.get('cost_center'):
374 item.set('cost_center', self.get('cost_center') or erpnext.get_default_cost_center(self.company))
375
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530376 if ret.get("pricing_rules"):
377 self.apply_pricing_rule_on_items(item, ret)
Rohit Waghchaurea248dfb2020-07-16 17:27:26 +0530378 self.set_pricing_rule_details(item, ret)
Rushabh Mehtab46069d2016-01-15 16:59:26 +0530379
Nabin Hait14aa9c52016-04-18 15:54:01 +0530380 if self.doctype == "Purchase Invoice":
Nabin Haitcccc45e2016-10-05 17:15:43 +0530381 self.set_expense_account(for_validate)
Nabin Haita3dd72a2014-05-28 12:49:20 +0530382
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530383 def apply_pricing_rule_on_items(self, item, pricing_rule_args):
384 if not pricing_rule_args.get("validate_applied_rule", 0):
385 # if user changed the discount percentage then set user's discount percentage ?
386 if pricing_rule_args.get("price_or_product_discount") == 'Price':
387 item.set("pricing_rules", pricing_rule_args.get("pricing_rules"))
388 item.set("discount_percentage", pricing_rule_args.get("discount_percentage"))
389 item.set("discount_amount", pricing_rule_args.get("discount_amount"))
390 if pricing_rule_args.get("pricing_rule_for") == "Rate":
391 item.set("price_list_rate", pricing_rule_args.get("price_list_rate"))
392
393 if item.get("price_list_rate"):
394 item.rate = flt(item.price_list_rate *
395 (1.0 - (flt(item.discount_percentage) / 100.0)), item.precision("rate"))
396
397 if item.get('discount_amount'):
398 item.rate = item.price_list_rate - item.discount_amount
399
Rohit Waghchaurea248dfb2020-07-16 17:27:26 +0530400 if item.get("apply_discount_on_discounted_rate") and pricing_rule_args.get("rate"):
401 item.rate = pricing_rule_args.get("rate")
402
Rohit Waghchaure21fe97e2019-12-13 16:18:38 +0530403 elif pricing_rule_args.get('free_item_data'):
404 apply_pricing_rule_for_free_items(self, pricing_rule_args.get('free_item_data'))
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530405
406 elif pricing_rule_args.get("validate_applied_rule"):
Rushabh Mehtaff5d1962020-08-25 11:59:57 +0530407 for pricing_rule in get_applied_pricing_rules(item.get('pricing_rules')):
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530408 pricing_rule_doc = frappe.get_cached_doc("Pricing Rule", pricing_rule)
409 for field in ['discount_percentage', 'discount_amount', 'rate']:
410 if item.get(field) < pricing_rule_doc.get(field):
411 title = get_link_to_form("Pricing Rule", pricing_rule)
412
413 frappe.msgprint(_("Row {0}: user has not applied the rule {1} on the item {2}")
414 .format(item.idx, frappe.bold(title), frappe.bold(item.item_code)))
415
Rohit Waghchaurea248dfb2020-07-16 17:27:26 +0530416 def set_pricing_rule_details(self, item_row, args):
417 pricing_rules = get_applied_pricing_rules(args.get("pricing_rules"))
418 if not pricing_rules: return
419
420 for pricing_rule in pricing_rules:
421 self.append("pricing_rules", {
422 "pricing_rule": pricing_rule,
423 "item_code": item_row.item_code,
424 "child_docname": item_row.name,
425 "rule_applied": True
426 })
427
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530428 def set_taxes(self):
429 if not self.meta.get_field("taxes"):
Anand Doshi3543f302013-05-24 19:25:01 +0530430 return
Anand Doshid2946502014-04-08 20:10:03 +0530431
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530432 tax_master_doctype = self.meta.get_field("taxes_and_charges").options
Anand Doshid2946502014-04-08 20:10:03 +0530433
rohitwaghchaure57914f12018-04-24 19:19:47 +0530434 if (self.is_new() or self.is_pos_profile_changed()) and not self.get("taxes"):
rohitwaghchaure505661b2017-12-11 14:52:28 +0530435 if self.company and not self.get("taxes_and_charges"):
Anand Doshi3543f302013-05-24 19:25:01 +0530436 # get the default tax master
rohitwaghchaure505661b2017-12-11 14:52:28 +0530437 self.taxes_and_charges = frappe.db.get_value(tax_master_doctype,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800438 {"is_default": 1, 'company': self.company})
Anand Doshid2946502014-04-08 20:10:03 +0530439
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530440 self.append_taxes_from_master(tax_master_doctype)
Anand Doshid2946502014-04-08 20:10:03 +0530441
rohitwaghchaure57914f12018-04-24 19:19:47 +0530442 def is_pos_profile_changed(self):
443 if (self.doctype == 'Sales Invoice' and self.is_pos and
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800444 self.pos_profile != frappe.db.get_value('Sales Invoice', self.name, 'pos_profile')):
rohitwaghchaure57914f12018-04-24 19:19:47 +0530445 return True
446
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530447 def append_taxes_from_master(self, tax_master_doctype=None):
448 if self.get("taxes_and_charges"):
Anand Doshi99100a42013-07-04 17:13:53 +0530449 if not tax_master_doctype:
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530450 tax_master_doctype = self.meta.get_field("taxes_and_charges").options
Anand Doshid2946502014-04-08 20:10:03 +0530451
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530452 self.extend("taxes", get_taxes_and_charges(tax_master_doctype, self.get("taxes_and_charges")))
Akhilesh Darjee4cdb7992014-01-30 13:56:57 +0530453
Anand Doshiac32bad2014-04-18 01:30:14 +0530454 def set_other_charges(self):
Nabin Haite7d15362014-12-25 16:01:55 +0530455 self.set("taxes", [])
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530456 self.set_taxes()
Anand Doshid2946502014-04-08 20:10:03 +0530457
ankitjavalkarwork6c29d872014-10-06 13:20:53 +0530458 def validate_enabled_taxes_and_charges(self):
459 taxes_and_charges_doctype = self.meta.get_options("taxes_and_charges")
460 if frappe.db.get_value(taxes_and_charges_doctype, self.taxes_and_charges, "disabled"):
461 frappe.throw(_("{0} '{1}' is disabled").format(taxes_and_charges_doctype, self.taxes_and_charges))
462
Nabin Haita2426fc2018-01-15 17:45:46 +0530463 def validate_tax_account_company(self):
464 for d in self.get("taxes"):
465 if d.account_head:
466 tax_account_company = frappe.db.get_value("Account", d.account_head, "company")
467 if tax_account_company != self.company:
468 frappe.throw(_("Row #{0}: Account {1} does not belong to company {2}")
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800469 .format(d.idx, d.account_head, self.company))
Nabin Haita2426fc2018-01-15 17:45:46 +0530470
deepeshgarg0073d11ac02019-05-19 00:02:01 +0530471 def get_gl_dict(self, args, account_currency=None, item=None):
Nabin Hait2df4d542013-01-29 11:34:39 +0530472 """this method populates the common properties of a gl entry record"""
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +0530473
Rohit Waghchaureaa7b4342018-05-11 01:56:05 +0530474 posting_date = args.get('posting_date') or self.get('posting_date')
475 fiscal_years = get_fiscal_years(posting_date, company=self.company)
Nabin Hait2ed0b592016-03-29 13:14:17 +0530476 if len(fiscal_years) > 1:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800477 frappe.throw(_("Multiple fiscal years exist for the date {0}. Please set company in Fiscal Year").format(
478 formatdate(posting_date)))
Nabin Hait2ed0b592016-03-29 13:14:17 +0530479 else:
480 fiscal_year = fiscal_years[0][0]
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +0530481
Rushabh Mehta793ba6b2014-02-14 15:47:51 +0530482 gl_dict = frappe._dict({
Anand Doshid2946502014-04-08 20:10:03 +0530483 'company': self.company,
Rohit Waghchaureaa7b4342018-05-11 01:56:05 +0530484 'posting_date': posting_date,
Nabin Hait2ed0b592016-03-29 13:14:17 +0530485 'fiscal_year': fiscal_year,
Anand Doshif78d1ae2014-03-28 13:55:00 +0530486 'voucher_type': self.doctype,
487 'voucher_no': self.name,
Nabin Hait5cd04a62019-05-27 11:44:06 +0530488 'remarks': self.get("remarks") or self.get("remark"),
Nabin Hait2df4d542013-01-29 11:34:39 +0530489 'debit': 0,
490 'credit': 0,
Nabin Hait46bcbaf2015-08-19 13:49:10 +0530491 'debit_in_account_currency': 0,
492 'credit_in_account_currency': 0,
Anand Doshif78d1ae2014-03-28 13:55:00 +0530493 'is_opening': self.get("is_opening") or "No",
Nabin Hait32251022014-08-29 11:18:32 +0530494 'party_type': None,
Nabin Hait591a5ab2016-05-26 17:41:39 +0530495 'party': None,
496 'project': self.get("project")
Nabin Hait2e296fa2013-08-28 18:53:11 +0530497 })
deepeshgarg007d83cf652019-05-12 18:34:23 +0530498
499 accounting_dimensions = get_accounting_dimensions()
500 dimension_dict = frappe._dict()
501
502 for dimension in accounting_dimensions:
503 dimension_dict[dimension] = self.get(dimension)
deepeshgarg0073d11ac02019-05-19 00:02:01 +0530504 if item and item.get(dimension):
505 dimension_dict[dimension] = item.get(dimension)
deepeshgarg007d83cf652019-05-12 18:34:23 +0530506
507 gl_dict.update(dimension_dict)
Nabin Hait2df4d542013-01-29 11:34:39 +0530508 gl_dict.update(args)
Anand Doshi979326b2015-09-11 16:22:37 +0530509
Nabin Hait895029d2015-08-20 14:55:39 +0530510 if not account_currency:
Anand Doshicd0989e2015-09-28 13:31:17 +0530511 account_currency = get_account_currency(gl_dict.account)
Anand Doshi979326b2015-09-11 16:22:37 +0530512
Rushabh Mehtabc4e2cd2017-10-17 12:30:34 +0530513 if gl_dict.account and self.doctype not in ["Journal Entry",
Deepesh Gargbfc17e42020-12-25 18:34:39 +0530514 "Period Closing Voucher", "Payment Entry", "Purchase Receipt", "Purchase Invoice", "Stock Entry"]:
Anand Doshibe6cfdd2015-09-17 21:07:04 +0530515 self.validate_account_currency(gl_dict.account, account_currency)
Deepesh Garg7c300852020-12-26 20:14:51 +0530516
517 if gl_dict.account and self.doctype not in ["Journal Entry", "Period Closing Voucher", "Payment Entry"]:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800518 set_balance_in_account_currency(gl_dict, account_currency, self.get("conversion_rate"),
519 self.company_currency)
Anand Doshi979326b2015-09-11 16:22:37 +0530520
Nabin Haitc561a492015-08-19 19:22:34 +0530521 return gl_dict
Anand Doshi979326b2015-09-11 16:22:37 +0530522
Anurag Mishrae657fe82018-11-26 15:19:17 +0530523 def validate_qty_is_not_zero(self):
Maricac68a9402019-12-03 12:59:22 +0530524 if self.doctype != "Purchase Receipt":
525 for item in self.items:
526 if not item.qty:
527 frappe.throw(_("Item quantity can not be zero"))
Anurag Mishrae657fe82018-11-26 15:19:17 +0530528
Nabin Hait895029d2015-08-20 14:55:39 +0530529 def validate_account_currency(self, account, account_currency=None):
Nabin Hait6e439a52015-08-28 19:24:22 +0530530 valid_currency = [self.company_currency]
531 if self.get("currency") and self.currency != self.company_currency:
532 valid_currency.append(self.currency)
533
Nabin Hait895029d2015-08-20 14:55:39 +0530534 if account_currency not in valid_currency:
Nabin Hait4ffd7f32015-08-27 12:28:36 +0530535 frappe.throw(_("Account {0} is invalid. Account Currency must be {1}")
Suraj Shettyda6806e2020-04-08 09:32:41 +0530536 .format(account, (' ' + _("or") + ' ').join(valid_currency)))
Anand Doshi979326b2015-09-11 16:22:37 +0530537
Anand Doshi613cb6a2013-02-06 17:33:46 +0530538 def clear_unallocated_advances(self, childtype, parentfield):
Rushabh Mehtaf191f852014-04-02 18:09:34 +0530539 self.set(parentfield, self.get(parentfield, {"allocated_amount": ["not in", [0, None, ""]]}))
540
Anand Doshid2946502014-04-08 20:10:03 +0530541 frappe.db.sql("""delete from `tab%s` where parentfield=%s and parent = %s
Anand Doshi602e8252015-11-16 19:05:46 +0530542 and allocated_amount = 0""" % (childtype, '%s', '%s'), (parentfield, self.name))
Anand Doshid2946502014-04-08 20:10:03 +0530543
Walstan Baptistad6360752021-03-31 12:30:32 +0530544 @frappe.whitelist()
Rushabh Mehta30dc9a12017-11-17 14:31:09 +0530545 def apply_shipping_rule(self):
546 if self.shipping_rule:
547 shipping_rule = frappe.get_doc("Shipping Rule", self.shipping_rule)
548 shipping_rule.apply(self)
549 self.calculate_taxes_and_totals()
550
551 def get_shipping_address(self):
552 '''Returns Address object from shipping address fields if present'''
553
554 # shipping address fields can be `shipping_address_name` or `shipping_address`
555 # try getting value from both
556
557 for fieldname in ('shipping_address_name', 'shipping_address'):
558 shipping_field = self.meta.get_field(fieldname)
559 if shipping_field and shipping_field.fieldtype == 'Link':
560 if self.get(fieldname):
561 return frappe.get_doc('Address', self.get(fieldname))
562
563 return {}
564
Walstan Baptistad6360752021-03-31 12:30:32 +0530565 @frappe.whitelist()
Nabin Hait041a5c22018-08-01 18:07:39 +0530566 def set_advances(self):
567 """Returns list of advances against Account, Party, Reference"""
568
569 res = self.get_advance_entries()
570
571 self.set("advances", [])
572 advance_allocated = 0
573 for d in res:
574 if d.against_order:
575 allocated_amount = flt(d.amount)
576 else:
Deepesh Garg26210162020-08-11 16:06:13 +0530577 if self.get('party_account_currency') == self.company_currency:
578 amount = self.get('base_rounded_total') or self.base_grand_total
579 else:
580 amount = self.get('rounded_total') or self.grand_total
581
Rohit Waghchaure6cc2f522018-11-27 12:07:03 +0530582 allocated_amount = min(amount - advance_allocated, d.amount)
Nabin Hait041a5c22018-08-01 18:07:39 +0530583 advance_allocated += flt(allocated_amount)
Rushabh Mehta708e47a2018-08-08 16:37:31 +0530584
Saqiba20999c2021-07-12 14:33:23 +0530585 advance_row = {
Nabin Hait041a5c22018-08-01 18:07:39 +0530586 "doctype": self.doctype + " Advance",
587 "reference_type": d.reference_type,
588 "reference_name": d.reference_name,
589 "reference_row": d.reference_row,
590 "remarks": d.remarks,
591 "advance_amount": flt(d.amount),
Saqiba20999c2021-07-12 14:33:23 +0530592 "allocated_amount": allocated_amount,
593 "ref_exchange_rate": flt(d.exchange_rate) # exchange_rate of advance entry
594 }
595
596 self.append("advances", advance_row)
Nabin Hait041a5c22018-08-01 18:07:39 +0530597
Nabin Hait28a05282016-06-27 17:41:39 +0530598 def get_advance_entries(self, include_unallocated=True):
599 if self.doctype == "Sales Invoice":
600 party_account = self.debit_to
601 party_type = "Customer"
602 party = self.customer
603 amount_field = "credit_in_account_currency"
604 order_field = "sales_order"
605 order_doctype = "Sales Order"
606 else:
607 party_account = self.credit_to
608 party_type = "Supplier"
609 party = self.supplier
610 amount_field = "debit_in_account_currency"
611 order_field = "purchase_order"
612 order_doctype = "Purchase Order"
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530613
Ankush Menat98917802021-06-11 18:40:22 +0530614 order_list = list(set(d.get(order_field)
615 for d in self.get("items") if d.get(order_field)))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530616
617 journal_entries = get_advance_journal_entries(party_type, party, party_account,
Nabin Hait868766d2019-07-15 18:02:58 +0530618 amount_field, order_doctype, order_list, include_unallocated)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530619
620 payment_entries = get_advance_payment_entries(party_type, party, party_account,
Nabin Hait868766d2019-07-15 18:02:58 +0530621 order_doctype, order_list, include_unallocated)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530622
Nabin Hait28a05282016-06-27 17:41:39 +0530623 res = journal_entries + payment_entries
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530624
Nabin Hait28a05282016-06-27 17:41:39 +0530625 return res
Nabin Hait48f5fa62014-09-18 15:03:54 +0530626
rohitwaghchaurebf4c1142018-01-08 15:20:15 +0530627 def is_inclusive_tax(self):
Nabin Hait868766d2019-07-15 18:02:58 +0530628 is_inclusive = cint(frappe.db.get_single_value("Accounts Settings", "show_inclusive_tax_in_print"))
rohitwaghchaurebf4c1142018-01-08 15:20:15 +0530629
630 if is_inclusive:
631 is_inclusive = 0
632 if self.get("taxes", filters={"included_in_print_rate": 1}):
633 is_inclusive = 1
634
635 return is_inclusive
636
Nabin Hait28a05282016-06-27 17:41:39 +0530637 def validate_advance_entries(self):
Nabin Hait05aefbb2016-06-28 19:42:19 +0530638 order_field = "sales_order" if self.doctype == "Sales Invoice" else "purchase_order"
Ankush Menat98917802021-06-11 18:40:22 +0530639 order_list = list(set(d.get(order_field)
640 for d in self.get("items") if d.get(order_field)))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530641
Nabin Hait05aefbb2016-06-28 19:42:19 +0530642 if not order_list: return
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530643
Nabin Hait28a05282016-06-27 17:41:39 +0530644 advance_entries = self.get_advance_entries(include_unallocated=False)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530645
Nabin Hait28a05282016-06-27 17:41:39 +0530646 if advance_entries:
647 advance_entries_against_si = [d.reference_name for d in self.get("advances")]
648 for d in advance_entries:
649 if not advance_entries_against_si or d.reference_name not in advance_entries_against_si:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800650 frappe.msgprint(_(
651 "Payment Entry {0} is linked against Order {1}, check if it should be pulled as advance in this invoice.")
Nabin Hait868766d2019-07-15 18:02:58 +0530652 .format(d.reference_name, d.against_order))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530653
Saqiba20999c2021-07-12 14:33:23 +0530654 def set_advance_gain_or_loss(self):
655 if not self.get("advances"):
656 return
657
658 for d in self.get("advances"):
659 advance_exchange_rate = d.ref_exchange_rate
660 if (d.allocated_amount and self.conversion_rate != 1
661 and self.conversion_rate != advance_exchange_rate):
662
663 base_allocated_amount_in_ref_rate = advance_exchange_rate * d.allocated_amount
664 base_allocated_amount_in_inv_rate = self.conversion_rate * d.allocated_amount
665 difference = base_allocated_amount_in_ref_rate - base_allocated_amount_in_inv_rate
666
667 d.exchange_gain_loss = difference
668
669 def make_exchange_gain_loss_gl_entries(self, gl_entries):
670 if self.get('doctype') in ['Purchase Invoice', 'Sales Invoice']:
671 for d in self.get("advances"):
672 if d.exchange_gain_loss:
Saqibd4ae1fe2021-07-30 11:21:49 +0530673 is_purchase_invoice = self.get('doctype') == 'Purchase Invoice'
674 party = self.supplier if is_purchase_invoice else self.customer
675 party_account = self.credit_to if is_purchase_invoice else self.debit_to
676 party_type = "Supplier" if is_purchase_invoice else "Customer"
Saqiba20999c2021-07-12 14:33:23 +0530677
678 gain_loss_account = frappe.db.get_value('Company', self.company, 'exchange_gain_loss_account')
Saqibd4ae1fe2021-07-30 11:21:49 +0530679 if not gain_loss_account:
680 frappe.throw(_("Please set Default Exchange Gain/Loss Account in Company {}")
681 .format(self.get('company')))
Saqiba20999c2021-07-12 14:33:23 +0530682 account_currency = get_account_currency(gain_loss_account)
683 if account_currency != self.company_currency:
Saqibd4ae1fe2021-07-30 11:21:49 +0530684 frappe.throw(_("Currency for {0} must be {1}").format(gain_loss_account, self.company_currency))
Saqiba20999c2021-07-12 14:33:23 +0530685
686 # for purchase
687 dr_or_cr = 'debit' if d.exchange_gain_loss > 0 else 'credit'
Saqibd4ae1fe2021-07-30 11:21:49 +0530688 if not is_purchase_invoice:
689 # just reverse for sales?
690 dr_or_cr = 'debit' if dr_or_cr == 'credit' else 'credit'
Saqiba20999c2021-07-12 14:33:23 +0530691
692 gl_entries.append(
693 self.get_gl_dict({
694 "account": gain_loss_account,
695 "account_currency": account_currency,
696 "against": party,
697 dr_or_cr + "_in_account_currency": abs(d.exchange_gain_loss),
698 dr_or_cr: abs(d.exchange_gain_loss),
699 "cost_center": self.cost_center,
700 "project": self.project
701 }, item=d)
702 )
703
704 dr_or_cr = 'debit' if dr_or_cr == 'credit' else 'credit'
705
706 gl_entries.append(
707 self.get_gl_dict({
708 "account": party_account,
709 "party_type": party_type,
710 "party": party,
711 "against": gain_loss_account,
712 dr_or_cr + "_in_account_currency": flt(abs(d.exchange_gain_loss) / self.conversion_rate),
713 dr_or_cr: abs(d.exchange_gain_loss),
714 "cost_center": self.cost_center,
715 "project": self.project
716 }, self.party_account_currency, item=self)
717 )
718
Nabin Hait28a05282016-06-27 17:41:39 +0530719 def update_against_document_in_jv(self):
720 """
721 Links invoice and advance voucher:
722 1. cancel advance voucher
723 2. split into multiple rows if partially adjusted, assign against voucher
724 3. submit advance voucher
725 """
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530726
Nabin Hait28a05282016-06-27 17:41:39 +0530727 if self.doctype == "Sales Invoice":
Nabin Haitff2f3ef2016-07-04 11:41:14 +0530728 party_type = "Customer"
Nabin Hait28a05282016-06-27 17:41:39 +0530729 party = self.customer
730 party_account = self.debit_to
731 dr_or_cr = "credit_in_account_currency"
732 else:
Nabin Haitff2f3ef2016-07-04 11:41:14 +0530733 party_type = "Supplier"
Nabin Hait28a05282016-06-27 17:41:39 +0530734 party = self.supplier
735 party_account = self.credit_to
736 dr_or_cr = "debit_in_account_currency"
Nabin Hait48f5fa62014-09-18 15:03:54 +0530737
Nabin Hait28a05282016-06-27 17:41:39 +0530738 lst = []
739 for d in self.get('advances'):
740 if flt(d.allocated_amount) > 0:
741 args = frappe._dict({
742 'voucher_type': d.reference_type,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800743 'voucher_no': d.reference_name,
744 'voucher_detail_no': d.reference_row,
745 'against_voucher_type': self.doctype,
746 'against_voucher': self.name,
747 'account': party_account,
Nabin Haitff2f3ef2016-07-04 11:41:14 +0530748 'party_type': party_type,
Nabin Hait28a05282016-06-27 17:41:39 +0530749 'party': party,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800750 'is_advance': 'Yes',
751 'dr_or_cr': dr_or_cr,
752 'unadjusted_amount': flt(d.advance_amount),
753 'allocated_amount': flt(d.allocated_amount),
Deepesh Gargf54d5962021-03-31 14:06:02 +0530754 'precision': d.precision('advance_amount'),
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530755 'exchange_rate': (self.conversion_rate
Nabin Hait868766d2019-07-15 18:02:58 +0530756 if self.party_account_currency != self.company_currency else 1),
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530757 'grand_total': (self.base_grand_total
Nabin Hait868766d2019-07-15 18:02:58 +0530758 if self.party_account_currency == self.company_currency else self.grand_total),
Saqiba20999c2021-07-12 14:33:23 +0530759 'outstanding_amount': self.outstanding_amount,
760 'difference_account': frappe.db.get_value('Company', self.company, 'exchange_gain_loss_account'),
761 'exchange_gain_loss': flt(d.get('exchange_gain_loss'))
Nabin Hait28a05282016-06-27 17:41:39 +0530762 })
763 lst.append(args)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530764
Nabin Hait28a05282016-06-27 17:41:39 +0530765 if lst:
766 from erpnext.accounts.utils import reconcile_against_document
767 reconcile_against_document(lst)
Anand Doshid2946502014-04-08 20:10:03 +0530768
Rohit Waghchaure5fa9a7a2019-04-01 00:40:38 +0530769 def on_cancel(self):
770 from erpnext.accounts.utils import unlink_ref_doc_from_payment_entries
771
772 if self.doctype in ["Sales Invoice", "Purchase Invoice"]:
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530773 self.update_allocated_advance_taxes_on_cancel()
Rohit Waghchaure5fa9a7a2019-04-01 00:40:38 +0530774 if frappe.db.get_single_value('Accounts Settings', 'unlink_payment_on_cancellation_of_invoice'):
775 unlink_ref_doc_from_payment_entries(self)
776
777 elif self.doctype in ["Sales Order", "Purchase Order"]:
Rohit Waghchaure9835c892019-04-01 01:02:06 +0530778 if frappe.db.get_single_value('Accounts Settings', 'unlink_advance_payment_on_cancelation_of_order'):
Rohit Waghchaure5fa9a7a2019-04-01 00:40:38 +0530779 unlink_ref_doc_from_payment_entries(self)
780
Deepesh Gargd18dde72020-11-29 21:40:04 +0530781 def get_tax_map(self):
782 tax_map = {}
783 for tax in self.get('taxes'):
784 tax_map.setdefault(tax.account_head, 0.0)
785 tax_map[tax.account_head] += tax.tax_amount
786
787 return tax_map
788
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530789 def update_allocated_advance_taxes_on_cancel(self):
Deepesh Gargd18dde72020-11-29 21:40:04 +0530790 if self.get('advances'):
791 tax_accounts = [d.account_head for d in self.get('taxes')]
792 allocated_tax_map = frappe._dict(frappe.get_all('GL Entry', fields=['account', 'sum(credit - debit)'],
793 filters={'voucher_no': self.name, 'account': ('in', tax_accounts)},
794 group_by='account', as_list=1))
795
796 tax_map = self.get_tax_map()
797
798 for pe in self.get('advances'):
Deepesh Garga23aaf42021-05-17 20:58:50 +0530799 if pe.reference_type == 'Payment Entry':
800 pe = frappe.get_doc('Payment Entry', pe.reference_name)
801 for tax in pe.get('taxes'):
802 allocated_amount = tax_map.get(tax.account_head) - allocated_tax_map.get(tax.account_head)
803 if allocated_amount > tax.tax_amount:
804 allocated_amount = tax.tax_amount
Deepesh Gargd18dde72020-11-29 21:40:04 +0530805
Deepesh Garga23aaf42021-05-17 20:58:50 +0530806 if allocated_amount:
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530807 frappe.db.set_value('Advance Taxes and Charges', tax.name, 'allocated_amount',
808 tax.allocated_amount - allocated_amount)
Deepesh Garga23aaf42021-05-17 20:58:50 +0530809 tax_map[tax.account_head] -= allocated_amount
810 allocated_tax_map[tax.account_head] -= allocated_amount
Deepesh Gargd18dde72020-11-29 21:40:04 +0530811
Deepesh Garg92f7a5a2021-07-21 15:25:40 +0530812 def get_amount_and_base_amount(self, item, enable_discount_accounting):
813 amount = item.net_amount
814 base_amount = item.base_net_amount
815
816 if enable_discount_accounting and self.get('discount_amount') and self.get('additional_discount_account'):
817 amount = item.amount
818 base_amount = item.base_amount
819
820 return amount, base_amount
821
822 def get_tax_amounts(self, tax, enable_discount_accounting):
823 amount = tax.tax_amount_after_discount_amount
824 base_amount = tax.base_tax_amount_after_discount_amount
825
826 if enable_discount_accounting and self.get('discount_amount') and self.get('additional_discount_account') \
827 and self.get('apply_discount_on') == 'Grand Total':
828 amount = tax.tax_amount
829 base_amount = tax.base_tax_amount
830
831 return amount, base_amount
832
GangaManoj8f7b0a12021-07-13 03:01:02 +0530833 def make_discount_gl_entries(self, gl_entries):
834 enable_discount_accounting = cint(frappe.db.get_single_value('Accounts Settings', 'enable_discount_accounting'))
835
836 if enable_discount_accounting:
GangaManoj4105e272021-07-20 03:46:02 +0530837 if self.doctype == "Purchase Invoice":
838 dr_or_cr = "credit"
839 rev_dr_cr = "debit"
840 supplier_or_customer = self.supplier
Ankush Menat4551d7d2021-08-19 13:41:10 +0530841
GangaManoj4105e272021-07-20 03:46:02 +0530842 else:
843 dr_or_cr = "debit"
844 rev_dr_cr = "credit"
845 supplier_or_customer = self.customer
846
GangaManoj8f7b0a12021-07-13 03:01:02 +0530847 for item in self.get("items"):
848 if item.get('discount_amount') and item.get('discount_account'):
Deepesh Gargad7bb312021-07-28 11:38:44 +0530849 discount_amount = item.discount_amount * item.qty
GangaManoj8f7b0a12021-07-13 03:01:02 +0530850 if self.doctype == "Purchase Invoice":
GangaManoj8f7b0a12021-07-13 03:01:02 +0530851 income_or_expense_account = (item.expense_account
Ankush Menat4551d7d2021-08-19 13:41:10 +0530852 if (not item.enable_deferred_expense or self.is_return)
GangaManoj8f7b0a12021-07-13 03:01:02 +0530853 else item.deferred_expense_account)
854 else:
GangaManoj8f7b0a12021-07-13 03:01:02 +0530855 income_or_expense_account = (item.income_account
Ankush Menat4551d7d2021-08-19 13:41:10 +0530856 if (not item.enable_deferred_revenue or self.is_return)
GangaManoj8f7b0a12021-07-13 03:01:02 +0530857 else item.deferred_revenue_account)
858
859 account_currency = get_account_currency(item.discount_account)
860 gl_entries.append(
861 self.get_gl_dict({
862 "account": item.discount_account,
863 "against": supplier_or_customer,
Deepesh Gargad7bb312021-07-28 11:38:44 +0530864 dr_or_cr: flt(discount_amount, item.precision('discount_amount')),
Ankush Menat4551d7d2021-08-19 13:41:10 +0530865 dr_or_cr + "_in_account_currency": flt(discount_amount * self.get('conversion_rate'),
Deepesh Gargad7bb312021-07-28 11:38:44 +0530866 item.precision('discount_amount')),
Ganga Manoj980798c2021-07-19 23:43:36 +0530867 "cost_center": item.cost_center,
Ganga Manoj63b7ecd2021-07-19 23:44:21 +0530868 "project": item.project
Ganga Manoj0ea29342021-07-19 23:44:55 +0530869 }, account_currency, item=item)
GangaManoj8f7b0a12021-07-13 03:01:02 +0530870 )
871
872 account_currency = get_account_currency(income_or_expense_account)
873 gl_entries.append(
874 self.get_gl_dict({
875 "account": income_or_expense_account,
876 "against": supplier_or_customer,
Deepesh Gargad7bb312021-07-28 11:38:44 +0530877 rev_dr_cr: flt(discount_amount, item.precision('discount_amount')),
Ankush Menat4551d7d2021-08-19 13:41:10 +0530878 rev_dr_cr + "_in_account_currency": flt(discount_amount * self.get('conversion_rate'),
Deepesh Gargad7bb312021-07-28 11:38:44 +0530879 item.precision('discount_amount')),
GangaManoj8f7b0a12021-07-13 03:01:02 +0530880 "cost_center": item.cost_center,
881 "project": item.project or self.project
882 }, account_currency, item=item)
883 )
GangaManoj857501c2021-07-15 22:03:46 +0530884
GangaManoj4105e272021-07-20 03:46:02 +0530885 if self.get('discount_amount') and self.get('additional_discount_account'):
GangaManoj857501c2021-07-15 22:03:46 +0530886 gl_entries.append(
887 self.get_gl_dict({
888 "account": self.additional_discount_account,
GangaManoj4105e272021-07-20 03:46:02 +0530889 "against": supplier_or_customer,
890 dr_or_cr: self.discount_amount,
891 "cost_center": self.cost_center
892 }, item=self)
Ankush Menat4551d7d2021-08-19 13:41:10 +0530893 )
894
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530895 def allocate_advance_taxes(self, gl_entries):
896 tax_map = self.get_tax_map()
897 for pe in self.get("advances"):
Deepesh Garg911818a2021-06-09 22:55:10 +0530898 if pe.reference_type == "Payment Entry" and \
899 frappe.db.get_value('Payment Entry', pe.reference_name, 'advance_tax_account'):
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530900 pe = frappe.get_doc("Payment Entry", pe.reference_name)
901 for tax in pe.get("taxes"):
902 account_currency = get_account_currency(tax.account_head)
903
904 if self.doctype == "Purchase Invoice":
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530905 dr_or_cr = "debit" if tax.add_deduct_tax == "Add" else "credit"
906 rev_dr_cr = "credit" if tax.add_deduct_tax == "Add" else "debit"
Deepesh Garg4478c542021-07-13 11:22:55 +0530907 else:
908 dr_or_cr = "credit" if tax.add_deduct_tax == "Add" else "debit"
909 rev_dr_cr = "debit" if tax.add_deduct_tax == "Add" else "credit"
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530910
911 party = self.supplier if self.doctype == "Purchase Invoice" else self.customer
912 unallocated_amount = tax.tax_amount - tax.allocated_amount
913 if tax_map.get(tax.account_head):
914 amount = tax_map.get(tax.account_head)
915 if amount < unallocated_amount:
916 unallocated_amount = amount
917
918 gl_entries.append(
919 self.get_gl_dict({
920 "account": tax.account_head,
921 "against": party,
922 dr_or_cr: unallocated_amount,
923 dr_or_cr + "_in_account_currency": unallocated_amount
924 if account_currency==self.company_currency
925 else unallocated_amount,
926 "cost_center": tax.cost_center
927 }, account_currency, item=tax))
928
929 gl_entries.append(
930 self.get_gl_dict({
931 "account": pe.advance_tax_account,
932 "against": party,
933 rev_dr_cr: unallocated_amount,
934 rev_dr_cr + "_in_account_currency": unallocated_amount
935 if account_currency==self.company_currency
936 else unallocated_amount,
937 "cost_center": tax.cost_center
938 }, account_currency, item=tax))
939
940 frappe.db.set_value("Advance Taxes and Charges", tax.name, "allocated_amount",
941 tax.allocated_amount + unallocated_amount)
942
943 tax_map[tax.account_head] -= unallocated_amount
944
Nabin Hait19d945a2013-07-29 18:35:39 +0530945 def validate_multiple_billing(self, ref_dt, item_ref_dn, based_on, parentfield):
Nabin Hait868766d2019-07-15 18:02:58 +0530946 from erpnext.controllers.status_updater import get_allowance_for
947 item_allowance = {}
948 global_qty_allowance, global_amount_allowance = None, None
Anand Doshid2946502014-04-08 20:10:03 +0530949
Nabin Hait4b8185d2014-12-25 18:19:39 +0530950 for item in self.get("items"):
Anand Doshif78d1ae2014-03-28 13:55:00 +0530951 if item.get(item_ref_dn):
Anand Doshid2946502014-04-08 20:10:03 +0530952 ref_amt = flt(frappe.db.get_value(ref_dt + " Item",
Nabin Hait868766d2019-07-15 18:02:58 +0530953 item.get(item_ref_dn), based_on), self.precision(based_on, item))
Nabin Haitdc15b4f2014-01-20 16:48:49 +0530954 if not ref_amt:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800955 frappe.msgprint(
Nabin Hait868766d2019-07-15 18:02:58 +0530956 _("Warning: System will not check overbilling since amount for Item {0} in {1} is zero")
957 .format(item.item_code, ref_dt))
Nabin Haitdc15b4f2014-01-20 16:48:49 +0530958 else:
Nabin Hait868766d2019-07-15 18:02:58 +0530959 already_billed = frappe.db.sql("""
960 select sum(%s)
961 from `tab%s`
962 where %s=%s and docstatus=1 and parent != %s
963 """ % (based_on, self.doctype + " Item", item_ref_dn, '%s', '%s'),
964 (item.get(item_ref_dn), self.name))[0][0]
Anand Doshid2946502014-04-08 20:10:03 +0530965
966 total_billed_amt = flt(flt(already_billed) + flt(item.get(based_on)),
Nabin Hait868766d2019-07-15 18:02:58 +0530967 self.precision(based_on, item))
Anand Doshid2946502014-04-08 20:10:03 +0530968
Nabin Hait868766d2019-07-15 18:02:58 +0530969 allowance, item_allowance, global_qty_allowance, global_amount_allowance = \
970 get_allowance_for(item.item_code, item_allowance, global_qty_allowance, global_amount_allowance, "amount")
Anand Doshid2946502014-04-08 20:10:03 +0530971
Nabin Hait868766d2019-07-15 18:02:58 +0530972 max_allowed_amt = flt(ref_amt * (100 + allowance) / 100)
Anand Doshid2946502014-04-08 20:10:03 +0530973
rohitwaghchaure285344e2019-10-11 11:02:11 +0530974 if total_billed_amt < 0 and max_allowed_amt < 0:
975 # while making debit note against purchase return entry(purchase receipt) getting overbill error
976 total_billed_amt = abs(total_billed_amt)
977 max_allowed_amt = abs(max_allowed_amt)
978
Deepesh Gargcb718fc2021-04-19 13:25:15 +0530979 role_allowed_to_over_bill = frappe.db.get_single_value('Accounts Settings', 'role_allowed_to_over_bill')
980
981 if total_billed_amt - max_allowed_amt > 0.01 and role_allowed_to_over_bill not in frappe.get_roles():
Afshan53fefd72021-06-24 10:09:02 +0530982 if self.doctype != "Purchase Invoice":
983 self.throw_overbill_exception(item, max_allowed_amt)
984 elif not cint(frappe.db.get_single_value("Buying Settings", "bill_for_rejected_quantity_in_purchase_invoice")):
985 self.throw_overbill_exception(item, max_allowed_amt)
986
987 def throw_overbill_exception(self, item, max_allowed_amt):
988 frappe.throw(_("Cannot overbill for Item {0} in row {1} more than {2}. To allow over-billing, please set allowance in Accounts Settings")
989 .format(item.item_code, item.idx, max_allowed_amt))
Anand Doshid2946502014-04-08 20:10:03 +0530990
Rohit Waghchaure2a14f252021-07-30 12:36:35 +0530991 def get_company_default(self, fieldname, ignore_validation=False):
Rushabh Mehta1f847992013-12-12 19:12:19 +0530992 from erpnext.accounts.utils import get_company_default
Rohit Waghchaure2a14f252021-07-30 12:36:35 +0530993 return get_company_default(self.company, fieldname, ignore_validation=ignore_validation)
Anand Doshid2946502014-04-08 20:10:03 +0530994
Nabin Haita36adbd2013-08-02 14:50:12 +0530995 def get_stock_items(self):
996 stock_items = []
Nabin Haitdd38a262014-12-26 13:15:21 +0530997 item_codes = list(set(item.item_code for item in self.get("items")))
Nabin Haita36adbd2013-08-02 14:50:12 +0530998 if item_codes:
Nabin Hait868766d2019-07-15 18:02:58 +0530999 stock_items = [r[0] for r in frappe.db.sql("""
1000 select name from `tabItem`
1001 where name in (%s) and is_stock_item=1
1002 """ % (", ".join((["%s"] * len(item_codes))),), item_codes)]
Anand Doshid2946502014-04-08 20:10:03 +05301003
Nabin Haita36adbd2013-08-02 14:50:12 +05301004 return stock_items
Anand Doshid2946502014-04-08 20:10:03 +05301005
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301006 def set_total_advance_paid(self):
1007 if self.doctype == "Sales Order":
Nabin Hait6e439a52015-08-28 19:24:22 +05301008 dr_or_cr = "credit_in_account_currency"
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301009 rev_dr_or_cr = "debit_in_account_currency"
Nabin Haitb2206d12016-01-27 15:43:12 +05301010 party = self.customer
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301011 else:
Nabin Hait6e439a52015-08-28 19:24:22 +05301012 dr_or_cr = "debit_in_account_currency"
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301013 rev_dr_or_cr = "credit_in_account_currency"
Nabin Haitb2206d12016-01-27 15:43:12 +05301014 party = self.supplier
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301015
Nabin Haitb2206d12016-01-27 15:43:12 +05301016 advance = frappe.db.sql("""
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301017 select
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301018 account_currency, sum({dr_or_cr}) - sum({rev_dr_cr}) as amount
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301019 from
Nabin Hait12e2a512016-06-26 01:37:21 +05301020 `tabGL Entry`
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301021 where
Nabin Hait12e2a512016-06-26 01:37:21 +05301022 against_voucher_type = %s and against_voucher = %s and party=%s
1023 and docstatus = 1
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301024 """.format(dr_or_cr=dr_or_cr, rev_dr_cr=rev_dr_or_cr), (self.doctype, self.name, party), as_dict=1) #nosec
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301025
Nabin Haitb2206d12016-01-27 15:43:12 +05301026 if advance:
Anand Doshi7c0a58a2016-01-29 12:16:24 +05301027 advance = advance[0]
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301028
Anand Doshi7c0a58a2016-01-29 12:16:24 +05301029 advance_paid = flt(advance.amount, self.precision("advance_paid"))
1030 formatted_advance_paid = fmt_money(advance_paid, precision=self.precision("advance_paid"),
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001031 currency=advance.account_currency)
Anand Doshi7c0a58a2016-01-29 12:16:24 +05301032
1033 frappe.db.set_value(self.doctype, self.name, "party_account_currency",
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001034 advance.account_currency)
Anand Doshi7c0a58a2016-01-29 12:16:24 +05301035
1036 if advance.account_currency == self.currency:
finbyz5efc7972019-01-05 11:12:11 +05301037 order_total = self.get("rounded_total") or self.grand_total
1038 precision = "rounded_total" if self.get("rounded_total") else "grand_total"
Nabin Haitb2206d12016-01-27 15:43:12 +05301039 else:
finbyz5efc7972019-01-05 11:12:11 +05301040 order_total = self.get("base_rounded_total") or self.base_grand_total
1041 precision = "base_rounded_total" if self.get("base_rounded_total") else "base_grand_total"
Sagar Voraf733a392019-01-07 14:24:01 +05301042
finbyz5efc7972019-01-05 11:12:11 +05301043 formatted_order_total = fmt_money(order_total, precision=self.precision(precision),
1044 currency=advance.account_currency)
Anand Doshi7c0a58a2016-01-29 12:16:24 +05301045
Nabin Hait9db1b222016-06-30 12:37:53 +05301046 if self.currency == self.company_currency and advance_paid > order_total:
Nabin Haitb2206d12016-01-27 15:43:12 +05301047 frappe.throw(_("Total advance ({0}) against Order {1} cannot be greater than the Grand Total ({2})")
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001048 .format(formatted_advance_paid, self.name, formatted_order_total))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301049
Nabin Hait13093b42016-06-29 18:04:37 +05301050 frappe.db.set_value(self.doctype, self.name, "advance_paid", advance_paid)
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301051
ankitjavalkarworke60822b2014-08-26 14:29:06 +05301052 @property
1053 def company_abbr(self):
Nabin Hait6a5695f2018-08-09 11:30:21 +05301054 if not hasattr(self, "_abbr"):
1055 self._abbr = frappe.db.get_value('Company', self.company, "abbr")
ankitjavalkarworke60822b2014-08-26 14:29:06 +05301056
1057 return self._abbr
1058
marination4be5b5c2020-10-08 19:08:27 +05301059 def raise_missing_debit_credit_account_error(self, party_type, party):
marination53b1a9a2020-11-03 15:45:25 +05301060 """Raise an error if debit to/credit to account does not exist."""
marination4be5b5c2020-10-08 19:08:27 +05301061 db_or_cr = frappe.bold("Debit To") if self.doctype == "Sales Invoice" else frappe.bold("Credit To")
1062 rec_or_pay = "Receivable" if self.doctype == "Sales Invoice" else "Payable"
1063
1064 link_to_party = frappe.utils.get_link_to_form(party_type, party)
1065 link_to_company = frappe.utils.get_link_to_form("Company", self.company)
1066
1067 message = _("{0} Account not found against Customer {1}.").format(db_or_cr, frappe.bold(party) or '')
1068 message += "<br>" + _("Please set one of the following:") + "<br>"
1069 message += "<br><ul><li>" + _("'Account' in the Accounting section of Customer {0}").format(link_to_party) + "</li>"
1070 message += "<li>" + _("'Default {0} Account' in Company {1}").format(rec_or_pay, link_to_company) + "</li></ul>"
1071
marination53b1a9a2020-11-03 15:45:25 +05301072 frappe.throw(message, title=_("Account Missing"), exc=AccountMissingError)
marination4be5b5c2020-10-08 19:08:27 +05301073
Neil Trini Lasrado3fbbb712015-07-17 12:10:12 +05301074 def validate_party(self):
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301075 party_type, party = self.get_party()
shreyaseba9ca42016-01-26 14:56:52 +05301076 validate_party_frozen_disabled(party_type, party)
Anand Doshi979326b2015-09-11 16:22:37 +05301077
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301078 def get_party(self):
Neil Trini Lasrado79bf2332015-07-20 13:03:48 +05301079 party_type = None
shreyas29b565f2016-01-25 17:30:49 +05301080 if self.doctype in ("Opportunity", "Quotation", "Sales Order", "Delivery Note", "Sales Invoice"):
shreyaseba9ca42016-01-26 14:56:52 +05301081 party_type = 'Customer'
shreyas29b565f2016-01-25 17:30:49 +05301082
1083 elif self.doctype in ("Supplier Quotation", "Purchase Order", "Purchase Receipt", "Purchase Invoice"):
shreyaseba9ca42016-01-26 14:56:52 +05301084 party_type = 'Supplier'
shreyas29b565f2016-01-25 17:30:49 +05301085
1086 elif self.meta.get_field("customer"):
1087 party_type = "Customer"
Neil Trini Lasrado3fbbb712015-07-17 12:10:12 +05301088
Neil Trini Lasrado79bf2332015-07-20 13:03:48 +05301089 elif self.meta.get_field("supplier"):
shreyas29b565f2016-01-25 17:30:49 +05301090 party_type = "Supplier"
Anand Doshi979326b2015-09-11 16:22:37 +05301091
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301092 party = self.get(party_type.lower()) if party_type else None
Anand Doshi979326b2015-09-11 16:22:37 +05301093
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301094 return party_type, party
Anand Doshi979326b2015-09-11 16:22:37 +05301095
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301096 def validate_currency(self):
Nabin Hait6e439a52015-08-28 19:24:22 +05301097 if self.get("currency"):
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301098 party_type, party = self.get_party()
Nabin Hait6e439a52015-08-28 19:24:22 +05301099 if party_type and party:
Anand Doshib20baf82015-09-25 16:17:50 +05301100 party_account_currency = get_party_account_currency(party_type, party, self.company)
Anand Doshi979326b2015-09-11 16:22:37 +05301101
Anand Doshi7afaeb02015-10-01 18:55:25 +05301102 if (party_account_currency
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001103 and party_account_currency != self.company_currency
1104 and self.currency != party_account_currency):
Nabin Hait98096772015-09-03 10:28:08 +05301105 frappe.throw(_("Accounting Entry for {0}: {1} can only be made in currency: {2}")
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001106 .format(party_type, party, party_account_currency), InvalidCurrency)
Anand Doshi979326b2015-09-11 16:22:37 +05301107
shreyas29b565f2016-01-25 17:30:49 +05301108 # Note: not validating with gle account because we don't have the account
1109 # at quotation / sales order level and we shouldn't stop someone
1110 # from creating a sales invoice if sales order is already created
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +05301111
Nabin Hait297d74a2016-11-23 15:58:51 +05301112 def delink_advance_entries(self, linked_doc_name):
1113 total_allocated_amount = 0
1114 for adv in self.advances:
1115 consider_for_total_advance = True
1116 if adv.reference_name == linked_doc_name:
1117 frappe.db.sql("""delete from `tab{0} Advance`
1118 where name = %s""".format(self.doctype), adv.name)
1119 consider_for_total_advance = False
1120
1121 if consider_for_total_advance:
1122 total_allocated_amount += flt(adv.allocated_amount, adv.precision("allocated_amount"))
1123
Rushabh Mehta66958302017-01-16 16:57:53 +05301124 frappe.db.set_value(self.doctype, self.name, "total_advance",
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001125 total_allocated_amount, update_modified=False)
Rohit Waghchaure6087fe12016-04-09 14:31:09 +05301126
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301127 def group_similar_items(self):
1128 group_item_qty = {}
1129 group_item_amount = {}
Shreya Shah785f1aa2018-10-11 10:14:25 +05301130 # to update serial number in print
1131 count = 0
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301132
1133 for item in self.items:
1134 group_item_qty[item.item_code] = group_item_qty.get(item.item_code, 0) + item.qty
1135 group_item_amount[item.item_code] = group_item_amount.get(item.item_code, 0) + item.amount
1136
1137 duplicate_list = []
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301138 for item in self.items:
1139 if item.item_code in group_item_qty:
Shreya Shah785f1aa2018-10-11 10:14:25 +05301140 count += 1
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301141 item.qty = group_item_qty[item.item_code]
1142 item.amount = group_item_amount[item.item_code]
deepeshgarg007e8d21cd2019-06-24 17:46:44 +05301143
1144 if item.qty:
1145 item.rate = flt(flt(item.amount) / flt(item.qty), item.precision("rate"))
1146 else:
1147 item.rate = 0
1148
Shreya Shah785f1aa2018-10-11 10:14:25 +05301149 item.idx = count
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301150 del group_item_qty[item.item_code]
1151 else:
1152 duplicate_list.append(item)
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301153 for item in duplicate_list:
1154 self.remove(item)
1155
tunde32aa7c12017-09-07 06:52:15 +01001156 def set_payment_schedule(self):
Manas Solankia7f55892018-04-02 10:32:00 +05301157 if self.doctype == 'Sales Invoice' and self.is_pos:
1158 self.payment_terms_template = ''
1159 return
rohitwaghchauredb9fa782018-03-01 10:32:29 +05301160
Deepesh Garg26210162020-08-11 16:06:13 +05301161 party_account_currency = self.get('party_account_currency')
1162 if not party_account_currency:
1163 party_type, party = self.get_party()
1164
1165 if party_type and party:
1166 party_account_currency = get_party_account_currency(party_type, party, self.company)
1167
rohitwaghchaureda941af2018-01-17 16:23:04 +05301168 posting_date = self.get("bill_date") or self.get("posting_date") or self.get("transaction_date")
tundedf3a1752017-09-11 11:02:57 +01001169 date = self.get("due_date")
1170 due_date = date or posting_date
Deepesh Garg26210162020-08-11 16:06:13 +05301171
Saqib Ansarid552fe62021-04-23 14:46:52 +05301172 base_grand_total = self.get("base_rounded_total") or self.base_grand_total
1173 grand_total = self.get("rounded_total") or self.grand_total
Deepesh Garg26210162020-08-11 16:06:13 +05301174
Nabin Hait2f9f4f92017-12-20 12:24:59 +05301175 if self.doctype in ("Sales Invoice", "Purchase Invoice"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301176 base_grand_total = base_grand_total - flt(self.base_write_off_amount)
Nabin Hait2f9f4f92017-12-20 12:24:59 +05301177 grand_total = grand_total - flt(self.write_off_amount)
Deepesh Gargbcf56e62021-08-06 23:53:16 +05301178 po_or_so, doctype, fieldname = self.get_order_details()
1179 automatically_fetch_payment_terms = cint(frappe.db.get_single_value('Accounts Settings', 'automatically_fetch_payment_terms'))
tunde96b8f222017-09-08 15:35:59 +01001180
Rohit Waghchaure4a267b92019-05-09 19:50:00 +05301181 if self.get("total_advance"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301182 if party_account_currency == self.company_currency:
1183 base_grand_total -= self.get("total_advance")
1184 grand_total = flt(base_grand_total / self.get("conversion_rate"), self.precision("grand_total"))
1185 else:
1186 grand_total -= self.get("total_advance")
1187 base_grand_total = flt(grand_total * self.get("conversion_rate"), self.precision("base_grand_total"))
Rohit Waghchaure4a267b92019-05-09 19:50:00 +05301188
Nabin Hait0551f7b2017-11-21 19:58:16 +05301189 if not self.get("payment_schedule"):
Deepesh Gargbff3b092021-08-07 00:12:57 +05301190 if self.doctype in ["Sales Invoice", "Purchase Invoice"] and automatically_fetch_payment_terms \
1191 and self.linked_order_has_payment_terms(po_or_so, fieldname, doctype):
Deepesh Gargbcf56e62021-08-06 23:53:16 +05301192 self.fetch_payment_terms_from_order(po_or_so, doctype)
1193 if self.get('payment_terms_template'):
1194 self.ignore_default_payment_terms_template = 1
1195 elif self.get("payment_terms_template"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301196 data = get_payment_terms(self.payment_terms_template, posting_date, grand_total, base_grand_total)
Nabin Hait0551f7b2017-11-21 19:58:16 +05301197 for item in data:
1198 self.append("payment_schedule", item)
GangaManoj4323f4b2021-07-22 05:57:42 +05301199 elif self.doctype not in ["Purchase Receipt"]:
Saqib Ansarida5b55c2021-04-28 14:55:33 +05301200 data = dict(due_date=due_date, invoice_portion=100, payment_amount=grand_total, base_payment_amount=base_grand_total)
Nabin Hait0551f7b2017-11-21 19:58:16 +05301201 self.append("payment_schedule", data)
Deepesh Gargbcf56e62021-08-06 23:53:16 +05301202
1203 for d in self.get("payment_schedule"):
1204 if d.invoice_portion:
1205 d.payment_amount = flt(grand_total * flt(d.invoice_portion / 100), d.precision('payment_amount'))
1206 d.base_payment_amount = flt(base_grand_total * flt(d.invoice_portion / 100), d.precision('base_payment_amount'))
1207 d.outstanding = d.payment_amount
1208 elif not d.invoice_portion:
1209 d.base_payment_amount = flt(base_grand_total * self.get("conversion_rate"), d.precision('base_payment_amount'))
Subin Tomfac88a32021-07-23 21:23:48 +05301210
tunde43870aa2017-08-18 11:59:30 +01001211
GangaManoj4323f4b2021-07-22 05:57:42 +05301212 def get_order_details(self):
1213 if self.doctype == "Sales Invoice":
1214 po_or_so = self.get('items')[0].get('sales_order')
1215 po_or_so_doctype = "Sales Order"
1216 po_or_so_doctype_name = "sales_order"
1217
tunde43870aa2017-08-18 11:59:30 +01001218 else:
GangaManoj4323f4b2021-07-22 05:57:42 +05301219 po_or_so = self.get('items')[0].get('purchase_order')
1220 po_or_so_doctype = "Purchase Order"
1221 po_or_so_doctype_name = "purchase_order"
Ankush Menat4551d7d2021-08-19 13:41:10 +05301222
GangaManoj4323f4b2021-07-22 05:57:42 +05301223 return po_or_so, po_or_so_doctype, po_or_so_doctype_name
1224
GangaManojc7c90242021-07-29 19:18:35 +05301225 def linked_order_has_payment_terms(self, po_or_so, fieldname, doctype):
GangaManoj4323f4b2021-07-22 05:57:42 +05301226 if po_or_so and self.all_items_have_same_po_or_so(po_or_so, fieldname):
GangaManojc7c90242021-07-29 19:18:35 +05301227 if self.linked_order_has_payment_terms_template(po_or_so, doctype):
GangaManoj4323f4b2021-07-22 05:57:42 +05301228 return True
1229 elif self.linked_order_has_payment_schedule(po_or_so):
1230 return True
Ankush Menat4551d7d2021-08-19 13:41:10 +05301231
GangaManoj4323f4b2021-07-22 05:57:42 +05301232 return False
1233
1234 def all_items_have_same_po_or_so(self, po_or_so, fieldname):
1235 for item in self.get('items'):
1236 if item.get(fieldname) != po_or_so:
1237 return False
Ankush Menat4551d7d2021-08-19 13:41:10 +05301238
GangaManoj4323f4b2021-07-22 05:57:42 +05301239 return True
1240
GangaManojc7c90242021-07-29 19:18:35 +05301241 def linked_order_has_payment_terms_template(self, po_or_so, doctype):
1242 return frappe.get_value(doctype, po_or_so, 'payment_terms_template')
GangaManoj4323f4b2021-07-22 05:57:42 +05301243
1244 def linked_order_has_payment_schedule(self, po_or_so):
1245 return frappe.get_all('Payment Schedule', filters={'parent': po_or_so})
1246
1247 def fetch_payment_terms_from_order(self, po_or_so, po_or_so_doctype):
1248 """
1249 Fetch Payment Terms from Purchase/Sales Order on creating a new Purchase/Sales Invoice.
1250 """
1251 po_or_so = frappe.get_cached_doc(po_or_so_doctype, po_or_so)
1252
1253 self.payment_schedule = []
1254 self.payment_terms_template = po_or_so.payment_terms_template
1255
1256 for schedule in po_or_so.payment_schedule:
1257 payment_schedule = {
1258 'payment_term': schedule.payment_term,
1259 'due_date': schedule.due_date,
1260 'invoice_portion': schedule.invoice_portion,
GangaManoj5b33e752021-08-05 21:50:09 +05301261 'mode_of_payment': schedule.mode_of_payment,
1262 'description': schedule.description
GangaManoj4323f4b2021-07-22 05:57:42 +05301263 }
GangaManoj5b33e752021-08-05 21:50:09 +05301264
1265 if schedule.discount_type == 'Percentage':
1266 payment_schedule['discount_type'] = schedule.discount_type
1267 payment_schedule['discount'] = schedule.discount
1268
GangaManoj4323f4b2021-07-22 05:57:42 +05301269 self.append("payment_schedule", payment_schedule)
tunde43870aa2017-08-18 11:59:30 +01001270
tundebe1b8712017-08-19 08:21:44 +01001271 def set_due_date(self):
Nabin Hait0551f7b2017-11-21 19:58:16 +05301272 due_dates = [d.due_date for d in self.get("payment_schedule") if d.due_date]
1273 if due_dates:
1274 self.due_date = max(due_dates)
tunde62af5c52017-09-22 15:16:38 +01001275
1276 def validate_payment_schedule_dates(self):
tunde77ecacc2017-09-22 23:12:55 +01001277 dates = []
tunde9bed2de2017-09-25 10:19:35 +01001278 li = []
tunde43870aa2017-08-18 11:59:30 +01001279
rohitwaghchauredb9fa782018-03-01 10:32:29 +05301280 if self.doctype == 'Sales Invoice' and self.is_pos: return
1281
tunde43870aa2017-08-18 11:59:30 +01001282 for d in self.get("payment_schedule"):
Nabin Hait2f9f4f92017-12-20 12:24:59 +05301283 if self.doctype == "Sales Order" and getdate(d.due_date) < getdate(self.transaction_date):
Michelle Alva7f2477b2020-04-09 17:23:23 +05301284 frappe.throw(_("Row {0}: Due Date in the Payment Terms table cannot be before Posting Date").format(d.idx))
tunde77ecacc2017-09-22 23:12:55 +01001285 elif d.due_date in dates:
mnatalia5f0e8d62018-05-22 06:38:50 +03001286 li.append(_("{0} in row {1}").format(d.due_date, d.idx))
tunde9bed2de2017-09-25 10:19:35 +01001287 dates.append(d.due_date)
1288
1289 if li:
1290 duplicates = '<br>' + '<br>'.join(li)
Faris Ansari2ab6e0e2018-09-19 13:13:59 +05301291 frappe.throw(_("Rows with duplicate due dates in other rows were found: {0}").format(duplicates))
tunde43870aa2017-08-18 11:59:30 +01001292
tunde62af5c52017-09-22 15:16:38 +01001293 def validate_payment_schedule_amount(self):
rohitwaghchauredb9fa782018-03-01 10:32:29 +05301294 if self.doctype == 'Sales Invoice' and self.is_pos: return
1295
Deepesh Garg26210162020-08-11 16:06:13 +05301296 party_account_currency = self.get('party_account_currency')
1297 if not party_account_currency:
1298 party_type, party = self.get_party()
1299
1300 if party_type and party:
1301 party_account_currency = get_party_account_currency(party_type, party, self.company)
1302
Nabin Hait0551f7b2017-11-21 19:58:16 +05301303 if self.get("payment_schedule"):
1304 total = 0
Saqib Ansarid552fe62021-04-23 14:46:52 +05301305 base_total = 0
Nabin Hait0551f7b2017-11-21 19:58:16 +05301306 for d in self.get("payment_schedule"):
Nabin Haitf592f2c2017-12-19 11:31:34 +05301307 total += flt(d.payment_amount)
Saqib Ansarid552fe62021-04-23 14:46:52 +05301308 base_total += flt(d.base_payment_amount)
tunde43870aa2017-08-18 11:59:30 +01001309
Saqib Ansarid552fe62021-04-23 14:46:52 +05301310 base_grand_total = self.get("base_rounded_total") or self.base_grand_total
1311 grand_total = self.get("rounded_total") or self.grand_total
Rohit Waghchaure4a267b92019-05-09 19:50:00 +05301312
Nabin Haite591c852017-12-21 11:46:30 +05301313 if self.doctype in ("Sales Invoice", "Purchase Invoice"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301314 base_grand_total = base_grand_total - flt(self.base_write_off_amount)
Nabin Haite591c852017-12-21 11:46:30 +05301315 grand_total = grand_total - flt(self.write_off_amount)
Saqib Ansarid552fe62021-04-23 14:46:52 +05301316
1317 if self.get("total_advance"):
1318 if party_account_currency == self.company_currency:
1319 base_grand_total -= self.get("total_advance")
1320 grand_total = flt(base_grand_total / self.get("conversion_rate"), self.precision("grand_total"))
1321 else:
1322 grand_total -= self.get("total_advance")
1323 base_grand_total = flt(grand_total * self.get("conversion_rate"), self.precision("base_grand_total"))
Saqib Ansarid552fe62021-04-23 14:46:52 +05301324 if total != flt(grand_total, self.precision("grand_total")) or \
1325 base_total != flt(base_grand_total, self.precision("base_grand_total")):
Nabin Hait0551f7b2017-11-21 19:58:16 +05301326 frappe.throw(_("Total Payment Amount in Payment Schedule must be equal to Grand / Rounded Total"))
tunde43870aa2017-08-18 11:59:30 +01001327
Nabin Hait877e1bb2017-11-17 12:27:43 +05301328 def is_rounded_total_disabled(self):
1329 if self.meta.get_field("disable_rounded_total"):
1330 return self.disable_rounded_total
1331 else:
1332 return frappe.db.get_single_value("Global Defaults", "disable_rounded_total")
1333
Deepesh Gargf17ea2c2020-12-11 21:30:39 +05301334 def set_inter_company_account(self):
1335 """
1336 Set intercompany account for inter warehouse transactions
1337 This account will be used in case billing company and internal customer's
1338 representation company is same
1339 """
1340
1341 if self.is_internal_transfer() and not self.unrealized_profit_loss_account:
1342 unrealized_profit_loss_account = frappe.db.get_value('Company', self.company, 'unrealized_profit_loss_account')
1343
1344 if not unrealized_profit_loss_account:
1345 msg = _("Please select Unrealized Profit / Loss account or add default Unrealized Profit / Loss account account for company {0}").format(
1346 frappe.bold(self.company))
1347 frappe.throw(msg)
1348
1349 self.unrealized_profit_loss_account = unrealized_profit_loss_account
1350
1351 def is_internal_transfer(self):
1352 """
1353 It will an internal transfer if its an internal customer and representation
1354 company is same as billing company
1355 """
Deepesh Gargb4be2922021-01-28 13:09:56 +05301356 if self.doctype in ('Sales Invoice', 'Delivery Note', 'Sales Order'):
Deepesh Gargf17ea2c2020-12-11 21:30:39 +05301357 internal_party_field = 'is_internal_customer'
Deepesh Gargb4be2922021-01-28 13:09:56 +05301358 elif self.doctype in ('Purchase Invoice', 'Purchase Receipt', 'Purchase Order'):
Deepesh Gargf17ea2c2020-12-11 21:30:39 +05301359 internal_party_field = 'is_internal_supplier'
1360
1361 if self.get(internal_party_field) and (self.represents_company == self.company):
1362 return True
1363
1364 return False
1365
Rushabh Mehta793ba6b2014-02-14 15:47:51 +05301366@frappe.whitelist()
Rushabh Mehtaf56d73c2013-10-10 16:35:09 +05301367def get_tax_rate(account_head):
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +05301368 return frappe.db.get_value("Account", account_head, ["tax_rate", "account_name"], as_dict=True)
Rushabh Mehtaa33d4682015-06-01 17:15:42 +05301369
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001370
Nabin Haitffc7f3f2015-05-12 15:07:02 +05301371@frappe.whitelist()
Nabin Haita2426fc2018-01-15 17:45:46 +05301372def get_default_taxes_and_charges(master_doctype, tax_template=None, company=None):
rohitwaghchaure505661b2017-12-11 14:52:28 +05301373 if not company: return {}
1374
Nabin Haita2426fc2018-01-15 17:45:46 +05301375 if tax_template and company:
1376 tax_template_company = frappe.db.get_value(master_doctype, tax_template, "company")
1377 if tax_template_company == company:
1378 return
1379
1380 default_tax = frappe.db.get_value(master_doctype, {"is_default": 1, "company": company})
rohitwaghchaure505661b2017-12-11 14:52:28 +05301381
Rushabh Mehta98aa5812017-11-14 09:32:32 +05301382 return {
1383 'taxes_and_charges': default_tax,
1384 'taxes': get_taxes_and_charges(master_doctype, default_tax)
1385 }
Nabin Hait6b039142014-05-02 15:45:10 +05301386
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001387
Nabin Hait6b039142014-05-02 15:45:10 +05301388@frappe.whitelist()
Nabin Haitffc7f3f2015-05-12 15:07:02 +05301389def get_taxes_and_charges(master_doctype, master_name):
Nabin Hait1fe50122015-05-16 12:14:39 +05301390 if not master_name:
1391 return
Nabin Hait6b039142014-05-02 15:45:10 +05301392 from frappe.model import default_fields
1393 tax_master = frappe.get_doc(master_doctype, master_name)
1394
1395 taxes_and_charges = []
Nabin Haitffc7f3f2015-05-12 15:07:02 +05301396 for i, tax in enumerate(tax_master.get("taxes")):
Nabin Hait6b039142014-05-02 15:45:10 +05301397 tax = tax.as_dict()
1398
1399 for fieldname in default_fields:
1400 if fieldname in tax:
1401 del tax[fieldname]
1402
1403 taxes_and_charges.append(tax)
1404
1405 return taxes_and_charges
Rushabh Mehta66e08e32014-09-29 12:17:03 +05301406
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001407
Rushabh Mehta66e08e32014-09-29 12:17:03 +05301408def validate_conversion_rate(currency, conversion_rate, conversion_rate_label, company):
1409 """common validation for currency and price list currency"""
1410
Rushabh Mehta708e47a2018-08-08 16:37:31 +05301411 company_currency = frappe.get_cached_value('Company', company, "default_currency")
Rushabh Mehta66e08e32014-09-29 12:17:03 +05301412
1413 if not conversion_rate:
Saqib60212ff2020-10-26 11:17:04 +05301414 throw(
1415 _("{0} is mandatory. Maybe Currency Exchange record is not created for {1} to {2}.")
1416 .format(conversion_rate_label, currency, company_currency)
1417 )
Nabin Hait613d0812015-02-23 11:58:15 +05301418
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001419
Nabin Hait613d0812015-02-23 11:58:15 +05301420def validate_taxes_and_charges(tax):
Deepesh Garg302855e2021-06-14 11:16:39 +05301421 if tax.charge_type in ['Actual', 'On Net Total', 'On Paid Amount'] and tax.row_id:
Nabin Hait613d0812015-02-23 11:58:15 +05301422 frappe.throw(_("Can refer row only if the charge type is 'On Previous Row Amount' or 'Previous Row Total'"))
Nabin Hait37b047d2015-02-23 16:01:33 +05301423 elif tax.charge_type in ['On Previous Row Amount', 'On Previous Row Total']:
Nabin Hait613d0812015-02-23 11:58:15 +05301424 if cint(tax.idx) == 1:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001425 frappe.throw(
1426 _("Cannot select charge type as 'On Previous Row Amount' or 'On Previous Row Total' for first row"))
Nabin Hait613d0812015-02-23 11:58:15 +05301427 elif not tax.row_id:
Suraj Shetty48e9bc32020-01-29 15:06:18 +05301428 frappe.throw(_("Please specify a valid Row ID for row {0} in table {1}").format(tax.idx, _(tax.doctype)))
Nabin Hait613d0812015-02-23 11:58:15 +05301429 elif tax.row_id and cint(tax.row_id) >= cint(tax.idx):
1430 frappe.throw(_("Cannot refer row number greater than or equal to current row number for this Charge type"))
1431
Rushabh Mehta2a21bc92015-02-25 15:08:42 +05301432 if tax.charge_type == "Actual":
Nabin Haitbc6c3602015-02-27 23:40:56 +05301433 tax.rate = None
Rushabh Mehta2a21bc92015-02-25 15:08:42 +05301434
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001435
Anuja Pawar0e337be2021-08-10 17:26:35 +05301436def validate_account_head(tax, doc):
1437 company = frappe.get_cached_value('Account',
1438 tax.account_head, 'company')
1439
1440 if company != doc.company:
1441 frappe.throw(_('Row {0}: Account {1} does not belong to Company {2}')
1442 .format(tax.idx, frappe.bold(tax.account_head), frappe.bold(doc.company)), title=_('Invalid Account'))
1443
1444
1445def validate_cost_center(tax, doc):
1446 if not tax.cost_center:
1447 return
1448
1449 company = frappe.get_cached_value('Cost Center',
1450 tax.cost_center, 'company')
1451
1452 if company != doc.company:
1453 frappe.throw(_('Row {0}: Cost Center {1} does not belong to Company {2}')
1454 .format(tax.idx, frappe.bold(tax.cost_center), frappe.bold(doc.company)), title=_('Invalid Cost Center'))
1455
1456
Nabin Hait613d0812015-02-23 11:58:15 +05301457def validate_inclusive_tax(tax, doc):
1458 def _on_previous_row_error(row_range):
Deepesh Garg302855e2021-06-14 11:16:39 +05301459 throw(_("To include tax in row {0} in Item rate, taxes in rows {1} must also be included").format(tax.idx, row_range))
Nabin Hait613d0812015-02-23 11:58:15 +05301460
1461 if cint(getattr(tax, "included_in_print_rate", None)):
1462 if tax.charge_type == "Actual":
1463 # inclusive tax cannot be of type Actual
Deepesh Garg5ef9a622021-06-14 14:34:44 +05301464 throw(_("Charge of type 'Actual' in row {0} cannot be included in Item Rate or Paid Amount").format(tax.idx))
Nabin Hait613d0812015-02-23 11:58:15 +05301465 elif tax.charge_type == "On Previous Row Amount" and \
1466 not cint(doc.get("taxes")[cint(tax.row_id) - 1].included_in_print_rate):
1467 # referred row should also be inclusive
1468 _on_previous_row_error(tax.row_id)
1469 elif tax.charge_type == "On Previous Row Total" and \
1470 not all([cint(t.included_in_print_rate) for t in doc.get("taxes")[:cint(tax.row_id) - 1]]):
Deepesh Garg5ef9a622021-06-14 14:34:44 +05301471 # all rows about the referred tax should be inclusive
Nabin Hait613d0812015-02-23 11:58:15 +05301472 _on_previous_row_error("1 - %d" % (tax.row_id,))
Nabin Hait93b3a372015-02-24 17:08:34 +05301473 elif tax.get("category") == "Valuation":
Nabin Hait19ea7212020-08-11 20:34:57 +05301474 frappe.throw(_("Valuation type charges can not be marked as Inclusive"))
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301475
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301476
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001477def set_balance_in_account_currency(gl_dict, account_currency=None, conversion_rate=None, company_currency=None):
1478 if (not conversion_rate) and (account_currency != company_currency):
1479 frappe.throw(_("Account: {0} with currency: {1} can not be selected")
1480 .format(gl_dict.account, account_currency))
1481
1482 gl_dict["account_currency"] = company_currency if account_currency == company_currency \
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301483 else account_currency
1484
1485 # set debit/credit in account currency if not provided
1486 if flt(gl_dict.debit) and not flt(gl_dict.debit_in_account_currency):
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001487 gl_dict.debit_in_account_currency = gl_dict.debit if account_currency == company_currency \
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301488 else flt(gl_dict.debit / conversion_rate, 2)
1489
1490 if flt(gl_dict.credit) and not flt(gl_dict.credit_in_account_currency):
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001491 gl_dict.credit_in_account_currency = gl_dict.credit if account_currency == company_currency \
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301492 else flt(gl_dict.credit / conversion_rate, 2)
Nabin Hait1991c7b2016-06-27 20:09:05 +05301493
1494
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301495def get_advance_journal_entries(party_type, party, party_account, amount_field,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001496 order_doctype, order_list, include_unallocated=True):
1497 dr_or_cr = "credit_in_account_currency" if party_type == "Customer" else "debit_in_account_currency"
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301498
Nabin Hait1991c7b2016-06-27 20:09:05 +05301499 conditions = []
1500 if include_unallocated:
1501 conditions.append("ifnull(t2.reference_name, '')=''")
1502
1503 if order_list:
1504 order_condition = ', '.join(['%s'] * len(order_list))
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001505 conditions.append(" (t2.reference_type = '{0}' and ifnull(t2.reference_name, '') in ({1}))" \
1506 .format(order_doctype, order_condition))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301507
Nabin Hait1991c7b2016-06-27 20:09:05 +05301508 reference_condition = " and (" + " or ".join(conditions) + ")" if conditions else ""
Rushabh Mehta66958302017-01-16 16:57:53 +05301509
Nabin Hait1991c7b2016-06-27 20:09:05 +05301510 journal_entries = frappe.db.sql("""
1511 select
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301512 "Journal Entry" as reference_type, t1.name as reference_name,
Nabin Hait1991c7b2016-06-27 20:09:05 +05301513 t1.remark as remarks, t2.{0} as amount, t2.name as reference_row,
1514 t2.reference_name as against_order
1515 from
1516 `tabJournal Entry` t1, `tabJournal Entry Account` t2
1517 where
1518 t1.name = t2.parent and t2.account = %s
1519 and t2.party_type = %s and t2.party = %s
1520 and t2.is_advance = 'Yes' and t1.docstatus = 1
Nabin Haitca627fb2016-09-05 16:16:53 +05301521 and {1} > 0 {2}
Nabin Hait1991c7b2016-06-27 20:09:05 +05301522 order by t1.posting_date""".format(amount_field, dr_or_cr, reference_condition),
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001523 [party_account, party_type, party] + order_list, as_dict=1)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301524
Nabin Hait1991c7b2016-06-27 20:09:05 +05301525 return list(journal_entries)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301526
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001527
Rohit Waghchauref7258162019-01-15 18:12:04 +05301528def get_advance_payment_entries(party_type, party, party_account, order_doctype,
Nabin Hait34c551d2019-07-03 10:34:31 +05301529 order_list=None, include_unallocated=True, against_all_orders=False, limit=None):
Nabin Hait1991c7b2016-06-27 20:09:05 +05301530 party_account_field = "paid_from" if party_type == "Customer" else "paid_to"
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301531 currency_field = "paid_from_account_currency" if party_type == "Customer" else "paid_to_account_currency"
Nabin Hait1991c7b2016-06-27 20:09:05 +05301532 payment_type = "Receive" if party_type == "Customer" else "Pay"
Saqiba20999c2021-07-12 14:33:23 +05301533 exchange_rate_field = "source_exchange_rate" if payment_type == "Receive" else "target_exchange_rate"
1534
Nabin Hait1991c7b2016-06-27 20:09:05 +05301535 payment_entries_against_order, unallocated_payment_entries = [], []
Nabin Hait34c551d2019-07-03 10:34:31 +05301536 limit_cond = "limit %s" % limit if limit else ""
Nabin Haitff2f3ef2016-07-04 11:41:14 +05301537
Nabin Hait1991c7b2016-06-27 20:09:05 +05301538 if order_list or against_all_orders:
1539 if order_list:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001540 reference_condition = " and t2.reference_name in ({0})" \
Nabin Hait1991c7b2016-06-27 20:09:05 +05301541 .format(', '.join(['%s'] * len(order_list)))
1542 else:
1543 reference_condition = ""
1544 order_list = []
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301545
Nabin Hait1991c7b2016-06-27 20:09:05 +05301546 payment_entries_against_order = frappe.db.sql("""
1547 select
1548 "Payment Entry" as reference_type, t1.name as reference_name,
1549 t1.remarks, t2.allocated_amount as amount, t2.name as reference_row,
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301550 t2.reference_name as against_order, t1.posting_date,
Saqiba20999c2021-07-12 14:33:23 +05301551 t1.{0} as currency, t1.{4} as exchange_rate
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301552 from `tabPayment Entry` t1, `tabPayment Entry Reference` t2
Nabin Hait1991c7b2016-06-27 20:09:05 +05301553 where
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301554 t1.name = t2.parent and t1.{1} = %s and t1.payment_type = %s
Nabin Hait1991c7b2016-06-27 20:09:05 +05301555 and t1.party_type = %s and t1.party = %s and t1.docstatus = 1
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301556 and t2.reference_doctype = %s {2}
1557 order by t1.posting_date {3}
Saqiba20999c2021-07-12 14:33:23 +05301558 """.format(currency_field, party_account_field, reference_condition, limit_cond, exchange_rate_field),
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001559 [party_account, payment_type, party_type, party,
1560 order_doctype] + order_list, as_dict=1)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301561
Nabin Hait1991c7b2016-06-27 20:09:05 +05301562 if include_unallocated:
1563 unallocated_payment_entries = frappe.db.sql("""
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301564 select "Payment Entry" as reference_type, name as reference_name,
Saqiba20999c2021-07-12 14:33:23 +05301565 remarks, unallocated_amount as amount, {2} as exchange_rate
Nabin Hait1991c7b2016-06-27 20:09:05 +05301566 from `tabPayment Entry`
1567 where
1568 {0} = %s and party_type = %s and party = %s and payment_type = %s
1569 and docstatus = 1 and unallocated_amount > 0
Rohit Waghchauref7258162019-01-15 18:12:04 +05301570 order by posting_date {1}
Saqiba20999c2021-07-12 14:33:23 +05301571 """.format(party_account_field, limit_cond, exchange_rate_field),
1572 (party_account, party_type, party, payment_type), as_dict=1)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301573
Rohit Waghchaure2f1db572016-11-08 12:39:33 +05301574 return list(payment_entries_against_order) + list(unallocated_payment_entries)
1575
1576def update_invoice_status():
1577 # Daily update the status of the invoices
1578
Rushabh Mehta66958302017-01-16 16:57:53 +05301579 frappe.db.sql(""" update `tabSales Invoice` set status = 'Overdue'
Rohit Waghchaure2f1db572016-11-08 12:39:33 +05301580 where due_date < CURDATE() and docstatus = 1 and outstanding_amount > 0""")
1581
Rushabh Mehta66958302017-01-16 16:57:53 +05301582 frappe.db.sql(""" update `tabPurchase Invoice` set status = 'Overdue'
Nabin Hait92759692017-08-15 08:23:51 +05301583 where due_date < CURDATE() and docstatus = 1 and outstanding_amount > 0""")
1584
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001585
Nabin Hait92759692017-08-15 08:23:51 +05301586@frappe.whitelist()
Saqib Ansarid552fe62021-04-23 14:46:52 +05301587def get_payment_terms(terms_template, posting_date=None, grand_total=None, base_grand_total=None, bill_date=None):
Nabin Hait92759692017-08-15 08:23:51 +05301588 if not terms_template:
1589 return
1590
1591 terms_doc = frappe.get_doc("Payment Terms Template", terms_template)
1592
1593 schedule = []
tundefb144302017-08-19 15:01:40 +01001594 for d in terms_doc.get("terms"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301595 term_details = get_payment_term_details(d, posting_date, grand_total, base_grand_total, bill_date)
Nabin Hait92759692017-08-15 08:23:51 +05301596 schedule.append(term_details)
1597
1598 return schedule
1599
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001600
Nabin Hait92759692017-08-15 08:23:51 +05301601@frappe.whitelist()
Saqib Ansarid552fe62021-04-23 14:46:52 +05301602def get_payment_term_details(term, posting_date=None, grand_total=None, base_grand_total=None, bill_date=None):
Nabin Hait92759692017-08-15 08:23:51 +05301603 term_details = frappe._dict()
Achilles Rasquinha90509982018-03-08 12:55:41 +05301604 if isinstance(term, text_type):
Nabin Hait92759692017-08-15 08:23:51 +05301605 term = frappe.get_doc("Payment Term", term)
1606 else:
1607 term_details.payment_term = term.payment_term
1608 term_details.description = term.description
1609 term_details.invoice_portion = term.invoice_portion
Rohit Waghchaure52bf56d2017-11-27 11:43:52 +05301610 term_details.payment_amount = flt(term.invoice_portion) * flt(grand_total) / 100
Saqib Ansarid552fe62021-04-23 14:46:52 +05301611 term_details.base_payment_amount = flt(term.invoice_portion) * flt(base_grand_total) / 100
Saqib0586b7d2021-03-31 15:03:53 +05301612 term_details.discount_type = term.discount_type
1613 term_details.discount = term.discount
Saqib0586b7d2021-03-31 15:03:53 +05301614 term_details.outstanding = term_details.payment_amount
1615 term_details.mode_of_payment = term.mode_of_payment
1616
Shreya Shah3a9eec22018-02-16 13:05:21 +05301617 if bill_date:
1618 term_details.due_date = get_due_date(term, bill_date)
Saqib0586b7d2021-03-31 15:03:53 +05301619 term_details.discount_date = get_discount_date(term, bill_date)
Shreya Shah3a9eec22018-02-16 13:05:21 +05301620 elif posting_date:
1621 term_details.due_date = get_due_date(term, posting_date)
Saqib0586b7d2021-03-31 15:03:53 +05301622 term_details.discount_date = get_discount_date(term, posting_date)
Shreya Shah3a9eec22018-02-16 13:05:21 +05301623
1624 if getdate(term_details.due_date) < getdate(posting_date):
1625 term_details.due_date = posting_date
1626
Nabin Hait92759692017-08-15 08:23:51 +05301627 return term_details
1628
Shreya Shah3a9eec22018-02-16 13:05:21 +05301629def get_due_date(term, posting_date=None, bill_date=None):
Nabin Hait92759692017-08-15 08:23:51 +05301630 due_date = None
Shreya Shah3a9eec22018-02-16 13:05:21 +05301631 date = bill_date or posting_date
Nabin Hait92759692017-08-15 08:23:51 +05301632 if term.due_date_based_on == "Day(s) after invoice date":
Shreya Shah3a9eec22018-02-16 13:05:21 +05301633 due_date = add_days(date, term.credit_days)
Nabin Hait92759692017-08-15 08:23:51 +05301634 elif term.due_date_based_on == "Day(s) after the end of the invoice month":
Shreya Shah3a9eec22018-02-16 13:05:21 +05301635 due_date = add_days(get_last_day(date), term.credit_days)
Nabin Hait92759692017-08-15 08:23:51 +05301636 elif term.due_date_based_on == "Month(s) after the end of the invoice month":
Shreya Shah3a9eec22018-02-16 13:05:21 +05301637 due_date = add_months(get_last_day(date), term.credit_months)
tunde96b8f222017-09-08 15:35:59 +01001638 return due_date
tundebabzyad08d4c2018-05-16 07:01:41 +01001639
Saqib0586b7d2021-03-31 15:03:53 +05301640def get_discount_date(term, posting_date=None, bill_date=None):
1641 discount_validity = None
1642 date = bill_date or posting_date
1643 if term.discount_validity_based_on == "Day(s) after invoice date":
1644 discount_validity = add_days(date, term.discount_validity)
1645 elif term.discount_validity_based_on == "Day(s) after the end of the invoice month":
1646 discount_validity = add_days(get_last_day(date), term.discount_validity)
1647 elif term.discount_validity_based_on == "Month(s) after the end of the invoice month":
1648 discount_validity = add_months(get_last_day(date), term.discount_validity)
1649 return discount_validity
tundebabzyad08d4c2018-05-16 07:01:41 +01001650
1651def get_supplier_block_status(party_name):
1652 """
1653 Returns a dict containing the values of `on_hold`, `release_date` and `hold_type` of
1654 a `Supplier`
1655 """
1656 supplier = frappe.get_doc('Supplier', party_name)
1657 info = {
1658 'on_hold': supplier.on_hold,
1659 'release_date': supplier.release_date,
1660 'hold_type': supplier.hold_type
1661 }
1662 return info
1663
marination698d9832020-08-19 14:59:46 +05301664def set_child_tax_template_and_map(item, child_item, parent_doc):
1665 args = {
1666 'item_code': item.item_code,
1667 'posting_date': parent_doc.transaction_date,
1668 'tax_category': parent_doc.get('tax_category'),
1669 'company': parent_doc.get('company')
1670 }
1671
1672 child_item.item_tax_template = _get_item_tax_template(args, item.taxes)
1673 if child_item.get("item_tax_template"):
1674 child_item.item_tax_rate = get_item_tax_map(parent_doc.get('company'), child_item.item_tax_template, as_json=True)
1675
Afshanb3bbebd2021-08-09 14:39:32 +05301676def add_taxes_from_tax_template(child_item, parent_doc, db_insert=True):
Marica3b1be2b2020-10-22 17:04:31 +05301677 add_taxes_from_item_tax_template = frappe.db.get_single_value("Accounts Settings", "add_taxes_from_item_tax_template")
1678
1679 if child_item.get("item_tax_rate") and add_taxes_from_item_tax_template:
1680 tax_map = json.loads(child_item.get("item_tax_rate"))
1681 for tax_type in tax_map:
1682 tax_rate = flt(tax_map[tax_type])
1683 taxes = parent_doc.get('taxes') or []
1684 # add new row for tax head only if missing
1685 found = any(tax.account_head == tax_type for tax in taxes)
1686 if not found:
1687 tax_row = parent_doc.append("taxes", {})
1688 tax_row.update({
1689 "description" : str(tax_type).split(' - ')[0],
1690 "charge_type" : "On Net Total",
1691 "account_head" : tax_type,
1692 "rate" : tax_rate
1693 })
1694 if parent_doc.doctype == "Purchase Order":
1695 tax_row.update({
1696 "category" : "Total",
1697 "add_deduct_tax" : "Add"
1698 })
Afshanb3bbebd2021-08-09 14:39:32 +05301699 if db_insert:
1700 tax_row.db_insert()
Marica3b1be2b2020-10-22 17:04:31 +05301701
pateljannat637ddff2021-02-09 16:17:30 +05301702def set_order_defaults(parent_doctype, parent_doctype_name, child_doctype, child_docname, trans_item):
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001703 """
pateljannat637ddff2021-02-09 16:17:30 +05301704 Returns a Sales/Purchase Order Item child item containing the default values
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001705 """
Saqib438e0432020-04-03 10:02:56 +05301706 p_doc = frappe.get_doc(parent_doctype, parent_doctype_name)
pateljannat637ddff2021-02-09 16:17:30 +05301707 child_item = frappe.new_doc(child_doctype, p_doc, child_docname)
Saqib Ansarif53299e2020-04-15 22:08:12 +05301708 item = frappe.get_doc("Item", trans_item.get('item_code'))
marination0673f552021-03-31 01:38:22 +05301709
pateljannat637ddff2021-02-09 16:17:30 +05301710 for field in ("item_code", "item_name", "description", "item_group"):
marination0673f552021-03-31 01:38:22 +05301711 child_item.update({field: item.get(field)})
1712
pateljannat637ddff2021-02-09 16:17:30 +05301713 date_fieldname = "delivery_date" if child_doctype == "Sales Order Item" else "schedule_date"
Jannat Patelbb0d8f82021-02-11 20:59:28 +05301714 child_item.update({date_fieldname: trans_item.get(date_fieldname) or p_doc.get(date_fieldname)})
marination0673f552021-03-31 01:38:22 +05301715 child_item.stock_uom = item.stock_uom
Saqib61314242020-09-15 11:14:31 +05301716 child_item.uom = trans_item.get("uom") or item.stock_uom
Andy Zhu1062d7e2020-10-06 10:51:42 +13001717 child_item.warehouse = get_item_warehouse(item, p_doc, overwrite_warehouse=True)
Saqib61314242020-09-15 11:14:31 +05301718 conversion_factor = flt(get_conversion_factor(item.item_code, child_item.uom).get("conversion_factor"))
1719 child_item.conversion_factor = flt(trans_item.get('conversion_factor')) or conversion_factor
marination0673f552021-03-31 01:38:22 +05301720
pateljannat637ddff2021-02-09 16:17:30 +05301721 if child_doctype == "Purchase Order Item":
marination0673f552021-03-31 01:38:22 +05301722 # Initialized value will update in parent validation
1723 child_item.base_rate = 1
1724 child_item.base_amount = 1
pateljannat637ddff2021-02-09 16:17:30 +05301725 if child_doctype == "Sales Order Item":
1726 child_item.warehouse = get_item_warehouse(item, p_doc, overwrite_warehouse=True)
1727 if not child_item.warehouse:
1728 frappe.throw(_("Cannot find {} for item {}. Please set the same in Item Master or Stock Settings.")
1729 .format(frappe.bold("default warehouse"), frappe.bold(item.item_code)))
marination0673f552021-03-31 01:38:22 +05301730
marination698d9832020-08-19 14:59:46 +05301731 set_child_tax_template_and_map(item, child_item, p_doc)
Marica3b1be2b2020-10-22 17:04:31 +05301732 add_taxes_from_tax_template(child_item, p_doc)
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001733 return child_item
1734
marination0673f552021-03-31 01:38:22 +05301735def validate_child_on_delete(row, parent):
1736 """Check if partially transacted item (row) is being deleted."""
1737 if parent.doctype == "Sales Order":
1738 if flt(row.delivered_qty):
1739 frappe.throw(_("Row #{0}: Cannot delete item {1} which has already been delivered").format(row.idx, row.item_code))
1740 if flt(row.work_order_qty):
1741 frappe.throw(_("Row #{0}: Cannot delete item {1} which has work order assigned to it.").format(row.idx, row.item_code))
1742 if flt(row.ordered_qty):
1743 frappe.throw(_("Row #{0}: Cannot delete item {1} which is assigned to customer's purchase order.").format(row.idx, row.item_code))
1744
1745 if parent.doctype == "Purchase Order" and flt(row.received_qty):
1746 frappe.throw(_("Row #{0}: Cannot delete item {1} which has already been received").format(row.idx, row.item_code))
1747
1748 if flt(row.billed_amt):
1749 frappe.throw(_("Row #{0}: Cannot delete item {1} which has already been billed.").format(row.idx, row.item_code))
1750
1751def update_bin_on_delete(row, doctype):
1752 """Update bin for deleted item (row)."""
1753 from erpnext.stock.stock_balance import update_bin_qty, get_reserved_qty, get_ordered_qty, get_indented_qty
1754 qty_dict = {}
1755
1756 if doctype == "Sales Order":
1757 qty_dict["reserved_qty"] = get_reserved_qty(row.item_code, row.warehouse)
1758 else:
1759 if row.material_request_item:
1760 qty_dict["indented_qty"] = get_indented_qty(row.item_code, row.warehouse)
1761
1762 qty_dict["ordered_qty"] = get_ordered_qty(row.item_code, row.warehouse)
1763
1764 update_bin_qty(row.item_code, row.warehouse, qty_dict)
1765
Saqib6db92fb2020-09-14 19:54:17 +05301766def validate_and_delete_children(parent, data):
Saqib0ad74492019-12-24 16:42:30 +05301767 deleted_children = []
1768 updated_item_names = [d.get("docname") for d in data]
1769 for item in parent.items:
1770 if item.name not in updated_item_names:
1771 deleted_children.append(item)
1772
1773 for d in deleted_children:
marination0673f552021-03-31 01:38:22 +05301774 validate_child_on_delete(d, parent)
Saqib0ad74492019-12-24 16:42:30 +05301775 d.cancel()
1776 d.delete()
marination0673f552021-03-31 01:38:22 +05301777
1778 # need to update ordered qty in Material Request first
1779 # bin uses Material Request Items to recalculate & update
1780 parent.update_prevdoc_status()
1781
1782 for d in deleted_children:
1783 update_bin_on_delete(d, parent.doctype)
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001784
Rohan Bansala93b5142021-04-06 17:10:52 +05301785
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001786@frappe.whitelist()
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001787def update_child_qty_rate(parent_doctype, trans_items, parent_doctype_name, child_docname="items"):
Saqib6db92fb2020-09-14 19:54:17 +05301788 def check_doc_permissions(doc, perm_type='create'):
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301789 try:
1790 doc.check_permission(perm_type)
Saqib6db92fb2020-09-14 19:54:17 +05301791 except frappe.PermissionError:
marination661bf642020-09-29 18:16:45 +05301792 actions = { 'create': 'add', 'write': 'update'}
Saqib6db92fb2020-09-14 19:54:17 +05301793
1794 frappe.throw(_("You do not have permissions to {} items in a {}.")
1795 .format(actions[perm_type], parent_doctype), title=_("Insufficient Permissions"))
marination665c27a2020-09-15 12:04:38 +05301796
Saqib6db92fb2020-09-14 19:54:17 +05301797 def validate_workflow_conditions(doc):
1798 workflow = get_workflow_name(doc.doctype)
1799 if not workflow:
1800 return
1801
1802 workflow_doc = frappe.get_doc("Workflow", workflow)
1803 current_state = doc.get(workflow_doc.workflow_state_field)
1804 roles = frappe.get_roles()
1805
1806 transitions = []
1807 for transition in workflow_doc.transitions:
1808 if transition.next_state == current_state and transition.allowed in roles:
1809 if not is_transition_condition_satisfied(transition, doc):
1810 continue
1811 transitions.append(transition.as_dict())
1812
1813 if not transitions:
Saqib18318932020-09-23 13:01:49 +05301814 frappe.throw(
1815 _("You are not allowed to update as per the conditions set in {} Workflow.").format(get_link_to_form("Workflow", workflow)),
1816 title=_("Insufficient Permissions")
1817 )
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301818
Rohit Waghchaure8d5380a2020-06-18 14:06:31 +05301819 def get_new_child_item(item_row):
Rohit Waghchaureff70e612021-03-06 22:08:08 +05301820 child_doctype = "Sales Order Item" if parent_doctype == "Sales Order" else "Purchase Order Item"
pateljannat637ddff2021-02-09 16:17:30 +05301821 return set_order_defaults(parent_doctype, parent_doctype_name, child_doctype, child_docname, item_row)
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301822
1823 def validate_quantity(child_item, d):
1824 if parent_doctype == "Sales Order" and flt(d.get("qty")) < flt(child_item.delivered_qty):
1825 frappe.throw(_("Cannot set quantity less than delivered quantity"))
1826
1827 if parent_doctype == "Purchase Order" and flt(d.get("qty")) < flt(child_item.received_qty):
1828 frappe.throw(_("Cannot set quantity less than received quantity"))
1829
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001830 data = json.loads(trans_items)
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001831
rohitwaghchaure81c21752019-10-31 15:56:10 +05301832 sales_doctypes = ['Sales Order', 'Sales Invoice', 'Delivery Note', 'Quotation']
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301833 parent = frappe.get_doc(parent_doctype, parent_doctype_name)
marination665c27a2020-09-15 12:04:38 +05301834
marination661bf642020-09-29 18:16:45 +05301835 check_doc_permissions(parent, 'write')
Saqib6db92fb2020-09-14 19:54:17 +05301836 validate_and_delete_children(parent, data)
Saqib0ad74492019-12-24 16:42:30 +05301837
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001838 for d in data:
1839 new_child_flag = False
Ankush Menat6de7b8e2021-08-24 12:18:40 +05301840
1841 if not d.get("item_code"):
1842 # ignore empty rows
1843 continue
1844
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001845 if not d.get("docname"):
1846 new_child_flag = True
Saqib6db92fb2020-09-14 19:54:17 +05301847 check_doc_permissions(parent, 'create')
Rohit Waghchaure8d5380a2020-06-18 14:06:31 +05301848 child_item = get_new_child_item(d)
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001849 else:
Saqib6db92fb2020-09-14 19:54:17 +05301850 check_doc_permissions(parent, 'write')
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001851 child_item = frappe.get_doc(parent_doctype + ' Item', d.get("docname"))
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301852
Saqib Ansaric579b082020-05-29 22:21:50 +05301853 prev_rate, new_rate = flt(child_item.get("rate")), flt(d.get("rate"))
1854 prev_qty, new_qty = flt(child_item.get("qty")), flt(d.get("qty"))
1855 prev_con_fac, new_con_fac = flt(child_item.get("conversion_factor")), flt(d.get("conversion_factor"))
Saqib61314242020-09-15 11:14:31 +05301856 prev_uom, new_uom = child_item.get("uom"), d.get("uom")
Saqib Ansaric579b082020-05-29 22:21:50 +05301857
1858 if parent_doctype == 'Sales Order':
1859 prev_date, new_date = child_item.get("delivery_date"), d.get("delivery_date")
1860 elif parent_doctype == 'Purchase Order':
marinationb7e94cc2020-06-15 11:32:42 +05301861 prev_date, new_date = child_item.get("schedule_date"), d.get("schedule_date")
Saqib Ansaric579b082020-05-29 22:21:50 +05301862
1863 rate_unchanged = prev_rate == new_rate
marinationf9c4b202020-06-12 15:49:53 +05301864 qty_unchanged = prev_qty == new_qty
Saqib61314242020-09-15 11:14:31 +05301865 uom_unchanged = prev_uom == new_uom
Saqib Ansaric579b082020-05-29 22:21:50 +05301866 conversion_factor_unchanged = prev_con_fac == new_con_fac
Frappe PR Bot44434ff2021-08-18 18:33:06 +05301867 date_unchanged = prev_date == getdate(new_date) if prev_date and new_date else False # in case of delivery note etc
Saqib61314242020-09-15 11:14:31 +05301868 if rate_unchanged and qty_unchanged and conversion_factor_unchanged and uom_unchanged and date_unchanged:
Saqibdd374ff2020-02-27 12:51:31 +05301869 continue
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001870
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301871 validate_quantity(child_item, d)
deepeshgarg00777cde832018-12-27 15:56:51 +05301872
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001873 child_item.qty = flt(d.get("qty"))
Saqib56fea7d2020-10-09 21:19:25 +05301874 rate_precision = child_item.precision("rate") or 2
1875 conv_fac_precision = child_item.precision("conversion_factor") or 2
1876 qty_precision = child_item.precision("qty") or 2
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001877
Saqib56fea7d2020-10-09 21:19:25 +05301878 if flt(child_item.billed_amt, rate_precision) > flt(flt(d.get("rate"), rate_precision) * flt(d.get("qty"), qty_precision), rate_precision):
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001879 frappe.throw(_("Row #{0}: Cannot set Rate if amount is greater than billed amount for Item {1}.")
1880 .format(child_item.idx, child_item.item_code))
1881 else:
Saqib56fea7d2020-10-09 21:19:25 +05301882 child_item.rate = flt(d.get("rate"), rate_precision)
marinationf9c4b202020-06-12 15:49:53 +05301883
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301884 if d.get("conversion_factor"):
marinationf9c4b202020-06-12 15:49:53 +05301885 if child_item.stock_uom == child_item.uom:
1886 child_item.conversion_factor = 1
1887 else:
Saqib56fea7d2020-10-09 21:19:25 +05301888 child_item.conversion_factor = flt(d.get('conversion_factor'), conv_fac_precision)
marination665c27a2020-09-15 12:04:38 +05301889
Saqib61314242020-09-15 11:14:31 +05301890 if d.get("uom"):
1891 child_item.uom = d.get("uom")
1892 conversion_factor = flt(get_conversion_factor(child_item.item_code, child_item.uom).get("conversion_factor"))
Saqib56fea7d2020-10-09 21:19:25 +05301893 child_item.conversion_factor = flt(d.get('conversion_factor'), conv_fac_precision) or conversion_factor
Mangesh-Khairnara3d52002019-08-05 10:16:40 +05301894
Saqib Ansaric579b082020-05-29 22:21:50 +05301895 if d.get("delivery_date") and parent_doctype == 'Sales Order':
1896 child_item.delivery_date = d.get('delivery_date')
marinationf9c4b202020-06-12 15:49:53 +05301897
Saqib Ansaric579b082020-05-29 22:21:50 +05301898 if d.get("schedule_date") and parent_doctype == 'Purchase Order':
1899 child_item.schedule_date = d.get('schedule_date')
1900
Mangesh-Khairnara3d52002019-08-05 10:16:40 +05301901 if flt(child_item.price_list_rate):
Maricaf0674472019-10-11 10:47:09 +05301902 if flt(child_item.rate) > flt(child_item.price_list_rate):
1903 # if rate is greater than price_list_rate, set margin
1904 # or set discount
1905 child_item.discount_percentage = 0
rohitwaghchaure81c21752019-10-31 15:56:10 +05301906
1907 if parent_doctype in sales_doctypes:
1908 child_item.margin_type = "Amount"
1909 child_item.margin_rate_or_amount = flt(child_item.rate - child_item.price_list_rate,
1910 child_item.precision("margin_rate_or_amount"))
1911 child_item.rate_with_margin = child_item.rate
Maricaf0674472019-10-11 10:47:09 +05301912 else:
1913 child_item.discount_percentage = flt((1 - flt(child_item.rate) / flt(child_item.price_list_rate)) * 100.0,
1914 child_item.precision("discount_percentage"))
1915 child_item.discount_amount = flt(
1916 child_item.price_list_rate) - flt(child_item.rate)
rohitwaghchaure81c21752019-10-31 15:56:10 +05301917
1918 if parent_doctype in sales_doctypes:
1919 child_item.margin_type = ""
1920 child_item.margin_rate_or_amount = 0
1921 child_item.rate_with_margin = 0
Mangesh-Khairnara3d52002019-08-05 10:16:40 +05301922
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001923 child_item.flags.ignore_validate_update_after_submit = True
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001924 if new_child_flag:
Saqib Ansarif53299e2020-04-15 22:08:12 +05301925 parent.load_from_db()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301926 child_item.idx = len(parent.items) + 1
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001927 child_item.insert()
1928 else:
1929 child_item.save()
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001930
Rushabh Mehtafafbb022018-12-24 22:09:15 +05301931 parent.reload()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301932 parent.flags.ignore_validate_update_after_submit = True
1933 parent.set_qty_as_per_stock_uom()
1934 parent.calculate_taxes_and_totals()
Ankush Menatdf6e2082021-02-11 11:04:39 +05301935 parent.set_total_in_words()
Nabin Hait49a46f02019-10-21 13:35:43 +05301936 if parent_doctype == "Sales Order":
Marica3dee5272020-06-23 10:33:47 +05301937 make_packing_list(parent)
Nabin Hait49a46f02019-10-21 13:35:43 +05301938 parent.set_gross_profit()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301939 frappe.get_doc('Authorization Control').validate_approving_authority(parent.doctype,
1940 parent.company, parent.base_grand_total)
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001941
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301942 parent.set_payment_schedule()
Nabin Haitb2da0822018-07-13 17:01:40 +05301943 if parent_doctype == 'Purchase Order':
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301944 parent.validate_minimum_order_qty()
1945 parent.validate_budget()
1946 if parent.is_against_so():
1947 parent.update_status_updater()
Nabin Haitb2da0822018-07-13 17:01:40 +05301948 else:
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301949 parent.check_credit_limit()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301950 parent.save()
Nabin Haitb2da0822018-07-13 17:01:40 +05301951
1952 if parent_doctype == 'Purchase Order':
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301953 update_last_purchase_rate(parent, is_submit = 1)
1954 parent.update_prevdoc_status()
1955 parent.update_requested_qty()
1956 parent.update_ordered_qty()
1957 parent.update_ordered_and_reserved_qty()
1958 parent.update_receiving_percentage()
1959 if parent.is_subcontracted == "Yes":
1960 parent.update_reserved_qty_for_subcontract()
Saqib61314242020-09-15 11:14:31 +05301961 parent.create_raw_materials_supplied("supplied_items")
1962 parent.save()
Nabin Haitb2da0822018-07-13 17:01:40 +05301963 else:
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301964 parent.update_reserved_qty()
1965 parent.update_project()
1966 parent.update_prevdoc_status('submit')
1967 parent.update_delivery_status()
Nabin Haitb2da0822018-07-13 17:01:40 +05301968
Saqib6db92fb2020-09-14 19:54:17 +05301969 parent.reload()
1970 validate_workflow_conditions(parent)
1971
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301972 parent.update_blanket_order()
1973 parent.update_billing_percentage()
1974 parent.set_status()
Gauravf1e28e02019-02-13 16:46:24 +05301975
1976@erpnext.allow_regional
1977def validate_regional(doc):
1978 pass