Product data extensions¶

The eYssen modules on this page extend the product record itself: they add a dedicated Products app menu, a rule-driven internal reference generator, a material composition, a product lifecycle stage that can gate sales and purchases, seasons, computed dimensions, product images in list views and bulk media upload. Every module is independent — install only the ones a company needs.

Products app¶

eyssen_product adds a stand-alone Products application, so product data can be maintained without going through Inventory or Sales:

Products ‣ Products and Products ‣ Product Variants;
Products ‣ Configuration ‣ Product Categories and Products ‣ Configuration ‣ Attributes; and
Products ‣ Configuration ‣ Product Families, a simple list of product families with a Name and a Description.

screenshot: inventory-product-data-products-app

menu: Products
shows: The eYssen "Products" app with its menu bar open, showing the Products, Product Variants, Reports and Configuration menus.
highlight: The app's menu bar (red frame).
data: A catalog with a few hundred products.
module: eyssen_product
notes: English UI, light theme, 1440px width, crop to the top of the page with the menu open.

Note

Product Families are currently only a list of records: no field on the product links to a family yet, so the list serves as a reference table until that link is added.

Generated internal references¶

eyssen_product_default_code generates a product’s Internal Reference from rules instead of leaving it to be typed by hand, so references stay consistent and predictable across a large catalog.

Reference rules¶

Rules live under Products ‣ Configuration ‣ Reference Rules. Each rule has a Name, a Company, a Sequence (which rule is tried first), an Active flag and a Filter Type that decides which products it applies to. A read-only Preview shows what a reference built by the rule looks like.

A rule is built from ordered lines, each contributing one part of the reference:

a fixed text part (its Chars value);
a part taken from a product attribute — with Attribute Value Field choosing between the value’s Name and its Reference Value; or
a sequence number, with a configurable Sequence Padding (number of digits, four by default) and Start Number, counted per the fields listed in the line.

screenshot: inventory-product-data-reference-rule

menu: Products ‣ Configuration ‣ Reference Rules ‣ (a rule)
shows: A reference rule form with its Name, Company, Sequence, Filter Type and the read-only Preview, and the rule lines below showing a fixed-text part, an attribute part and a sequence part with its padding and start number.
highlight: The "Preview" field and the rule lines (red frames).
data: A rule producing references such as "SH-BLK-0001" from a fixed prefix, the Colour attribute and a four-digit sequence.
module: eyssen_product_default_code
notes: English UI, light theme, 1440px width, full form.

Reference values on attributes and categories¶

So that a reference stays short, an attribute value carries a separate Product Reference Value (for example BLK for the colour Black), used instead of its full name when a rule’s line is set to use the reference value. Product categories carry a Sequence for default code, which lets the sequence part of a reference be counted per category.

screenshot: inventory-product-data-attribute-reference-value

menu: Products ‣ Configuration ‣ Attributes ‣ (an attribute)
shows: An attribute's value list with the "Product Reference Value" column filled in next to each value's name.
highlight: The "Product Reference Value" column (red frame).
data: Attribute "Colour" with the values Black/BLK, White/WHT and Red/RED.
module: eyssen_product_default_code
notes: English UI, light theme, 1440px width, crop to the value list.

Material composition¶

eyssen_product_material records what a product is made of, in percentages, which is required for textile and footwear labelling among others.

The materials are maintained under Products ‣ Configuration ‣ Materials. Each material has a translatable Material Name and belongs to a Material Group (for example Upper, Lining, Sole); a group has a translatable Group Name and a Sequence that orders the groups on a product.

On the product form, one line per material records the Material Group, the Material and its Percentage. A computed Material Info summary and a rendered Material Pct breakdown make the composition easy to read and to reuse on reports.

screenshot: inventory-product-data-material

menu: Inventory ‣ Products ‣ Products ‣ (a product)
shows: The material lines of a product form, each with its Material Group, Material and Percentage, and the computed composition summary next to them.
highlight: The material lines and the computed summary (red frames).
data: A shoe with Upper 100% leather, Lining 100% textile and Sole 100% rubber.
module: eyssen_product_material
notes: English UI, light theme, 1440px width, crop to the material section.

Product stages¶

eyssen_product_stage gives every product a lifecycle Stage, and lets each stage decide what may be done with the product. This is how an unfinished product record is kept out of quotations, orders and deliveries until its data is complete.

Stages are configured under Products ‣ Configuration ‣ Product Stages. A stage has:

a translatable Name, a Sequence, a Color and an Active flag;
Required Fields and Required Attributes — what must be filled in on the product before it can reach the stage;
Groups and Users — who may move a product into the stage;
the permission switches Allow Sale Order Send, Allow Sale Order Confirm, Allow Purchase Order Send, Allow Purchase Order Confirm, Allow Stock Picking and Allow Account Move, all enabled by default; and
Create Reference, which generates the product’s internal reference (see above) when it does not have one yet.

screenshot: inventory-product-data-stage-form

menu: Products ‣ Configuration ‣ Stages ‣ (a stage)
shows: A product stage form with the Name, Sequence and Color, the Required Fields and Required Attributes lists, the Groups and Users restrictions, and the six permission switches.
highlight: The permission switches (red frame).
data: Stage "Draft" with Allow Sale Order Confirm and Allow Stock Picking disabled.
module: eyssen_product_stage
notes: English UI, light theme, 1440px width, full form.

The product’s Stage is tracked in the chatter, and a product variant inherits the stage of its template. When a document contains a product whose stage does not allow the operation, that action — sending or confirming a quotation, sending or confirming a purchase order, validating a transfer, or posting an invoice — is blocked with an error naming the product.

screenshot: inventory-product-data-stage-blocked

menu: Sales ‣ Orders ‣ Quotations ‣ (a quotation) ‣ Confirm
shows: The error raised when confirming a quotation that contains a product whose stage does not allow sales order confirmation, naming the product and its stage.
highlight: The error text (red frame).
data: One order line for a product in the "Draft" stage.
module: eyssen_product_stage
notes: English UI, light theme, 1440px width, crop to the error dialog.

Seasons¶

eyssen_product_season groups products into selling seasons. A season (Sales ‣ Configuration ‣ Szezonok) has a name, a start and an end date, a colour and the list of products that belong to it, with a counter showing how many products it contains. On the product form, a product can belong to several seasons at once.

Note

The labels of this module are currently Hungarian in the source code (Szezon, Szezon kezdete, Szezon vége, Termékek), so they appear in Hungarian regardless of the interface language until translations are added.

screenshot: inventory-product-data-seasons

menu: Products ‣ Configuration ‣ Seasons
shows: The seasons list with each season's name, start and end date and the number of products it contains, in the colours assigned to them.
highlight: None.
data: Four seasons, e.g. "SS25" and "AW25".
module: eyssen_product_season
notes: English UI, light theme, 1440px width, full list view. The field labels appear in Hungarian.

Dimensions and computed volume¶

eyssen_product_dimension computes a product’s volume from its physical dimensions instead of having it typed in. In the Dimensions group of the product’s Inventory tab, choose a Shape — cuboid, cylinder, hollow section, tube or sphere — and only the dimensions that shape needs remain visible:

length, width and height/thickness for a cuboid or a hollow section;
length and diameter for a cylinder or a tube;
diameter only for a sphere; and
a wall thickness for a hollow section or a tube.

From those, the product’s Volume and a Net Volume (the volume of the material itself, so a hollow section or tube excludes its cavity) are computed, converted into the company’s volume unit of measure through the Dimensional UoM. The module also adds the same dimension, volume and weight fields, each with its own unit of measure, to packagings.

screenshot: inventory-product-data-dimensions

menu: Inventory ‣ Products ‣ Products ‣ (a product) ‣ Inventory tab
shows: The "Dimensions" group of a product form with the "Shape" field set to "Hollow section", the length, width, height and wall thickness fields visible, and the computed Net Volume below them.
highlight: The "Shape" field and the computed "Net Volume" (red frames).
data: A steel hollow section, 6000 x 40 x 40 mm with a 2 mm wall.
module: eyssen_product_dimension
notes: English UI, light theme, 1440px width, crop to the group. Some field labels appear in Hungarian.

Important

The volume computation reads the reference length unit of the company’s volume unit of measure, which is set up by the Advanced UoM module. If those units are not configured, saving dimensions raises a validation error.

Note

The length, width, height, diameter and wall-thickness labels are currently Hungarian in the source code, as are the shape names.

Product image in list views¶

eyssen_product_list_view_image adds the product image as a small thumbnail column to the products and product variants list views, so a catalog can be scanned visually without switching to the kanban view. The column is shown by default and can be hidden from the optional-column selector.

Bulk media upload¶

product_media speeds up maintaining a product’s extra images:

an Upload Media action takes several files at once and creates one extra product image per file, named after the file;
an Set as Main Image action on an extra image swaps it with the product’s main image; and
a Delete All Extra Media action clears every extra image of a product in one step.

Note

This module targets the webshop’s product gallery. The webshop-side presentation of those images is documented with the Website application.

Bill of materials on the product form¶

eyssen_mrp_bom_on_product makes a product’s bill of materials editable directly on the product form, instead of only in the Manufacturing app. A Selected BoM field picks which bill of materials is shown, and the fields below it — Reference, BoM Type, Quantity, Unit of Measure, the component lines, the by-products, the operations, Manufacturing Readiness, Operation Type, Flexible Consumption, Operation Dependencies, Manufacturing Lead Time and Days to prepare Manufacturing Order — all edit that bill of materials in place. Buttons step through the product’s bills of materials and create a new one, and the component and by-product lists can be filled from the product catalog.