IMS Documentation

Manage Items

Manage Items is the central merchandise master in IMS. It connects each Item Code to its Style/Article, Color, Size, barcode, descriptions, merchandise hierarchy, supplier and brand, demographic classifications, origin, pricing, online information and product image. These fields are reused across Sales, Inventory, Purchasing, Sell Through and Main Sales reporting.

Open the screenManage → Items
IMS Manage menu with Items selected
Path: Manage → Items.

Items Data screen

IMS Items Data screen showing Style, Item Code, merchandise classifications, prices, online details and image
Items Data combines item search, style variants, merchandise classifications, pricing, online information and the Style/Color image.

Find an item or a complete style

SearchBehavior
Style / Article → FindFinds the style and loads its Item Code / Color / Size variants into the Style grid.
Item Code → FindFinds the exact Item Code and also loads the other variants belonging to the same Style.
Style gridSelect another Item Code in the grid to switch the details panel to that Color/Size variant.
Style versus Item CodeA Style can contain many sellable Item Codes. In the normal fashion-item structure, Color and Size distinguish the variants under the Style.

Item identity and variant fields

FieldMeaning
Style / ArticleThe product style/article that groups related Color/Size Item Codes.
Color CodeThe merchandise color code.
Color NameReadable color description associated with the color code.
SizeThe item's size or size code.
Barcode / EANThe item's primary barcode.
ListOpens the additional-barcode list for the selected Item Code when secondary barcodes exist.
Theme NameOptional merchandise Theme classification used by supported item and reporting workflows.
Product URLOnline/product URL stored for the Style/Color SKU.
Image SKUIMS builds the image key as Style_ColorCode.

Main item details

FieldPurpose
Item CodeUnique IMS item identifier.
DescriptionEnglish item description.
Ar. Descrip.Arabic item description.
TypeClassifies the record as an Item or Service.
StateCurrent IMS item state, such as Normal, Sale or Outlet according to the configured item-state master.
Account No.Financial/account mapping used where the item type and financial workflow require it.

Merchandise hierarchy

The item master stores the classifications that later become criteria and Group By dimensions in IMS reports.

FieldRelationship
CategoryMain merchandise category.
Sub CategorySubcategory under the selected Category.
Product GroupMain product group.
Sub GroupSubgroup under the selected Product Group.
Rcvd. SeasonReceived-season / received statistical-period classification associated with the item.
St. PeriodStatistical/selling period displayed for the item and used by supported reporting.
SupplierSupplier master assigned to the item.
BrandBrand under the selected Supplier.
Age RangeAge classification used by merchandise analysis.
GenderGender classification used by merchandise analysis.
OriginCountry of origin.

Several classifications are hierarchical. Changing the main Category resets the Sub Category, changing Product Group resets Sub Group, and changing Supplier resets Brand so the dependent field remains consistent with its parent master.

Receipt and cost information

The lower-right receipt/cost fields provide a quick reference to the item's latest purchasing and average-cost information.

FieldMeaning
Last Rcvd DateDate of the latest recorded purchase/receipt information for the item.
Last Rcvd CurrCurrency used by the latest purchase/receipt information.
Last Rcvd CostLatest purchase price shown using that purchase currency's format.
Avg. Local CostAverage item cost shown in the IMS local-currency format.
UnitItem unit of measure.

Retail pricing

FieldMeaning
Original PriceOriginal/full retail price.
Current PriceCurrent selling price.
Current Disc %Calculated as 1 − Current Price ÷ Original Price when Original Price is greater than Current Price; otherwise 0%.

When pricing is edited, IMS keeps the item's selling state aligned with the current versus original price and updates the relevant item pricing records.

Create a new item

  1. Click New.
  2. Enter the required Item Code, Style and Barcode.
  3. Enter Color, Size and descriptions.
  4. Set Type, State and the required merchandise classifications.
  5. Assign Supplier, Brand, Age Range, Gender, Origin and Unit as applicable.
  6. Enter Original Price and Current Price.
  7. Enter Product URL when the Style/Color has an online product link.
  8. Click Save.

Before saving, IMS checks that the Item Code is unique, that the barcode is not already assigned as either a primary or secondary barcode, and that the Style/Color/Size combination is not already assigned to another Item Code.

Edit an item

  1. Find the Item Code or Style.
  2. Select the required Item Code in the Style grid.
  3. Click Edit.
  4. Change the permitted item information.
  5. Click Save, or click Cancel to restore the existing data.

The Item Code itself remains fixed when editing an existing record.

Apply changes to the entire Style

During Edit mode, Apply to Style lets a maintenance user apply appropriate changes to all Item Codes belonging to the selected Style rather than changing only one Color/Size variant.

When Apply to Style is selected, Color Name, Color Code, Barcode and Size remain variant-specific and are not edited through the style-wide operation.

OptionEffect
Apply to Style + Price OnlyApplies Original Price, Current Price and the resulting item state across the Style.
Apply to Style without Price OnlyApplies the shared style-level information after IMS asks for confirmation.

Primary and additional barcodes

Every item has a primary Barcode / EAN. IMS can also maintain additional barcodes in the secondary-barcode list. Barcode validation checks both places so the same barcode is not assigned to different Item Codes.

Item images

IMS stores product images by Image SKU = Style_ColorCode. This means all Size variants of the same Style and Color share the same image.

Change or add an image

  1. Find the item.
  2. Click Change Image.
  3. Select a JPG, JPEG, PNG, GIF, BMP or WebP file.
  4. Review the image preview.
  5. Click Save Image.

IMS automatically converts the image to JPEG, auto-orients it, removes unnecessary metadata, resizes it to fit the IMS image dimensions and compresses it to the supported storage size. A 62 × 62 thumbnail is also created for reports and other thumbnail views.

Delete an image

Click Delete Image and confirm. Deleting the image removes the Style/Color image record without deleting the item itself.

Images in reportsThe same Style/Color image maintained here is what IMS uses when Main Sales Report, Sell Through Report or Purchasing Report displays product images or exports them to Excel.

Online Details and Product URL

Online Details >> opens the selected item's online-information screen. The button is shown in green when the item is currently marked Online and red when it is not.

IMS Items Data screen with the Item's Online Details window open
Item's Online Details for the selected Item Code.

The Online Details window keeps the e-commerce-specific values that can differ from the normal IMS retail item information.

FieldPurpose
Available OnlineMarks whether the selected item is available to the online integration.
ColorOnline color value for the selected Item Code.
Original PriceOriginal online price.
Current PriceCurrent online selling price.
Current Disc %Calculated automatically from Original Price and Current Price when the original price is greater than the current price.
HandleOnline product handle associated with the selected Item Code.
Reduce Qty. byQuantity reduction value used by the online item workflow.

Edit online details

  1. Find the required Item Code and click Online Details >>.
  2. Click Edit.
  3. Update Available Online, Color, Original Price, Current Price, Handle or Reduce Qty. by as required.
  4. Click Save.
  5. IMS asks whether the change should be applied to the entire Style.
Save choiceWhat IMS updates
No — selected Item Code onlyUpdates Available Online, online Color, Original Price, Current Price, Handle and Reduce Qty. by for the selected Item Code.
Yes — entire StyleUpdates Available Online, Original Price, Current Price and Reduce Qty. by for every Item Code belonging to the Style.
Style-wide updateOnline Color and Handle remain Item-Code-specific when the update is applied to the entire Style.

After saving, IMS records the affected Item Code or Style for the online-update workflow so the change can be processed by the integration service.

The Product URL on the main Items screen is stored at the Style/Color SKU level, matching the same Style_ColorCode structure used by item images.

Delete an item

IMS protects transaction history. An item can be deleted only when it has not already been used in relevant stock, purchasing, sales, depreciation, adjustment or transfer transactions.

  1. Find the Item Code.
  2. Click Delete.
  3. Review the confirmation message.
  4. Choose Yes to delete the unused item.

If IMS finds previous transaction history, the item is retained and the user is informed that it cannot be deleted.

Bulk Import

The Import menu provides administrative bulk-maintenance tools. IMS validates the selected file before committing changes and writes a validation log when the source contains invalid data.

Import optionPurpose
Import ItemsCreates items in bulk and can optionally update existing item records. When updating existing items, Item Code, Style, Color and Size are retained.
Import Price ChangesUpdates current selling price and state in bulk. Files can target an Item Code, a complete Style, or a Style + Color combination.
Import Online PricesUpdates online original price, online current price and Online status for item/style selections used by the online integration workflow.
Import ImagesImports Style/Color images in bulk from local file paths or HTTP/HTTPS image sources.

Import Items validation

The item-data import validates field lengths and data types, duplicate Item Codes, duplicate barcodes and duplicate Style/Color/Size combinations before saving. If invalid rows are found, IMS creates a -ValidationLog.txt file beside the import source.

When the import encounters Item Codes that already exist, IMS asks whether those existing records should be updated. Identity fields such as Item Code, Style, Color and Size remain unchanged during that update.

Import Images file

The image importer expects at least two tab-separated columns:

ColumnValue
SKUThe IMS Style_ColorCode image key.
Image SrcA local image path or an HTTP/HTTPS image URL.

IMS validates duplicate SKUs, confirms that the SKU exists in the item master, compresses the image and creates both the main image and thumbnail. Failed or skipped rows are written to an import error log.

Permissions

Item maintenance and the Item toolbar follow the logged-in user's manage item data permission. Users without that maintenance permission can still use the screen as allowed by their IMS access policy, but protected New/Edit/Delete/Import and image-maintenance actions are disabled.

Where the Item classifications come from

The classification fields on Items are maintained as separate IMS masters:

Item fieldMaster
Category / Sub CategoryManage → Categories
Product Group / Sub GroupManage → Product Groups
Age RangeManage → Age Ranges
GenderManage → Genders
St. PeriodManage → Statistical Periods

Keeping these values in shared masters is what lets the same classifications be reused consistently by Main Sales, Sell Through and Purchasing reports.

Sale Seasons and current item pricing

Manage → Sale Seasons can temporarily apply a Sale price to selected Item Codes. While a Sale Season is active, IMS uses the policy's sale price as the current selling price and places the affected merchandise in the Sale item state. The Sale Season also controls whether the item should return to its original/full price when the policy ends.

Relationship with Special Offers

Manage → Special Offers can target merchandise by exact Item Code, Style or Style/Color. The offer importer resolves those values against the Item master before saving the promotion.

A normal Special Offer does not replace the Item master definition. The From Price List option stores offer-specific promotional prices separately, while Sale Seasons are the module used for scheduled item markdown prices that change the current sale price/state.

How Item master data affects reporting

Common tasks

Search

Review every size/color in a style

Find the Style and use the Style grid to switch between individual Item Codes.

Pricing

Update a complete style

Edit one variant, choose Apply to Style and use Price Only when the change should affect style pricing only.

Images

Maintain report thumbnails

Add one Style/Color image and IMS makes it available to all Size variants of that Style and Color.

Bulk maintenance

Import new merchandise

Use Import Items for validated bulk creation and Import Price Changes or Import Images for specialized updates.

Normal Items versus Service Items

This screen is intended for normal merchandise items. Non-merchandise Service Items are maintained separately in Manage → Service Items. Both belong to the IMS item master, but Service Items use a simplified definition and are identified by Type = Service.