Settings — User Guide
Module: Warehouse
Audience: Warehouse administrators, system administrators
Version: 1.0.0
Last updated: 2026-07-22
Overview
Warehouse → Settings is where you configure how the Warehouse module behaves before and during daily operations. Use it to set up item categories, units, pricing rules, automatic stock documents, document numbering, approval workflows, minimum stock levels, and PDF display options.
Configure settings before onboarding items and processing stock movements. Most changes save immediately (toggles) or via a Submit button on the relevant tab.
Prerequisites
- Permission: Warehouse → Settings → View (to open the page). Create, Edit, or Delete for changes, depending on the task.
- Recommended: Create at least one warehouse under Warehouse → Warehouses before setting default receipt/return warehouses.
- Administrators only: WH permissions tab and Reset data tab.
Settings navigation
- Go to Warehouse → Settings.
- Select a group from the left sidebar (for example Rule sale price, Units, Approval setting).
- Make changes on the right panel.
- For tabs with a Submit button, click it to save. Toggle/checkbox settings on Rule sale price save automatically when changed.
Default opening tab: Rule sale price.
Rule sale price
This is the largest settings area. It has horizontal sub-tabs:
Items
- Profit rate (%) — default margin applied to new items.
- Rate calculation — choose whether sale price is derived from sale rate or purchase price.
- Rounding — fractional and integer rounding rules for calculated prices.
- Barcode printing — show product name and/or price on printed barcodes.
- On total items — percentage applied across the item catalog where configured.
- Update unchecked inventory numbers (admin) — maintenance action for inventory number fields.
Receipt / delivery voucher
- Revert on delete — whether deleting a receipt/delivery reverses linked stock.
- Auto-create goods receipt — create a goods receipt when a purchase order is approved; set the default receipt warehouse.
- Require PO on receipt — goods receipt must reference a purchase order.
- Auto-create goods delivery — create delivery notes from invoices when enabled.
- Invoice cancel/uncancel — reverse or recreate delivery vouchers when invoices change status.
- Require PO on delivery, notify customer on delivery status change, hide shipping fee — operational toggles.
- Export method — FIFO is shown (fixed).
Order return
- Default warehouse for return receipts — where returned stock is received.
- Return policies — rich-text policy shown to users/customers where applicable.
Packing lists, PDF, Shipments, Serial numbers
- Packing lists — custom labels for meter, kg, and m³ measurements.
- PDF — control which columns and summaries appear on delivery and packing list PDFs.
- Shipments — show shipments on the client portal.
- Serial numbers — enable product serial-number tracking.
Item master data tabs
Use these tabs to build the structure for your item catalog:
| Tab | Purpose |
|---|---|
| Commodity type | Top-level item types |
| Commodity group | Item groups |
| Sub group | Sub-groups within a group |
| Units | Units of measure (each, box, kg, etc.) |
| Colors | Color list for variants |
Models (bodys) |
Body/model attributes |
| Sizes | Size attributes |
| Styles | Style attributes |
| Brand / Model / Series | Shown only when brand-model-series mode is enabled |
On each tab:
- Click Add to create a record (code, name, order, display, note).
- Click Edit on a row to update.
- Click Delete to remove (blocked if the value is referenced by items).
Warehouse custom fields
Link core custom fields to specific warehouses so they appear only for items in those locations.
- Open Warehouse custom fields.
- Click Add, choose the custom field and target warehouse(s).
- Submit the modal.
Inventory (minimum stock)
Set minimum quantity thresholds per item:
- Open Inventory.
- Use the search box to filter items.
- Edit quantities in the spreadsheet grid.
- Click Submit.
Use this with item list low-stock indicators.
Inventory setting (numbering)
Configure document prefixes and next numbers for:
- Goods receipt and goods delivery
- Internal delivery note
- Packing list
- Order return (receipt and delivery vouchers)
- Item SKU prefix
- Automatic lot/batch numbers (prefix and next number)
- Open Inventory setting.
- Fill or adjust prefixes and next numbers.
- Click Submit.
Tip: Set prefixes before go-live so voucher numbers follow your company format.
Approval setting
Define who must approve each document type before it posts to stock:
- Open Approval setting.
- Click New approval setting.
- Enter a name, choose the related document type (stock import, stock export, loss adjustment, internal delivery, packing list, or order return).
- Add one or more approver steps (staff member, approve or sign action).
- Submit.
Edit or delete existing rows from the table. Documents use the matching approval chain when submitted for approval.
WH permissions (admin)
Assign warehouse module permissions to individual staff beyond their role defaults.
- Open WH permissions (admin sidebar only).
- Click Add or edit an existing staff row.
- Set capabilities per warehouse feature.
Reset data (admin)
Warning: This permanently deletes all warehouse transaction data (receipts, deliveries, inventory balances, approvals, packing lists, returns, etc.). It does not remove warehouses, items, or settings master data.
Use only in test environments or during a controlled re-onboarding. Click Reset data and confirm.
Related features
| Setting | Used by |
|---|---|
| Default receipt warehouse | Auto goods receipt from purchase orders |
| Default return warehouse | Order return receipts |
| Approval chains | Stock import/export, loss adjustment, internal delivery, packing lists, returns |
| Numbering prefixes | All warehouse vouchers and SKU/lot generation |
| Item taxonomies | Items (commodities) form and filters |
| Profit rate default | New item sale price calculation |
Troubleshooting
| Problem | Likely cause | What to do |
|---|---|---|
| Cannot see Settings menu | Missing wh_setting view |
Ask admin to grant Warehouse Settings view |
| Toggles do not save | Missing edit permission | Grant Settings edit or use an admin account |
| Auto receipt not created on PO | Auto-create off or no default warehouse | Enable auto-create and select goods receipt warehouse |
| Wrong voucher prefix | Inventory setting not saved | Open Inventory setting and submit correct prefix |
| Cannot delete commodity type | Type referenced by items | Reassign or delete dependent items first |
| Approval not triggered | No approval rule for document type | Add approval setting for that related type |
| Brand/Model/Series tabs missing | Feature flag disabled | Contact administrator — ACTIVE_BRAND_MODEL_SERIES must be enabled |
Best practices
- Complete Units, Commodity group, and Commodity type before bulk item import.
- Set Inventory setting prefixes before creating the first live voucher.
- Configure Approval setting before staff submit documents for approval.
- Set default warehouses for PO receipt and order returns early.
- Avoid Reset data on production tenants; export reports first if testing cleanup.