blob: d65efa24b4e625e0b157440460a7347d0c44ef7e [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 Garg5a060192021-07-21 15:25:40 +0530816 def get_amount_and_base_amount(self, item, enable_discount_accounting):
817 amount = item.net_amount
818 base_amount = item.base_net_amount
819
820 if enable_discount_accounting and self.get('discount_amount') and self.get('additional_discount_account'):
821 amount = item.amount
822 base_amount = item.base_amount
823
824 return amount, base_amount
825
826 def get_tax_amounts(self, tax, enable_discount_accounting):
827 amount = tax.tax_amount_after_discount_amount
828 base_amount = tax.base_tax_amount_after_discount_amount
829
830 if enable_discount_accounting and self.get('discount_amount') and self.get('additional_discount_account') \
831 and self.get('apply_discount_on') == 'Grand Total':
832 amount = tax.tax_amount
833 base_amount = tax.base_tax_amount
834
835 return amount, base_amount
836
GangaManojfd2852e2021-07-13 03:01:02 +0530837 def make_discount_gl_entries(self, gl_entries):
838 enable_discount_accounting = cint(frappe.db.get_single_value('Accounts Settings', 'enable_discount_accounting'))
839
840 if enable_discount_accounting:
GangaManoj566e8f82021-07-20 03:46:02 +0530841 if self.doctype == "Purchase Invoice":
842 dr_or_cr = "credit"
843 rev_dr_cr = "debit"
844 supplier_or_customer = self.supplier
845
846 else:
847 dr_or_cr = "debit"
848 rev_dr_cr = "credit"
849 supplier_or_customer = self.customer
850
GangaManojfd2852e2021-07-13 03:01:02 +0530851 for item in self.get("items"):
852 if item.get('discount_amount') and item.get('discount_account'):
Deepesh Garg1c9e5162021-07-28 11:38:44 +0530853 discount_amount = item.discount_amount * item.qty
GangaManojfd2852e2021-07-13 03:01:02 +0530854 if self.doctype == "Purchase Invoice":
GangaManojfd2852e2021-07-13 03:01:02 +0530855 income_or_expense_account = (item.expense_account
856 if (not item.enable_deferred_expense or self.is_return)
857 else item.deferred_expense_account)
858 else:
GangaManojfd2852e2021-07-13 03:01:02 +0530859 income_or_expense_account = (item.income_account
860 if (not item.enable_deferred_revenue or self.is_return)
861 else item.deferred_revenue_account)
862
863 account_currency = get_account_currency(item.discount_account)
864 gl_entries.append(
865 self.get_gl_dict({
866 "account": item.discount_account,
867 "against": supplier_or_customer,
Deepesh Garg1c9e5162021-07-28 11:38:44 +0530868 dr_or_cr: flt(discount_amount, item.precision('discount_amount')),
869 dr_or_cr + "_in_account_currency": flt(discount_amount * self.get('conversion_rate'),
870 item.precision('discount_amount')),
Ganga Manojb4a8bc82021-07-19 23:43:36 +0530871 "cost_center": item.cost_center,
Ganga Manoje7e9bda2021-07-19 23:44:21 +0530872 "project": item.project
Ganga Manojf421dc72021-07-19 23:44:55 +0530873 }, account_currency, item=item)
GangaManojfd2852e2021-07-13 03:01:02 +0530874 )
875
876 account_currency = get_account_currency(income_or_expense_account)
877 gl_entries.append(
878 self.get_gl_dict({
879 "account": income_or_expense_account,
880 "against": supplier_or_customer,
Deepesh Garg1c9e5162021-07-28 11:38:44 +0530881 rev_dr_cr: flt(discount_amount, item.precision('discount_amount')),
882 rev_dr_cr + "_in_account_currency": flt(discount_amount * self.get('conversion_rate'),
883 item.precision('discount_amount')),
GangaManojfd2852e2021-07-13 03:01:02 +0530884 "cost_center": item.cost_center,
885 "project": item.project or self.project
886 }, account_currency, item=item)
887 )
GangaManoj38327fc2021-07-15 22:03:46 +0530888
GangaManoj566e8f82021-07-20 03:46:02 +0530889 if self.get('discount_amount') and self.get('additional_discount_account'):
GangaManoj38327fc2021-07-15 22:03:46 +0530890 gl_entries.append(
891 self.get_gl_dict({
892 "account": self.additional_discount_account,
GangaManoj566e8f82021-07-20 03:46:02 +0530893 "against": supplier_or_customer,
894 dr_or_cr: self.discount_amount,
895 "cost_center": self.cost_center
896 }, item=self)
897 )
898
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530899 def allocate_advance_taxes(self, gl_entries):
900 tax_map = self.get_tax_map()
901 for pe in self.get("advances"):
Deepesh Garg911818a2021-06-09 22:55:10 +0530902 if pe.reference_type == "Payment Entry" and \
903 frappe.db.get_value('Payment Entry', pe.reference_name, 'advance_tax_account'):
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530904 pe = frappe.get_doc("Payment Entry", pe.reference_name)
905 for tax in pe.get("taxes"):
906 account_currency = get_account_currency(tax.account_head)
907
908 if self.doctype == "Purchase Invoice":
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530909 dr_or_cr = "debit" if tax.add_deduct_tax == "Add" else "credit"
910 rev_dr_cr = "credit" if tax.add_deduct_tax == "Add" else "debit"
Deepesh Garg4a2e4742021-07-13 11:22:55 +0530911 else:
912 dr_or_cr = "credit" if tax.add_deduct_tax == "Add" else "debit"
913 rev_dr_cr = "debit" if tax.add_deduct_tax == "Add" else "credit"
Deepesh Gargc9da1fc2021-05-19 18:38:35 +0530914
915 party = self.supplier if self.doctype == "Purchase Invoice" else self.customer
916 unallocated_amount = tax.tax_amount - tax.allocated_amount
917 if tax_map.get(tax.account_head):
918 amount = tax_map.get(tax.account_head)
919 if amount < unallocated_amount:
920 unallocated_amount = amount
921
922 gl_entries.append(
923 self.get_gl_dict({
924 "account": tax.account_head,
925 "against": party,
926 dr_or_cr: unallocated_amount,
927 dr_or_cr + "_in_account_currency": unallocated_amount
928 if account_currency==self.company_currency
929 else unallocated_amount,
930 "cost_center": tax.cost_center
931 }, account_currency, item=tax))
932
933 gl_entries.append(
934 self.get_gl_dict({
935 "account": pe.advance_tax_account,
936 "against": party,
937 rev_dr_cr: unallocated_amount,
938 rev_dr_cr + "_in_account_currency": unallocated_amount
939 if account_currency==self.company_currency
940 else unallocated_amount,
941 "cost_center": tax.cost_center
942 }, account_currency, item=tax))
943
944 frappe.db.set_value("Advance Taxes and Charges", tax.name, "allocated_amount",
945 tax.allocated_amount + unallocated_amount)
946
947 tax_map[tax.account_head] -= unallocated_amount
948
Nabin Hait19d945a2013-07-29 18:35:39 +0530949 def validate_multiple_billing(self, ref_dt, item_ref_dn, based_on, parentfield):
Nabin Hait868766d2019-07-15 18:02:58 +0530950 from erpnext.controllers.status_updater import get_allowance_for
951 item_allowance = {}
952 global_qty_allowance, global_amount_allowance = None, None
Anand Doshid2946502014-04-08 20:10:03 +0530953
Nabin Hait4b8185d2014-12-25 18:19:39 +0530954 for item in self.get("items"):
Anand Doshif78d1ae2014-03-28 13:55:00 +0530955 if item.get(item_ref_dn):
Anand Doshid2946502014-04-08 20:10:03 +0530956 ref_amt = flt(frappe.db.get_value(ref_dt + " Item",
Nabin Hait868766d2019-07-15 18:02:58 +0530957 item.get(item_ref_dn), based_on), self.precision(based_on, item))
Nabin Haitdc15b4f2014-01-20 16:48:49 +0530958 if not ref_amt:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +0800959 frappe.msgprint(
Nabin Hait868766d2019-07-15 18:02:58 +0530960 _("Warning: System will not check overbilling since amount for Item {0} in {1} is zero")
961 .format(item.item_code, ref_dt))
Nabin Haitdc15b4f2014-01-20 16:48:49 +0530962 else:
Nabin Hait868766d2019-07-15 18:02:58 +0530963 already_billed = frappe.db.sql("""
964 select sum(%s)
965 from `tab%s`
966 where %s=%s and docstatus=1 and parent != %s
967 """ % (based_on, self.doctype + " Item", item_ref_dn, '%s', '%s'),
968 (item.get(item_ref_dn), self.name))[0][0]
Anand Doshid2946502014-04-08 20:10:03 +0530969
970 total_billed_amt = flt(flt(already_billed) + flt(item.get(based_on)),
Nabin Hait868766d2019-07-15 18:02:58 +0530971 self.precision(based_on, item))
Anand Doshid2946502014-04-08 20:10:03 +0530972
Nabin Hait868766d2019-07-15 18:02:58 +0530973 allowance, item_allowance, global_qty_allowance, global_amount_allowance = \
974 get_allowance_for(item.item_code, item_allowance, global_qty_allowance, global_amount_allowance, "amount")
Anand Doshid2946502014-04-08 20:10:03 +0530975
Nabin Hait868766d2019-07-15 18:02:58 +0530976 max_allowed_amt = flt(ref_amt * (100 + allowance) / 100)
Anand Doshid2946502014-04-08 20:10:03 +0530977
rohitwaghchaure285344e2019-10-11 11:02:11 +0530978 if total_billed_amt < 0 and max_allowed_amt < 0:
979 # while making debit note against purchase return entry(purchase receipt) getting overbill error
980 total_billed_amt = abs(total_billed_amt)
981 max_allowed_amt = abs(max_allowed_amt)
982
Deepesh Gargcb718fc2021-04-19 13:25:15 +0530983 role_allowed_to_over_bill = frappe.db.get_single_value('Accounts Settings', 'role_allowed_to_over_bill')
984
985 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 +0530986 if self.doctype != "Purchase Invoice":
987 self.throw_overbill_exception(item, max_allowed_amt)
988 elif not cint(frappe.db.get_single_value("Buying Settings", "bill_for_rejected_quantity_in_purchase_invoice")):
989 self.throw_overbill_exception(item, max_allowed_amt)
990
991 def throw_overbill_exception(self, item, max_allowed_amt):
992 frappe.throw(_("Cannot overbill for Item {0} in row {1} more than {2}. To allow over-billing, please set allowance in Accounts Settings")
993 .format(item.item_code, item.idx, max_allowed_amt))
Anand Doshid2946502014-04-08 20:10:03 +0530994
Nabin Hait0fc24542013-03-25 11:06:00 +0530995 def get_company_default(self, fieldname):
Rushabh Mehta1f847992013-12-12 19:12:19 +0530996 from erpnext.accounts.utils import get_company_default
Anand Doshif78d1ae2014-03-28 13:55:00 +0530997 return get_company_default(self.company, fieldname)
Anand Doshid2946502014-04-08 20:10:03 +0530998
Nabin Haita36adbd2013-08-02 14:50:12 +0530999 def get_stock_items(self):
1000 stock_items = []
Nabin Haitdd38a262014-12-26 13:15:21 +05301001 item_codes = list(set(item.item_code for item in self.get("items")))
Nabin Haita36adbd2013-08-02 14:50:12 +05301002 if item_codes:
Nabin Hait868766d2019-07-15 18:02:58 +05301003 stock_items = [r[0] for r in frappe.db.sql("""
1004 select name from `tabItem`
1005 where name in (%s) and is_stock_item=1
1006 """ % (", ".join((["%s"] * len(item_codes))),), item_codes)]
Anand Doshid2946502014-04-08 20:10:03 +05301007
Nabin Haita36adbd2013-08-02 14:50:12 +05301008 return stock_items
Anand Doshid2946502014-04-08 20:10:03 +05301009
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301010 def set_total_advance_paid(self):
1011 if self.doctype == "Sales Order":
Nabin Hait6e439a52015-08-28 19:24:22 +05301012 dr_or_cr = "credit_in_account_currency"
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301013 rev_dr_or_cr = "debit_in_account_currency"
Nabin Haitb2206d12016-01-27 15:43:12 +05301014 party = self.customer
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301015 else:
Nabin Hait6e439a52015-08-28 19:24:22 +05301016 dr_or_cr = "debit_in_account_currency"
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301017 rev_dr_or_cr = "credit_in_account_currency"
Nabin Haitb2206d12016-01-27 15:43:12 +05301018 party = self.supplier
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301019
Nabin Haitb2206d12016-01-27 15:43:12 +05301020 advance = frappe.db.sql("""
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301021 select
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301022 account_currency, sum({dr_or_cr}) - sum({rev_dr_cr}) as amount
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301023 from
Nabin Hait12e2a512016-06-26 01:37:21 +05301024 `tabGL Entry`
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301025 where
Nabin Hait12e2a512016-06-26 01:37:21 +05301026 against_voucher_type = %s and against_voucher = %s and party=%s
1027 and docstatus = 1
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301028 """.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 +05301029
Nabin Haitb2206d12016-01-27 15:43:12 +05301030 if advance:
Anand Doshi7c0a58a2016-01-29 12:16:24 +05301031 advance = advance[0]
Deepesh Garg2a9c5ba2020-04-30 10:38:58 +05301032
Anand Doshi7c0a58a2016-01-29 12:16:24 +05301033 advance_paid = flt(advance.amount, self.precision("advance_paid"))
1034 formatted_advance_paid = fmt_money(advance_paid, precision=self.precision("advance_paid"),
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001035 currency=advance.account_currency)
Anand Doshi7c0a58a2016-01-29 12:16:24 +05301036
1037 frappe.db.set_value(self.doctype, self.name, "party_account_currency",
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001038 advance.account_currency)
Anand Doshi7c0a58a2016-01-29 12:16:24 +05301039
1040 if advance.account_currency == self.currency:
finbyz5efc7972019-01-05 11:12:11 +05301041 order_total = self.get("rounded_total") or self.grand_total
1042 precision = "rounded_total" if self.get("rounded_total") else "grand_total"
Nabin Haitb2206d12016-01-27 15:43:12 +05301043 else:
finbyz5efc7972019-01-05 11:12:11 +05301044 order_total = self.get("base_rounded_total") or self.base_grand_total
1045 precision = "base_rounded_total" if self.get("base_rounded_total") else "base_grand_total"
Sagar Voraf733a392019-01-07 14:24:01 +05301046
finbyz5efc7972019-01-05 11:12:11 +05301047 formatted_order_total = fmt_money(order_total, precision=self.precision(precision),
1048 currency=advance.account_currency)
Anand Doshi7c0a58a2016-01-29 12:16:24 +05301049
Nabin Hait9db1b222016-06-30 12:37:53 +05301050 if self.currency == self.company_currency and advance_paid > order_total:
Nabin Haitb2206d12016-01-27 15:43:12 +05301051 frappe.throw(_("Total advance ({0}) against Order {1} cannot be greater than the Grand Total ({2})")
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001052 .format(formatted_advance_paid, self.name, formatted_order_total))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301053
Nabin Hait13093b42016-06-29 18:04:37 +05301054 frappe.db.set_value(self.doctype, self.name, "advance_paid", advance_paid)
Ankit Javalkar8e7ca412014-09-12 15:18:53 +05301055
ankitjavalkarworke60822b2014-08-26 14:29:06 +05301056 @property
1057 def company_abbr(self):
Nabin Hait6a5695f2018-08-09 11:30:21 +05301058 if not hasattr(self, "_abbr"):
1059 self._abbr = frappe.db.get_value('Company', self.company, "abbr")
ankitjavalkarworke60822b2014-08-26 14:29:06 +05301060
1061 return self._abbr
1062
marination4be5b5c2020-10-08 19:08:27 +05301063 def raise_missing_debit_credit_account_error(self, party_type, party):
marination53b1a9a2020-11-03 15:45:25 +05301064 """Raise an error if debit to/credit to account does not exist."""
marination4be5b5c2020-10-08 19:08:27 +05301065 db_or_cr = frappe.bold("Debit To") if self.doctype == "Sales Invoice" else frappe.bold("Credit To")
1066 rec_or_pay = "Receivable" if self.doctype == "Sales Invoice" else "Payable"
1067
1068 link_to_party = frappe.utils.get_link_to_form(party_type, party)
1069 link_to_company = frappe.utils.get_link_to_form("Company", self.company)
1070
1071 message = _("{0} Account not found against Customer {1}.").format(db_or_cr, frappe.bold(party) or '')
1072 message += "<br>" + _("Please set one of the following:") + "<br>"
1073 message += "<br><ul><li>" + _("'Account' in the Accounting section of Customer {0}").format(link_to_party) + "</li>"
1074 message += "<li>" + _("'Default {0} Account' in Company {1}").format(rec_or_pay, link_to_company) + "</li></ul>"
1075
marination53b1a9a2020-11-03 15:45:25 +05301076 frappe.throw(message, title=_("Account Missing"), exc=AccountMissingError)
marination4be5b5c2020-10-08 19:08:27 +05301077
Neil Trini Lasrado3fbbb712015-07-17 12:10:12 +05301078 def validate_party(self):
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301079 party_type, party = self.get_party()
shreyaseba9ca42016-01-26 14:56:52 +05301080 validate_party_frozen_disabled(party_type, party)
Anand Doshi979326b2015-09-11 16:22:37 +05301081
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301082 def get_party(self):
Neil Trini Lasrado79bf2332015-07-20 13:03:48 +05301083 party_type = None
shreyas29b565f2016-01-25 17:30:49 +05301084 if self.doctype in ("Opportunity", "Quotation", "Sales Order", "Delivery Note", "Sales Invoice"):
shreyaseba9ca42016-01-26 14:56:52 +05301085 party_type = 'Customer'
shreyas29b565f2016-01-25 17:30:49 +05301086
1087 elif self.doctype in ("Supplier Quotation", "Purchase Order", "Purchase Receipt", "Purchase Invoice"):
shreyaseba9ca42016-01-26 14:56:52 +05301088 party_type = 'Supplier'
shreyas29b565f2016-01-25 17:30:49 +05301089
1090 elif self.meta.get_field("customer"):
1091 party_type = "Customer"
Neil Trini Lasrado3fbbb712015-07-17 12:10:12 +05301092
Neil Trini Lasrado79bf2332015-07-20 13:03:48 +05301093 elif self.meta.get_field("supplier"):
shreyas29b565f2016-01-25 17:30:49 +05301094 party_type = "Supplier"
Anand Doshi979326b2015-09-11 16:22:37 +05301095
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301096 party = self.get(party_type.lower()) if party_type else None
Anand Doshi979326b2015-09-11 16:22:37 +05301097
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301098 return party_type, party
Anand Doshi979326b2015-09-11 16:22:37 +05301099
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301100 def validate_currency(self):
Nabin Hait6e439a52015-08-28 19:24:22 +05301101 if self.get("currency"):
Nabin Hait4ffd7f32015-08-27 12:28:36 +05301102 party_type, party = self.get_party()
Nabin Hait6e439a52015-08-28 19:24:22 +05301103 if party_type and party:
Anand Doshib20baf82015-09-25 16:17:50 +05301104 party_account_currency = get_party_account_currency(party_type, party, self.company)
Anand Doshi979326b2015-09-11 16:22:37 +05301105
Anand Doshi7afaeb02015-10-01 18:55:25 +05301106 if (party_account_currency
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001107 and party_account_currency != self.company_currency
1108 and self.currency != party_account_currency):
Nabin Hait98096772015-09-03 10:28:08 +05301109 frappe.throw(_("Accounting Entry for {0}: {1} can only be made in currency: {2}")
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001110 .format(party_type, party, party_account_currency), InvalidCurrency)
Anand Doshi979326b2015-09-11 16:22:37 +05301111
shreyas29b565f2016-01-25 17:30:49 +05301112 # Note: not validating with gle account because we don't have the account
1113 # at quotation / sales order level and we shouldn't stop someone
1114 # from creating a sales invoice if sales order is already created
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +05301115
Nabin Hait297d74a2016-11-23 15:58:51 +05301116 def delink_advance_entries(self, linked_doc_name):
1117 total_allocated_amount = 0
1118 for adv in self.advances:
1119 consider_for_total_advance = True
1120 if adv.reference_name == linked_doc_name:
1121 frappe.db.sql("""delete from `tab{0} Advance`
1122 where name = %s""".format(self.doctype), adv.name)
1123 consider_for_total_advance = False
1124
1125 if consider_for_total_advance:
1126 total_allocated_amount += flt(adv.allocated_amount, adv.precision("allocated_amount"))
1127
Rushabh Mehta66958302017-01-16 16:57:53 +05301128 frappe.db.set_value(self.doctype, self.name, "total_advance",
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001129 total_allocated_amount, update_modified=False)
Rohit Waghchaure6087fe12016-04-09 14:31:09 +05301130
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301131 def group_similar_items(self):
1132 group_item_qty = {}
1133 group_item_amount = {}
Shreya Shah785f1aa2018-10-11 10:14:25 +05301134 # to update serial number in print
1135 count = 0
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301136
1137 for item in self.items:
1138 group_item_qty[item.item_code] = group_item_qty.get(item.item_code, 0) + item.qty
1139 group_item_amount[item.item_code] = group_item_amount.get(item.item_code, 0) + item.amount
1140
1141 duplicate_list = []
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301142 for item in self.items:
1143 if item.item_code in group_item_qty:
Shreya Shah785f1aa2018-10-11 10:14:25 +05301144 count += 1
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301145 item.qty = group_item_qty[item.item_code]
1146 item.amount = group_item_amount[item.item_code]
deepeshgarg007e8d21cd2019-06-24 17:46:44 +05301147
1148 if item.qty:
1149 item.rate = flt(flt(item.amount) / flt(item.qty), item.precision("rate"))
1150 else:
1151 item.rate = 0
1152
Shreya Shah785f1aa2018-10-11 10:14:25 +05301153 item.idx = count
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301154 del group_item_qty[item.item_code]
1155 else:
1156 duplicate_list.append(item)
KanchanChauhan49a50fe2016-11-18 13:57:53 +05301157 for item in duplicate_list:
1158 self.remove(item)
1159
tunde32aa7c12017-09-07 06:52:15 +01001160 def set_payment_schedule(self):
Manas Solankia7f55892018-04-02 10:32:00 +05301161 if self.doctype == 'Sales Invoice' and self.is_pos:
1162 self.payment_terms_template = ''
1163 return
rohitwaghchauredb9fa782018-03-01 10:32:29 +05301164
Deepesh Garg26210162020-08-11 16:06:13 +05301165 party_account_currency = self.get('party_account_currency')
1166 if not party_account_currency:
1167 party_type, party = self.get_party()
1168
1169 if party_type and party:
1170 party_account_currency = get_party_account_currency(party_type, party, self.company)
1171
rohitwaghchaureda941af2018-01-17 16:23:04 +05301172 posting_date = self.get("bill_date") or self.get("posting_date") or self.get("transaction_date")
tundedf3a1752017-09-11 11:02:57 +01001173 date = self.get("due_date")
1174 due_date = date or posting_date
Deepesh Garg26210162020-08-11 16:06:13 +05301175
Saqib Ansarid552fe62021-04-23 14:46:52 +05301176 base_grand_total = self.get("base_rounded_total") or self.base_grand_total
1177 grand_total = self.get("rounded_total") or self.grand_total
Deepesh Garg26210162020-08-11 16:06:13 +05301178
Nabin Hait2f9f4f92017-12-20 12:24:59 +05301179 if self.doctype in ("Sales Invoice", "Purchase Invoice"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301180 base_grand_total = base_grand_total - flt(self.base_write_off_amount)
Nabin Hait2f9f4f92017-12-20 12:24:59 +05301181 grand_total = grand_total - flt(self.write_off_amount)
Deepesh Garg0bba4252021-08-06 23:53:16 +05301182 po_or_so, doctype, fieldname = self.get_order_details()
1183 automatically_fetch_payment_terms = cint(frappe.db.get_single_value('Accounts Settings', 'automatically_fetch_payment_terms'))
tunde96b8f222017-09-08 15:35:59 +01001184
Rohit Waghchaure4a267b92019-05-09 19:50:00 +05301185 if self.get("total_advance"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301186 if party_account_currency == self.company_currency:
1187 base_grand_total -= self.get("total_advance")
1188 grand_total = flt(base_grand_total / self.get("conversion_rate"), self.precision("grand_total"))
1189 else:
1190 grand_total -= self.get("total_advance")
1191 base_grand_total = flt(grand_total * self.get("conversion_rate"), self.precision("base_grand_total"))
Rohit Waghchaure4a267b92019-05-09 19:50:00 +05301192
Nabin Hait0551f7b2017-11-21 19:58:16 +05301193 if not self.get("payment_schedule"):
Deepesh Garga27ef142021-08-07 00:12:57 +05301194 if self.doctype in ["Sales Invoice", "Purchase Invoice"] and automatically_fetch_payment_terms \
1195 and self.linked_order_has_payment_terms(po_or_so, fieldname, doctype):
Deepesh Garg0bba4252021-08-06 23:53:16 +05301196 self.fetch_payment_terms_from_order(po_or_so, doctype)
1197 if self.get('payment_terms_template'):
1198 self.ignore_default_payment_terms_template = 1
1199 elif self.get("payment_terms_template"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301200 data = get_payment_terms(self.payment_terms_template, posting_date, grand_total, base_grand_total)
Nabin Hait0551f7b2017-11-21 19:58:16 +05301201 for item in data:
1202 self.append("payment_schedule", item)
GangaManojdef7cc62021-07-22 05:57:42 +05301203 elif self.doctype not in ["Purchase Receipt"]:
Saqib Ansarida5b55c2021-04-28 14:55:33 +05301204 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 +05301205 self.append("payment_schedule", data)
Subin Tom06fb0b92021-07-26 16:46:47 +05301206
Deepesh Garg0bba4252021-08-06 23:53:16 +05301207 for d in self.get("payment_schedule"):
1208 if d.invoice_portion:
1209 d.payment_amount = flt(grand_total * flt(d.invoice_portion / 100), d.precision('payment_amount'))
1210 d.base_payment_amount = flt(base_grand_total * flt(d.invoice_portion / 100), d.precision('base_payment_amount'))
1211 d.outstanding = d.payment_amount
1212 elif not d.invoice_portion:
1213 d.base_payment_amount = flt(base_grand_total * self.get("conversion_rate"), d.precision('base_payment_amount'))
Nabin Hait0551f7b2017-11-21 19:58:16 +05301214
1215
GangaManojdef7cc62021-07-22 05:57:42 +05301216 def get_order_details(self):
1217 if self.doctype == "Sales Invoice":
1218 po_or_so = self.get('items')[0].get('sales_order')
1219 po_or_so_doctype = "Sales Order"
1220 po_or_so_doctype_name = "sales_order"
1221
tundedf3a1752017-09-11 11:02:57 +01001222 else:
GangaManojdef7cc62021-07-22 05:57:42 +05301223 po_or_so = self.get('items')[0].get('purchase_order')
1224 po_or_so_doctype = "Purchase Order"
1225 po_or_so_doctype_name = "purchase_order"
1226
1227 return po_or_so, po_or_so_doctype, po_or_so_doctype_name
1228
GangaManoj01ab6312021-07-29 19:18:35 +05301229 def linked_order_has_payment_terms(self, po_or_so, fieldname, doctype):
GangaManojdef7cc62021-07-22 05:57:42 +05301230 if po_or_so and self.all_items_have_same_po_or_so(po_or_so, fieldname):
GangaManoj01ab6312021-07-29 19:18:35 +05301231 if self.linked_order_has_payment_terms_template(po_or_so, doctype):
GangaManojdef7cc62021-07-22 05:57:42 +05301232 return True
1233 elif self.linked_order_has_payment_schedule(po_or_so):
1234 return True
1235
1236 return False
1237
1238 def all_items_have_same_po_or_so(self, po_or_so, fieldname):
1239 for item in self.get('items'):
1240 if item.get(fieldname) != po_or_so:
1241 return False
1242
1243 return True
1244
GangaManoj01ab6312021-07-29 19:18:35 +05301245 def linked_order_has_payment_terms_template(self, po_or_so, doctype):
1246 return frappe.get_value(doctype, po_or_so, 'payment_terms_template')
GangaManojdef7cc62021-07-22 05:57:42 +05301247
1248 def linked_order_has_payment_schedule(self, po_or_so):
1249 return frappe.get_all('Payment Schedule', filters={'parent': po_or_so})
1250
1251 def fetch_payment_terms_from_order(self, po_or_so, po_or_so_doctype):
1252 """
1253 Fetch Payment Terms from Purchase/Sales Order on creating a new Purchase/Sales Invoice.
1254 """
1255 po_or_so = frappe.get_cached_doc(po_or_so_doctype, po_or_so)
1256
1257 self.payment_schedule = []
1258 self.payment_terms_template = po_or_so.payment_terms_template
1259
1260 for schedule in po_or_so.payment_schedule:
1261 payment_schedule = {
1262 'payment_term': schedule.payment_term,
1263 'due_date': schedule.due_date,
1264 'invoice_portion': schedule.invoice_portion,
GangaManoj5c21eea2021-08-05 21:50:09 +05301265 'mode_of_payment': schedule.mode_of_payment,
1266 'description': schedule.description
GangaManojdef7cc62021-07-22 05:57:42 +05301267 }
GangaManoj5c21eea2021-08-05 21:50:09 +05301268
1269 if schedule.discount_type == 'Percentage':
1270 payment_schedule['discount_type'] = schedule.discount_type
1271 payment_schedule['discount'] = schedule.discount
1272
GangaManojdef7cc62021-07-22 05:57:42 +05301273 self.append("payment_schedule", payment_schedule)
tunde43870aa2017-08-18 11:59:30 +01001274
tundebe1b8712017-08-19 08:21:44 +01001275 def set_due_date(self):
Nabin Hait0551f7b2017-11-21 19:58:16 +05301276 due_dates = [d.due_date for d in self.get("payment_schedule") if d.due_date]
1277 if due_dates:
1278 self.due_date = max(due_dates)
tunde62af5c52017-09-22 15:16:38 +01001279
1280 def validate_payment_schedule_dates(self):
tunde77ecacc2017-09-22 23:12:55 +01001281 dates = []
tunde9bed2de2017-09-25 10:19:35 +01001282 li = []
tunde43870aa2017-08-18 11:59:30 +01001283
rohitwaghchauredb9fa782018-03-01 10:32:29 +05301284 if self.doctype == 'Sales Invoice' and self.is_pos: return
1285
tunde43870aa2017-08-18 11:59:30 +01001286 for d in self.get("payment_schedule"):
Nabin Hait2f9f4f92017-12-20 12:24:59 +05301287 if self.doctype == "Sales Order" and getdate(d.due_date) < getdate(self.transaction_date):
Michelle Alva7f2477b2020-04-09 17:23:23 +05301288 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 +01001289 elif d.due_date in dates:
mnatalia5f0e8d62018-05-22 06:38:50 +03001290 li.append(_("{0} in row {1}").format(d.due_date, d.idx))
tunde9bed2de2017-09-25 10:19:35 +01001291 dates.append(d.due_date)
1292
1293 if li:
1294 duplicates = '<br>' + '<br>'.join(li)
Faris Ansari2ab6e0e2018-09-19 13:13:59 +05301295 frappe.throw(_("Rows with duplicate due dates in other rows were found: {0}").format(duplicates))
tunde43870aa2017-08-18 11:59:30 +01001296
tunde62af5c52017-09-22 15:16:38 +01001297 def validate_payment_schedule_amount(self):
rohitwaghchauredb9fa782018-03-01 10:32:29 +05301298 if self.doctype == 'Sales Invoice' and self.is_pos: return
1299
Deepesh Garg26210162020-08-11 16:06:13 +05301300 party_account_currency = self.get('party_account_currency')
1301 if not party_account_currency:
1302 party_type, party = self.get_party()
1303
1304 if party_type and party:
1305 party_account_currency = get_party_account_currency(party_type, party, self.company)
1306
Nabin Hait0551f7b2017-11-21 19:58:16 +05301307 if self.get("payment_schedule"):
1308 total = 0
Saqib Ansarid552fe62021-04-23 14:46:52 +05301309 base_total = 0
Nabin Hait0551f7b2017-11-21 19:58:16 +05301310 for d in self.get("payment_schedule"):
Nabin Haitf592f2c2017-12-19 11:31:34 +05301311 total += flt(d.payment_amount)
Saqib Ansarid552fe62021-04-23 14:46:52 +05301312 base_total += flt(d.base_payment_amount)
tunde43870aa2017-08-18 11:59:30 +01001313
Saqib Ansarid552fe62021-04-23 14:46:52 +05301314 base_grand_total = self.get("base_rounded_total") or self.base_grand_total
1315 grand_total = self.get("rounded_total") or self.grand_total
Rohit Waghchaure4a267b92019-05-09 19:50:00 +05301316
Nabin Haite591c852017-12-21 11:46:30 +05301317 if self.doctype in ("Sales Invoice", "Purchase Invoice"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301318 base_grand_total = base_grand_total - flt(self.base_write_off_amount)
Nabin Haite591c852017-12-21 11:46:30 +05301319 grand_total = grand_total - flt(self.write_off_amount)
Saqib Ansarid552fe62021-04-23 14:46:52 +05301320
1321 if self.get("total_advance"):
1322 if party_account_currency == self.company_currency:
1323 base_grand_total -= self.get("total_advance")
1324 grand_total = flt(base_grand_total / self.get("conversion_rate"), self.precision("grand_total"))
1325 else:
1326 grand_total -= self.get("total_advance")
1327 base_grand_total = flt(grand_total * self.get("conversion_rate"), self.precision("base_grand_total"))
Saqib Ansarid552fe62021-04-23 14:46:52 +05301328 if total != flt(grand_total, self.precision("grand_total")) or \
1329 base_total != flt(base_grand_total, self.precision("base_grand_total")):
Nabin Hait0551f7b2017-11-21 19:58:16 +05301330 frappe.throw(_("Total Payment Amount in Payment Schedule must be equal to Grand / Rounded Total"))
tunde43870aa2017-08-18 11:59:30 +01001331
Nabin Hait877e1bb2017-11-17 12:27:43 +05301332 def is_rounded_total_disabled(self):
1333 if self.meta.get_field("disable_rounded_total"):
1334 return self.disable_rounded_total
1335 else:
1336 return frappe.db.get_single_value("Global Defaults", "disable_rounded_total")
1337
Deepesh Gargf17ea2c2020-12-11 21:30:39 +05301338 def set_inter_company_account(self):
1339 """
1340 Set intercompany account for inter warehouse transactions
1341 This account will be used in case billing company and internal customer's
1342 representation company is same
1343 """
1344
1345 if self.is_internal_transfer() and not self.unrealized_profit_loss_account:
1346 unrealized_profit_loss_account = frappe.db.get_value('Company', self.company, 'unrealized_profit_loss_account')
1347
1348 if not unrealized_profit_loss_account:
1349 msg = _("Please select Unrealized Profit / Loss account or add default Unrealized Profit / Loss account account for company {0}").format(
1350 frappe.bold(self.company))
1351 frappe.throw(msg)
1352
1353 self.unrealized_profit_loss_account = unrealized_profit_loss_account
1354
1355 def is_internal_transfer(self):
1356 """
1357 It will an internal transfer if its an internal customer and representation
1358 company is same as billing company
1359 """
Deepesh Gargb4be2922021-01-28 13:09:56 +05301360 if self.doctype in ('Sales Invoice', 'Delivery Note', 'Sales Order'):
Deepesh Gargf17ea2c2020-12-11 21:30:39 +05301361 internal_party_field = 'is_internal_customer'
Deepesh Gargb4be2922021-01-28 13:09:56 +05301362 elif self.doctype in ('Purchase Invoice', 'Purchase Receipt', 'Purchase Order'):
Deepesh Gargf17ea2c2020-12-11 21:30:39 +05301363 internal_party_field = 'is_internal_supplier'
1364
1365 if self.get(internal_party_field) and (self.represents_company == self.company):
1366 return True
1367
1368 return False
1369
Rushabh Mehta793ba6b2014-02-14 15:47:51 +05301370@frappe.whitelist()
Rushabh Mehtaf56d73c2013-10-10 16:35:09 +05301371def get_tax_rate(account_head):
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +05301372 return frappe.db.get_value("Account", account_head, ["tax_rate", "account_name"], as_dict=True)
Rushabh Mehtaa33d4682015-06-01 17:15:42 +05301373
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001374
Nabin Haitffc7f3f2015-05-12 15:07:02 +05301375@frappe.whitelist()
Nabin Haita2426fc2018-01-15 17:45:46 +05301376def get_default_taxes_and_charges(master_doctype, tax_template=None, company=None):
rohitwaghchaure505661b2017-12-11 14:52:28 +05301377 if not company: return {}
1378
Nabin Haita2426fc2018-01-15 17:45:46 +05301379 if tax_template and company:
1380 tax_template_company = frappe.db.get_value(master_doctype, tax_template, "company")
1381 if tax_template_company == company:
1382 return
1383
1384 default_tax = frappe.db.get_value(master_doctype, {"is_default": 1, "company": company})
rohitwaghchaure505661b2017-12-11 14:52:28 +05301385
Rushabh Mehta98aa5812017-11-14 09:32:32 +05301386 return {
1387 'taxes_and_charges': default_tax,
1388 'taxes': get_taxes_and_charges(master_doctype, default_tax)
1389 }
Nabin Hait6b039142014-05-02 15:45:10 +05301390
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001391
Nabin Hait6b039142014-05-02 15:45:10 +05301392@frappe.whitelist()
Nabin Haitffc7f3f2015-05-12 15:07:02 +05301393def get_taxes_and_charges(master_doctype, master_name):
Nabin Hait1fe50122015-05-16 12:14:39 +05301394 if not master_name:
1395 return
Nabin Hait6b039142014-05-02 15:45:10 +05301396 from frappe.model import default_fields
1397 tax_master = frappe.get_doc(master_doctype, master_name)
1398
1399 taxes_and_charges = []
Nabin Haitffc7f3f2015-05-12 15:07:02 +05301400 for i, tax in enumerate(tax_master.get("taxes")):
Nabin Hait6b039142014-05-02 15:45:10 +05301401 tax = tax.as_dict()
1402
1403 for fieldname in default_fields:
1404 if fieldname in tax:
1405 del tax[fieldname]
1406
1407 taxes_and_charges.append(tax)
1408
1409 return taxes_and_charges
Rushabh Mehta66e08e32014-09-29 12:17:03 +05301410
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001411
Rushabh Mehta66e08e32014-09-29 12:17:03 +05301412def validate_conversion_rate(currency, conversion_rate, conversion_rate_label, company):
1413 """common validation for currency and price list currency"""
1414
Rushabh Mehta708e47a2018-08-08 16:37:31 +05301415 company_currency = frappe.get_cached_value('Company', company, "default_currency")
Rushabh Mehta66e08e32014-09-29 12:17:03 +05301416
1417 if not conversion_rate:
Saqib60212ff2020-10-26 11:17:04 +05301418 throw(
1419 _("{0} is mandatory. Maybe Currency Exchange record is not created for {1} to {2}.")
1420 .format(conversion_rate_label, currency, company_currency)
1421 )
Nabin Hait613d0812015-02-23 11:58:15 +05301422
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001423
Nabin Hait613d0812015-02-23 11:58:15 +05301424def validate_taxes_and_charges(tax):
Deepesh Garg58034632021-06-14 11:16:39 +05301425 if tax.charge_type in ['Actual', 'On Net Total', 'On Paid Amount'] and tax.row_id:
Nabin Hait613d0812015-02-23 11:58:15 +05301426 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 +05301427 elif tax.charge_type in ['On Previous Row Amount', 'On Previous Row Total']:
Nabin Hait613d0812015-02-23 11:58:15 +05301428 if cint(tax.idx) == 1:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001429 frappe.throw(
1430 _("Cannot select charge type as 'On Previous Row Amount' or 'On Previous Row Total' for first row"))
Nabin Hait613d0812015-02-23 11:58:15 +05301431 elif not tax.row_id:
Suraj Shetty48e9bc32020-01-29 15:06:18 +05301432 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 +05301433 elif tax.row_id and cint(tax.row_id) >= cint(tax.idx):
1434 frappe.throw(_("Cannot refer row number greater than or equal to current row number for this Charge type"))
1435
Rushabh Mehta2a21bc92015-02-25 15:08:42 +05301436 if tax.charge_type == "Actual":
Nabin Haitbc6c3602015-02-27 23:40:56 +05301437 tax.rate = None
Rushabh Mehta2a21bc92015-02-25 15:08:42 +05301438
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001439
Nabin Hait613d0812015-02-23 11:58:15 +05301440def validate_inclusive_tax(tax, doc):
1441 def _on_previous_row_error(row_range):
Deepesh Garg58034632021-06-14 11:16:39 +05301442 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 +05301443
Deepesh Garg87180132021-06-14 14:34:44 +05301444 if cint(getattr(tax, "included_in_print_rate", None)):
1445 if tax.charge_type == "Actual":
1446 # inclusive tax cannot be of type Actual
1447 throw(_("Charge of type 'Actual' in row {0} cannot be included in Item Rate or Paid Amount").format(tax.idx))
1448 elif tax.charge_type == "On Previous Row Amount" and \
1449 not cint(doc.get("taxes")[cint(tax.row_id) - 1].included_in_print_rate):
1450 # referred row should also be inclusive
1451 _on_previous_row_error(tax.row_id)
1452 elif tax.charge_type == "On Previous Row Total" and \
Deepesh Garg4cd0f6c2021-06-14 20:01:04 +05301453 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 +05301454 # all rows about the referred tax should be inclusive
Deepesh Garg4cd0f6c2021-06-14 20:01:04 +05301455 _on_previous_row_error("1 - %d" % (tax.row_id,))
Deepesh Garg87180132021-06-14 14:34:44 +05301456 elif tax.get("category") == "Valuation":
1457 frappe.throw(_("Valuation type charges can not be marked as Inclusive"))
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301458
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301459
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001460def set_balance_in_account_currency(gl_dict, account_currency=None, conversion_rate=None, company_currency=None):
1461 if (not conversion_rate) and (account_currency != company_currency):
1462 frappe.throw(_("Account: {0} with currency: {1} can not be selected")
1463 .format(gl_dict.account, account_currency))
1464
1465 gl_dict["account_currency"] = company_currency if account_currency == company_currency \
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301466 else account_currency
1467
1468 # set debit/credit in account currency if not provided
1469 if flt(gl_dict.debit) and not flt(gl_dict.debit_in_account_currency):
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001470 gl_dict.debit_in_account_currency = gl_dict.debit if account_currency == company_currency \
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301471 else flt(gl_dict.debit / conversion_rate, 2)
1472
1473 if flt(gl_dict.credit) and not flt(gl_dict.credit_in_account_currency):
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001474 gl_dict.credit_in_account_currency = gl_dict.credit if account_currency == company_currency \
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301475 else flt(gl_dict.credit / conversion_rate, 2)
Nabin Hait1991c7b2016-06-27 20:09:05 +05301476
1477
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301478def get_advance_journal_entries(party_type, party, party_account, amount_field,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001479 order_doctype, order_list, include_unallocated=True):
1480 dr_or_cr = "credit_in_account_currency" if party_type == "Customer" else "debit_in_account_currency"
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301481
Nabin Hait1991c7b2016-06-27 20:09:05 +05301482 conditions = []
1483 if include_unallocated:
1484 conditions.append("ifnull(t2.reference_name, '')=''")
1485
1486 if order_list:
1487 order_condition = ', '.join(['%s'] * len(order_list))
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001488 conditions.append(" (t2.reference_type = '{0}' and ifnull(t2.reference_name, '') in ({1}))" \
1489 .format(order_doctype, order_condition))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301490
Nabin Hait1991c7b2016-06-27 20:09:05 +05301491 reference_condition = " and (" + " or ".join(conditions) + ")" if conditions else ""
Rushabh Mehta66958302017-01-16 16:57:53 +05301492
Nabin Hait1991c7b2016-06-27 20:09:05 +05301493 journal_entries = frappe.db.sql("""
1494 select
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301495 "Journal Entry" as reference_type, t1.name as reference_name,
Nabin Hait1991c7b2016-06-27 20:09:05 +05301496 t1.remark as remarks, t2.{0} as amount, t2.name as reference_row,
1497 t2.reference_name as against_order
1498 from
1499 `tabJournal Entry` t1, `tabJournal Entry Account` t2
1500 where
1501 t1.name = t2.parent and t2.account = %s
1502 and t2.party_type = %s and t2.party = %s
1503 and t2.is_advance = 'Yes' and t1.docstatus = 1
Nabin Haitca627fb2016-09-05 16:16:53 +05301504 and {1} > 0 {2}
Nabin Hait1991c7b2016-06-27 20:09:05 +05301505 order by t1.posting_date""".format(amount_field, dr_or_cr, reference_condition),
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001506 [party_account, party_type, party] + order_list, as_dict=1)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301507
Nabin Hait1991c7b2016-06-27 20:09:05 +05301508 return list(journal_entries)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301509
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001510
Rohit Waghchauref7258162019-01-15 18:12:04 +05301511def get_advance_payment_entries(party_type, party, party_account, order_doctype,
Nabin Hait34c551d2019-07-03 10:34:31 +05301512 order_list=None, include_unallocated=True, against_all_orders=False, limit=None):
Nabin Hait1991c7b2016-06-27 20:09:05 +05301513 party_account_field = "paid_from" if party_type == "Customer" else "paid_to"
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301514 currency_field = "paid_from_account_currency" if party_type == "Customer" else "paid_to_account_currency"
Nabin Hait1991c7b2016-06-27 20:09:05 +05301515 payment_type = "Receive" if party_type == "Customer" else "Pay"
Saqib7fb64d12021-07-12 18:33:16 +05301516 exchange_rate_field = "source_exchange_rate" if payment_type == "Receive" else "target_exchange_rate"
1517
Nabin Hait1991c7b2016-06-27 20:09:05 +05301518 payment_entries_against_order, unallocated_payment_entries = [], []
Nabin Hait34c551d2019-07-03 10:34:31 +05301519 limit_cond = "limit %s" % limit if limit else ""
Nabin Haitff2f3ef2016-07-04 11:41:14 +05301520
Nabin Hait1991c7b2016-06-27 20:09:05 +05301521 if order_list or against_all_orders:
1522 if order_list:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001523 reference_condition = " and t2.reference_name in ({0})" \
Nabin Hait1991c7b2016-06-27 20:09:05 +05301524 .format(', '.join(['%s'] * len(order_list)))
1525 else:
1526 reference_condition = ""
1527 order_list = []
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301528
Nabin Hait1991c7b2016-06-27 20:09:05 +05301529 payment_entries_against_order = frappe.db.sql("""
1530 select
1531 "Payment Entry" as reference_type, t1.name as reference_name,
1532 t1.remarks, t2.allocated_amount as amount, t2.name as reference_row,
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301533 t2.reference_name as against_order, t1.posting_date,
Saqib7fb64d12021-07-12 18:33:16 +05301534 t1.{0} as currency, t1.{4} as exchange_rate
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301535 from `tabPayment Entry` t1, `tabPayment Entry Reference` t2
Nabin Hait1991c7b2016-06-27 20:09:05 +05301536 where
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301537 t1.name = t2.parent and t1.{1} = %s and t1.payment_type = %s
Nabin Hait1991c7b2016-06-27 20:09:05 +05301538 and t1.party_type = %s and t1.party = %s and t1.docstatus = 1
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301539 and t2.reference_doctype = %s {2}
1540 order by t1.posting_date {3}
Saqib7fb64d12021-07-12 18:33:16 +05301541 """.format(currency_field, party_account_field, reference_condition, limit_cond, exchange_rate_field),
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001542 [party_account, payment_type, party_type, party,
1543 order_doctype] + order_list, as_dict=1)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301544
Nabin Hait1991c7b2016-06-27 20:09:05 +05301545 if include_unallocated:
1546 unallocated_payment_entries = frappe.db.sql("""
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301547 select "Payment Entry" as reference_type, name as reference_name,
Saqib7fb64d12021-07-12 18:33:16 +05301548 remarks, unallocated_amount as amount, {2} as exchange_rate
Nabin Hait1991c7b2016-06-27 20:09:05 +05301549 from `tabPayment Entry`
1550 where
1551 {0} = %s and party_type = %s and party = %s and payment_type = %s
1552 and docstatus = 1 and unallocated_amount > 0
Rohit Waghchauref7258162019-01-15 18:12:04 +05301553 order by posting_date {1}
Saqib7fb64d12021-07-12 18:33:16 +05301554 """.format(party_account_field, limit_cond, exchange_rate_field),
1555 (party_account, party_type, party, payment_type), as_dict=1)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301556
Rohit Waghchaure2f1db572016-11-08 12:39:33 +05301557 return list(payment_entries_against_order) + list(unallocated_payment_entries)
1558
1559def update_invoice_status():
1560 # Daily update the status of the invoices
1561
Rushabh Mehta66958302017-01-16 16:57:53 +05301562 frappe.db.sql(""" update `tabSales Invoice` set status = 'Overdue'
Rohit Waghchaure2f1db572016-11-08 12:39:33 +05301563 where due_date < CURDATE() and docstatus = 1 and outstanding_amount > 0""")
1564
Rushabh Mehta66958302017-01-16 16:57:53 +05301565 frappe.db.sql(""" update `tabPurchase Invoice` set status = 'Overdue'
Nabin Hait92759692017-08-15 08:23:51 +05301566 where due_date < CURDATE() and docstatus = 1 and outstanding_amount > 0""")
1567
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001568
Nabin Hait92759692017-08-15 08:23:51 +05301569@frappe.whitelist()
Saqib Ansarid552fe62021-04-23 14:46:52 +05301570def 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 +05301571 if not terms_template:
1572 return
1573
1574 terms_doc = frappe.get_doc("Payment Terms Template", terms_template)
1575
1576 schedule = []
tundefb144302017-08-19 15:01:40 +01001577 for d in terms_doc.get("terms"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301578 term_details = get_payment_term_details(d, posting_date, grand_total, base_grand_total, bill_date)
Nabin Hait92759692017-08-15 08:23:51 +05301579 schedule.append(term_details)
1580
1581 return schedule
1582
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001583
Nabin Hait92759692017-08-15 08:23:51 +05301584@frappe.whitelist()
Saqib Ansarid552fe62021-04-23 14:46:52 +05301585def 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 +05301586 term_details = frappe._dict()
Achilles Rasquinha90509982018-03-08 12:55:41 +05301587 if isinstance(term, text_type):
Nabin Hait92759692017-08-15 08:23:51 +05301588 term = frappe.get_doc("Payment Term", term)
1589 else:
1590 term_details.payment_term = term.payment_term
1591 term_details.description = term.description
1592 term_details.invoice_portion = term.invoice_portion
Rohit Waghchaure52bf56d2017-11-27 11:43:52 +05301593 term_details.payment_amount = flt(term.invoice_portion) * flt(grand_total) / 100
Saqib Ansarid552fe62021-04-23 14:46:52 +05301594 term_details.base_payment_amount = flt(term.invoice_portion) * flt(base_grand_total) / 100
Saqib0586b7d2021-03-31 15:03:53 +05301595 term_details.discount_type = term.discount_type
1596 term_details.discount = term.discount
Saqib0586b7d2021-03-31 15:03:53 +05301597 term_details.outstanding = term_details.payment_amount
1598 term_details.mode_of_payment = term.mode_of_payment
1599
Shreya Shah3a9eec22018-02-16 13:05:21 +05301600 if bill_date:
1601 term_details.due_date = get_due_date(term, bill_date)
Saqib0586b7d2021-03-31 15:03:53 +05301602 term_details.discount_date = get_discount_date(term, bill_date)
Shreya Shah3a9eec22018-02-16 13:05:21 +05301603 elif posting_date:
1604 term_details.due_date = get_due_date(term, posting_date)
Saqib0586b7d2021-03-31 15:03:53 +05301605 term_details.discount_date = get_discount_date(term, posting_date)
Shreya Shah3a9eec22018-02-16 13:05:21 +05301606
1607 if getdate(term_details.due_date) < getdate(posting_date):
1608 term_details.due_date = posting_date
1609
Nabin Hait92759692017-08-15 08:23:51 +05301610 return term_details
1611
Shreya Shah3a9eec22018-02-16 13:05:21 +05301612def get_due_date(term, posting_date=None, bill_date=None):
Nabin Hait92759692017-08-15 08:23:51 +05301613 due_date = None
Shreya Shah3a9eec22018-02-16 13:05:21 +05301614 date = bill_date or posting_date
Nabin Hait92759692017-08-15 08:23:51 +05301615 if term.due_date_based_on == "Day(s) after invoice date":
Shreya Shah3a9eec22018-02-16 13:05:21 +05301616 due_date = add_days(date, term.credit_days)
Nabin Hait92759692017-08-15 08:23:51 +05301617 elif term.due_date_based_on == "Day(s) after the end of the invoice month":
Shreya Shah3a9eec22018-02-16 13:05:21 +05301618 due_date = add_days(get_last_day(date), term.credit_days)
Nabin Hait92759692017-08-15 08:23:51 +05301619 elif term.due_date_based_on == "Month(s) after the end of the invoice month":
Shreya Shah3a9eec22018-02-16 13:05:21 +05301620 due_date = add_months(get_last_day(date), term.credit_months)
tunde96b8f222017-09-08 15:35:59 +01001621 return due_date
tundebabzyad08d4c2018-05-16 07:01:41 +01001622
Saqib0586b7d2021-03-31 15:03:53 +05301623def get_discount_date(term, posting_date=None, bill_date=None):
1624 discount_validity = None
1625 date = bill_date or posting_date
1626 if term.discount_validity_based_on == "Day(s) after invoice date":
1627 discount_validity = add_days(date, term.discount_validity)
1628 elif term.discount_validity_based_on == "Day(s) after the end of the invoice month":
1629 discount_validity = add_days(get_last_day(date), term.discount_validity)
1630 elif term.discount_validity_based_on == "Month(s) after the end of the invoice month":
1631 discount_validity = add_months(get_last_day(date), term.discount_validity)
1632 return discount_validity
tundebabzyad08d4c2018-05-16 07:01:41 +01001633
1634def get_supplier_block_status(party_name):
1635 """
1636 Returns a dict containing the values of `on_hold`, `release_date` and `hold_type` of
1637 a `Supplier`
1638 """
1639 supplier = frappe.get_doc('Supplier', party_name)
1640 info = {
1641 'on_hold': supplier.on_hold,
1642 'release_date': supplier.release_date,
1643 'hold_type': supplier.hold_type
1644 }
1645 return info
1646
marination698d9832020-08-19 14:59:46 +05301647def set_child_tax_template_and_map(item, child_item, parent_doc):
1648 args = {
1649 'item_code': item.item_code,
1650 'posting_date': parent_doc.transaction_date,
1651 'tax_category': parent_doc.get('tax_category'),
1652 'company': parent_doc.get('company')
1653 }
1654
1655 child_item.item_tax_template = _get_item_tax_template(args, item.taxes)
1656 if child_item.get("item_tax_template"):
1657 child_item.item_tax_rate = get_item_tax_map(parent_doc.get('company'), child_item.item_tax_template, as_json=True)
1658
Frappe PR Bot0ff9ef62021-08-09 17:58:18 +05301659def add_taxes_from_tax_template(child_item, parent_doc, db_insert=True):
Marica3b1be2b2020-10-22 17:04:31 +05301660 add_taxes_from_item_tax_template = frappe.db.get_single_value("Accounts Settings", "add_taxes_from_item_tax_template")
1661
1662 if child_item.get("item_tax_rate") and add_taxes_from_item_tax_template:
1663 tax_map = json.loads(child_item.get("item_tax_rate"))
1664 for tax_type in tax_map:
1665 tax_rate = flt(tax_map[tax_type])
1666 taxes = parent_doc.get('taxes') or []
1667 # add new row for tax head only if missing
1668 found = any(tax.account_head == tax_type for tax in taxes)
1669 if not found:
1670 tax_row = parent_doc.append("taxes", {})
1671 tax_row.update({
1672 "description" : str(tax_type).split(' - ')[0],
1673 "charge_type" : "On Net Total",
1674 "account_head" : tax_type,
1675 "rate" : tax_rate
1676 })
1677 if parent_doc.doctype == "Purchase Order":
1678 tax_row.update({
1679 "category" : "Total",
1680 "add_deduct_tax" : "Add"
1681 })
Frappe PR Bot0ff9ef62021-08-09 17:58:18 +05301682 if db_insert:
1683 tax_row.db_insert()
Marica3b1be2b2020-10-22 17:04:31 +05301684
pateljannat637ddff2021-02-09 16:17:30 +05301685def set_order_defaults(parent_doctype, parent_doctype_name, child_doctype, child_docname, trans_item):
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001686 """
pateljannat637ddff2021-02-09 16:17:30 +05301687 Returns a Sales/Purchase Order Item child item containing the default values
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001688 """
Saqib438e0432020-04-03 10:02:56 +05301689 p_doc = frappe.get_doc(parent_doctype, parent_doctype_name)
pateljannat637ddff2021-02-09 16:17:30 +05301690 child_item = frappe.new_doc(child_doctype, p_doc, child_docname)
Saqib Ansarif53299e2020-04-15 22:08:12 +05301691 item = frappe.get_doc("Item", trans_item.get('item_code'))
marination0673f552021-03-31 01:38:22 +05301692
pateljannat637ddff2021-02-09 16:17:30 +05301693 for field in ("item_code", "item_name", "description", "item_group"):
marination0673f552021-03-31 01:38:22 +05301694 child_item.update({field: item.get(field)})
1695
pateljannat637ddff2021-02-09 16:17:30 +05301696 date_fieldname = "delivery_date" if child_doctype == "Sales Order Item" else "schedule_date"
Jannat Patelbb0d8f82021-02-11 20:59:28 +05301697 child_item.update({date_fieldname: trans_item.get(date_fieldname) or p_doc.get(date_fieldname)})
marination0673f552021-03-31 01:38:22 +05301698 child_item.stock_uom = item.stock_uom
Saqib61314242020-09-15 11:14:31 +05301699 child_item.uom = trans_item.get("uom") or item.stock_uom
Andy Zhu1062d7e2020-10-06 10:51:42 +13001700 child_item.warehouse = get_item_warehouse(item, p_doc, overwrite_warehouse=True)
Saqib61314242020-09-15 11:14:31 +05301701 conversion_factor = flt(get_conversion_factor(item.item_code, child_item.uom).get("conversion_factor"))
1702 child_item.conversion_factor = flt(trans_item.get('conversion_factor')) or conversion_factor
marination0673f552021-03-31 01:38:22 +05301703
pateljannat637ddff2021-02-09 16:17:30 +05301704 if child_doctype == "Purchase Order Item":
marination0673f552021-03-31 01:38:22 +05301705 # Initialized value will update in parent validation
1706 child_item.base_rate = 1
1707 child_item.base_amount = 1
pateljannat637ddff2021-02-09 16:17:30 +05301708 if child_doctype == "Sales Order Item":
1709 child_item.warehouse = get_item_warehouse(item, p_doc, overwrite_warehouse=True)
1710 if not child_item.warehouse:
1711 frappe.throw(_("Cannot find {} for item {}. Please set the same in Item Master or Stock Settings.")
1712 .format(frappe.bold("default warehouse"), frappe.bold(item.item_code)))
marination0673f552021-03-31 01:38:22 +05301713
marination698d9832020-08-19 14:59:46 +05301714 set_child_tax_template_and_map(item, child_item, p_doc)
Marica3b1be2b2020-10-22 17:04:31 +05301715 add_taxes_from_tax_template(child_item, p_doc)
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001716 return child_item
1717
marination0673f552021-03-31 01:38:22 +05301718def validate_child_on_delete(row, parent):
1719 """Check if partially transacted item (row) is being deleted."""
1720 if parent.doctype == "Sales Order":
1721 if flt(row.delivered_qty):
1722 frappe.throw(_("Row #{0}: Cannot delete item {1} which has already been delivered").format(row.idx, row.item_code))
1723 if flt(row.work_order_qty):
1724 frappe.throw(_("Row #{0}: Cannot delete item {1} which has work order assigned to it.").format(row.idx, row.item_code))
1725 if flt(row.ordered_qty):
1726 frappe.throw(_("Row #{0}: Cannot delete item {1} which is assigned to customer's purchase order.").format(row.idx, row.item_code))
1727
1728 if parent.doctype == "Purchase Order" and flt(row.received_qty):
1729 frappe.throw(_("Row #{0}: Cannot delete item {1} which has already been received").format(row.idx, row.item_code))
1730
1731 if flt(row.billed_amt):
1732 frappe.throw(_("Row #{0}: Cannot delete item {1} which has already been billed.").format(row.idx, row.item_code))
1733
1734def update_bin_on_delete(row, doctype):
1735 """Update bin for deleted item (row)."""
1736 from erpnext.stock.stock_balance import update_bin_qty, get_reserved_qty, get_ordered_qty, get_indented_qty
1737 qty_dict = {}
1738
1739 if doctype == "Sales Order":
1740 qty_dict["reserved_qty"] = get_reserved_qty(row.item_code, row.warehouse)
1741 else:
1742 if row.material_request_item:
1743 qty_dict["indented_qty"] = get_indented_qty(row.item_code, row.warehouse)
1744
1745 qty_dict["ordered_qty"] = get_ordered_qty(row.item_code, row.warehouse)
1746
1747 update_bin_qty(row.item_code, row.warehouse, qty_dict)
1748
Saqib6db92fb2020-09-14 19:54:17 +05301749def validate_and_delete_children(parent, data):
Saqib0ad74492019-12-24 16:42:30 +05301750 deleted_children = []
1751 updated_item_names = [d.get("docname") for d in data]
1752 for item in parent.items:
1753 if item.name not in updated_item_names:
1754 deleted_children.append(item)
1755
1756 for d in deleted_children:
marination0673f552021-03-31 01:38:22 +05301757 validate_child_on_delete(d, parent)
Saqib0ad74492019-12-24 16:42:30 +05301758 d.cancel()
1759 d.delete()
marination0673f552021-03-31 01:38:22 +05301760
1761 # need to update ordered qty in Material Request first
1762 # bin uses Material Request Items to recalculate & update
1763 parent.update_prevdoc_status()
1764
1765 for d in deleted_children:
1766 update_bin_on_delete(d, parent.doctype)
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001767
Rohan Bansala93b5142021-04-06 17:10:52 +05301768
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001769@frappe.whitelist()
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001770def update_child_qty_rate(parent_doctype, trans_items, parent_doctype_name, child_docname="items"):
Saqib6db92fb2020-09-14 19:54:17 +05301771 def check_doc_permissions(doc, perm_type='create'):
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301772 try:
1773 doc.check_permission(perm_type)
Saqib6db92fb2020-09-14 19:54:17 +05301774 except frappe.PermissionError:
marination661bf642020-09-29 18:16:45 +05301775 actions = { 'create': 'add', 'write': 'update'}
Saqib6db92fb2020-09-14 19:54:17 +05301776
1777 frappe.throw(_("You do not have permissions to {} items in a {}.")
1778 .format(actions[perm_type], parent_doctype), title=_("Insufficient Permissions"))
marination665c27a2020-09-15 12:04:38 +05301779
Saqib6db92fb2020-09-14 19:54:17 +05301780 def validate_workflow_conditions(doc):
1781 workflow = get_workflow_name(doc.doctype)
1782 if not workflow:
1783 return
1784
1785 workflow_doc = frappe.get_doc("Workflow", workflow)
1786 current_state = doc.get(workflow_doc.workflow_state_field)
1787 roles = frappe.get_roles()
1788
1789 transitions = []
1790 for transition in workflow_doc.transitions:
1791 if transition.next_state == current_state and transition.allowed in roles:
1792 if not is_transition_condition_satisfied(transition, doc):
1793 continue
1794 transitions.append(transition.as_dict())
1795
1796 if not transitions:
Saqib18318932020-09-23 13:01:49 +05301797 frappe.throw(
1798 _("You are not allowed to update as per the conditions set in {} Workflow.").format(get_link_to_form("Workflow", workflow)),
1799 title=_("Insufficient Permissions")
1800 )
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301801
Rohit Waghchaure8d5380a2020-06-18 14:06:31 +05301802 def get_new_child_item(item_row):
Rohit Waghchaureff70e612021-03-06 22:08:08 +05301803 child_doctype = "Sales Order Item" if parent_doctype == "Sales Order" else "Purchase Order Item"
pateljannat637ddff2021-02-09 16:17:30 +05301804 return set_order_defaults(parent_doctype, parent_doctype_name, child_doctype, child_docname, item_row)
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301805
1806 def validate_quantity(child_item, d):
1807 if parent_doctype == "Sales Order" and flt(d.get("qty")) < flt(child_item.delivered_qty):
1808 frappe.throw(_("Cannot set quantity less than delivered quantity"))
1809
1810 if parent_doctype == "Purchase Order" and flt(d.get("qty")) < flt(child_item.received_qty):
1811 frappe.throw(_("Cannot set quantity less than received quantity"))
1812
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001813 data = json.loads(trans_items)
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001814
rohitwaghchaure81c21752019-10-31 15:56:10 +05301815 sales_doctypes = ['Sales Order', 'Sales Invoice', 'Delivery Note', 'Quotation']
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301816 parent = frappe.get_doc(parent_doctype, parent_doctype_name)
marination665c27a2020-09-15 12:04:38 +05301817
marination661bf642020-09-29 18:16:45 +05301818 check_doc_permissions(parent, 'write')
Saqib6db92fb2020-09-14 19:54:17 +05301819 validate_and_delete_children(parent, data)
Saqib0ad74492019-12-24 16:42:30 +05301820
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001821 for d in data:
1822 new_child_flag = False
1823 if not d.get("docname"):
1824 new_child_flag = True
Saqib6db92fb2020-09-14 19:54:17 +05301825 check_doc_permissions(parent, 'create')
Rohit Waghchaure8d5380a2020-06-18 14:06:31 +05301826 child_item = get_new_child_item(d)
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001827 else:
Saqib6db92fb2020-09-14 19:54:17 +05301828 check_doc_permissions(parent, 'write')
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001829 child_item = frappe.get_doc(parent_doctype + ' Item', d.get("docname"))
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301830
Saqib Ansaric579b082020-05-29 22:21:50 +05301831 prev_rate, new_rate = flt(child_item.get("rate")), flt(d.get("rate"))
1832 prev_qty, new_qty = flt(child_item.get("qty")), flt(d.get("qty"))
1833 prev_con_fac, new_con_fac = flt(child_item.get("conversion_factor")), flt(d.get("conversion_factor"))
Saqib61314242020-09-15 11:14:31 +05301834 prev_uom, new_uom = child_item.get("uom"), d.get("uom")
Saqib Ansaric579b082020-05-29 22:21:50 +05301835
1836 if parent_doctype == 'Sales Order':
1837 prev_date, new_date = child_item.get("delivery_date"), d.get("delivery_date")
1838 elif parent_doctype == 'Purchase Order':
marinationb7e94cc2020-06-15 11:32:42 +05301839 prev_date, new_date = child_item.get("schedule_date"), d.get("schedule_date")
Saqib Ansaric579b082020-05-29 22:21:50 +05301840
1841 rate_unchanged = prev_rate == new_rate
marinationf9c4b202020-06-12 15:49:53 +05301842 qty_unchanged = prev_qty == new_qty
Saqib61314242020-09-15 11:14:31 +05301843 uom_unchanged = prev_uom == new_uom
Saqib Ansaric579b082020-05-29 22:21:50 +05301844 conversion_factor_unchanged = prev_con_fac == new_con_fac
1845 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 +05301846 if rate_unchanged and qty_unchanged and conversion_factor_unchanged and uom_unchanged and date_unchanged:
Saqibdd374ff2020-02-27 12:51:31 +05301847 continue
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001848
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301849 validate_quantity(child_item, d)
deepeshgarg00777cde832018-12-27 15:56:51 +05301850
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001851 child_item.qty = flt(d.get("qty"))
Saqib56fea7d2020-10-09 21:19:25 +05301852 rate_precision = child_item.precision("rate") or 2
1853 conv_fac_precision = child_item.precision("conversion_factor") or 2
1854 qty_precision = child_item.precision("qty") or 2
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001855
Saqib56fea7d2020-10-09 21:19:25 +05301856 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 +08001857 frappe.throw(_("Row #{0}: Cannot set Rate if amount is greater than billed amount for Item {1}.")
1858 .format(child_item.idx, child_item.item_code))
1859 else:
Saqib56fea7d2020-10-09 21:19:25 +05301860 child_item.rate = flt(d.get("rate"), rate_precision)
marinationf9c4b202020-06-12 15:49:53 +05301861
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301862 if d.get("conversion_factor"):
marinationf9c4b202020-06-12 15:49:53 +05301863 if child_item.stock_uom == child_item.uom:
1864 child_item.conversion_factor = 1
1865 else:
Saqib56fea7d2020-10-09 21:19:25 +05301866 child_item.conversion_factor = flt(d.get('conversion_factor'), conv_fac_precision)
marination665c27a2020-09-15 12:04:38 +05301867
Saqib61314242020-09-15 11:14:31 +05301868 if d.get("uom"):
1869 child_item.uom = d.get("uom")
1870 conversion_factor = flt(get_conversion_factor(child_item.item_code, child_item.uom).get("conversion_factor"))
Saqib56fea7d2020-10-09 21:19:25 +05301871 child_item.conversion_factor = flt(d.get('conversion_factor'), conv_fac_precision) or conversion_factor
Mangesh-Khairnara3d52002019-08-05 10:16:40 +05301872
Saqib Ansaric579b082020-05-29 22:21:50 +05301873 if d.get("delivery_date") and parent_doctype == 'Sales Order':
1874 child_item.delivery_date = d.get('delivery_date')
marinationf9c4b202020-06-12 15:49:53 +05301875
Saqib Ansaric579b082020-05-29 22:21:50 +05301876 if d.get("schedule_date") and parent_doctype == 'Purchase Order':
1877 child_item.schedule_date = d.get('schedule_date')
1878
Mangesh-Khairnara3d52002019-08-05 10:16:40 +05301879 if flt(child_item.price_list_rate):
Maricaf0674472019-10-11 10:47:09 +05301880 if flt(child_item.rate) > flt(child_item.price_list_rate):
1881 # if rate is greater than price_list_rate, set margin
1882 # or set discount
1883 child_item.discount_percentage = 0
rohitwaghchaure81c21752019-10-31 15:56:10 +05301884
1885 if parent_doctype in sales_doctypes:
1886 child_item.margin_type = "Amount"
1887 child_item.margin_rate_or_amount = flt(child_item.rate - child_item.price_list_rate,
1888 child_item.precision("margin_rate_or_amount"))
1889 child_item.rate_with_margin = child_item.rate
Maricaf0674472019-10-11 10:47:09 +05301890 else:
1891 child_item.discount_percentage = flt((1 - flt(child_item.rate) / flt(child_item.price_list_rate)) * 100.0,
1892 child_item.precision("discount_percentage"))
1893 child_item.discount_amount = flt(
1894 child_item.price_list_rate) - flt(child_item.rate)
rohitwaghchaure81c21752019-10-31 15:56:10 +05301895
1896 if parent_doctype in sales_doctypes:
1897 child_item.margin_type = ""
1898 child_item.margin_rate_or_amount = 0
1899 child_item.rate_with_margin = 0
Mangesh-Khairnara3d52002019-08-05 10:16:40 +05301900
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001901 child_item.flags.ignore_validate_update_after_submit = True
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001902 if new_child_flag:
Saqib Ansarif53299e2020-04-15 22:08:12 +05301903 parent.load_from_db()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301904 child_item.idx = len(parent.items) + 1
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001905 child_item.insert()
1906 else:
1907 child_item.save()
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001908
Rushabh Mehtafafbb022018-12-24 22:09:15 +05301909 parent.reload()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301910 parent.flags.ignore_validate_update_after_submit = True
1911 parent.set_qty_as_per_stock_uom()
1912 parent.calculate_taxes_and_totals()
Ankush Menatdf6e2082021-02-11 11:04:39 +05301913 parent.set_total_in_words()
Nabin Hait49a46f02019-10-21 13:35:43 +05301914 if parent_doctype == "Sales Order":
Marica3dee5272020-06-23 10:33:47 +05301915 make_packing_list(parent)
Nabin Hait49a46f02019-10-21 13:35:43 +05301916 parent.set_gross_profit()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301917 frappe.get_doc('Authorization Control').validate_approving_authority(parent.doctype,
1918 parent.company, parent.base_grand_total)
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001919
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301920 parent.set_payment_schedule()
Nabin Haitb2da0822018-07-13 17:01:40 +05301921 if parent_doctype == 'Purchase Order':
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301922 parent.validate_minimum_order_qty()
1923 parent.validate_budget()
1924 if parent.is_against_so():
1925 parent.update_status_updater()
Nabin Haitb2da0822018-07-13 17:01:40 +05301926 else:
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301927 parent.check_credit_limit()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301928 parent.save()
Nabin Haitb2da0822018-07-13 17:01:40 +05301929
1930 if parent_doctype == 'Purchase Order':
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301931 update_last_purchase_rate(parent, is_submit = 1)
1932 parent.update_prevdoc_status()
1933 parent.update_requested_qty()
1934 parent.update_ordered_qty()
1935 parent.update_ordered_and_reserved_qty()
1936 parent.update_receiving_percentage()
1937 if parent.is_subcontracted == "Yes":
1938 parent.update_reserved_qty_for_subcontract()
Saqib61314242020-09-15 11:14:31 +05301939 parent.create_raw_materials_supplied("supplied_items")
1940 parent.save()
Nabin Haitb2da0822018-07-13 17:01:40 +05301941 else:
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301942 parent.update_reserved_qty()
1943 parent.update_project()
1944 parent.update_prevdoc_status('submit')
1945 parent.update_delivery_status()
Nabin Haitb2da0822018-07-13 17:01:40 +05301946
Saqib6db92fb2020-09-14 19:54:17 +05301947 parent.reload()
1948 validate_workflow_conditions(parent)
1949
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301950 parent.update_blanket_order()
1951 parent.update_billing_percentage()
1952 parent.set_status()
Gauravf1e28e02019-02-13 16:46:24 +05301953
1954@erpnext.allow_regional
1955def validate_regional(doc):
1956 pass
Saqib6d74f5b2020-12-25 10:26:43 +05301957
1958@erpnext.allow_regional
1959def validate_einvoice_fields(doc):
GangaManojdef7cc62021-07-22 05:57:42 +05301960 pass