brotherton-erpnext/erpnext/stock/get_item_details.py

1529 lines
47 KiB
Python
Raw Normal View History

# Copyright (c) 2015, Frappe Technologies Pvt. Ltd. and Contributors
# License: GNU General Public License v3. See license.txt
import json
2014-02-14 10:17:51 +00:00
import frappe
from frappe import _, throw
from frappe.model import child_table_fields, default_fields
2014-09-29 06:47:03 +00:00
from frappe.model.meta import get_field_precision
from frappe.utils import add_days, add_months, cint, cstr, flt, getdate
from erpnext import get_company_currency
from erpnext.accounts.doctype.pricing_rule.pricing_rule import (
get_pricing_rule_for_item,
set_transaction_type,
)
from erpnext.setup.doctype.brand.brand import get_brand_defaults
from erpnext.setup.doctype.item_group.item_group import get_item_group_defaults
from erpnext.setup.utils import get_exchange_rate
from erpnext.stock.doctype.batch.batch import get_batch_no
from erpnext.stock.doctype.item.item import get_item_defaults, get_uom_conv_factor
from erpnext.stock.doctype.item_manufacturer.item_manufacturer import get_item_manufacturer_part_no
from erpnext.stock.doctype.price_list.price_list import get_price_list_details
2022-03-28 13:22:46 +00:00
sales_doctypes = ["Quotation", "Sales Order", "Delivery Note", "Sales Invoice", "POS Invoice"]
purchase_doctypes = [
"Material Request",
"Supplier Quotation",
"Purchase Order",
"Purchase Receipt",
"Purchase Invoice",
]
2019-02-14 13:00:10 +00:00
2014-02-14 10:17:51 +00:00
@frappe.whitelist()
def get_item_details(args, doc=None, for_validate=False, overwrite_warehouse=True):
"""
2022-03-28 13:22:46 +00:00
args = {
"item_code": "",
"warehouse": None,
"customer": "",
"conversion_rate": 1.0,
"selling_price_list": None,
"price_list_currency": None,
"plc_conversion_rate": 1.0,
"doctype": "",
"name": "",
"supplier": None,
"transaction_date": None,
"conversion_rate": 1.0,
"buying_price_list": None,
"is_subcontracted": 0/1,
2022-03-28 13:22:46 +00:00
"ignore_pricing_rule": 0/1
"project": ""
"set_warehouse": ""
}
"""
2014-07-01 12:15:15 +00:00
args = process_args(args)
for_validate = process_string_args(for_validate)
overwrite_warehouse = process_string_args(overwrite_warehouse)
2018-08-08 11:07:31 +00:00
item = frappe.get_cached_doc("Item", args.item_code)
validate_item_details(args, item)
2021-11-04 14:18:32 +00:00
if isinstance(doc, str):
doc = json.loads(doc)
if doc:
args["transaction_date"] = doc.get("transaction_date") or doc.get("posting_date")
if doc.get("doctype") == "Purchase Invoice":
args["bill_date"] = doc.get("bill_date")
out = get_basic_details(args, item, overwrite_warehouse)
get_item_tax_template(args, item, out)
2022-03-28 13:22:46 +00:00
out["item_tax_rate"] = get_item_tax_map(
args.company,
args.get("item_tax_template")
if out.get("item_tax_template") is None
else out.get("item_tax_template"),
as_json=True,
)
2018-08-08 11:07:31 +00:00
get_party_item_code(args, item, out)
2016-04-22 11:52:22 +00:00
2018-08-08 11:07:31 +00:00
set_valuation_rate(out, args)
update_party_blanket_order(args, out)
out.update(get_price_list_rate(args, item))
if args.customer and cint(args.is_pos):
out.update(get_pos_profile_item_details(args.company, args, update_data=True))
2022-03-28 13:22:46 +00:00
if (
args.get("doctype") == "Material Request"
and args.get("material_request_type") == "Material Transfer"
):
out.update(get_bin_details(args.item_code, args.get("from_warehouse")))
elif out.get("warehouse"):
2022-03-28 13:22:46 +00:00
if doc and doc.get("doctype") == "Purchase Order":
# calculate company_total_stock only for po
bin_details = get_bin_details(
args.item_code, out.warehouse, args.company, include_child_warehouses=True
)
else:
bin_details = get_bin_details(args.item_code, out.warehouse, include_child_warehouses=True)
out.update(bin_details)
2014-05-28 07:19:20 +00:00
# update args with out, if key or value not exists
2021-11-04 14:18:32 +00:00
for key, value in out.items():
2014-05-28 07:19:20 +00:00
if args.get(key) is None:
args[key] = value
2022-12-08 12:34:40 +00:00
data = get_pricing_rule_for_item(args, doc=doc, for_validate=for_validate)
2019-03-18 09:04:19 +00:00
out.update(data)
2018-08-08 11:07:31 +00:00
update_stock(args, out)
if args.transaction_date and item.lead_time_days:
2022-03-28 13:22:46 +00:00
out.schedule_date = out.lead_time_date = add_days(args.transaction_date, item.lead_time_days)
2018-08-08 11:07:31 +00:00
if args.get("is_subcontracted"):
2022-03-28 13:22:46 +00:00
out.bom = args.get("bom") or get_default_bom(args.item_code)
2018-08-08 11:07:31 +00:00
get_gross_profit(out)
2022-03-28 13:22:46 +00:00
if args.doctype == "Material Request":
2018-08-08 11:07:31 +00:00
out.rate = args.rate or out.price_list_rate
out.amount = flt(args.qty) * flt(out.rate)
2018-08-08 11:07:31 +00:00
out = remove_standard_fields(out)
2018-08-08 11:07:31 +00:00
return out
2022-03-28 13:22:46 +00:00
def remove_standard_fields(details):
for key in child_table_fields + default_fields:
details.pop(key, None)
return details
2018-08-08 11:07:31 +00:00
def update_stock(args, out):
2022-03-28 13:22:46 +00:00
if (
(
args.get("doctype") == "Delivery Note"
or (args.get("doctype") == "Sales Invoice" and args.get("update_stock"))
)
and out.warehouse
and out.stock_qty > 0
):
2017-06-23 06:09:03 +00:00
if out.has_batch_no and not args.get("batch_no"):
out.batch_no = get_batch_no(out.item_code, out.warehouse, out.qty)
actual_batch_qty = get_batch_qty(out.batch_no, out.warehouse, out.item_code)
if actual_batch_qty:
out.update(actual_batch_qty)
2018-04-27 10:54:05 +00:00
2022-03-28 13:22:46 +00:00
if out.has_serial_no and args.get("batch_no"):
reserved_so = get_so_reservation_for_item(args)
2022-03-28 13:22:46 +00:00
out.batch_no = args.get("batch_no")
out.serial_no = get_serial_no(out, args.serial_no, sales_order=reserved_so)
2018-04-27 10:54:05 +00:00
elif out.has_serial_no:
reserved_so = get_so_reservation_for_item(args)
out.serial_no = get_serial_no(out, args.serial_no, sales_order=reserved_so)
if not out.serial_no:
out.pop("serial_no", None)
2018-08-08 11:07:31 +00:00
def set_valuation_rate(out, args):
if frappe.db.exists("Product Bundle", args.item_code, cache=True):
2018-08-08 11:07:31 +00:00
valuation_rate = 0.0
bundled_items = frappe.get_doc("Product Bundle", args.item_code)
2016-04-22 11:52:22 +00:00
2018-08-08 11:07:31 +00:00
for bundle_item in bundled_items.items:
2022-03-28 13:22:46 +00:00
valuation_rate += flt(
get_valuation_rate(bundle_item.item_code, args.company, out.get("warehouse")).get(
"valuation_rate"
)
* bundle_item.qty
)
2018-08-08 11:07:31 +00:00
2022-03-28 13:22:46 +00:00
out.update({"valuation_rate": valuation_rate})
2018-08-08 11:07:31 +00:00
else:
out.update(get_valuation_rate(args.item_code, args.company, out.get("warehouse")))
2014-07-01 12:15:15 +00:00
def process_args(args):
2021-11-04 14:18:32 +00:00
if isinstance(args, str):
2014-07-01 12:15:15 +00:00
args = json.loads(args)
args = frappe._dict(args)
if not args.get("price_list"):
args.price_list = args.get("selling_price_list") or args.get("buying_price_list")
if not args.item_code and args.barcode:
2014-07-01 12:15:15 +00:00
args.item_code = get_item_code(barcode=args.barcode)
elif not args.item_code and args.serial_no:
args.item_code = get_item_code(serial_no=args.serial_no)
2016-04-22 11:52:22 +00:00
2016-01-21 10:40:22 +00:00
set_transaction_type(args)
2014-07-01 12:15:15 +00:00
return args
2022-03-28 13:22:46 +00:00
def process_string_args(args):
2021-11-04 14:18:32 +00:00
if isinstance(args, str):
args = json.loads(args)
return args
2022-03-28 13:22:46 +00:00
2015-02-25 12:04:27 +00:00
@frappe.whitelist()
def get_item_code(barcode=None, serial_no=None):
if barcode:
item_code = frappe.db.get_value("Item Barcode", {"barcode": barcode}, fieldname=["parent"])
2014-04-16 11:51:25 +00:00
if not item_code:
frappe.throw(_("No Item with Barcode {0}").format(barcode))
elif serial_no:
2014-02-26 07:05:33 +00:00
item_code = frappe.db.get_value("Serial No", serial_no, "item_code")
2014-04-16 11:51:25 +00:00
if not item_code:
frappe.throw(_("No Item with Serial No {0}").format(serial_no))
return item_code
def validate_item_details(args, item):
if not args.company:
throw(_("Please specify Company"))
from erpnext.stock.doctype.item.item import validate_end_of_life
2022-03-28 13:22:46 +00:00
validate_end_of_life(item.name, item.end_of_life, item.disabled)
if args.transaction_type == "selling" and cint(item.has_variants):
throw(_("Item {0} is a template, please select one of its variants").format(item.name))
2016-04-22 11:52:22 +00:00
elif args.transaction_type == "buying" and args.doctype != "Material Request":
if args.get("is_subcontracted"):
if args.get("is_old_subcontracting_flow"):
if item.is_sub_contracted_item != 1:
throw(_("Item {0} must be a Sub-contracted Item").format(item.name))
else:
if item.is_stock_item:
throw(_("Item {0} must be a Non-Stock Item").format(item.name))
def get_basic_details(args, item, overwrite_warehouse=True):
"""
:param args: {
2022-03-28 13:22:46 +00:00
"item_code": "",
"warehouse": None,
"customer": "",
"conversion_rate": 1.0,
"selling_price_list": None,
"price_list_currency": None,
"price_list_uom_dependant": None,
"plc_conversion_rate": 1.0,
"doctype": "",
"name": "",
"supplier": None,
"transaction_date": None,
"conversion_rate": 1.0,
"buying_price_list": None,
"is_subcontracted": 0/1,
2022-03-28 13:22:46 +00:00
"ignore_pricing_rule": 0/1
"project": "",
barcode: "",
serial_no: "",
currency: "",
update_stock: "",
price_list: "",
company: "",
order_type: "",
is_pos: "",
project: "",
qty: "",
stock_qty: "",
conversion_factor: "",
against_blanket_order: 0/1
}
:param item: `item_code` of Item object
:return: frappe._dict
"""
if not item:
item = frappe.get_doc("Item", args.get("item_code"))
if item.variant_of:
item.update_template_tables()
2018-05-04 11:19:33 +00:00
item_defaults = get_item_defaults(item.name, args.company)
item_group_defaults = get_item_group_defaults(item.name, args.company)
brand_defaults = get_brand_defaults(item.name, args.company)
2022-03-28 13:22:46 +00:00
defaults = frappe._dict(
{
"item_defaults": item_defaults,
"item_group_defaults": item_group_defaults,
"brand_defaults": brand_defaults,
}
)
2020-04-06 16:43:13 +00:00
warehouse = get_item_warehouse(item, args, overwrite_warehouse, defaults)
2014-02-12 13:39:28 +00:00
2022-03-28 13:22:46 +00:00
if args.get("doctype") == "Material Request" and not args.get("material_request_type"):
args["material_request_type"] = frappe.db.get_value(
"Material Request", args.get("name"), "material_request_type", cache=True
)
expense_account = None
2022-03-28 13:22:46 +00:00
if args.get("doctype") == "Purchase Invoice" and item.is_fixed_asset:
from erpnext.assets.doctype.asset_category.asset_category import get_asset_category_account
2022-03-28 13:22:46 +00:00
expense_account = get_asset_category_account(
fieldname="fixed_asset_account", item=args.item_code, company=args.company
)
# Set the UOM to the Default Sales UOM or Default Purchase UOM if configured in the Item Master
if not args.get("uom"):
if args.get("doctype") in sales_doctypes:
2017-09-29 12:44:10 +00:00
args.uom = item.sales_uom if item.sales_uom else item.stock_uom
2022-03-28 13:22:46 +00:00
elif (args.get("doctype") in ["Purchase Order", "Purchase Receipt", "Purchase Invoice"]) or (
args.get("doctype") == "Material Request" and args.get("material_request_type") == "Purchase"
):
2017-09-29 12:44:10 +00:00
args.uom = item.purchase_uom if item.purchase_uom else item.stock_uom
else:
args.uom = item.stock_uom
# Set stock UOM in args, so that it can be used while fetching item price
args.stock_uom = item.stock_uom
2022-03-28 13:22:46 +00:00
if args.get("batch_no") and item.name != frappe.get_cached_value(
"Batch", args.get("batch_no"), "item"
):
args["batch_no"] = ""
out = frappe._dict(
{
"item_code": item.name,
"item_name": item.item_name,
"description": cstr(item.description).strip(),
"image": cstr(item.image).strip(),
"warehouse": warehouse,
"income_account": get_default_income_account(
args, item_defaults, item_group_defaults, brand_defaults
),
"expense_account": expense_account
or get_default_expense_account(args, item_defaults, item_group_defaults, brand_defaults),
"discount_account": get_default_discount_account(args, item_defaults),
"provisional_expense_account": get_provisional_account(args, item_defaults),
2022-03-28 13:22:46 +00:00
"cost_center": get_default_cost_center(
args, item_defaults, item_group_defaults, brand_defaults
),
"has_serial_no": item.has_serial_no,
"has_batch_no": item.has_batch_no,
"batch_no": args.get("batch_no"),
"uom": args.uom,
"stock_uom": item.stock_uom,
2022-03-28 13:22:46 +00:00
"min_order_qty": flt(item.min_order_qty) if args.doctype == "Material Request" else "",
"qty": flt(args.qty) or 1.0,
"stock_qty": flt(args.qty) or 1.0,
"price_list_rate": 0.0,
"base_price_list_rate": 0.0,
"rate": 0.0,
"base_rate": 0.0,
"amount": 0.0,
"base_amount": 0.0,
"net_rate": 0.0,
"net_amount": 0.0,
"discount_percentage": 0.0,
"discount_amount": flt(args.discount_amount) or 0.0,
2022-03-28 13:22:46 +00:00
"supplier": get_default_supplier(args, item_defaults, item_group_defaults, brand_defaults),
"update_stock": args.get("update_stock")
if args.get("doctype") in ["Sales Invoice", "Purchase Invoice"]
else 0,
"delivered_by_supplier": item.delivered_by_supplier
if args.get("doctype") in ["Sales Order", "Sales Invoice"]
else 0,
"is_fixed_asset": item.is_fixed_asset,
"last_purchase_rate": item.last_purchase_rate
if args.get("doctype") in ["Purchase Order"]
else 0,
"transaction_date": args.get("transaction_date"),
"against_blanket_order": args.get("against_blanket_order"),
"bom_no": item.get("default_bom"),
"weight_per_unit": args.get("weight_per_unit") or item.get("weight_per_unit"),
"weight_uom": args.get("weight_uom") or item.get("weight_uom"),
"grant_commission": item.get("grant_commission"),
}
)
2019-01-15 08:46:32 +00:00
if item.get("enable_deferred_revenue") or item.get("enable_deferred_expense"):
out.update(calculate_service_end_date(args, item))
# calculate conversion factor
if item.stock_uom == args.uom:
out.conversion_factor = 1.0
else:
2022-03-28 13:22:46 +00:00
out.conversion_factor = args.conversion_factor or get_conversion_factor(item.name, args.uom).get(
"conversion_factor"
)
args.conversion_factor = out.conversion_factor
out.stock_qty = out.qty * out.conversion_factor
args.stock_qty = out.stock_qty
# calculate last purchase rate
2022-03-28 13:22:46 +00:00
if args.get("doctype") in purchase_doctypes:
2019-02-14 13:00:10 +00:00
from erpnext.buying.doctype.purchase_order.purchase_order import item_last_purchase_rate
2022-03-28 13:22:46 +00:00
out.last_purchase_rate = item_last_purchase_rate(
args.name, args.conversion_rate, item.name, out.conversion_factor
)
# if default specified in item is for another company, fetch from company
for d in [
["Account", "income_account", "default_income_account"],
2016-04-22 11:52:22 +00:00
["Account", "expense_account", "default_expense_account"],
["Cost Center", "cost_center", "cost_center"],
2022-03-28 13:22:46 +00:00
["Warehouse", "warehouse", ""],
]:
if not out[d[1]]:
out[d[1]] = frappe.get_cached_value("Company", args.company, d[2]) if d[2] else None
for fieldname in ("item_name", "item_group", "brand", "stock_uom"):
out[fieldname] = item.get(fieldname)
if args.get("manufacturer"):
part_no = get_item_manufacturer_part_no(args.get("item_code"), args.get("manufacturer"))
if part_no:
out["manufacturer_part_no"] = part_no
else:
out["manufacturer_part_no"] = None
out["manufacturer"] = None
else:
2022-03-28 13:22:46 +00:00
data = frappe.get_value(
"Item", item.name, ["default_item_manufacturer", "default_manufacturer_part_no"], as_dict=1
)
if data:
2022-03-28 13:22:46 +00:00
out.update(
{
"manufacturer": data.default_item_manufacturer,
"manufacturer_part_no": data.default_manufacturer_part_no,
}
)
child_doctype = args.doctype + " Item"
meta = frappe.get_meta(child_doctype)
if meta.get_field("barcode"):
update_barcode_value(out)
if out.get("weight_per_unit"):
2022-03-28 13:22:46 +00:00
out["total_weight"] = out.weight_per_unit * out.stock_qty
return out
2022-03-28 13:22:46 +00:00
def get_item_warehouse(item, args, overwrite_warehouse, defaults=None):
if not defaults:
2022-03-28 13:22:46 +00:00
defaults = frappe._dict(
{
"item_defaults": get_item_defaults(item.name, args.company),
"item_group_defaults": get_item_group_defaults(item.name, args.company),
"brand_defaults": get_brand_defaults(item.name, args.company),
}
)
if overwrite_warehouse or not args.warehouse:
warehouse = (
2022-03-28 13:22:46 +00:00
args.get("set_warehouse")
or defaults.item_defaults.get("default_warehouse")
or defaults.item_group_defaults.get("default_warehouse")
or defaults.brand_defaults.get("default_warehouse")
or args.get("warehouse")
)
if not warehouse:
defaults = frappe.defaults.get_defaults() or {}
2022-03-28 13:22:46 +00:00
warehouse_exists = frappe.db.exists(
"Warehouse", {"name": defaults.default_warehouse, "company": args.company}
)
if defaults.get("default_warehouse") and warehouse_exists:
warehouse = defaults.default_warehouse
else:
2022-03-28 13:22:46 +00:00
warehouse = args.get("warehouse")
2020-04-06 16:43:13 +00:00
if not warehouse:
default_warehouse = frappe.db.get_single_value("Stock Settings", "default_warehouse")
if frappe.db.get_value("Warehouse", default_warehouse, "company") == args.company:
return default_warehouse
return warehouse
2022-03-28 13:22:46 +00:00
def update_barcode_value(out):
barcode_data = get_barcode_data([out])
# If item has one barcode then update the value of the barcode field
if barcode_data and len(barcode_data.get(out.item_code)) == 1:
2022-03-28 13:22:46 +00:00
out["barcode"] = barcode_data.get(out.item_code)[0]
refactor: POS workflow (#20789) * refactor: add pos invoice doctype replacing sales invoice in POS * refactor: move pos.py to pos invoice * feat: add pos invoice merge log doctype * feat: ability to merge pos invoices into a sales invoice * feat: [wip] new ui for point of sale * fix: pos.py moved to pos_invoice * feat: loyalty points for POS Invoice * fix: loyalty points on merging * feat: return against pos invoices * Merge 'fork/serial-no-selector' into refactor-pos-invoice * chore: status fix and set warehouse from pos profile * fix: naming series * feat: merge pos returns into credit notes * feat: add pos list action for merging into sales invoices * feat[UX]: add shortcuts & focus on search after customer selection * feat: stock validation from previous pos transactions * Merge 'fork/serial-no-selector' into refactor-pos-invoice * chore: fix df not found for base_amount precision * feat: serial no validation from previous pos transactions * chore: move pos.py into pos page * feat: pos opening voucher * feat: link pos closing voucher with opening voucher * chore: use map_doc instead of get_mapped_doc for better perf * feat: enforce opening voucher on pos page * feat: [ui] [wip] point of sale beta ui refactor * fix: auto fetching serial nos with batch no * feat: [ui] item details section for new pos ui * feat: remove item from cart * refactor: [ui] [wip] split point_of_sale into components * new payment component * new numberpad * fix pos opening status * move from flex to grids * fix: search from item selector * feat: loyalty points as payment method * feat: pos invoice status * fix a bug with invalid JSON * fix: loyalty program ui fixes * feat: past order list and past order summary * feat: (minor) setting discount from item details * fix: adding item before customer selection * feat: post order submission summary * save and open draft orders * fix: item group filter * fix: item_det not defined while submitting sle * fix: minor bugs * fix: minor ux fixes * feat: show opening time in pos ui * feat: item and customer images * feat: emailing and printing an invoice * fix: item details field edit shows empty alert * fix: (minor) ux fixes * chore: rename pos opening voucher to pos opening entry * chore: (minor) rename pos closing voucher and sub doctypes * chore: add patch for renaming pos closing doctypes * fix: negative stock not allowed in pos invoices* default is_pos in pos invoices* fix: transalation * fix: invoices not getting fetched on pos closing * fix: indentation * feat: view / edit customer info * fix: minor bugs * fix: minor bug * fix: patch * fix: minor ux issues * fix: remove uppercase status * refactor: pos closing payment reconciliation * fix: move pos invoice print formats to pos invoice doctype * fix: ui issues * feat: new child doctype to store pos payment mode details * fix: add to patches.txt * feat: search by serial no * chore: [wip] code cleanup * fix: item not selectable from cart * chore: [wip] code cleanup * fix: minor issues * loyalty points transactions * default payment mode * fix: minor fixes * set correct mop amount with loaylty points * editing draft invoices from UI * chore: pos invoice merge log tests * fix: batch / serial validation in pos ui and on submission * feat: use onscan js for barcode scan events * fix: cart header with amount column * fix: validate batch no and qty in pos transactions * chore: do not fetch closing balances as opening balance * feat: show available qty in item selector * feat: shortcuts * fix: onscan.js not found * fix: onscan.js not found * fix: cannot return partial items * fix: neagtive stock indicator * feat: invoice discount * fix: change available stock on warehouse change * chore: cleanup code * fix: pos profile payment method table * feat: adding same item with different uom * fix: loyalty points deleted after consolidation * fix: enter loyalty amount instead of loyalty points * chore: return print format * feat: custom fields in pos view * chore: pos invoice test * chore: remove offline pos * fix: cyclic dependency * fix: cyclic dependency * patch: remove pos page and order fixes * chore: little fixes * fix: patch perf and plural naming * chore: tidy up pos invoice validation * chore: move pos closing to accounts * fix: move pos doctypes to accounts * fix: move pos doctypes to accounts * fix: item description in cart * fix: item description in cart * chore: loyalty tests * minor fixes * chore: rename point of sale beta to point of sale * chore: reset past order summary on filter change * chore: add point of sale to accounting desk * fix: payment reconciliation table in pos closing * fix: travis * Update accounting.json * fix: test cases * fix: tests * patch loyalty point entries * fix: remove test * default mode of payment is mandatory for pos transaction * chore: remove unused checks from pos profile * fix: loyalty point entry patch * fix: numpad reset and patches * fix: minor bugs * fix: travis * fix: travis * fix: travis * fix: travis Co-authored-by: Nabin Hait <nabinhait@gmail.com>
2020-07-23 13:21:26 +00:00
def get_barcode_data(items_list):
# get itemwise batch no data
# exmaple: {'LED-GRE': [Batch001, Batch002]}
# where LED-GRE is item code, SN0001 is serial no and Pune is warehouse
itemwise_barcode = {}
for item in items_list:
2022-03-28 13:22:46 +00:00
barcodes = frappe.db.sql(
"""
refactor: POS workflow (#20789) * refactor: add pos invoice doctype replacing sales invoice in POS * refactor: move pos.py to pos invoice * feat: add pos invoice merge log doctype * feat: ability to merge pos invoices into a sales invoice * feat: [wip] new ui for point of sale * fix: pos.py moved to pos_invoice * feat: loyalty points for POS Invoice * fix: loyalty points on merging * feat: return against pos invoices * Merge 'fork/serial-no-selector' into refactor-pos-invoice * chore: status fix and set warehouse from pos profile * fix: naming series * feat: merge pos returns into credit notes * feat: add pos list action for merging into sales invoices * feat[UX]: add shortcuts & focus on search after customer selection * feat: stock validation from previous pos transactions * Merge 'fork/serial-no-selector' into refactor-pos-invoice * chore: fix df not found for base_amount precision * feat: serial no validation from previous pos transactions * chore: move pos.py into pos page * feat: pos opening voucher * feat: link pos closing voucher with opening voucher * chore: use map_doc instead of get_mapped_doc for better perf * feat: enforce opening voucher on pos page * feat: [ui] [wip] point of sale beta ui refactor * fix: auto fetching serial nos with batch no * feat: [ui] item details section for new pos ui * feat: remove item from cart * refactor: [ui] [wip] split point_of_sale into components * new payment component * new numberpad * fix pos opening status * move from flex to grids * fix: search from item selector * feat: loyalty points as payment method * feat: pos invoice status * fix a bug with invalid JSON * fix: loyalty program ui fixes * feat: past order list and past order summary * feat: (minor) setting discount from item details * fix: adding item before customer selection * feat: post order submission summary * save and open draft orders * fix: item group filter * fix: item_det not defined while submitting sle * fix: minor bugs * fix: minor ux fixes * feat: show opening time in pos ui * feat: item and customer images * feat: emailing and printing an invoice * fix: item details field edit shows empty alert * fix: (minor) ux fixes * chore: rename pos opening voucher to pos opening entry * chore: (minor) rename pos closing voucher and sub doctypes * chore: add patch for renaming pos closing doctypes * fix: negative stock not allowed in pos invoices* default is_pos in pos invoices* fix: transalation * fix: invoices not getting fetched on pos closing * fix: indentation * feat: view / edit customer info * fix: minor bugs * fix: minor bug * fix: patch * fix: minor ux issues * fix: remove uppercase status * refactor: pos closing payment reconciliation * fix: move pos invoice print formats to pos invoice doctype * fix: ui issues * feat: new child doctype to store pos payment mode details * fix: add to patches.txt * feat: search by serial no * chore: [wip] code cleanup * fix: item not selectable from cart * chore: [wip] code cleanup * fix: minor issues * loyalty points transactions * default payment mode * fix: minor fixes * set correct mop amount with loaylty points * editing draft invoices from UI * chore: pos invoice merge log tests * fix: batch / serial validation in pos ui and on submission * feat: use onscan js for barcode scan events * fix: cart header with amount column * fix: validate batch no and qty in pos transactions * chore: do not fetch closing balances as opening balance * feat: show available qty in item selector * feat: shortcuts * fix: onscan.js not found * fix: onscan.js not found * fix: cannot return partial items * fix: neagtive stock indicator * feat: invoice discount * fix: change available stock on warehouse change * chore: cleanup code * fix: pos profile payment method table * feat: adding same item with different uom * fix: loyalty points deleted after consolidation * fix: enter loyalty amount instead of loyalty points * chore: return print format * feat: custom fields in pos view * chore: pos invoice test * chore: remove offline pos * fix: cyclic dependency * fix: cyclic dependency * patch: remove pos page and order fixes * chore: little fixes * fix: patch perf and plural naming * chore: tidy up pos invoice validation * chore: move pos closing to accounts * fix: move pos doctypes to accounts * fix: move pos doctypes to accounts * fix: item description in cart * fix: item description in cart * chore: loyalty tests * minor fixes * chore: rename point of sale beta to point of sale * chore: reset past order summary on filter change * chore: add point of sale to accounting desk * fix: payment reconciliation table in pos closing * fix: travis * Update accounting.json * fix: test cases * fix: tests * patch loyalty point entries * fix: remove test * default mode of payment is mandatory for pos transaction * chore: remove unused checks from pos profile * fix: loyalty point entry patch * fix: numpad reset and patches * fix: minor bugs * fix: travis * fix: travis * fix: travis * fix: travis Co-authored-by: Nabin Hait <nabinhait@gmail.com>
2020-07-23 13:21:26 +00:00
select barcode from `tabItem Barcode` where parent = %s
2022-03-28 13:22:46 +00:00
""",
item.item_code,
as_dict=1,
)
refactor: POS workflow (#20789) * refactor: add pos invoice doctype replacing sales invoice in POS * refactor: move pos.py to pos invoice * feat: add pos invoice merge log doctype * feat: ability to merge pos invoices into a sales invoice * feat: [wip] new ui for point of sale * fix: pos.py moved to pos_invoice * feat: loyalty points for POS Invoice * fix: loyalty points on merging * feat: return against pos invoices * Merge 'fork/serial-no-selector' into refactor-pos-invoice * chore: status fix and set warehouse from pos profile * fix: naming series * feat: merge pos returns into credit notes * feat: add pos list action for merging into sales invoices * feat[UX]: add shortcuts & focus on search after customer selection * feat: stock validation from previous pos transactions * Merge 'fork/serial-no-selector' into refactor-pos-invoice * chore: fix df not found for base_amount precision * feat: serial no validation from previous pos transactions * chore: move pos.py into pos page * feat: pos opening voucher * feat: link pos closing voucher with opening voucher * chore: use map_doc instead of get_mapped_doc for better perf * feat: enforce opening voucher on pos page * feat: [ui] [wip] point of sale beta ui refactor * fix: auto fetching serial nos with batch no * feat: [ui] item details section for new pos ui * feat: remove item from cart * refactor: [ui] [wip] split point_of_sale into components * new payment component * new numberpad * fix pos opening status * move from flex to grids * fix: search from item selector * feat: loyalty points as payment method * feat: pos invoice status * fix a bug with invalid JSON * fix: loyalty program ui fixes * feat: past order list and past order summary * feat: (minor) setting discount from item details * fix: adding item before customer selection * feat: post order submission summary * save and open draft orders * fix: item group filter * fix: item_det not defined while submitting sle * fix: minor bugs * fix: minor ux fixes * feat: show opening time in pos ui * feat: item and customer images * feat: emailing and printing an invoice * fix: item details field edit shows empty alert * fix: (minor) ux fixes * chore: rename pos opening voucher to pos opening entry * chore: (minor) rename pos closing voucher and sub doctypes * chore: add patch for renaming pos closing doctypes * fix: negative stock not allowed in pos invoices* default is_pos in pos invoices* fix: transalation * fix: invoices not getting fetched on pos closing * fix: indentation * feat: view / edit customer info * fix: minor bugs * fix: minor bug * fix: patch * fix: minor ux issues * fix: remove uppercase status * refactor: pos closing payment reconciliation * fix: move pos invoice print formats to pos invoice doctype * fix: ui issues * feat: new child doctype to store pos payment mode details * fix: add to patches.txt * feat: search by serial no * chore: [wip] code cleanup * fix: item not selectable from cart * chore: [wip] code cleanup * fix: minor issues * loyalty points transactions * default payment mode * fix: minor fixes * set correct mop amount with loaylty points * editing draft invoices from UI * chore: pos invoice merge log tests * fix: batch / serial validation in pos ui and on submission * feat: use onscan js for barcode scan events * fix: cart header with amount column * fix: validate batch no and qty in pos transactions * chore: do not fetch closing balances as opening balance * feat: show available qty in item selector * feat: shortcuts * fix: onscan.js not found * fix: onscan.js not found * fix: cannot return partial items * fix: neagtive stock indicator * feat: invoice discount * fix: change available stock on warehouse change * chore: cleanup code * fix: pos profile payment method table * feat: adding same item with different uom * fix: loyalty points deleted after consolidation * fix: enter loyalty amount instead of loyalty points * chore: return print format * feat: custom fields in pos view * chore: pos invoice test * chore: remove offline pos * fix: cyclic dependency * fix: cyclic dependency * patch: remove pos page and order fixes * chore: little fixes * fix: patch perf and plural naming * chore: tidy up pos invoice validation * chore: move pos closing to accounts * fix: move pos doctypes to accounts * fix: move pos doctypes to accounts * fix: item description in cart * fix: item description in cart * chore: loyalty tests * minor fixes * chore: rename point of sale beta to point of sale * chore: reset past order summary on filter change * chore: add point of sale to accounting desk * fix: payment reconciliation table in pos closing * fix: travis * Update accounting.json * fix: test cases * fix: tests * patch loyalty point entries * fix: remove test * default mode of payment is mandatory for pos transaction * chore: remove unused checks from pos profile * fix: loyalty point entry patch * fix: numpad reset and patches * fix: minor bugs * fix: travis * fix: travis * fix: travis * fix: travis Co-authored-by: Nabin Hait <nabinhait@gmail.com>
2020-07-23 13:21:26 +00:00
for barcode in barcodes:
if item.item_code not in itemwise_barcode:
itemwise_barcode.setdefault(item.item_code, [])
itemwise_barcode[item.item_code].append(barcode.get("barcode"))
return itemwise_barcode
2022-03-28 13:22:46 +00:00
@frappe.whitelist()
def get_item_tax_info(company, tax_category, item_codes, item_rates=None, item_tax_templates=None):
out = {}
2021-06-25 08:04:00 +00:00
2021-06-25 08:08:06 +00:00
if item_tax_templates is None:
2021-06-25 08:04:00 +00:00
item_tax_templates = {}
2021-07-13 06:15:41 +00:00
2021-06-25 08:08:06 +00:00
if item_rates is None:
item_rates = {}
2021-06-25 08:04:00 +00:00
if isinstance(item_codes, (str,)):
item_codes = json.loads(item_codes)
if isinstance(item_rates, (str,)):
2021-06-04 17:23:26 +00:00
item_rates = json.loads(item_rates)
if isinstance(item_tax_templates, (str,)):
item_tax_templates = json.loads(item_tax_templates)
for item_code in item_codes:
if not item_code or item_code[1] in out or not item_tax_templates.get(item_code[1]):
continue
2021-06-04 17:23:26 +00:00
out[item_code[1]] = {}
item = frappe.get_cached_doc("Item", item_code[0])
2022-03-28 13:22:46 +00:00
args = {
"company": company,
"tax_category": tax_category,
"net_rate": item_rates.get(item_code[1]),
}
2021-06-23 17:22:51 +00:00
if item_tax_templates:
args.update({"item_tax_template": item_tax_templates.get(item_code[1])})
2021-06-04 17:23:26 +00:00
get_item_tax_template(args, item, out[item_code[1]])
2022-03-28 13:22:46 +00:00
out[item_code[1]]["item_tax_rate"] = get_item_tax_map(
company, out[item_code[1]].get("item_tax_template"), as_json=True
)
return out
2022-03-28 13:22:46 +00:00
def get_item_tax_template(args, item, out):
"""
2022-03-28 13:22:46 +00:00
args = {
"tax_category": None
"item_tax_template": None
}
"""
item_tax_template = None
if item.taxes:
item_tax_template = _get_item_tax_template(args, item.taxes, out)
if not item_tax_template:
item_group = item.item_group
while item_group and not item_tax_template:
item_group_doc = frappe.get_cached_doc("Item Group", item_group)
item_tax_template = _get_item_tax_template(args, item_group_doc.taxes, out)
item_group = item_group_doc.parent_item_group
2022-03-28 13:22:46 +00:00
def _get_item_tax_template(args, taxes, out=None, for_validate=False):
if out is None:
out = {}
taxes_with_validity = []
taxes_with_no_validity = []
for tax in taxes:
2022-03-28 13:22:46 +00:00
tax_company = frappe.get_cached_value("Item Tax Template", tax.item_tax_template, "company")
if tax_company == args["company"]:
if tax.valid_from or tax.maximum_net_rate:
# In purchase Invoice first preference will be given to supplier invoice date
# if supplier date is not present then posting date
validation_date = args.get("bill_date") or args.get("transaction_date")
2022-03-28 13:22:46 +00:00
if getdate(tax.valid_from) <= getdate(validation_date) and is_within_valid_range(args, tax):
taxes_with_validity.append(tax)
else:
taxes_with_no_validity.append(tax)
if taxes_with_validity:
2022-03-28 13:22:46 +00:00
taxes = sorted(taxes_with_validity, key=lambda i: i.valid_from, reverse=True)
else:
taxes = taxes_with_no_validity
if for_validate:
2022-03-28 13:22:46 +00:00
return [
tax.item_tax_template
for tax in taxes
if (
cstr(tax.tax_category) == cstr(args.get("tax_category"))
and (tax.item_tax_template not in taxes)
)
]
# all templates have validity and no template is valid
if not taxes_with_validity and (not taxes_with_no_validity):
return None
2021-06-04 17:23:26 +00:00
# do not change if already a valid template
2022-03-28 13:22:46 +00:00
if args.get("item_tax_template") in {t.item_tax_template for t in taxes}:
out["item_tax_template"] = args.get("item_tax_template")
return args.get("item_tax_template")
2021-06-04 17:23:26 +00:00
for tax in taxes:
if cstr(tax.tax_category) == cstr(args.get("tax_category")):
out["item_tax_template"] = tax.item_tax_template
return tax.item_tax_template
return None
2022-03-28 13:22:46 +00:00
2021-06-04 17:23:26 +00:00
def is_within_valid_range(args, tax):
if not flt(tax.maximum_net_rate):
# No range specified, just ignore
return True
2022-03-28 13:22:46 +00:00
elif flt(tax.minimum_net_rate) <= flt(args.get("net_rate")) <= flt(tax.maximum_net_rate):
2021-06-04 17:23:26 +00:00
return True
return False
2022-03-28 13:22:46 +00:00
@frappe.whitelist()
def get_item_tax_map(company, item_tax_template, as_json=True):
item_tax_map = {}
if item_tax_template:
template = frappe.get_cached_doc("Item Tax Template", item_tax_template)
for d in template.taxes:
if frappe.get_cached_value("Account", d.tax_type, "company") == company:
item_tax_map[d.tax_type] = d.tax_rate
return json.dumps(item_tax_map) if as_json else item_tax_map
2022-03-28 13:22:46 +00:00
@frappe.whitelist()
def calculate_service_end_date(args, item=None):
args = process_args(args)
if not item:
item = frappe.get_cached_doc("Item", args.item_code)
2019-01-15 08:46:32 +00:00
doctype = args.get("parenttype") or args.get("doctype")
2019-01-15 09:06:11 +00:00
if doctype == "Sales Invoice":
enable_deferred = "enable_deferred_revenue"
no_of_months = "no_of_months"
account = "deferred_revenue_account"
else:
enable_deferred = "enable_deferred_expense"
no_of_months = "no_of_months_exp"
account = "deferred_expense_account"
service_start_date = args.service_start_date if args.service_start_date else args.transaction_date
service_end_date = add_months(service_start_date, item.get(no_of_months))
2022-03-28 13:22:46 +00:00
deferred_detail = {"service_start_date": service_start_date, "service_end_date": service_end_date}
deferred_detail[enable_deferred] = item.get(enable_deferred)
deferred_detail[account] = get_default_deferred_account(args, item, fieldname=account)
return deferred_detail
2022-03-28 13:22:46 +00:00
def get_default_income_account(args, item, item_group, brand):
2022-03-28 13:22:46 +00:00
return (
item.get("income_account")
or item_group.get("income_account")
or brand.get("income_account")
2022-03-28 13:22:46 +00:00
or args.income_account
)
def get_default_expense_account(args, item, item_group, brand):
2022-03-28 13:22:46 +00:00
return (
item.get("expense_account")
or item_group.get("expense_account")
or brand.get("expense_account")
2022-03-28 13:22:46 +00:00
or args.expense_account
)
def get_provisional_account(args, item):
return item.get("default_provisional_account") or args.default_provisional_account
def get_default_discount_account(args, item):
2022-03-28 13:22:46 +00:00
return item.get("default_discount_account") or args.discount_account
def get_default_deferred_account(args, item, fieldname=None):
2019-01-15 08:46:32 +00:00
if item.get("enable_deferred_revenue") or item.get("enable_deferred_expense"):
2022-03-28 13:22:46 +00:00
return (
item.get(fieldname)
or args.get(fieldname)
2022-03-28 13:22:46 +00:00
or frappe.get_cached_value("Company", args.company, "default_" + fieldname)
)
else:
return None
2022-03-28 13:22:46 +00:00
def get_default_cost_center(args, item=None, item_group=None, brand=None, company=None):
cost_center = None
if not company and args.get("company"):
company = args.get("company")
2022-03-28 13:22:46 +00:00
if args.get("project"):
cost_center = frappe.db.get_value("Project", args.get("project"), "cost_center", cache=True)
if not cost_center and (item and item_group and brand):
2022-03-28 13:22:46 +00:00
if args.get("customer"):
cost_center = (
item.get("selling_cost_center")
or item_group.get("selling_cost_center")
or brand.get("selling_cost_center")
)
else:
2022-03-28 13:22:46 +00:00
cost_center = (
item.get("buying_cost_center")
or item_group.get("buying_cost_center")
or brand.get("buying_cost_center")
)
elif not cost_center and args.get("item_code") and company:
for method in ["get_item_defaults", "get_item_group_defaults", "get_brand_defaults"]:
path = "erpnext.stock.get_item_details.{0}".format(method)
data = frappe.get_attr(path)(args.get("item_code"), company)
if data and (data.selling_cost_center or data.buying_cost_center):
return data.selling_cost_center or data.buying_cost_center
if not cost_center and args.get("cost_center"):
cost_center = args.get("cost_center")
2022-03-28 13:22:46 +00:00
if (
company
and cost_center
and frappe.get_cached_value("Cost Center", cost_center, "company") != company
):
return None
if not cost_center and company:
2022-03-28 13:22:46 +00:00
cost_center = frappe.get_cached_value("Company", company, "cost_center")
return cost_center
2022-03-28 13:22:46 +00:00
def get_default_supplier(args, item, item_group, brand):
2022-03-28 13:22:46 +00:00
return (
item.get("default_supplier")
or item_group.get("default_supplier")
2022-03-28 13:22:46 +00:00
or brand.get("default_supplier")
)
def get_price_list_rate(args, item_doc, out=None):
if out is None:
out = frappe._dict()
2016-02-15 06:12:18 +00:00
meta = frappe.get_meta(args.parenttype or args.doctype)
2022-03-28 13:22:46 +00:00
if meta.get_field("currency") or args.get("currency"):
if not args.get("price_list_currency") or not args.get("plc_conversion_rate"):
# if currency and plc_conversion_rate exist then
# `get_price_list_currency_and_exchange_rate` has already been called
pl_details = get_price_list_currency_and_exchange_rate(args)
args.update(pl_details)
if meta.get_field("currency"):
validate_conversion_rate(args, meta)
price_list_rate = get_price_list_rate_for(args, item_doc.name)
# variant
if price_list_rate is None and item_doc.variant_of:
price_list_rate = get_price_list_rate_for(args, item_doc.variant_of)
# insert in database
if price_list_rate is None:
if args.price_list and args.rate:
insert_item_price(args)
return out
2022-03-28 13:22:46 +00:00
out.price_list_rate = (
flt(price_list_rate) * flt(args.plc_conversion_rate) / flt(args.conversion_rate)
)
2022-03-28 13:22:46 +00:00
if not out.price_list_rate and args.transaction_type == "buying":
from erpnext.stock.doctype.item.item import get_last_purchase_details
2022-03-28 13:22:46 +00:00
out.update(get_last_purchase_details(item_doc.name, args.name, args.conversion_rate))
return out
2022-03-28 13:22:46 +00:00
def insert_item_price(args):
"""Insert Item Price if Price List and Price List Rate are specified and currency is the same"""
2022-03-28 13:22:46 +00:00
if frappe.db.get_value(
"Price List", args.price_list, "currency", cache=True
) == args.currency and cint(
frappe.db.get_single_value("Stock Settings", "auto_insert_price_list_rate_if_missing")
):
if frappe.has_permission("Item Price", "write"):
2022-03-28 13:22:46 +00:00
price_list_rate = (
(flt(args.rate) + flt(args.discount_amount)) / args.get("conversion_factor")
if args.get("conversion_factor")
else (flt(args.rate) + flt(args.discount_amount))
2022-03-28 13:22:46 +00:00
)
item_price = frappe.db.get_value(
"Item Price",
{"item_code": args.item_code, "price_list": args.price_list, "currency": args.currency},
["name", "price_list_rate"],
as_dict=1,
)
if item_price and item_price.name:
2022-03-28 13:22:46 +00:00
if item_price.price_list_rate != price_list_rate and frappe.db.get_single_value(
"Stock Settings", "update_existing_price_list_rate"
):
frappe.db.set_value("Item Price", item_price.name, "price_list_rate", price_list_rate)
frappe.msgprint(
_("Item Price updated for {0} in Price List {1}").format(args.item_code, args.price_list),
alert=True,
)
else:
2022-03-28 13:22:46 +00:00
item_price = frappe.get_doc(
{
"doctype": "Item Price",
"price_list": args.price_list,
"item_code": args.item_code,
"currency": args.currency,
"price_list_rate": price_list_rate,
"uom": args.stock_uom,
2022-03-28 13:22:46 +00:00
}
)
2016-06-24 11:41:15 +00:00
item_price.insert()
2022-03-28 13:22:46 +00:00
frappe.msgprint(
_("Item Price added for {0} in Price List {1}").format(args.item_code, args.price_list),
alert=True,
)
def get_item_price(args, item_code, ignore_party=False):
"""
2022-03-28 13:22:46 +00:00
Get name, price_list_rate from Item Price based on conditions
Check if the desired qty is within the increment of the packing list.
:param args: dict (or frappe._dict) with mandatory fields price_list, uom
optional fields transaction_date, customer, supplier
:param item_code: str, Item Doctype field item_code
"""
2022-03-28 13:22:46 +00:00
args["item_code"] = item_code
conditions = """where item_code=%(item_code)s
and price_list=%(price_list)s
and ifnull(uom, '') in ('', %(uom)s)"""
conditions += "and ifnull(batch_no, '') in ('', %(batch_no)s)"
if not ignore_party:
if args.get("customer"):
conditions += " and customer=%(customer)s"
elif args.get("supplier"):
conditions += " and supplier=%(supplier)s"
else:
conditions += "and (customer is null or customer = '') and (supplier is null or supplier = '')"
2022-03-28 13:22:46 +00:00
if args.get("transaction_date"):
conditions += """ and %(transaction_date)s between
ifnull(valid_from, '2000-01-01') and ifnull(valid_upto, '2500-12-31')"""
2020-07-11 08:28:53 +00:00
2022-03-28 13:22:46 +00:00
return frappe.db.sql(
""" select name, price_list_rate, uom
from `tabItem Price` {conditions}
order by valid_from desc, ifnull(batch_no, '') desc, uom desc """.format(
2022-03-28 13:22:46 +00:00
conditions=conditions
),
args,
)
def get_price_list_rate_for(args, item_code):
"""
2022-03-28 13:22:46 +00:00
:param customer: link to Customer DocType
:param supplier: link to Supplier DocType
:param price_list: str (Standard Buying or Standard Selling)
:param item_code: str, Item Doctype field item_code
:param qty: Desired Qty
:param transaction_date: Date of the price
"""
item_price_args = {
2022-03-28 13:22:46 +00:00
"item_code": item_code,
"price_list": args.get("price_list"),
"customer": args.get("customer"),
"supplier": args.get("supplier"),
"uom": args.get("uom"),
"transaction_date": args.get("transaction_date"),
"batch_no": args.get("batch_no"),
}
item_price_data = 0
price_list_rate = get_item_price(item_price_args, item_code)
if price_list_rate:
desired_qty = args.get("qty")
2019-02-27 14:01:32 +00:00
if desired_qty and check_packing_list(price_list_rate[0][0], desired_qty, item_code):
item_price_data = price_list_rate
else:
for field in ["customer", "supplier"]:
del item_price_args[field]
2022-03-28 13:22:46 +00:00
general_price_list_rate = get_item_price(
item_price_args, item_code, ignore_party=args.get("ignore_party")
)
if not general_price_list_rate and args.get("uom") != args.get("stock_uom"):
item_price_args["uom"] = args.get("stock_uom")
2022-03-28 13:22:46 +00:00
general_price_list_rate = get_item_price(
item_price_args, item_code, ignore_party=args.get("ignore_party")
)
if general_price_list_rate:
item_price_data = general_price_list_rate
if item_price_data:
if item_price_data[0][2] == args.get("uom"):
return item_price_data[0][1]
2022-03-28 13:22:46 +00:00
elif not args.get("price_list_uom_dependant"):
return flt(item_price_data[0][1] * flt(args.get("conversion_factor", 1)))
else:
return item_price_data[0][1]
2022-03-28 13:22:46 +00:00
def check_packing_list(price_list_rate_name, desired_qty, item_code):
"""
2022-03-28 13:22:46 +00:00
Check if the desired qty is within the increment of the packing list.
:param price_list_rate_name: Name of Item Price
:param desired_qty: Desired Qt
:param item_code: str, Item Doctype field item_code
:param qty: Desired Qt
"""
2019-02-27 12:31:25 +00:00
flag = True
item_price = frappe.get_doc("Item Price", price_list_rate_name)
2019-02-27 14:01:32 +00:00
if item_price.packing_unit:
packing_increment = desired_qty % item_price.packing_unit
2019-02-27 12:31:25 +00:00
if packing_increment != 0:
flag = False
return flag
2022-03-28 13:22:46 +00:00
def validate_conversion_rate(args, meta):
2014-09-29 06:47:03 +00:00
from erpnext.controllers.accounts_controller import validate_conversion_rate
2022-03-28 13:22:46 +00:00
company_currency = frappe.get_cached_value("Company", args.company, "default_currency")
if not args.conversion_rate and args.currency == company_currency:
args.conversion_rate = 1.0
2022-03-28 13:22:46 +00:00
if (
not args.ignore_conversion_rate
and args.conversion_rate == 1
and args.currency != company_currency
):
args.conversion_rate = (
get_exchange_rate(args.currency, company_currency, args.transaction_date, "for_buying") or 1.0
)
2021-07-13 06:15:41 +00:00
# validate currency conversion rate
2022-03-28 13:22:46 +00:00
validate_conversion_rate(
args.currency, args.conversion_rate, meta.get_label("conversion_rate"), args.company
)
2022-03-28 13:22:46 +00:00
args.conversion_rate = flt(
args.conversion_rate,
get_field_precision(meta.get_field("conversion_rate"), frappe._dict({"fields": args})),
)
if args.price_list:
2022-03-28 13:22:46 +00:00
if not args.plc_conversion_rate and args.price_list_currency == frappe.db.get_value(
"Price List", args.price_list, "currency", cache=True
):
args.plc_conversion_rate = 1.0
# validate price list currency conversion rate
if not args.get("price_list_currency"):
throw(_("Price List Currency not selected"))
else:
2022-03-28 13:22:46 +00:00
validate_conversion_rate(
args.price_list_currency,
args.plc_conversion_rate,
meta.get_label("plc_conversion_rate"),
args.company,
)
if meta.get_field("plc_conversion_rate"):
2022-03-28 13:22:46 +00:00
args.plc_conversion_rate = flt(
args.plc_conversion_rate,
get_field_precision(meta.get_field("plc_conversion_rate"), frappe._dict({"fields": args})),
)
def get_party_item_code(args, item_doc, out):
2022-03-28 13:22:46 +00:00
if args.transaction_type == "selling" and args.customer:
out.customer_item_code = None
2022-03-28 13:22:46 +00:00
if args.quotation_to and args.quotation_to != "Customer":
return
2014-12-26 06:11:15 +00:00
customer_item_code = item_doc.get("customer_items", {"customer_name": args.customer})
if customer_item_code:
out.customer_item_code = customer_item_code[0].ref_code
else:
2018-08-09 05:17:09 +00:00
customer_group = frappe.get_cached_value("Customer", args.customer, "customer_group")
customer_group_item_code = item_doc.get("customer_items", {"customer_group": customer_group})
if customer_group_item_code and not customer_group_item_code[0].customer_name:
out.customer_item_code = customer_group_item_code[0].ref_code
2016-01-21 16:58:47 +00:00
2022-03-28 13:22:46 +00:00
if args.transaction_type == "buying" and args.supplier:
2014-12-26 06:11:15 +00:00
item_supplier = item_doc.get("supplier_items", {"supplier": args.supplier})
out.supplier_part_no = item_supplier[0].supplier_part_no if item_supplier else None
2022-03-28 13:22:46 +00:00
def get_pos_profile_item_details(company, args, pos_profile=None, update_data=False):
2014-02-14 10:17:51 +00:00
res = frappe._dict()
2018-08-08 11:07:31 +00:00
if not frappe.flags.pos_profile and not pos_profile:
2022-03-28 13:22:46 +00:00
pos_profile = frappe.flags.pos_profile = get_pos_profile(company, args.get("pos_profile"))
if pos_profile:
for fieldname in ("income_account", "cost_center", "warehouse", "expense_account"):
if (not args.get(fieldname) or update_data) and pos_profile.get(fieldname):
res[fieldname] = pos_profile.get(fieldname)
if res.get("warehouse"):
res.actual_qty = get_bin_details(
args.item_code, res.warehouse, include_child_warehouses=True
).get("actual_qty")
return res
2022-03-28 13:22:46 +00:00
@frappe.whitelist()
def get_pos_profile(company, pos_profile=None, user=None):
2022-03-28 13:22:46 +00:00
if pos_profile:
return frappe.get_cached_doc("POS Profile", pos_profile)
if not user:
2022-03-28 13:22:46 +00:00
user = frappe.session["user"]
2019-04-04 19:12:48 +00:00
condition = "pfu.user = %(user)s AND pfu.default=1"
if user and company:
condition = "pfu.user = %(user)s AND pf.company = %(company)s AND pfu.default=1"
2022-03-28 13:22:46 +00:00
pos_profile = frappe.db.sql(
"""SELECT pf.*
FROM
`tabPOS Profile` pf LEFT JOIN `tabPOS Profile User` pfu
ON
pf.name = pfu.parent
WHERE
2019-04-04 19:12:48 +00:00
{cond} AND pf.disabled = 0
2022-03-28 13:22:46 +00:00
""".format(
cond=condition
),
{"user": user, "company": company},
as_dict=1,
)
2019-04-04 19:12:48 +00:00
if not pos_profile and company:
2022-03-28 13:22:46 +00:00
pos_profile = frappe.db.sql(
"""SELECT pf.*
2019-04-04 19:12:48 +00:00
FROM
`tabPOS Profile` pf LEFT JOIN `tabPOS Profile User` pfu
ON
pf.name = pfu.parent
WHERE
pf.company = %(company)s AND pf.disabled = 0
2022-03-28 13:22:46 +00:00
""",
{"company": company},
as_dict=1,
)
2019-04-04 19:12:48 +00:00
return pos_profile and pos_profile[0] or None
2022-03-28 13:22:46 +00:00
def get_serial_nos_by_fifo(args, sales_order=None):
if frappe.db.get_single_value("Stock Settings", "automatically_set_serial_nos_based_on_fifo"):
2022-03-28 13:22:46 +00:00
return "\n".join(
frappe.db.sql_list(
"""select name from `tabSerial No`
where item_code=%(item_code)s and warehouse=%(warehouse)s and
sales_order=IF(%(sales_order)s IS NULL, sales_order, %(sales_order)s)
order by timestamp(purchase_date, purchase_time)
asc limit %(qty)s""",
2022-03-28 13:22:46 +00:00
{
"item_code": args.item_code,
"warehouse": args.warehouse,
"qty": abs(cint(args.stock_qty)),
"sales_order": sales_order,
},
)
)
def get_serial_no_batchwise(args, sales_order=None):
if frappe.db.get_single_value("Stock Settings", "automatically_set_serial_nos_based_on_fifo"):
2022-03-28 13:22:46 +00:00
return "\n".join(
frappe.db.sql_list(
"""select name from `tabSerial No`
where item_code=%(item_code)s and warehouse=%(warehouse)s and
sales_order=IF(%(sales_order)s IS NULL, sales_order, %(sales_order)s)
and batch_no=IF(%(batch_no)s IS NULL, batch_no, %(batch_no)s) order
2022-03-28 13:22:46 +00:00
by timestamp(purchase_date, purchase_time) asc limit %(qty)s""",
{
"item_code": args.item_code,
"warehouse": args.warehouse,
"batch_no": args.batch_no,
"qty": abs(cint(args.stock_qty)),
"sales_order": sales_order,
},
)
)
2014-02-14 10:17:51 +00:00
@frappe.whitelist()
def get_conversion_factor(item_code, uom):
2018-08-08 11:07:31 +00:00
variant_of = frappe.db.get_value("Item", item_code, "variant_of", cache=True)
filters = {"parent": item_code, "uom": uom}
if variant_of:
filters["parent"] = ("in", (item_code, variant_of))
2022-03-28 13:22:46 +00:00
conversion_factor = frappe.db.get_value("UOM Conversion Detail", filters, "conversion_factor")
if not conversion_factor:
stock_uom = frappe.db.get_value("Item", item_code, "stock_uom")
conversion_factor = get_uom_conv_factor(uom, stock_uom)
return {"conversion_factor": conversion_factor or 1.0}
2022-03-28 13:22:46 +00:00
2014-02-14 10:17:51 +00:00
@frappe.whitelist()
def get_projected_qty(item_code, warehouse):
2022-03-28 13:22:46 +00:00
return {
"projected_qty": frappe.db.get_value(
"Bin", {"item_code": item_code, "warehouse": warehouse}, "projected_qty"
)
}
2014-02-14 10:17:51 +00:00
@frappe.whitelist()
def get_bin_details(item_code, warehouse, company=None, include_child_warehouses=False):
bin_details = {"projected_qty": 0, "actual_qty": 0, "reserved_qty": 0}
if warehouse:
from erpnext.stock.doctype.warehouse.warehouse import get_child_warehouses
warehouses = get_child_warehouses(warehouse) if include_child_warehouses else [warehouse]
bin_details = frappe.db.get_value(
"Bin",
filters={"item_code": item_code, "warehouse": ["in", warehouses]},
fieldname=[
"sum(projected_qty) as projected_qty",
"sum(actual_qty) as actual_qty",
"sum(reserved_qty) as reserved_qty",
],
as_dict=True,
cache=True,
)
bin_details = {k: 0 if not v else v for k, v in bin_details.items()}
2021-03-15 06:07:46 +00:00
if company:
2022-03-28 13:22:46 +00:00
bin_details["company_total_stock"] = get_company_total_stock(item_code, company)
2021-03-15 06:07:46 +00:00
return bin_details
2022-03-28 13:22:46 +00:00
2021-03-15 06:07:46 +00:00
def get_company_total_stock(item_code, company):
2022-03-28 13:22:46 +00:00
return frappe.db.sql(
"""SELECT sum(actual_qty) from
(`tabBin` INNER JOIN `tabWarehouse` ON `tabBin`.warehouse = `tabWarehouse`.name)
WHERE `tabWarehouse`.company = %s and `tabBin`.item_code = %s""",
2022-03-28 13:22:46 +00:00
(company, item_code),
)[0][0]
2021-03-15 06:07:46 +00:00
@frappe.whitelist()
2017-02-10 08:57:11 +00:00
def get_serial_no_details(item_code, warehouse, stock_qty, serial_no):
2022-03-28 13:22:46 +00:00
args = frappe._dict(
{"item_code": item_code, "warehouse": warehouse, "stock_qty": stock_qty, "serial_no": serial_no}
)
serial_no = get_serial_no(args)
2022-03-28 13:22:46 +00:00
return {"serial_no": serial_no}
@frappe.whitelist()
2022-03-28 13:22:46 +00:00
def get_bin_details_and_serial_nos(
item_code, warehouse, has_batch_no=None, stock_qty=None, serial_no=None
):
bin_details_and_serial_nos = {}
bin_details_and_serial_nos.update(get_bin_details(item_code, warehouse))
if flt(stock_qty) > 0:
if has_batch_no:
2022-03-28 13:22:46 +00:00
args = frappe._dict({"item_code": item_code, "warehouse": warehouse, "stock_qty": stock_qty})
serial_no = get_serial_no(args)
2022-03-28 13:22:46 +00:00
bin_details_and_serial_nos.update({"serial_no": serial_no})
return bin_details_and_serial_nos
2022-03-28 13:22:46 +00:00
bin_details_and_serial_nos.update(
get_serial_no_details(item_code, warehouse, stock_qty, serial_no)
)
return bin_details_and_serial_nos
2014-07-01 12:15:15 +00:00
2022-03-28 13:22:46 +00:00
@frappe.whitelist()
def get_batch_qty_and_serial_no(batch_no, stock_qty, warehouse, item_code, has_serial_no):
batch_qty_and_serial_no = {}
batch_qty_and_serial_no.update(get_batch_qty(batch_no, warehouse, item_code))
2022-03-28 13:22:46 +00:00
if (flt(batch_qty_and_serial_no.get("actual_batch_qty")) >= flt(stock_qty)) and has_serial_no:
args = frappe._dict(
{"item_code": item_code, "warehouse": warehouse, "stock_qty": stock_qty, "batch_no": batch_no}
)
serial_no = get_serial_no(args)
2022-03-28 13:22:46 +00:00
batch_qty_and_serial_no.update({"serial_no": serial_no})
return batch_qty_and_serial_no
2022-03-28 13:22:46 +00:00
2015-03-10 09:49:29 +00:00
@frappe.whitelist()
def get_batch_qty(batch_no, warehouse, item_code):
from erpnext.stock.doctype.batch import batch
2022-03-28 13:22:46 +00:00
if batch_no:
2022-03-28 13:22:46 +00:00
return {"actual_batch_qty": batch.get_batch_qty(batch_no, warehouse)}
2014-07-01 12:15:15 +00:00
@frappe.whitelist()
def apply_price_list(args, as_doc=False):
"""Apply pricelist on a document-like dict object and return as
{'parent': dict, 'children': list}
:param args: See below
:param as_doc: Updates value in the passed dict
2022-03-28 13:22:46 +00:00
args = {
"doctype": "",
"name": "",
"items": [{"doctype": "", "name": "", "item_code": "", "brand": "", "item_group": ""}, ...],
"conversion_rate": 1.0,
"selling_price_list": None,
"price_list_currency": None,
"price_list_uom_dependant": None,
"plc_conversion_rate": 1.0,
"doctype": "",
"name": "",
"supplier": None,
"transaction_date": None,
"conversion_rate": 1.0,
"buying_price_list": None,
"ignore_pricing_rule": 0/1
}
2014-07-01 12:15:15 +00:00
"""
args = process_args(args)
parent = get_price_list_currency_and_exchange_rate(args)
args.update(parent)
2014-07-01 12:15:15 +00:00
children = []
if "items" in args:
item_list = args.get("items")
2014-07-01 12:15:15 +00:00
args.update(parent)
for item in item_list:
args_copy = frappe._dict(args.copy())
args_copy.update(item)
item_details = apply_price_list_on_item(args_copy)
children.append(item_details)
if as_doc:
2022-03-28 13:22:46 +00:00
args.price_list_currency = (parent.price_list_currency,)
args.plc_conversion_rate = parent.plc_conversion_rate
2022-03-28 13:22:46 +00:00
if args.get("items"):
for i, item in enumerate(args.get("items")):
for fieldname in children[i]:
# if the field exists in the original doc
# update the value
if fieldname in item and fieldname not in ("name", "doctype"):
item[fieldname] = children[i][fieldname]
return args
else:
2022-03-28 13:22:46 +00:00
return {"parent": parent, "children": children}
2014-07-01 12:15:15 +00:00
def apply_price_list_on_item(args):
2022-03-28 13:22:46 +00:00
item_doc = frappe.db.get_value("Item", args.item_code, ["name", "variant_of"], as_dict=1)
item_details = get_price_list_rate(args, item_doc)
item_details.update(get_pricing_rule_for_item(args))
2014-07-01 12:15:15 +00:00
return item_details
2022-03-28 13:22:46 +00:00
2014-07-01 12:15:15 +00:00
def get_price_list_currency_and_exchange_rate(args):
if not args.price_list:
return {}
2022-03-28 13:22:46 +00:00
if args.doctype in ["Quotation", "Sales Order", "Delivery Note", "Sales Invoice"]:
args.update({"exchange_rate": "for_selling"})
2022-03-28 13:22:46 +00:00
elif args.doctype in ["Purchase Order", "Purchase Receipt", "Purchase Invoice"]:
args.update({"exchange_rate": "for_buying"})
price_list_details = get_price_list_details(args.price_list)
price_list_currency = price_list_details.get("currency")
price_list_uom_dependant = price_list_details.get("price_list_uom_dependant")
2014-07-01 12:15:15 +00:00
plc_conversion_rate = args.plc_conversion_rate
company_currency = get_company_currency(args.company)
2014-07-01 12:15:15 +00:00
2022-03-28 13:22:46 +00:00
if (not plc_conversion_rate) or (
price_list_currency
and args.price_list_currency
and price_list_currency != args.price_list_currency
):
# cksgb 19/09/2016: added args.transaction_date as posting_date argument for get_exchange_rate
plc_conversion_rate = (
get_exchange_rate(
price_list_currency, company_currency, args.transaction_date, args.exchange_rate
)
or plc_conversion_rate
)
return frappe._dict(
{
"price_list_currency": price_list_currency,
"price_list_uom_dependant": price_list_uom_dependant,
"plc_conversion_rate": plc_conversion_rate or 1,
}
)
2014-07-01 12:15:15 +00:00
@frappe.whitelist()
def get_default_bom(item_code=None):
def _get_bom(item):
bom = frappe.get_all(
"BOM", dict(item=item, is_active=True, is_default=True, docstatus=1), limit=1
2022-03-28 13:22:46 +00:00
)
return bom[0].name if bom else None
if not item_code:
return
bom_name = _get_bom(item_code)
template_item = frappe.db.get_value("Item", item_code, "variant_of")
if not bom_name and template_item:
bom_name = _get_bom(template_item)
return bom_name
2016-04-22 11:52:22 +00:00
2022-03-28 13:22:46 +00:00
@frappe.whitelist()
2018-05-04 10:32:38 +00:00
def get_valuation_rate(item_code, company, warehouse=None):
2018-05-04 11:19:33 +00:00
item = get_item_defaults(item_code, company)
item_group = get_item_group_defaults(item_code, company)
brand = get_brand_defaults(item_code, company)
2018-05-04 10:32:38 +00:00
# item = frappe.get_doc("Item", item_code)
2018-05-16 10:20:17 +00:00
if item.get("is_stock_item"):
if not warehouse:
2022-03-28 13:22:46 +00:00
warehouse = (
item.get("default_warehouse")
or item_group.get("default_warehouse")
or brand.get("default_warehouse")
)
2016-04-22 11:52:22 +00:00
2022-03-28 13:22:46 +00:00
return frappe.db.get_value(
"Bin", {"item_code": item_code, "warehouse": warehouse}, ["valuation_rate"], as_dict=True
) or {"valuation_rate": 0}
2016-04-22 11:52:22 +00:00
2018-05-16 10:20:17 +00:00
elif not item.get("is_stock_item"):
2022-03-28 13:22:46 +00:00
valuation_rate = frappe.db.sql(
"""select sum(base_net_amount) / sum(qty*conversion_factor)
2016-04-22 11:52:22 +00:00
from `tabPurchase Invoice Item`
2022-03-28 13:22:46 +00:00
where item_code = %s and docstatus=1""",
item_code,
)
2016-04-22 11:52:22 +00:00
if valuation_rate:
return {"valuation_rate": valuation_rate[0][0] or 0.0}
else:
return {"valuation_rate": 0.0}
2016-04-22 11:52:22 +00:00
2022-03-28 13:22:46 +00:00
def get_gross_profit(out):
if out.valuation_rate:
2022-03-28 13:22:46 +00:00
out.update({"gross_profit": ((out.base_rate - out.valuation_rate) * out.stock_qty)})
2016-04-22 11:52:22 +00:00
return out
2016-01-21 10:40:22 +00:00
2022-03-28 13:22:46 +00:00
@frappe.whitelist()
def get_serial_no(args, serial_nos=None, sales_order=None):
serial_no = None
2021-11-04 14:18:32 +00:00
if isinstance(args, str):
args = json.loads(args)
args = frappe._dict(args)
2022-03-28 13:22:46 +00:00
if args.get("doctype") == "Sales Invoice" and not args.get("update_stock"):
return ""
2022-03-28 13:22:46 +00:00
if args.get("warehouse") and args.get("stock_qty") and args.get("item_code"):
has_serial_no = frappe.get_value("Item", {"item_code": args.item_code}, "has_serial_no")
if args.get("batch_no") and has_serial_no == 1:
return get_serial_no_batchwise(args, sales_order)
elif has_serial_no == 1:
2022-03-28 13:22:46 +00:00
args = json.dumps(
{
"item_code": args.get("item_code"),
"warehouse": args.get("warehouse"),
"stock_qty": args.get("stock_qty"),
}
)
args = process_args(args)
serial_no = get_serial_nos_by_fifo(args, sales_order)
if not serial_no and serial_nos:
# For POS
serial_no = serial_nos
return serial_no
def update_party_blanket_order(args, out):
if out["against_blanket_order"]:
blanket_order_details = get_blanket_order_details(args)
if blanket_order_details:
out.update(blanket_order_details)
2022-03-28 13:22:46 +00:00
@frappe.whitelist()
def get_blanket_order_details(args):
2021-11-04 14:18:32 +00:00
if isinstance(args, str):
args = frappe._dict(json.loads(args))
blanket_order_details = None
2022-03-28 13:22:46 +00:00
condition = ""
if args.item_code:
if args.customer and args.doctype == "Sales Order":
2022-03-28 13:22:46 +00:00
condition = " and bo.customer=%(customer)s"
elif args.supplier and args.doctype == "Purchase Order":
2022-03-28 13:22:46 +00:00
condition = " and bo.supplier=%(supplier)s"
if args.blanket_order:
2022-03-28 13:22:46 +00:00
condition += " and bo.name =%(blanket_order)s"
2018-06-14 12:37:22 +00:00
if args.transaction_date:
2022-03-28 13:22:46 +00:00
condition += " and bo.to_date>=%(transaction_date)s"
2018-06-14 12:37:22 +00:00
2022-03-28 13:22:46 +00:00
blanket_order_details = frappe.db.sql(
"""
select boi.rate as blanket_order_rate, bo.name as blanket_order
from `tabBlanket Order` bo, `tabBlanket Order Item` boi
2018-06-14 12:37:22 +00:00
where bo.company=%(company)s and boi.item_code=%(item_code)s
and bo.docstatus=1 and bo.name = boi.parent {0}
2022-03-28 13:22:46 +00:00
""".format(
condition
),
args,
as_dict=True,
)
2018-06-14 12:37:22 +00:00
2022-03-28 13:22:46 +00:00
blanket_order_details = blanket_order_details[0] if blanket_order_details else ""
return blanket_order_details
2022-03-28 13:22:46 +00:00
def get_so_reservation_for_item(args):
reserved_so = None
2022-03-28 13:22:46 +00:00
if args.get("against_sales_order"):
if get_reserved_qty_for_so(args.get("against_sales_order"), args.get("item_code")):
reserved_so = args.get("against_sales_order")
elif args.get("against_sales_invoice"):
sales_order = frappe.db.sql(
"""select sales_order from `tabSales Invoice Item` where
parent=%s and item_code=%s""",
(args.get("against_sales_invoice"), args.get("item_code")),
)
if sales_order and sales_order[0]:
2022-03-28 13:22:46 +00:00
if get_reserved_qty_for_so(sales_order[0][0], args.get("item_code")):
reserved_so = sales_order[0]
elif args.get("sales_order"):
2022-03-28 13:22:46 +00:00
if get_reserved_qty_for_so(args.get("sales_order"), args.get("item_code")):
reserved_so = args.get("sales_order")
return reserved_so
2022-03-28 13:22:46 +00:00
def get_reserved_qty_for_so(sales_order, item_code):
2022-03-28 13:22:46 +00:00
reserved_qty = frappe.db.sql(
"""select sum(qty) from `tabSales Order Item`
where parent=%s and item_code=%s and ensure_delivery_based_on_produced_serial_no=1
2022-03-28 13:22:46 +00:00
""",
(sales_order, item_code),
)
if reserved_qty and reserved_qty[0][0]:
return reserved_qty[0][0]
else:
return 0