2. Sites, locations and item master

A physical company facility. A site contains one or more storage locations.

A controlled storage address inside a site, such as a quarantine cage, receiving bay, rack or bin.

A holding area for material that has arrived but is not yet approved for use. Company setup creates Receipt Quarantine automatically; users select it during receipt rather than creating it for every shipment.

An authorised bin for usable material after independent inspection and putaway.

A separate named user role responsible for item master and planning data. The role does not perform physical receipt or quality inspection.

The authoritative catalogue definition of a part: number, description, unit, classification and applicable controls. It contains no quantity. Inventory exists only after a physical receipt posts stock into quarantine.

The sum of positive current-stock balances visible within the signed-in user’s assigned sites and clearance, including quarantine, reserved, blocked/MRB, repair and subcontractor states. It is read-only context and is not stored on the item.

Only visible UNRESTRICTED stock in an issuable container. Quarantine, reserved, blocked, MRB hold, repair, subcontractor and other controlled states are physical but are never labelled available.

A user without stock:read receives no stock facts and never sees a misleading zero. The dedicated stock-summary API enforces tenant, assigned-site and clearance scope and audits classified reads.

Use the company’s official unique part number in production; Moduvio does not require a universal prefix. Use E2E-CA- only for fictitious acceptance records so test data is easy to identify and remove.

The plain-language name users see beside the part number. It should identify the material without relying on an internal code.

How inventory quantity is counted. EA means each individual unit; KG means kilograms; M means metres; L means litres; SET means a complete set.

The information-protection level of the item record. A user must have equal or higher clearance to view it.

NATO Stock Number. Enter it only when an authorised codification process has formally assigned one; otherwise leave it blank.

The usable period from manufacture for material that expires. Leave it blank for non-expiring parts; when supplied, receipt dates drive expiry blocking and re-test controls.

Optional identifying or planning information. Do not enter information above the item’s selected classification.

The item’s governance stage. A newly created item begins in DRAFT; this is separate from physical stock state.

Use Add item for one-off entry. Save creates one non-operational DRAFT and no stock; a duplicate part number returns a conflict. Existing records are updated only through the audited Item Master edit and return to DRAFT review.

Use Programme operations → Migration for controlled bulk onboarding. An authorised migration administrator replaces the supplied E2E rows, inspects and maps headers, resolves row errors, runs a database DRY RUN and then COMMIT. Imported items are create-only and enter REVIEW_REQUIRED; existing part numbers are rejected rather than overwritten.

Detected headers can be corrected explicitly before revalidation. Errors identify sheet, row and field; unresolved mapping, invalid JSON, duplicate identifiers and database catalogue-rule failures keep DRY RUN and COMMIT unavailable.

DRY RUN records an attributable job and audit event but changes no item, vendor or stock business rows. COMMIT reruns validation and atomically creates the accepted records; any validation failure creates no partial business data.

There is no XLSX update-existing switch. This is intentional fail-closed behavior: use the audited Item Master Edit action for a controlled update, including its renewed catalogue review.

The Items sheet defines catalogue records only. Opening Stock is a separate executable sheet and count; delete its supplied example row for item-only import. Stock ledger and current balance stay zero unless valid Opening Stock rows are separately dry-run and committed.

Use Supply → Supplier management and guide 17B for versioned legal identity, sites, contacts, qualification, reviews, suspension and reinstatement. Materials Planner no longer creates, edits, approves or deletes supplier records.