DocsMaster data10 min read
Items & Products
Manage your product and service catalog with multi-entity pricing, volume tiers, and GL account mappings
On this page
Items are the goods and services your business sells or purchases. They form the foundation of sales, purchasing, and inventory management — connecting what you sell to the right revenue accounts, cost accounts, and pricing automatically.
Why Item Master Data Matters
Without item master data:
- You sold something for $500 — but what was it? What was the cost? Which GL accounts should be used?
With item master data:
- WIDGET-001 — Premium Wireless Earbuds: Unit price $149.99, cost $45.00, Revenue account 4000, COGS account 5000, taxable
- CONS-001 — Consulting Services: $200/hour, cost $80/hour, Revenue account 4100, Expense account 5200, tax exempt
Key Benefits
- Consistent pricing — same item, same price across all transactions
- Automated GL posting — items know their revenue and expense accounts
- Multi-entity flexibility — different entities can customize item details
- Multi-currency support — entity-specific pricing in local currencies
- Volume discounts — automatic tier-based pricing
- Complete audit trail — every change to item definitions is tracked
Multi-Entity Architecture
Items follow the Master + Entity Override pattern for maximum efficiency:
How It Works
Master Items (Organization-wide)
"WIDGET-001 - Premium Wireless Earbuds"
Visible to ALL entities by default
|
v
Entity-Specific Customizations (Sparse)
Entity 9 renames: "Premium Earbuds - EU Edition"
Entity 13 uses a different revenue account
Entity 10 adds: "MUG-EUR-001" (entity-only item)
|
v
Entity-Specific Pricing
Entity 9: EUR 129.99
Entity 13: USD 149.99
Entity 14: GBP 119.99
|
v
Effective Views (What each entity sees)
Entity 9: 15 items (1 renamed, EUR pricing)
Entity 13: 14 items (1 hidden, USD pricing)
Entity 10: 16 items (1 entity-specific addition)
Entity-Specific vs. Global Items
| Scope | Visibility | Use Case |
|---|---|---|
| Global (default) | All entities see the item | Standard products sold everywhere |
| Entity-specific | Only one entity sees the item | Regional products, local services |
Item Properties
| Property | Required | Description | Example |
|---|---|---|---|
| Item number | Yes | Unique identifier (SKU) | WIDGET-001, CONS-HR-001 |
| Item name | Yes | Display name | Premium Wireless Earbuds |
| Item type | No | Classification | revenue_product, revenue_service, expense_product, expense_service |
| Category | No | Item category | INVENTORY, SALES, SERVICES |
| Description | No | Detailed description | Bluetooth 5.0 earbuds with ANC |
| Unit of measure | No | Unit | EA (each), HR (hour), kg, lb |
| Unit price | No | Default selling price | 149.99 |
| Cost price | No | Default cost price | 45.00 |
| Is taxable | No | Taxable by default | true (default) |
| Revenue account | No | AR-side GL account | 4000 (Sales Revenue) |
| Expense account | No | AP-side GL account | 5200 (Purchases) |
| Asset account | No | Inventory GL account | 1200 (Inventory) |
| COGS account | No | Cost of goods sold account | 5000 |
| Tax code | No | Tax treatment | SALES_TAX, VAT, EXEMPT |
| Metadata | No | Custom JSON fields | {"brand": "Apple"} |
Item Types
| Item Type | Description | Has Inventory? | Example |
|---|---|---|---|
| revenue_product | Physical goods sold | Yes | Earbuds, coffee mugs |
| revenue_service | Services provided | No | Consulting, support hours |
| expense_product | Physical goods purchased | Yes | Office supplies, raw materials |
| expense_service | Services purchased | No | Contract labor, utilities |
Item Categories
| Category | Description |
|---|---|
| INVENTORY | Physical goods held for resale |
| SALES | Items sold to customers |
| SERVICES | Professional services and consulting |
| SOFTWARE | Software licenses and digital downloads |
| SUBSCRIPTION | Recurring subscription-based products |
| RAW_MATERIALS | Components for manufacturing |
| FINISHED_GOODS | Completed manufactured products |
| NON_INVENTORY | Purchases not tracked in inventory |
| LABOR | Labor and contractor services |
| SHIPPING | Shipping, freight, and delivery |
| OTHER | Miscellaneous items |
Item Numbering
Recommended structure:
[PREFIX]-[CATEGORY]-[NUMBER]
Examples:
PROD-TECH-001 (Product > Technology)
SERV-CONS-001 (Service > Consulting)
SUP-OFFICE-001 (Supplies > Office)
Simple structure:
WIDGET-001
CONS-001
Item Customization Per Entity
Entities can customize items without affecting other entities:
Rename an Item
Entity 9 sees "Premium Earbuds - EU Edition" while all other entities see the master name "Premium Wireless Earbuds."
Hide an Item
Entity 13 doesn't sell WIDGET-002, so it can be deactivated for that entity only. Other entities continue to see and use it.
Custom GL Accounts
Entity 10 uses a different revenue account for a specific item. Other entities continue using the master GL mapping.
Revert to Master
If an entity no longer needs a customization, the override can be removed and the entity reverts to seeing master values.
Item Pricing
Pricing is managed separately from the master/override pattern because prices are inherently entity-specific and support multi-currency.
Pricing Priority Chain
When determining the effective price for an item, the system checks (highest to lowest priority):
- Customer-specific price — price negotiated for a specific customer
- Promotional price — limited-time promotional pricing
- Volume tier price — quantity-based pricing tiers
- Entity-specific price — standard price for this entity and currency
- Master price — default price from the item master record
Multi-Currency Pricing
Each entity can have its own price in its functional currency:
| Entity | Currency | Unit Price | Cost Price |
|---|---|---|---|
| US Entity | USD | $149.99 | $45.00 |
| EU Entity | EUR | EUR 129.99 | EUR 39.00 |
| UK Entity | GBP | GBP 119.99 | GBP 35.00 |
Billing Models
Each price can carry billing model attributes for SaaS and subscription businesses:
| Attribute | Options | Description |
|---|---|---|
| Price type | one_time, recurring | One-time purchase vs. subscription |
| Billing interval | month, year, week, day | Recurring billing frequency |
| Interval count | 1, 3, 6, etc. | e.g., 3 for quarterly |
| Usage type | licensed, metered | Seat-based vs. consumption-based |
| Billing scheme | per_unit, tiered | Flat rate vs. graduated pricing |
An item can have both a one-time setup fee and a recurring monthly subscription price in the same currency.
Volume Pricing Tiers
Define quantity-based pricing for volume discounts:
| Tier | Quantity Range | Price | Discount |
|---|---|---|---|
| Tier 1 | 1-10 units | $100.00 | 0% |
| Tier 2 | 11-50 units | $90.00 | 10% |
| Tier 3 | 51+ units | $80.00 | 20% |
Volume tiers are entity-specific and can have effective date ranges. Tiers can be added, updated, or removed using the action-based pattern (add, update, delete).
Item Deactivation
Items can be deactivated at two levels:
- Master deactivation: Item is deactivated for the entire organization
- Entity-specific deactivation: Item is hidden from one entity while remaining active for others
Deactivated items:
- Are hidden from item selection lists
- Cannot be used on new transactions
- Remain visible on historical transactions
- Can be reactivated at any time
Bulk Import
Import items from external sources with validation and duplicate detection.
Import Process
- Data validation — field types, SKU format, GL account existence
- Duplicate detection — by item number
- Review and approval — summary before execution
Import Options
| Option | Description | Default |
|---|---|---|
| On duplicate | Skip, update, or error | Skip |
| Validate only | Dry run | No |
| Stop on error | Halt on first error | Continue |
Approval Workflows
| Operation | Approval | Lane |
|---|---|---|
| Create item | Auto-approved | Green |
| Update item | Auto or Manager approval | Green/Yellow |
| Delete item | Requires approval | Yellow |
All operations generate a complete audit trail.
Units of Measure
Standard: EA (each), DZ (dozen), HR (hour), DAY (day)
Weight: lb (pound), kg (kilogram), oz (ounce)
Volume: gal (gallon), L (liter)
The default unit of measure is EA (each) if not specified.