# Copyright (c) 2015, Frappe Technologies Pvt. Ltd. and Contributors # License: GNU General Public License v3. See license.txt import json import frappe from frappe import ValidationError, _, msgprint from frappe.contacts.doctype.address.address import render_address from frappe.utils import cint, flt, format_date, get_link_to_form, getdate from frappe.utils.data import nowtime import erpnext from erpnext.accounts.doctype.accounting_dimension.accounting_dimension import get_dimensions from erpnext.accounts.doctype.budget.budget import validate_expense_against_budget from erpnext.accounts.party import _get_party_details from erpnext.buying.utils import update_last_purchase_rate, validate_for_items from erpnext.controllers.accounts_controller import get_taxes_and_charges from erpnext.controllers.sales_and_purchase_return import get_rate_for_return from erpnext.controllers.subcontracting_controller import SubcontractingController from erpnext.stock.get_item_details import ( NOT_APPLICABLE_TAX, get_conversion_factor, get_item_defaults, ) from erpnext.stock.utils import get_incoming_rate class QtyMismatchError(ValidationError): pass class BuyingController(SubcontractingController): def __setup__(self): self.flags.ignore_permlevel_for_fields = ["buying_price_list", "price_list_currency"] def validate(self): from erpnext.stock.doctype.landed_cost_voucher.landed_cost_voucher import ( set_landed_cost_voucher_amount, ) self.set_rate_for_standalone_debit_note() super().validate() if getattr(self, "supplier", None) and not self.supplier_name: self.supplier_name = frappe.db.get_value("Supplier", self.supplier, "supplier_name") self.validate_items() self.set_qty_as_per_stock_uom() self.validate_stock_or_nonstock_items() self.validate_warehouse() self.validate_from_warehouse() self.set_supplier_address() self.validate_asset_return() self.validate_auto_repeat_subscription_dates() self.create_package_for_transfer() if self.doctype == "Purchase Invoice": self.validate_purchase_receipt_if_update_stock() if self.doctype == "Purchase Receipt" or (self.doctype == "Purchase Invoice" and self.update_stock): self.validate_purchase_return() self.validate_rejected_warehouse() self.validate_accepted_rejected_qty() validate_for_items(self) set_landed_cost_voucher_amount(self) if self.doctype in ("Purchase Receipt", "Purchase Invoice"): self.update_valuation_rate() self.set_serial_and_batch_bundle() def onload(self): super().onload() self.set_onload( "backflush_based_on", frappe.db.get_single_value("Buying Settings", "backflush_raw_materials_of_subcontract_based_on"), ) if self.docstatus == 1 and self.doctype in ["Purchase Receipt", "Purchase Invoice"]: self.set_onload( "allow_to_make_qc_after_submission", frappe.get_single_value( "Stock Settings", "allow_to_make_quality_inspection_after_purchase_or_delivery" ), ) if ( self.get("company") and ( default_buying_terms := frappe.get_value( "Company", self.get("company"), "default_buying_terms" ) ) and not self.get("tc_name") and not self.get("terms") ): self.tc_name = default_buying_terms self.terms = frappe.get_value("Terms and Conditions", self.get("tc_name"), "terms") def validate_posting_date_with_po(self): po_list = {x.purchase_order for x in self.items if x.purchase_order} if not po_list: return invalid_po = [] po_dates = frappe._dict( frappe.get_all( "Purchase Order", filters={"name": ["in", po_list]}, fields=["name", "transaction_date"], as_list=True, ) ) for po in po_list: po_date = po_dates[po] if getdate(po_date) > getdate(self.posting_date): invalid_po.append((get_link_to_form("Purchase Order", po), format_date(po_date))) if not invalid_po: return msg = _("

Posting Date {0} cannot be before Purchase Order date for the following:

" frappe.throw(msg) def create_package_for_transfer(self) -> None: """Create serial and batch package for Sourece Warehouse in case of inter transfer.""" if self.is_internal_transfer() and ( self.doctype == "Purchase Receipt" or (self.doctype == "Purchase Invoice" and self.update_stock) ): field = "delivery_note_item" if self.doctype == "Purchase Receipt" else "sales_invoice_item" doctype = "Delivery Note Item" if self.doctype == "Purchase Receipt" else "Sales Invoice Item" ids = [d.get(field) for d in self.get("items") if d.get(field)] bundle_ids = {} if ids: for bundle in frappe.get_all( doctype, filters={"name": ("in", ids)}, fields=["serial_and_batch_bundle", "name"] ): bundle_ids[bundle.name] = bundle.serial_and_batch_bundle if not bundle_ids: return for item in self.get("items"): if item.get(field) and not item.serial_and_batch_bundle and bundle_ids.get(item.get(field)): item.serial_and_batch_bundle = self.make_package_for_transfer( bundle_ids.get(item.get(field)), item.from_warehouse, type_of_transaction="Outward", do_not_submit=True, qty=item.qty, ) elif ( not self.is_new() and item.serial_and_batch_bundle and next( ( old_item for old_item in self.get_doc_before_save().items if old_item.name == item.name and old_item.qty != item.qty ), None, ) and len( sabe := frappe.get_all( "Serial and Batch Entry", filters={"parent": item.serial_and_batch_bundle, "serial_no": ["is", "not set"]}, pluck="name", ) ) == 1 ): frappe.set_value("Serial and Batch Entry", sabe[0], "qty", item.qty) def set_rate_for_standalone_debit_note(self): if self.get("is_return") and self.get("update_stock") and not self.return_against: for row in self.items: if row.rate <= 0: # override the rate with valuation rate row.rate = get_incoming_rate( { "item_code": row.item_code, "warehouse": row.warehouse, "posting_date": self.get("posting_date"), "posting_time": self.get("posting_time"), "qty": row.qty, "serial_and_batch_bundle": row.get("serial_and_batch_bundle"), "company": self.company, "voucher_type": self.doctype, "voucher_no": self.name, "voucher_detail_no": row.name, }, raise_error_if_no_rate=False, ) row.discount_percentage = 0.0 row.discount_amount = 0.0 row.margin_rate_or_amount = 0.0 def set_missing_values(self, for_validate=False): super().set_missing_values(for_validate) self.set_supplier_from_item_default() self.set_price_list_currency("Buying") # set contact and address details for supplier, if they are not mentioned if getattr(self, "supplier", None): self.update_if_missing( _get_party_details( self.supplier, party_type="Supplier", doctype=self.doctype, company=self.company, party_address=self.get("supplier_address"), shipping_address=self.get("shipping_address"), dispatch_address=self.get("dispatch_address"), company_address=self.get("billing_address"), fetch_payment_terms_template=not self.get("ignore_default_payment_terms_template"), ignore_permissions=self.flags.ignore_permissions, ) ) self.set_missing_item_details(for_validate) if self.meta.get_field("taxes"): if self.get("taxes_and_charges") and not self.get("taxes") and not for_validate: taxes = get_taxes_and_charges("Purchase Taxes and Charges Template", self.taxes_and_charges) for tax in taxes: self.append("taxes", tax) def set_supplier_from_item_default(self): if self.meta.get_field("supplier") and not self.supplier: for d in self.get("items"): supplier = frappe.db.get_value( "Item Default", {"parent": d.item_code, "company": self.company}, "default_supplier" ) if supplier: self.supplier = supplier else: item_group = frappe.db.get_value("Item", d.item_code, "item_group") supplier = frappe.db.get_value( "Item Default", {"parent": item_group, "company": self.company}, "default_supplier" ) if supplier: self.supplier = supplier break def validate_stock_or_nonstock_items(self): if self.meta.get_field("taxes") and not self.get_stock_items() and not self.get_asset_items(): msg = _('Tax Category has been changed to "Total" because all the Items are non-stock items') self.update_tax_category(msg) def update_tax_category(self, msg): tax_for_valuation = [ d for d in self.get("taxes") if d.category in ["Valuation", "Valuation and Total"] ] if tax_for_valuation: for d in tax_for_valuation: d.category = "Total" msgprint(msg) def validate_asset_return(self): if self.doctype not in ["Purchase Receipt", "Purchase Invoice"] or not self.is_return: return purchase_doc_field = "purchase_receipt" if self.doctype == "Purchase Receipt" else "purchase_invoice" not_cancelled_asset = [] if self.return_against: not_cancelled_asset = [ d.name for d in frappe.db.get_all("Asset", {purchase_doc_field: self.return_against, "docstatus": 1}) ] if self.is_return and len(not_cancelled_asset): frappe.throw( _( "{0} has submitted assets linked to it. You need to cancel the assets to create purchase return." ).format(self.return_against), title=_("Not Allowed"), ) def get_asset_items(self): if self.doctype not in ["Purchase Order", "Purchase Invoice", "Purchase Receipt"]: return [] return [d.item_code for d in self.items if d.is_fixed_asset] def validate_from_warehouse(self): for item in self.get("items"): if item.get("from_warehouse") and (item.get("from_warehouse") == item.get("warehouse")): frappe.throw( _("Row #{idx}: {from_warehouse_field} and {to_warehouse_field} cannot be same.").format( idx=item.idx, from_warehouse_field=_(item.meta.get_label("from_warehouse")), to_warehouse_field=_(item.meta.get_label("warehouse")), ) ) if item.get("from_warehouse") and self.get("is_subcontracted"): frappe.throw( _( "Row #{idx}: Cannot select Supplier Warehouse while suppling raw materials to subcontractor." ).format(idx=item.idx) ) def set_supplier_address(self): address_dict = { "supplier_address": "address_display", "shipping_address": "shipping_address_display", "dispatch_address": "dispatch_address_display", "billing_address": "billing_address_display", } for address_field, address_display_field in address_dict.items(): if self.get(address_field): self.set( address_display_field, render_address(self.get(address_field), check_permissions=False) ) def get_validated_purchase_expense_details(self, item_code): fields = ("purchase_expense_account", "purchase_expense_contra_account") details = get_purchase_expense_account(item_code, self.company) for field in fields: if not details.get(field): details[field] = frappe.get_cached_value("Company", self.company, field) for field in fields: if not details.get(field): frappe.throw( _("Please set {0} in Company {1} or in the Item Defaults of Item {2}").format( frappe.bold(_(frappe.unscrub(field))), self.company, item_code ) ) return details def set_gl_entry_for_purchase_expense(self, gl_entries): if not cint(frappe.db.get_single_value("Accounts Settings", "book_stock_expense_gl_entries")): return if self.doctype == "Purchase Invoice" and not self.update_stock: return stock_items = self.get_stock_items() for row in self.items: # A service item holds no stock value, so there is nothing to book against it - and it # must not make the expense accounts mandatory either. if row.item_code not in stock_items: continue details = self.get_validated_purchase_expense_details(row.item_code) if not details: continue amount = flt(row.valuation_rate * row.stock_qty, row.precision("base_amount")) if row.landed_cost_voucher_amount: amount -= flt(row.landed_cost_voucher_amount, row.precision("base_amount")) if not amount: # GL Entry rejects a row with neither a debit nor a credit. continue self.add_gl_entry( gl_entries=gl_entries, account=details.purchase_expense_account, cost_center=row.cost_center, debit=amount, credit=0.0, remarks=_("Purchase Expense for Item {0}").format(row.item_code), against_account=details.purchase_expense_contra_account, account_currency=frappe.get_cached_value( "Account", details.purchase_expense_account, "account_currency" ), item=row, ) self.add_gl_entry( gl_entries=gl_entries, account=details.purchase_expense_contra_account, cost_center=row.cost_center, debit=0.0, credit=amount, remarks=_("Purchase Expense for Item {0}").format(row.item_code), against_account=details.purchase_expense_account, account_currency=frappe.get_cached_value( "Account", details.purchase_expense_contra_account, "account_currency" ), item=row, ) def set_total_in_words(self): from frappe.utils import money_in_words if self.meta.get_field("base_in_words"): if self.meta.get_field("base_rounded_total") and not self.is_rounded_total_disabled(): amount = abs(flt(self.base_rounded_total)) else: amount = abs(flt(self.base_grand_total)) self.base_in_words = money_in_words(amount, self.company_currency) if self.meta.get_field("in_words"): if self.meta.get_field("rounded_total") and not self.is_rounded_total_disabled(): amount = abs(flt(self.rounded_total)) else: amount = abs(flt(self.grand_total)) self.in_words = money_in_words(amount, self.currency) # update valuation rate def update_valuation_rate(self, reset_outgoing_rate=True): """ item_tax_amount is the total tax amount applied on that item stored for valuation TODO: rename item_tax_amount to valuation_tax_amount """ stock_and_asset_items = [] stock_and_asset_items = self.get_stock_items() + self.get_asset_items() ( tax_accounts, total_valuation_amount, total_actual_tax_amount, total_actual_tax_on_stock_items, ) = self.get_tax_details() # Pre-compute each item's share of the "Actual" valuation charges (keyed by row object). actual_charge_per_item = self.distribute_actual_tax_amount( stock_and_asset_items, total_actual_tax_amount, total_actual_tax_on_stock_items ) last_item_idx = max((d.idx for d in self.get("items")), default=1) for i, item in enumerate(self.get("items")): if item.item_code and (item.qty or item.get("rejected_qty")): if i == (last_item_idx - 1): # dump any rounding remainder of the On Net Total valuation on the last item item_tax_amount = total_valuation_amount else: item_tax_amount = self.get_item_tax_amount(item, tax_accounts) total_valuation_amount -= item_tax_amount # This code is required here to calculate the correct valuation for stock items if item.item_code not in stock_and_asset_items: item.valuation_rate = 0.0 continue # Item tax amount is the total tax amount applied on that item and actual tax type amount item.item_tax_amount = flt( item_tax_amount + actual_charge_per_item.get(item.idx, 0.0), self.precision("item_tax_amount", item), ) self.round_floats_in(item) if flt(item.conversion_factor) == 0.0: item.conversion_factor = ( get_conversion_factor(item.item_code, item.uom).get("conversion_factor") or 1.0 ) net_rate = item.base_net_amount if item.sales_incoming_rate: # for internal transfer net_rate = item.qty * item.sales_incoming_rate if ( not net_rate and item.get("rejected_qty") and frappe.get_single_value( "Buying Settings", "set_valuation_rate_for_rejected_materials" ) ): net_rate = item.rejected_qty * item.net_rate qty_in_stock_uom = flt(item.qty * item.conversion_factor) if not qty_in_stock_uom and item.get("rejected_qty"): qty_in_stock_uom = flt(item.rejected_qty * item.conversion_factor) item.valuation_rate = ( net_rate + item.item_tax_amount + flt(item.landed_cost_voucher_amount) + flt(item.get("amount_difference_with_purchase_invoice")) ) / qty_in_stock_uom else: item.valuation_rate = 0.0 update_regional_item_valuation_rate(self) def get_tax_details(self): tax_accounts = [] total_valuation_amount = 0.0 total_actual_tax_amount = 0.0 total_actual_tax_on_stock_items = 0.0 for d in self.get("taxes"): if d.category not in ["Valuation", "Valuation and Total"]: continue amount = flt(d.base_tax_amount_after_discount_amount) * ( -1 if d.get("add_deduct_tax") == "Deduct" else 1 ) if d.charge_type == "On Net Total": total_valuation_amount += amount tax_accounts.append(d.account_head) elif d.charge_type == "Actual" and d.get("allocate_full_amount_to_stock_items"): # Allocate the full amount to stock/asset items only (e.g. Freight) total_actual_tax_on_stock_items += amount else: total_actual_tax_amount += amount return tax_accounts, total_valuation_amount, total_actual_tax_amount, total_actual_tax_on_stock_items def get_item_tax_amount(self, item, tax_accounts): item_tax_amount = 0.0 if item.item_tax_rate: tax_details = json.loads(item.item_tax_rate) for account, rate in tax_details.items(): if account not in tax_accounts: continue if rate == NOT_APPLICABLE_TAX: continue net_rate = item.base_net_amount if item.sales_incoming_rate: net_rate = item.qty * item.sales_incoming_rate item_tax_amount += flt(net_rate) * flt(rate) / 100 return item_tax_amount def distribute_actual_tax_amount(self, stock_and_asset_items, total_on_all_items, total_on_stock_items): """Distribute "Actual" valuation charges to each item, keyed by row idx. `total_on_all_items` is spread across every item by net amount; a non-stock item's share is computed but never capitalized (e.g. a genuine tax). `total_on_stock_items` (flagged `allocate_full_amount_to_stock_items`) is spread across stock/asset items only, so the whole charge is capitalized (e.g. Freight). """ all_items = [d for d in self.get("items") if d.item_code] stock_items = [d for d in all_items if d.item_code in stock_and_asset_items] charge_per_item = {} self._spread_charge_over_items(charge_per_item, total_on_all_items, all_items) self._spread_charge_over_items(charge_per_item, total_on_stock_items, stock_items) return charge_per_item def _spread_charge_over_items(self, charge_per_item, total_charge, items): """Add each item's proportional share of `total_charge` into `charge_per_item`. Proportion is by net amount (falling back to qty); any rounding remainder is assigned to the last item in the group.""" if not total_charge or not items: return total_amount = sum(flt(d.base_net_amount) for d in items) total_qty = sum(flt(d.qty) for d in items) # Nothing to proportion against (all rows have zero amount and zero qty) if not total_amount and not total_qty: return remaining = total_charge for d in items[:-1]: proportion = flt(d.base_net_amount) / total_amount if total_amount else flt(d.qty) / total_qty charge = flt(proportion * total_charge, self.precision("item_tax_amount", d)) charge_per_item[d.idx] = charge_per_item.get(d.idx, 0.0) + charge remaining -= charge last = items[-1] charge_per_item[last.idx] = charge_per_item.get(last.idx, 0.0) + flt( remaining, self.precision("item_tax_amount", last) ) def get_capitalized_valuation_tax(self): stock_and_asset_items = self.get_stock_items() + self.get_asset_items() all_items = [d for d in self.get("items") if d.item_code] stock_item_idx = {d.idx for d in all_items if d.item_code in stock_and_asset_items} capitalized = {} for tax in self.get("taxes"): if tax.category not in ("Valuation", "Valuation and Total"): continue amount = flt(tax.base_tax_amount_after_discount_amount) * ( -1 if tax.get("add_deduct_tax") == "Deduct" else 1 ) if not amount: continue if tax.charge_type == "Actual" and not tax.get("allocate_full_amount_to_stock_items"): # Spread across all items; only the stock/asset items' share is capitalized. charge_per_item = {} self._spread_charge_over_items(charge_per_item, amount, all_items) amount = sum( charge for item_idx, charge in charge_per_item.items() if item_idx in stock_item_idx ) capitalized[tax.name] = amount return capitalized def set_incoming_rate(self): """ Override item rate with incoming rate for internal stock transfer """ if self.doctype not in ("Purchase Receipt", "Purchase Invoice"): return if not (self.doctype == "Purchase Receipt" or self.get("update_stock")): return if cint(self.get("is_return")): # Get outgoing rate based on original item cost based on valuation method return if not self.is_internal_transfer(): return self.set_sales_incoming_rate_for_internal_transfer() allow_at_arms_length_price = frappe.get_cached_value( "Stock Settings", None, "allow_internal_transfer_at_arms_length_price" ) if allow_at_arms_length_price: return for d in self.get("items"): d.discount_percentage = 0.0 d.discount_amount = 0.0 d.margin_rate_or_amount = 0.0 if d.rate == d.sales_incoming_rate: continue d.rate = d.sales_incoming_rate frappe.msgprint( _( "Row #{idx}: Item rate has been updated as per valuation rate since its an internal stock transfer." ).format(idx=d.idx), alert=1, ) def set_sales_incoming_rate_for_internal_transfer(self): """ Set incoming rate from the sales transaction against which the purchase is made (internal transfer) """ ref_doctype_map = { "Purchase Receipt": "Delivery Note Item", "Purchase Invoice": "Sales Invoice Item", } ref_doctype = ref_doctype_map.get(self.doctype) for d in self.get("items"): if not d.get(frappe.scrub(ref_doctype)): posting_time = self.get("posting_time") if not posting_time: posting_time = nowtime() outgoing_rate = get_incoming_rate( { "item_code": d.item_code, "warehouse": d.get("from_warehouse"), "posting_date": self.get("posting_date") or self.get("transaction_date"), "posting_time": posting_time, "qty": -1 * flt(d.get("stock_qty")), "serial_and_batch_bundle": d.get("serial_and_batch_bundle"), "company": self.company, "voucher_type": self.doctype, "voucher_no": self.name, "allow_zero_valuation": d.get("allow_zero_valuation"), "voucher_detail_no": d.name, }, raise_error_if_no_rate=False, ) d.sales_incoming_rate = flt(outgoing_rate * (d.conversion_factor or 1)) else: field = "incoming_rate" if self.get("is_internal_supplier") else "rate" d.sales_incoming_rate = flt( frappe.db.get_value(ref_doctype, d.get(frappe.scrub(ref_doctype)), field) * (d.conversion_factor or 1) ) def set_qty_as_per_stock_uom(self): allow_to_edit_stock_qty = frappe.get_single_value( "Stock Settings", "allow_to_edit_stock_uom_qty_for_purchase" ) for d in self.get("items"): if d.meta.get_field("stock_qty"): # Check if item code is present # Conversion factor should not be mandatory for non itemized items if not d.conversion_factor and d.item_code: frappe.throw( _("Row #{idx}: {field_label} is mandatory.").format( idx=d.idx, field_label=_(d.meta.get_label("conversion_factor")), ) ) d.stock_qty = flt(d.qty) * flt(d.conversion_factor) if self.doctype == "Purchase Receipt" and d.meta.get_field("received_stock_qty"): # Set Received Qty in Stock UOM d.received_stock_qty = flt(d.received_qty) * flt( d.conversion_factor, d.precision("conversion_factor") ) if allow_to_edit_stock_qty: d.stock_qty = flt(d.stock_qty, d.precision("stock_qty")) if d.get("received_stock_qty") and d.meta.get_field("received_stock_qty"): d.received_stock_qty = flt(d.received_stock_qty, d.precision("received_stock_qty")) def validate_purchase_return(self): for d in self.get("items"): if self.is_return and not flt(d.rejected_qty) and d.rejected_warehouse: d.rejected_warehouse = None # validate accepted and rejected qty def validate_accepted_rejected_qty(self): for d in self.get("items"): self.validate_negative_quantity(d, ["received_qty", "qty", "rejected_qty"]) if not flt(d.received_qty) and (flt(d.qty) or flt(d.rejected_qty)): d.received_qty = flt(d.qty) + flt(d.rejected_qty) # Check Received Qty = Accepted Qty + Rejected Qty val = flt(d.qty) + flt(d.rejected_qty) if flt(val, d.precision("received_qty")) != flt(d.received_qty, d.precision("received_qty")): message = _( "Row #{idx}: Received Qty must be equal to Accepted + Rejected Qty for Item {item_code}." ).format(idx=d.idx, item_code=frappe.bold(d.item_code)) frappe.throw(msg=message, title=_("Mismatch"), exc=QtyMismatchError) def validate_negative_quantity(self, item_row, field_list): if self.is_return: return item_row = item_row.as_dict() for fieldname in field_list: if flt(item_row[fieldname]) < 0: frappe.throw( _("Row #{idx}: {field_label} can not be negative for item {item_code}.").format( idx=item_row["idx"], field_label=_(frappe.get_meta(item_row.doctype).get_label(fieldname)), item_code=frappe.bold(item_row["item_code"]), ) ) def update_stock_ledger(self, allow_negative_stock=False, via_landed_cost_voucher=False): self.update_ordered_and_reserved_qty() sl_entries = [] stock_items = self.get_stock_items() for d in self.get("items"): if d.item_code not in stock_items: continue if d.warehouse: pr_qty = flt(flt(d.qty) * flt(d.conversion_factor), d.precision("stock_qty")) if pr_qty: if d.from_warehouse and ( (not cint(self.is_return) and self.docstatus == 1) or (cint(self.is_return) and self.docstatus == 2) ): serial_and_batch_bundle = d.get("serial_and_batch_bundle") if self.is_internal_transfer() and self.is_return and self.docstatus == 2: serial_and_batch_bundle = frappe.db.get_value( "Stock Ledger Entry", {"voucher_detail_no": d.name, "warehouse": d.from_warehouse}, "serial_and_batch_bundle", ) from_warehouse_sle = self.get_sl_entries( d, { "actual_qty": -1 * pr_qty, "warehouse": d.from_warehouse, "outgoing_rate": d.rate, "recalculate_rate": 1, "dependant_sle_voucher_detail_no": d.name, "serial_and_batch_bundle": serial_and_batch_bundle, }, ) sl_entries.append(from_warehouse_sle) type_of_transaction = "Inward" if self.docstatus == 2: type_of_transaction = "Outward" sle = self.get_sl_entries( d, { "actual_qty": flt(pr_qty), "serial_and_batch_bundle": ( d.serial_and_batch_bundle if not self.is_internal_transfer() or self.is_return or (self.is_internal_transfer() and self.docstatus == 2) else self.get_package_for_target_warehouse( d, type_of_transaction=type_of_transaction, via_landed_cost_voucher=via_landed_cost_voucher, ) ), }, ) if self.is_return: outgoing_rate = get_rate_for_return( self.doctype, self.name, d.item_code, self.return_against, item_row=d ) sle.update( { "outgoing_rate": outgoing_rate, "recalculate_rate": 1, "serial_and_batch_bundle": d.serial_and_batch_bundle, } ) if d.from_warehouse: sle.dependant_sle_voucher_detail_no = d.name else: sle.update( { "incoming_rate": d.valuation_rate, "recalculate_rate": 1 if (self.is_subcontracted and (d.bom or d.get("fg_item"))) or d.from_warehouse else 0, } ) sl_entries.append(sle) if d.from_warehouse and ( (not cint(self.is_return) and self.docstatus == 2) or (cint(self.is_return) and self.docstatus == 1) ): serial_and_batch_bundle = None if self.is_internal_transfer() and self.docstatus == 2: serial_and_batch_bundle = frappe.db.get_value( "Stock Ledger Entry", {"voucher_detail_no": d.name, "warehouse": d.warehouse}, "serial_and_batch_bundle", ) from_warehouse_sle = self.get_sl_entries( d, { "actual_qty": -1 * pr_qty, "warehouse": d.from_warehouse, "recalculate_rate": 1, "serial_and_batch_bundle": ( self.get_package_for_target_warehouse(d, d.from_warehouse, "Inward") if self.is_internal_transfer() and self.is_return else serial_and_batch_bundle ), }, ) sl_entries.append(from_warehouse_sle) if flt(d.rejected_qty) != 0: valuation_rate_for_rejected_item = 0.0 if frappe.db.get_single_value("Buying Settings", "set_valuation_rate_for_rejected_materials"): valuation_rate_for_rejected_item = d.valuation_rate sl_entries.append( self.get_sl_entries( d, { "warehouse": d.rejected_warehouse, "actual_qty": flt( flt(d.rejected_qty) * flt(d.conversion_factor), d.precision("stock_qty") ), "incoming_rate": valuation_rate_for_rejected_item if not self.is_return else 0.0, "outgoing_rate": valuation_rate_for_rejected_item if self.is_return else 0.0, "serial_and_batch_bundle": d.rejected_serial_and_batch_bundle, }, ) ) self.make_sl_entries( sl_entries, allow_negative_stock=allow_negative_stock, via_landed_cost_voucher=via_landed_cost_voucher, ) def get_package_for_target_warehouse( self, item, warehouse=None, type_of_transaction=None, via_landed_cost_voucher=None ) -> str: if via_landed_cost_voucher and item.get("warehouse"): if sabb := frappe.db.get_value( "Serial and Batch Bundle", { "voucher_detail_no": item.name, "warehouse": item.get("warehouse"), "docstatus": 1, "is_cancelled": 0, }, "name", ): return sabb if not item.serial_and_batch_bundle: return "" if not warehouse: warehouse = item.warehouse return self.make_package_for_transfer( item.serial_and_batch_bundle, warehouse, type_of_transaction=type_of_transaction ) def update_ordered_and_reserved_qty(self): po_map = {} for d in self.get("items"): if self.doctype == "Purchase Receipt" and d.purchase_order: po_map.setdefault(d.purchase_order, []).append(d.purchase_order_item) elif self.doctype == "Purchase Invoice" and d.purchase_order and d.po_detail: po_map.setdefault(d.purchase_order, []).append(d.po_detail) for po, po_item_rows in po_map.items(): if po and po_item_rows: po_obj = frappe.get_lazy_doc("Purchase Order", po) if po_obj.status in ["Closed", "Cancelled"]: frappe.throw( _("{doctype} {name} is cancelled or closed.").format( doctype=frappe.bold(_("Purchase Order")), name=frappe.bold(po), ), frappe.InvalidStatusError, ) po_obj.update_ordered_qty(po_item_rows) def on_submit(self): if self.get("is_return"): return if self.doctype in ["Purchase Receipt", "Purchase Invoice"]: self.process_fixed_asset() if self.doctype in [ "Purchase Order", "Purchase Receipt", "Purchase Invoice", ] and not frappe.db.get_single_value("Buying Settings", "disable_last_purchase_rate"): update_last_purchase_rate(self, is_submit=1) def on_cancel(self): super().on_cancel() if self.get("is_return"): return if self.doctype in [ "Purchase Order", "Purchase Receipt", "Purchase Invoice", ] and not frappe.db.get_single_value("Buying Settings", "disable_last_purchase_rate"): update_last_purchase_rate(self, is_submit=0) if self.doctype in ["Purchase Receipt", "Purchase Invoice"]: field = "purchase_invoice" if self.doctype == "Purchase Invoice" else "purchase_receipt" self.delete_linked_asset() self.update_fixed_asset(field, delete_asset=True) def validate_budget(self): if not frappe.get_single_value("Accounts Settings", "use_legacy_budget_controller"): from erpnext.controllers.budget_controller import BudgetValidation val = BudgetValidation(doc=self) val.validate() else: if self.docstatus == 1: for data in self.get("items"): args = data.as_dict() args.update( { "doctype": self.doctype, "company": self.company, "posting_date": ( self.schedule_date if self.doctype == "Material Request" else self.transaction_date ), } ) validate_expense_against_budget(args) def process_fixed_asset(self): if self.doctype == "Purchase Invoice" and not self.update_stock: return asset_items = self.get_asset_items() if asset_items: self.auto_make_assets(asset_items) def auto_make_assets(self, asset_items): items_data = get_asset_item_details(asset_items) messages = [] alert = False accounting_dimensions = get_dimensions(with_cost_center_and_project=True) for d in self.items: if d.is_fixed_asset: item_data = items_data.get(d.item_code) if item_data.get("auto_create_assets"): # If asset has to be auto created # Check for asset naming series if item_data.get("asset_naming_series"): created_assets = [] if item_data.get("is_grouped_asset"): asset = self.make_asset(d, accounting_dimensions, is_grouped_asset=True) created_assets.append(asset) else: for _qty in range(cint(d.qty)): asset = self.make_asset(d, accounting_dimensions) created_assets.append(asset) if len(created_assets) > 5: # dont show asset form links if more than 5 assets are created messages.append( _("{count} Assets created for {item_code}").format( count=len(created_assets), item_code=frappe.bold(d.item_code) ) ) else: assets_link = list( map(lambda d: frappe.utils.get_link_to_form("Asset", d), created_assets) ) assets_link = frappe.bold(",".join(assets_link)) if len(created_assets) == 1: msg = _("Asset {assets_link} created for {item_code}").format( assets_link=assets_link, item_code=frappe.bold(d.item_code), ) else: msg = _("Assets {assets_link} created for {item_code}").format( assets_link=assets_link, item_code=frappe.bold(d.item_code), ) messages.append(msg) else: frappe.throw( _( "Row {idx}: Asset Naming Series is mandatory for the auto creation of assets for item {item_code}." ).format(idx=d.idx, item_code=frappe.bold(d.item_code)) ) else: messages.append( _( "Assets not created for {item_code}. You will have to create asset manually." ).format(item_code=frappe.bold(d.item_code)) ) alert = True for message in messages: frappe.msgprint(message, title="Success", indicator="green", alert=alert) def make_asset(self, row, accounting_dimensions, is_grouped_asset=False): if not row.asset_location: frappe.throw( _("Row #{idx}: Please enter a location for the asset item {item_code}.").format( idx=row.idx, item_code=frappe.bold(row.item_code), ) ) item_data = frappe.get_cached_value( "Item", row.item_code, ["asset_naming_series", "asset_category"], as_dict=1 ) asset_quantity = row.qty if is_grouped_asset else 1 purchase_amount = flt(row.valuation_rate) * asset_quantity asset = frappe.get_doc( { "doctype": "Asset", "item_code": row.item_code, "asset_name": row.item_name, "naming_series": item_data.get("asset_naming_series") or "AST", "asset_category": item_data.get("asset_category"), "location": row.asset_location, "company": self.company, "status": "Draft", "supplier": self.supplier, "purchase_date": self.posting_date, "calculate_depreciation": 0, "purchase_amount": purchase_amount, "net_purchase_amount": purchase_amount, "asset_quantity": asset_quantity, "purchase_receipt": self.name if self.doctype == "Purchase Receipt" else None, "purchase_invoice": self.name if self.doctype == "Purchase Invoice" else None, "purchase_receipt_item": row.name if self.doctype == "Purchase Receipt" else None, "purchase_invoice_item": row.name if self.doctype == "Purchase Invoice" else None, } ) for dimension in accounting_dimensions[0]: fieldname = dimension["fieldname"] default_dimension = accounting_dimensions[1].get(self.company, {}).get(fieldname) if not asset.get(fieldname): asset.update({fieldname: row.get(fieldname) or self.get(fieldname) or default_dimension}) asset.flags.ignore_validate = True asset.flags.ignore_mandatory = True asset.set_missing_values() asset.db_insert() return asset.name def update_fixed_asset(self, field, delete_asset=False): for d in self.get("items"): if d.is_fixed_asset: is_auto_create_enabled = frappe.db.get_value("Item", d.item_code, "auto_create_assets") assets = frappe.db.get_all("Asset", filters={field: self.name, "item_code": d.item_code}) for asset in assets: asset = frappe.get_doc("Asset", asset.name) if delete_asset and is_auto_create_enabled: # need to delete movements to delete assets otherwise throws link exists error movements = frappe.get_all( "Asset Movement Item", filters={"asset": asset.name}, pluck="parent", limit_page_length=0, # delete every movement of the asset (no default 20 cap) ) for movement in movements: frappe.delete_doc("Asset Movement", movement, force=1) frappe.delete_doc("Asset", asset.name, force=1) continue if self.docstatus == 2: if asset.docstatus == 2: continue if asset.docstatus == 0: asset.set(field, None) asset.supplier = None if asset.docstatus == 1 and delete_asset: frappe.throw( _( "Cannot cancel this document as it is linked with the submitted asset {asset_link}. Please cancel the asset to continue." ).format(asset_link=frappe.utils.get_link_to_form("Asset", asset.name)) ) asset.flags.ignore_validate_update_after_submit = True asset.flags.ignore_mandatory = True if asset.docstatus == 0: asset.flags.ignore_validate = True asset.save() def delete_linked_asset(self): if self.doctype == "Purchase Invoice" and not self.get("update_stock"): return asset_movement = frappe.db.get_value("Asset Movement", {"reference_name": self.name}, "name") frappe.delete_doc("Asset Movement", asset_movement, force=1) def validate_schedule_date(self): if not self.get("items"): return if any(d.schedule_date for d in self.get("items")): # Select earliest schedule_date. self.schedule_date = min( d.schedule_date for d in self.get("items") if d.schedule_date is not None ) if self.schedule_date: for d in self.get("items"): if not d.schedule_date: d.schedule_date = self.schedule_date if ( d.schedule_date and self.transaction_date and getdate(d.schedule_date) < getdate(self.transaction_date) ): frappe.throw( _("Row #{idx}: {schedule_date} cannot be before {transaction_date}.").format( idx=d.idx, schedule_date=_(self.meta.get_label("schedule_date")), transaction_date=_(self.meta.get_label("transaction_date")), ) ) else: frappe.throw( _("Please enter the {schedule_date}.").format( schedule_date=_(self.meta.get_label("schedule_date")) ) ) def validate_items(self): # validate items to see if they have is_purchase_item or is_subcontracted_item enabled if self.doctype == "Material Request": return validate_item_type(self, "is_purchase_item", "purchase") def get_asset_item_details(asset_items): asset_items_data = {} for d in frappe.get_all( "Item", fields=["name", "auto_create_assets", "asset_naming_series", "is_grouped_asset"], filters={"name": ("in", asset_items)}, ): asset_items_data.setdefault(d.name, d) return asset_items_data def validate_item_type(doc, fieldname, message): # iterate through items and check if they are valid sales or purchase items items = [d.item_code for d in doc.items if d.item_code] # No validation check inase of creating transaction using 'Opening Invoice Creation Tool' if not items: return invalid_items = frappe.get_all( "Item", filters={"name": ["in", items], fieldname: 0}, pluck="item_code", limit_page_length=0, # validate every item in the document (no default 20 cap) ) if invalid_items: items = ", ".join([d for d in invalid_items]) if len(invalid_items) > 1: error_message = _( "The items {items} are not marked as {type_of} item. You can enable them as {type_of} item from their Item masters." ).format( items=items, type_of=message, ) else: error_message = _( "The item {item} is not marked as {type_of} item. You can enable it as {type_of} item from its Item master." ).format( item=items, type_of=message, ) frappe.throw(error_message) @erpnext.allow_regional def update_regional_item_valuation_rate(doc): pass @frappe.request_cache def get_purchase_expense_account(item_code, company): defaults = get_item_defaults(item_code, company) details = frappe._dict( { "purchase_expense_account": defaults.get("purchase_expense_account"), "purchase_expense_contra_account": defaults.get("purchase_expense_contra_account"), } ) if not details.purchase_expense_account: details = frappe.db.get_value( "Item Default", {"parent": defaults.item_group, "company": company}, ["purchase_expense_account", "purchase_expense_contra_account"], as_dict=1, ) or frappe._dict({}) if not details.purchase_expense_account: details = frappe.db.get_value( "Item Default", {"parent": defaults.brand, "company": company}, ["purchase_expense_account", "purchase_expense_contra_account"], as_dict=1, ) return details or frappe._dict({})