Skip to main content

Product

The Product is the operational catalogue record: name, price, cost, commercial capabilities, classification, and tax. From the list you create, filter, and group; from the record page you manage the details and the child tabs until posting.

Path: Side menu → Product Catalogue → Products
List: /Entities/CAT/Product
Create: /Entities/CAT/Product/new
Record: /Entities/CAT/Product/{id}

What this screen does​

  • Shows products by name, status, unit price, and unit cost
  • Lets you filter by type and status, and group by type / status / category / market unit / tax rate
  • Supports card view and a DlgView preview without opening the full record
  • Links the product to units of measure, deliverables, inventories, and bundles after creation

List columns​

ColumnMeaning
nameName with a thumbnail and a link to the record
entityStatusNameRecord status
unitPrice_valUnit price (selling)
unitCost_valUnit cost (purchasing)
actionsPreview / edit / delete

Filters: search by name; Product.EntityTypeId; Product.EntityStatusId.

Views: List | Cards | Tree (grouping).

Grouping: EntityTypeId, EntityStatusId, ProductCategoryId, MarketUnitId, TaxRateId.

Card view​

Each card shows the image / status badge, the title, category · market unit, price, and edit / delete actions. Selecting a card opens /Entities/CAT/Product/{id}. Pagination: 12 / 24 / 36.

DlgView preview​

The eye icon opens a read-only preview dialog showing: both names, status, ID, SKU, PN, price / cost, classification, unit of measure, capability flags, and description, with a button to open the product.

Required fields​

FieldUse
nameName in English
nameArName in Arabic

Optional fields​

FieldUse
pNExternal part number (PN)
sKUNoInternal identifier (SKU)
uOMIdBase unit of measure
marketUnitId → productCategoryId → brandId → brandModelIdCascading classification; clearing a parent clears its children
taxRateIdTax rate
tradingTypeIdTrading type
deliveryProofIdProof of delivery
billingFrequencyIdBilling frequency
reOrderLimit_decRe-order limit (≥ 0)
unitPrice_val / unitCost_valUnit price and unit cost
descriptionSales / descriptionPurchaseSales / purchase description
warningSales / warningPurchaseWarning at sale / purchase
description / descriptionArGeneral description
photoUrlProduct images (entity attachments)
dataConfidentialityIdData confidentiality
entityTypeId / entityStatusIdType and status

Capabilities​

CapabilityMeaning
IsCanBeSoldCan be sold
IsCanBePurchasedCan be purchased
IsCanBeExpensedCan be expensed
IsCanBeStoredCan be stored
IsCanBeDecimalAllows decimal quantities

In the quick-create drawer, Sold / Purchased are shown; on the record details, all five capabilities are shown.

Draft → Post lifecycle​

  1. Create the product with the two required fields and save
  2. Complete the classification, prices, and capabilities
  3. Select Post through the posting dialog once the record exists
  4. On posting, fields are locked, Save / Post are hidden, and attachments become read-only
Posting locks the form

A product is considered posted when its status name (converted to lowercase) contains one of: post, مرحل, منشور, or publish. A fixed status ID is not used for the product.

Record tabs /Entities/CAT/Product/{id}​

TabContent
DetailsDetails form and Save / Post
ProductUOMsLinked units of measure: UOM + unitPrice_val / unitCost_val — create / edit / delete
DeliverablesDeliverables by name — create / edit / delete
InventoriesInventory links by name — create / edit / delete
SubProductsBundles / sub-products by name — create / edit / delete

Activities / attachments / logs​

From the extras menu on the record:

  • Activities through the shared activities component
  • Attachments
  • Logs
ProductActivity ListSub

A ProductActivity/ListSub component exists with create, edit, and delete, but it is not mounted as a tab on the current product page. The activities shown from the extras menu use the shared activities path.

How to use the screen​

  1. Open the products list
  2. Filter by type or status, or switch to cards / grouping when needed
  3. Create a product from Create New Product, or edit an existing row
  4. Fill in name and nameAr, then optionally PN / SKU, the cascading classification, and capabilities
  5. Save, then manage the child tabs (UOMs, Deliverables, Inventories, SubProducts)
  6. Post when the definition is complete, if your policy requires locking

Best Practices​

Define the unit of measure before multi-unit pricing

Link the base uOMId first, then add ProductUOM rows for additional unit prices.

Classification is cascading

In the interface you cannot select a category without a market unit selected, a brand without a category, or a model without a brand. Clear a parent with care because it clears its children.

The image locks after posting

The images component becomes read-only when the product is posted.