IMS Documentation

Settings

The Settings menu opens the System Settings window, which contains company-wide IMS configuration for company identity, country/time zone, maintenance mode, locations, update-server access, email, Star Rewards, phone operators and transaction rules.

Open the screenSystem → Settings.
IMS System Settings screen showing general settings, phone operators, update and email settings, Star Rewards and transaction settings
System Settings contains company-wide configuration. Most settings are read-only until Edit is selected.
Administrative configurationChanges made here affect business-wide IMS behavior. Review transaction, loyalty, tax, email and maintenance settings carefully before saving.

General Settings

SettingPurpose
Company Name / Arabic NameThe company names stored in the IMS system settings.
Default CountryThe default country used by IMS configuration. Country selection also helps IMS select an appropriate time zone.
Time ZoneThe PostgreSQL time-zone name used by IMS. The current abbreviation and UTC offset are shown beside it.
Maintenance ModeSet the system on maintenance mode (READ ONLY) places IMS in its maintenance/read-only operating state.
Company LogoThe company image stored in IMS and available to the application where company branding is used.
Manage LocationsOpens the Locations maintenance screen for logical Store groupings.

Country choices come from the IMS country table. Time-zone choices come from PostgreSQL's time-zone catalog, and IMS displays the selected zone's abbreviation and UTC offset.

Company Logo

Change Image accepts JPG, JPEG, GIF or BMP images. IMS resizes the image to 400 × 300 and, when necessary, compresses it before storing it. The stored image must remain within the application's image-size limit. Delete Image removes the stored company logo after confirmation.

Manage Locations

Click Manage Locations to maintain named logical Locations and associate Stores with each Location. This is separate from the Store master itself: a Location is a grouping layer that can contain one or more Stores.

IMS Locations screen showing named locations and the stores assigned to a selected location
The Locations screen maintains a Location ID/Name and the Stores assigned to that grouping.

The Locations screen provides New, Edit and Delete actions. The Stores area uses + and - controls to maintain the Stores belonging to the selected Location.

Update Server

FieldPurpose
URLServer/location configured for IMS application updates.
Login NameAccount used to access the configured update location.
PasswordPassword associated with the update-server account; masked on screen.

IMS encrypts the configured Update Server URL, login and password before saving them in System Settings.

Email Server Settings

SettingPurpose
SMTP ServerOutgoing mail server used by IMS email functions.
SMTP PortSMTP server port.
User Name / PasswordSMTP authentication credentials. The password is masked on screen.
Enable SSLEnables the SSL/TLS option used by the configured SMTP connection.
Auto send sales receiptsEnables the system setting for automatic email delivery of sales receipts.

Star Rewards Settings

This area controls the company-wide Star Rewards/Loyalty configuration.

SettingPurpose
Enable Star Rewards ModuleTurns the Star Rewards functionality on or off.
Earn Per 1 KWDNumber of loyalty points earned for one unit of the configured earning amount.
Point ValueRedemption value of one point in the local currency.
Minimum Redeem AmountMinimum local-currency amount that can be redeemed.
Require App. OTP to redeemRequires the application's OTP verification for redemption.
Suspend points for refund allowance timeControls whether earned points are held during the permitted refund period.
Enable Loyalty tier systemEnables loyalty tiers.
Prevent downgrading client's tier reachedKeeps a customer's reached tier from being reduced if tier policies later change.
Points Expire afterNumber of days after which points expire; the screen indicates 0 for never expire.
Calculate points for non-registered customersAllows points to be calculated for customers who are not registered.
Expires AfterExpiry period for points calculated for non-registered customers; 0 means never expire.

When Star Rewards is enabled, IMS requires valid non-zero earning, point-value and minimum-redemption values before System Settings can be saved.

Phone Operators

Phone Operators maintains the mobile/telephone operator definitions used by IMS phone-number handling.

FieldPurpose
Op. IDIMS operator identifier.
Op. NameOperator/company name.
Num. LengthExpected phone-number length for the operator.
CodeOne or more starting/prefix codes associated with the operator.

Use the operator +/- controls to add or remove operators. Edit allows the Name, Number Length and starting Codes to be changed. A new operator requires a Name, Number Length and at least one Code.

Transaction Settings

SettingBusiness effect
Cashier Policy IDGroup Policy ID attached to user accounts automatically created through the Sales Men/Ladies module.
Reject refunds after N day(s)Defines the company refund-grace period used by the sales workflow.
Trans. Reply To MailReply-To email address used by transaction-related email. IMS validates the address format when supplied.
Redeem multiple vouchers in single sales transactionAllows more than one voucher to be redeemed in one sale.
Auto save Stock Transfer while adding itemsEnables the Stock Transfer staging/autosave behavior while items are being added; the transfer is not applied until the user saves it.
Enable exchange sizesEnables the exchange-size workflow.
Exchange sizes based on item colorRestricts/organizes exchange sizes using the item's color when that option is enabled.
Enable Value-Added TaxEnables VAT processing for the current company. When selected, Account No., Percentage and Round become editable.
VAT Account No.Company VAT account number. IMS requires this value when VAT is enabled.
VAT PercentageVAT rate displayed as a percentage. A zero saved percentage disables VAT.
VAT RoundSales VAT rounding increment. Values greater than zero round the extracted VAT amount to the configured increment.
Global Exchange and Refund PolicyCompany-wide return/exchange policy text used as the default policy for Stores that are not configured to force their own custom policy.
Manage Star Cards ProfilesOpens the Special Cards Profiles setup screen.

When System Settings is saved, IMS applies the Global Exchange and Refund Policy to all active Stores whose Force Custom Policy option is not enabled. Stores that force a custom policy keep their own policy text.

VAT behavior

VAT configuration starts here. After VAT is enabled, the Purchase VAT / Tax Codes panel becomes available in Financial → Integration Setup, VAT Information becomes visible in Manage → Suppliers, and VAT/tax fields become available in Inventory → Purchases.

Sales treats the configured VAT rate as tax included in the receipt amount and separates the amount into VAT Base and VAT Amount. Receipt-based returns use the original sale's VAT context so a later settings change does not redefine the VAT that belonged to the original invoice.

Save validationIMS will not save System Settings with VAT enabled and a blank VAT Account No. If Percentage is saved as zero, the VAT-enabled state is cleared.

For the complete setup sequence, see VAT & Tax Configuration.

Edit and Save

  1. Open System → Settings.
  2. Click Edit to unlock the editable company-wide settings.
  3. Make the required changes.
  4. Review the transaction, loyalty, email and maintenance options carefully.
  5. Click Save.

IMS records a Modified System settings entry in the activity log after the main System Settings record is saved.

Cancel without savingWhile editing, the Close button changes to Cancel. Cancel returns the form to view mode and reloads the stored settings.