Inventory
Purpose {#purpose}
Inventory is your equipment master data — items, single units, cases, labels, and availability.
Navigation: Sidebar Inventory → /app/inventory
Permissions: inventory.read (view), inventory.manage (manage), equipment.manage (equipment without item master)
Terms: product, item, equipment {#terms-product-item-equipment}
| Level | Description | Example |
|---|---|---|
| Product | Catalog template / product family | “Martin MAC Aura XB” |
| Item | Bookable warehouse object | MAC Aura #1–#10 or “XLR 5m” (qty 50) |
| Equipment | Concrete single unit with ID | EQ-00042, status, barcode |
Bulk items have an item with a quantity; single units have one equipment record per unit with an EQ-ID.
Inventory overview {#inventory-overview}
/app/inventory — list of all items with:
- Search and filters (status, category, source)
- Open camera scanner — fills the search field
- Quick actions: Report to workshop, open detail
Create a new item {#create-a-new-item}
/app/inventory/new
| Field | Note |
|---|---|
| Name | Display name in shop and packing lists |
| Source | Own, external inventory (manual), partner |
| Tracking | Single unit or bulk item |
| Owner | For external inventory, the party (lessor) |
Item detail {#item-detail}
/app/inventory/:id — tabs for equipment list, bookings, photos, notes.
Products (catalog) {#products-catalog}
Navigation: /app/inventory/products
Products bundle master data (manufacturer, description, image) for multiple items/equipment.
-
New product:
/app/inventory/products/new -
Product detail:
/app/inventory/products/:id
Catalog PDF: /app/catalog-pdf (permission documents.catalog_pdf)
Equipment (single units) {#equipment-single-units}
/app/inventory/equipment/:equipment_id
| Information | Description |
|---|---|
| EQ-ID | Internal unique number |
| Barcode | Optional manufacturer/own barcode |
| Status | In warehouse, on job, defective, maintenance, … |
| Lifecycle timeline | Reservations, inspections, workshop, audit |
Equipment status {#equipment-status}
| Status | Meaning |
|---|---|
| In warehouse | In stock, bookable |
| On job (planned) | Reserved for order |
| On job | With customer |
| Maintenance | In workshop or inspection |
| Defective | Not usable |
| Archived | Retired |
Cases (fixed cases) {#cases-fixed-cases}
Navigation: /app/inventory/cases
Fixed cases have a predefined bill of materials.
| Action | Path |
|---|---|
| Create case |
/app/inventory/cases/new |
| Edit case |
/app/inventory/cases/:id/edit |
| Book contents (case shop) |
/app/inventory/cases/:case_id/shop |
In the case shop you define which items are in the case. When booked onto an order, the full case contents are booked.
Flexcases {#flexcases}
Navigation: /app/inventory/flexcases
Flexcases are variable cases — contents are assembled per order.
- Create flexcase template
- Assign to order
- When packing, scan as pack target
- Print contents list as PDF
Booking sets (Artikelsets) {#booking-sets-artikelsets}
Templates for common booking combinations — labeled Artikelsets in the app. See booking-sets-artikelsets.
Navigation: /app/inventory/booking-sets
Device manuals {#device-manuals}
On the item detail page (/app/inventory/:id), under Device manuals:
- Choose a PDF and Upload (PDF only; the filename appears in the list)
- To delete one, confirm Really delete manual?
Permission: inventory.manage (not available for archived items)
Uploaded manuals automatically appear in the Customer Portal for orders that include this item — no extra approval needed.
Internal download: /app/inventory/:item_id/manuals/:id
Stocktakes {#stocktakes}
Navigation: /app/inventory/stocktakes
Guided physical count with expected/actual reconciliation. Only one stocktake at a time per tenant.
- Start a new stocktake (or resume one that’s already open)
-
At
/app/inventory/stocktakes/:id/run, choose between Single and List view - Count by entering a quantity or scanning (camera / IDs, same as packing)
- Handle discrepancies: mark found, archive missing items (with a reason; blocked if still booked), adjust stock, add equipment
- Complete the stocktake (optionally skipping open lines) or cancel it
-
After completion: PDF report at
/app/inventory/stocktakes/:id/pdf
Handheld scanners use dedicated stocktake API endpoints.
Permission: viewing inventory is enough to watch; starting/changing a stocktake needs inventory.manage.
Labels {#labels}
Navigation: /app/inventory/labels
- Select item or equipment
- Choose label layout (organization-wide under pdf-and-labels)
-
Print preview →
/app/inventory/labels/print -
Print PDF (
/app/inventory/labels.pdf)
Labels typically include QR code and EQ-ID.
Barcode scan {#barcode-scan}
Navigation: /app/inventory/scan
Dedicated scan page for quick lookup:
- Scan code → item/equipment detail
- From there: report to workshop, change status
Availability calendar {#availability-calendar}
/app/inventory/calendar — shows utilization of items/equipment over time. Helpful for dispatch alongside the technik-buchen-und-verfuegbarkeit|material shop.
Archive {#archive}
/app/inventory/archive — retired or deleted items. No active booking possible.
Archived equipment does not appear in the workshop selection. If archived material is still booked on an order, the UI warns in the rental history / dispatch views.
CSV export {#csv-export}
/app/inventory/items.csv — export all items as CSV (permission inventory.read).
Report to workshop from inventory {#report-to-workshop-from-inventory}
- Open item or equipment
- Report to workshop
- Description and optional photos
- Ticket under Workshop — see Workshop & Inspections
Permission: workshop.report
Printing labels {#printing-labels}
/app/inventory/labels — print queue, label studio (editor = preview), and output:
| Option | Description |
|---|---|
| Download labels as PDF (current canvas, even without saving) | |
| Browser print — label grid on white A4 only, no app chrome | |
| Brother | Direct print to Brother PT tape (WebUSB, experimental — Chrome/Edge) |
Print queue {#print-queue}
- One search across items, equipment, cases, and flexcases
- Filter chips instead of tabs
- Queue on the left: order = PDF order; click = preview object
Label studio (Canva-like) {#label-studio-canva-like}
The editor is the preview — large central stage with auto-fit zoom:
- Canvas: real rendered content (QR, text, logo), drag & resize
- Palette & properties in the right inspector
- Output: A4 sheet (labels only, no header), single label per page, or Brother tape (12/18/24 mm)
- Templates: load, save; includes Brother presets
Sheet mode: calibrate margin, gaps, and label size in the inspector (~N labels/page).
Tour labels {#tour-labels}
- Tour fields (production, dates, checked by) apply per print job
- Queue: cases and flexcases only
- One label page per case/flexcase
Overlapping zones are highlighted and block saving until you separate them.
Common issues {#common-issues}
| Problem | Solution |
|---|---|
| Item not in shop | Check status; archived? |
| Unknown EQ-ID | Print label; add barcode to equipment |
| Incomplete case contents | Check case shop |
| Stocktake won’t start |
Is another stocktake already open? Do you have inventory.manage? |
| Manual upload failed |
PDF only; requires inventory.manage |
Last updated: November 2026