Skip to Content
ERPX Documentation — Your complete guide to the ERPX platform

Items

Go to: Inventory → Items → Item

The item master is the single most important record in Inventory. Everything else — stock ledger rows, batches, serials, bundles, BOMs, prices, purchase and sales lines — points back to an item.

What is on the Items screen

Go to: Inventory → Items

TileWhat it does
ItemCreate and maintain items
Item TypeHierarchical classification tree (Product, Consumable, Raw Material, Service, Sub Assembly)
AttributeAttributes and their values, used to build variants
Item BatchBatch records for batch-tracked items
Item BundleKit definitions for bundle parent items
Item Serial NumbersSerial records for serial-tracked items
Item Reorder LevelsPer-item, per-warehouse minimum stock levels
Reorder RulesOrganization-wide enforcement and auto-purchase-request settings

Item Type

Go to: Inventory → Items → Item Type

Item Type is a tree, so you can classify as deeply as you need — for example Kids → Boys → School Shoes or Raw Materials → Metal → Steel.

ERPX seeds five root types:

Item TypeKeyMeaning
ProductItem-ProductPhysical products for sale
ConsumableItem-ConsumableItems consumed in production
Raw MaterialItem-Raw-MaterialInputs for manufacturing
ServiceItem-ServiceNon-stock service items
Sub AssemblyItem-Sub-AssemblyIntermediate manufactured components
FieldWhat it means
NameDisplay name
KeyUnique code within the organization
DescriptionFree text
ParentPosition in the tree
Is GroupOn = classification node only
Is DisabledHides the type from new items

Service items are strictly non-stock. If an item’s type is Service, ERPX rejects the item when any of these are switched on: Stock Item, Manufacturing Item, Bundle Parent, Variants, Batch Number Tracking, Serial Number Tracking, or Subcontracted Item.


Creating an item

Open the item form

Navigate to Inventory → Items → Item and click New.

Fill in basic information

FieldWhat it means
Item CodeRequired. Unique code (e.g. TSHIRT-001)
Item NameRequired. Display name
Report NameOptional shorter name for reports; defaults to Item Name
Item TypeClassification from the Item Type tree
DescriptionLong description used on documents
HS CodeHarmonized System code, used by Export Documents
IndustryOptional industry classification
Packing TypeDefault packing type (Carton, etc.)
Parent ItemSet only for variants — points at the template item

Set the units of measurement

Every item needs at least one UOM, and exactly one must be marked Default.

FieldRule
Unit of MeasurementThe unit (pcs, kg, g, box, …)
Is DefaultExactly one row must be default. This is the stock UOM
Conversion FactorHow many stock UOM one of this unit equals. The default row must be 1

Example for a T-shirt stocked in pieces but bought in cartons of 12:

UOMIs DefaultConversion Factor
pcsYes1
cartonNo12

Add barcodes (optional)

Each barcode row needs a Barcode Type, the Barcode value, and the UOM it represents — so a carton barcode and a piece barcode can coexist on the same item.

Set the item properties

These flags decide how the item behaves everywhere else. See the table below.

Set financial defaults

FieldWhat it means
Valuation RateOpening/reference cost rate. Actual valuation is recalculated from the ledger
Standard Selling RateDefault selling price suggested on sales documents
Is TaxableWhether tax rules apply to this item by default

Configure quality inspection (optional)

FieldEffect
Inspection Required Before PurchaseBlocks GRN completion until inspection passes
Inspection Required Before DeliveryBlocks delivery until inspection passes
Inspection Required In ProcessRequires in-process inspection during manufacturing
Default QI TemplateTemplate used when an inspection is created

Save, then approve

A new item is saved as Draft. It only appears in transaction dropdowns once its status is Enabled.

Item properties — the flags that matter

FlagField labelWhat switching it on does
Stock itemIs Stock ItemThe item hits the Stock Ledger. Off = no stock is tracked
VariantsHas VariantsMarks the item as a variant template; you then generate variants from its attributes
Batch trackingHas Batch NumberEvery inward line must carry a batch; outward lines pick batches (FIFO by default)
Serial trackingHas Serial NumberEvery unit needs a serial number on receipt and on issue
Serial prefixSerial Number PrefixPrefix used when generating serial numbers
BundleIs Bundle ParentThe item is a kit header; its Item Bundle defines the components
ManufacturingIs Manufacturing ItemThe item can be produced via Work Orders / BOMs
SubcontractingSupply Raw MaterialsThe item is subcontracted; raw materials are supplied to the vendor

Batch and Serial tracking are mutually exclusive. An item’s stock identity is either batch-level or unit-level, never both. Enabling both is rejected: “An item cannot have both Batch Number Tracking and Serial Number Tracking enabled.”

Bundle parents can have only one UOM. ERPX rejects a bundle parent item with more than one unit of measurement.

Changes blocked once stock exists

ERPX protects history. Once an item has stock entries, these fields can no longer be changed:

FieldWhy it is locked
Has Batch NumberExisting ledger rows have no batch identity to migrate to
Has Serial NumberExisting units were never serialised
Is Manufacturing ItemProduction history would become inconsistent
Is Stock ItemLedger rows exist for an item that would become non-stock
Default UOM / conversion factorsEvery historical quantity was converted with the old factor

Plan these flags before the first receipt. If you got it wrong, create a new item with the correct configuration and disable the old one rather than fighting the validation.

Item status

StatusMeaning
DraftBeing set up. Not selectable on transactions
EnabledLive. Appears in all dropdowns
DisabledRetired. History is kept, no new transactions

Items awaiting approval appear on the Inventory overview under To Approve → Items.

Item view tabs

Opening an existing item shows more than the form:

TabWhat it shows
DetailsThe item master fields
InventoryCurrent stock per warehouse, with links into the ledgers
VariantsGenerated variants, when Has Variants is on
AttributesAttributes assigned to this item and their naming order
Activity / CommentsAudit timeline and discussion

Item types in practice

A sellable physical product.

FieldValue
Item TypeProduct
Is Stock ItemOn
Default UOMpcs (factor 1)
Standard Selling RateYour list price

Moves stock on GRN, Delivery Note, Stock Entry, and Transfer.

Bulk import

Use the item.csv template to load items in bulk. Its columns map directly to the fields above:

Item Code, Item Name, UoM, HS Code, Item Type, Has Variants, Has Batch Number, Industry, Packing Type, Has Serial Number, Serial Number Prefix, Parent Item, Is Stock Item, Is Manufacture Item, Color, Size, Material, Weight, Metal

The trailing columns are attribute values — supplying them on a row whose Parent Item is filled in creates that row as a variant of the template item.

Tips

  • Use a consistent item-code scheme; it is the field everyone searches by.
  • Set the stock UOM to the smallest unit you count in. Buying and selling units can be added as extra UOMs with conversion factors.
  • Do not model colour and size as separate items — use Attributes & Variants.
  • Keep Report Name short; it is what fits on printed documents.