How Attribute Set Instance (ASI) Works in iDempiere
An Attribute Set Instance (ASI) represents the actual physical batch of a product. It stores real values like lot number and expiry date, recording what truly exists in inventory. Every traceable stock movement ultimately points to the Attribute Set Instance as the batch-level source of truth.
Role of Attribute Set Instance in the Overall Flow
The Attribute Set Instance sits at the execution layer of traceability.
In the complete lifecycle:
- Attributes describe characteristics
- Attribute Sets enforce rules
- ASIs store real batch data created during transactions
Without ASIs, traceability remains theoretical.
With ASIs, traceability becomes operational and auditable.
How an Attribute Set Instance Is Created
Attribute Set Instances are not created as master data.
They are created or selected during transactions, exactly when physical stock enters or moves within the system.
During Material Receipt, the system prompts for Attribute Set Instance creation based on Attribute Set rules:
- Lot number is auto-generated or entered
- Expiry (Guarantee) date is entered
- Instance-level attributes (such as Flavor) are applied
- The Attribute Set Instance is saved along with the received quantity
Once created, the Attribute Set Instance becomes a permanent identity for that batch.
Meaning of “Same Quality Bar”
The term same quality bar means that multiple quantities belong to the same ASI.
This is true only when all attribute values match exactly.
A same quality bar requires:
- Same Attribute Set
- Same Lot number
- Same Expiry date
- Same instance-level attribute values (e.g., Flavor)
If even one value differs, iDempiere treats the stock as a different ASI, even if the product is the same. This rule prevents quality mixing and preserves batch integrity.
How Attribute Set Instance Flows Across Transactions
Once created, the Attribute Set Instance flows unchanged across all downstream processes. The system never recalculates or modifies Attribute Set Instance data.
Across the business flow:
- Inventory movements transfer the same ASI between locators
- Customer shipments deduct stock from the exact ASI
- Invoices carry ASI details into financial records
- Reports show quantity, location, and expiry by ASI
This ensures physical stock, operational documents, and accounting always reference the same batch identity.
Attribute Set Instance Traceability and History
Each Attribute Set Instance maintains a complete transaction history.
Lower tabs in the Attribute Set Instance window show how that batch was received, moved, shipped, and invoiced.
These views answer critical questions such as:
- Where did this batch come from?
- Where is it stored now?
- Which customer received it?
- Which documents referenced it?
This makes the Attribute Set Instance a powerful audit and quality-control tool.
Purpose
The Attribute Set Instance exists to track reality, not assumptions.
It ensures that every unit of stock can be traced back to its origin and forward to its destination.
This is essential for:
- Batch recalls
- Expiry-based picking (FEFO)
- Quality investigations
- Regulatory audits
Attribute Set Instance-level control is what turns compliance requirements into standard system behavior.
Key Capabilities Enabled by Attribute Set Instance
- True batch-level inventory visibility
- Preservation of quality identity across movements
- End-to-end traceability from receipt to customer
- Accurate reporting by lot and expiry
- Seamless integration with sales and finance
Outcome
With Attribute Set Instances in place, iDempiere delivers:
- Production-grade batch traceability
- Accurate stock control by lot and expiry
- Clean alignment between inventory, operations, and accounting
- Audit-ready data without manual tracking
Attribute Set Instance completes the traceability framework by capturing what actually happens on the warehouse floor and carrying that truth across the entire system.