Units

Last updated: 31 July 2026

A unit is how you count a thing - piece, kilogram, litre, metre, hour, square metre. Units matter in OSOSS because you rarely buy and sell in the same one: you purchase a 12-piece carton and sell single pieces, you receive a 25 kg sack and sell 250 g bags. Units and their ratios let the system hold one stock balance and still speak both languages.

Menu path: Inventories > Units

Screenshot from the live OSOSS Dashboard

How units work in OSOSS

Every unit belongs to a category, and only units in the same category can convert into one another:

Within a category, the ratio is what does the arithmetic. A carton with a ratio of 12 against the base piece means one carton in equals twelve pieces of stock; selling twelve pieces empties one carton. Set the ratio wrongly and your inventory valuation and reorder points are wrong by exactly that factor, silently.

The type and selection type control how the unit behaves on documents - whether it is the base unit of its category and whether a user may pick it in the unit selector on a line.

Create a unit

1. Name the unit as your staff say it, not as a textbook says it. "Carton" beats "CTN".
2. Choose the Category. This is the one field you cannot fix later without disturbing conversions, because it defines what the unit is comparable to.
3. Set the Ratio against the base unit of that category.
4. Set the type and selection type, then save.
5. Assign units on products: a purchase unit for how you buy, and a selling unit for how you sell.

Full reference

Every option and control on this page, at a glance.

Filters (3)

• Products and stock: Category
• Status and flags: Type
• Other: Name

Form fields (4)

Category, Name, Ratio, Type

Standard list tools

Every list page in OSOSS shares these controls:

• Manage columns - the icon at the right edge of the header row: search columns, tick to show or hide, drag to reorder. Your selection persists for your user.
• Quick search - matches the page's primary field.
• Filter chips + More Filters - the chips are your defaults; More Filters exposes the full set below.
• Save Filter / Saved Filters - name a filter combination and recall it in one click; one can be your default view.
• Reset - clears filters back to defaults.
• Export All - downloads the current filtered rows with exactly the columns you have selected.
• Focus - hides the surrounding chrome for a full-width table.
• Row selection - the header checkbox selects the page or all matching rows, enabling bulk actions.
• Rows per page and page jumper - at the foot of the table.
• Custom fields - anything you define under Settings > Custom Fields appears here as both a column and a filter.

Related pages

• Products - where purchase and selling units are assigned
• Ingredients - recipes consume ingredients in a unit
• Stock Counting - how to correct a balance after a unit fix

What you can do on this page

Every action on this page, step by step. What you see depends on your role, so a control your account is not set up for simply does not appear.

Add a record

1. Click Add above the table - some pages label it New or show a + icon.
2. Complete the form. Required fields carry a red asterisk and the form will not submit until they are filled.
3. Click Save. Validation runs on submit; any field that fails shows its message directly beneath itself, and the form scrolls to the first problem.
4. You land back on the list with the new record in place.

Fields on this form: Category, Name, Ratio, Type

Edit a record

1. Open the row's actions menu at the end of the row and choose Edit, or open the record and use Edit there.
2. The form loads with current values. Change only what you need.
3. Click Save.

Open and read a record

1. Click the row, or choose View in the row's actions menu.
2. The detail page shows the record's own fields, its related documents, and the actions that apply to it in its current state.
3. Use the breadcrumb or your browser's back button to return - your filters, sort, and page position are preserved.

Export the list

1. Filter and choose your columns first - the export mirrors exactly what is on screen, not the whole table.
2. Click Export All.
3. The file downloads as a spreadsheet: one row per record, your visible columns in your order.