blob: e96312513c4d1ed8b65104ae4940385886f8e0e4 [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
Deepesh Garg80c85dd2021-08-12 15:39:07 +053017from erpnext.accounts.party import get_party_account_currency, validate_party_frozen_disabled, get_party_gle_currency
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()
Deepesh Garg80c85dd2021-08-12 15:39:07 +0530116 self.validate_party_account_currency()
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +0530117
Rohit Waghchaure6087fe12016-04-09 14:31:09 +0530118 if self.doctype == 'Purchase Invoice':
Mangesh-Khairnar7bcb24e2019-09-11 10:49:33 +0530119 self.calculate_paid_amount()
Deepesh Garg911818a2021-06-09 22:55:10 +0530120 # apply tax withholding only if checked and applicable
121 self.set_tax_withholding()
Rohit Waghchaure6087fe12016-04-09 14:31:09 +0530122
Nabin Hait041a5c22018-08-01 18:07:39 +0530123 if self.doctype in ['Purchase Invoice', 'Sales Invoice']:
Nabin Hait4a994d42019-04-25 17:47:26 +0530124 pos_check_field = "is_pos" if self.doctype=="Sales Invoice" else "is_paid"
125 if cint(self.allocate_advances_automatically) and not cint(self.get(pos_check_field)):
Nabin Hait041a5c22018-08-01 18:07:39 +0530126 self.set_advances()
127
Saqiba20999c2021-07-12 14:33:23 +0530128 self.set_advance_gain_or_loss()
129
Nabin Hait041a5c22018-08-01 18:07:39 +0530130 if self.is_return:
131 self.validate_qty()
Nabin Haitacdd5082019-12-04 15:30:01 +0530132 else:
133 self.validate_deferred_start_and_end_date()
rohitwaghchaure70489252018-06-11 12:02:14 +0530134
Deepesh Gargf17ea2c2020-12-11 21:30:39 +0530135 self.set_inter_company_account()
136
Gauravf1e28e02019-02-13 16:46:24 +0530137 validate_regional(self)
Deepesh Garg7c300852020-12-26 20:14:51 +0530138
Saqib6d74f5b2020-12-25 10:26:43 +0530139 validate_einvoice_fields(self)
140
Rohit Waghchaure8bfe3302019-03-18 14:34:19 +0530141 if self.doctype != 'Material Request':
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530142 apply_pricing_rule_on_transaction(self)
Gauravf1e28e02019-02-13 16:46:24 +0530143
Saqib6d74f5b2020-12-25 10:26:43 +0530144 def before_cancel(self):
145 validate_einvoice_fields(self)
rohitwaghchaurebf7317d2021-02-01 20:22:14 +0530146
Saqib8e556772021-01-28 12:26:45 +0530147 def on_trash(self):
148 # delete sl and gl entries on deletion of transaction
149 if frappe.db.get_single_value('Accounts Settings', 'delete_linked_ledger_entries'):
150 frappe.db.sql("delete from `tabGL Entry` where voucher_type=%s and voucher_no=%s", (self.doctype, self.name))
151 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 +0530152
Nabin Haitacdd5082019-12-04 15:30:01 +0530153 def validate_deferred_start_and_end_date(self):
154 for d in self.items:
155 if d.get("enable_deferred_revenue") or d.get("enable_deferred_expense"):
156 if not (d.service_start_date and d.service_end_date):
157 frappe.throw(_("Row #{0}: Service Start and End Date is required for deferred accounting").format(d.idx))
158 elif getdate(d.service_start_date) > getdate(d.service_end_date):
159 frappe.throw(_("Row #{0}: Service Start Date cannot be greater than Service End Date").format(d.idx))
160 elif getdate(self.posting_date) > getdate(d.service_end_date):
161 frappe.throw(_("Row #{0}: Service End Date cannot be before Invoice Posting Date").format(d.idx))
162
tunde62af5c52017-09-22 15:16:38 +0100163 def validate_invoice_documents_schedule(self):
Nabin Hait0551f7b2017-11-21 19:58:16 +0530164 self.validate_payment_schedule_dates()
165 self.set_due_date()
Nabin Hait0551f7b2017-11-21 19:58:16 +0530166 self.set_payment_schedule()
167 self.validate_payment_schedule_amount()
tunde62af5c52017-09-22 15:16:38 +0100168 self.validate_due_date()
169 self.validate_advance_entries()
170
171 def validate_non_invoice_documents_schedule(self):
Nabin Hait0551f7b2017-11-21 19:58:16 +0530172 self.set_payment_schedule()
Nabin Hait2f9f4f92017-12-20 12:24:59 +0530173 self.validate_payment_schedule_dates()
Nabin Hait0551f7b2017-11-21 19:58:16 +0530174 self.validate_payment_schedule_amount()
tunde62af5c52017-09-22 15:16:38 +0100175
176 def validate_all_documents_schedule(self):
177 if self.doctype in ("Sales Invoice", "Purchase Invoice") and not self.is_return:
178 self.validate_invoice_documents_schedule()
179 elif self.doctype in ("Quotation", "Purchase Order", "Sales Order"):
180 self.validate_non_invoice_documents_schedule()
181
prssanna71e5b602020-10-29 14:19:34 +0530182 def before_print(self, settings=None):
Zarrarb9f54ca2018-05-28 17:41:09 +0530183 if self.doctype in ['Purchase Order', 'Sales Order', 'Sales Invoice', 'Purchase Invoice',
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800184 'Supplier Quotation', 'Purchase Receipt', 'Delivery Note', 'Quotation']:
KanchanChauhan49a50fe2016-11-18 13:57:53 +0530185 if self.get("group_same_items"):
186 self.group_similar_items()
187
Zarrar5be6d192018-11-08 12:16:26 +0530188 df = self.meta.get_field("discount_amount")
189 if self.get("discount_amount") and hasattr(self, "taxes") and not len(self.taxes):
190 df.set("print_hide", 0)
191 self.discount_amount = -self.discount_amount
192 else:
193 df.set("print_hide", 1)
194
prssanna71e5b602020-10-29 14:19:34 +0530195 set_print_templates_for_item_table(self, settings)
196 set_print_templates_for_taxes(self, settings)
197
Mangesh-Khairnar7bcb24e2019-09-11 10:49:33 +0530198 def calculate_paid_amount(self):
Saurabh43520f92016-03-21 18:32:48 +0530199 if hasattr(self, "is_pos") or hasattr(self, "is_paid"):
200 is_paid = self.get("is_pos") or self.get("is_paid")
Mangesh-Khairnar7bcb24e2019-09-11 10:49:33 +0530201
202 if is_paid:
203 if not self.cash_bank_account:
204 # show message that the amount is not paid
205 frappe.throw(_("Note: Payment Entry will not be created since 'Cash or Bank Account' was not specified"))
Marica23d7b092019-09-25 17:17:36 +0530206
Mangesh-Khairnar7bcb24e2019-09-11 10:49:33 +0530207 if cint(self.is_return) and self.grand_total > self.paid_amount:
208 self.paid_amount = flt(flt(self.grand_total), self.precision("paid_amount"))
209
210 elif not flt(self.paid_amount) and flt(self.outstanding_amount) > 0:
211 self.paid_amount = flt(flt(self.outstanding_amount), self.precision("paid_amount"))
212
213 self.base_paid_amount = flt(self.paid_amount * self.conversion_rate,
214 self.precision("base_paid_amount"))
Saurabh43520f92016-03-21 18:32:48 +0530215
Anand Doshiabc10032013-06-14 17:44:03 +0530216 def set_missing_values(self, for_validate=False):
Rohit Waghchaure5d97d892016-05-12 12:58:29 +0530217 if frappe.flags.in_test:
tunde62af5c52017-09-22 15:16:38 +0100218 for fieldname in ["posting_date", "transaction_date"]:
Rohit Waghchaure5d97d892016-05-12 12:58:29 +0530219 if self.meta.get_field(fieldname) and not self.get(fieldname):
220 self.set(fieldname, today())
221 break
Anand Doshid2946502014-04-08 20:10:03 +0530222
Nabin Hait3237c752015-02-17 11:11:11 +0530223 def calculate_taxes_and_totals(self):
Nabin Haitfe81da22015-02-18 12:23:18 +0530224 from erpnext.controllers.taxes_and_totals import calculate_taxes_and_totals
225 calculate_taxes_and_totals(self)
Nabin Hait3237c752015-02-17 11:11:11 +0530226
227 if self.doctype in ["Quotation", "Sales Order", "Delivery Note", "Sales Invoice"]:
228 self.calculate_commission()
229 self.calculate_contribution()
230
Nabin Haitcfecd2b2013-07-11 17:49:18 +0530231 def validate_date_with_fiscal_year(self):
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800232 if self.meta.get_field("fiscal_year"):
Rohan Bansal1e3a3b22021-05-26 15:18:10 +0530233 date_field = None
Nabin Haitcfecd2b2013-07-11 17:49:18 +0530234 if self.meta.get_field("posting_date"):
235 date_field = "posting_date"
236 elif self.meta.get_field("transaction_date"):
237 date_field = "transaction_date"
Anand Doshid2946502014-04-08 20:10:03 +0530238
Rushabh Mehtaf2227d02014-03-31 23:37:40 +0530239 if date_field and self.get(date_field):
Rushabh Mehta66958302017-01-16 16:57:53 +0530240 validate_fiscal_year(self.get(date_field), self.fiscal_year, self.company,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800241 self.meta.get_label(date_field), self)
Anand Doshid2946502014-04-08 20:10:03 +0530242
Deepesh Garg4c8d15b2021-04-26 15:24:34 +0530243 def validate_party_accounts(self):
244 if self.doctype not in ('Sales Invoice', 'Purchase Invoice'):
245 return
246
247 if self.doctype == 'Sales Invoice':
248 party_account_field = 'debit_to'
249 item_field = 'income_account'
250 else:
251 party_account_field = 'credit_to'
252 item_field = 'expense_account'
253
254 for item in self.get('items'):
255 if item.get(item_field) == self.get(party_account_field):
256 frappe.throw(_("Row {0}: {1} {2} cannot be same as {3} (Party Account) {4}").format(item.idx,
257 frappe.bold(frappe.unscrub(item_field)), item.get(item_field),
258 frappe.bold(frappe.unscrub(party_account_field)), self.get(party_account_field)))
259
Deepesh Gargb4be2922021-01-28 13:09:56 +0530260 def validate_inter_company_reference(self):
261 if self.doctype not in ('Purchase Invoice', 'Purchase Receipt', 'Purchase Order'):
262 return
263
264 if self.is_internal_transfer():
265 if not (self.get('inter_company_reference') or self.get('inter_company_invoice_reference')
266 or self.get('inter_company_order_reference')):
Deepesh Garg4c8d15b2021-04-26 15:24:34 +0530267 msg = _("Internal Sale or Delivery Reference missing.")
Deepesh Gargb4be2922021-01-28 13:09:56 +0530268 msg += _("Please create purchase from internal sale or delivery document itself")
269 frappe.throw(msg, title=_("Internal Sales Reference Missing"))
270
Nabin Haite9daefe2014-08-27 16:46:33 +0530271 def validate_due_date(self):
rohitwaghchaureea943c62018-07-06 12:28:58 +0530272 if self.get('is_pos'): return
273
Nabin Haite9daefe2014-08-27 16:46:33 +0530274 from erpnext.accounts.party import validate_due_date
275 if self.doctype == "Sales Invoice":
Nabin Hait04d244a2015-07-22 17:47:49 +0530276 if not self.due_date:
277 frappe.throw(_("Due Date is mandatory"))
Rushabh Mehtab16b9cd2015-08-03 16:13:33 +0530278
rohitwaghchaure3ffe8962018-07-13 17:40:48 +0530279 validate_due_date(self.posting_date, self.due_date,
280 "Customer", self.customer, self.company, self.payment_terms_template)
Nabin Haite9daefe2014-08-27 16:46:33 +0530281 elif self.doctype == "Purchase Invoice":
Rohit Waghchaured1a85a32018-11-26 18:42:29 +0530282 validate_due_date(self.bill_date or self.posting_date, self.due_date,
Saurabhd7897f12018-07-18 17:08:16 +0530283 "Supplier", self.supplier, self.company, self.bill_date, self.payment_terms_template)
Nabin Haite9daefe2014-08-27 16:46:33 +0530284
Nabin Hait096d3632013-10-17 17:01:14 +0530285 def set_price_list_currency(self, buying_or_selling):
Nabin Hait1cc55fb2016-12-08 14:09:23 +0530286 if self.meta.get_field("posting_date"):
Nabin Hait288a18e2016-12-08 15:36:23 +0530287 transaction_date = self.posting_date
Nabin Hait1cc55fb2016-12-08 14:09:23 +0530288 else:
Nabin Hait288a18e2016-12-08 15:36:23 +0530289 transaction_date = self.transaction_date
Rushabh Mehta66958302017-01-16 16:57:53 +0530290
Rushabh Mehta4a404e92013-08-09 18:11:35 +0530291 if self.meta.get_field("currency"):
Nabin Hait7a75e102013-09-17 10:21:20 +0530292 # price list part
Shreya3f778522018-05-15 16:59:20 +0530293 if buying_or_selling.lower() == "selling":
294 fieldname = "selling_price_list"
295 args = "for_selling"
296 else:
297 fieldname = "buying_price_list"
298 args = "for_buying"
299
Anand Doshif78d1ae2014-03-28 13:55:00 +0530300 if self.meta.get_field(fieldname) and self.get(fieldname):
301 self.price_list_currency = frappe.db.get_value("Price List",
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800302 self.get(fieldname), "currency")
Anand Doshid2946502014-04-08 20:10:03 +0530303
Nabin Hait6e439a52015-08-28 19:24:22 +0530304 if self.price_list_currency == self.company_currency:
Anand Doshif78d1ae2014-03-28 13:55:00 +0530305 self.plc_conversion_rate = 1.0
Nabin Hait11f41952013-09-24 14:36:55 +0530306
Anand Doshif78d1ae2014-03-28 13:55:00 +0530307 elif not self.plc_conversion_rate:
Rushabh Mehta66958302017-01-16 16:57:53 +0530308 self.plc_conversion_rate = get_exchange_rate(self.price_list_currency,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800309 self.company_currency, transaction_date, args)
Anand Doshid2946502014-04-08 20:10:03 +0530310
Nabin Hait7a75e102013-09-17 10:21:20 +0530311 # currency
Anand Doshif78d1ae2014-03-28 13:55:00 +0530312 if not self.currency:
313 self.currency = self.price_list_currency
314 self.conversion_rate = self.plc_conversion_rate
Nabin Hait6e439a52015-08-28 19:24:22 +0530315 elif self.currency == self.company_currency:
Anand Doshif78d1ae2014-03-28 13:55:00 +0530316 self.conversion_rate = 1.0
317 elif not self.conversion_rate:
Anand Doshidffec8f2014-07-01 17:45:15 +0530318 self.conversion_rate = get_exchange_rate(self.currency,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800319 self.company_currency, transaction_date, args)
Nabin Hait7a75e102013-09-17 10:21:20 +0530320
Nabin Haitcccc45e2016-10-05 17:15:43 +0530321 def set_missing_item_details(self, for_validate=False):
Anand Doshi3543f302013-05-24 19:25:01 +0530322 """set missing item values"""
Nabin Haitf37d43d2017-07-18 12:14:42 +0530323 from erpnext.stock.doctype.serial_no.serial_no import get_serial_nos
Rushabh Mehtab46069d2016-01-15 16:59:26 +0530324
Nabin Haitdd38a262014-12-26 13:15:21 +0530325 if hasattr(self, "items"):
Nabin Hait444f9562014-06-20 15:59:49 +0530326 parent_dict = {}
Pratik Vyasf7daab72014-04-10 17:53:30 +0530327 for fieldname in self.meta.get_valid_columns():
328 parent_dict[fieldname] = self.get(fieldname)
329
mbauskara52472c2016-03-05 15:10:25 +0530330 if self.doctype in ["Quotation", "Sales Order", "Delivery Note", "Sales Invoice"]:
331 document_type = "{} Item".format(self.doctype)
mbauskarc97becb2016-01-18 16:28:21 +0530332 parent_dict.update({"document_type": document_type})
333
Nabin Hait34c551d2019-07-03 10:34:31 +0530334 # party_name field used for customer in quotation
335 if self.doctype == "Quotation" and self.quotation_to == "Customer" and parent_dict.get("party_name"):
336 parent_dict.update({"customer": parent_dict.get("party_name")})
337
Rohit Waghchaurea248dfb2020-07-16 17:27:26 +0530338 self.pricing_rules = []
Nabin Haitdd38a262014-12-26 13:15:21 +0530339 for item in self.get("items"):
Rushabh Mehtaf14b8092014-04-03 14:30:42 +0530340 if item.get("item_code"):
Nabin Hait444f9562014-06-20 15:59:49 +0530341 args = parent_dict.copy()
342 args.update(item.as_dict())
Rushabh Mehtab46069d2016-01-15 16:59:26 +0530343
Nabin Hait34d28222016-01-19 15:45:49 +0530344 args["doctype"] = self.doctype
345 args["name"] = self.name
Rohit Waghchaure8bfe3302019-03-18 14:34:19 +0530346 args["child_docname"] = item.name
Saqibac9e6ff2021-01-28 17:58:55 +0530347 args["ignore_pricing_rule"] = self.ignore_pricing_rule if hasattr(self, 'ignore_pricing_rule') else 0
Rushabh Mehtab46069d2016-01-15 16:59:26 +0530348
Nabin Haite2f054c2015-03-09 14:54:37 +0530349 if not args.get("transaction_date"):
350 args["transaction_date"] = args.get("posting_date")
Anand Doshi2b2b6392015-03-20 14:18:09 +0530351
352 if self.get("is_subcontracted"):
353 args["is_subcontracted"] = self.is_subcontracted
Rohit Waghchaure8bfe3302019-03-18 14:34:19 +0530354
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530355 ret = get_item_details(args, self, for_validate=True, overwrite_warehouse=False)
Rohit Waghchaure8bfe3302019-03-18 14:34:19 +0530356
Rushabh Mehtaf14b8092014-04-03 14:30:42 +0530357 for fieldname, value in ret.items():
Anand Doshi602e8252015-11-16 19:05:46 +0530358 if item.meta.get_field(fieldname) and value is not None:
359 if (item.get(fieldname) is None or fieldname in force_item_fields):
Rushabh Mehtaf14b8092014-04-03 14:30:42 +0530360 item.set(fieldname, value)
Anand Doshid2946502014-04-08 20:10:03 +0530361
Rohit Waghchauredc981dc2017-04-03 14:17:08 +0530362 elif fieldname in ['cost_center', 'conversion_factor'] and not item.get(fieldname):
Anand Doshi602e8252015-11-16 19:05:46 +0530363 item.set(fieldname, value)
364
Rohit Waghchauredc981dc2017-04-03 14:17:08 +0530365 elif fieldname == "serial_no":
Alchez9155e402018-07-09 16:57:42 +0530366 # Ensure that serial numbers are matched against Stock UOM
367 item_conversion_factor = item.get("conversion_factor") or 1.0
368 item_qty = abs(item.get("qty")) * item_conversion_factor
Alchez8f2a0f32018-07-06 14:36:52 +0530369
370 if item_qty != len(get_serial_nos(item.get('serial_no'))):
Rohit Waghchauredc981dc2017-04-03 14:17:08 +0530371 item.set(fieldname, value)
Nabin Haita74468b2014-12-30 18:33:52 +0530372
Rohit Waghchauref6f503a2018-12-19 15:06:44 +0530373 if self.doctype in ["Purchase Invoice", "Sales Invoice"] and item.meta.get_field('is_fixed_asset'):
374 item.set('is_fixed_asset', ret.get('is_fixed_asset', 0))
375
Deepesh Garga60c3082021-05-11 16:38:33 +0530376 # Double check for cost center
377 # Items add via promotional scheme may not have cost center set
378 if hasattr(item, 'cost_center') and not item.get('cost_center'):
379 item.set('cost_center', self.get('cost_center') or erpnext.get_default_cost_center(self.company))
380
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530381 if ret.get("pricing_rules"):
382 self.apply_pricing_rule_on_items(item, ret)
Rohit Waghchaurea248dfb2020-07-16 17:27:26 +0530383 self.set_pricing_rule_details(item, ret)
Rushabh Mehtab46069d2016-01-15 16:59:26 +0530384
Nabin Hait14aa9c52016-04-18 15:54:01 +0530385 if self.doctype == "Purchase Invoice":
Nabin Haitcccc45e2016-10-05 17:15:43 +0530386 self.set_expense_account(for_validate)
Nabin Haita3dd72a2014-05-28 12:49:20 +0530387
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530388 def apply_pricing_rule_on_items(self, item, pricing_rule_args):
389 if not pricing_rule_args.get("validate_applied_rule", 0):
390 # if user changed the discount percentage then set user's discount percentage ?
391 if pricing_rule_args.get("price_or_product_discount") == 'Price':
392 item.set("pricing_rules", pricing_rule_args.get("pricing_rules"))
393 item.set("discount_percentage", pricing_rule_args.get("discount_percentage"))
394 item.set("discount_amount", pricing_rule_args.get("discount_amount"))
395 if pricing_rule_args.get("pricing_rule_for") == "Rate":
396 item.set("price_list_rate", pricing_rule_args.get("price_list_rate"))
397
398 if item.get("price_list_rate"):
399 item.rate = flt(item.price_list_rate *
400 (1.0 - (flt(item.discount_percentage) / 100.0)), item.precision("rate"))
401
402 if item.get('discount_amount'):
403 item.rate = item.price_list_rate - item.discount_amount
404
Rohit Waghchaurea248dfb2020-07-16 17:27:26 +0530405 if item.get("apply_discount_on_discounted_rate") and pricing_rule_args.get("rate"):
406 item.rate = pricing_rule_args.get("rate")
407
Rohit Waghchaure21fe97e2019-12-13 16:18:38 +0530408 elif pricing_rule_args.get('free_item_data'):
409 apply_pricing_rule_for_free_items(self, pricing_rule_args.get('free_item_data'))
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530410
411 elif pricing_rule_args.get("validate_applied_rule"):
Rushabh Mehtaff5d1962020-08-25 11:59:57 +0530412 for pricing_rule in get_applied_pricing_rules(item.get('pricing_rules')):
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530413 pricing_rule_doc = frappe.get_cached_doc("Pricing Rule", pricing_rule)
414 for field in ['discount_percentage', 'discount_amount', 'rate']:
415 if item.get(field) < pricing_rule_doc.get(field):
416 title = get_link_to_form("Pricing Rule", pricing_rule)
417
418 frappe.msgprint(_("Row {0}: user has not applied the rule {1} on the item {2}")
419 .format(item.idx, frappe.bold(title), frappe.bold(item.item_code)))
420
Rohit Waghchaurea248dfb2020-07-16 17:27:26 +0530421 def set_pricing_rule_details(self, item_row, args):
422 pricing_rules = get_applied_pricing_rules(args.get("pricing_rules"))
423 if not pricing_rules: return
424
425 for pricing_rule in pricing_rules:
426 self.append("pricing_rules", {
427 "pricing_rule": pricing_rule,
428 "item_code": item_row.item_code,
429 "child_docname": item_row.name,
430 "rule_applied": True
431 })
432
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530433 def set_taxes(self):
434 if not self.meta.get_field("taxes"):
Anand Doshi3543f302013-05-24 19:25:01 +0530435 return
Anand Doshid2946502014-04-08 20:10:03 +0530436
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530437 tax_master_doctype = self.meta.get_field("taxes_and_charges").options
Anand Doshid2946502014-04-08 20:10:03 +0530438
rohitwaghchaure57914f12018-04-24 19:19:47 +0530439 if (self.is_new() or self.is_pos_profile_changed()) and not self.get("taxes"):
rohitwaghchaure505661b2017-12-11 14:52:28 +0530440 if self.company and not self.get("taxes_and_charges"):
Anand Doshi3543f302013-05-24 19:25:01 +0530441 # get the default tax master
rohitwaghchaure505661b2017-12-11 14:52:28 +0530442 self.taxes_and_charges = frappe.db.get_value(tax_master_doctype,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800443 {"is_default": 1, 'company': self.company})
Anand Doshid2946502014-04-08 20:10:03 +0530444
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530445 self.append_taxes_from_master(tax_master_doctype)
Anand Doshid2946502014-04-08 20:10:03 +0530446
rohitwaghchaure57914f12018-04-24 19:19:47 +0530447 def is_pos_profile_changed(self):
448 if (self.doctype == 'Sales Invoice' and self.is_pos and
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800449 self.pos_profile != frappe.db.get_value('Sales Invoice', self.name, 'pos_profile')):
rohitwaghchaure57914f12018-04-24 19:19:47 +0530450 return True
451
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530452 def append_taxes_from_master(self, tax_master_doctype=None):
453 if self.get("taxes_and_charges"):
Anand Doshi99100a42013-07-04 17:13:53 +0530454 if not tax_master_doctype:
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530455 tax_master_doctype = self.meta.get_field("taxes_and_charges").options
Anand Doshid2946502014-04-08 20:10:03 +0530456
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530457 self.extend("taxes", get_taxes_and_charges(tax_master_doctype, self.get("taxes_and_charges")))
Akhilesh Darjee4cdb7992014-01-30 13:56:57 +0530458
Anand Doshiac32bad2014-04-18 01:30:14 +0530459 def set_other_charges(self):
Nabin Haite7d15362014-12-25 16:01:55 +0530460 self.set("taxes", [])
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530461 self.set_taxes()
Anand Doshid2946502014-04-08 20:10:03 +0530462
ankitjavalkarwork6c29d872014-10-06 13:20:53 +0530463 def validate_enabled_taxes_and_charges(self):
464 taxes_and_charges_doctype = self.meta.get_options("taxes_and_charges")
465 if frappe.db.get_value(taxes_and_charges_doctype, self.taxes_and_charges, "disabled"):
466 frappe.throw(_("{0} '{1}' is disabled").format(taxes_and_charges_doctype, self.taxes_and_charges))
467
Nabin Haita2426fc2018-01-15 17:45:46 +0530468 def validate_tax_account_company(self):
469 for d in self.get("taxes"):
470 if d.account_head:
471 tax_account_company = frappe.db.get_value("Account", d.account_head, "company")
472 if tax_account_company != self.company:
473 frappe.throw(_("Row #{0}: Account {1} does not belong to company {2}")
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800474 .format(d.idx, d.account_head, self.company))
Nabin Haita2426fc2018-01-15 17:45:46 +0530475
deepeshgarg0073d11ac02019-05-19 00:02:01 +0530476 def get_gl_dict(self, args, account_currency=None, item=None):
Nabin Hait2df4d542013-01-29 11:34:39 +0530477 """this method populates the common properties of a gl entry record"""
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +0530478
Rohit Waghchaureaa7b4342018-05-11 01:56:05 +0530479 posting_date = args.get('posting_date') or self.get('posting_date')
480 fiscal_years = get_fiscal_years(posting_date, company=self.company)
Nabin Hait2ed0b592016-03-29 13:14:17 +0530481 if len(fiscal_years) > 1:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800482 frappe.throw(_("Multiple fiscal years exist for the date {0}. Please set company in Fiscal Year").format(
483 formatdate(posting_date)))
Nabin Hait2ed0b592016-03-29 13:14:17 +0530484 else:
485 fiscal_year = fiscal_years[0][0]
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +0530486
Rushabh Mehta793ba6b2014-02-14 15:47:51 +0530487 gl_dict = frappe._dict({
Anand Doshid2946502014-04-08 20:10:03 +0530488 'company': self.company,
Rohit Waghchaureaa7b4342018-05-11 01:56:05 +0530489 'posting_date': posting_date,
Nabin Hait2ed0b592016-03-29 13:14:17 +0530490 'fiscal_year': fiscal_year,
Anand Doshif78d1ae2014-03-28 13:55:00 +0530491 'voucher_type': self.doctype,
492 'voucher_no': self.name,
Nabin Hait5cd04a62019-05-27 11:44:06 +0530493 'remarks': self.get("remarks") or self.get("remark"),
Nabin Hait2df4d542013-01-29 11:34:39 +0530494 'debit': 0,
495 'credit': 0,
Nabin Hait46bcbaf2015-08-19 13:49:10 +0530496 'debit_in_account_currency': 0,
497 'credit_in_account_currency': 0,
Anand Doshif78d1ae2014-03-28 13:55:00 +0530498 'is_opening': self.get("is_opening") or "No",
Nabin Hait32251022014-08-29 11:18:32 +0530499 'party_type': None,
Nabin Hait591a5ab2016-05-26 17:41:39 +0530500 'party': None,
501 'project': self.get("project")
Nabin Hait2e296fa2013-08-28 18:53:11 +0530502 })
deepeshgarg007d83cf652019-05-12 18:34:23 +0530503
504 accounting_dimensions = get_accounting_dimensions()
505 dimension_dict = frappe._dict()
506
507 for dimension in accounting_dimensions:
508 dimension_dict[dimension] = self.get(dimension)
deepeshgarg0073d11ac02019-05-19 00:02:01 +0530509 if item and item.get(dimension):
510 dimension_dict[dimension] = item.get(dimension)
deepeshgarg007d83cf652019-05-12 18:34:23 +0530511
512 gl_dict.update(dimension_dict)
Nabin Hait2df4d542013-01-29 11:34:39 +0530513 gl_dict.update(args)
Anand Doshi979326b2015-09-11 16:22:37 +0530514
Nabin Hait895029d2015-08-20 14:55:39 +0530515 if not account_currency:
Anand Doshicd0989e2015-09-28 13:31:17 +0530516 account_currency = get_account_currency(gl_dict.account)
Anand Doshi979326b2015-09-11 16:22:37 +0530517
Rushabh Mehtabc4e2cd2017-10-17 12:30:34 +0530518 if gl_dict.account and self.doctype not in ["Journal Entry",
Deepesh Gargbfc17e42020-12-25 18:34:39 +0530519 "Period Closing Voucher", "Payment Entry", "Purchase Receipt", "Purchase Invoice", "Stock Entry"]:
Anand Doshibe6cfdd2015-09-17 21:07:04 +0530520 self.validate_account_currency(gl_dict.account, account_currency)
Deepesh Garg7c300852020-12-26 20:14:51 +0530521
522 if gl_dict.account and self.doctype not in ["Journal Entry", "Period Closing Voucher", "Payment Entry"]:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800523 set_balance_in_account_currency(gl_dict, account_currency, self.get("conversion_rate"),
524 self.company_currency)
Anand Doshi979326b2015-09-11 16:22:37 +0530525
Nabin Haitc561a492015-08-19 19:22:34 +0530526 return gl_dict
Anand Doshi979326b2015-09-11 16:22:37 +0530527
Anurag Mishrae657fe82018-11-26 15:19:17 +0530528 def validate_qty_is_not_zero(self):
Maricac68a9402019-12-03 12:59:22 +0530529 if self.doctype != "Purchase Receipt":
530 for item in self.items:
531 if not item.qty:
532 frappe.throw(_("Item quantity can not be zero"))
Anurag Mishrae657fe82018-11-26 15:19:17 +0530533
Nabin Hait895029d2015-08-20 14:55:39 +0530534 def validate_account_currency(self, account, account_currency=None):
Nabin Hait6e439a52015-08-28 19:24:22 +0530535 valid_currency = [self.company_currency]
536 if self.get("currency") and self.currency != self.company_currency:
537 valid_currency.append(self.currency)
538
Nabin Hait895029d2015-08-20 14:55:39 +0530539 if account_currency not in valid_currency:
Nabin Hait4ffd7f32015-08-27 12:28:36 +0530540 frappe.throw(_("Account {0} is invalid. Account Currency must be {1}")
Suraj Shettyda6806e2020-04-08 09:32:41 +0530541 .format(account, (' ' + _("or") + ' ').join(valid_currency)))
Anand Doshi979326b2015-09-11 16:22:37 +0530542
Anand Doshi613cb6a2013-02-06 17:33:46 +0530543 def clear_unallocated_advances(self, childtype, parentfield):
Rushabh Mehtaf191f852014-04-02 18:09:34 +0530544 self.set(parentfield, self.get(parentfield, {"allocated_amount": ["not in", [0, None, ""]]}))
545
Anand Doshid2946502014-04-08 20:10:03 +0530546 frappe.db.sql("""delete from `tab%s` where parentfield=%s and parent = %s
Anand Doshi602e8252015-11-16 19:05:46 +0530547 and allocated_amount = 0""" % (childtype, '%s', '%s'), (parentfield, self.name))
Anand Doshid2946502014-04-08 20:10:03 +0530548
Walstan Baptistad6360752021-03-31 12:30:32 +0530549 @frappe.whitelist()
Rushabh Mehta30dc9a12017-11-17 14:31:09 +0530550 def apply_shipping_rule(self):
551 if self.shipping_rule:
552 shipping_rule = frappe.get_doc("Shipping Rule", self.shipping_rule)
553 shipping_rule.apply(self)
554 self.calculate_taxes_and_totals()
555
556 def get_shipping_address(self):
557 '''Returns Address object from shipping address fields if present'''
558
559 # shipping address fields can be `shipping_address_name` or `shipping_address`
560 # try getting value from both
561
562 for fieldname in ('shipping_address_name', 'shipping_address'):
563 shipping_field = self.meta.get_field(fieldname)
564 if shipping_field and shipping_field.fieldtype == 'Link':
565 if self.get(fieldname):
566 return frappe.get_doc('Address', self.get(fieldname))
567
568 return {}
569
Walstan Baptistad6360752021-03-31 12:30:32 +0530570 @frappe.whitelist()
Nabin Hait041a5c22018-08-01 18:07:39 +0530571 def set_advances(self):
572 """Returns list of advances against Account, Party, Reference"""
573
574 res = self.get_advance_entries()
575
576 self.set("advances", [])
577 advance_allocated = 0
578 for d in res:
579 if d.against_order:
580 allocated_amount = flt(d.amount)
581 else:
Deepesh Garg26210162020-08-11 16:06:13 +0530582 if self.get('party_account_currency') == self.company_currency:
583 amount = self.get('base_rounded_total') or self.base_grand_total
584 else:
585 amount = self.get('rounded_total') or self.grand_total
586
Rohit Waghchaure6cc2f522018-11-27 12:07:03 +0530587 allocated_amount = min(amount - advance_allocated, d.amount)
Nabin Hait041a5c22018-08-01 18:07:39 +0530588 advance_allocated += flt(allocated_amount)
Rushabh Mehta708e47a2018-08-08 16:37:31 +0530589
Saqiba20999c2021-07-12 14:33:23 +0530590 advance_row = {
Nabin Hait041a5c22018-08-01 18:07:39 +0530591 "doctype": self.doctype + " Advance",
592 "reference_type": d.reference_type,
593 "reference_name": d.reference_name,
594 "reference_row": d.reference_row,
595 "remarks": d.remarks,
596 "advance_amount": flt(d.amount),
Saqiba20999c2021-07-12 14:33:23 +0530597 "allocated_amount": allocated_amount,
598 "ref_exchange_rate": flt(d.exchange_rate) # exchange_rate of advance entry
599 }
600
601 self.append("advances", advance_row)
Nabin Hait041a5c22018-08-01 18:07:39 +0530602
Nabin Hait28a05282016-06-27 17:41:39 +0530603 def get_advance_entries(self, include_unallocated=True):
604 if self.doctype == "Sales Invoice":
605 party_account = self.debit_to
606 party_type = "Customer"
607 party = self.customer
608 amount_field = "credit_in_account_currency"
609 order_field = "sales_order"
610 order_doctype = "Sales Order"
611 else:
612 party_account = self.credit_to
613 party_type = "Supplier"
614 party = self.supplier
615 amount_field = "debit_in_account_currency"
616 order_field = "purchase_order"
617 order_doctype = "Purchase Order"
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530618
Ankush Menat98917802021-06-11 18:40:22 +0530619 order_list = list(set(d.get(order_field)
620 for d in self.get("items") if d.get(order_field)))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530621
622 journal_entries = get_advance_journal_entries(party_type, party, party_account,
Nabin Hait868766d2019-07-15 18:02:58 +0530623 amount_field, order_doctype, order_list, include_unallocated)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530624
625 payment_entries = get_advance_payment_entries(party_type, party, party_account,
Nabin Hait868766d2019-07-15 18:02:58 +0530626 order_doctype, order_list, include_unallocated)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530627
Nabin Hait28a05282016-06-27 17:41:39 +0530628 res = journal_entries + payment_entries
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530629
Nabin Hait28a05282016-06-27 17:41:39 +0530630 return res
Nabin Hait48f5fa62014-09-18 15:03:54 +0530631
rohitwaghchaurebf4c1142018-01-08 15:20:15 +0530632 def is_inclusive_tax(self):
Nabin Hait868766d2019-07-15 18:02:58 +0530633 is_inclusive = cint(frappe.db.get_single_value("Accounts Settings", "show_inclusive_tax_in_print"))
rohitwaghchaurebf4c1142018-01-08 15:20:15 +0530634
635 if is_inclusive:
636 is_inclusive = 0
637 if self.get("taxes", filters={"included_in_print_rate": 1}):
638 is_inclusive = 1
639
640 return is_inclusive
641
Nabin Hait28a05282016-06-27 17:41:39 +0530642 def validate_advance_entries(self):
Nabin Hait05aefbb2016-06-28 19:42:19 +0530643 order_field = "sales_order" if self.doctype == "Sales Invoice" else "purchase_order"
Ankush Menat98917802021-06-11 18:40:22 +0530644 order_list = list(set(d.get(order_field)
645 for d in self.get("items") if d.get(order_field)))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530646
Nabin Hait05aefbb2016-06-28 19:42:19 +0530647 if not order_list: return
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530648
Nabin Hait28a05282016-06-27 17:41:39 +0530649 advance_entries = self.get_advance_entries(include_unallocated=False)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530650
Nabin Hait28a05282016-06-27 17:41:39 +0530651 if advance_entries:
652 advance_entries_against_si = [d.reference_name for d in self.get("advances")]
653 for d in advance_entries:
654 if not advance_entries_against_si or d.reference_name not in advance_entries_against_si:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800655 frappe.msgprint(_(
656 "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 +0530657 .format(d.reference_name, d.against_order))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530658
Saqiba20999c2021-07-12 14:33:23 +0530659 def set_advance_gain_or_loss(self):
660 if not self.get("advances"):
661 return
662
663 for d in self.get("advances"):
664 advance_exchange_rate = d.ref_exchange_rate
665 if (d.allocated_amount and self.conversion_rate != 1
666 and self.conversion_rate != advance_exchange_rate):
667
668 base_allocated_amount_in_ref_rate = advance_exchange_rate * d.allocated_amount
669 base_allocated_amount_in_inv_rate = self.conversion_rate * d.allocated_amount
670 difference = base_allocated_amount_in_ref_rate - base_allocated_amount_in_inv_rate
671
672 d.exchange_gain_loss = difference
673
674 def make_exchange_gain_loss_gl_entries(self, gl_entries):
675 if self.get('doctype') in ['Purchase Invoice', 'Sales Invoice']:
676 for d in self.get("advances"):
677 if d.exchange_gain_loss:
Saqibd4ae1fe2021-07-30 11:21:49 +0530678 is_purchase_invoice = self.get('doctype') == 'Purchase Invoice'
679 party = self.supplier if is_purchase_invoice else self.customer
680 party_account = self.credit_to if is_purchase_invoice else self.debit_to
681 party_type = "Supplier" if is_purchase_invoice else "Customer"
Saqiba20999c2021-07-12 14:33:23 +0530682
683 gain_loss_account = frappe.db.get_value('Company', self.company, 'exchange_gain_loss_account')
Saqibd4ae1fe2021-07-30 11:21:49 +0530684 if not gain_loss_account:
685 frappe.throw(_("Please set Default Exchange Gain/Loss Account in Company {}")
686 .format(self.get('company')))
Saqiba20999c2021-07-12 14:33:23 +0530687 account_currency = get_account_currency(gain_loss_account)
688 if account_currency != self.company_currency:
Saqibd4ae1fe2021-07-30 11:21:49 +0530689 frappe.throw(_("Currency for {0} must be {1}").format(gain_loss_account, self.company_currency))
Saqiba20999c2021-07-12 14:33:23 +0530690
691 # for purchase
692 dr_or_cr = 'debit' if d.exchange_gain_loss > 0 else 'credit'
Saqibd4ae1fe2021-07-30 11:21:49 +0530693 if not is_purchase_invoice:
694 # just reverse for sales?
695 dr_or_cr = 'debit' if dr_or_cr == 'credit' else 'credit'
Saqiba20999c2021-07-12 14:33:23 +0530696
697 gl_entries.append(
698 self.get_gl_dict({
699 "account": gain_loss_account,
700 "account_currency": account_currency,
701 "against": party,
702 dr_or_cr + "_in_account_currency": abs(d.exchange_gain_loss),
703 dr_or_cr: abs(d.exchange_gain_loss),
704 "cost_center": self.cost_center,
705 "project": self.project
706 }, item=d)
707 )
708
709 dr_or_cr = 'debit' if dr_or_cr == 'credit' else 'credit'
710
711 gl_entries.append(
712 self.get_gl_dict({
713 "account": party_account,
714 "party_type": party_type,
715 "party": party,
716 "against": gain_loss_account,
717 dr_or_cr + "_in_account_currency": flt(abs(d.exchange_gain_loss) / self.conversion_rate),
718 dr_or_cr: abs(d.exchange_gain_loss),
719 "cost_center": self.cost_center,
720 "project": self.project
721 }, self.party_account_currency, item=self)
722 )
723
Nabin Hait28a05282016-06-27 17:41:39 +0530724 def update_against_document_in_jv(self):
725 """
726 Links invoice and advance voucher:
727 1. cancel advance voucher
728 2. split into multiple rows if partially adjusted, assign against voucher
729 3. submit advance voucher
730 """
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530731
Nabin Hait28a05282016-06-27 17:41:39 +0530732 if self.doctype == "Sales Invoice":
Nabin Haitff2f3ef2016-07-04 11:41:14 +0530733 party_type = "Customer"
Nabin Hait28a05282016-06-27 17:41:39 +0530734 party = self.customer
735 party_account = self.debit_to
736 dr_or_cr = "credit_in_account_currency"
737 else:
Nabin Haitff2f3ef2016-07-04 11:41:14 +0530738 party_type = "Supplier"
Nabin Hait28a05282016-06-27 17:41:39 +0530739 party = self.supplier
740 party_account = self.credit_to
741 dr_or_cr = "debit_in_account_currency"
Nabin Hait48f5fa62014-09-18 15:03:54 +0530742
Nabin Hait28a05282016-06-27 17:41:39 +0530743 lst = []
744 for d in self.get('advances'):
745 if flt(d.allocated_amount) > 0:
746 args = frappe._dict({
747 'voucher_type': d.reference_type,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800748 'voucher_no': d.reference_name,
749 'voucher_detail_no': d.reference_row,
750 'against_voucher_type': self.doctype,
751 'against_voucher': self.name,
752 'account': party_account,
Nabin Haitff2f3ef2016-07-04 11:41:14 +0530753 'party_type': party_type,
Nabin Hait28a05282016-06-27 17:41:39 +0530754 'party': party,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800755 'is_advance': 'Yes',
756 'dr_or_cr': dr_or_cr,
757 'unadjusted_amount': flt(d.advance_amount),
758 'allocated_amount': flt(d.allocated_amount),
Deepesh Gargf54d5962021-03-31 14:06:02 +0530759 'precision': d.precision('advance_amount'),
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530760 'exchange_rate': (self.conversion_rate
Nabin Hait868766d2019-07-15 18:02:58 +0530761 if self.party_account_currency != self.company_currency else 1),
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530762 'grand_total': (self.base_grand_total
Nabin Hait868766d2019-07-15 18:02:58 +0530763 if self.party_account_currency == self.company_currency else self.grand_total),
Saqiba20999c2021-07-12 14:33:23 +0530764 'outstanding_amount': self.outstanding_amount,
765 'difference_account': frappe.db.get_value('Company', self.company, 'exchange_gain_loss_account'),
766 'exchange_gain_loss': flt(d.get('exchange_gain_loss'))
Nabin Hait28a05282016-06-27 17:41:39 +0530767 })
768 lst.append(args)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530769
Nabin Hait28a05282016-06-27 17:41:39 +0530770 if lst:
771 from erpnext.accounts.utils import reconcile_against_document
772 reconcile_against_document(lst)
Anand Doshid2946502014-04-08 20:10:03 +0530773
Rohit Waghchaure5fa9a7a2019-04-01 00:40:38 +0530774 def on_cancel(self):
775 from erpnext.accounts.utils import unlink_ref_doc_from_payment_entries
776
777 if self.doctype in ["Sales Invoice", "Purchase Invoice"]:
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530778 self.update_allocated_advance_taxes_on_cancel()
Rohit Waghchaure5fa9a7a2019-04-01 00:40:38 +0530779 if frappe.db.get_single_value('Accounts Settings', 'unlink_payment_on_cancellation_of_invoice'):
780 unlink_ref_doc_from_payment_entries(self)
781
782 elif self.doctype in ["Sales Order", "Purchase Order"]:
Rohit Waghchaure9835c892019-04-01 01:02:06 +0530783 if frappe.db.get_single_value('Accounts Settings', 'unlink_advance_payment_on_cancelation_of_order'):
Rohit Waghchaure5fa9a7a2019-04-01 00:40:38 +0530784 unlink_ref_doc_from_payment_entries(self)
785
Deepesh Gargd18dde72020-11-29 21:40:04 +0530786 def get_tax_map(self):
787 tax_map = {}
788 for tax in self.get('taxes'):
789 tax_map.setdefault(tax.account_head, 0.0)
790 tax_map[tax.account_head] += tax.tax_amount
791
792 return tax_map
793
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530794 def update_allocated_advance_taxes_on_cancel(self):
Deepesh Gargd18dde72020-11-29 21:40:04 +0530795 if self.get('advances'):
796 tax_accounts = [d.account_head for d in self.get('taxes')]
797 allocated_tax_map = frappe._dict(frappe.get_all('GL Entry', fields=['account', 'sum(credit - debit)'],
798 filters={'voucher_no': self.name, 'account': ('in', tax_accounts)},
799 group_by='account', as_list=1))
800
801 tax_map = self.get_tax_map()
802
803 for pe in self.get('advances'):
Deepesh Garga23aaf42021-05-17 20:58:50 +0530804 if pe.reference_type == 'Payment Entry':
805 pe = frappe.get_doc('Payment Entry', pe.reference_name)
806 for tax in pe.get('taxes'):
807 allocated_amount = tax_map.get(tax.account_head) - allocated_tax_map.get(tax.account_head)
808 if allocated_amount > tax.tax_amount:
809 allocated_amount = tax.tax_amount
Deepesh Gargd18dde72020-11-29 21:40:04 +0530810
Deepesh Garga23aaf42021-05-17 20:58:50 +0530811 if allocated_amount:
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530812 frappe.db.set_value('Advance Taxes and Charges', tax.name, 'allocated_amount',
813 tax.allocated_amount - allocated_amount)
Deepesh Garga23aaf42021-05-17 20:58:50 +0530814 tax_map[tax.account_head] -= allocated_amount
815 allocated_tax_map[tax.account_head] -= allocated_amount
Deepesh Gargd18dde72020-11-29 21:40:04 +0530816
Deepesh Garg92f7a5a2021-07-21 15:25:40 +0530817 def get_amount_and_base_amount(self, item, enable_discount_accounting):
818 amount = item.net_amount
819 base_amount = item.base_net_amount
820
821 if enable_discount_accounting and self.get('discount_amount') and self.get('additional_discount_account'):
822 amount = item.amount
823 base_amount = item.base_amount
824
825 return amount, base_amount
826
827 def get_tax_amounts(self, tax, enable_discount_accounting):
828 amount = tax.tax_amount_after_discount_amount
829 base_amount = tax.base_tax_amount_after_discount_amount
830
831 if enable_discount_accounting and self.get('discount_amount') and self.get('additional_discount_account') \
832 and self.get('apply_discount_on') == 'Grand Total':
833 amount = tax.tax_amount
834 base_amount = tax.base_tax_amount
835
836 return amount, base_amount
837
GangaManoj8f7b0a12021-07-13 03:01:02 +0530838 def make_discount_gl_entries(self, gl_entries):
839 enable_discount_accounting = cint(frappe.db.get_single_value('Accounts Settings', 'enable_discount_accounting'))
840
841 if enable_discount_accounting:
GangaManoj4105e272021-07-20 03:46:02 +0530842 if self.doctype == "Purchase Invoice":
843 dr_or_cr = "credit"
844 rev_dr_cr = "debit"
845 supplier_or_customer = self.supplier
846
847 else:
848 dr_or_cr = "debit"
849 rev_dr_cr = "credit"
850 supplier_or_customer = self.customer
851
GangaManoj8f7b0a12021-07-13 03:01:02 +0530852 for item in self.get("items"):
853 if item.get('discount_amount') and item.get('discount_account'):
Deepesh Gargad7bb312021-07-28 11:38:44 +0530854 discount_amount = item.discount_amount * item.qty
GangaManoj8f7b0a12021-07-13 03:01:02 +0530855 if self.doctype == "Purchase Invoice":
GangaManoj8f7b0a12021-07-13 03:01:02 +0530856 income_or_expense_account = (item.expense_account
857 if (not item.enable_deferred_expense or self.is_return)
858 else item.deferred_expense_account)
859 else:
GangaManoj8f7b0a12021-07-13 03:01:02 +0530860 income_or_expense_account = (item.income_account
861 if (not item.enable_deferred_revenue or self.is_return)
862 else item.deferred_revenue_account)
863
864 account_currency = get_account_currency(item.discount_account)
865 gl_entries.append(
866 self.get_gl_dict({
867 "account": item.discount_account,
868 "against": supplier_or_customer,
Deepesh Gargad7bb312021-07-28 11:38:44 +0530869 dr_or_cr: flt(discount_amount, item.precision('discount_amount')),
870 dr_or_cr + "_in_account_currency": flt(discount_amount * self.get('conversion_rate'),
871 item.precision('discount_amount')),
Ganga Manoj980798c2021-07-19 23:43:36 +0530872 "cost_center": item.cost_center,
Ganga Manoj63b7ecd2021-07-19 23:44:21 +0530873 "project": item.project
Ganga Manoj0ea29342021-07-19 23:44:55 +0530874 }, account_currency, item=item)
GangaManoj8f7b0a12021-07-13 03:01:02 +0530875 )
876
877 account_currency = get_account_currency(income_or_expense_account)
878 gl_entries.append(
879 self.get_gl_dict({
880 "account": income_or_expense_account,
881 "against": supplier_or_customer,
Deepesh Gargad7bb312021-07-28 11:38:44 +0530882 rev_dr_cr: flt(discount_amount, item.precision('discount_amount')),
883 rev_dr_cr + "_in_account_currency": flt(discount_amount * self.get('conversion_rate'),
884 item.precision('discount_amount')),
GangaManoj8f7b0a12021-07-13 03:01:02 +0530885 "cost_center": item.cost_center,
886 "project": item.project or self.project
887 }, account_currency, item=item)
888 )
GangaManoj857501c2021-07-15 22:03:46 +0530889
GangaManoj4105e272021-07-20 03:46:02 +0530890 if self.get('discount_amount') and self.get('additional_discount_account'):
GangaManoj857501c2021-07-15 22:03:46 +0530891 gl_entries.append(
892 self.get_gl_dict({
893 "account": self.additional_discount_account,
GangaManoj4105e272021-07-20 03:46:02 +0530894 "against": supplier_or_customer,
895 dr_or_cr: self.discount_amount,
896 "cost_center": self.cost_center
897 }, item=self)
898 )
899
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530900 def allocate_advance_taxes(self, gl_entries):
901 tax_map = self.get_tax_map()
902 for pe in self.get("advances"):
Deepesh Garg911818a2021-06-09 22:55:10 +0530903 if pe.reference_type == "Payment Entry" and \
904 frappe.db.get_value('Payment Entry', pe.reference_name, 'advance_tax_account'):
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530905 pe = frappe.get_doc("Payment Entry", pe.reference_name)
906 for tax in pe.get("taxes"):
907 account_currency = get_account_currency(tax.account_head)
908
909 if self.doctype == "Purchase Invoice":
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530910 dr_or_cr = "debit" if tax.add_deduct_tax == "Add" else "credit"
911 rev_dr_cr = "credit" if tax.add_deduct_tax == "Add" else "debit"
Deepesh Garg4478c542021-07-13 11:22:55 +0530912 else:
913 dr_or_cr = "credit" if tax.add_deduct_tax == "Add" else "debit"
914 rev_dr_cr = "debit" if tax.add_deduct_tax == "Add" else "credit"
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530915
916 party = self.supplier if self.doctype == "Purchase Invoice" else self.customer
917 unallocated_amount = tax.tax_amount - tax.allocated_amount
918 if tax_map.get(tax.account_head):
919 amount = tax_map.get(tax.account_head)
920 if amount < unallocated_amount:
921 unallocated_amount = amount
922
923 gl_entries.append(
924 self.get_gl_dict({
925 "account": tax.account_head,
926 "against": party,
927 dr_or_cr: unallocated_amount,
928 dr_or_cr + "_in_account_currency": unallocated_amount
929 if account_currency==self.company_currency
930 else unallocated_amount,
931 "cost_center": tax.cost_center
932 }, account_currency, item=tax))
933
934 gl_entries.append(
935 self.get_gl_dict({
936 "account": pe.advance_tax_account,
937 "against": party,
938 rev_dr_cr: unallocated_amount,
939 rev_dr_cr + "_in_account_currency": unallocated_amount
940 if account_currency==self.company_currency
941 else unallocated_amount,
942 "cost_center": tax.cost_center
943 }, account_currency, item=tax))
944
945 frappe.db.set_value("Advance Taxes and Charges", tax.name, "allocated_amount",
946 tax.allocated_amount + unallocated_amount)
947
948 tax_map[tax.account_head] -= unallocated_amount
949
Nabin Hait19d945a2013-07-29 18:35:39 +0530950 def validate_multiple_billing(self, ref_dt, item_ref_dn, based_on, parentfield):
Nabin Hait868766d2019-07-15 18:02:58 +0530951 from erpnext.controllers.status_updater import get_allowance_for
952 item_allowance = {}
953 global_qty_allowance, global_amount_allowance = None, None
Anand Doshid2946502014-04-08 20:10:03 +0530954
Nabin Hait4b8185d2014-12-25 18:19:39 +0530955 for item in self.get("items"):
Anand Doshif78d1ae2014-03-28 13:55:00 +0530956 if item.get(item_ref_dn):
Anand Doshid2946502014-04-08 20:10:03 +0530957 ref_amt = flt(frappe.db.get_value(ref_dt + " Item",
Nabin Hait868766d2019-07-15 18:02:58 +0530958 item.get(item_ref_dn), based_on), self.precision(based_on, item))
Nabin Haitdc15b4f2014-01-20 16:48:49 +0530959 if not ref_amt:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800960 frappe.msgprint(
Nabin Hait868766d2019-07-15 18:02:58 +0530961 _("Warning: System will not check overbilling since amount for Item {0} in {1} is zero")
962 .format(item.item_code, ref_dt))
Nabin Haitdc15b4f2014-01-20 16:48:49 +0530963 else:
Nabin Hait868766d2019-07-15 18:02:58 +0530964 already_billed = frappe.db.sql("""
965 select sum(%s)
966 from `tab%s`
967 where %s=%s and docstatus=1 and parent != %s
968 """ % (based_on, self.doctype + " Item", item_ref_dn, '%s', '%s'),
969 (item.get(item_ref_dn), self.name))[0][0]
Anand Doshid2946502014-04-08 20:10:03 +0530970
971 total_billed_amt = flt(flt(already_billed) + flt(item.get(based_on)),
Nabin Hait868766d2019-07-15 18:02:58 +0530972 self.precision(based_on, item))
Anand Doshid2946502014-04-08 20:10:03 +0530973
Nabin Hait868766d2019-07-15 18:02:58 +0530974 allowance, item_allowance, global_qty_allowance, global_amount_allowance = \
975 get_allowance_for(item.item_code, item_allowance, global_qty_allowance, global_amount_allowance, "amount")
Anand Doshid2946502014-04-08 20:10:03 +0530976
Nabin Hait868766d2019-07-15 18:02:58 +0530977 max_allowed_amt = flt(ref_amt * (100 + allowance) / 100)
Anand Doshid2946502014-04-08 20:10:03 +0530978
rohitwaghchaure285344e2019-10-11 11:02:11 +0530979 if total_billed_amt < 0 and max_allowed_amt < 0:
980 # while making debit note against purchase return entry(purchase receipt) getting overbill error
981 total_billed_amt = abs(total_billed_amt)
982 max_allowed_amt = abs(max_allowed_amt)
983
Deepesh Gargcb718fc2021-04-19 13:25:15 +0530984 role_allowed_to_over_bill = frappe.db.get_single_value('Accounts Settings', 'role_allowed_to_over_bill')
985
986 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 +0530987 if self.doctype != "Purchase Invoice":
988 self.throw_overbill_exception(item, max_allowed_amt)
989 elif not cint(frappe.db.get_single_value("Buying Settings", "bill_for_rejected_quantity_in_purchase_invoice")):
990 self.throw_overbill_exception(item, max_allowed_amt)
991
992 def throw_overbill_exception(self, item, max_allowed_amt):
993 frappe.throw(_("Cannot overbill for Item {0} in row {1} more than {2}. To allow over-billing, please set allowance in Accounts Settings")
994 .format(item.item_code, item.idx, max_allowed_amt))
Anand Doshid2946502014-04-08 20:10:03 +0530995
Rohit Waghchaure2a14f252021-07-30 12:36:35 +0530996 def get_company_default(self, fieldname, ignore_validation=False):
Rushabh Mehta1f847992013-12-12 19:12:19 +0530997 from erpnext.accounts.utils import get_company_default
Rohit Waghchaure2a14f252021-07-30 12:36:35 +0530998 return get_company_default(self.company, fieldname, ignore_validation=ignore_validation)
Anand Doshid2946502014-04-08 20:10:03 +0530999
Nabin Haita36adbd2013-08-02 14:50:12 +05301000 def get_stock_items(self):
1001 stock_items = []
Nabin Haitdd38a262014-12-26 13:15:21 +05301002 item_codes = list(set(item.item_code for item in self.get("items")))
Nabin Haita36adbd2013-08-02 14:50:12 +05301003 if item_codes:
Nabin Hait868766d2019-07-15 18:02:58 +05301004 stock_items = [r[0] for r in frappe.db.sql("""
1005 select name from `tabItem`
1006 where name in (%s) and is_stock_item=1
1007 """ % (", ".join((["%s"] * len(item_codes))),), item_codes)]
Anand Doshid2946502014-04-08 20:10:03 +05301008
Nabin Haita36adbd2013-08-02 14:50:12 +05301009 return stock_items
Anand Doshid2946502014-04-08 20:10:03 +05301010
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301011 def set_total_advance_paid(self):
1012 if self.doctype == "Sales Order":
Nabin Hait6e439a52015-08-28 19:24:22 +05301013 dr_or_cr = "credit_in_account_currency"
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301014 rev_dr_or_cr = "debit_in_account_currency"
Nabin Haitb2206d12016-01-27 15:43:12 +05301015 party = self.customer
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301016 else:
Nabin Hait6e439a52015-08-28 19:24:22 +05301017 dr_or_cr = "debit_in_account_currency"
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301018 rev_dr_or_cr = "credit_in_account_currency"
Nabin Haitb2206d12016-01-27 15:43:12 +05301019 party = self.supplier
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301020
Nabin Haitb2206d12016-01-27 15:43:12 +05301021 advance = frappe.db.sql("""
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301022 select
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301023 account_currency, sum({dr_or_cr}) - sum({rev_dr_cr}) as amount
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301024 from
Nabin Hait12e2a512016-06-26 01:37:21 +05301025 `tabGL Entry`
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301026 where
Nabin Hait12e2a512016-06-26 01:37:21 +05301027 against_voucher_type = %s and against_voucher = %s and party=%s
1028 and docstatus = 1
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301029 """.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 +05301030
Nabin Haitb2206d12016-01-27 15:43:12 +05301031 if advance:
Anand Doshi7c0a58a2016-01-29 12:16:24 +05301032 advance = advance[0]
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301033
Anand Doshi7c0a58a2016-01-29 12:16:24 +05301034 advance_paid = flt(advance.amount, self.precision("advance_paid"))
1035 formatted_advance_paid = fmt_money(advance_paid, precision=self.precision("advance_paid"),
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001036 currency=advance.account_currency)
Anand Doshi7c0a58a2016-01-29 12:16:24 +05301037
1038 frappe.db.set_value(self.doctype, self.name, "party_account_currency",
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001039 advance.account_currency)
Anand Doshi7c0a58a2016-01-29 12:16:24 +05301040
1041 if advance.account_currency == self.currency:
finbyz5efc7972019-01-05 11:12:11 +05301042 order_total = self.get("rounded_total") or self.grand_total
1043 precision = "rounded_total" if self.get("rounded_total") else "grand_total"
Nabin Haitb2206d12016-01-27 15:43:12 +05301044 else:
finbyz5efc7972019-01-05 11:12:11 +05301045 order_total = self.get("base_rounded_total") or self.base_grand_total
1046 precision = "base_rounded_total" if self.get("base_rounded_total") else "base_grand_total"
Sagar Voraf733a392019-01-07 14:24:01 +05301047
finbyz5efc7972019-01-05 11:12:11 +05301048 formatted_order_total = fmt_money(order_total, precision=self.precision(precision),
1049 currency=advance.account_currency)
Anand Doshi7c0a58a2016-01-29 12:16:24 +05301050
Nabin Hait9db1b222016-06-30 12:37:53 +05301051 if self.currency == self.company_currency and advance_paid > order_total:
Nabin Haitb2206d12016-01-27 15:43:12 +05301052 frappe.throw(_("Total advance ({0}) against Order {1} cannot be greater than the Grand Total ({2})")
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001053 .format(formatted_advance_paid, self.name, formatted_order_total))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301054
Nabin Hait13093b42016-06-29 18:04:37 +05301055 frappe.db.set_value(self.doctype, self.name, "advance_paid", advance_paid)
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301056
ankitjavalkarworke60822b2014-08-26 14:29:06 +05301057 @property
1058 def company_abbr(self):
Nabin Hait6a5695f2018-08-09 11:30:21 +05301059 if not hasattr(self, "_abbr"):
1060 self._abbr = frappe.db.get_value('Company', self.company, "abbr")
ankitjavalkarworke60822b2014-08-26 14:29:06 +05301061
1062 return self._abbr
1063
marination4be5b5c2020-10-08 19:08:27 +05301064 def raise_missing_debit_credit_account_error(self, party_type, party):
marination53b1a9a2020-11-03 15:45:25 +05301065 """Raise an error if debit to/credit to account does not exist."""
marination4be5b5c2020-10-08 19:08:27 +05301066 db_or_cr = frappe.bold("Debit To") if self.doctype == "Sales Invoice" else frappe.bold("Credit To")
1067 rec_or_pay = "Receivable" if self.doctype == "Sales Invoice" else "Payable"
1068
1069 link_to_party = frappe.utils.get_link_to_form(party_type, party)
1070 link_to_company = frappe.utils.get_link_to_form("Company", self.company)
1071
1072 message = _("{0} Account not found against Customer {1}.").format(db_or_cr, frappe.bold(party) or '')
1073 message += "<br>" + _("Please set one of the following:") + "<br>"
1074 message += "<br><ul><li>" + _("'Account' in the Accounting section of Customer {0}").format(link_to_party) + "</li>"
1075 message += "<li>" + _("'Default {0} Account' in Company {1}").format(rec_or_pay, link_to_company) + "</li></ul>"
1076
marination53b1a9a2020-11-03 15:45:25 +05301077 frappe.throw(message, title=_("Account Missing"), exc=AccountMissingError)
marination4be5b5c2020-10-08 19:08:27 +05301078
Neil Trini Lasrado3fbbb712015-07-17 12:10:12 +05301079 def validate_party(self):
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301080 party_type, party = self.get_party()
shreyaseba9ca42016-01-26 14:56:52 +05301081 validate_party_frozen_disabled(party_type, party)
Anand Doshi979326b2015-09-11 16:22:37 +05301082
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301083 def get_party(self):
Neil Trini Lasrado79bf2332015-07-20 13:03:48 +05301084 party_type = None
shreyas29b565f2016-01-25 17:30:49 +05301085 if self.doctype in ("Opportunity", "Quotation", "Sales Order", "Delivery Note", "Sales Invoice"):
shreyaseba9ca42016-01-26 14:56:52 +05301086 party_type = 'Customer'
shreyas29b565f2016-01-25 17:30:49 +05301087
1088 elif self.doctype in ("Supplier Quotation", "Purchase Order", "Purchase Receipt", "Purchase Invoice"):
shreyaseba9ca42016-01-26 14:56:52 +05301089 party_type = 'Supplier'
shreyas29b565f2016-01-25 17:30:49 +05301090
1091 elif self.meta.get_field("customer"):
1092 party_type = "Customer"
Neil Trini Lasrado3fbbb712015-07-17 12:10:12 +05301093
Neil Trini Lasrado79bf2332015-07-20 13:03:48 +05301094 elif self.meta.get_field("supplier"):
shreyas29b565f2016-01-25 17:30:49 +05301095 party_type = "Supplier"
Anand Doshi979326b2015-09-11 16:22:37 +05301096
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301097 party = self.get(party_type.lower()) if party_type else None
Anand Doshi979326b2015-09-11 16:22:37 +05301098
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301099 return party_type, party
Anand Doshi979326b2015-09-11 16:22:37 +05301100
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301101 def validate_currency(self):
Nabin Hait6e439a52015-08-28 19:24:22 +05301102 if self.get("currency"):
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301103 party_type, party = self.get_party()
Nabin Hait6e439a52015-08-28 19:24:22 +05301104 if party_type and party:
Anand Doshib20baf82015-09-25 16:17:50 +05301105 party_account_currency = get_party_account_currency(party_type, party, self.company)
Anand Doshi979326b2015-09-11 16:22:37 +05301106
Anand Doshi7afaeb02015-10-01 18:55:25 +05301107 if (party_account_currency
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001108 and party_account_currency != self.company_currency
1109 and self.currency != party_account_currency):
Nabin Hait98096772015-09-03 10:28:08 +05301110 frappe.throw(_("Accounting Entry for {0}: {1} can only be made in currency: {2}")
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001111 .format(party_type, party, party_account_currency), InvalidCurrency)
Anand Doshi979326b2015-09-11 16:22:37 +05301112
shreyas29b565f2016-01-25 17:30:49 +05301113 # Note: not validating with gle account because we don't have the account
1114 # at quotation / sales order level and we shouldn't stop someone
1115 # from creating a sales invoice if sales order is already created
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +05301116
Deepesh Garg80c85dd2021-08-12 15:39:07 +05301117 def validate_party_account_currency(self):
1118 if self.doctype not in ('Sales Invoice', 'Purchase Invoice'):
1119 return
1120
1121 party_type, party = self.get_party()
1122 party_gle_currency = get_party_gle_currency(party_type, party, self.company)
1123 party_account = self.get('debit_to') if self.doctype == 'Sales Invoice' else self.get('credit_to')
1124 party_account_currency = get_account_currency(party_account)
1125
1126 if not party_gle_currency and (party_account_currency != self.currency):
1127 frappe.throw(_("Party Account {0} currency and document currency should be same").format(frappe.bold(party_account)))
1128
1129
Nabin Hait297d74a2016-11-23 15:58:51 +05301130 def delink_advance_entries(self, linked_doc_name):
1131 total_allocated_amount = 0
1132 for adv in self.advances:
1133 consider_for_total_advance = True
1134 if adv.reference_name == linked_doc_name:
1135 frappe.db.sql("""delete from `tab{0} Advance`
1136 where name = %s""".format(self.doctype), adv.name)
1137 consider_for_total_advance = False
1138
1139 if consider_for_total_advance:
1140 total_allocated_amount += flt(adv.allocated_amount, adv.precision("allocated_amount"))
1141
Rushabh Mehta66958302017-01-16 16:57:53 +05301142 frappe.db.set_value(self.doctype, self.name, "total_advance",
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001143 total_allocated_amount, update_modified=False)
Rohit Waghchaure6087fe12016-04-09 14:31:09 +05301144
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301145 def group_similar_items(self):
1146 group_item_qty = {}
1147 group_item_amount = {}
Shreya Shah785f1aa2018-10-11 10:14:25 +05301148 # to update serial number in print
1149 count = 0
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301150
1151 for item in self.items:
1152 group_item_qty[item.item_code] = group_item_qty.get(item.item_code, 0) + item.qty
1153 group_item_amount[item.item_code] = group_item_amount.get(item.item_code, 0) + item.amount
1154
1155 duplicate_list = []
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301156 for item in self.items:
1157 if item.item_code in group_item_qty:
Shreya Shah785f1aa2018-10-11 10:14:25 +05301158 count += 1
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301159 item.qty = group_item_qty[item.item_code]
1160 item.amount = group_item_amount[item.item_code]
deepeshgarg007e8d21cd2019-06-24 17:46:44 +05301161
1162 if item.qty:
1163 item.rate = flt(flt(item.amount) / flt(item.qty), item.precision("rate"))
1164 else:
1165 item.rate = 0
1166
Shreya Shah785f1aa2018-10-11 10:14:25 +05301167 item.idx = count
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301168 del group_item_qty[item.item_code]
1169 else:
1170 duplicate_list.append(item)
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301171 for item in duplicate_list:
1172 self.remove(item)
1173
tunde32aa7c12017-09-07 06:52:15 +01001174 def set_payment_schedule(self):
Manas Solankia7f55892018-04-02 10:32:00 +05301175 if self.doctype == 'Sales Invoice' and self.is_pos:
1176 self.payment_terms_template = ''
1177 return
rohitwaghchauredb9fa782018-03-01 10:32:29 +05301178
Deepesh Garg26210162020-08-11 16:06:13 +05301179 party_account_currency = self.get('party_account_currency')
1180 if not party_account_currency:
1181 party_type, party = self.get_party()
1182
1183 if party_type and party:
1184 party_account_currency = get_party_account_currency(party_type, party, self.company)
1185
rohitwaghchaureda941af2018-01-17 16:23:04 +05301186 posting_date = self.get("bill_date") or self.get("posting_date") or self.get("transaction_date")
tundedf3a1752017-09-11 11:02:57 +01001187 date = self.get("due_date")
1188 due_date = date or posting_date
Deepesh Garg26210162020-08-11 16:06:13 +05301189
Saqib Ansarid552fe62021-04-23 14:46:52 +05301190 base_grand_total = self.get("base_rounded_total") or self.base_grand_total
1191 grand_total = self.get("rounded_total") or self.grand_total
Deepesh Garg26210162020-08-11 16:06:13 +05301192
Nabin Hait2f9f4f92017-12-20 12:24:59 +05301193 if self.doctype in ("Sales Invoice", "Purchase Invoice"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301194 base_grand_total = base_grand_total - flt(self.base_write_off_amount)
Nabin Hait2f9f4f92017-12-20 12:24:59 +05301195 grand_total = grand_total - flt(self.write_off_amount)
Deepesh Gargbcf56e62021-08-06 23:53:16 +05301196 po_or_so, doctype, fieldname = self.get_order_details()
1197 automatically_fetch_payment_terms = cint(frappe.db.get_single_value('Accounts Settings', 'automatically_fetch_payment_terms'))
tunde96b8f222017-09-08 15:35:59 +01001198
Rohit Waghchaure4a267b92019-05-09 19:50:00 +05301199 if self.get("total_advance"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301200 if party_account_currency == self.company_currency:
1201 base_grand_total -= self.get("total_advance")
1202 grand_total = flt(base_grand_total / self.get("conversion_rate"), self.precision("grand_total"))
1203 else:
1204 grand_total -= self.get("total_advance")
1205 base_grand_total = flt(grand_total * self.get("conversion_rate"), self.precision("base_grand_total"))
Rohit Waghchaure4a267b92019-05-09 19:50:00 +05301206
Nabin Hait0551f7b2017-11-21 19:58:16 +05301207 if not self.get("payment_schedule"):
Deepesh Gargbff3b092021-08-07 00:12:57 +05301208 if self.doctype in ["Sales Invoice", "Purchase Invoice"] and automatically_fetch_payment_terms \
1209 and self.linked_order_has_payment_terms(po_or_so, fieldname, doctype):
Deepesh Gargbcf56e62021-08-06 23:53:16 +05301210 self.fetch_payment_terms_from_order(po_or_so, doctype)
1211 if self.get('payment_terms_template'):
1212 self.ignore_default_payment_terms_template = 1
1213 elif self.get("payment_terms_template"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301214 data = get_payment_terms(self.payment_terms_template, posting_date, grand_total, base_grand_total)
Nabin Hait0551f7b2017-11-21 19:58:16 +05301215 for item in data:
1216 self.append("payment_schedule", item)
GangaManoj4323f4b2021-07-22 05:57:42 +05301217 elif self.doctype not in ["Purchase Receipt"]:
Saqib Ansarida5b55c2021-04-28 14:55:33 +05301218 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 +05301219 self.append("payment_schedule", data)
Deepesh Gargbcf56e62021-08-06 23:53:16 +05301220
1221 for d in self.get("payment_schedule"):
1222 if d.invoice_portion:
1223 d.payment_amount = flt(grand_total * flt(d.invoice_portion / 100), d.precision('payment_amount'))
1224 d.base_payment_amount = flt(base_grand_total * flt(d.invoice_portion / 100), d.precision('base_payment_amount'))
1225 d.outstanding = d.payment_amount
1226 elif not d.invoice_portion:
1227 d.base_payment_amount = flt(base_grand_total * self.get("conversion_rate"), d.precision('base_payment_amount'))
Subin Tomfac88a32021-07-23 21:23:48 +05301228
tunde43870aa2017-08-18 11:59:30 +01001229
GangaManoj4323f4b2021-07-22 05:57:42 +05301230 def get_order_details(self):
1231 if self.doctype == "Sales Invoice":
1232 po_or_so = self.get('items')[0].get('sales_order')
1233 po_or_so_doctype = "Sales Order"
1234 po_or_so_doctype_name = "sales_order"
1235
1236 else:
1237 po_or_so = self.get('items')[0].get('purchase_order')
1238 po_or_so_doctype = "Purchase Order"
1239 po_or_so_doctype_name = "purchase_order"
1240
1241 return po_or_so, po_or_so_doctype, po_or_so_doctype_name
1242
GangaManojc7c90242021-07-29 19:18:35 +05301243 def linked_order_has_payment_terms(self, po_or_so, fieldname, doctype):
GangaManoj4323f4b2021-07-22 05:57:42 +05301244 if po_or_so and self.all_items_have_same_po_or_so(po_or_so, fieldname):
GangaManojc7c90242021-07-29 19:18:35 +05301245 if self.linked_order_has_payment_terms_template(po_or_so, doctype):
GangaManoj4323f4b2021-07-22 05:57:42 +05301246 return True
1247 elif self.linked_order_has_payment_schedule(po_or_so):
1248 return True
1249
1250 return False
1251
1252 def all_items_have_same_po_or_so(self, po_or_so, fieldname):
1253 for item in self.get('items'):
1254 if item.get(fieldname) != po_or_so:
1255 return False
1256
1257 return True
1258
GangaManojc7c90242021-07-29 19:18:35 +05301259 def linked_order_has_payment_terms_template(self, po_or_so, doctype):
1260 return frappe.get_value(doctype, po_or_so, 'payment_terms_template')
GangaManoj4323f4b2021-07-22 05:57:42 +05301261
1262 def linked_order_has_payment_schedule(self, po_or_so):
1263 return frappe.get_all('Payment Schedule', filters={'parent': po_or_so})
1264
1265 def fetch_payment_terms_from_order(self, po_or_so, po_or_so_doctype):
1266 """
1267 Fetch Payment Terms from Purchase/Sales Order on creating a new Purchase/Sales Invoice.
1268 """
1269 po_or_so = frappe.get_cached_doc(po_or_so_doctype, po_or_so)
1270
1271 self.payment_schedule = []
1272 self.payment_terms_template = po_or_so.payment_terms_template
1273
1274 for schedule in po_or_so.payment_schedule:
1275 payment_schedule = {
1276 'payment_term': schedule.payment_term,
1277 'due_date': schedule.due_date,
1278 'invoice_portion': schedule.invoice_portion,
GangaManoj5b33e752021-08-05 21:50:09 +05301279 'mode_of_payment': schedule.mode_of_payment,
1280 'description': schedule.description
GangaManoj4323f4b2021-07-22 05:57:42 +05301281 }
GangaManoj5b33e752021-08-05 21:50:09 +05301282
1283 if schedule.discount_type == 'Percentage':
1284 payment_schedule['discount_type'] = schedule.discount_type
1285 payment_schedule['discount'] = schedule.discount
1286
GangaManoj4323f4b2021-07-22 05:57:42 +05301287 self.append("payment_schedule", payment_schedule)
1288
tundebe1b8712017-08-19 08:21:44 +01001289 def set_due_date(self):
Nabin Hait0551f7b2017-11-21 19:58:16 +05301290 due_dates = [d.due_date for d in self.get("payment_schedule") if d.due_date]
1291 if due_dates:
1292 self.due_date = max(due_dates)
tunde62af5c52017-09-22 15:16:38 +01001293
1294 def validate_payment_schedule_dates(self):
tunde77ecacc2017-09-22 23:12:55 +01001295 dates = []
tunde9bed2de2017-09-25 10:19:35 +01001296 li = []
tunde43870aa2017-08-18 11:59:30 +01001297
rohitwaghchauredb9fa782018-03-01 10:32:29 +05301298 if self.doctype == 'Sales Invoice' and self.is_pos: return
1299
tunde43870aa2017-08-18 11:59:30 +01001300 for d in self.get("payment_schedule"):
Nabin Hait2f9f4f92017-12-20 12:24:59 +05301301 if self.doctype == "Sales Order" and getdate(d.due_date) < getdate(self.transaction_date):
Michelle Alva7f2477b2020-04-09 17:23:23 +05301302 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 +01001303 elif d.due_date in dates:
mnatalia5f0e8d62018-05-22 06:38:50 +03001304 li.append(_("{0} in row {1}").format(d.due_date, d.idx))
tunde9bed2de2017-09-25 10:19:35 +01001305 dates.append(d.due_date)
1306
1307 if li:
1308 duplicates = '<br>' + '<br>'.join(li)
Faris Ansari2ab6e0e2018-09-19 13:13:59 +05301309 frappe.throw(_("Rows with duplicate due dates in other rows were found: {0}").format(duplicates))
tunde43870aa2017-08-18 11:59:30 +01001310
tunde62af5c52017-09-22 15:16:38 +01001311 def validate_payment_schedule_amount(self):
rohitwaghchauredb9fa782018-03-01 10:32:29 +05301312 if self.doctype == 'Sales Invoice' and self.is_pos: return
1313
Deepesh Garg26210162020-08-11 16:06:13 +05301314 party_account_currency = self.get('party_account_currency')
1315 if not party_account_currency:
1316 party_type, party = self.get_party()
1317
1318 if party_type and party:
1319 party_account_currency = get_party_account_currency(party_type, party, self.company)
1320
Nabin Hait0551f7b2017-11-21 19:58:16 +05301321 if self.get("payment_schedule"):
1322 total = 0
Saqib Ansarid552fe62021-04-23 14:46:52 +05301323 base_total = 0
Nabin Hait0551f7b2017-11-21 19:58:16 +05301324 for d in self.get("payment_schedule"):
Nabin Haitf592f2c2017-12-19 11:31:34 +05301325 total += flt(d.payment_amount)
Saqib Ansarid552fe62021-04-23 14:46:52 +05301326 base_total += flt(d.base_payment_amount)
tunde43870aa2017-08-18 11:59:30 +01001327
Saqib Ansarid552fe62021-04-23 14:46:52 +05301328 base_grand_total = self.get("base_rounded_total") or self.base_grand_total
1329 grand_total = self.get("rounded_total") or self.grand_total
Rohit Waghchaure4a267b92019-05-09 19:50:00 +05301330
Nabin Haite591c852017-12-21 11:46:30 +05301331 if self.doctype in ("Sales Invoice", "Purchase Invoice"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301332 base_grand_total = base_grand_total - flt(self.base_write_off_amount)
Nabin Haite591c852017-12-21 11:46:30 +05301333 grand_total = grand_total - flt(self.write_off_amount)
Saqib Ansarid552fe62021-04-23 14:46:52 +05301334
1335 if self.get("total_advance"):
1336 if party_account_currency == self.company_currency:
1337 base_grand_total -= self.get("total_advance")
1338 grand_total = flt(base_grand_total / self.get("conversion_rate"), self.precision("grand_total"))
1339 else:
1340 grand_total -= self.get("total_advance")
1341 base_grand_total = flt(grand_total * self.get("conversion_rate"), self.precision("base_grand_total"))
Saqib Ansarid552fe62021-04-23 14:46:52 +05301342 if total != flt(grand_total, self.precision("grand_total")) or \
1343 base_total != flt(base_grand_total, self.precision("base_grand_total")):
Nabin Hait0551f7b2017-11-21 19:58:16 +05301344 frappe.throw(_("Total Payment Amount in Payment Schedule must be equal to Grand / Rounded Total"))
tunde43870aa2017-08-18 11:59:30 +01001345
Nabin Hait877e1bb2017-11-17 12:27:43 +05301346 def is_rounded_total_disabled(self):
1347 if self.meta.get_field("disable_rounded_total"):
1348 return self.disable_rounded_total
1349 else:
1350 return frappe.db.get_single_value("Global Defaults", "disable_rounded_total")
1351
Deepesh Gargf17ea2c2020-12-11 21:30:39 +05301352 def set_inter_company_account(self):
1353 """
1354 Set intercompany account for inter warehouse transactions
1355 This account will be used in case billing company and internal customer's
1356 representation company is same
1357 """
1358
1359 if self.is_internal_transfer() and not self.unrealized_profit_loss_account:
1360 unrealized_profit_loss_account = frappe.db.get_value('Company', self.company, 'unrealized_profit_loss_account')
1361
1362 if not unrealized_profit_loss_account:
1363 msg = _("Please select Unrealized Profit / Loss account or add default Unrealized Profit / Loss account account for company {0}").format(
1364 frappe.bold(self.company))
1365 frappe.throw(msg)
1366
1367 self.unrealized_profit_loss_account = unrealized_profit_loss_account
1368
1369 def is_internal_transfer(self):
1370 """
1371 It will an internal transfer if its an internal customer and representation
1372 company is same as billing company
1373 """
Deepesh Gargb4be2922021-01-28 13:09:56 +05301374 if self.doctype in ('Sales Invoice', 'Delivery Note', 'Sales Order'):
Deepesh Gargf17ea2c2020-12-11 21:30:39 +05301375 internal_party_field = 'is_internal_customer'
Deepesh Gargb4be2922021-01-28 13:09:56 +05301376 elif self.doctype in ('Purchase Invoice', 'Purchase Receipt', 'Purchase Order'):
Deepesh Gargf17ea2c2020-12-11 21:30:39 +05301377 internal_party_field = 'is_internal_supplier'
1378
1379 if self.get(internal_party_field) and (self.represents_company == self.company):
1380 return True
1381
1382 return False
1383
Rushabh Mehta793ba6b2014-02-14 15:47:51 +05301384@frappe.whitelist()
Rushabh Mehtaf56d73c2013-10-10 16:35:09 +05301385def get_tax_rate(account_head):
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +05301386 return frappe.db.get_value("Account", account_head, ["tax_rate", "account_name"], as_dict=True)
Rushabh Mehtaa33d4682015-06-01 17:15:42 +05301387
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001388
Nabin Haitffc7f3f2015-05-12 15:07:02 +05301389@frappe.whitelist()
Nabin Haita2426fc2018-01-15 17:45:46 +05301390def get_default_taxes_and_charges(master_doctype, tax_template=None, company=None):
rohitwaghchaure505661b2017-12-11 14:52:28 +05301391 if not company: return {}
1392
Nabin Haita2426fc2018-01-15 17:45:46 +05301393 if tax_template and company:
1394 tax_template_company = frappe.db.get_value(master_doctype, tax_template, "company")
1395 if tax_template_company == company:
1396 return
1397
1398 default_tax = frappe.db.get_value(master_doctype, {"is_default": 1, "company": company})
rohitwaghchaure505661b2017-12-11 14:52:28 +05301399
Rushabh Mehta98aa5812017-11-14 09:32:32 +05301400 return {
1401 'taxes_and_charges': default_tax,
1402 'taxes': get_taxes_and_charges(master_doctype, default_tax)
1403 }
Nabin Hait6b039142014-05-02 15:45:10 +05301404
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001405
Nabin Hait6b039142014-05-02 15:45:10 +05301406@frappe.whitelist()
Nabin Haitffc7f3f2015-05-12 15:07:02 +05301407def get_taxes_and_charges(master_doctype, master_name):
Nabin Hait1fe50122015-05-16 12:14:39 +05301408 if not master_name:
1409 return
Nabin Hait6b039142014-05-02 15:45:10 +05301410 from frappe.model import default_fields
1411 tax_master = frappe.get_doc(master_doctype, master_name)
1412
1413 taxes_and_charges = []
Nabin Haitffc7f3f2015-05-12 15:07:02 +05301414 for i, tax in enumerate(tax_master.get("taxes")):
Nabin Hait6b039142014-05-02 15:45:10 +05301415 tax = tax.as_dict()
1416
1417 for fieldname in default_fields:
1418 if fieldname in tax:
1419 del tax[fieldname]
1420
1421 taxes_and_charges.append(tax)
1422
1423 return taxes_and_charges
Rushabh Mehta66e08e32014-09-29 12:17:03 +05301424
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001425
Rushabh Mehta66e08e32014-09-29 12:17:03 +05301426def validate_conversion_rate(currency, conversion_rate, conversion_rate_label, company):
1427 """common validation for currency and price list currency"""
1428
Rushabh Mehta708e47a2018-08-08 16:37:31 +05301429 company_currency = frappe.get_cached_value('Company', company, "default_currency")
Rushabh Mehta66e08e32014-09-29 12:17:03 +05301430
1431 if not conversion_rate:
Saqib60212ff2020-10-26 11:17:04 +05301432 throw(
1433 _("{0} is mandatory. Maybe Currency Exchange record is not created for {1} to {2}.")
1434 .format(conversion_rate_label, currency, company_currency)
1435 )
Nabin Hait613d0812015-02-23 11:58:15 +05301436
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001437
Nabin Hait613d0812015-02-23 11:58:15 +05301438def validate_taxes_and_charges(tax):
Deepesh Garg302855e2021-06-14 11:16:39 +05301439 if tax.charge_type in ['Actual', 'On Net Total', 'On Paid Amount'] and tax.row_id:
Nabin Hait613d0812015-02-23 11:58:15 +05301440 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 +05301441 elif tax.charge_type in ['On Previous Row Amount', 'On Previous Row Total']:
Nabin Hait613d0812015-02-23 11:58:15 +05301442 if cint(tax.idx) == 1:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001443 frappe.throw(
1444 _("Cannot select charge type as 'On Previous Row Amount' or 'On Previous Row Total' for first row"))
Nabin Hait613d0812015-02-23 11:58:15 +05301445 elif not tax.row_id:
Suraj Shetty48e9bc32020-01-29 15:06:18 +05301446 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 +05301447 elif tax.row_id and cint(tax.row_id) >= cint(tax.idx):
1448 frappe.throw(_("Cannot refer row number greater than or equal to current row number for this Charge type"))
1449
Rushabh Mehta2a21bc92015-02-25 15:08:42 +05301450 if tax.charge_type == "Actual":
Nabin Haitbc6c3602015-02-27 23:40:56 +05301451 tax.rate = None
Rushabh Mehta2a21bc92015-02-25 15:08:42 +05301452
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001453
Anuja Pawar0e337be2021-08-10 17:26:35 +05301454def validate_account_head(tax, doc):
1455 company = frappe.get_cached_value('Account',
1456 tax.account_head, 'company')
1457
1458 if company != doc.company:
1459 frappe.throw(_('Row {0}: Account {1} does not belong to Company {2}')
1460 .format(tax.idx, frappe.bold(tax.account_head), frappe.bold(doc.company)), title=_('Invalid Account'))
1461
1462
1463def validate_cost_center(tax, doc):
1464 if not tax.cost_center:
1465 return
1466
1467 company = frappe.get_cached_value('Cost Center',
1468 tax.cost_center, 'company')
1469
1470 if company != doc.company:
1471 frappe.throw(_('Row {0}: Cost Center {1} does not belong to Company {2}')
1472 .format(tax.idx, frappe.bold(tax.cost_center), frappe.bold(doc.company)), title=_('Invalid Cost Center'))
1473
1474
Nabin Hait613d0812015-02-23 11:58:15 +05301475def validate_inclusive_tax(tax, doc):
1476 def _on_previous_row_error(row_range):
Deepesh Garg302855e2021-06-14 11:16:39 +05301477 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 +05301478
1479 if cint(getattr(tax, "included_in_print_rate", None)):
1480 if tax.charge_type == "Actual":
1481 # inclusive tax cannot be of type Actual
Deepesh Garg5ef9a622021-06-14 14:34:44 +05301482 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 +05301483 elif tax.charge_type == "On Previous Row Amount" and \
1484 not cint(doc.get("taxes")[cint(tax.row_id) - 1].included_in_print_rate):
1485 # referred row should also be inclusive
1486 _on_previous_row_error(tax.row_id)
1487 elif tax.charge_type == "On Previous Row Total" and \
1488 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 +05301489 # all rows about the referred tax should be inclusive
Nabin Hait613d0812015-02-23 11:58:15 +05301490 _on_previous_row_error("1 - %d" % (tax.row_id,))
Nabin Hait93b3a372015-02-24 17:08:34 +05301491 elif tax.get("category") == "Valuation":
Nabin Hait19ea7212020-08-11 20:34:57 +05301492 frappe.throw(_("Valuation type charges can not be marked as Inclusive"))
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301493
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301494
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001495def set_balance_in_account_currency(gl_dict, account_currency=None, conversion_rate=None, company_currency=None):
1496 if (not conversion_rate) and (account_currency != company_currency):
1497 frappe.throw(_("Account: {0} with currency: {1} can not be selected")
1498 .format(gl_dict.account, account_currency))
1499
1500 gl_dict["account_currency"] = company_currency if account_currency == company_currency \
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301501 else account_currency
1502
1503 # set debit/credit in account currency if not provided
1504 if flt(gl_dict.debit) and not flt(gl_dict.debit_in_account_currency):
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001505 gl_dict.debit_in_account_currency = gl_dict.debit if account_currency == company_currency \
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301506 else flt(gl_dict.debit / conversion_rate, 2)
1507
1508 if flt(gl_dict.credit) and not flt(gl_dict.credit_in_account_currency):
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001509 gl_dict.credit_in_account_currency = gl_dict.credit if account_currency == company_currency \
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301510 else flt(gl_dict.credit / conversion_rate, 2)
Nabin Hait1991c7b2016-06-27 20:09:05 +05301511
1512
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301513def get_advance_journal_entries(party_type, party, party_account, amount_field,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001514 order_doctype, order_list, include_unallocated=True):
1515 dr_or_cr = "credit_in_account_currency" if party_type == "Customer" else "debit_in_account_currency"
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301516
Nabin Hait1991c7b2016-06-27 20:09:05 +05301517 conditions = []
1518 if include_unallocated:
1519 conditions.append("ifnull(t2.reference_name, '')=''")
1520
1521 if order_list:
1522 order_condition = ', '.join(['%s'] * len(order_list))
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001523 conditions.append(" (t2.reference_type = '{0}' and ifnull(t2.reference_name, '') in ({1}))" \
1524 .format(order_doctype, order_condition))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301525
Nabin Hait1991c7b2016-06-27 20:09:05 +05301526 reference_condition = " and (" + " or ".join(conditions) + ")" if conditions else ""
Rushabh Mehta66958302017-01-16 16:57:53 +05301527
Nabin Hait1991c7b2016-06-27 20:09:05 +05301528 journal_entries = frappe.db.sql("""
1529 select
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301530 "Journal Entry" as reference_type, t1.name as reference_name,
Nabin Hait1991c7b2016-06-27 20:09:05 +05301531 t1.remark as remarks, t2.{0} as amount, t2.name as reference_row,
1532 t2.reference_name as against_order
1533 from
1534 `tabJournal Entry` t1, `tabJournal Entry Account` t2
1535 where
1536 t1.name = t2.parent and t2.account = %s
1537 and t2.party_type = %s and t2.party = %s
1538 and t2.is_advance = 'Yes' and t1.docstatus = 1
Nabin Haitca627fb2016-09-05 16:16:53 +05301539 and {1} > 0 {2}
Nabin Hait1991c7b2016-06-27 20:09:05 +05301540 order by t1.posting_date""".format(amount_field, dr_or_cr, reference_condition),
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001541 [party_account, party_type, party] + order_list, as_dict=1)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301542
Nabin Hait1991c7b2016-06-27 20:09:05 +05301543 return list(journal_entries)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301544
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001545
Rohit Waghchauref7258162019-01-15 18:12:04 +05301546def get_advance_payment_entries(party_type, party, party_account, order_doctype,
Nabin Hait34c551d2019-07-03 10:34:31 +05301547 order_list=None, include_unallocated=True, against_all_orders=False, limit=None):
Nabin Hait1991c7b2016-06-27 20:09:05 +05301548 party_account_field = "paid_from" if party_type == "Customer" else "paid_to"
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301549 currency_field = "paid_from_account_currency" if party_type == "Customer" else "paid_to_account_currency"
Nabin Hait1991c7b2016-06-27 20:09:05 +05301550 payment_type = "Receive" if party_type == "Customer" else "Pay"
Saqiba20999c2021-07-12 14:33:23 +05301551 exchange_rate_field = "source_exchange_rate" if payment_type == "Receive" else "target_exchange_rate"
1552
Nabin Hait1991c7b2016-06-27 20:09:05 +05301553 payment_entries_against_order, unallocated_payment_entries = [], []
Nabin Hait34c551d2019-07-03 10:34:31 +05301554 limit_cond = "limit %s" % limit if limit else ""
Nabin Haitff2f3ef2016-07-04 11:41:14 +05301555
Nabin Hait1991c7b2016-06-27 20:09:05 +05301556 if order_list or against_all_orders:
1557 if order_list:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001558 reference_condition = " and t2.reference_name in ({0})" \
Nabin Hait1991c7b2016-06-27 20:09:05 +05301559 .format(', '.join(['%s'] * len(order_list)))
1560 else:
1561 reference_condition = ""
1562 order_list = []
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301563
Nabin Hait1991c7b2016-06-27 20:09:05 +05301564 payment_entries_against_order = frappe.db.sql("""
1565 select
1566 "Payment Entry" as reference_type, t1.name as reference_name,
1567 t1.remarks, t2.allocated_amount as amount, t2.name as reference_row,
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301568 t2.reference_name as against_order, t1.posting_date,
Saqiba20999c2021-07-12 14:33:23 +05301569 t1.{0} as currency, t1.{4} as exchange_rate
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301570 from `tabPayment Entry` t1, `tabPayment Entry Reference` t2
Nabin Hait1991c7b2016-06-27 20:09:05 +05301571 where
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301572 t1.name = t2.parent and t1.{1} = %s and t1.payment_type = %s
Nabin Hait1991c7b2016-06-27 20:09:05 +05301573 and t1.party_type = %s and t1.party = %s and t1.docstatus = 1
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301574 and t2.reference_doctype = %s {2}
1575 order by t1.posting_date {3}
Saqiba20999c2021-07-12 14:33:23 +05301576 """.format(currency_field, party_account_field, reference_condition, limit_cond, exchange_rate_field),
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001577 [party_account, payment_type, party_type, party,
1578 order_doctype] + order_list, as_dict=1)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301579
Nabin Hait1991c7b2016-06-27 20:09:05 +05301580 if include_unallocated:
1581 unallocated_payment_entries = frappe.db.sql("""
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301582 select "Payment Entry" as reference_type, name as reference_name,
Saqiba20999c2021-07-12 14:33:23 +05301583 remarks, unallocated_amount as amount, {2} as exchange_rate
Nabin Hait1991c7b2016-06-27 20:09:05 +05301584 from `tabPayment Entry`
1585 where
1586 {0} = %s and party_type = %s and party = %s and payment_type = %s
1587 and docstatus = 1 and unallocated_amount > 0
Rohit Waghchauref7258162019-01-15 18:12:04 +05301588 order by posting_date {1}
Saqiba20999c2021-07-12 14:33:23 +05301589 """.format(party_account_field, limit_cond, exchange_rate_field),
1590 (party_account, party_type, party, payment_type), as_dict=1)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301591
Rohit Waghchaure2f1db572016-11-08 12:39:33 +05301592 return list(payment_entries_against_order) + list(unallocated_payment_entries)
1593
1594def update_invoice_status():
1595 # Daily update the status of the invoices
1596
Rushabh Mehta66958302017-01-16 16:57:53 +05301597 frappe.db.sql(""" update `tabSales Invoice` set status = 'Overdue'
Rohit Waghchaure2f1db572016-11-08 12:39:33 +05301598 where due_date < CURDATE() and docstatus = 1 and outstanding_amount > 0""")
1599
Rushabh Mehta66958302017-01-16 16:57:53 +05301600 frappe.db.sql(""" update `tabPurchase Invoice` set status = 'Overdue'
Nabin Hait92759692017-08-15 08:23:51 +05301601 where due_date < CURDATE() and docstatus = 1 and outstanding_amount > 0""")
1602
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001603
Nabin Hait92759692017-08-15 08:23:51 +05301604@frappe.whitelist()
Saqib Ansarid552fe62021-04-23 14:46:52 +05301605def 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 +05301606 if not terms_template:
1607 return
1608
1609 terms_doc = frappe.get_doc("Payment Terms Template", terms_template)
1610
1611 schedule = []
tundefb144302017-08-19 15:01:40 +01001612 for d in terms_doc.get("terms"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301613 term_details = get_payment_term_details(d, posting_date, grand_total, base_grand_total, bill_date)
Nabin Hait92759692017-08-15 08:23:51 +05301614 schedule.append(term_details)
1615
1616 return schedule
1617
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001618
Nabin Hait92759692017-08-15 08:23:51 +05301619@frappe.whitelist()
Saqib Ansarid552fe62021-04-23 14:46:52 +05301620def 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 +05301621 term_details = frappe._dict()
Achilles Rasquinha90509982018-03-08 12:55:41 +05301622 if isinstance(term, text_type):
Nabin Hait92759692017-08-15 08:23:51 +05301623 term = frappe.get_doc("Payment Term", term)
1624 else:
1625 term_details.payment_term = term.payment_term
1626 term_details.description = term.description
1627 term_details.invoice_portion = term.invoice_portion
Rohit Waghchaure52bf56d2017-11-27 11:43:52 +05301628 term_details.payment_amount = flt(term.invoice_portion) * flt(grand_total) / 100
Saqib Ansarid552fe62021-04-23 14:46:52 +05301629 term_details.base_payment_amount = flt(term.invoice_portion) * flt(base_grand_total) / 100
Saqib0586b7d2021-03-31 15:03:53 +05301630 term_details.discount_type = term.discount_type
1631 term_details.discount = term.discount
Saqib0586b7d2021-03-31 15:03:53 +05301632 term_details.outstanding = term_details.payment_amount
1633 term_details.mode_of_payment = term.mode_of_payment
1634
Shreya Shah3a9eec22018-02-16 13:05:21 +05301635 if bill_date:
1636 term_details.due_date = get_due_date(term, bill_date)
Saqib0586b7d2021-03-31 15:03:53 +05301637 term_details.discount_date = get_discount_date(term, bill_date)
Shreya Shah3a9eec22018-02-16 13:05:21 +05301638 elif posting_date:
1639 term_details.due_date = get_due_date(term, posting_date)
Saqib0586b7d2021-03-31 15:03:53 +05301640 term_details.discount_date = get_discount_date(term, posting_date)
Shreya Shah3a9eec22018-02-16 13:05:21 +05301641
1642 if getdate(term_details.due_date) < getdate(posting_date):
1643 term_details.due_date = posting_date
1644
Nabin Hait92759692017-08-15 08:23:51 +05301645 return term_details
1646
Shreya Shah3a9eec22018-02-16 13:05:21 +05301647def get_due_date(term, posting_date=None, bill_date=None):
Nabin Hait92759692017-08-15 08:23:51 +05301648 due_date = None
Shreya Shah3a9eec22018-02-16 13:05:21 +05301649 date = bill_date or posting_date
Nabin Hait92759692017-08-15 08:23:51 +05301650 if term.due_date_based_on == "Day(s) after invoice date":
Shreya Shah3a9eec22018-02-16 13:05:21 +05301651 due_date = add_days(date, term.credit_days)
Nabin Hait92759692017-08-15 08:23:51 +05301652 elif term.due_date_based_on == "Day(s) after the end of the invoice month":
Shreya Shah3a9eec22018-02-16 13:05:21 +05301653 due_date = add_days(get_last_day(date), term.credit_days)
Nabin Hait92759692017-08-15 08:23:51 +05301654 elif term.due_date_based_on == "Month(s) after the end of the invoice month":
Shreya Shah3a9eec22018-02-16 13:05:21 +05301655 due_date = add_months(get_last_day(date), term.credit_months)
tunde96b8f222017-09-08 15:35:59 +01001656 return due_date
tundebabzyad08d4c2018-05-16 07:01:41 +01001657
Saqib0586b7d2021-03-31 15:03:53 +05301658def get_discount_date(term, posting_date=None, bill_date=None):
1659 discount_validity = None
1660 date = bill_date or posting_date
1661 if term.discount_validity_based_on == "Day(s) after invoice date":
1662 discount_validity = add_days(date, term.discount_validity)
1663 elif term.discount_validity_based_on == "Day(s) after the end of the invoice month":
1664 discount_validity = add_days(get_last_day(date), term.discount_validity)
1665 elif term.discount_validity_based_on == "Month(s) after the end of the invoice month":
1666 discount_validity = add_months(get_last_day(date), term.discount_validity)
1667 return discount_validity
tundebabzyad08d4c2018-05-16 07:01:41 +01001668
1669def get_supplier_block_status(party_name):
1670 """
1671 Returns a dict containing the values of `on_hold`, `release_date` and `hold_type` of
1672 a `Supplier`
1673 """
1674 supplier = frappe.get_doc('Supplier', party_name)
1675 info = {
1676 'on_hold': supplier.on_hold,
1677 'release_date': supplier.release_date,
1678 'hold_type': supplier.hold_type
1679 }
1680 return info
1681
marination698d9832020-08-19 14:59:46 +05301682def set_child_tax_template_and_map(item, child_item, parent_doc):
1683 args = {
1684 'item_code': item.item_code,
1685 'posting_date': parent_doc.transaction_date,
1686 'tax_category': parent_doc.get('tax_category'),
1687 'company': parent_doc.get('company')
1688 }
1689
1690 child_item.item_tax_template = _get_item_tax_template(args, item.taxes)
1691 if child_item.get("item_tax_template"):
1692 child_item.item_tax_rate = get_item_tax_map(parent_doc.get('company'), child_item.item_tax_template, as_json=True)
1693
Afshanb3bbebd2021-08-09 14:39:32 +05301694def add_taxes_from_tax_template(child_item, parent_doc, db_insert=True):
Marica3b1be2b2020-10-22 17:04:31 +05301695 add_taxes_from_item_tax_template = frappe.db.get_single_value("Accounts Settings", "add_taxes_from_item_tax_template")
1696
1697 if child_item.get("item_tax_rate") and add_taxes_from_item_tax_template:
1698 tax_map = json.loads(child_item.get("item_tax_rate"))
1699 for tax_type in tax_map:
1700 tax_rate = flt(tax_map[tax_type])
1701 taxes = parent_doc.get('taxes') or []
1702 # add new row for tax head only if missing
1703 found = any(tax.account_head == tax_type for tax in taxes)
1704 if not found:
1705 tax_row = parent_doc.append("taxes", {})
1706 tax_row.update({
1707 "description" : str(tax_type).split(' - ')[0],
1708 "charge_type" : "On Net Total",
1709 "account_head" : tax_type,
1710 "rate" : tax_rate
1711 })
1712 if parent_doc.doctype == "Purchase Order":
1713 tax_row.update({
1714 "category" : "Total",
1715 "add_deduct_tax" : "Add"
1716 })
Afshanb3bbebd2021-08-09 14:39:32 +05301717 if db_insert:
1718 tax_row.db_insert()
Marica3b1be2b2020-10-22 17:04:31 +05301719
pateljannat637ddff2021-02-09 16:17:30 +05301720def set_order_defaults(parent_doctype, parent_doctype_name, child_doctype, child_docname, trans_item):
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001721 """
pateljannat637ddff2021-02-09 16:17:30 +05301722 Returns a Sales/Purchase Order Item child item containing the default values
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001723 """
Saqib438e0432020-04-03 10:02:56 +05301724 p_doc = frappe.get_doc(parent_doctype, parent_doctype_name)
pateljannat637ddff2021-02-09 16:17:30 +05301725 child_item = frappe.new_doc(child_doctype, p_doc, child_docname)
Saqib Ansarif53299e2020-04-15 22:08:12 +05301726 item = frappe.get_doc("Item", trans_item.get('item_code'))
marination0673f552021-03-31 01:38:22 +05301727
pateljannat637ddff2021-02-09 16:17:30 +05301728 for field in ("item_code", "item_name", "description", "item_group"):
marination0673f552021-03-31 01:38:22 +05301729 child_item.update({field: item.get(field)})
1730
pateljannat637ddff2021-02-09 16:17:30 +05301731 date_fieldname = "delivery_date" if child_doctype == "Sales Order Item" else "schedule_date"
Jannat Patelbb0d8f82021-02-11 20:59:28 +05301732 child_item.update({date_fieldname: trans_item.get(date_fieldname) or p_doc.get(date_fieldname)})
marination0673f552021-03-31 01:38:22 +05301733 child_item.stock_uom = item.stock_uom
Saqib61314242020-09-15 11:14:31 +05301734 child_item.uom = trans_item.get("uom") or item.stock_uom
Andy Zhu1062d7e2020-10-06 10:51:42 +13001735 child_item.warehouse = get_item_warehouse(item, p_doc, overwrite_warehouse=True)
Saqib61314242020-09-15 11:14:31 +05301736 conversion_factor = flt(get_conversion_factor(item.item_code, child_item.uom).get("conversion_factor"))
1737 child_item.conversion_factor = flt(trans_item.get('conversion_factor')) or conversion_factor
marination0673f552021-03-31 01:38:22 +05301738
pateljannat637ddff2021-02-09 16:17:30 +05301739 if child_doctype == "Purchase Order Item":
marination0673f552021-03-31 01:38:22 +05301740 # Initialized value will update in parent validation
1741 child_item.base_rate = 1
1742 child_item.base_amount = 1
pateljannat637ddff2021-02-09 16:17:30 +05301743 if child_doctype == "Sales Order Item":
1744 child_item.warehouse = get_item_warehouse(item, p_doc, overwrite_warehouse=True)
1745 if not child_item.warehouse:
1746 frappe.throw(_("Cannot find {} for item {}. Please set the same in Item Master or Stock Settings.")
1747 .format(frappe.bold("default warehouse"), frappe.bold(item.item_code)))
marination0673f552021-03-31 01:38:22 +05301748
marination698d9832020-08-19 14:59:46 +05301749 set_child_tax_template_and_map(item, child_item, p_doc)
Marica3b1be2b2020-10-22 17:04:31 +05301750 add_taxes_from_tax_template(child_item, p_doc)
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001751 return child_item
1752
marination0673f552021-03-31 01:38:22 +05301753def validate_child_on_delete(row, parent):
1754 """Check if partially transacted item (row) is being deleted."""
1755 if parent.doctype == "Sales Order":
1756 if flt(row.delivered_qty):
1757 frappe.throw(_("Row #{0}: Cannot delete item {1} which has already been delivered").format(row.idx, row.item_code))
1758 if flt(row.work_order_qty):
1759 frappe.throw(_("Row #{0}: Cannot delete item {1} which has work order assigned to it.").format(row.idx, row.item_code))
1760 if flt(row.ordered_qty):
1761 frappe.throw(_("Row #{0}: Cannot delete item {1} which is assigned to customer's purchase order.").format(row.idx, row.item_code))
1762
1763 if parent.doctype == "Purchase Order" and flt(row.received_qty):
1764 frappe.throw(_("Row #{0}: Cannot delete item {1} which has already been received").format(row.idx, row.item_code))
1765
1766 if flt(row.billed_amt):
1767 frappe.throw(_("Row #{0}: Cannot delete item {1} which has already been billed.").format(row.idx, row.item_code))
1768
1769def update_bin_on_delete(row, doctype):
1770 """Update bin for deleted item (row)."""
1771 from erpnext.stock.stock_balance import update_bin_qty, get_reserved_qty, get_ordered_qty, get_indented_qty
1772 qty_dict = {}
1773
1774 if doctype == "Sales Order":
1775 qty_dict["reserved_qty"] = get_reserved_qty(row.item_code, row.warehouse)
1776 else:
1777 if row.material_request_item:
1778 qty_dict["indented_qty"] = get_indented_qty(row.item_code, row.warehouse)
1779
1780 qty_dict["ordered_qty"] = get_ordered_qty(row.item_code, row.warehouse)
1781
1782 update_bin_qty(row.item_code, row.warehouse, qty_dict)
1783
Saqib6db92fb2020-09-14 19:54:17 +05301784def validate_and_delete_children(parent, data):
Saqib0ad74492019-12-24 16:42:30 +05301785 deleted_children = []
1786 updated_item_names = [d.get("docname") for d in data]
1787 for item in parent.items:
1788 if item.name not in updated_item_names:
1789 deleted_children.append(item)
1790
1791 for d in deleted_children:
marination0673f552021-03-31 01:38:22 +05301792 validate_child_on_delete(d, parent)
Saqib0ad74492019-12-24 16:42:30 +05301793 d.cancel()
1794 d.delete()
marination0673f552021-03-31 01:38:22 +05301795
1796 # need to update ordered qty in Material Request first
1797 # bin uses Material Request Items to recalculate & update
1798 parent.update_prevdoc_status()
1799
1800 for d in deleted_children:
1801 update_bin_on_delete(d, parent.doctype)
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001802
Rohan Bansala93b5142021-04-06 17:10:52 +05301803
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001804@frappe.whitelist()
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001805def update_child_qty_rate(parent_doctype, trans_items, parent_doctype_name, child_docname="items"):
Saqib6db92fb2020-09-14 19:54:17 +05301806 def check_doc_permissions(doc, perm_type='create'):
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301807 try:
1808 doc.check_permission(perm_type)
Saqib6db92fb2020-09-14 19:54:17 +05301809 except frappe.PermissionError:
marination661bf642020-09-29 18:16:45 +05301810 actions = { 'create': 'add', 'write': 'update'}
Saqib6db92fb2020-09-14 19:54:17 +05301811
1812 frappe.throw(_("You do not have permissions to {} items in a {}.")
1813 .format(actions[perm_type], parent_doctype), title=_("Insufficient Permissions"))
marination665c27a2020-09-15 12:04:38 +05301814
Saqib6db92fb2020-09-14 19:54:17 +05301815 def validate_workflow_conditions(doc):
1816 workflow = get_workflow_name(doc.doctype)
1817 if not workflow:
1818 return
1819
1820 workflow_doc = frappe.get_doc("Workflow", workflow)
1821 current_state = doc.get(workflow_doc.workflow_state_field)
1822 roles = frappe.get_roles()
1823
1824 transitions = []
1825 for transition in workflow_doc.transitions:
1826 if transition.next_state == current_state and transition.allowed in roles:
1827 if not is_transition_condition_satisfied(transition, doc):
1828 continue
1829 transitions.append(transition.as_dict())
1830
1831 if not transitions:
Saqib18318932020-09-23 13:01:49 +05301832 frappe.throw(
1833 _("You are not allowed to update as per the conditions set in {} Workflow.").format(get_link_to_form("Workflow", workflow)),
1834 title=_("Insufficient Permissions")
1835 )
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301836
Rohit Waghchaure8d5380a2020-06-18 14:06:31 +05301837 def get_new_child_item(item_row):
Rohit Waghchaureff70e612021-03-06 22:08:08 +05301838 child_doctype = "Sales Order Item" if parent_doctype == "Sales Order" else "Purchase Order Item"
pateljannat637ddff2021-02-09 16:17:30 +05301839 return set_order_defaults(parent_doctype, parent_doctype_name, child_doctype, child_docname, item_row)
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301840
1841 def validate_quantity(child_item, d):
1842 if parent_doctype == "Sales Order" and flt(d.get("qty")) < flt(child_item.delivered_qty):
1843 frappe.throw(_("Cannot set quantity less than delivered quantity"))
1844
1845 if parent_doctype == "Purchase Order" and flt(d.get("qty")) < flt(child_item.received_qty):
1846 frappe.throw(_("Cannot set quantity less than received quantity"))
1847
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001848 data = json.loads(trans_items)
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001849
rohitwaghchaure81c21752019-10-31 15:56:10 +05301850 sales_doctypes = ['Sales Order', 'Sales Invoice', 'Delivery Note', 'Quotation']
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301851 parent = frappe.get_doc(parent_doctype, parent_doctype_name)
marination665c27a2020-09-15 12:04:38 +05301852
marination661bf642020-09-29 18:16:45 +05301853 check_doc_permissions(parent, 'write')
Saqib6db92fb2020-09-14 19:54:17 +05301854 validate_and_delete_children(parent, data)
Saqib0ad74492019-12-24 16:42:30 +05301855
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001856 for d in data:
1857 new_child_flag = False
1858 if not d.get("docname"):
1859 new_child_flag = True
Saqib6db92fb2020-09-14 19:54:17 +05301860 check_doc_permissions(parent, 'create')
Rohit Waghchaure8d5380a2020-06-18 14:06:31 +05301861 child_item = get_new_child_item(d)
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001862 else:
Saqib6db92fb2020-09-14 19:54:17 +05301863 check_doc_permissions(parent, 'write')
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001864 child_item = frappe.get_doc(parent_doctype + ' Item', d.get("docname"))
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301865
Saqib Ansaric579b082020-05-29 22:21:50 +05301866 prev_rate, new_rate = flt(child_item.get("rate")), flt(d.get("rate"))
1867 prev_qty, new_qty = flt(child_item.get("qty")), flt(d.get("qty"))
1868 prev_con_fac, new_con_fac = flt(child_item.get("conversion_factor")), flt(d.get("conversion_factor"))
Saqib61314242020-09-15 11:14:31 +05301869 prev_uom, new_uom = child_item.get("uom"), d.get("uom")
Saqib Ansaric579b082020-05-29 22:21:50 +05301870
1871 if parent_doctype == 'Sales Order':
1872 prev_date, new_date = child_item.get("delivery_date"), d.get("delivery_date")
1873 elif parent_doctype == 'Purchase Order':
marinationb7e94cc2020-06-15 11:32:42 +05301874 prev_date, new_date = child_item.get("schedule_date"), d.get("schedule_date")
Saqib Ansaric579b082020-05-29 22:21:50 +05301875
1876 rate_unchanged = prev_rate == new_rate
marinationf9c4b202020-06-12 15:49:53 +05301877 qty_unchanged = prev_qty == new_qty
Saqib61314242020-09-15 11:14:31 +05301878 uom_unchanged = prev_uom == new_uom
Saqib Ansaric579b082020-05-29 22:21:50 +05301879 conversion_factor_unchanged = prev_con_fac == new_con_fac
1880 date_unchanged = prev_date == new_date if prev_date and new_date else False # in case of delivery note etc
Saqib61314242020-09-15 11:14:31 +05301881 if rate_unchanged and qty_unchanged and conversion_factor_unchanged and uom_unchanged and date_unchanged:
Saqibdd374ff2020-02-27 12:51:31 +05301882 continue
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001883
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301884 validate_quantity(child_item, d)
deepeshgarg00777cde832018-12-27 15:56:51 +05301885
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001886 child_item.qty = flt(d.get("qty"))
Saqib56fea7d2020-10-09 21:19:25 +05301887 rate_precision = child_item.precision("rate") or 2
1888 conv_fac_precision = child_item.precision("conversion_factor") or 2
1889 qty_precision = child_item.precision("qty") or 2
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001890
Saqib56fea7d2020-10-09 21:19:25 +05301891 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 +08001892 frappe.throw(_("Row #{0}: Cannot set Rate if amount is greater than billed amount for Item {1}.")
1893 .format(child_item.idx, child_item.item_code))
1894 else:
Saqib56fea7d2020-10-09 21:19:25 +05301895 child_item.rate = flt(d.get("rate"), rate_precision)
marinationf9c4b202020-06-12 15:49:53 +05301896
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301897 if d.get("conversion_factor"):
marinationf9c4b202020-06-12 15:49:53 +05301898 if child_item.stock_uom == child_item.uom:
1899 child_item.conversion_factor = 1
1900 else:
Saqib56fea7d2020-10-09 21:19:25 +05301901 child_item.conversion_factor = flt(d.get('conversion_factor'), conv_fac_precision)
marination665c27a2020-09-15 12:04:38 +05301902
Saqib61314242020-09-15 11:14:31 +05301903 if d.get("uom"):
1904 child_item.uom = d.get("uom")
1905 conversion_factor = flt(get_conversion_factor(child_item.item_code, child_item.uom).get("conversion_factor"))
Saqib56fea7d2020-10-09 21:19:25 +05301906 child_item.conversion_factor = flt(d.get('conversion_factor'), conv_fac_precision) or conversion_factor
Mangesh-Khairnara3d52002019-08-05 10:16:40 +05301907
Saqib Ansaric579b082020-05-29 22:21:50 +05301908 if d.get("delivery_date") and parent_doctype == 'Sales Order':
1909 child_item.delivery_date = d.get('delivery_date')
marinationf9c4b202020-06-12 15:49:53 +05301910
Saqib Ansaric579b082020-05-29 22:21:50 +05301911 if d.get("schedule_date") and parent_doctype == 'Purchase Order':
1912 child_item.schedule_date = d.get('schedule_date')
1913
Mangesh-Khairnara3d52002019-08-05 10:16:40 +05301914 if flt(child_item.price_list_rate):
Maricaf0674472019-10-11 10:47:09 +05301915 if flt(child_item.rate) > flt(child_item.price_list_rate):
1916 # if rate is greater than price_list_rate, set margin
1917 # or set discount
1918 child_item.discount_percentage = 0
rohitwaghchaure81c21752019-10-31 15:56:10 +05301919
1920 if parent_doctype in sales_doctypes:
1921 child_item.margin_type = "Amount"
1922 child_item.margin_rate_or_amount = flt(child_item.rate - child_item.price_list_rate,
1923 child_item.precision("margin_rate_or_amount"))
1924 child_item.rate_with_margin = child_item.rate
Maricaf0674472019-10-11 10:47:09 +05301925 else:
1926 child_item.discount_percentage = flt((1 - flt(child_item.rate) / flt(child_item.price_list_rate)) * 100.0,
1927 child_item.precision("discount_percentage"))
1928 child_item.discount_amount = flt(
1929 child_item.price_list_rate) - flt(child_item.rate)
rohitwaghchaure81c21752019-10-31 15:56:10 +05301930
1931 if parent_doctype in sales_doctypes:
1932 child_item.margin_type = ""
1933 child_item.margin_rate_or_amount = 0
1934 child_item.rate_with_margin = 0
Mangesh-Khairnara3d52002019-08-05 10:16:40 +05301935
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001936 child_item.flags.ignore_validate_update_after_submit = True
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001937 if new_child_flag:
Saqib Ansarif53299e2020-04-15 22:08:12 +05301938 parent.load_from_db()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301939 child_item.idx = len(parent.items) + 1
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001940 child_item.insert()
1941 else:
1942 child_item.save()
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001943
Rushabh Mehtafafbb022018-12-24 22:09:15 +05301944 parent.reload()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301945 parent.flags.ignore_validate_update_after_submit = True
1946 parent.set_qty_as_per_stock_uom()
1947 parent.calculate_taxes_and_totals()
Ankush Menatdf6e2082021-02-11 11:04:39 +05301948 parent.set_total_in_words()
Nabin Hait49a46f02019-10-21 13:35:43 +05301949 if parent_doctype == "Sales Order":
Marica3dee5272020-06-23 10:33:47 +05301950 make_packing_list(parent)
Nabin Hait49a46f02019-10-21 13:35:43 +05301951 parent.set_gross_profit()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301952 frappe.get_doc('Authorization Control').validate_approving_authority(parent.doctype,
1953 parent.company, parent.base_grand_total)
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001954
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301955 parent.set_payment_schedule()
Nabin Haitb2da0822018-07-13 17:01:40 +05301956 if parent_doctype == 'Purchase Order':
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301957 parent.validate_minimum_order_qty()
1958 parent.validate_budget()
1959 if parent.is_against_so():
1960 parent.update_status_updater()
Nabin Haitb2da0822018-07-13 17:01:40 +05301961 else:
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301962 parent.check_credit_limit()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301963 parent.save()
Nabin Haitb2da0822018-07-13 17:01:40 +05301964
1965 if parent_doctype == 'Purchase Order':
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301966 update_last_purchase_rate(parent, is_submit = 1)
1967 parent.update_prevdoc_status()
1968 parent.update_requested_qty()
1969 parent.update_ordered_qty()
1970 parent.update_ordered_and_reserved_qty()
1971 parent.update_receiving_percentage()
1972 if parent.is_subcontracted == "Yes":
1973 parent.update_reserved_qty_for_subcontract()
Saqib61314242020-09-15 11:14:31 +05301974 parent.create_raw_materials_supplied("supplied_items")
1975 parent.save()
Nabin Haitb2da0822018-07-13 17:01:40 +05301976 else:
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301977 parent.update_reserved_qty()
1978 parent.update_project()
1979 parent.update_prevdoc_status('submit')
1980 parent.update_delivery_status()
Nabin Haitb2da0822018-07-13 17:01:40 +05301981
Saqib6db92fb2020-09-14 19:54:17 +05301982 parent.reload()
1983 validate_workflow_conditions(parent)
1984
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301985 parent.update_blanket_order()
1986 parent.update_billing_percentage()
1987 parent.set_status()
Gauravf1e28e02019-02-13 16:46:24 +05301988
1989@erpnext.allow_regional
1990def validate_regional(doc):
1991 pass
Saqib6d74f5b2020-12-25 10:26:43 +05301992
1993@erpnext.allow_regional
1994def validate_einvoice_fields(doc):
GangaManoj4323f4b2021-07-22 05:57:42 +05301995 pass