Stock Ledger

All stock actions are immutable events linked to MPL products and batches.

role

Dashboard

On-hand rows

Total quantity

Available

Expiring soon

Negative balances

Reserved

Awaiting refresh.

Stock Actions

Each action emits a ledger event and enforces MPL + traceability rules.

Receive stock

Product (MPL name)

Batch / Lot

Create new batch (national only)

Expiry date

Quantity

Issue reason

Unit (UCUM)

Source location

Receiving location

Document (optional)

Attach document (optional)

Stored in DB and linked to the event.

Transfer / Issue

From location

To location

Product (MPL name)

Batch / Lot

Quantity

Reason

Replenishment, program or emergency transfers.

Admin override Override facility lock

Override reason

Required when bypassing facility locks.

Consume / Dispense

Location

Patient token (optional)

Product (MPL name)

Batch / Lot

Quantity

Action

Link to patient Include patient reference

Encounter ID (optional)

Prescription ID (optional)

Adjust / Write-off

Location

Product

Batch / Lot

Quantity (+/-)

Reason

Supervisor note

Batch status

Action

Product (MPL name)

Batch / Lot

Stock take

Location

Product (MPL name)

Batch / Lot

Counted quantity

System quantity

Reason

Allocate / Assign (reserve)

Reserve stock for a destination without physical movement.

From location

To location (assignee)

Product (MPL name)

Batch / Lot

Quantity

Reason (optional)

Ledger (latest)

Time	Type	Location	Request	Signed by	Action
Load to view events.