mirror of
https://github.com/frappe/erpnext.git
synced 2026-08-22 18:59:58 +00:00
Merge pull request #56506 from frappe/chore/stock-ledger-test-coverage
test: Stock Ledger report coverage
This commit is contained in:
Nabin Hait
182
erpnext/stock/report/stock_ledger/test_stock_ledger.py
Normal file
182
erpnext/stock/report/stock_ledger/test_stock_ledger.py
Normal file
@@ -0,0 +1,182 @@
|
||||
# Copyright (c) 2026, Frappe Technologies Pvt. Ltd. and Contributors
|
||||
# See license.txt
|
||||
|
||||
import frappe
|
||||
|
||||
from erpnext.stock.doctype.item.test_item import make_item
|
||||
from erpnext.stock.doctype.stock_entry.stock_entry_utils import make_stock_entry
|
||||
from erpnext.stock.report.stock_ledger.stock_ledger import execute
|
||||
from erpnext.tests.utils import ERPNextTestSuite
|
||||
|
||||
WH = "Stores - _TC"
|
||||
WH2 = "Finished Goods - _TC"
|
||||
ITEM = "_Test Item"
|
||||
ITEM2 = "_Test Item 2"
|
||||
SERIAL_ITEM = "_Test Serialized Item With Series"
|
||||
|
||||
|
||||
class TestStockLedgerReport(ERPNextTestSuite):
|
||||
def make_batch_item(self):
|
||||
return make_item(
|
||||
properties={
|
||||
"is_stock_item": 1,
|
||||
"has_batch_no": 1,
|
||||
"create_new_batch": 1,
|
||||
"batch_number_series": "SL-BCH-.#####",
|
||||
}
|
||||
).name
|
||||
|
||||
def run_report(self, item_code, warehouse=None, **extra):
|
||||
filters = frappe._dict(
|
||||
{
|
||||
"company": "_Test Company",
|
||||
"from_date": "2026-01-01",
|
||||
"to_date": "2026-12-31",
|
||||
"valuation_field_type": "Currency",
|
||||
"item_code": [item_code] if isinstance(item_code, str) else item_code,
|
||||
**extra,
|
||||
}
|
||||
)
|
||||
if warehouse:
|
||||
filters["warehouse"] = [warehouse] if isinstance(warehouse, str) else warehouse
|
||||
return execute(filters)[1]
|
||||
|
||||
def sle_rows(self, item_code, warehouse=WH, **extra):
|
||||
# scope to the clean warehouse so the committed baseline stock of reused master
|
||||
# items (in `_Test Warehouse - _TC`) does not leak in; drop the synthetic
|
||||
# "'Opening'" row and keep only this item's ledger lines
|
||||
rows = self.run_report(item_code, warehouse=warehouse, **extra)
|
||||
return [row for row in rows if row.get("item_code") == item_code]
|
||||
|
||||
def test_receipt_shows_in_qty_and_balance(self):
|
||||
item = ITEM
|
||||
make_stock_entry(item_code=item, to_warehouse=WH, qty=10, rate=100, posting_date="2026-06-01")
|
||||
|
||||
(row,) = self.sle_rows(item)
|
||||
self.assertEqual(row["in_qty"], 10)
|
||||
self.assertEqual(row["out_qty"], 0)
|
||||
self.assertEqual(row["qty_after_transaction"], 10)
|
||||
self.assertEqual(row["incoming_rate"], 100)
|
||||
self.assertEqual(row["valuation_rate"], 100)
|
||||
self.assertEqual(row["stock_value"], 1000)
|
||||
self.assertEqual(row["stock_value_difference"], 1000)
|
||||
|
||||
def test_issue_shows_out_qty_and_outgoing_rate(self):
|
||||
item = ITEM
|
||||
make_stock_entry(item_code=item, to_warehouse=WH, qty=10, rate=100, posting_date="2026-06-01")
|
||||
make_stock_entry(item_code=item, from_warehouse=WH, qty=4, posting_date="2026-06-02")
|
||||
|
||||
issue = self.sle_rows(item)[-1]
|
||||
self.assertEqual(issue["in_qty"], 0)
|
||||
self.assertEqual(issue["out_qty"], -4)
|
||||
self.assertEqual(issue["qty_after_transaction"], 6)
|
||||
self.assertEqual(issue["in_out_rate"], 100) # stock_value_difference / actual_qty
|
||||
self.assertEqual(issue["stock_value"], 600)
|
||||
|
||||
def test_running_balance_across_transactions(self):
|
||||
item = ITEM
|
||||
make_stock_entry(item_code=item, to_warehouse=WH, qty=10, rate=100, posting_date="2026-06-01")
|
||||
make_stock_entry(item_code=item, to_warehouse=WH, qty=5, rate=100, posting_date="2026-06-02")
|
||||
make_stock_entry(item_code=item, from_warehouse=WH, qty=3, posting_date="2026-06-03")
|
||||
|
||||
balances = [row["qty_after_transaction"] for row in self.sle_rows(item)]
|
||||
self.assertEqual(balances, [10, 15, 12])
|
||||
|
||||
def test_moving_average_valuation(self):
|
||||
item = ITEM
|
||||
frappe.db.set_value("Item", item, "valuation_method", "Moving Average")
|
||||
make_stock_entry(item_code=item, to_warehouse=WH, qty=10, rate=100, posting_date="2026-06-01")
|
||||
make_stock_entry(item_code=item, to_warehouse=WH, qty=10, rate=200, posting_date="2026-06-02")
|
||||
|
||||
latest = self.sle_rows(item)[-1]
|
||||
# (10*100 + 10*200) / 20 = 150
|
||||
self.assertEqual(latest["valuation_rate"], 150)
|
||||
self.assertEqual(latest["stock_value"], 3000)
|
||||
|
||||
def test_item_code_filter_excludes_other_items(self):
|
||||
item_a = ITEM
|
||||
item_b = ITEM2
|
||||
make_stock_entry(item_code=item_a, to_warehouse=WH, qty=10, rate=100, posting_date="2026-06-01")
|
||||
make_stock_entry(item_code=item_b, to_warehouse=WH, qty=7, rate=100, posting_date="2026-06-01")
|
||||
|
||||
item_codes = {row["item_code"] for row in self.run_report(item_a)}
|
||||
self.assertEqual(item_codes, {item_a})
|
||||
|
||||
def test_warehouse_filter(self):
|
||||
item = ITEM
|
||||
make_stock_entry(item_code=item, to_warehouse=WH, qty=10, rate=100, posting_date="2026-06-01")
|
||||
make_stock_entry(item_code=item, to_warehouse=WH2, qty=5, rate=100, posting_date="2026-06-01")
|
||||
|
||||
warehouses = {row["warehouse"] for row in self.sle_rows(item, warehouse=WH2)}
|
||||
self.assertEqual(warehouses, {WH2})
|
||||
|
||||
def test_voucher_no_filter(self):
|
||||
item = ITEM
|
||||
se = make_stock_entry(item_code=item, to_warehouse=WH, qty=10, rate=100, posting_date="2026-06-01")
|
||||
make_stock_entry(item_code=item, to_warehouse=WH, qty=5, rate=100, posting_date="2026-06-02")
|
||||
|
||||
rows = self.sle_rows(item, voucher_no=se.name)
|
||||
self.assertEqual(len(rows), 1)
|
||||
self.assertEqual(rows[0]["voucher_no"], se.name)
|
||||
|
||||
def test_date_range_excludes_out_of_range_entries(self):
|
||||
item = ITEM
|
||||
se = make_stock_entry(item_code=item, to_warehouse=WH, qty=10, rate=100, posting_date="2025-12-01")
|
||||
|
||||
# 2026 window must not include the 2025 entry
|
||||
self.assertEqual(self.sle_rows(item), [])
|
||||
# widening the window back to 2025 brings it in
|
||||
in_window = self.run_report(item, from_date="2025-01-01", to_date="2025-12-31")
|
||||
self.assertIn(se.name, {row.get("voucher_no") for row in in_window})
|
||||
|
||||
def test_opening_balance_row(self):
|
||||
item = ITEM
|
||||
# stock received before the reporting window should surface as the opening balance
|
||||
make_stock_entry(item_code=item, to_warehouse=WH, qty=10, rate=100, posting_date="2025-12-01")
|
||||
|
||||
data = self.run_report(item, warehouse=WH)
|
||||
opening = data[0]
|
||||
self.assertEqual(opening["item_code"], "'Opening'")
|
||||
self.assertEqual(opening["qty_after_transaction"], 10)
|
||||
self.assertEqual(opening["stock_value"], 1000)
|
||||
|
||||
def test_bundle_not_segregated_by_default(self):
|
||||
item = SERIAL_ITEM
|
||||
# a single receipt of 3 serials is one ledger line when the filter is off
|
||||
make_stock_entry(item_code=item, to_warehouse=WH, qty=3, rate=100, posting_date="2026-06-01")
|
||||
|
||||
(row,) = self.sle_rows(item)
|
||||
self.assertEqual(row["in_qty"], 3)
|
||||
self.assertEqual(row["qty_after_transaction"], 3)
|
||||
|
||||
def test_serial_bundle_segregated_into_per_serial_rows(self):
|
||||
item = SERIAL_ITEM
|
||||
make_stock_entry(item_code=item, to_warehouse=WH, qty=3, rate=100, posting_date="2026-06-01")
|
||||
|
||||
rows = self.sle_rows(item, segregate_serial_batch_bundle=1)
|
||||
# the one receipt is split into one row per serial number
|
||||
self.assertEqual(len(rows), 3)
|
||||
self.assertTrue(all(row["in_qty"] == 1 for row in rows))
|
||||
self.assertEqual(len({row["serial_no"] for row in rows}), 3)
|
||||
# running balance accumulates across the segregated rows
|
||||
self.assertEqual([row["qty_after_transaction"] for row in rows], [1, 2, 3])
|
||||
|
||||
def test_segregated_issue_rows_show_out_qty_per_serial(self):
|
||||
item = SERIAL_ITEM
|
||||
make_stock_entry(item_code=item, to_warehouse=WH, qty=3, rate=100, posting_date="2026-06-01")
|
||||
make_stock_entry(item_code=item, from_warehouse=WH, qty=2, posting_date="2026-06-02")
|
||||
|
||||
rows = self.sle_rows(item, segregate_serial_batch_bundle=1)
|
||||
issue_rows = [row for row in rows if row["out_qty"]]
|
||||
self.assertEqual(len(issue_rows), 2)
|
||||
self.assertTrue(all(row["out_qty"] == -1 for row in issue_rows))
|
||||
self.assertTrue(all(row["in_out_rate"] == 100 for row in issue_rows))
|
||||
|
||||
def test_batch_bundle_segregated_shows_batch_no(self):
|
||||
item = self.make_batch_item()
|
||||
make_stock_entry(item_code=item, to_warehouse=WH, qty=10, rate=100, posting_date="2026-06-01")
|
||||
|
||||
(row,) = self.sle_rows(item, segregate_serial_batch_bundle=1)
|
||||
self.assertTrue(row["batch_no"])
|
||||
self.assertEqual(row["in_qty"], 10)
|
||||
self.assertEqual(row["qty_after_transaction"], 10)
|
||||
Reference in New Issue
Block a user