blob: 4c79a5cb5f18bf499b6cef7e9beb15205d502c45 [file] [log] [blame]
Anand Doshi885e0742015-03-03 14:55:30 +05301# Copyright (c) 2015, Frappe Technologies Pvt. Ltd. and Contributors
Rushabh Mehtae67d1fb2013-08-05 14:59:54 +05302# License: GNU General Public License v3. See license.txt
Nabin Hait2df4d542013-01-29 11:34:39 +05303
4from __future__ import unicode_literals
Rushabh Mehtacc8b2b22017-03-31 12:44:29 +05305import frappe, erpnext
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08006import json
Rushabh Mehta793ba6b2014-02-14 15:47:51 +05307from frappe import _, throw
rohitwaghchaurea85ddf22019-11-19 18:47:48 +05308from frappe.utils import (today, flt, cint, fmt_money, formatdate,
9 getdate, add_days, add_months, get_last_day, nowdate, get_link_to_form)
Saqib6db92fb2020-09-14 19:54:17 +053010from frappe.model.workflow import get_workflow_name, is_transition_condition_satisfied, WorkflowPermissionError
rohitwaghchaurea85ddf22019-11-19 18:47:48 +053011from erpnext.stock.get_item_details import get_conversion_factor, get_item_details
Rushabh Mehtacc8b2b22017-03-31 12:44:29 +053012from erpnext.setup.utils import get_exchange_rate
Nabin Hait2ed0b592016-03-29 13:14:17 +053013from erpnext.accounts.utils import get_fiscal_years, validate_fiscal_year, get_account_currency
Nabin Hait436f5262014-02-10 14:47:54 +053014from erpnext.utilities.transaction_base import TransactionBase
Doridel Cahanap6f06cc22018-05-17 16:28:58 +080015from erpnext.buying.utils import update_last_purchase_rate
Nabin Hait3cf67a42015-07-24 13:26:36 +053016from erpnext.controllers.sales_and_purchase_return import validate_return
shreyas29b565f2016-01-25 17:30:49 +053017from erpnext.accounts.party import get_party_account_currency, validate_party_frozen_disabled
rohitwaghchaurea85ddf22019-11-19 18:47:48 +053018from erpnext.accounts.doctype.pricing_rule.utils import (apply_pricing_rule_on_transaction,
19 apply_pricing_rule_for_free_items, get_applied_pricing_rules)
shreyasf76853a2016-01-25 21:25:11 +053020from erpnext.exceptions import InvalidCurrency
Achilles Rasquinha90509982018-03-08 12:55:41 +053021from six import text_type
deepeshgarg007d83cf652019-05-12 18:34:23 +053022from erpnext.accounts.doctype.accounting_dimension.accounting_dimension import get_accounting_dimensions
marination698d9832020-08-19 14:59:46 +053023from erpnext.stock.get_item_details import get_item_warehouse, _get_item_tax_template, get_item_tax_map
Marica3dee5272020-06-23 10:33:47 +053024from erpnext.stock.doctype.packed_item.packed_item import make_packing_list
prssanna71e5b602020-10-29 14:19:34 +053025from erpnext.controllers.print_settings import set_print_templates_for_item_table, set_print_templates_for_taxes
Nabin Hait1d218422015-07-17 15:19:02 +053026
marination53b1a9a2020-11-03 15:45:25 +053027class AccountMissingError(frappe.ValidationError): pass
28
Rohit Waghchaurebde159a2021-03-22 23:36:48 +053029force_item_fields = ("item_group", "brand", "stock_uom", "is_fixed_asset", "item_tax_rate",
30 "pricing_rules", "weight_per_unit", "weight_uom", "total_weight")
Doridel Cahanap6f06cc22018-05-17 16:28:58 +080031
Nabin Haitbf495c92013-01-30 12:49:08 +053032class AccountsController(TransactionBase):
Nabin Hait7eba1a32017-10-02 15:59:27 +053033 def __init__(self, *args, **kwargs):
34 super(AccountsController, self).__init__(*args, **kwargs)
Anand Doshi979326b2015-09-11 16:22:37 +053035
prssanna71e5b602020-10-29 14:19:34 +053036 def get_print_settings(self):
37 print_setting_fields = []
38 items_field = self.meta.get_field('items')
39
40 if items_field and items_field.fieldtype == 'Table':
41 print_setting_fields += ['compact_item_print', 'print_uom_after_quantity']
42
43 taxes_field = self.meta.get_field('taxes')
44 if taxes_field and taxes_field.fieldtype == 'Table':
45 print_setting_fields += ['print_taxes_with_zero_amount']
46
47 return print_setting_fields
48
Nabin Hait4ffd7f32015-08-27 12:28:36 +053049 @property
50 def company_currency(self):
51 if not hasattr(self, "__company_currency"):
Rushabh Mehtacc8b2b22017-03-31 12:44:29 +053052 self.__company_currency = erpnext.get_company_currency(self.company)
Anand Doshi979326b2015-09-11 16:22:37 +053053
Nabin Hait4ffd7f32015-08-27 12:28:36 +053054 return self.__company_currency
Anand Doshi979326b2015-09-11 16:22:37 +053055
Rohit Waghchaure7d529892016-10-06 14:35:04 +053056 def onload(self):
Nabin Hait34c551d2019-07-03 10:34:31 +053057 self.set_onload("make_payment_via_journal_entry",
58 frappe.db.get_single_value('Accounts Settings', 'make_payment_via_journal_entry'))
Nabin Hait0551f7b2017-11-21 19:58:16 +053059
tundee52bb822017-09-25 09:02:23 +010060 if self.is_new():
Nabin Hait0551f7b2017-11-21 19:58:16 +053061 relevant_docs = ("Quotation", "Purchase Order", "Sales Order",
Doridel Cahanap6f06cc22018-05-17 16:28:58 +080062 "Purchase Invoice", "Sales Invoice")
tundee52bb822017-09-25 09:02:23 +010063 if self.doctype in relevant_docs:
64 self.set_payment_schedule()
Rohit Waghchaure7d529892016-10-06 14:35:04 +053065
tundebabzyad08d4c2018-05-16 07:01:41 +010066 def ensure_supplier_is_not_blocked(self):
67 is_supplier_payment = self.doctype == 'Payment Entry' and self.party_type == 'Supplier'
68 is_buying_invoice = self.doctype in ['Purchase Invoice', 'Purchase Order']
69 supplier = None
70 supplier_name = None
71
72 if is_buying_invoice or is_supplier_payment:
73 supplier_name = self.supplier if is_buying_invoice else self.party
74 supplier = frappe.get_doc('Supplier', supplier_name)
75
76 if supplier and supplier_name and supplier.on_hold:
77 if (is_buying_invoice and supplier.hold_type in ['All', 'Invoices']) or \
78 (is_supplier_payment and supplier.hold_type in ['All', 'Payments']):
79 if not supplier.release_date or getdate(nowdate()) <= supplier.release_date:
80 frappe.msgprint(
Suraj Shetty48e9bc32020-01-29 15:06:18 +053081 _('{0} is blocked so this transaction cannot proceed').format(supplier_name), raise_exception=1)
tundebabzyad08d4c2018-05-16 07:01:41 +010082
Saurabh6f753182013-03-20 12:55:28 +053083 def validate(self):
Deepesh Gargd301d262019-07-31 15:58:19 +053084 if not self.get('is_return'):
85 self.validate_qty_is_not_zero()
86
nabinhait23cce732014-07-03 12:25:06 +053087 if self.get("_action") and self._action != "update_after_submit":
Nabin Hait704a4532014-06-05 16:55:31 +053088 self.set_missing_values(for_validate=True)
tunde62af5c52017-09-22 15:16:38 +010089
tundebabzyad08d4c2018-05-16 07:01:41 +010090 self.ensure_supplier_is_not_blocked()
91
Nabin Haitcfecd2b2013-07-11 17:49:18 +053092 self.validate_date_with_fiscal_year()
Deepesh Garg4c8d15b2021-04-26 15:24:34 +053093 self.validate_party_accounts()
94
Deepesh Gargb4be2922021-01-28 13:09:56 +053095 self.validate_inter_company_reference()
96
97 self.set_incoming_rate()
Rushabh Mehtab16b9cd2015-08-03 16:13:33 +053098
Anand Doshi3543f302013-05-24 19:25:01 +053099 if self.meta.get_field("currency"):
Anand Doshi923d41d2013-05-28 17:23:36 +0530100 self.calculate_taxes_and_totals()
Rohit Waghchaure6087fe12016-04-09 14:31:09 +0530101
Nabin Hait1d218422015-07-17 15:19:02 +0530102 if not self.meta.get_field("is_return") or not self.is_return:
103 self.validate_value("base_grand_total", ">=", 0)
Rushabh Mehtab16b9cd2015-08-03 16:13:33 +0530104
Nabin Hait3cf67a42015-07-24 13:26:36 +0530105 validate_return(self)
Anand Doshi3543f302013-05-24 19:25:01 +0530106 self.set_total_in_words()
Anand Doshid2946502014-04-08 20:10:03 +0530107
tunde62af5c52017-09-22 15:16:38 +0100108 self.validate_all_documents_schedule()
Anand Doshid2946502014-04-08 20:10:03 +0530109
ankitjavalkarwork6c29d872014-10-06 13:20:53 +0530110 if self.meta.get_field("taxes_and_charges"):
111 self.validate_enabled_taxes_and_charges()
Nabin Haita2426fc2018-01-15 17:45:46 +0530112 self.validate_tax_account_company()
Rushabh Mehtab16b9cd2015-08-03 16:13:33 +0530113
Neil Trini Lasrado3fbbb712015-07-17 12:10:12 +0530114 self.validate_party()
Nabin Hait895029d2015-08-20 14:55:39 +0530115 self.validate_currency()
Rushabh Mehta2cb7a9f2016-06-15 16:45:03 +0530116
Rohit Waghchaure6087fe12016-04-09 14:31:09 +0530117 if self.doctype == 'Purchase Invoice':
Mangesh-Khairnar7bcb24e2019-09-11 10:49:33 +0530118 self.calculate_paid_amount()
Deepesh Garg911818a2021-06-09 22:55:10 +0530119 # apply tax withholding only if checked and applicable
120 self.set_tax_withholding()
Rohit Waghchaure6087fe12016-04-09 14:31:09 +0530121
Nabin Hait041a5c22018-08-01 18:07:39 +0530122 if self.doctype in ['Purchase Invoice', 'Sales Invoice']:
Nabin Hait4a994d42019-04-25 17:47:26 +0530123 pos_check_field = "is_pos" if self.doctype=="Sales Invoice" else "is_paid"
124 if cint(self.allocate_advances_automatically) and not cint(self.get(pos_check_field)):
Nabin Hait041a5c22018-08-01 18:07:39 +0530125 self.set_advances()
126
Saqiba20999c2021-07-12 14:33:23 +0530127 self.set_advance_gain_or_loss()
128
Nabin Hait041a5c22018-08-01 18:07:39 +0530129 if self.is_return:
130 self.validate_qty()
Nabin Haitacdd5082019-12-04 15:30:01 +0530131 else:
132 self.validate_deferred_start_and_end_date()
rohitwaghchaure70489252018-06-11 12:02:14 +0530133
Deepesh Gargf17ea2c2020-12-11 21:30:39 +0530134 self.set_inter_company_account()
135
Gauravf1e28e02019-02-13 16:46:24 +0530136 validate_regional(self)
Deepesh Garg7c300852020-12-26 20:14:51 +0530137
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
Saqiba20999c2021-07-12 14:33:23 +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),
Saqiba20999c2021-07-12 14:33:23 +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 Menat98917802021-06-11 18:40:22 +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 Menat98917802021-06-11 18:40:22 +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
Saqiba20999c2021-07-12 14:33:23 +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:
Saqibd4ae1fe2021-07-30 11:21:49 +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"
Saqiba20999c2021-07-12 14:33:23 +0530681
682 gain_loss_account = frappe.db.get_value('Company', self.company, 'exchange_gain_loss_account')
Saqibd4ae1fe2021-07-30 11:21:49 +0530683 if not gain_loss_account:
684 frappe.throw(_("Please set Default Exchange Gain/Loss Account in Company {}")
685 .format(self.get('company')))
Saqiba20999c2021-07-12 14:33:23 +0530686 account_currency = get_account_currency(gain_loss_account)
687 if account_currency != self.company_currency:
Saqibd4ae1fe2021-07-30 11:21:49 +0530688 frappe.throw(_("Currency for {0} must be {1}").format(gain_loss_account, self.company_currency))
Saqiba20999c2021-07-12 14:33:23 +0530689
690 # for purchase
691 dr_or_cr = 'debit' if d.exchange_gain_loss > 0 else 'credit'
Saqibd4ae1fe2021-07-30 11:21:49 +0530692 if not is_purchase_invoice:
693 # just reverse for sales?
694 dr_or_cr = 'debit' if dr_or_cr == 'credit' else 'credit'
Saqiba20999c2021-07-12 14:33:23 +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),
Saqiba20999c2021-07-12 14:33:23 +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 Garg92f7a5a2021-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
GangaManoj8f7b0a12021-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:
GangaManoj4105e272021-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
GangaManoj8f7b0a12021-07-13 03:01:02 +0530851 for item in self.get("items"):
852 if item.get('discount_amount') and item.get('discount_account'):
Deepesh Gargad7bb312021-07-28 11:38:44 +0530853 discount_amount = item.discount_amount * item.qty
GangaManoj8f7b0a12021-07-13 03:01:02 +0530854 if self.doctype == "Purchase Invoice":
GangaManoj8f7b0a12021-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:
GangaManoj8f7b0a12021-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 Gargad7bb312021-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 Manoj980798c2021-07-19 23:43:36 +0530871 "cost_center": item.cost_center,
Ganga Manoj63b7ecd2021-07-19 23:44:21 +0530872 "project": item.project
Ganga Manoj0ea29342021-07-19 23:44:55 +0530873 }, account_currency, item=item)
GangaManoj8f7b0a12021-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 Gargad7bb312021-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')),
GangaManoj8f7b0a12021-07-13 03:01:02 +0530884 "cost_center": item.cost_center,
885 "project": item.project or self.project
886 }, account_currency, item=item)
887 )
GangaManoj857501c2021-07-15 22:03:46 +0530888
GangaManoj4105e272021-07-20 03:46:02 +0530889 if self.get('discount_amount') and self.get('additional_discount_account'):
GangaManoj857501c2021-07-15 22:03:46 +0530890 gl_entries.append(
891 self.get_gl_dict({
892 "account": self.additional_discount_account,
GangaManoj4105e272021-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 Garg4478c542021-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():
Afshan53fefd72021-06-24 10:09:02 +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
Rohit Waghchaure2a14f252021-07-30 12:36:35 +0530995 def get_company_default(self, fieldname, ignore_validation=False):
Rushabh Mehta1f847992013-12-12 19:12:19 +0530996 from erpnext.accounts.utils import get_company_default
Rohit Waghchaure2a14f252021-07-30 12:36:35 +0530997 return get_company_default(self.company, fieldname, ignore_validation=ignore_validation)
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 Gargbcf56e62021-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 Gargbff3b092021-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 Gargbcf56e62021-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)
GangaManoj4323f4b2021-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)
Deepesh Gargbcf56e62021-08-06 23:53:16 +05301206
1207 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'))
Subin Tomfac88a32021-07-23 21:23:48 +05301214
tunde43870aa2017-08-18 11:59:30 +01001215
GangaManoj4323f4b2021-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
tunde43870aa2017-08-18 11:59:30 +01001222 else:
GangaManoj4323f4b2021-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
GangaManojc7c90242021-07-29 19:18:35 +05301229 def linked_order_has_payment_terms(self, po_or_so, fieldname, doctype):
GangaManoj4323f4b2021-07-22 05:57:42 +05301230 if po_or_so and self.all_items_have_same_po_or_so(po_or_so, fieldname):
GangaManojc7c90242021-07-29 19:18:35 +05301231 if self.linked_order_has_payment_terms_template(po_or_so, doctype):
GangaManoj4323f4b2021-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
GangaManojc7c90242021-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')
GangaManoj4323f4b2021-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,
GangaManoj5b33e752021-08-05 21:50:09 +05301265 'mode_of_payment': schedule.mode_of_payment,
1266 'description': schedule.description
GangaManoj4323f4b2021-07-22 05:57:42 +05301267 }
GangaManoj5b33e752021-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
GangaManoj4323f4b2021-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 Garg302855e2021-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
Anuja Pawar0e337be2021-08-10 17:26:35 +05301440def validate_account_head(tax, doc):
1441 company = frappe.get_cached_value('Account',
1442 tax.account_head, 'company')
1443
1444 if company != doc.company:
1445 frappe.throw(_('Row {0}: Account {1} does not belong to Company {2}')
1446 .format(tax.idx, frappe.bold(tax.account_head), frappe.bold(doc.company)), title=_('Invalid Account'))
1447
1448
1449def validate_cost_center(tax, doc):
1450 if not tax.cost_center:
1451 return
1452
1453 company = frappe.get_cached_value('Cost Center',
1454 tax.cost_center, 'company')
1455
1456 if company != doc.company:
1457 frappe.throw(_('Row {0}: Cost Center {1} does not belong to Company {2}')
1458 .format(tax.idx, frappe.bold(tax.cost_center), frappe.bold(doc.company)), title=_('Invalid Cost Center'))
1459
1460
Nabin Hait613d0812015-02-23 11:58:15 +05301461def validate_inclusive_tax(tax, doc):
1462 def _on_previous_row_error(row_range):
Deepesh Garg302855e2021-06-14 11:16:39 +05301463 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 +05301464
1465 if cint(getattr(tax, "included_in_print_rate", None)):
1466 if tax.charge_type == "Actual":
1467 # inclusive tax cannot be of type Actual
Deepesh Garg5ef9a622021-06-14 14:34:44 +05301468 throw(_("Charge of type 'Actual' in row {0} cannot be included in Item Rate or Paid Amount").format(tax.idx))
Nabin Hait613d0812015-02-23 11:58:15 +05301469 elif tax.charge_type == "On Previous Row Amount" and \
1470 not cint(doc.get("taxes")[cint(tax.row_id) - 1].included_in_print_rate):
1471 # referred row should also be inclusive
1472 _on_previous_row_error(tax.row_id)
1473 elif tax.charge_type == "On Previous Row Total" and \
1474 not all([cint(t.included_in_print_rate) for t in doc.get("taxes")[:cint(tax.row_id) - 1]]):
Deepesh Garg5ef9a622021-06-14 14:34:44 +05301475 # all rows about the referred tax should be inclusive
Nabin Hait613d0812015-02-23 11:58:15 +05301476 _on_previous_row_error("1 - %d" % (tax.row_id,))
Nabin Hait93b3a372015-02-24 17:08:34 +05301477 elif tax.get("category") == "Valuation":
Nabin Hait19ea7212020-08-11 20:34:57 +05301478 frappe.throw(_("Valuation type charges can not be marked as Inclusive"))
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301479
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301480
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001481def set_balance_in_account_currency(gl_dict, account_currency=None, conversion_rate=None, company_currency=None):
1482 if (not conversion_rate) and (account_currency != company_currency):
1483 frappe.throw(_("Account: {0} with currency: {1} can not be selected")
1484 .format(gl_dict.account, account_currency))
1485
1486 gl_dict["account_currency"] = company_currency if account_currency == company_currency \
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301487 else account_currency
1488
1489 # set debit/credit in account currency if not provided
1490 if flt(gl_dict.debit) and not flt(gl_dict.debit_in_account_currency):
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001491 gl_dict.debit_in_account_currency = gl_dict.debit if account_currency == company_currency \
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301492 else flt(gl_dict.debit / conversion_rate, 2)
1493
1494 if flt(gl_dict.credit) and not flt(gl_dict.credit_in_account_currency):
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001495 gl_dict.credit_in_account_currency = gl_dict.credit if account_currency == company_currency \
Revant Nandgaonkar5da941b2016-02-18 16:02:05 +05301496 else flt(gl_dict.credit / conversion_rate, 2)
Nabin Hait1991c7b2016-06-27 20:09:05 +05301497
1498
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301499def get_advance_journal_entries(party_type, party, party_account, amount_field,
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001500 order_doctype, order_list, include_unallocated=True):
1501 dr_or_cr = "credit_in_account_currency" if party_type == "Customer" else "debit_in_account_currency"
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301502
Nabin Hait1991c7b2016-06-27 20:09:05 +05301503 conditions = []
1504 if include_unallocated:
1505 conditions.append("ifnull(t2.reference_name, '')=''")
1506
1507 if order_list:
1508 order_condition = ', '.join(['%s'] * len(order_list))
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001509 conditions.append(" (t2.reference_type = '{0}' and ifnull(t2.reference_name, '') in ({1}))" \
1510 .format(order_doctype, order_condition))
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301511
Nabin Hait1991c7b2016-06-27 20:09:05 +05301512 reference_condition = " and (" + " or ".join(conditions) + ")" if conditions else ""
Rushabh Mehta66958302017-01-16 16:57:53 +05301513
Nabin Hait1991c7b2016-06-27 20:09:05 +05301514 journal_entries = frappe.db.sql("""
1515 select
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301516 "Journal Entry" as reference_type, t1.name as reference_name,
Nabin Hait1991c7b2016-06-27 20:09:05 +05301517 t1.remark as remarks, t2.{0} as amount, t2.name as reference_row,
1518 t2.reference_name as against_order
1519 from
1520 `tabJournal Entry` t1, `tabJournal Entry Account` t2
1521 where
1522 t1.name = t2.parent and t2.account = %s
1523 and t2.party_type = %s and t2.party = %s
1524 and t2.is_advance = 'Yes' and t1.docstatus = 1
Nabin Haitca627fb2016-09-05 16:16:53 +05301525 and {1} > 0 {2}
Nabin Hait1991c7b2016-06-27 20:09:05 +05301526 order by t1.posting_date""".format(amount_field, dr_or_cr, reference_condition),
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001527 [party_account, party_type, party] + order_list, as_dict=1)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301528
Nabin Hait1991c7b2016-06-27 20:09:05 +05301529 return list(journal_entries)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301530
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001531
Rohit Waghchauref7258162019-01-15 18:12:04 +05301532def get_advance_payment_entries(party_type, party, party_account, order_doctype,
Nabin Hait34c551d2019-07-03 10:34:31 +05301533 order_list=None, include_unallocated=True, against_all_orders=False, limit=None):
Nabin Hait1991c7b2016-06-27 20:09:05 +05301534 party_account_field = "paid_from" if party_type == "Customer" else "paid_to"
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301535 currency_field = "paid_from_account_currency" if party_type == "Customer" else "paid_to_account_currency"
Nabin Hait1991c7b2016-06-27 20:09:05 +05301536 payment_type = "Receive" if party_type == "Customer" else "Pay"
Saqiba20999c2021-07-12 14:33:23 +05301537 exchange_rate_field = "source_exchange_rate" if payment_type == "Receive" else "target_exchange_rate"
1538
Nabin Hait1991c7b2016-06-27 20:09:05 +05301539 payment_entries_against_order, unallocated_payment_entries = [], []
Nabin Hait34c551d2019-07-03 10:34:31 +05301540 limit_cond = "limit %s" % limit if limit else ""
Nabin Haitff2f3ef2016-07-04 11:41:14 +05301541
Nabin Hait1991c7b2016-06-27 20:09:05 +05301542 if order_list or against_all_orders:
1543 if order_list:
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001544 reference_condition = " and t2.reference_name in ({0})" \
Nabin Hait1991c7b2016-06-27 20:09:05 +05301545 .format(', '.join(['%s'] * len(order_list)))
1546 else:
1547 reference_condition = ""
1548 order_list = []
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301549
Nabin Hait1991c7b2016-06-27 20:09:05 +05301550 payment_entries_against_order = frappe.db.sql("""
1551 select
1552 "Payment Entry" as reference_type, t1.name as reference_name,
1553 t1.remarks, t2.allocated_amount as amount, t2.name as reference_row,
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301554 t2.reference_name as against_order, t1.posting_date,
Saqiba20999c2021-07-12 14:33:23 +05301555 t1.{0} as currency, t1.{4} as exchange_rate
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301556 from `tabPayment Entry` t1, `tabPayment Entry Reference` t2
Nabin Hait1991c7b2016-06-27 20:09:05 +05301557 where
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301558 t1.name = t2.parent and t1.{1} = %s and t1.payment_type = %s
Nabin Hait1991c7b2016-06-27 20:09:05 +05301559 and t1.party_type = %s and t1.party = %s and t1.docstatus = 1
Deepesh Gargc7eadfc2020-07-22 17:59:37 +05301560 and t2.reference_doctype = %s {2}
1561 order by t1.posting_date {3}
Saqiba20999c2021-07-12 14:33:23 +05301562 """.format(currency_field, party_account_field, reference_condition, limit_cond, exchange_rate_field),
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001563 [party_account, payment_type, party_type, party,
1564 order_doctype] + order_list, as_dict=1)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301565
Nabin Hait1991c7b2016-06-27 20:09:05 +05301566 if include_unallocated:
1567 unallocated_payment_entries = frappe.db.sql("""
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301568 select "Payment Entry" as reference_type, name as reference_name,
Saqiba20999c2021-07-12 14:33:23 +05301569 remarks, unallocated_amount as amount, {2} as exchange_rate
Nabin Hait1991c7b2016-06-27 20:09:05 +05301570 from `tabPayment Entry`
1571 where
1572 {0} = %s and party_type = %s and party = %s and payment_type = %s
1573 and docstatus = 1 and unallocated_amount > 0
Rohit Waghchauref7258162019-01-15 18:12:04 +05301574 order by posting_date {1}
Saqiba20999c2021-07-12 14:33:23 +05301575 """.format(party_account_field, limit_cond, exchange_rate_field),
1576 (party_account, party_type, party, payment_type), as_dict=1)
Rushabh Mehtaea0ff232016-07-07 14:02:26 +05301577
Rohit Waghchaure2f1db572016-11-08 12:39:33 +05301578 return list(payment_entries_against_order) + list(unallocated_payment_entries)
1579
1580def update_invoice_status():
1581 # Daily update the status of the invoices
1582
Rushabh Mehta66958302017-01-16 16:57:53 +05301583 frappe.db.sql(""" update `tabSales Invoice` set status = 'Overdue'
Rohit Waghchaure2f1db572016-11-08 12:39:33 +05301584 where due_date < CURDATE() and docstatus = 1 and outstanding_amount > 0""")
1585
Rushabh Mehta66958302017-01-16 16:57:53 +05301586 frappe.db.sql(""" update `tabPurchase Invoice` set status = 'Overdue'
Nabin Hait92759692017-08-15 08:23:51 +05301587 where due_date < CURDATE() and docstatus = 1 and outstanding_amount > 0""")
1588
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001589
Nabin Hait92759692017-08-15 08:23:51 +05301590@frappe.whitelist()
Saqib Ansarid552fe62021-04-23 14:46:52 +05301591def 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 +05301592 if not terms_template:
1593 return
1594
1595 terms_doc = frappe.get_doc("Payment Terms Template", terms_template)
1596
1597 schedule = []
tundefb144302017-08-19 15:01:40 +01001598 for d in terms_doc.get("terms"):
Saqib Ansarid552fe62021-04-23 14:46:52 +05301599 term_details = get_payment_term_details(d, posting_date, grand_total, base_grand_total, bill_date)
Nabin Hait92759692017-08-15 08:23:51 +05301600 schedule.append(term_details)
1601
1602 return schedule
1603
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001604
Nabin Hait92759692017-08-15 08:23:51 +05301605@frappe.whitelist()
Saqib Ansarid552fe62021-04-23 14:46:52 +05301606def 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 +05301607 term_details = frappe._dict()
Achilles Rasquinha90509982018-03-08 12:55:41 +05301608 if isinstance(term, text_type):
Nabin Hait92759692017-08-15 08:23:51 +05301609 term = frappe.get_doc("Payment Term", term)
1610 else:
1611 term_details.payment_term = term.payment_term
1612 term_details.description = term.description
1613 term_details.invoice_portion = term.invoice_portion
Rohit Waghchaure52bf56d2017-11-27 11:43:52 +05301614 term_details.payment_amount = flt(term.invoice_portion) * flt(grand_total) / 100
Saqib Ansarid552fe62021-04-23 14:46:52 +05301615 term_details.base_payment_amount = flt(term.invoice_portion) * flt(base_grand_total) / 100
Saqib0586b7d2021-03-31 15:03:53 +05301616 term_details.discount_type = term.discount_type
1617 term_details.discount = term.discount
Saqib0586b7d2021-03-31 15:03:53 +05301618 term_details.outstanding = term_details.payment_amount
1619 term_details.mode_of_payment = term.mode_of_payment
1620
Shreya Shah3a9eec22018-02-16 13:05:21 +05301621 if bill_date:
1622 term_details.due_date = get_due_date(term, bill_date)
Saqib0586b7d2021-03-31 15:03:53 +05301623 term_details.discount_date = get_discount_date(term, bill_date)
Shreya Shah3a9eec22018-02-16 13:05:21 +05301624 elif posting_date:
1625 term_details.due_date = get_due_date(term, posting_date)
Saqib0586b7d2021-03-31 15:03:53 +05301626 term_details.discount_date = get_discount_date(term, posting_date)
Shreya Shah3a9eec22018-02-16 13:05:21 +05301627
1628 if getdate(term_details.due_date) < getdate(posting_date):
1629 term_details.due_date = posting_date
1630
Nabin Hait92759692017-08-15 08:23:51 +05301631 return term_details
1632
Shreya Shah3a9eec22018-02-16 13:05:21 +05301633def get_due_date(term, posting_date=None, bill_date=None):
Nabin Hait92759692017-08-15 08:23:51 +05301634 due_date = None
Shreya Shah3a9eec22018-02-16 13:05:21 +05301635 date = bill_date or posting_date
Nabin Hait92759692017-08-15 08:23:51 +05301636 if term.due_date_based_on == "Day(s) after invoice date":
Shreya Shah3a9eec22018-02-16 13:05:21 +05301637 due_date = add_days(date, term.credit_days)
Nabin Hait92759692017-08-15 08:23:51 +05301638 elif term.due_date_based_on == "Day(s) after the end of the invoice month":
Shreya Shah3a9eec22018-02-16 13:05:21 +05301639 due_date = add_days(get_last_day(date), term.credit_days)
Nabin Hait92759692017-08-15 08:23:51 +05301640 elif term.due_date_based_on == "Month(s) after the end of the invoice month":
Shreya Shah3a9eec22018-02-16 13:05:21 +05301641 due_date = add_months(get_last_day(date), term.credit_months)
tunde96b8f222017-09-08 15:35:59 +01001642 return due_date
tundebabzyad08d4c2018-05-16 07:01:41 +01001643
Saqib0586b7d2021-03-31 15:03:53 +05301644def get_discount_date(term, posting_date=None, bill_date=None):
1645 discount_validity = None
1646 date = bill_date or posting_date
1647 if term.discount_validity_based_on == "Day(s) after invoice date":
1648 discount_validity = add_days(date, term.discount_validity)
1649 elif term.discount_validity_based_on == "Day(s) after the end of the invoice month":
1650 discount_validity = add_days(get_last_day(date), term.discount_validity)
1651 elif term.discount_validity_based_on == "Month(s) after the end of the invoice month":
1652 discount_validity = add_months(get_last_day(date), term.discount_validity)
1653 return discount_validity
tundebabzyad08d4c2018-05-16 07:01:41 +01001654
1655def get_supplier_block_status(party_name):
1656 """
1657 Returns a dict containing the values of `on_hold`, `release_date` and `hold_type` of
1658 a `Supplier`
1659 """
1660 supplier = frappe.get_doc('Supplier', party_name)
1661 info = {
1662 'on_hold': supplier.on_hold,
1663 'release_date': supplier.release_date,
1664 'hold_type': supplier.hold_type
1665 }
1666 return info
1667
marination698d9832020-08-19 14:59:46 +05301668def set_child_tax_template_and_map(item, child_item, parent_doc):
1669 args = {
1670 'item_code': item.item_code,
1671 'posting_date': parent_doc.transaction_date,
1672 'tax_category': parent_doc.get('tax_category'),
1673 'company': parent_doc.get('company')
1674 }
1675
1676 child_item.item_tax_template = _get_item_tax_template(args, item.taxes)
1677 if child_item.get("item_tax_template"):
1678 child_item.item_tax_rate = get_item_tax_map(parent_doc.get('company'), child_item.item_tax_template, as_json=True)
1679
Afshanb3bbebd2021-08-09 14:39:32 +05301680def add_taxes_from_tax_template(child_item, parent_doc, db_insert=True):
Marica3b1be2b2020-10-22 17:04:31 +05301681 add_taxes_from_item_tax_template = frappe.db.get_single_value("Accounts Settings", "add_taxes_from_item_tax_template")
1682
1683 if child_item.get("item_tax_rate") and add_taxes_from_item_tax_template:
1684 tax_map = json.loads(child_item.get("item_tax_rate"))
1685 for tax_type in tax_map:
1686 tax_rate = flt(tax_map[tax_type])
1687 taxes = parent_doc.get('taxes') or []
1688 # add new row for tax head only if missing
1689 found = any(tax.account_head == tax_type for tax in taxes)
1690 if not found:
1691 tax_row = parent_doc.append("taxes", {})
1692 tax_row.update({
1693 "description" : str(tax_type).split(' - ')[0],
1694 "charge_type" : "On Net Total",
1695 "account_head" : tax_type,
1696 "rate" : tax_rate
1697 })
1698 if parent_doc.doctype == "Purchase Order":
1699 tax_row.update({
1700 "category" : "Total",
1701 "add_deduct_tax" : "Add"
1702 })
Afshanb3bbebd2021-08-09 14:39:32 +05301703 if db_insert:
1704 tax_row.db_insert()
Marica3b1be2b2020-10-22 17:04:31 +05301705
pateljannat637ddff2021-02-09 16:17:30 +05301706def set_order_defaults(parent_doctype, parent_doctype_name, child_doctype, child_docname, trans_item):
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001707 """
pateljannat637ddff2021-02-09 16:17:30 +05301708 Returns a Sales/Purchase Order Item child item containing the default values
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001709 """
Saqib438e0432020-04-03 10:02:56 +05301710 p_doc = frappe.get_doc(parent_doctype, parent_doctype_name)
pateljannat637ddff2021-02-09 16:17:30 +05301711 child_item = frappe.new_doc(child_doctype, p_doc, child_docname)
Saqib Ansarif53299e2020-04-15 22:08:12 +05301712 item = frappe.get_doc("Item", trans_item.get('item_code'))
marination0673f552021-03-31 01:38:22 +05301713
pateljannat637ddff2021-02-09 16:17:30 +05301714 for field in ("item_code", "item_name", "description", "item_group"):
marination0673f552021-03-31 01:38:22 +05301715 child_item.update({field: item.get(field)})
1716
pateljannat637ddff2021-02-09 16:17:30 +05301717 date_fieldname = "delivery_date" if child_doctype == "Sales Order Item" else "schedule_date"
Jannat Patelbb0d8f82021-02-11 20:59:28 +05301718 child_item.update({date_fieldname: trans_item.get(date_fieldname) or p_doc.get(date_fieldname)})
marination0673f552021-03-31 01:38:22 +05301719 child_item.stock_uom = item.stock_uom
Saqib61314242020-09-15 11:14:31 +05301720 child_item.uom = trans_item.get("uom") or item.stock_uom
Andy Zhu1062d7e2020-10-06 10:51:42 +13001721 child_item.warehouse = get_item_warehouse(item, p_doc, overwrite_warehouse=True)
Saqib61314242020-09-15 11:14:31 +05301722 conversion_factor = flt(get_conversion_factor(item.item_code, child_item.uom).get("conversion_factor"))
1723 child_item.conversion_factor = flt(trans_item.get('conversion_factor')) or conversion_factor
marination0673f552021-03-31 01:38:22 +05301724
pateljannat637ddff2021-02-09 16:17:30 +05301725 if child_doctype == "Purchase Order Item":
marination0673f552021-03-31 01:38:22 +05301726 # Initialized value will update in parent validation
1727 child_item.base_rate = 1
1728 child_item.base_amount = 1
pateljannat637ddff2021-02-09 16:17:30 +05301729 if child_doctype == "Sales Order Item":
1730 child_item.warehouse = get_item_warehouse(item, p_doc, overwrite_warehouse=True)
1731 if not child_item.warehouse:
1732 frappe.throw(_("Cannot find {} for item {}. Please set the same in Item Master or Stock Settings.")
1733 .format(frappe.bold("default warehouse"), frappe.bold(item.item_code)))
marination0673f552021-03-31 01:38:22 +05301734
marination698d9832020-08-19 14:59:46 +05301735 set_child_tax_template_and_map(item, child_item, p_doc)
Marica3b1be2b2020-10-22 17:04:31 +05301736 add_taxes_from_tax_template(child_item, p_doc)
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001737 return child_item
1738
marination0673f552021-03-31 01:38:22 +05301739def validate_child_on_delete(row, parent):
1740 """Check if partially transacted item (row) is being deleted."""
1741 if parent.doctype == "Sales Order":
1742 if flt(row.delivered_qty):
1743 frappe.throw(_("Row #{0}: Cannot delete item {1} which has already been delivered").format(row.idx, row.item_code))
1744 if flt(row.work_order_qty):
1745 frappe.throw(_("Row #{0}: Cannot delete item {1} which has work order assigned to it.").format(row.idx, row.item_code))
1746 if flt(row.ordered_qty):
1747 frappe.throw(_("Row #{0}: Cannot delete item {1} which is assigned to customer's purchase order.").format(row.idx, row.item_code))
1748
1749 if parent.doctype == "Purchase Order" and flt(row.received_qty):
1750 frappe.throw(_("Row #{0}: Cannot delete item {1} which has already been received").format(row.idx, row.item_code))
1751
1752 if flt(row.billed_amt):
1753 frappe.throw(_("Row #{0}: Cannot delete item {1} which has already been billed.").format(row.idx, row.item_code))
1754
1755def update_bin_on_delete(row, doctype):
1756 """Update bin for deleted item (row)."""
1757 from erpnext.stock.stock_balance import update_bin_qty, get_reserved_qty, get_ordered_qty, get_indented_qty
1758 qty_dict = {}
1759
1760 if doctype == "Sales Order":
1761 qty_dict["reserved_qty"] = get_reserved_qty(row.item_code, row.warehouse)
1762 else:
1763 if row.material_request_item:
1764 qty_dict["indented_qty"] = get_indented_qty(row.item_code, row.warehouse)
1765
1766 qty_dict["ordered_qty"] = get_ordered_qty(row.item_code, row.warehouse)
1767
1768 update_bin_qty(row.item_code, row.warehouse, qty_dict)
1769
Saqib6db92fb2020-09-14 19:54:17 +05301770def validate_and_delete_children(parent, data):
Saqib0ad74492019-12-24 16:42:30 +05301771 deleted_children = []
1772 updated_item_names = [d.get("docname") for d in data]
1773 for item in parent.items:
1774 if item.name not in updated_item_names:
1775 deleted_children.append(item)
1776
1777 for d in deleted_children:
marination0673f552021-03-31 01:38:22 +05301778 validate_child_on_delete(d, parent)
Saqib0ad74492019-12-24 16:42:30 +05301779 d.cancel()
1780 d.delete()
marination0673f552021-03-31 01:38:22 +05301781
1782 # need to update ordered qty in Material Request first
1783 # bin uses Material Request Items to recalculate & update
1784 parent.update_prevdoc_status()
1785
1786 for d in deleted_children:
1787 update_bin_on_delete(d, parent.doctype)
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001788
Rohan Bansala93b5142021-04-06 17:10:52 +05301789
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001790@frappe.whitelist()
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001791def update_child_qty_rate(parent_doctype, trans_items, parent_doctype_name, child_docname="items"):
Saqib6db92fb2020-09-14 19:54:17 +05301792 def check_doc_permissions(doc, perm_type='create'):
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301793 try:
1794 doc.check_permission(perm_type)
Saqib6db92fb2020-09-14 19:54:17 +05301795 except frappe.PermissionError:
marination661bf642020-09-29 18:16:45 +05301796 actions = { 'create': 'add', 'write': 'update'}
Saqib6db92fb2020-09-14 19:54:17 +05301797
1798 frappe.throw(_("You do not have permissions to {} items in a {}.")
1799 .format(actions[perm_type], parent_doctype), title=_("Insufficient Permissions"))
marination665c27a2020-09-15 12:04:38 +05301800
Saqib6db92fb2020-09-14 19:54:17 +05301801 def validate_workflow_conditions(doc):
1802 workflow = get_workflow_name(doc.doctype)
1803 if not workflow:
1804 return
1805
1806 workflow_doc = frappe.get_doc("Workflow", workflow)
1807 current_state = doc.get(workflow_doc.workflow_state_field)
1808 roles = frappe.get_roles()
1809
1810 transitions = []
1811 for transition in workflow_doc.transitions:
1812 if transition.next_state == current_state and transition.allowed in roles:
1813 if not is_transition_condition_satisfied(transition, doc):
1814 continue
1815 transitions.append(transition.as_dict())
1816
1817 if not transitions:
Saqib18318932020-09-23 13:01:49 +05301818 frappe.throw(
1819 _("You are not allowed to update as per the conditions set in {} Workflow.").format(get_link_to_form("Workflow", workflow)),
1820 title=_("Insufficient Permissions")
1821 )
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301822
Rohit Waghchaure8d5380a2020-06-18 14:06:31 +05301823 def get_new_child_item(item_row):
Rohit Waghchaureff70e612021-03-06 22:08:08 +05301824 child_doctype = "Sales Order Item" if parent_doctype == "Sales Order" else "Purchase Order Item"
pateljannat637ddff2021-02-09 16:17:30 +05301825 return set_order_defaults(parent_doctype, parent_doctype_name, child_doctype, child_docname, item_row)
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301826
1827 def validate_quantity(child_item, d):
1828 if parent_doctype == "Sales Order" and flt(d.get("qty")) < flt(child_item.delivered_qty):
1829 frappe.throw(_("Cannot set quantity less than delivered quantity"))
1830
1831 if parent_doctype == "Purchase Order" and flt(d.get("qty")) < flt(child_item.received_qty):
1832 frappe.throw(_("Cannot set quantity less than received quantity"))
1833
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001834 data = json.loads(trans_items)
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001835
rohitwaghchaure81c21752019-10-31 15:56:10 +05301836 sales_doctypes = ['Sales Order', 'Sales Invoice', 'Delivery Note', 'Quotation']
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301837 parent = frappe.get_doc(parent_doctype, parent_doctype_name)
marination665c27a2020-09-15 12:04:38 +05301838
marination661bf642020-09-29 18:16:45 +05301839 check_doc_permissions(parent, 'write')
Saqib6db92fb2020-09-14 19:54:17 +05301840 validate_and_delete_children(parent, data)
Saqib0ad74492019-12-24 16:42:30 +05301841
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001842 for d in data:
1843 new_child_flag = False
1844 if not d.get("docname"):
1845 new_child_flag = True
Saqib6db92fb2020-09-14 19:54:17 +05301846 check_doc_permissions(parent, 'create')
Rohit Waghchaure8d5380a2020-06-18 14:06:31 +05301847 child_item = get_new_child_item(d)
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001848 else:
Saqib6db92fb2020-09-14 19:54:17 +05301849 check_doc_permissions(parent, 'write')
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001850 child_item = frappe.get_doc(parent_doctype + ' Item', d.get("docname"))
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301851
Saqib Ansaric579b082020-05-29 22:21:50 +05301852 prev_rate, new_rate = flt(child_item.get("rate")), flt(d.get("rate"))
1853 prev_qty, new_qty = flt(child_item.get("qty")), flt(d.get("qty"))
1854 prev_con_fac, new_con_fac = flt(child_item.get("conversion_factor")), flt(d.get("conversion_factor"))
Saqib61314242020-09-15 11:14:31 +05301855 prev_uom, new_uom = child_item.get("uom"), d.get("uom")
Saqib Ansaric579b082020-05-29 22:21:50 +05301856
1857 if parent_doctype == 'Sales Order':
1858 prev_date, new_date = child_item.get("delivery_date"), d.get("delivery_date")
1859 elif parent_doctype == 'Purchase Order':
marinationb7e94cc2020-06-15 11:32:42 +05301860 prev_date, new_date = child_item.get("schedule_date"), d.get("schedule_date")
Saqib Ansaric579b082020-05-29 22:21:50 +05301861
1862 rate_unchanged = prev_rate == new_rate
marinationf9c4b202020-06-12 15:49:53 +05301863 qty_unchanged = prev_qty == new_qty
Saqib61314242020-09-15 11:14:31 +05301864 uom_unchanged = prev_uom == new_uom
Saqib Ansaric579b082020-05-29 22:21:50 +05301865 conversion_factor_unchanged = prev_con_fac == new_con_fac
1866 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 +05301867 if rate_unchanged and qty_unchanged and conversion_factor_unchanged and uom_unchanged and date_unchanged:
Saqibdd374ff2020-02-27 12:51:31 +05301868 continue
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001869
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301870 validate_quantity(child_item, d)
deepeshgarg00777cde832018-12-27 15:56:51 +05301871
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001872 child_item.qty = flt(d.get("qty"))
Saqib56fea7d2020-10-09 21:19:25 +05301873 rate_precision = child_item.precision("rate") or 2
1874 conv_fac_precision = child_item.precision("conversion_factor") or 2
1875 qty_precision = child_item.precision("qty") or 2
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001876
Saqib56fea7d2020-10-09 21:19:25 +05301877 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 +08001878 frappe.throw(_("Row #{0}: Cannot set Rate if amount is greater than billed amount for Item {1}.")
1879 .format(child_item.idx, child_item.item_code))
1880 else:
Saqib56fea7d2020-10-09 21:19:25 +05301881 child_item.rate = flt(d.get("rate"), rate_precision)
marinationf9c4b202020-06-12 15:49:53 +05301882
Saqib Ansari2c3c8aa2020-05-29 21:55:38 +05301883 if d.get("conversion_factor"):
marinationf9c4b202020-06-12 15:49:53 +05301884 if child_item.stock_uom == child_item.uom:
1885 child_item.conversion_factor = 1
1886 else:
Saqib56fea7d2020-10-09 21:19:25 +05301887 child_item.conversion_factor = flt(d.get('conversion_factor'), conv_fac_precision)
marination665c27a2020-09-15 12:04:38 +05301888
Saqib61314242020-09-15 11:14:31 +05301889 if d.get("uom"):
1890 child_item.uom = d.get("uom")
1891 conversion_factor = flt(get_conversion_factor(child_item.item_code, child_item.uom).get("conversion_factor"))
Saqib56fea7d2020-10-09 21:19:25 +05301892 child_item.conversion_factor = flt(d.get('conversion_factor'), conv_fac_precision) or conversion_factor
Mangesh-Khairnara3d52002019-08-05 10:16:40 +05301893
Saqib Ansaric579b082020-05-29 22:21:50 +05301894 if d.get("delivery_date") and parent_doctype == 'Sales Order':
1895 child_item.delivery_date = d.get('delivery_date')
marinationf9c4b202020-06-12 15:49:53 +05301896
Saqib Ansaric579b082020-05-29 22:21:50 +05301897 if d.get("schedule_date") and parent_doctype == 'Purchase Order':
1898 child_item.schedule_date = d.get('schedule_date')
1899
Mangesh-Khairnara3d52002019-08-05 10:16:40 +05301900 if flt(child_item.price_list_rate):
Maricaf0674472019-10-11 10:47:09 +05301901 if flt(child_item.rate) > flt(child_item.price_list_rate):
1902 # if rate is greater than price_list_rate, set margin
1903 # or set discount
1904 child_item.discount_percentage = 0
rohitwaghchaure81c21752019-10-31 15:56:10 +05301905
1906 if parent_doctype in sales_doctypes:
1907 child_item.margin_type = "Amount"
1908 child_item.margin_rate_or_amount = flt(child_item.rate - child_item.price_list_rate,
1909 child_item.precision("margin_rate_or_amount"))
1910 child_item.rate_with_margin = child_item.rate
Maricaf0674472019-10-11 10:47:09 +05301911 else:
1912 child_item.discount_percentage = flt((1 - flt(child_item.rate) / flt(child_item.price_list_rate)) * 100.0,
1913 child_item.precision("discount_percentage"))
1914 child_item.discount_amount = flt(
1915 child_item.price_list_rate) - flt(child_item.rate)
rohitwaghchaure81c21752019-10-31 15:56:10 +05301916
1917 if parent_doctype in sales_doctypes:
1918 child_item.margin_type = ""
1919 child_item.margin_rate_or_amount = 0
1920 child_item.rate_with_margin = 0
Mangesh-Khairnara3d52002019-08-05 10:16:40 +05301921
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001922 child_item.flags.ignore_validate_update_after_submit = True
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001923 if new_child_flag:
Saqib Ansarif53299e2020-04-15 22:08:12 +05301924 parent.load_from_db()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301925 child_item.idx = len(parent.items) + 1
Stavros Anastasiadis3d82b742018-12-10 13:00:55 +01001926 child_item.insert()
1927 else:
1928 child_item.save()
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001929
Rushabh Mehtafafbb022018-12-24 22:09:15 +05301930 parent.reload()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301931 parent.flags.ignore_validate_update_after_submit = True
1932 parent.set_qty_as_per_stock_uom()
1933 parent.calculate_taxes_and_totals()
Ankush Menatdf6e2082021-02-11 11:04:39 +05301934 parent.set_total_in_words()
Nabin Hait49a46f02019-10-21 13:35:43 +05301935 if parent_doctype == "Sales Order":
Marica3dee5272020-06-23 10:33:47 +05301936 make_packing_list(parent)
Nabin Hait49a46f02019-10-21 13:35:43 +05301937 parent.set_gross_profit()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301938 frappe.get_doc('Authorization Control').validate_approving_authority(parent.doctype,
1939 parent.company, parent.base_grand_total)
Doridel Cahanap6f06cc22018-05-17 16:28:58 +08001940
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301941 parent.set_payment_schedule()
Nabin Haitb2da0822018-07-13 17:01:40 +05301942 if parent_doctype == 'Purchase Order':
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301943 parent.validate_minimum_order_qty()
1944 parent.validate_budget()
1945 if parent.is_against_so():
1946 parent.update_status_updater()
Nabin Haitb2da0822018-07-13 17:01:40 +05301947 else:
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301948 parent.check_credit_limit()
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301949 parent.save()
Nabin Haitb2da0822018-07-13 17:01:40 +05301950
1951 if parent_doctype == 'Purchase Order':
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301952 update_last_purchase_rate(parent, is_submit = 1)
1953 parent.update_prevdoc_status()
1954 parent.update_requested_qty()
1955 parent.update_ordered_qty()
1956 parent.update_ordered_and_reserved_qty()
1957 parent.update_receiving_percentage()
1958 if parent.is_subcontracted == "Yes":
1959 parent.update_reserved_qty_for_subcontract()
Saqib61314242020-09-15 11:14:31 +05301960 parent.create_raw_materials_supplied("supplied_items")
1961 parent.save()
Nabin Haitb2da0822018-07-13 17:01:40 +05301962 else:
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301963 parent.update_reserved_qty()
1964 parent.update_project()
1965 parent.update_prevdoc_status('submit')
1966 parent.update_delivery_status()
Nabin Haitb2da0822018-07-13 17:01:40 +05301967
Saqib6db92fb2020-09-14 19:54:17 +05301968 parent.reload()
1969 validate_workflow_conditions(parent)
1970
Rushabh Mehtac9b1a352018-12-24 20:55:35 +05301971 parent.update_blanket_order()
1972 parent.update_billing_percentage()
1973 parent.set_status()
Gauravf1e28e02019-02-13 16:46:24 +05301974
1975@erpnext.allow_regional
1976def validate_regional(doc):
1977 pass
Saqib6d74f5b2020-12-25 10:26:43 +05301978
1979@erpnext.allow_regional
1980def validate_einvoice_fields(doc):
GangaManoj4323f4b2021-07-22 05:57:42 +05301981 pass