blob: ad950be57e7b334a4d59bc3565e9f6c54bc266f7 [file] [log] [blame]
Anand Doshi885e0742015-03-03 14:55:30 +05301# Copyright (c) 2015, Frappe Technologies Pvt. Ltd. and Contributors
Rushabh Mehtae67d1fb2013-08-05 14:59:54 +05302# License: GNU General Public License v3. See license.txt
Nabin Hait2df4d542013-01-29 11:34:39 +05303
4from __future__ import unicode_literals
Rushabh Mehtacc8b2b22017-03-31 12:44:29 +05305import frappe, erpnext
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08006import json
Rushabh Mehta793ba6b2014-02-14 15:47:51 +05307from frappe import _, throw
rohitwaghchaurea85ddf22019-11-19 18:47:48 +05308from frappe.utils import (today, flt, cint, fmt_money, formatdate,
9 getdate, add_days, add_months, get_last_day, nowdate, get_link_to_form)
Saqib6db92fb2020-09-14 19:54:17 +053010from frappe.model.workflow import get_workflow_name, is_transition_condition_satisfied, WorkflowPermissionError
rohitwaghchaurea85ddf22019-11-19 18:47:48 +053011from erpnext.stock.get_item_details import get_conversion_factor, get_item_details
Rushabh Mehtacc8b2b22017-03-31 12:44:29 +053012from erpnext.setup.utils import get_exchange_rate
Nabin Hait2ed0b592016-03-29 13:14:17 +053013from erpnext.accounts.utils import get_fiscal_years, validate_fiscal_year, get_account_currency
Nabin Hait436f5262014-02-10 14:47:54 +053014from erpnext.utilities.transaction_base import TransactionBase
Doridel Cahanap6f06cc22018-05-17 16:28:58 +080015from erpnext.buying.utils import update_last_purchase_rate
Nabin Hait3cf67a42015-07-24 13:26:36 +053016from erpnext.controllers.sales_and_purchase_return import validate_return
shreyas29b565f2016-01-25 17:30:49 +053017from erpnext.accounts.party import get_party_account_currency, validate_party_frozen_disabled
rohitwaghchaurea85ddf22019-11-19 18:47:48 +053018from erpnext.accounts.doctype.pricing_rule.utils import (apply_pricing_rule_on_transaction,
19 apply_pricing_rule_for_free_items, get_applied_pricing_rules)
shreyasf76853a2016-01-25 21:25:11 +053020from erpnext.exceptions import InvalidCurrency
Achilles Rasquinha90509982018-03-08 12:55:41 +053021from six import text_type
deepeshgarg007d83cf652019-05-12 18:34:23 +053022from erpnext.accounts.doctype.accounting_dimension.accounting_dimension import get_accounting_dimensions
marination698d9832020-08-19 14:59:46 +053023from erpnext.stock.get_item_details import get_item_warehouse, _get_item_tax_template, get_item_tax_map
Marica3dee5272020-06-23 10:33:47 +053024from erpnext.stock.doctype.packed_item.packed_item import make_packing_list
prssanna71e5b602020-10-29 14:19:34 +053025from erpnext.controllers.print_settings import set_print_templates_for_item_table, set_print_templates_for_taxes
Nabin Hait1d218422015-07-17 15:19:02 +053026
marination53b1a9a2020-11-03 15:45:25 +053027class AccountMissingError(frappe.ValidationError): pass
28
Rohit Waghchaurebde159a2021-03-22 23:36:48 +053029force_item_fields = ("item_group", "brand", "stock_uom", "is_fixed_asset", "item_tax_rate",
30 "pricing_rules", "weight_per_unit", "weight_uom", "total_weight")
Doridel Cahanap6f06cc22018-05-17 16:28:58 +080031
Nabin Haitbf495c92013-01-30 12:49:08 +053032class AccountsController(TransactionBase):
Nabin Hait7eba1a32017-10-02 15:59:27 +053033 def __init__(self, *args, **kwargs):
34 super(AccountsController, self).__init__(*args, **kwargs)
Anand Doshi979326b2015-09-11 16:22:37 +053035
prssanna71e5b602020-10-29 14:19:34 +053036 def get_print_settings(self):
37 print_setting_fields = []
38 items_field = self.meta.get_field('items')
39
40 if items_field and items_field.fieldtype == 'Table':
41 print_setting_fields += ['compact_item_print', 'print_uom_after_quantity']
42
43 taxes_field = self.meta.get_field('taxes')
44 if taxes_field and taxes_field.fieldtype == 'Table':
45 print_setting_fields += ['print_taxes_with_zero_amount']
46
47 return print_setting_fields
48
Nabin Hait4ffd7f32015-08-27 12:28:36 +053049 @property
50 def company_currency(self):
51 if not hasattr(self, "__company_currency"):
Rushabh Mehtacc8b2b22017-03-31 12:44:29 +053052 self.__company_currency = erpnext.get_company_currency(self.company)
Anand Doshi979326b2015-09-11 16:22:37 +053053
Nabin Hait4ffd7f32015-08-27 12:28:36 +053054 return self.__company_currency
Anand Doshi979326b2015-09-11 16:22:37 +053055
Rohit Waghchaure7d529892016-10-06 14:35:04 +053056 def onload(self):
Nabin Hait34c551d2019-07-03 10:34:31 +053057 self.set_onload("make_payment_via_journal_entry",
58 frappe.db.get_single_value('Accounts Settings', 'make_payment_via_journal_entry'))
Nabin Hait0551f7b2017-11-21 19:58:16 +053059
tundee52bb822017-09-25 09:02:23 +010060 if self.is_new():
Nabin Hait0551f7b2017-11-21 19:58:16 +053061 relevant_docs = ("Quotation", "Purchase Order", "Sales Order",
Doridel Cahanap6f06cc22018-05-17 16:28:58 +080062 "Purchase Invoice", "Sales Invoice")
tundee52bb822017-09-25 09:02:23 +010063 if self.doctype in relevant_docs:
64 self.set_payment_schedule()
Rohit Waghchaure7d529892016-10-06 14:35:04 +053065
tundebabzyad08d4c2018-05-16 07:01:41 +010066 def ensure_supplier_is_not_blocked(self):
67 is_supplier_payment = self.doctype == 'Payment Entry' and self.party_type == 'Supplier'
68 is_buying_invoice = self.doctype in ['Purchase Invoice', 'Purchase Order']
69 supplier = None
70 supplier_name = None
71
72 if is_buying_invoice or is_supplier_payment:
73 supplier_name = self.supplier if is_buying_invoice else self.party
74 supplier = frappe.get_doc('Supplier', supplier_name)
75
76 if supplier and supplier_name and supplier.on_hold:
77 if (is_buying_invoice and supplier.hold_type in ['All', 'Invoices']) or \
78 (is_supplier_payment and supplier.hold_type in ['All', 'Payments']):
79 if not supplier.release_date or getdate(nowdate()) <= supplier.release_date:
80 frappe.msgprint(
Suraj Shetty48e9bc32020-01-29 15:06:18 +053081 _('{0} is blocked so this transaction cannot proceed').format(supplier_name), raise_exception=1)
tundebabzyad08d4c2018-05-16 07:01:41 +010082
Saurabh6f753182013-03-20 12:55:28 +053083 def validate(self):
Deepesh Gargd301d262019-07-31 15:58:19 +053084 if not self.get('is_return'):
85 self.validate_qty_is_not_zero()
86
nabinhait23cce732014-07-03 12:25:06 +053087 if self.get("_action") and self._action != "update_after_submit":
Nabin Hait704a4532014-06-05 16:55:31 +053088 self.set_missing_values(for_validate=True)
tunde62af5c52017-09-22 15:16:38 +010089
tundebabzyad08d4c2018-05-16 07:01:41 +010090 self.ensure_supplier_is_not_blocked()
91
Nabin Haitcfecd2b2013-07-11 17:49:18 +053092 self.validate_date_with_fiscal_year()
Deepesh Garg4c8d15b2021-04-26 15:24:34 +053093 self.validate_party_accounts()
94
Deepesh Gargb4be2922021-01-28 13:09:56 +053095 self.validate_inter_company_reference()
96
97 self.set_incoming_rate()
Rushabh Mehtab16b9cd2015-08-03 16:13:33 +053098
Anand Doshi3543f302013-05-24 19:25:01 +053099 if self.meta.get_field("currency"):
Anand Doshi923d41d2013-05-28 17:23:36 +0530100 self.calculate_taxes_and_totals()
Rohit Waghchaure6087fe12016-04-09 14:31:09 +0530101
Nabin Hait1d218422015-07-17 15:19:02 +0530102 if not self.meta.get_field("is_return") or not self.is_return:
103 self.validate_value("base_grand_total", ">=", 0)
Rushabh Mehtab16b9cd2015-08-03 16:13:33 +0530104
Nabin Hait3cf67a42015-07-24 13:26:36 +0530105 validate_return(self)
Anand Doshi3543f302013-05-24 19:25:01 +0530106 self.set_total_in_words()
Anand Doshid2946502014-04-08 20:10:03 +0530107
tunde62af5c52017-09-22 15:16:38 +0100108 self.validate_all_documents_schedule()
Anand Doshid2946502014-04-08 20:10:03 +0530109
ankitjavalkarwork6c29d872014-10-06 13:20:53 +0530110 if self.meta.get_field("taxes_and_charges"):
111 self.validate_enabled_taxes_and_charges()
Nabin Haita2426fc2018-01-15 17:45:46 +0530112 self.validate_tax_account_company()
Rushabh Mehtab16b9cd2015-08-03 16:13:33 +0530113
Neil Trini Lasrado3fbbb712015-07-17 12:10:12 +0530114 self.validate_party()
Nabin Hait895029d2015-08-20 14:55:39 +0530115 self.validate_currency()
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +0530116
Rohit Waghchaure6087fe12016-04-09 14:31:09 +0530117 if self.doctype == 'Purchase Invoice':
Mangesh-Khairnar7bcb24e2019-09-11 10:49:33 +0530118 self.calculate_paid_amount()
Deepesh Garg911818a2021-06-09 22:55:10 +0530119 # apply tax withholding only if checked and applicable
120 self.set_tax_withholding()
Rohit Waghchaure6087fe12016-04-09 14:31:09 +0530121
Nabin Hait041a5c22018-08-01 18:07:39 +0530122 if self.doctype in ['Purchase Invoice', 'Sales Invoice']:
Nabin Hait4a994d42019-04-25 17:47:26 +0530123 pos_check_field = "is_pos" if self.doctype=="Sales Invoice" else "is_paid"
124 if cint(self.allocate_advances_automatically) and not cint(self.get(pos_check_field)):
Nabin Hait041a5c22018-08-01 18:07:39 +0530125 self.set_advances()
126
Saqib7fb64d12021-07-12 18:33:16 +0530127 self.set_advance_gain_or_loss()
128
Nabin Hait041a5c22018-08-01 18:07:39 +0530129 if self.is_return:
130 self.validate_qty()
Nabin Haitacdd5082019-12-04 15:30:01 +0530131 else:
132 self.validate_deferred_start_and_end_date()
rohitwaghchaure70489252018-06-11 12:02:14 +0530133
Deepesh Gargf17ea2c2020-12-11 21:30:39 +0530134 self.set_inter_company_account()
135
Gauravf1e28e02019-02-13 16:46:24 +0530136 validate_regional(self)
Deepesh Garg7c300852020-12-26 20:14:51 +0530137
Saqib6d74f5b2020-12-25 10:26:43 +0530138 validate_einvoice_fields(self)
139
Rohit Waghchaure8bfe3302019-03-18 14:34:19 +0530140 if self.doctype != 'Material Request':
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530141 apply_pricing_rule_on_transaction(self)
Gauravf1e28e02019-02-13 16:46:24 +0530142
Saqib6d74f5b2020-12-25 10:26:43 +0530143 def before_cancel(self):
144 validate_einvoice_fields(self)
rohitwaghchaurebf7317d2021-02-01 20:22:14 +0530145
Saqib8e556772021-01-28 12:26:45 +0530146 def on_trash(self):
147 # delete sl and gl entries on deletion of transaction
148 if frappe.db.get_single_value('Accounts Settings', 'delete_linked_ledger_entries'):
149 frappe.db.sql("delete from `tabGL Entry` where voucher_type=%s and voucher_no=%s", (self.doctype, self.name))
150 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 +0530151
Nabin Haitacdd5082019-12-04 15:30:01 +0530152 def validate_deferred_start_and_end_date(self):
153 for d in self.items:
154 if d.get("enable_deferred_revenue") or d.get("enable_deferred_expense"):
155 if not (d.service_start_date and d.service_end_date):
156 frappe.throw(_("Row #{0}: Service Start and End Date is required for deferred accounting").format(d.idx))
157 elif getdate(d.service_start_date) > getdate(d.service_end_date):
158 frappe.throw(_("Row #{0}: Service Start Date cannot be greater than Service End Date").format(d.idx))
159 elif getdate(self.posting_date) > getdate(d.service_end_date):
160 frappe.throw(_("Row #{0}: Service End Date cannot be before Invoice Posting Date").format(d.idx))
161
tunde62af5c52017-09-22 15:16:38 +0100162 def validate_invoice_documents_schedule(self):
Nabin Hait0551f7b2017-11-21 19:58:16 +0530163 self.validate_payment_schedule_dates()
164 self.set_due_date()
Nabin Hait0551f7b2017-11-21 19:58:16 +0530165 self.set_payment_schedule()
166 self.validate_payment_schedule_amount()
tunde62af5c52017-09-22 15:16:38 +0100167 self.validate_due_date()
168 self.validate_advance_entries()
169
170 def validate_non_invoice_documents_schedule(self):
Nabin Hait0551f7b2017-11-21 19:58:16 +0530171 self.set_payment_schedule()
Nabin Hait2f9f4f92017-12-20 12:24:59 +0530172 self.validate_payment_schedule_dates()
Nabin Hait0551f7b2017-11-21 19:58:16 +0530173 self.validate_payment_schedule_amount()
tunde62af5c52017-09-22 15:16:38 +0100174
175 def validate_all_documents_schedule(self):
176 if self.doctype in ("Sales Invoice", "Purchase Invoice") and not self.is_return:
177 self.validate_invoice_documents_schedule()
178 elif self.doctype in ("Quotation", "Purchase Order", "Sales Order"):
179 self.validate_non_invoice_documents_schedule()
180
prssanna71e5b602020-10-29 14:19:34 +0530181 def before_print(self, settings=None):
Zarrarb9f54ca2018-05-28 17:41:09 +0530182 if self.doctype in ['Purchase Order', 'Sales Order', 'Sales Invoice', 'Purchase Invoice',
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800183 'Supplier Quotation', 'Purchase Receipt', 'Delivery Note', 'Quotation']:
KanchanChauhan49a50fe2016-11-18 13:57:53 +0530184 if self.get("group_same_items"):
185 self.group_similar_items()
186
Zarrar5be6d192018-11-08 12:16:26 +0530187 df = self.meta.get_field("discount_amount")
188 if self.get("discount_amount") and hasattr(self, "taxes") and not len(self.taxes):
189 df.set("print_hide", 0)
190 self.discount_amount = -self.discount_amount
191 else:
192 df.set("print_hide", 1)
193
prssanna71e5b602020-10-29 14:19:34 +0530194 set_print_templates_for_item_table(self, settings)
195 set_print_templates_for_taxes(self, settings)
196
Mangesh-Khairnar7bcb24e2019-09-11 10:49:33 +0530197 def calculate_paid_amount(self):
Saurabh43520f92016-03-21 18:32:48 +0530198 if hasattr(self, "is_pos") or hasattr(self, "is_paid"):
199 is_paid = self.get("is_pos") or self.get("is_paid")
Mangesh-Khairnar7bcb24e2019-09-11 10:49:33 +0530200
201 if is_paid:
202 if not self.cash_bank_account:
203 # show message that the amount is not paid
204 frappe.throw(_("Note: Payment Entry will not be created since 'Cash or Bank Account' was not specified"))
Marica23d7b092019-09-25 17:17:36 +0530205
Mangesh-Khairnar7bcb24e2019-09-11 10:49:33 +0530206 if cint(self.is_return) and self.grand_total > self.paid_amount:
207 self.paid_amount = flt(flt(self.grand_total), self.precision("paid_amount"))
208
209 elif not flt(self.paid_amount) and flt(self.outstanding_amount) > 0:
210 self.paid_amount = flt(flt(self.outstanding_amount), self.precision("paid_amount"))
211
212 self.base_paid_amount = flt(self.paid_amount * self.conversion_rate,
213 self.precision("base_paid_amount"))
Saurabh43520f92016-03-21 18:32:48 +0530214
Anand Doshiabc10032013-06-14 17:44:03 +0530215 def set_missing_values(self, for_validate=False):
Rohit Waghchaure5d97d892016-05-12 12:58:29 +0530216 if frappe.flags.in_test:
tunde62af5c52017-09-22 15:16:38 +0100217 for fieldname in ["posting_date", "transaction_date"]:
Rohit Waghchaure5d97d892016-05-12 12:58:29 +0530218 if self.meta.get_field(fieldname) and not self.get(fieldname):
219 self.set(fieldname, today())
220 break
Anand Doshid2946502014-04-08 20:10:03 +0530221
Nabin Hait3237c752015-02-17 11:11:11 +0530222 def calculate_taxes_and_totals(self):
Nabin Haitfe81da22015-02-18 12:23:18 +0530223 from erpnext.controllers.taxes_and_totals import calculate_taxes_and_totals
224 calculate_taxes_and_totals(self)
Nabin Hait3237c752015-02-17 11:11:11 +0530225
226 if self.doctype in ["Quotation", "Sales Order", "Delivery Note", "Sales Invoice"]:
227 self.calculate_commission()
228 self.calculate_contribution()
229
Nabin Haitcfecd2b2013-07-11 17:49:18 +0530230 def validate_date_with_fiscal_year(self):
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800231 if self.meta.get_field("fiscal_year"):
Rohan Bansal1e3a3b22021-05-26 15:18:10 +0530232 date_field = None
Nabin Haitcfecd2b2013-07-11 17:49:18 +0530233 if self.meta.get_field("posting_date"):
234 date_field = "posting_date"
235 elif self.meta.get_field("transaction_date"):
236 date_field = "transaction_date"
Anand Doshid2946502014-04-08 20:10:03 +0530237
Rushabh Mehtaf2227d02014-03-31 23:37:40 +0530238 if date_field and self.get(date_field):
Rushabh Mehta66958302017-01-16 16:57:53 +0530239 validate_fiscal_year(self.get(date_field), self.fiscal_year, self.company,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800240 self.meta.get_label(date_field), self)
Anand Doshid2946502014-04-08 20:10:03 +0530241
Deepesh Garg4c8d15b2021-04-26 15:24:34 +0530242 def validate_party_accounts(self):
243 if self.doctype not in ('Sales Invoice', 'Purchase Invoice'):
244 return
245
246 if self.doctype == 'Sales Invoice':
247 party_account_field = 'debit_to'
248 item_field = 'income_account'
249 else:
250 party_account_field = 'credit_to'
251 item_field = 'expense_account'
252
253 for item in self.get('items'):
254 if item.get(item_field) == self.get(party_account_field):
255 frappe.throw(_("Row {0}: {1} {2} cannot be same as {3} (Party Account) {4}").format(item.idx,
256 frappe.bold(frappe.unscrub(item_field)), item.get(item_field),
257 frappe.bold(frappe.unscrub(party_account_field)), self.get(party_account_field)))
258
Deepesh Gargb4be2922021-01-28 13:09:56 +0530259 def validate_inter_company_reference(self):
260 if self.doctype not in ('Purchase Invoice', 'Purchase Receipt', 'Purchase Order'):
261 return
262
263 if self.is_internal_transfer():
264 if not (self.get('inter_company_reference') or self.get('inter_company_invoice_reference')
265 or self.get('inter_company_order_reference')):
Deepesh Garg4c8d15b2021-04-26 15:24:34 +0530266 msg = _("Internal Sale or Delivery Reference missing.")
Deepesh Gargb4be2922021-01-28 13:09:56 +0530267 msg += _("Please create purchase from internal sale or delivery document itself")
268 frappe.throw(msg, title=_("Internal Sales Reference Missing"))
269
Nabin Haite9daefe2014-08-27 16:46:33 +0530270 def validate_due_date(self):
rohitwaghchaureea943c62018-07-06 12:28:58 +0530271 if self.get('is_pos'): return
272
Nabin Haite9daefe2014-08-27 16:46:33 +0530273 from erpnext.accounts.party import validate_due_date
274 if self.doctype == "Sales Invoice":
Nabin Hait04d244a2015-07-22 17:47:49 +0530275 if not self.due_date:
276 frappe.throw(_("Due Date is mandatory"))
Rushabh Mehtab16b9cd2015-08-03 16:13:33 +0530277
rohitwaghchaure3ffe8962018-07-13 17:40:48 +0530278 validate_due_date(self.posting_date, self.due_date,
279 "Customer", self.customer, self.company, self.payment_terms_template)
Nabin Haite9daefe2014-08-27 16:46:33 +0530280 elif self.doctype == "Purchase Invoice":
Rohit Waghchaured1a85a32018-11-26 18:42:29 +0530281 validate_due_date(self.bill_date or self.posting_date, self.due_date,
Saurabhd7897f12018-07-18 17:08:16 +0530282 "Supplier", self.supplier, self.company, self.bill_date, self.payment_terms_template)
Nabin Haite9daefe2014-08-27 16:46:33 +0530283
Nabin Hait096d3632013-10-17 17:01:14 +0530284 def set_price_list_currency(self, buying_or_selling):
Nabin Hait1cc55fb2016-12-08 14:09:23 +0530285 if self.meta.get_field("posting_date"):
Nabin Hait288a18e2016-12-08 15:36:23 +0530286 transaction_date = self.posting_date
Nabin Hait1cc55fb2016-12-08 14:09:23 +0530287 else:
Nabin Hait288a18e2016-12-08 15:36:23 +0530288 transaction_date = self.transaction_date
Rushabh Mehta66958302017-01-16 16:57:53 +0530289
Rushabh Mehta4a404e92013-08-09 18:11:35 +0530290 if self.meta.get_field("currency"):
Nabin Hait7a75e102013-09-17 10:21:20 +0530291 # price list part
Shreya3f778522018-05-15 16:59:20 +0530292 if buying_or_selling.lower() == "selling":
293 fieldname = "selling_price_list"
294 args = "for_selling"
295 else:
296 fieldname = "buying_price_list"
297 args = "for_buying"
298
Anand Doshif78d1ae2014-03-28 13:55:00 +0530299 if self.meta.get_field(fieldname) and self.get(fieldname):
300 self.price_list_currency = frappe.db.get_value("Price List",
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800301 self.get(fieldname), "currency")
Anand Doshid2946502014-04-08 20:10:03 +0530302
Nabin Hait6e439a52015-08-28 19:24:22 +0530303 if self.price_list_currency == self.company_currency:
Anand Doshif78d1ae2014-03-28 13:55:00 +0530304 self.plc_conversion_rate = 1.0
Nabin Hait11f41952013-09-24 14:36:55 +0530305
Anand Doshif78d1ae2014-03-28 13:55:00 +0530306 elif not self.plc_conversion_rate:
Rushabh Mehta66958302017-01-16 16:57:53 +0530307 self.plc_conversion_rate = get_exchange_rate(self.price_list_currency,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800308 self.company_currency, transaction_date, args)
Anand Doshid2946502014-04-08 20:10:03 +0530309
Nabin Hait7a75e102013-09-17 10:21:20 +0530310 # currency
Anand Doshif78d1ae2014-03-28 13:55:00 +0530311 if not self.currency:
312 self.currency = self.price_list_currency
313 self.conversion_rate = self.plc_conversion_rate
Nabin Hait6e439a52015-08-28 19:24:22 +0530314 elif self.currency == self.company_currency:
Anand Doshif78d1ae2014-03-28 13:55:00 +0530315 self.conversion_rate = 1.0
316 elif not self.conversion_rate:
Anand Doshidffec8f2014-07-01 17:45:15 +0530317 self.conversion_rate = get_exchange_rate(self.currency,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800318 self.company_currency, transaction_date, args)
Nabin Hait7a75e102013-09-17 10:21:20 +0530319
Nabin Haitcccc45e2016-10-05 17:15:43 +0530320 def set_missing_item_details(self, for_validate=False):
Anand Doshi3543f302013-05-24 19:25:01 +0530321 """set missing item values"""
Nabin Haitf37d43d2017-07-18 12:14:42 +0530322 from erpnext.stock.doctype.serial_no.serial_no import get_serial_nos
Rushabh Mehtab46069d2016-01-15 16:59:26 +0530323
Nabin Haitdd38a262014-12-26 13:15:21 +0530324 if hasattr(self, "items"):
Nabin Hait444f9562014-06-20 15:59:49 +0530325 parent_dict = {}
Pratik Vyasf7daab72014-04-10 17:53:30 +0530326 for fieldname in self.meta.get_valid_columns():
327 parent_dict[fieldname] = self.get(fieldname)
328
mbauskara52472c2016-03-05 15:10:25 +0530329 if self.doctype in ["Quotation", "Sales Order", "Delivery Note", "Sales Invoice"]:
330 document_type = "{} Item".format(self.doctype)
mbauskarc97becb2016-01-18 16:28:21 +0530331 parent_dict.update({"document_type": document_type})
332
Nabin Hait34c551d2019-07-03 10:34:31 +0530333 # party_name field used for customer in quotation
334 if self.doctype == "Quotation" and self.quotation_to == "Customer" and parent_dict.get("party_name"):
335 parent_dict.update({"customer": parent_dict.get("party_name")})
336
Rohit Waghchaurea248dfb2020-07-16 17:27:26 +0530337 self.pricing_rules = []
Nabin Haitdd38a262014-12-26 13:15:21 +0530338 for item in self.get("items"):
Rushabh Mehtaf14b8092014-04-03 14:30:42 +0530339 if item.get("item_code"):
Nabin Hait444f9562014-06-20 15:59:49 +0530340 args = parent_dict.copy()
341 args.update(item.as_dict())
Rushabh Mehtab46069d2016-01-15 16:59:26 +0530342
Nabin Hait34d28222016-01-19 15:45:49 +0530343 args["doctype"] = self.doctype
344 args["name"] = self.name
Rohit Waghchaure8bfe3302019-03-18 14:34:19 +0530345 args["child_docname"] = item.name
Saqibac9e6ff2021-01-28 17:58:55 +0530346 args["ignore_pricing_rule"] = self.ignore_pricing_rule if hasattr(self, 'ignore_pricing_rule') else 0
Rushabh Mehtab46069d2016-01-15 16:59:26 +0530347
Nabin Haite2f054c2015-03-09 14:54:37 +0530348 if not args.get("transaction_date"):
349 args["transaction_date"] = args.get("posting_date")
Anand Doshi2b2b6392015-03-20 14:18:09 +0530350
351 if self.get("is_subcontracted"):
352 args["is_subcontracted"] = self.is_subcontracted
Rohit Waghchaure8bfe3302019-03-18 14:34:19 +0530353
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530354 ret = get_item_details(args, self, for_validate=True, overwrite_warehouse=False)
Rohit Waghchaure8bfe3302019-03-18 14:34:19 +0530355
Rushabh Mehtaf14b8092014-04-03 14:30:42 +0530356 for fieldname, value in ret.items():
Anand Doshi602e8252015-11-16 19:05:46 +0530357 if item.meta.get_field(fieldname) and value is not None:
358 if (item.get(fieldname) is None or fieldname in force_item_fields):
Rushabh Mehtaf14b8092014-04-03 14:30:42 +0530359 item.set(fieldname, value)
Anand Doshid2946502014-04-08 20:10:03 +0530360
Rohit Waghchauredc981dc2017-04-03 14:17:08 +0530361 elif fieldname in ['cost_center', 'conversion_factor'] and not item.get(fieldname):
Anand Doshi602e8252015-11-16 19:05:46 +0530362 item.set(fieldname, value)
363
Rohit Waghchauredc981dc2017-04-03 14:17:08 +0530364 elif fieldname == "serial_no":
Alchez9155e402018-07-09 16:57:42 +0530365 # Ensure that serial numbers are matched against Stock UOM
366 item_conversion_factor = item.get("conversion_factor") or 1.0
367 item_qty = abs(item.get("qty")) * item_conversion_factor
Alchez8f2a0f32018-07-06 14:36:52 +0530368
369 if item_qty != len(get_serial_nos(item.get('serial_no'))):
Rohit Waghchauredc981dc2017-04-03 14:17:08 +0530370 item.set(fieldname, value)
Nabin Haita74468b2014-12-30 18:33:52 +0530371
Rohit Waghchauref6f503a2018-12-19 15:06:44 +0530372 if self.doctype in ["Purchase Invoice", "Sales Invoice"] and item.meta.get_field('is_fixed_asset'):
373 item.set('is_fixed_asset', ret.get('is_fixed_asset', 0))
374
Deepesh Garga60c3082021-05-11 16:38:33 +0530375 # Double check for cost center
376 # Items add via promotional scheme may not have cost center set
377 if hasattr(item, 'cost_center') and not item.get('cost_center'):
378 item.set('cost_center', self.get('cost_center') or erpnext.get_default_cost_center(self.company))
379
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530380 if ret.get("pricing_rules"):
381 self.apply_pricing_rule_on_items(item, ret)
Rohit Waghchaurea248dfb2020-07-16 17:27:26 +0530382 self.set_pricing_rule_details(item, ret)
Rushabh Mehtab46069d2016-01-15 16:59:26 +0530383
Nabin Hait14aa9c52016-04-18 15:54:01 +0530384 if self.doctype == "Purchase Invoice":
Nabin Haitcccc45e2016-10-05 17:15:43 +0530385 self.set_expense_account(for_validate)
Nabin Haita3dd72a2014-05-28 12:49:20 +0530386
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530387 def apply_pricing_rule_on_items(self, item, pricing_rule_args):
388 if not pricing_rule_args.get("validate_applied_rule", 0):
389 # if user changed the discount percentage then set user's discount percentage ?
390 if pricing_rule_args.get("price_or_product_discount") == 'Price':
391 item.set("pricing_rules", pricing_rule_args.get("pricing_rules"))
392 item.set("discount_percentage", pricing_rule_args.get("discount_percentage"))
393 item.set("discount_amount", pricing_rule_args.get("discount_amount"))
394 if pricing_rule_args.get("pricing_rule_for") == "Rate":
395 item.set("price_list_rate", pricing_rule_args.get("price_list_rate"))
396
397 if item.get("price_list_rate"):
398 item.rate = flt(item.price_list_rate *
399 (1.0 - (flt(item.discount_percentage) / 100.0)), item.precision("rate"))
400
401 if item.get('discount_amount'):
402 item.rate = item.price_list_rate - item.discount_amount
403
Rohit Waghchaurea248dfb2020-07-16 17:27:26 +0530404 if item.get("apply_discount_on_discounted_rate") and pricing_rule_args.get("rate"):
405 item.rate = pricing_rule_args.get("rate")
406
Rohit Waghchaure21fe97e2019-12-13 16:18:38 +0530407 elif pricing_rule_args.get('free_item_data'):
408 apply_pricing_rule_for_free_items(self, pricing_rule_args.get('free_item_data'))
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530409
410 elif pricing_rule_args.get("validate_applied_rule"):
Rushabh Mehtaff5d1962020-08-25 11:59:57 +0530411 for pricing_rule in get_applied_pricing_rules(item.get('pricing_rules')):
rohitwaghchaurea85ddf22019-11-19 18:47:48 +0530412 pricing_rule_doc = frappe.get_cached_doc("Pricing Rule", pricing_rule)
413 for field in ['discount_percentage', 'discount_amount', 'rate']:
414 if item.get(field) < pricing_rule_doc.get(field):
415 title = get_link_to_form("Pricing Rule", pricing_rule)
416
417 frappe.msgprint(_("Row {0}: user has not applied the rule {1} on the item {2}")
418 .format(item.idx, frappe.bold(title), frappe.bold(item.item_code)))
419
Rohit Waghchaurea248dfb2020-07-16 17:27:26 +0530420 def set_pricing_rule_details(self, item_row, args):
421 pricing_rules = get_applied_pricing_rules(args.get("pricing_rules"))
422 if not pricing_rules: return
423
424 for pricing_rule in pricing_rules:
425 self.append("pricing_rules", {
426 "pricing_rule": pricing_rule,
427 "item_code": item_row.item_code,
428 "child_docname": item_row.name,
429 "rule_applied": True
430 })
431
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530432 def set_taxes(self):
433 if not self.meta.get_field("taxes"):
Anand Doshi3543f302013-05-24 19:25:01 +0530434 return
Anand Doshid2946502014-04-08 20:10:03 +0530435
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530436 tax_master_doctype = self.meta.get_field("taxes_and_charges").options
Anand Doshid2946502014-04-08 20:10:03 +0530437
rohitwaghchaure57914f12018-04-24 19:19:47 +0530438 if (self.is_new() or self.is_pos_profile_changed()) and not self.get("taxes"):
rohitwaghchaure505661b2017-12-11 14:52:28 +0530439 if self.company and not self.get("taxes_and_charges"):
Anand Doshi3543f302013-05-24 19:25:01 +0530440 # get the default tax master
rohitwaghchaure505661b2017-12-11 14:52:28 +0530441 self.taxes_and_charges = frappe.db.get_value(tax_master_doctype,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800442 {"is_default": 1, 'company': self.company})
Anand Doshid2946502014-04-08 20:10:03 +0530443
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530444 self.append_taxes_from_master(tax_master_doctype)
Anand Doshid2946502014-04-08 20:10:03 +0530445
rohitwaghchaure57914f12018-04-24 19:19:47 +0530446 def is_pos_profile_changed(self):
447 if (self.doctype == 'Sales Invoice' and self.is_pos and
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800448 self.pos_profile != frappe.db.get_value('Sales Invoice', self.name, 'pos_profile')):
rohitwaghchaure57914f12018-04-24 19:19:47 +0530449 return True
450
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530451 def append_taxes_from_master(self, tax_master_doctype=None):
452 if self.get("taxes_and_charges"):
Anand Doshi99100a42013-07-04 17:13:53 +0530453 if not tax_master_doctype:
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530454 tax_master_doctype = self.meta.get_field("taxes_and_charges").options
Anand Doshid2946502014-04-08 20:10:03 +0530455
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530456 self.extend("taxes", get_taxes_and_charges(tax_master_doctype, self.get("taxes_and_charges")))
Akhilesh Darjee4cdb7992014-01-30 13:56:57 +0530457
Anand Doshiac32bad2014-04-18 01:30:14 +0530458 def set_other_charges(self):
Nabin Haite7d15362014-12-25 16:01:55 +0530459 self.set("taxes", [])
Nabin Haitffc7f3f2015-05-12 15:07:02 +0530460 self.set_taxes()
Anand Doshid2946502014-04-08 20:10:03 +0530461
ankitjavalkarwork6c29d872014-10-06 13:20:53 +0530462 def validate_enabled_taxes_and_charges(self):
463 taxes_and_charges_doctype = self.meta.get_options("taxes_and_charges")
464 if frappe.db.get_value(taxes_and_charges_doctype, self.taxes_and_charges, "disabled"):
465 frappe.throw(_("{0} '{1}' is disabled").format(taxes_and_charges_doctype, self.taxes_and_charges))
466
Nabin Haita2426fc2018-01-15 17:45:46 +0530467 def validate_tax_account_company(self):
468 for d in self.get("taxes"):
469 if d.account_head:
470 tax_account_company = frappe.db.get_value("Account", d.account_head, "company")
471 if tax_account_company != self.company:
472 frappe.throw(_("Row #{0}: Account {1} does not belong to company {2}")
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800473 .format(d.idx, d.account_head, self.company))
Nabin Haita2426fc2018-01-15 17:45:46 +0530474
deepeshgarg0073d11ac02019-05-19 00:02:01 +0530475 def get_gl_dict(self, args, account_currency=None, item=None):
Nabin Hait2df4d542013-01-29 11:34:39 +0530476 """this method populates the common properties of a gl entry record"""
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +0530477
Rohit Waghchaureaa7b4342018-05-11 01:56:05 +0530478 posting_date = args.get('posting_date') or self.get('posting_date')
479 fiscal_years = get_fiscal_years(posting_date, company=self.company)
Nabin Hait2ed0b592016-03-29 13:14:17 +0530480 if len(fiscal_years) > 1:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800481 frappe.throw(_("Multiple fiscal years exist for the date {0}. Please set company in Fiscal Year").format(
482 formatdate(posting_date)))
Nabin Hait2ed0b592016-03-29 13:14:17 +0530483 else:
484 fiscal_year = fiscal_years[0][0]
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +0530485
Rushabh Mehta793ba6b2014-02-14 15:47:51 +0530486 gl_dict = frappe._dict({
Anand Doshid2946502014-04-08 20:10:03 +0530487 'company': self.company,
Rohit Waghchaureaa7b4342018-05-11 01:56:05 +0530488 'posting_date': posting_date,
Nabin Hait2ed0b592016-03-29 13:14:17 +0530489 'fiscal_year': fiscal_year,
Anand Doshif78d1ae2014-03-28 13:55:00 +0530490 'voucher_type': self.doctype,
491 'voucher_no': self.name,
Nabin Hait5cd04a62019-05-27 11:44:06 +0530492 'remarks': self.get("remarks") or self.get("remark"),
Nabin Hait2df4d542013-01-29 11:34:39 +0530493 'debit': 0,
494 'credit': 0,
Nabin Hait46bcbaf2015-08-19 13:49:10 +0530495 'debit_in_account_currency': 0,
496 'credit_in_account_currency': 0,
Anand Doshif78d1ae2014-03-28 13:55:00 +0530497 'is_opening': self.get("is_opening") or "No",
Nabin Hait32251022014-08-29 11:18:32 +0530498 'party_type': None,
Nabin Hait591a5ab2016-05-26 17:41:39 +0530499 'party': None,
500 'project': self.get("project")
Nabin Hait2e296fa2013-08-28 18:53:11 +0530501 })
deepeshgarg007d83cf652019-05-12 18:34:23 +0530502
503 accounting_dimensions = get_accounting_dimensions()
504 dimension_dict = frappe._dict()
505
506 for dimension in accounting_dimensions:
507 dimension_dict[dimension] = self.get(dimension)
deepeshgarg0073d11ac02019-05-19 00:02:01 +0530508 if item and item.get(dimension):
509 dimension_dict[dimension] = item.get(dimension)
deepeshgarg007d83cf652019-05-12 18:34:23 +0530510
511 gl_dict.update(dimension_dict)
Nabin Hait2df4d542013-01-29 11:34:39 +0530512 gl_dict.update(args)
Anand Doshi979326b2015-09-11 16:22:37 +0530513
Nabin Hait895029d2015-08-20 14:55:39 +0530514 if not account_currency:
Anand Doshicd0989e2015-09-28 13:31:17 +0530515 account_currency = get_account_currency(gl_dict.account)
Anand Doshi979326b2015-09-11 16:22:37 +0530516
Rushabh Mehtabc4e2cd2017-10-17 12:30:34 +0530517 if gl_dict.account and self.doctype not in ["Journal Entry",
Deepesh Gargbfc17e42020-12-25 18:34:39 +0530518 "Period Closing Voucher", "Payment Entry", "Purchase Receipt", "Purchase Invoice", "Stock Entry"]:
Anand Doshibe6cfdd2015-09-17 21:07:04 +0530519 self.validate_account_currency(gl_dict.account, account_currency)
Deepesh Garg7c300852020-12-26 20:14:51 +0530520
521 if gl_dict.account and self.doctype not in ["Journal Entry", "Period Closing Voucher", "Payment Entry"]:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800522 set_balance_in_account_currency(gl_dict, account_currency, self.get("conversion_rate"),
523 self.company_currency)
Anand Doshi979326b2015-09-11 16:22:37 +0530524
Nabin Haitc561a492015-08-19 19:22:34 +0530525 return gl_dict
Anand Doshi979326b2015-09-11 16:22:37 +0530526
Anurag Mishrae657fe82018-11-26 15:19:17 +0530527 def validate_qty_is_not_zero(self):
Maricac68a9402019-12-03 12:59:22 +0530528 if self.doctype != "Purchase Receipt":
529 for item in self.items:
530 if not item.qty:
531 frappe.throw(_("Item quantity can not be zero"))
Anurag Mishrae657fe82018-11-26 15:19:17 +0530532
Nabin Hait895029d2015-08-20 14:55:39 +0530533 def validate_account_currency(self, account, account_currency=None):
Nabin Hait6e439a52015-08-28 19:24:22 +0530534 valid_currency = [self.company_currency]
535 if self.get("currency") and self.currency != self.company_currency:
536 valid_currency.append(self.currency)
537
Nabin Hait895029d2015-08-20 14:55:39 +0530538 if account_currency not in valid_currency:
Nabin Hait4ffd7f32015-08-27 12:28:36 +0530539 frappe.throw(_("Account {0} is invalid. Account Currency must be {1}")
Suraj Shettyda6806e2020-04-08 09:32:41 +0530540 .format(account, (' ' + _("or") + ' ').join(valid_currency)))
Anand Doshi979326b2015-09-11 16:22:37 +0530541
Anand Doshi613cb6a2013-02-06 17:33:46 +0530542 def clear_unallocated_advances(self, childtype, parentfield):
Rushabh Mehtaf191f852014-04-02 18:09:34 +0530543 self.set(parentfield, self.get(parentfield, {"allocated_amount": ["not in", [0, None, ""]]}))
544
Anand Doshid2946502014-04-08 20:10:03 +0530545 frappe.db.sql("""delete from `tab%s` where parentfield=%s and parent = %s
Anand Doshi602e8252015-11-16 19:05:46 +0530546 and allocated_amount = 0""" % (childtype, '%s', '%s'), (parentfield, self.name))
Anand Doshid2946502014-04-08 20:10:03 +0530547
Walstan Baptistad6360752021-03-31 12:30:32 +0530548 @frappe.whitelist()
Rushabh Mehta30dc9a12017-11-17 14:31:09 +0530549 def apply_shipping_rule(self):
550 if self.shipping_rule:
551 shipping_rule = frappe.get_doc("Shipping Rule", self.shipping_rule)
552 shipping_rule.apply(self)
553 self.calculate_taxes_and_totals()
554
555 def get_shipping_address(self):
556 '''Returns Address object from shipping address fields if present'''
557
558 # shipping address fields can be `shipping_address_name` or `shipping_address`
559 # try getting value from both
560
561 for fieldname in ('shipping_address_name', 'shipping_address'):
562 shipping_field = self.meta.get_field(fieldname)
563 if shipping_field and shipping_field.fieldtype == 'Link':
564 if self.get(fieldname):
565 return frappe.get_doc('Address', self.get(fieldname))
566
567 return {}
568
Walstan Baptistad6360752021-03-31 12:30:32 +0530569 @frappe.whitelist()
Nabin Hait041a5c22018-08-01 18:07:39 +0530570 def set_advances(self):
571 """Returns list of advances against Account, Party, Reference"""
572
573 res = self.get_advance_entries()
574
575 self.set("advances", [])
576 advance_allocated = 0
577 for d in res:
578 if d.against_order:
579 allocated_amount = flt(d.amount)
580 else:
Deepesh Garg26210162020-08-11 16:06:13 +0530581 if self.get('party_account_currency') == self.company_currency:
582 amount = self.get('base_rounded_total') or self.base_grand_total
583 else:
584 amount = self.get('rounded_total') or self.grand_total
585
Rohit Waghchaure6cc2f522018-11-27 12:07:03 +0530586 allocated_amount = min(amount - advance_allocated, d.amount)
Nabin Hait041a5c22018-08-01 18:07:39 +0530587 advance_allocated += flt(allocated_amount)
Rushabh Mehta708e47a2018-08-08 16:37:31 +0530588
Saqib7fb64d12021-07-12 18:33:16 +0530589 advance_row = {
Nabin Hait041a5c22018-08-01 18:07:39 +0530590 "doctype": self.doctype + " Advance",
591 "reference_type": d.reference_type,
592 "reference_name": d.reference_name,
593 "reference_row": d.reference_row,
594 "remarks": d.remarks,
595 "advance_amount": flt(d.amount),
Saqib7fb64d12021-07-12 18:33:16 +0530596 "allocated_amount": allocated_amount,
597 "ref_exchange_rate": flt(d.exchange_rate) # exchange_rate of advance entry
598 }
599
600 self.append("advances", advance_row)
Nabin Hait041a5c22018-08-01 18:07:39 +0530601
Nabin Hait28a05282016-06-27 17:41:39 +0530602 def get_advance_entries(self, include_unallocated=True):
603 if self.doctype == "Sales Invoice":
604 party_account = self.debit_to
605 party_type = "Customer"
606 party = self.customer
607 amount_field = "credit_in_account_currency"
608 order_field = "sales_order"
609 order_doctype = "Sales Order"
610 else:
611 party_account = self.credit_to
612 party_type = "Supplier"
613 party = self.supplier
614 amount_field = "debit_in_account_currency"
615 order_field = "purchase_order"
616 order_doctype = "Purchase Order"
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530617
Ankush Menata9c84f72021-06-11 16:00:48 +0530618 order_list = list(set(d.get(order_field)
619 for d in self.get("items") if d.get(order_field)))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530620
621 journal_entries = get_advance_journal_entries(party_type, party, party_account,
Nabin Hait868766d2019-07-15 18:02:58 +0530622 amount_field, order_doctype, order_list, include_unallocated)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530623
624 payment_entries = get_advance_payment_entries(party_type, party, party_account,
Nabin Hait868766d2019-07-15 18:02:58 +0530625 order_doctype, order_list, include_unallocated)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530626
Nabin Hait28a05282016-06-27 17:41:39 +0530627 res = journal_entries + payment_entries
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530628
Nabin Hait28a05282016-06-27 17:41:39 +0530629 return res
Nabin Hait48f5fa62014-09-18 15:03:54 +0530630
rohitwaghchaurebf4c1142018-01-08 15:20:15 +0530631 def is_inclusive_tax(self):
Nabin Hait868766d2019-07-15 18:02:58 +0530632 is_inclusive = cint(frappe.db.get_single_value("Accounts Settings", "show_inclusive_tax_in_print"))
rohitwaghchaurebf4c1142018-01-08 15:20:15 +0530633
634 if is_inclusive:
635 is_inclusive = 0
636 if self.get("taxes", filters={"included_in_print_rate": 1}):
637 is_inclusive = 1
638
639 return is_inclusive
640
Nabin Hait28a05282016-06-27 17:41:39 +0530641 def validate_advance_entries(self):
Nabin Hait05aefbb2016-06-28 19:42:19 +0530642 order_field = "sales_order" if self.doctype == "Sales Invoice" else "purchase_order"
Ankush Menata9c84f72021-06-11 16:00:48 +0530643 order_list = list(set(d.get(order_field)
644 for d in self.get("items") if d.get(order_field)))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530645
Nabin Hait05aefbb2016-06-28 19:42:19 +0530646 if not order_list: return
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530647
Nabin Hait28a05282016-06-27 17:41:39 +0530648 advance_entries = self.get_advance_entries(include_unallocated=False)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530649
Nabin Hait28a05282016-06-27 17:41:39 +0530650 if advance_entries:
651 advance_entries_against_si = [d.reference_name for d in self.get("advances")]
652 for d in advance_entries:
653 if not advance_entries_against_si or d.reference_name not in advance_entries_against_si:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800654 frappe.msgprint(_(
655 "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 +0530656 .format(d.reference_name, d.against_order))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530657
Saqib7fb64d12021-07-12 18:33:16 +0530658 def set_advance_gain_or_loss(self):
659 if not self.get("advances"):
660 return
661
662 for d in self.get("advances"):
663 advance_exchange_rate = d.ref_exchange_rate
664 if (d.allocated_amount and self.conversion_rate != 1
665 and self.conversion_rate != advance_exchange_rate):
666
667 base_allocated_amount_in_ref_rate = advance_exchange_rate * d.allocated_amount
668 base_allocated_amount_in_inv_rate = self.conversion_rate * d.allocated_amount
669 difference = base_allocated_amount_in_ref_rate - base_allocated_amount_in_inv_rate
670
671 d.exchange_gain_loss = difference
672
673 def make_exchange_gain_loss_gl_entries(self, gl_entries):
674 if self.get('doctype') in ['Purchase Invoice', 'Sales Invoice']:
675 for d in self.get("advances"):
676 if d.exchange_gain_loss:
Saqib2d6f2fe2021-07-30 10:55:53 +0530677 is_purchase_invoice = self.get('doctype') == 'Purchase Invoice'
678 party = self.supplier if is_purchase_invoice else self.customer
679 party_account = self.credit_to if is_purchase_invoice else self.debit_to
680 party_type = "Supplier" if is_purchase_invoice else "Customer"
Saqib7fb64d12021-07-12 18:33:16 +0530681
682 gain_loss_account = frappe.db.get_value('Company', self.company, 'exchange_gain_loss_account')
Saqib2d6f2fe2021-07-30 10:55:53 +0530683 if not gain_loss_account:
684 frappe.throw(_("Please set Default Exchange Gain/Loss Account in Company {}")
685 .format(self.get('company')))
Saqib7fb64d12021-07-12 18:33:16 +0530686 account_currency = get_account_currency(gain_loss_account)
687 if account_currency != self.company_currency:
Saqib2d6f2fe2021-07-30 10:55:53 +0530688 frappe.throw(_("Currency for {0} must be {1}").format(gain_loss_account, self.company_currency))
Saqib7fb64d12021-07-12 18:33:16 +0530689
690 # for purchase
691 dr_or_cr = 'debit' if d.exchange_gain_loss > 0 else 'credit'
Saqib2d6f2fe2021-07-30 10:55:53 +0530692 if not is_purchase_invoice:
693 # just reverse for sales?
694 dr_or_cr = 'debit' if dr_or_cr == 'credit' else 'credit'
Saqib7fb64d12021-07-12 18:33:16 +0530695
696 gl_entries.append(
697 self.get_gl_dict({
698 "account": gain_loss_account,
699 "account_currency": account_currency,
700 "against": party,
701 dr_or_cr + "_in_account_currency": abs(d.exchange_gain_loss),
702 dr_or_cr: abs(d.exchange_gain_loss),
703 "cost_center": self.cost_center,
704 "project": self.project
705 }, item=d)
706 )
707
708 dr_or_cr = 'debit' if dr_or_cr == 'credit' else 'credit'
709
710 gl_entries.append(
711 self.get_gl_dict({
712 "account": party_account,
713 "party_type": party_type,
714 "party": party,
715 "against": gain_loss_account,
716 dr_or_cr + "_in_account_currency": flt(abs(d.exchange_gain_loss) / self.conversion_rate),
717 dr_or_cr: abs(d.exchange_gain_loss),
718 "cost_center": self.cost_center,
719 "project": self.project
720 }, self.party_account_currency, item=self)
721 )
722
Nabin Hait28a05282016-06-27 17:41:39 +0530723 def update_against_document_in_jv(self):
724 """
725 Links invoice and advance voucher:
726 1. cancel advance voucher
727 2. split into multiple rows if partially adjusted, assign against voucher
728 3. submit advance voucher
729 """
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530730
Nabin Hait28a05282016-06-27 17:41:39 +0530731 if self.doctype == "Sales Invoice":
Nabin Haitff2f3ef2016-07-04 11:41:14 +0530732 party_type = "Customer"
Nabin Hait28a05282016-06-27 17:41:39 +0530733 party = self.customer
734 party_account = self.debit_to
735 dr_or_cr = "credit_in_account_currency"
736 else:
Nabin Haitff2f3ef2016-07-04 11:41:14 +0530737 party_type = "Supplier"
Nabin Hait28a05282016-06-27 17:41:39 +0530738 party = self.supplier
739 party_account = self.credit_to
740 dr_or_cr = "debit_in_account_currency"
Nabin Hait48f5fa62014-09-18 15:03:54 +0530741
Nabin Hait28a05282016-06-27 17:41:39 +0530742 lst = []
743 for d in self.get('advances'):
744 if flt(d.allocated_amount) > 0:
745 args = frappe._dict({
746 'voucher_type': d.reference_type,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800747 'voucher_no': d.reference_name,
748 'voucher_detail_no': d.reference_row,
749 'against_voucher_type': self.doctype,
750 'against_voucher': self.name,
751 'account': party_account,
Nabin Haitff2f3ef2016-07-04 11:41:14 +0530752 'party_type': party_type,
Nabin Hait28a05282016-06-27 17:41:39 +0530753 'party': party,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800754 'is_advance': 'Yes',
755 'dr_or_cr': dr_or_cr,
756 'unadjusted_amount': flt(d.advance_amount),
757 'allocated_amount': flt(d.allocated_amount),
Deepesh Gargf54d5962021-03-31 14:06:02 +0530758 'precision': d.precision('advance_amount'),
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530759 'exchange_rate': (self.conversion_rate
Nabin Hait868766d2019-07-15 18:02:58 +0530760 if self.party_account_currency != self.company_currency else 1),
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530761 'grand_total': (self.base_grand_total
Nabin Hait868766d2019-07-15 18:02:58 +0530762 if self.party_account_currency == self.company_currency else self.grand_total),
Saqib7fb64d12021-07-12 18:33:16 +0530763 'outstanding_amount': self.outstanding_amount,
764 'difference_account': frappe.db.get_value('Company', self.company, 'exchange_gain_loss_account'),
765 'exchange_gain_loss': flt(d.get('exchange_gain_loss'))
Nabin Hait28a05282016-06-27 17:41:39 +0530766 })
767 lst.append(args)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530768
Nabin Hait28a05282016-06-27 17:41:39 +0530769 if lst:
770 from erpnext.accounts.utils import reconcile_against_document
771 reconcile_against_document(lst)
Anand Doshid2946502014-04-08 20:10:03 +0530772
Rohit Waghchaure5fa9a7a2019-04-01 00:40:38 +0530773 def on_cancel(self):
774 from erpnext.accounts.utils import unlink_ref_doc_from_payment_entries
775
776 if self.doctype in ["Sales Invoice", "Purchase Invoice"]:
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530777 self.update_allocated_advance_taxes_on_cancel()
Rohit Waghchaure5fa9a7a2019-04-01 00:40:38 +0530778 if frappe.db.get_single_value('Accounts Settings', 'unlink_payment_on_cancellation_of_invoice'):
779 unlink_ref_doc_from_payment_entries(self)
780
781 elif self.doctype in ["Sales Order", "Purchase Order"]:
Rohit Waghchaure9835c892019-04-01 01:02:06 +0530782 if frappe.db.get_single_value('Accounts Settings', 'unlink_advance_payment_on_cancelation_of_order'):
Rohit Waghchaure5fa9a7a2019-04-01 00:40:38 +0530783 unlink_ref_doc_from_payment_entries(self)
784
Deepesh Gargd18dde72020-11-29 21:40:04 +0530785 def get_tax_map(self):
786 tax_map = {}
787 for tax in self.get('taxes'):
788 tax_map.setdefault(tax.account_head, 0.0)
789 tax_map[tax.account_head] += tax.tax_amount
790
791 return tax_map
792
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530793 def update_allocated_advance_taxes_on_cancel(self):
Deepesh Gargd18dde72020-11-29 21:40:04 +0530794 if self.get('advances'):
795 tax_accounts = [d.account_head for d in self.get('taxes')]
796 allocated_tax_map = frappe._dict(frappe.get_all('GL Entry', fields=['account', 'sum(credit - debit)'],
797 filters={'voucher_no': self.name, 'account': ('in', tax_accounts)},
798 group_by='account', as_list=1))
799
800 tax_map = self.get_tax_map()
801
802 for pe in self.get('advances'):
Deepesh Garga23aaf42021-05-17 20:58:50 +0530803 if pe.reference_type == 'Payment Entry':
804 pe = frappe.get_doc('Payment Entry', pe.reference_name)
805 for tax in pe.get('taxes'):
806 allocated_amount = tax_map.get(tax.account_head) - allocated_tax_map.get(tax.account_head)
807 if allocated_amount > tax.tax_amount:
808 allocated_amount = tax.tax_amount
Deepesh Gargd18dde72020-11-29 21:40:04 +0530809
Deepesh Garga23aaf42021-05-17 20:58:50 +0530810 if allocated_amount:
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530811 frappe.db.set_value('Advance Taxes and Charges', tax.name, 'allocated_amount',
812 tax.allocated_amount - allocated_amount)
Deepesh Garga23aaf42021-05-17 20:58:50 +0530813 tax_map[tax.account_head] -= allocated_amount
814 allocated_tax_map[tax.account_head] -= allocated_amount
Deepesh Gargd18dde72020-11-29 21:40:04 +0530815
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530816 def allocate_advance_taxes(self, gl_entries):
817 tax_map = self.get_tax_map()
818 for pe in self.get("advances"):
Deepesh Garg911818a2021-06-09 22:55:10 +0530819 if pe.reference_type == "Payment Entry" and \
820 frappe.db.get_value('Payment Entry', pe.reference_name, 'advance_tax_account'):
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530821 pe = frappe.get_doc("Payment Entry", pe.reference_name)
822 for tax in pe.get("taxes"):
823 account_currency = get_account_currency(tax.account_head)
824
825 if self.doctype == "Purchase Invoice":
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530826 dr_or_cr = "debit" if tax.add_deduct_tax == "Add" else "credit"
827 rev_dr_cr = "credit" if tax.add_deduct_tax == "Add" else "debit"
Deepesh Garg4a2e4742021-07-13 11:22:55 +0530828 else:
829 dr_or_cr = "credit" if tax.add_deduct_tax == "Add" else "debit"
830 rev_dr_cr = "debit" if tax.add_deduct_tax == "Add" else "credit"
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530831
832 party = self.supplier if self.doctype == "Purchase Invoice" else self.customer
833 unallocated_amount = tax.tax_amount - tax.allocated_amount
834 if tax_map.get(tax.account_head):
835 amount = tax_map.get(tax.account_head)
836 if amount < unallocated_amount:
837 unallocated_amount = amount
838
839 gl_entries.append(
840 self.get_gl_dict({
841 "account": tax.account_head,
842 "against": party,
843 dr_or_cr: unallocated_amount,
844 dr_or_cr + "_in_account_currency": unallocated_amount
845 if account_currency==self.company_currency
846 else unallocated_amount,
847 "cost_center": tax.cost_center
848 }, account_currency, item=tax))
849
850 gl_entries.append(
851 self.get_gl_dict({
852 "account": pe.advance_tax_account,
853 "against": party,
854 rev_dr_cr: unallocated_amount,
855 rev_dr_cr + "_in_account_currency": unallocated_amount
856 if account_currency==self.company_currency
857 else unallocated_amount,
858 "cost_center": tax.cost_center
859 }, account_currency, item=tax))
860
861 frappe.db.set_value("Advance Taxes and Charges", tax.name, "allocated_amount",
862 tax.allocated_amount + unallocated_amount)
863
864 tax_map[tax.account_head] -= unallocated_amount
865
Nabin Hait19d945a2013-07-29 18:35:39 +0530866 def validate_multiple_billing(self, ref_dt, item_ref_dn, based_on, parentfield):
Nabin Hait868766d2019-07-15 18:02:58 +0530867 from erpnext.controllers.status_updater import get_allowance_for
868 item_allowance = {}
869 global_qty_allowance, global_amount_allowance = None, None
Anand Doshid2946502014-04-08 20:10:03 +0530870
Nabin Hait4b8185d2014-12-25 18:19:39 +0530871 for item in self.get("items"):
Anand Doshif78d1ae2014-03-28 13:55:00 +0530872 if item.get(item_ref_dn):
Anand Doshid2946502014-04-08 20:10:03 +0530873 ref_amt = flt(frappe.db.get_value(ref_dt + " Item",
Nabin Hait868766d2019-07-15 18:02:58 +0530874 item.get(item_ref_dn), based_on), self.precision(based_on, item))
Nabin Haitdc15b4f2014-01-20 16:48:49 +0530875 if not ref_amt:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800876 frappe.msgprint(
Nabin Hait868766d2019-07-15 18:02:58 +0530877 _("Warning: System will not check overbilling since amount for Item {0} in {1} is zero")
878 .format(item.item_code, ref_dt))
Nabin Haitdc15b4f2014-01-20 16:48:49 +0530879 else:
Nabin Hait868766d2019-07-15 18:02:58 +0530880 already_billed = frappe.db.sql("""
881 select sum(%s)
882 from `tab%s`
883 where %s=%s and docstatus=1 and parent != %s
884 """ % (based_on, self.doctype + " Item", item_ref_dn, '%s', '%s'),
885 (item.get(item_ref_dn), self.name))[0][0]
Anand Doshid2946502014-04-08 20:10:03 +0530886
887 total_billed_amt = flt(flt(already_billed) + flt(item.get(based_on)),
Nabin Hait868766d2019-07-15 18:02:58 +0530888 self.precision(based_on, item))
Anand Doshid2946502014-04-08 20:10:03 +0530889
Nabin Hait868766d2019-07-15 18:02:58 +0530890 allowance, item_allowance, global_qty_allowance, global_amount_allowance = \
891 get_allowance_for(item.item_code, item_allowance, global_qty_allowance, global_amount_allowance, "amount")
Anand Doshid2946502014-04-08 20:10:03 +0530892
Nabin Hait868766d2019-07-15 18:02:58 +0530893 max_allowed_amt = flt(ref_amt * (100 + allowance) / 100)
Anand Doshid2946502014-04-08 20:10:03 +0530894
rohitwaghchaure285344e2019-10-11 11:02:11 +0530895 if total_billed_amt < 0 and max_allowed_amt < 0:
896 # while making debit note against purchase return entry(purchase receipt) getting overbill error
897 total_billed_amt = abs(total_billed_amt)
898 max_allowed_amt = abs(max_allowed_amt)
899
Deepesh Gargcb718fc2021-04-19 13:25:15 +0530900 role_allowed_to_over_bill = frappe.db.get_single_value('Accounts Settings', 'role_allowed_to_over_bill')
901
902 if total_billed_amt - max_allowed_amt > 0.01 and role_allowed_to_over_bill not in frappe.get_roles():
Afshan7fd44902021-06-24 14:26:36 +0530903 if self.doctype != "Purchase Invoice":
904 self.throw_overbill_exception(item, max_allowed_amt)
905 elif not cint(frappe.db.get_single_value("Buying Settings", "bill_for_rejected_quantity_in_purchase_invoice")):
906 self.throw_overbill_exception(item, max_allowed_amt)
907
908 def throw_overbill_exception(self, item, max_allowed_amt):
909 frappe.throw(_("Cannot overbill for Item {0} in row {1} more than {2}. To allow over-billing, please set allowance in Accounts Settings")
910 .format(item.item_code, item.idx, max_allowed_amt))
Anand Doshid2946502014-04-08 20:10:03 +0530911
Nabin Hait0fc24542013-03-25 11:06:00 +0530912 def get_company_default(self, fieldname):
Rushabh Mehta1f847992013-12-12 19:12:19 +0530913 from erpnext.accounts.utils import get_company_default
Anand Doshif78d1ae2014-03-28 13:55:00 +0530914 return get_company_default(self.company, fieldname)
Anand Doshid2946502014-04-08 20:10:03 +0530915
Nabin Haita36adbd2013-08-02 14:50:12 +0530916 def get_stock_items(self):
917 stock_items = []
Nabin Haitdd38a262014-12-26 13:15:21 +0530918 item_codes = list(set(item.item_code for item in self.get("items")))
Nabin Haita36adbd2013-08-02 14:50:12 +0530919 if item_codes:
Nabin Hait868766d2019-07-15 18:02:58 +0530920 stock_items = [r[0] for r in frappe.db.sql("""
921 select name from `tabItem`
922 where name in (%s) and is_stock_item=1
923 """ % (", ".join((["%s"] * len(item_codes))),), item_codes)]
Anand Doshid2946502014-04-08 20:10:03 +0530924
Nabin Haita36adbd2013-08-02 14:50:12 +0530925 return stock_items
Anand Doshid2946502014-04-08 20:10:03 +0530926
Ankit Javalkar8e7ca412014-09-12 15:18:53 +0530927 def set_total_advance_paid(self):
928 if self.doctype == "Sales Order":
Nabin Hait6e439a52015-08-28 19:24:22 +0530929 dr_or_cr = "credit_in_account_currency"
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +0530930 rev_dr_or_cr = "debit_in_account_currency"
Nabin Haitb2206d12016-01-27 15:43:12 +0530931 party = self.customer
Ankit Javalkar8e7ca412014-09-12 15:18:53 +0530932 else:
Nabin Hait6e439a52015-08-28 19:24:22 +0530933 dr_or_cr = "debit_in_account_currency"
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +0530934 rev_dr_or_cr = "credit_in_account_currency"
Nabin Haitb2206d12016-01-27 15:43:12 +0530935 party = self.supplier
Ankit Javalkar8e7ca412014-09-12 15:18:53 +0530936
Nabin Haitb2206d12016-01-27 15:43:12 +0530937 advance = frappe.db.sql("""
Ankit Javalkar8e7ca412014-09-12 15:18:53 +0530938 select
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +0530939 account_currency, sum({dr_or_cr}) - sum({rev_dr_cr}) as amount
Ankit Javalkar8e7ca412014-09-12 15:18:53 +0530940 from
Nabin Hait12e2a512016-06-26 01:37:21 +0530941 `tabGL Entry`
Ankit Javalkar8e7ca412014-09-12 15:18:53 +0530942 where
Nabin Hait12e2a512016-06-26 01:37:21 +0530943 against_voucher_type = %s and against_voucher = %s and party=%s
944 and docstatus = 1
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +0530945 """.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 +0530946
Nabin Haitb2206d12016-01-27 15:43:12 +0530947 if advance:
Anand Doshi7c0a58a2016-01-29 12:16:24 +0530948 advance = advance[0]
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +0530949
Anand Doshi7c0a58a2016-01-29 12:16:24 +0530950 advance_paid = flt(advance.amount, self.precision("advance_paid"))
951 formatted_advance_paid = fmt_money(advance_paid, precision=self.precision("advance_paid"),
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800952 currency=advance.account_currency)
Anand Doshi7c0a58a2016-01-29 12:16:24 +0530953
954 frappe.db.set_value(self.doctype, self.name, "party_account_currency",
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800955 advance.account_currency)
Anand Doshi7c0a58a2016-01-29 12:16:24 +0530956
957 if advance.account_currency == self.currency:
finbyz5efc7972019-01-05 11:12:11 +0530958 order_total = self.get("rounded_total") or self.grand_total
959 precision = "rounded_total" if self.get("rounded_total") else "grand_total"
Nabin Haitb2206d12016-01-27 15:43:12 +0530960 else:
finbyz5efc7972019-01-05 11:12:11 +0530961 order_total = self.get("base_rounded_total") or self.base_grand_total
962 precision = "base_rounded_total" if self.get("base_rounded_total") else "base_grand_total"
Sagar Voraf733a392019-01-07 14:24:01 +0530963
finbyz5efc7972019-01-05 11:12:11 +0530964 formatted_order_total = fmt_money(order_total, precision=self.precision(precision),
965 currency=advance.account_currency)
Anand Doshi7c0a58a2016-01-29 12:16:24 +0530966
Nabin Hait9db1b222016-06-30 12:37:53 +0530967 if self.currency == self.company_currency and advance_paid > order_total:
Nabin Haitb2206d12016-01-27 15:43:12 +0530968 frappe.throw(_("Total advance ({0}) against Order {1} cannot be greater than the Grand Total ({2})")
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800969 .format(formatted_advance_paid, self.name, formatted_order_total))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +0530970
Nabin Hait13093b42016-06-29 18:04:37 +0530971 frappe.db.set_value(self.doctype, self.name, "advance_paid", advance_paid)
Ankit Javalkar8e7ca412014-09-12 15:18:53 +0530972
ankitjavalkarworke60822b2014-08-26 14:29:06 +0530973 @property
974 def company_abbr(self):
Nabin Hait6a5695f2018-08-09 11:30:21 +0530975 if not hasattr(self, "_abbr"):
976 self._abbr = frappe.db.get_value('Company', self.company, "abbr")
ankitjavalkarworke60822b2014-08-26 14:29:06 +0530977
978 return self._abbr
979
marination4be5b5c2020-10-08 19:08:27 +0530980 def raise_missing_debit_credit_account_error(self, party_type, party):
marination53b1a9a2020-11-03 15:45:25 +0530981 """Raise an error if debit to/credit to account does not exist."""
marination4be5b5c2020-10-08 19:08:27 +0530982 db_or_cr = frappe.bold("Debit To") if self.doctype == "Sales Invoice" else frappe.bold("Credit To")
983 rec_or_pay = "Receivable" if self.doctype == "Sales Invoice" else "Payable"
984
985 link_to_party = frappe.utils.get_link_to_form(party_type, party)
986 link_to_company = frappe.utils.get_link_to_form("Company", self.company)
987
988 message = _("{0} Account not found against Customer {1}.").format(db_or_cr, frappe.bold(party) or '')
989 message += "<br>" + _("Please set one of the following:") + "<br>"
990 message += "<br><ul><li>" + _("'Account' in the Accounting section of Customer {0}").format(link_to_party) + "</li>"
991 message += "<li>" + _("'Default {0} Account' in Company {1}").format(rec_or_pay, link_to_company) + "</li></ul>"
992
marination53b1a9a2020-11-03 15:45:25 +0530993 frappe.throw(message, title=_("Account Missing"), exc=AccountMissingError)
marination4be5b5c2020-10-08 19:08:27 +0530994
Neil Trini Lasrado3fbbb712015-07-17 12:10:12 +0530995 def validate_party(self):
Nabin Hait4ffd7f32015-08-27 12:28:36 +0530996 party_type, party = self.get_party()
shreyaseba9ca42016-01-26 14:56:52 +0530997 validate_party_frozen_disabled(party_type, party)
Anand Doshi979326b2015-09-11 16:22:37 +0530998
Nabin Hait4ffd7f32015-08-27 12:28:36 +0530999 def get_party(self):
Neil Trini Lasrado79bf2332015-07-20 13:03:48 +05301000 party_type = None
shreyas29b565f2016-01-25 17:30:49 +05301001 if self.doctype in ("Opportunity", "Quotation", "Sales Order", "Delivery Note", "Sales Invoice"):
shreyaseba9ca42016-01-26 14:56:52 +05301002 party_type = 'Customer'
shreyas29b565f2016-01-25 17:30:49 +05301003
1004 elif self.doctype in ("Supplier Quotation", "Purchase Order", "Purchase Receipt", "Purchase Invoice"):
shreyaseba9ca42016-01-26 14:56:52 +05301005 party_type = 'Supplier'
shreyas29b565f2016-01-25 17:30:49 +05301006
1007 elif self.meta.get_field("customer"):
1008 party_type = "Customer"
Neil Trini Lasrado3fbbb712015-07-17 12:10:12 +05301009
Neil Trini Lasrado79bf2332015-07-20 13:03:48 +05301010 elif self.meta.get_field("supplier"):
shreyas29b565f2016-01-25 17:30:49 +05301011 party_type = "Supplier"
Anand Doshi979326b2015-09-11 16:22:37 +05301012
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301013 party = self.get(party_type.lower()) if party_type else None
Anand Doshi979326b2015-09-11 16:22:37 +05301014
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301015 return party_type, party
Anand Doshi979326b2015-09-11 16:22:37 +05301016
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301017 def validate_currency(self):
Nabin Hait6e439a52015-08-28 19:24:22 +05301018 if self.get("currency"):
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301019 party_type, party = self.get_party()
Nabin Hait6e439a52015-08-28 19:24:22 +05301020 if party_type and party:
Anand Doshib20baf82015-09-25 16:17:50 +05301021 party_account_currency = get_party_account_currency(party_type, party, self.company)
Anand Doshi979326b2015-09-11 16:22:37 +05301022
Anand Doshi7afaeb02015-10-01 18:55:25 +05301023 if (party_account_currency
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001024 and party_account_currency != self.company_currency
1025 and self.currency != party_account_currency):
Nabin Hait98096772015-09-03 10:28:08 +05301026 frappe.throw(_("Accounting Entry for {0}: {1} can only be made in currency: {2}")
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001027 .format(party_type, party, party_account_currency), InvalidCurrency)
Anand Doshi979326b2015-09-11 16:22:37 +05301028
shreyas29b565f2016-01-25 17:30:49 +05301029 # Note: not validating with gle account because we don't have the account
1030 # at quotation / sales order level and we shouldn't stop someone
1031 # from creating a sales invoice if sales order is already created
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +05301032
Nabin Hait297d74a2016-11-23 15:58:51 +05301033 def delink_advance_entries(self, linked_doc_name):
1034 total_allocated_amount = 0
1035 for adv in self.advances:
1036 consider_for_total_advance = True
1037 if adv.reference_name == linked_doc_name:
1038 frappe.db.sql("""delete from `tab{0} Advance`
1039 where name = %s""".format(self.doctype), adv.name)
1040 consider_for_total_advance = False
1041
1042 if consider_for_total_advance:
1043 total_allocated_amount += flt(adv.allocated_amount, adv.precision("allocated_amount"))
1044
Rushabh Mehta66958302017-01-16 16:57:53 +05301045 frappe.db.set_value(self.doctype, self.name, "total_advance",
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001046 total_allocated_amount, update_modified=False)
Rohit Waghchaure6087fe12016-04-09 14:31:09 +05301047
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301048 def group_similar_items(self):
1049 group_item_qty = {}
1050 group_item_amount = {}
Shreya Shah785f1aa2018-10-11 10:14:25 +05301051 # to update serial number in print
1052 count = 0
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301053
1054 for item in self.items:
1055 group_item_qty[item.item_code] = group_item_qty.get(item.item_code, 0) + item.qty
1056 group_item_amount[item.item_code] = group_item_amount.get(item.item_code, 0) + item.amount
1057
1058 duplicate_list = []
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301059 for item in self.items:
1060 if item.item_code in group_item_qty:
Shreya Shah785f1aa2018-10-11 10:14:25 +05301061 count += 1
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301062 item.qty = group_item_qty[item.item_code]
1063 item.amount = group_item_amount[item.item_code]
deepeshgarg007e8d21cd2019-06-24 17:46:44 +05301064
1065 if item.qty:
1066 item.rate = flt(flt(item.amount) / flt(item.qty), item.precision("rate"))
1067 else:
1068 item.rate = 0
1069
Shreya Shah785f1aa2018-10-11 10:14:25 +05301070 item.idx = count
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301071 del group_item_qty[item.item_code]
1072 else:
1073 duplicate_list.append(item)
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301074 for item in duplicate_list:
1075 self.remove(item)
1076
tunde32aa7c12017-09-07 06:52:15 +01001077 def set_payment_schedule(self):
Manas Solankia7f55892018-04-02 10:32:00 +05301078 if self.doctype == 'Sales Invoice' and self.is_pos:
1079 self.payment_terms_template = ''
1080 return
rohitwaghchauredb9fa782018-03-01 10:32:29 +05301081
Deepesh Garg26210162020-08-11 16:06:13 +05301082 party_account_currency = self.get('party_account_currency')
1083 if not party_account_currency:
1084 party_type, party = self.get_party()
1085
1086 if party_type and party:
1087 party_account_currency = get_party_account_currency(party_type, party, self.company)
1088
rohitwaghchaureda941af2018-01-17 16:23:04 +05301089 posting_date = self.get("bill_date") or self.get("posting_date") or self.get("transaction_date")
tundedf3a1752017-09-11 11:02:57 +01001090 date = self.get("due_date")
1091 due_date = date or posting_date
Deepesh Garg26210162020-08-11 16:06:13 +05301092
Saqib Ansarid552fe62021-04-23 14:46:52 +05301093 base_grand_total = self.get("base_rounded_total") or self.base_grand_total
1094 grand_total = self.get("rounded_total") or self.grand_total
Deepesh Garg26210162020-08-11 16:06:13 +05301095
Nabin Hait2f9f4f92017-12-20 12:24:59 +05301096 if self.doctype in ("Sales Invoice", "Purchase Invoice"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301097 base_grand_total = base_grand_total - flt(self.base_write_off_amount)
Nabin Hait2f9f4f92017-12-20 12:24:59 +05301098 grand_total = grand_total - flt(self.write_off_amount)
Deepesh Garg0bba4252021-08-06 23:53:16 +05301099 po_or_so, doctype, fieldname = self.get_order_details()
1100 automatically_fetch_payment_terms = cint(frappe.db.get_single_value('Accounts Settings', 'automatically_fetch_payment_terms'))
tunde96b8f222017-09-08 15:35:59 +01001101
Rohit Waghchaure4a267b92019-05-09 19:50:00 +05301102 if self.get("total_advance"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301103 if party_account_currency == self.company_currency:
1104 base_grand_total -= self.get("total_advance")
1105 grand_total = flt(base_grand_total / self.get("conversion_rate"), self.precision("grand_total"))
1106 else:
1107 grand_total -= self.get("total_advance")
1108 base_grand_total = flt(grand_total * self.get("conversion_rate"), self.precision("base_grand_total"))
Rohit Waghchaure4a267b92019-05-09 19:50:00 +05301109
Nabin Hait0551f7b2017-11-21 19:58:16 +05301110 if not self.get("payment_schedule"):
Deepesh Garga27ef142021-08-07 00:12:57 +05301111 if self.doctype in ["Sales Invoice", "Purchase Invoice"] and automatically_fetch_payment_terms \
1112 and self.linked_order_has_payment_terms(po_or_so, fieldname, doctype):
Deepesh Garg0bba4252021-08-06 23:53:16 +05301113 self.fetch_payment_terms_from_order(po_or_so, doctype)
1114 if self.get('payment_terms_template'):
1115 self.ignore_default_payment_terms_template = 1
1116 elif self.get("payment_terms_template"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301117 data = get_payment_terms(self.payment_terms_template, posting_date, grand_total, base_grand_total)
Nabin Hait0551f7b2017-11-21 19:58:16 +05301118 for item in data:
1119 self.append("payment_schedule", item)
GangaManojdef7cc62021-07-22 05:57:42 +05301120 elif self.doctype not in ["Purchase Receipt"]:
Saqib Ansarida5b55c2021-04-28 14:55:33 +05301121 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 +05301122 self.append("payment_schedule", data)
Subin Tom06fb0b92021-07-26 16:46:47 +05301123
Deepesh Garg0bba4252021-08-06 23:53:16 +05301124 for d in self.get("payment_schedule"):
1125 if d.invoice_portion:
1126 d.payment_amount = flt(grand_total * flt(d.invoice_portion / 100), d.precision('payment_amount'))
1127 d.base_payment_amount = flt(base_grand_total * flt(d.invoice_portion / 100), d.precision('base_payment_amount'))
1128 d.outstanding = d.payment_amount
1129 elif not d.invoice_portion:
1130 d.base_payment_amount = flt(base_grand_total * self.get("conversion_rate"), d.precision('base_payment_amount'))
Nabin Hait0551f7b2017-11-21 19:58:16 +05301131
1132
GangaManojdef7cc62021-07-22 05:57:42 +05301133 def get_order_details(self):
1134 if self.doctype == "Sales Invoice":
1135 po_or_so = self.get('items')[0].get('sales_order')
1136 po_or_so_doctype = "Sales Order"
1137 po_or_so_doctype_name = "sales_order"
1138
1139 else:
1140 po_or_so = self.get('items')[0].get('purchase_order')
1141 po_or_so_doctype = "Purchase Order"
1142 po_or_so_doctype_name = "purchase_order"
1143
1144 return po_or_so, po_or_so_doctype, po_or_so_doctype_name
1145
GangaManoj01ab6312021-07-29 19:18:35 +05301146 def linked_order_has_payment_terms(self, po_or_so, fieldname, doctype):
GangaManojdef7cc62021-07-22 05:57:42 +05301147 if po_or_so and self.all_items_have_same_po_or_so(po_or_so, fieldname):
GangaManoj01ab6312021-07-29 19:18:35 +05301148 if self.linked_order_has_payment_terms_template(po_or_so, doctype):
GangaManojdef7cc62021-07-22 05:57:42 +05301149 return True
1150 elif self.linked_order_has_payment_schedule(po_or_so):
1151 return True
1152
1153 return False
1154
1155 def all_items_have_same_po_or_so(self, po_or_so, fieldname):
1156 for item in self.get('items'):
1157 if item.get(fieldname) != po_or_so:
1158 return False
1159
1160 return True
1161
GangaManoj01ab6312021-07-29 19:18:35 +05301162 def linked_order_has_payment_terms_template(self, po_or_so, doctype):
1163 return frappe.get_value(doctype, po_or_so, 'payment_terms_template')
GangaManojdef7cc62021-07-22 05:57:42 +05301164
1165 def linked_order_has_payment_schedule(self, po_or_so):
1166 return frappe.get_all('Payment Schedule', filters={'parent': po_or_so})
1167
1168 def fetch_payment_terms_from_order(self, po_or_so, po_or_so_doctype):
1169 """
1170 Fetch Payment Terms from Purchase/Sales Order on creating a new Purchase/Sales Invoice.
1171 """
1172 po_or_so = frappe.get_cached_doc(po_or_so_doctype, po_or_so)
1173
1174 self.payment_schedule = []
1175 self.payment_terms_template = po_or_so.payment_terms_template
1176
1177 for schedule in po_or_so.payment_schedule:
1178 payment_schedule = {
1179 'payment_term': schedule.payment_term,
1180 'due_date': schedule.due_date,
1181 'invoice_portion': schedule.invoice_portion,
GangaManoj5c21eea2021-08-05 21:50:09 +05301182 'mode_of_payment': schedule.mode_of_payment,
1183 'description': schedule.description
GangaManojdef7cc62021-07-22 05:57:42 +05301184 }
GangaManoj5c21eea2021-08-05 21:50:09 +05301185
1186 if schedule.discount_type == 'Percentage':
1187 payment_schedule['discount_type'] = schedule.discount_type
1188 payment_schedule['discount'] = schedule.discount
1189
GangaManojdef7cc62021-07-22 05:57:42 +05301190 self.append("payment_schedule", payment_schedule)
tunde43870aa2017-08-18 11:59:30 +01001191
tundebe1b8712017-08-19 08:21:44 +01001192 def set_due_date(self):
Nabin Hait0551f7b2017-11-21 19:58:16 +05301193 due_dates = [d.due_date for d in self.get("payment_schedule") if d.due_date]
1194 if due_dates:
1195 self.due_date = max(due_dates)
tunde62af5c52017-09-22 15:16:38 +01001196
1197 def validate_payment_schedule_dates(self):
tunde77ecacc2017-09-22 23:12:55 +01001198 dates = []
tunde9bed2de2017-09-25 10:19:35 +01001199 li = []
tunde43870aa2017-08-18 11:59:30 +01001200
rohitwaghchauredb9fa782018-03-01 10:32:29 +05301201 if self.doctype == 'Sales Invoice' and self.is_pos: return
1202
tunde43870aa2017-08-18 11:59:30 +01001203 for d in self.get("payment_schedule"):
Nabin Hait2f9f4f92017-12-20 12:24:59 +05301204 if self.doctype == "Sales Order" and getdate(d.due_date) < getdate(self.transaction_date):
Michelle Alva7f2477b2020-04-09 17:23:23 +05301205 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 +01001206 elif d.due_date in dates:
mnatalia5f0e8d62018-05-22 06:38:50 +03001207 li.append(_("{0} in row {1}").format(d.due_date, d.idx))
tunde9bed2de2017-09-25 10:19:35 +01001208 dates.append(d.due_date)
1209
1210 if li:
1211 duplicates = '<br>' + '<br>'.join(li)
Faris Ansari2ab6e0e2018-09-19 13:13:59 +05301212 frappe.throw(_("Rows with duplicate due dates in other rows were found: {0}").format(duplicates))
tunde43870aa2017-08-18 11:59:30 +01001213
tunde62af5c52017-09-22 15:16:38 +01001214 def validate_payment_schedule_amount(self):
rohitwaghchauredb9fa782018-03-01 10:32:29 +05301215 if self.doctype == 'Sales Invoice' and self.is_pos: return
1216
Deepesh Garg26210162020-08-11 16:06:13 +05301217 party_account_currency = self.get('party_account_currency')
1218 if not party_account_currency:
1219 party_type, party = self.get_party()
1220
1221 if party_type and party:
1222 party_account_currency = get_party_account_currency(party_type, party, self.company)
1223
Nabin Hait0551f7b2017-11-21 19:58:16 +05301224 if self.get("payment_schedule"):
1225 total = 0
Saqib Ansarid552fe62021-04-23 14:46:52 +05301226 base_total = 0
Nabin Hait0551f7b2017-11-21 19:58:16 +05301227 for d in self.get("payment_schedule"):
Nabin Haitf592f2c2017-12-19 11:31:34 +05301228 total += flt(d.payment_amount)
Saqib Ansarid552fe62021-04-23 14:46:52 +05301229 base_total += flt(d.base_payment_amount)
tunde43870aa2017-08-18 11:59:30 +01001230
Saqib Ansarid552fe62021-04-23 14:46:52 +05301231 base_grand_total = self.get("base_rounded_total") or self.base_grand_total
1232 grand_total = self.get("rounded_total") or self.grand_total
Rohit Waghchaure4a267b92019-05-09 19:50:00 +05301233
Nabin Haite591c852017-12-21 11:46:30 +05301234 if self.doctype in ("Sales Invoice", "Purchase Invoice"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301235 base_grand_total = base_grand_total - flt(self.base_write_off_amount)
Nabin Haite591c852017-12-21 11:46:30 +05301236 grand_total = grand_total - flt(self.write_off_amount)
Saqib Ansarid552fe62021-04-23 14:46:52 +05301237
1238 if self.get("total_advance"):
1239 if party_account_currency == self.company_currency:
1240 base_grand_total -= self.get("total_advance")
1241 grand_total = flt(base_grand_total / self.get("conversion_rate"), self.precision("grand_total"))
1242 else:
1243 grand_total -= self.get("total_advance")
1244 base_grand_total = flt(grand_total * self.get("conversion_rate"), self.precision("base_grand_total"))
Saqib Ansarid552fe62021-04-23 14:46:52 +05301245 if total != flt(grand_total, self.precision("grand_total")) or \
1246 base_total != flt(base_grand_total, self.precision("base_grand_total")):
Nabin Hait0551f7b2017-11-21 19:58:16 +05301247 frappe.throw(_("Total Payment Amount in Payment Schedule must be equal to Grand / Rounded Total"))
tunde43870aa2017-08-18 11:59:30 +01001248
Nabin Hait877e1bb2017-11-17 12:27:43 +05301249 def is_rounded_total_disabled(self):
1250 if self.meta.get_field("disable_rounded_total"):
1251 return self.disable_rounded_total
1252 else:
1253 return frappe.db.get_single_value("Global Defaults", "disable_rounded_total")
1254
Deepesh Gargf17ea2c2020-12-11 21:30:39 +05301255 def set_inter_company_account(self):
1256 """
1257 Set intercompany account for inter warehouse transactions
1258 This account will be used in case billing company and internal customer's
1259 representation company is same
1260 """
1261
1262 if self.is_internal_transfer() and not self.unrealized_profit_loss_account:
1263 unrealized_profit_loss_account = frappe.db.get_value('Company', self.company, 'unrealized_profit_loss_account')
1264
1265 if not unrealized_profit_loss_account:
1266 msg = _("Please select Unrealized Profit / Loss account or add default Unrealized Profit / Loss account account for company {0}").format(
1267 frappe.bold(self.company))
1268 frappe.throw(msg)
1269
1270 self.unrealized_profit_loss_account = unrealized_profit_loss_account
1271
1272 def is_internal_transfer(self):
1273 """
1274 It will an internal transfer if its an internal customer and representation
1275 company is same as billing company
1276 """
Deepesh Gargb4be2922021-01-28 13:09:56 +05301277 if self.doctype in ('Sales Invoice', 'Delivery Note', 'Sales Order'):
Deepesh Gargf17ea2c2020-12-11 21:30:39 +05301278 internal_party_field = 'is_internal_customer'
Deepesh Gargb4be2922021-01-28 13:09:56 +05301279 elif self.doctype in ('Purchase Invoice', 'Purchase Receipt', 'Purchase Order'):
Deepesh Gargf17ea2c2020-12-11 21:30:39 +05301280 internal_party_field = 'is_internal_supplier'
1281
1282 if self.get(internal_party_field) and (self.represents_company == self.company):
1283 return True
1284
1285 return False
1286
Rushabh Mehta793ba6b2014-02-14 15:47:51 +05301287@frappe.whitelist()
Rushabh Mehtaf56d73c2013-10-10 16:35:09 +05301288def get_tax_rate(account_head):
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +05301289 return frappe.db.get_value("Account", account_head, ["tax_rate", "account_name"], as_dict=True)
Rushabh Mehtaa33d4682015-06-01 17:15:42 +05301290
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001291
Nabin Haitffc7f3f2015-05-12 15:07:02 +05301292@frappe.whitelist()
Nabin Haita2426fc2018-01-15 17:45:46 +05301293def get_default_taxes_and_charges(master_doctype, tax_template=None, company=None):
rohitwaghchaure505661b2017-12-11 14:52:28 +05301294 if not company: return {}
1295
Nabin Haita2426fc2018-01-15 17:45:46 +05301296 if tax_template and company:
1297 tax_template_company = frappe.db.get_value(master_doctype, tax_template, "company")
1298 if tax_template_company == company:
1299 return
1300
1301 default_tax = frappe.db.get_value(master_doctype, {"is_default": 1, "company": company})
rohitwaghchaure505661b2017-12-11 14:52:28 +05301302
Rushabh Mehta98aa5812017-11-14 09:32:32 +05301303 return {
1304 'taxes_and_charges': default_tax,
1305 'taxes': get_taxes_and_charges(master_doctype, default_tax)
1306 }
Nabin Hait6b039142014-05-02 15:45:10 +05301307
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001308
Nabin Hait6b039142014-05-02 15:45:10 +05301309@frappe.whitelist()
Nabin Haitffc7f3f2015-05-12 15:07:02 +05301310def get_taxes_and_charges(master_doctype, master_name):
Nabin Hait1fe50122015-05-16 12:14:39 +05301311 if not master_name:
1312 return
Nabin Hait6b039142014-05-02 15:45:10 +05301313 from frappe.model import default_fields
1314 tax_master = frappe.get_doc(master_doctype, master_name)
1315
1316 taxes_and_charges = []
Nabin Haitffc7f3f2015-05-12 15:07:02 +05301317 for i, tax in enumerate(tax_master.get("taxes")):
Nabin Hait6b039142014-05-02 15:45:10 +05301318 tax = tax.as_dict()
1319
1320 for fieldname in default_fields:
1321 if fieldname in tax:
1322 del tax[fieldname]
1323
1324 taxes_and_charges.append(tax)
1325
1326 return taxes_and_charges
Rushabh Mehta66e08e32014-09-29 12:17:03 +05301327
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001328
Rushabh Mehta66e08e32014-09-29 12:17:03 +05301329def validate_conversion_rate(currency, conversion_rate, conversion_rate_label, company):
1330 """common validation for currency and price list currency"""
1331
Rushabh Mehta708e47a2018-08-08 16:37:31 +05301332 company_currency = frappe.get_cached_value('Company', company, "default_currency")
Rushabh Mehta66e08e32014-09-29 12:17:03 +05301333
1334 if not conversion_rate:
Saqib60212ff2020-10-26 11:17:04 +05301335 throw(
1336 _("{0} is mandatory. Maybe Currency Exchange record is not created for {1} to {2}.")
1337 .format(conversion_rate_label, currency, company_currency)
1338 )
Nabin Hait613d0812015-02-23 11:58:15 +05301339
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001340
Nabin Hait613d0812015-02-23 11:58:15 +05301341def validate_taxes_and_charges(tax):
Deepesh Garg58034632021-06-14 11:16:39 +05301342 if tax.charge_type in ['Actual', 'On Net Total', 'On Paid Amount'] and tax.row_id:
Nabin Hait613d0812015-02-23 11:58:15 +05301343 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 +05301344 elif tax.charge_type in ['On Previous Row Amount', 'On Previous Row Total']:
Nabin Hait613d0812015-02-23 11:58:15 +05301345 if cint(tax.idx) == 1:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001346 frappe.throw(
1347 _("Cannot select charge type as 'On Previous Row Amount' or 'On Previous Row Total' for first row"))
Nabin Hait613d0812015-02-23 11:58:15 +05301348 elif not tax.row_id:
Suraj Shetty48e9bc32020-01-29 15:06:18 +05301349 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 +05301350 elif tax.row_id and cint(tax.row_id) >= cint(tax.idx):
1351 frappe.throw(_("Cannot refer row number greater than or equal to current row number for this Charge type"))
1352
Rushabh Mehta2a21bc92015-02-25 15:08:42 +05301353 if tax.charge_type == "Actual":
Nabin Haitbc6c3602015-02-27 23:40:56 +05301354 tax.rate = None
Rushabh Mehta2a21bc92015-02-25 15:08:42 +05301355
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001356
Nabin Hait613d0812015-02-23 11:58:15 +05301357def validate_inclusive_tax(tax, doc):
1358 def _on_previous_row_error(row_range):
Deepesh Garg58034632021-06-14 11:16:39 +05301359 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 +05301360
Deepesh Garg87180132021-06-14 14:34:44 +05301361 if cint(getattr(tax, "included_in_print_rate", None)):
1362 if tax.charge_type == "Actual":
1363 # inclusive tax cannot be of type Actual
1364 throw(_("Charge of type 'Actual' in row {0} cannot be included in Item Rate or Paid Amount").format(tax.idx))
1365 elif tax.charge_type == "On Previous Row Amount" and \
1366 not cint(doc.get("taxes")[cint(tax.row_id) - 1].included_in_print_rate):
1367 # referred row should also be inclusive
1368 _on_previous_row_error(tax.row_id)
1369 elif tax.charge_type == "On Previous Row Total" and \
Deepesh Garg4cd0f6c2021-06-14 20:01:04 +05301370 not all([cint(t.included_in_print_rate) for t in doc.get("taxes")[:cint(tax.row_id) - 1]]):
Deepesh Garg87180132021-06-14 14:34:44 +05301371 # all rows about the referred tax should be inclusive
Deepesh Garg4cd0f6c2021-06-14 20:01:04 +05301372 _on_previous_row_error("1 - %d" % (tax.row_id,))
Deepesh Garg87180132021-06-14 14:34:44 +05301373 elif tax.get("category") == "Valuation":
1374 frappe.throw(_("Valuation type charges can not be marked as Inclusive"))
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301375
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301376
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001377def set_balance_in_account_currency(gl_dict, account_currency=None, conversion_rate=None, company_currency=None):
1378 if (not conversion_rate) and (account_currency != company_currency):
1379 frappe.throw(_("Account: {0} with currency: {1} can not be selected")
1380 .format(gl_dict.account, account_currency))
1381
1382 gl_dict["account_currency"] = company_currency if account_currency == company_currency \
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301383 else account_currency
1384
1385 # set debit/credit in account currency if not provided
1386 if flt(gl_dict.debit) and not flt(gl_dict.debit_in_account_currency):
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001387 gl_dict.debit_in_account_currency = gl_dict.debit if account_currency == company_currency \
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301388 else flt(gl_dict.debit / conversion_rate, 2)
1389
1390 if flt(gl_dict.credit) and not flt(gl_dict.credit_in_account_currency):
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001391 gl_dict.credit_in_account_currency = gl_dict.credit if account_currency == company_currency \
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301392 else flt(gl_dict.credit / conversion_rate, 2)
Nabin Hait1991c7b2016-06-27 20:09:05 +05301393
1394
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301395def get_advance_journal_entries(party_type, party, party_account, amount_field,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001396 order_doctype, order_list, include_unallocated=True):
1397 dr_or_cr = "credit_in_account_currency" if party_type == "Customer" else "debit_in_account_currency"
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301398
Nabin Hait1991c7b2016-06-27 20:09:05 +05301399 conditions = []
1400 if include_unallocated:
1401 conditions.append("ifnull(t2.reference_name, '')=''")
1402
1403 if order_list:
1404 order_condition = ', '.join(['%s'] * len(order_list))
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001405 conditions.append(" (t2.reference_type = '{0}' and ifnull(t2.reference_name, '') in ({1}))" \
1406 .format(order_doctype, order_condition))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301407
Nabin Hait1991c7b2016-06-27 20:09:05 +05301408 reference_condition = " and (" + " or ".join(conditions) + ")" if conditions else ""
Rushabh Mehta66958302017-01-16 16:57:53 +05301409
Nabin Hait1991c7b2016-06-27 20:09:05 +05301410 journal_entries = frappe.db.sql("""
1411 select
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301412 "Journal Entry" as reference_type, t1.name as reference_name,
Nabin Hait1991c7b2016-06-27 20:09:05 +05301413 t1.remark as remarks, t2.{0} as amount, t2.name as reference_row,
1414 t2.reference_name as against_order
1415 from
1416 `tabJournal Entry` t1, `tabJournal Entry Account` t2
1417 where
1418 t1.name = t2.parent and t2.account = %s
1419 and t2.party_type = %s and t2.party = %s
1420 and t2.is_advance = 'Yes' and t1.docstatus = 1
Nabin Haitca627fb2016-09-05 16:16:53 +05301421 and {1} > 0 {2}
Nabin Hait1991c7b2016-06-27 20:09:05 +05301422 order by t1.posting_date""".format(amount_field, dr_or_cr, reference_condition),
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001423 [party_account, party_type, party] + order_list, as_dict=1)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301424
Nabin Hait1991c7b2016-06-27 20:09:05 +05301425 return list(journal_entries)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301426
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001427
Rohit Waghchauref7258162019-01-15 18:12:04 +05301428def get_advance_payment_entries(party_type, party, party_account, order_doctype,
Nabin Hait34c551d2019-07-03 10:34:31 +05301429 order_list=None, include_unallocated=True, against_all_orders=False, limit=None):
Nabin Hait1991c7b2016-06-27 20:09:05 +05301430 party_account_field = "paid_from" if party_type == "Customer" else "paid_to"
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301431 currency_field = "paid_from_account_currency" if party_type == "Customer" else "paid_to_account_currency"
Nabin Hait1991c7b2016-06-27 20:09:05 +05301432 payment_type = "Receive" if party_type == "Customer" else "Pay"
Saqib7fb64d12021-07-12 18:33:16 +05301433 exchange_rate_field = "source_exchange_rate" if payment_type == "Receive" else "target_exchange_rate"
1434
Nabin Hait1991c7b2016-06-27 20:09:05 +05301435 payment_entries_against_order, unallocated_payment_entries = [], []
Nabin Hait34c551d2019-07-03 10:34:31 +05301436 limit_cond = "limit %s" % limit if limit else ""
Nabin Haitff2f3ef2016-07-04 11:41:14 +05301437
Nabin Hait1991c7b2016-06-27 20:09:05 +05301438 if order_list or against_all_orders:
1439 if order_list:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001440 reference_condition = " and t2.reference_name in ({0})" \
Nabin Hait1991c7b2016-06-27 20:09:05 +05301441 .format(', '.join(['%s'] * len(order_list)))
1442 else:
1443 reference_condition = ""
1444 order_list = []
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301445
Nabin Hait1991c7b2016-06-27 20:09:05 +05301446 payment_entries_against_order = frappe.db.sql("""
1447 select
1448 "Payment Entry" as reference_type, t1.name as reference_name,
1449 t1.remarks, t2.allocated_amount as amount, t2.name as reference_row,
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301450 t2.reference_name as against_order, t1.posting_date,
Saqib7fb64d12021-07-12 18:33:16 +05301451 t1.{0} as currency, t1.{4} as exchange_rate
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301452 from `tabPayment Entry` t1, `tabPayment Entry Reference` t2
Nabin Hait1991c7b2016-06-27 20:09:05 +05301453 where
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301454 t1.name = t2.parent and t1.{1} = %s and t1.payment_type = %s
Nabin Hait1991c7b2016-06-27 20:09:05 +05301455 and t1.party_type = %s and t1.party = %s and t1.docstatus = 1
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301456 and t2.reference_doctype = %s {2}
1457 order by t1.posting_date {3}
Saqib7fb64d12021-07-12 18:33:16 +05301458 """.format(currency_field, party_account_field, reference_condition, limit_cond, exchange_rate_field),
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001459 [party_account, payment_type, party_type, party,
1460 order_doctype] + order_list, as_dict=1)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301461
Nabin Hait1991c7b2016-06-27 20:09:05 +05301462 if include_unallocated:
1463 unallocated_payment_entries = frappe.db.sql("""
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301464 select "Payment Entry" as reference_type, name as reference_name,
Saqib7fb64d12021-07-12 18:33:16 +05301465 remarks, unallocated_amount as amount, {2} as exchange_rate
Nabin Hait1991c7b2016-06-27 20:09:05 +05301466 from `tabPayment Entry`
1467 where
1468 {0} = %s and party_type = %s and party = %s and payment_type = %s
1469 and docstatus = 1 and unallocated_amount > 0
Rohit Waghchauref7258162019-01-15 18:12:04 +05301470 order by posting_date {1}
Saqib7fb64d12021-07-12 18:33:16 +05301471 """.format(party_account_field, limit_cond, exchange_rate_field),
1472 (party_account, party_type, party, payment_type), as_dict=1)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301473
Rohit Waghchaure2f1db572016-11-08 12:39:33 +05301474 return list(payment_entries_against_order) + list(unallocated_payment_entries)
1475
1476def update_invoice_status():
1477 # Daily update the status of the invoices
1478
Rushabh Mehta66958302017-01-16 16:57:53 +05301479 frappe.db.sql(""" update `tabSales Invoice` set status = 'Overdue'
Rohit Waghchaure2f1db572016-11-08 12:39:33 +05301480 where due_date < CURDATE() and docstatus = 1 and outstanding_amount > 0""")
1481
Rushabh Mehta66958302017-01-16 16:57:53 +05301482 frappe.db.sql(""" update `tabPurchase Invoice` set status = 'Overdue'
Nabin Hait92759692017-08-15 08:23:51 +05301483 where due_date < CURDATE() and docstatus = 1 and outstanding_amount > 0""")
1484
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001485
Nabin Hait92759692017-08-15 08:23:51 +05301486@frappe.whitelist()
Saqib Ansarid552fe62021-04-23 14:46:52 +05301487def 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 +05301488 if not terms_template:
1489 return
1490
1491 terms_doc = frappe.get_doc("Payment Terms Template", terms_template)
1492
1493 schedule = []
tundefb144302017-08-19 15:01:40 +01001494 for d in terms_doc.get("terms"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301495 term_details = get_payment_term_details(d, posting_date, grand_total, base_grand_total, bill_date)
Nabin Hait92759692017-08-15 08:23:51 +05301496 schedule.append(term_details)
1497
1498 return schedule
1499
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001500
Nabin Hait92759692017-08-15 08:23:51 +05301501@frappe.whitelist()
Saqib Ansarid552fe62021-04-23 14:46:52 +05301502def 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 +05301503 term_details = frappe._dict()
Achilles Rasquinha90509982018-03-08 12:55:41 +05301504 if isinstance(term, text_type):
Nabin Hait92759692017-08-15 08:23:51 +05301505 term = frappe.get_doc("Payment Term", term)
1506 else:
1507 term_details.payment_term = term.payment_term
1508 term_details.description = term.description
1509 term_details.invoice_portion = term.invoice_portion
Rohit Waghchaure52bf56d2017-11-27 11:43:52 +05301510 term_details.payment_amount = flt(term.invoice_portion) * flt(grand_total) / 100
Saqib Ansarid552fe62021-04-23 14:46:52 +05301511 term_details.base_payment_amount = flt(term.invoice_portion) * flt(base_grand_total) / 100
Saqib0586b7d2021-03-31 15:03:53 +05301512 term_details.discount_type = term.discount_type
1513 term_details.discount = term.discount
Saqib0586b7d2021-03-31 15:03:53 +05301514 term_details.outstanding = term_details.payment_amount
1515 term_details.mode_of_payment = term.mode_of_payment
1516
Shreya Shah3a9eec22018-02-16 13:05:21 +05301517 if bill_date:
1518 term_details.due_date = get_due_date(term, bill_date)
Saqib0586b7d2021-03-31 15:03:53 +05301519 term_details.discount_date = get_discount_date(term, bill_date)
Shreya Shah3a9eec22018-02-16 13:05:21 +05301520 elif posting_date:
1521 term_details.due_date = get_due_date(term, posting_date)
Saqib0586b7d2021-03-31 15:03:53 +05301522 term_details.discount_date = get_discount_date(term, posting_date)
Shreya Shah3a9eec22018-02-16 13:05:21 +05301523
1524 if getdate(term_details.due_date) < getdate(posting_date):
1525 term_details.due_date = posting_date
1526
Nabin Hait92759692017-08-15 08:23:51 +05301527 return term_details
1528
Shreya Shah3a9eec22018-02-16 13:05:21 +05301529def get_due_date(term, posting_date=None, bill_date=None):
Nabin Hait92759692017-08-15 08:23:51 +05301530 due_date = None
Shreya Shah3a9eec22018-02-16 13:05:21 +05301531 date = bill_date or posting_date
Nabin Hait92759692017-08-15 08:23:51 +05301532 if term.due_date_based_on == "Day(s) after invoice date":
Shreya Shah3a9eec22018-02-16 13:05:21 +05301533 due_date = add_days(date, term.credit_days)
Nabin Hait92759692017-08-15 08:23:51 +05301534 elif term.due_date_based_on == "Day(s) after the end of the invoice month":
Shreya Shah3a9eec22018-02-16 13:05:21 +05301535 due_date = add_days(get_last_day(date), term.credit_days)
Nabin Hait92759692017-08-15 08:23:51 +05301536 elif term.due_date_based_on == "Month(s) after the end of the invoice month":
Shreya Shah3a9eec22018-02-16 13:05:21 +05301537 due_date = add_months(get_last_day(date), term.credit_months)
tunde96b8f222017-09-08 15:35:59 +01001538 return due_date
tundebabzyad08d4c2018-05-16 07:01:41 +01001539
Saqib0586b7d2021-03-31 15:03:53 +05301540def get_discount_date(term, posting_date=None, bill_date=None):
1541 discount_validity = None
1542 date = bill_date or posting_date
1543 if term.discount_validity_based_on == "Day(s) after invoice date":
1544 discount_validity = add_days(date, term.discount_validity)
1545 elif term.discount_validity_based_on == "Day(s) after the end of the invoice month":
1546 discount_validity = add_days(get_last_day(date), term.discount_validity)
1547 elif term.discount_validity_based_on == "Month(s) after the end of the invoice month":
1548 discount_validity = add_months(get_last_day(date), term.discount_validity)
1549 return discount_validity
tundebabzyad08d4c2018-05-16 07:01:41 +01001550
1551def get_supplier_block_status(party_name):
1552 """
1553 Returns a dict containing the values of `on_hold`, `release_date` and `hold_type` of
1554 a `Supplier`
1555 """
1556 supplier = frappe.get_doc('Supplier', party_name)
1557 info = {
1558 'on_hold': supplier.on_hold,
1559 'release_date': supplier.release_date,
1560 'hold_type': supplier.hold_type
1561 }
1562 return info
1563
marination698d9832020-08-19 14:59:46 +05301564def set_child_tax_template_and_map(item, child_item, parent_doc):
1565 args = {
1566 'item_code': item.item_code,
1567 'posting_date': parent_doc.transaction_date,
1568 'tax_category': parent_doc.get('tax_category'),
1569 'company': parent_doc.get('company')
1570 }
1571
1572 child_item.item_tax_template = _get_item_tax_template(args, item.taxes)
1573 if child_item.get("item_tax_template"):
1574 child_item.item_tax_rate = get_item_tax_map(parent_doc.get('company'), child_item.item_tax_template, as_json=True)
1575
Frappe PR Bot0ff9ef62021-08-09 17:58:18 +05301576def add_taxes_from_tax_template(child_item, parent_doc, db_insert=True):
Marica3b1be2b2020-10-22 17:04:31 +05301577 add_taxes_from_item_tax_template = frappe.db.get_single_value("Accounts Settings", "add_taxes_from_item_tax_template")
1578
1579 if child_item.get("item_tax_rate") and add_taxes_from_item_tax_template:
1580 tax_map = json.loads(child_item.get("item_tax_rate"))
1581 for tax_type in tax_map:
1582 tax_rate = flt(tax_map[tax_type])
1583 taxes = parent_doc.get('taxes') or []
1584 # add new row for tax head only if missing
1585 found = any(tax.account_head == tax_type for tax in taxes)
1586 if not found:
1587 tax_row = parent_doc.append("taxes", {})
1588 tax_row.update({
1589 "description" : str(tax_type).split(' - ')[0],
1590 "charge_type" : "On Net Total",
1591 "account_head" : tax_type,
1592 "rate" : tax_rate
1593 })
1594 if parent_doc.doctype == "Purchase Order":
1595 tax_row.update({
1596 "category" : "Total",
1597 "add_deduct_tax" : "Add"
1598 })
Frappe PR Bot0ff9ef62021-08-09 17:58:18 +05301599 if db_insert:
1600 tax_row.db_insert()
Marica3b1be2b2020-10-22 17:04:31 +05301601
pateljannat637ddff2021-02-09 16:17:30 +05301602def set_order_defaults(parent_doctype, parent_doctype_name, child_doctype, child_docname, trans_item):
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001603 """
pateljannat637ddff2021-02-09 16:17:30 +05301604 Returns a Sales/Purchase Order Item child item containing the default values
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001605 """
Saqib438e0432020-04-03 10:02:56 +05301606 p_doc = frappe.get_doc(parent_doctype, parent_doctype_name)
pateljannat637ddff2021-02-09 16:17:30 +05301607 child_item = frappe.new_doc(child_doctype, p_doc, child_docname)
Saqib Ansarif53299e2020-04-15 22:08:12 +05301608 item = frappe.get_doc("Item", trans_item.get('item_code'))
marination0673f552021-03-31 01:38:22 +05301609
pateljannat637ddff2021-02-09 16:17:30 +05301610 for field in ("item_code", "item_name", "description", "item_group"):
marination0673f552021-03-31 01:38:22 +05301611 child_item.update({field: item.get(field)})
1612
pateljannat637ddff2021-02-09 16:17:30 +05301613 date_fieldname = "delivery_date" if child_doctype == "Sales Order Item" else "schedule_date"
Jannat Patelbb0d8f82021-02-11 20:59:28 +05301614 child_item.update({date_fieldname: trans_item.get(date_fieldname) or p_doc.get(date_fieldname)})
marination0673f552021-03-31 01:38:22 +05301615 child_item.stock_uom = item.stock_uom
Saqib61314242020-09-15 11:14:31 +05301616 child_item.uom = trans_item.get("uom") or item.stock_uom
Andy Zhu1062d7e2020-10-06 10:51:42 +13001617 child_item.warehouse = get_item_warehouse(item, p_doc, overwrite_warehouse=True)
Saqib61314242020-09-15 11:14:31 +05301618 conversion_factor = flt(get_conversion_factor(item.item_code, child_item.uom).get("conversion_factor"))
1619 child_item.conversion_factor = flt(trans_item.get('conversion_factor')) or conversion_factor
marination0673f552021-03-31 01:38:22 +05301620
pateljannat637ddff2021-02-09 16:17:30 +05301621 if child_doctype == "Purchase Order Item":
marination0673f552021-03-31 01:38:22 +05301622 # Initialized value will update in parent validation
1623 child_item.base_rate = 1
1624 child_item.base_amount = 1
pateljannat637ddff2021-02-09 16:17:30 +05301625 if child_doctype == "Sales Order Item":
1626 child_item.warehouse = get_item_warehouse(item, p_doc, overwrite_warehouse=True)
1627 if not child_item.warehouse:
1628 frappe.throw(_("Cannot find {} for item {}. Please set the same in Item Master or Stock Settings.")
1629 .format(frappe.bold("default warehouse"), frappe.bold(item.item_code)))
marination0673f552021-03-31 01:38:22 +05301630
marination698d9832020-08-19 14:59:46 +05301631 set_child_tax_template_and_map(item, child_item, p_doc)
Marica3b1be2b2020-10-22 17:04:31 +05301632 add_taxes_from_tax_template(child_item, p_doc)
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001633 return child_item
1634
marination0673f552021-03-31 01:38:22 +05301635def validate_child_on_delete(row, parent):
1636 """Check if partially transacted item (row) is being deleted."""
1637 if parent.doctype == "Sales Order":
1638 if flt(row.delivered_qty):
1639 frappe.throw(_("Row #{0}: Cannot delete item {1} which has already been delivered").format(row.idx, row.item_code))
1640 if flt(row.work_order_qty):
1641 frappe.throw(_("Row #{0}: Cannot delete item {1} which has work order assigned to it.").format(row.idx, row.item_code))
1642 if flt(row.ordered_qty):
1643 frappe.throw(_("Row #{0}: Cannot delete item {1} which is assigned to customer's purchase order.").format(row.idx, row.item_code))
1644
1645 if parent.doctype == "Purchase Order" and flt(row.received_qty):
1646 frappe.throw(_("Row #{0}: Cannot delete item {1} which has already been received").format(row.idx, row.item_code))
1647
1648 if flt(row.billed_amt):
1649 frappe.throw(_("Row #{0}: Cannot delete item {1} which has already been billed.").format(row.idx, row.item_code))
1650
1651def update_bin_on_delete(row, doctype):
1652 """Update bin for deleted item (row)."""
1653 from erpnext.stock.stock_balance import update_bin_qty, get_reserved_qty, get_ordered_qty, get_indented_qty
1654 qty_dict = {}
1655
1656 if doctype == "Sales Order":
1657 qty_dict["reserved_qty"] = get_reserved_qty(row.item_code, row.warehouse)
1658 else:
1659 if row.material_request_item:
1660 qty_dict["indented_qty"] = get_indented_qty(row.item_code, row.warehouse)
1661
1662 qty_dict["ordered_qty"] = get_ordered_qty(row.item_code, row.warehouse)
1663
1664 update_bin_qty(row.item_code, row.warehouse, qty_dict)
1665
Saqib6db92fb2020-09-14 19:54:17 +05301666def validate_and_delete_children(parent, data):
Saqib0ad74492019-12-24 16:42:30 +05301667 deleted_children = []
1668 updated_item_names = [d.get("docname") for d in data]
1669 for item in parent.items:
1670 if item.name not in updated_item_names:
1671 deleted_children.append(item)
1672
1673 for d in deleted_children:
marination0673f552021-03-31 01:38:22 +05301674 validate_child_on_delete(d, parent)
Saqib0ad74492019-12-24 16:42:30 +05301675 d.cancel()
1676 d.delete()
marination0673f552021-03-31 01:38:22 +05301677
1678 # need to update ordered qty in Material Request first
1679 # bin uses Material Request Items to recalculate & update
1680 parent.update_prevdoc_status()
1681
1682 for d in deleted_children:
1683 update_bin_on_delete(d, parent.doctype)
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001684
Rohan Bansala93b5142021-04-06 17:10:52 +05301685
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001686@frappe.whitelist()
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001687def update_child_qty_rate(parent_doctype, trans_items, parent_doctype_name, child_docname="items"):
Saqib6db92fb2020-09-14 19:54:17 +05301688 def check_doc_permissions(doc, perm_type='create'):
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301689 try:
1690 doc.check_permission(perm_type)
Saqib6db92fb2020-09-14 19:54:17 +05301691 except frappe.PermissionError:
marination661bf642020-09-29 18:16:45 +05301692 actions = { 'create': 'add', 'write': 'update'}
Saqib6db92fb2020-09-14 19:54:17 +05301693
1694 frappe.throw(_("You do not have permissions to {} items in a {}.")
1695 .format(actions[perm_type], parent_doctype), title=_("Insufficient Permissions"))
marination665c27a2020-09-15 12:04:38 +05301696
Saqib6db92fb2020-09-14 19:54:17 +05301697 def validate_workflow_conditions(doc):
1698 workflow = get_workflow_name(doc.doctype)
1699 if not workflow:
1700 return
1701
1702 workflow_doc = frappe.get_doc("Workflow", workflow)
1703 current_state = doc.get(workflow_doc.workflow_state_field)
1704 roles = frappe.get_roles()
1705
1706 transitions = []
1707 for transition in workflow_doc.transitions:
1708 if transition.next_state == current_state and transition.allowed in roles:
1709 if not is_transition_condition_satisfied(transition, doc):
1710 continue
1711 transitions.append(transition.as_dict())
1712
1713 if not transitions:
Saqib18318932020-09-23 13:01:49 +05301714 frappe.throw(
1715 _("You are not allowed to update as per the conditions set in {} Workflow.").format(get_link_to_form("Workflow", workflow)),
1716 title=_("Insufficient Permissions")
1717 )
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301718
Rohit Waghchaure8d5380a2020-06-18 14:06:31 +05301719 def get_new_child_item(item_row):
Rohit Waghchaureff70e612021-03-06 22:08:08 +05301720 child_doctype = "Sales Order Item" if parent_doctype == "Sales Order" else "Purchase Order Item"
pateljannat637ddff2021-02-09 16:17:30 +05301721 return set_order_defaults(parent_doctype, parent_doctype_name, child_doctype, child_docname, item_row)
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301722
1723 def validate_quantity(child_item, d):
1724 if parent_doctype == "Sales Order" and flt(d.get("qty")) < flt(child_item.delivered_qty):
1725 frappe.throw(_("Cannot set quantity less than delivered quantity"))
1726
1727 if parent_doctype == "Purchase Order" and flt(d.get("qty")) < flt(child_item.received_qty):
1728 frappe.throw(_("Cannot set quantity less than received quantity"))
1729
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001730 data = json.loads(trans_items)
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001731
rohitwaghchaure81c21752019-10-31 15:56:10 +05301732 sales_doctypes = ['Sales Order', 'Sales Invoice', 'Delivery Note', 'Quotation']
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301733 parent = frappe.get_doc(parent_doctype, parent_doctype_name)
marination665c27a2020-09-15 12:04:38 +05301734
marination661bf642020-09-29 18:16:45 +05301735 check_doc_permissions(parent, 'write')
Saqib6db92fb2020-09-14 19:54:17 +05301736 validate_and_delete_children(parent, data)
Saqib0ad74492019-12-24 16:42:30 +05301737
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001738 for d in data:
1739 new_child_flag = False
1740 if not d.get("docname"):
1741 new_child_flag = True
Saqib6db92fb2020-09-14 19:54:17 +05301742 check_doc_permissions(parent, 'create')
Rohit Waghchaure8d5380a2020-06-18 14:06:31 +05301743 child_item = get_new_child_item(d)
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001744 else:
Saqib6db92fb2020-09-14 19:54:17 +05301745 check_doc_permissions(parent, 'write')
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001746 child_item = frappe.get_doc(parent_doctype + ' Item', d.get("docname"))
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301747
Saqib Ansaric579b082020-05-29 22:21:50 +05301748 prev_rate, new_rate = flt(child_item.get("rate")), flt(d.get("rate"))
1749 prev_qty, new_qty = flt(child_item.get("qty")), flt(d.get("qty"))
1750 prev_con_fac, new_con_fac = flt(child_item.get("conversion_factor")), flt(d.get("conversion_factor"))
Saqib61314242020-09-15 11:14:31 +05301751 prev_uom, new_uom = child_item.get("uom"), d.get("uom")
Saqib Ansaric579b082020-05-29 22:21:50 +05301752
1753 if parent_doctype == 'Sales Order':
1754 prev_date, new_date = child_item.get("delivery_date"), d.get("delivery_date")
1755 elif parent_doctype == 'Purchase Order':
marinationb7e94cc2020-06-15 11:32:42 +05301756 prev_date, new_date = child_item.get("schedule_date"), d.get("schedule_date")
Saqib Ansaric579b082020-05-29 22:21:50 +05301757
1758 rate_unchanged = prev_rate == new_rate
marinationf9c4b202020-06-12 15:49:53 +05301759 qty_unchanged = prev_qty == new_qty
Saqib61314242020-09-15 11:14:31 +05301760 uom_unchanged = prev_uom == new_uom
Saqib Ansaric579b082020-05-29 22:21:50 +05301761 conversion_factor_unchanged = prev_con_fac == new_con_fac
1762 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 +05301763 if rate_unchanged and qty_unchanged and conversion_factor_unchanged and uom_unchanged and date_unchanged:
Saqibdd374ff2020-02-27 12:51:31 +05301764 continue
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001765
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301766 validate_quantity(child_item, d)
deepeshgarg00777cde832018-12-27 15:56:51 +05301767
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001768 child_item.qty = flt(d.get("qty"))
Saqib56fea7d2020-10-09 21:19:25 +05301769 rate_precision = child_item.precision("rate") or 2
1770 conv_fac_precision = child_item.precision("conversion_factor") or 2
1771 qty_precision = child_item.precision("qty") or 2
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001772
Saqib56fea7d2020-10-09 21:19:25 +05301773 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 +08001774 frappe.throw(_("Row #{0}: Cannot set Rate if amount is greater than billed amount for Item {1}.")
1775 .format(child_item.idx, child_item.item_code))
1776 else:
Saqib56fea7d2020-10-09 21:19:25 +05301777 child_item.rate = flt(d.get("rate"), rate_precision)
marinationf9c4b202020-06-12 15:49:53 +05301778
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301779 if d.get("conversion_factor"):
marinationf9c4b202020-06-12 15:49:53 +05301780 if child_item.stock_uom == child_item.uom:
1781 child_item.conversion_factor = 1
1782 else:
Saqib56fea7d2020-10-09 21:19:25 +05301783 child_item.conversion_factor = flt(d.get('conversion_factor'), conv_fac_precision)
marination665c27a2020-09-15 12:04:38 +05301784
Saqib61314242020-09-15 11:14:31 +05301785 if d.get("uom"):
1786 child_item.uom = d.get("uom")
1787 conversion_factor = flt(get_conversion_factor(child_item.item_code, child_item.uom).get("conversion_factor"))
Saqib56fea7d2020-10-09 21:19:25 +05301788 child_item.conversion_factor = flt(d.get('conversion_factor'), conv_fac_precision) or conversion_factor
Mangesh-Khairnara3d52002019-08-05 10:16:40 +05301789
Saqib Ansaric579b082020-05-29 22:21:50 +05301790 if d.get("delivery_date") and parent_doctype == 'Sales Order':
1791 child_item.delivery_date = d.get('delivery_date')
marinationf9c4b202020-06-12 15:49:53 +05301792
Saqib Ansaric579b082020-05-29 22:21:50 +05301793 if d.get("schedule_date") and parent_doctype == 'Purchase Order':
1794 child_item.schedule_date = d.get('schedule_date')
1795
Mangesh-Khairnara3d52002019-08-05 10:16:40 +05301796 if flt(child_item.price_list_rate):
Maricaf0674472019-10-11 10:47:09 +05301797 if flt(child_item.rate) > flt(child_item.price_list_rate):
1798 # if rate is greater than price_list_rate, set margin
1799 # or set discount
1800 child_item.discount_percentage = 0
rohitwaghchaure81c21752019-10-31 15:56:10 +05301801
1802 if parent_doctype in sales_doctypes:
1803 child_item.margin_type = "Amount"
1804 child_item.margin_rate_or_amount = flt(child_item.rate - child_item.price_list_rate,
1805 child_item.precision("margin_rate_or_amount"))
1806 child_item.rate_with_margin = child_item.rate
Maricaf0674472019-10-11 10:47:09 +05301807 else:
1808 child_item.discount_percentage = flt((1 - flt(child_item.rate) / flt(child_item.price_list_rate)) * 100.0,
1809 child_item.precision("discount_percentage"))
1810 child_item.discount_amount = flt(
1811 child_item.price_list_rate) - flt(child_item.rate)
rohitwaghchaure81c21752019-10-31 15:56:10 +05301812
1813 if parent_doctype in sales_doctypes:
1814 child_item.margin_type = ""
1815 child_item.margin_rate_or_amount = 0
1816 child_item.rate_with_margin = 0
Mangesh-Khairnara3d52002019-08-05 10:16:40 +05301817
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001818 child_item.flags.ignore_validate_update_after_submit = True
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001819 if new_child_flag:
Saqib Ansarif53299e2020-04-15 22:08:12 +05301820 parent.load_from_db()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301821 child_item.idx = len(parent.items) + 1
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001822 child_item.insert()
1823 else:
1824 child_item.save()
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001825
Rushabh Mehtafafbb022018-12-24 22:09:15 +05301826 parent.reload()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301827 parent.flags.ignore_validate_update_after_submit = True
1828 parent.set_qty_as_per_stock_uom()
1829 parent.calculate_taxes_and_totals()
Ankush Menatdf6e2082021-02-11 11:04:39 +05301830 parent.set_total_in_words()
Nabin Hait49a46f02019-10-21 13:35:43 +05301831 if parent_doctype == "Sales Order":
Marica3dee5272020-06-23 10:33:47 +05301832 make_packing_list(parent)
Nabin Hait49a46f02019-10-21 13:35:43 +05301833 parent.set_gross_profit()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301834 frappe.get_doc('Authorization Control').validate_approving_authority(parent.doctype,
1835 parent.company, parent.base_grand_total)
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001836
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301837 parent.set_payment_schedule()
Nabin Haitb2da0822018-07-13 17:01:40 +05301838 if parent_doctype == 'Purchase Order':
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301839 parent.validate_minimum_order_qty()
1840 parent.validate_budget()
1841 if parent.is_against_so():
1842 parent.update_status_updater()
Nabin Haitb2da0822018-07-13 17:01:40 +05301843 else:
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301844 parent.check_credit_limit()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301845 parent.save()
Nabin Haitb2da0822018-07-13 17:01:40 +05301846
1847 if parent_doctype == 'Purchase Order':
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301848 update_last_purchase_rate(parent, is_submit = 1)
1849 parent.update_prevdoc_status()
1850 parent.update_requested_qty()
1851 parent.update_ordered_qty()
1852 parent.update_ordered_and_reserved_qty()
1853 parent.update_receiving_percentage()
1854 if parent.is_subcontracted == "Yes":
1855 parent.update_reserved_qty_for_subcontract()
Saqib61314242020-09-15 11:14:31 +05301856 parent.create_raw_materials_supplied("supplied_items")
1857 parent.save()
Nabin Haitb2da0822018-07-13 17:01:40 +05301858 else:
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301859 parent.update_reserved_qty()
1860 parent.update_project()
1861 parent.update_prevdoc_status('submit')
1862 parent.update_delivery_status()
Nabin Haitb2da0822018-07-13 17:01:40 +05301863
Saqib6db92fb2020-09-14 19:54:17 +05301864 parent.reload()
1865 validate_workflow_conditions(parent)
1866
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301867 parent.update_blanket_order()
1868 parent.update_billing_percentage()
1869 parent.set_status()
Gauravf1e28e02019-02-13 16:46:24 +05301870
1871@erpnext.allow_regional
1872def validate_regional(doc):
1873 pass
Saqib6d74f5b2020-12-25 10:26:43 +05301874
1875@erpnext.allow_regional
1876def validate_einvoice_fields(doc):
GangaManojdef7cc62021-07-22 05:57:42 +05301877 pass