Opening Stock#

Opening Stock (transaction type OPN) is how you establish the starting point for inventory. Use it when:

• You are setting up Neriyam for the first time and need to record what is already in your warehouses
• You are activating a new item that had existing stock before it was created in Neriyam
• You are bringing on a new warehouse with stock transferred in from outside the system

Every stock balance in Neriyam starts from a submitted OPN entry, and everything afterwards (GRNs, SDNs, adjustments) adjusts that baseline.

Important rules#

• Inward only — opening stock can only add stock. You cannot enter a negative quantity. Use Stock Adjustment for corrections.
• Once per (item, warehouse, ownership) — you cannot post two opening stocks for the same combination. If you need to correct one, cancel and repost.
• Rate matters — the rate you enter on each line establishes the starting moving-average cost. Get it right the first time.

Creating an opening stock entry#

1. Navigate to Inventory › Opening Stock
2. Click + New Opening Stock
3. Fill in the header
4. Add line items
5. Click Save as Draft — you land on the detail page in D.
6. On the detail page, review and click Submit for Approval → S — posts to the stock ledger.

The create page only has Cancel and Save as Draft buttons; the Submit for Approval action lives on the detail page once the draft exists.

Header fields#

Line fields#

Ownership — own vs. customer#

Most opening stock entries are for your own material. Set Stock Owner = Own Stock at the header and every line represents company inventory by default.

You can also seed customer-supplied material that is already physically in your warehouse — this is a common case when onboarding Neriyam at an existing operation that already runs job work. See Recording customer-owned opening stock below.

The header Stock Owner sets the default ownership for new lines, but each line carries its own ownership tag in the line dialog. You can therefore mix own-stock and customer-stock lines on a single OPN entry — the stock ledger tracks them separately.

Recording customer-owned opening stock#

When you onboard Neriyam, customer free-issue material may already be in your warehouse. To preserve the ownership audit trail from day one:

1. Create a new Opening Stock entry as usual.
2. For lines with customer-owned material, set the Ownership to Customer in the line dialog and select the customer.
3. Lines with your own stock keep the default Own Stock setting.
4. Mix both ownership types in the same entry if you want — the stock ledger records each line under its own ownership.

Without this, customer material would either be missing from inventory entirely or wrongly counted as your own.

Valuation impact#

On submit:

• Balance quantity at (item, warehouse, ownership) becomes the opening qty
• Balance average cost becomes the rate you entered
• The stock ledger records an inward entry dated to your Posting Date

Subsequent inward movements (GRNs, production) will blend into this moving average; subsequent outward movements (sales, transfers out) will consume at the current average.

Statuses#

Stock entries use a simpler lifecycle than approval-based documents:

Cancelling an opening stock#

A submitted OPN can be cancelled. Neriyam posts a reversal — an outward entry of the same qty at the same rate — so the stock ledger shows both the original posting and the reversal. Balance drops to the pre-opening state.

You can then create a fresh OPN with the correct values.

List page#

• Columns: Code/Ref, Posting Date, Item Count, Total Qty, Status
• Filter by date range and status
• Row actions: View (detail), Submit (if Draft), Cancel (if Submitted)

Permissions#

Related#

• Stock Adjustment — for corrections after opening
• Stock valuation — how opening stock seeds moving average
• Stock ownership — own vs. customer
• Stock Ledger — see the opening entry posted

FAQ#

Can I have opening stock of zero?
No — quantity must be positive. If an item has zero opening stock, simply do not create an OPN for it; its balance is zero by default.

What if I find out later that my opening rate was wrong?
You have two options: (1) cancel the OPN and repost at the correct rate — this works cleanly if no downstream transactions have happened. (2) post a Stock Adjustment to nudge the average cost up or down — this is the right answer if you have already been transacting on the item.

Can the same item appear on multiple OPN entries?
Yes — as long as they are in different warehouses or different ownership contexts. You cannot post two OPNs for the same (item, warehouse, ownership) combination.

Validation rules#

An Opening Balance entry can only be created/submitted when these rules are met:

Item requirements

• All items must be stockable (is_stockable = true).

Quantity

• Always positive — Opening Balance only seeds inventory; never depletes it.

Ownership

• Per line: own or a specific customer. See Stock Ownership.

No prior history

• An OPN can only be posted for an item + warehouse + owner combination that has no existing stock entry. If any prior entry exists, use Stock Adjustment instead.

Approval state

• All items and customers must be Approved to be selectable.

If a rule is violated, submission fails with a specific error naming the line and the problem.