PMIS Website Glass Crates — User Manual
Slovenski priročnik · Module overview
This manual covers pmis_website_glass_crate for Odoo 18 Community: configuration,
customer composition, sales approval, pricing, regional delivery planning,
warehouse packing, returns, and packing lists. Standard Odoo checkout, payment,
invoicing, and inventory processes continue to apply.
Screenshots use an isolated disposable database containing synthetic companies, customers, products, inventory, and orders. Example names, references, dates, prices, and capacities are illustrative. Interface labels follow the English interface; menu availability also depends on your access rights and installed apps.
Contents
- Concepts and responsibilities
- Initial configuration
- Delivery configuration
- Customer workflow
- Quotation approval and checkout
- Salesperson workflow
- Prices, surcharge, and invoicing
- Warehouse workflow and returns
- Packing lists
- Troubleshooting and operating limits
1. Concepts and responsibilities
A virtual crate records the loading composition of glass belonging to one sales order. A row is one loading position containing a whole number of sheets of one product variant. The same product can occupy several positions and crates. The sales order aggregates the corresponding area in square meters for pricing, stock movements, and invoicing. A physical package is created later during warehouse packing; creating a virtual crate does not create a package.
| Role | Main responsibilities |
|---|---|
| Website administrator with Settings rights | Configure the website catalog, units, measurement axes, capacities, checkout policy, and scheduling switch. |
| Product administrator | Publish eligible products, assign website categories, maintain conversions, dimensions, weights, and stock policy. |
| Salesperson | Compose crates on accessible quotations, review requests, approve or reopen compositions, and confirm orders. |
| Sales manager | Maintain company delivery regions, trucks, weekly schedules, and dated capacities. |
| Warehouse user | Assign loading positions to detailed operations, pack, deliver, and attribute returns. |
| Authenticated customer | Compose and view their own website orders, request quotations, choose delivery dates, and print packing lists. |
Company and normal sales-order access rules still apply. A customer must sign in; the configurator is not an anonymous shopping tool. Portal changes use the customer workflow rather than unrestricted editing of crate records.
Example used throughout this manual
Each example sheet measures 2,000 × 3,000 mm and converts to 6 m² per sheet. The fixed crate capacity is 120 mm depth × 2,500 mm height × 3,500 mm length.
| Crate | Position | Article | Sheets | Area | Occupied depth |
|---|---|---|---|---|---|
| First | 1 | V\|CLEAR-06, clear 6 mm |
4 | 24 m² | 24 mm |
| First | 2 | V\|CLEAR-08, clear 8 mm |
2 | 12 m² | 16 mm |
| First | 3 | V\|CLEAR-06, clear 6 mm |
1 | 6 m² | 6 mm |
| Second | 1 | V\|GREY-06, grey 6 mm |
2 | 12 m² | 12 mm |
The first crate contains seven sheets, 42 m², and 46 mm of glass depth. Its numbering is 1–4, 5, 6, and 7. Both clear 6 mm rows share the sales quantity of 30 m² while retaining separate loading positions.
2. Initial configuration
2.1 Install prerequisites and assign access
An administrator installs PMIS Website Glass Crates. Its dependencies are
website_sale_stock, pmis_product_multi_website,
pmis_deliverable_logistic_unit, product_dimension, and pmis_energy_surcharge.
Installation does not configure your catalog, square-meter unit, physical crate
sizes, customer regions, or truck fleet.
Give staff the relevant Sales, Inventory, and administration rights. Delivery configuration requires Sales manager access; ordinary sales and warehouse users can read that configuration. Use the correct active company before configuring company-specific records or customer delivery regions.
2.2 Configure the website
Open the website record through Website → Configuration → Websites and its Glass Crates section. Settings administration rights are required for this section. Enable developer mode to expose the standard Websites menu when needed, or ask the website administrator to open the website record.

| Setting | How to use it |
|---|---|
| Default Order Warehouse | Select a warehouse belonging to the website company. New website orders use it; existing orders keep their own warehouse. Empty retains the standard sales default. |
| All Website Categories | Enabled by default. Include categories explicitly assigned to this website through either website assignment field. Each child needs its own assignment. |
| Glass Crate Category | When All Website Categories is off, select an assigned parent category to restrict the catalog to that branch. |
| Website Category Filter | Optional parent for subcategory choices in the product picker. The parent itself is omitted. Empty lists eligible assigned subcategories throughout the configured scope. |
| Glass Crate Square-Meter UoM | Select the existing square-meter unit used exactly by the products' sales unit. |
| Glass Thickness Source | Normally Product Width. |
| Glass Height Source | Normally Product Height; represents upright sheet height. |
| Glass Length Source | Normally Product Length. All three measurement sources must differ. |
| Fixed Crate Depth / Height / Length (mm) | Enter positive usable capacities, in millimeters. These are copied into new crates. |
| Allow Direct Glass Crate Checkout | Off by default. Enable only if editable draft compositions may continue without prior sales approval. |
| Schedule Crate Deliveries | Require a regional truck delivery date for every crate before sales order confirmation. Crates and quotations can be submitted without dates. Configure deliveries first. |
With All Website Categories enabled, assigning a parent does not automatically expose an unassigned child. Hidden or other-site categories are excluded. With a restricted category branch, descendant products must still satisfy the publication, website, company, unit, and product eligibility rules. The picker shows only assigned subcategories within its filter scope; root categories are not options or labels. A category can be listed even when it currently contains no eligible articles.
2.3 Set units and precision
Use an active square-meter unit whose conversion factor is 1 and whose English
name is m2, m², Square Meter, or Square Meters (case-insensitive).
An existing legacy area category is supported. Do not select a sheet unit as the
sales unit. Configure Product Unit of Measure decimal precision to support
the unit's rounding; for rounding 0.001, use at least 3 decimal places.
The standard unit and precision administration screens may require developer mode.
2.4 Prepare each product variant
Open the product from Sales → Products → Products. Maintain variant-specific values where the product has variants.
- Use an active, sellable Goods product and enable Usable in Crates.
- Publish it and assign it to the intended website and eligible eCommerce category.
- Set the sales unit to exactly the website's configured square-meter unit.
- Set Alternate Logistic UoM conversion to square meters per sheet. In the example it is 6. The configurator uses this factor, not height × length, as the authoritative sales conversion.
- Set Dimensional UoM to a length unit and enter positive length, width, and height. With meters, enter width 0.006, height 2, length 3 for the clear 6 mm article. The configurator converts these to millimeters.
- Use an internal reference beginning with
V|for portal code entry and picker selection, for exampleV|CLEAR-06. - For tracked availability, enable inventory tracking, provide stock in the order warehouse, and review the normal out-of-stock ordering policy.
- Maintain the product's sales price, category surcharge eligibility, and weight. For square-meter sales, weight must be consistent with one square meter.

In the product list, select several products and use Enable Glass Crates or Disable Glass Crates from the actions menu. The Usable in Crates search filter and optional list column help audit eligibility. Disabling eligibility prevents future selection and may require replacing that article in an unfinished composition before submission; it does not erase saved order history.
2.5 Configure the energy surcharge
Use PMIS Energy Surcharge configuration to set the company's default surcharge product, eligible product categories, exclusions, and weights. The crate module prices one automatic surcharge product line using the order's pricelist.
For the example, glass weight is 15 kg/m² for 6 mm and 20 kg/m² for 8 mm. The total eligible weight is 870 kg. A surcharge price of €0.12/kg produces €104.40 net. These are illustrative commercial values, not recommended rates. A weight-unit surcharge product converts from the system weight unit; other units follow the dependency's weight-as-quantity convention.
Missing surcharge configuration or zero/invalid eligible weight prevents a composition change from saving. Orders without eligible lines do not need a surcharge product and have no generated surcharge line.
2.6 References and languages
Crates receive automatic references such as CRATE/000002; users cannot rename
them. The shared sequence uses code pmis.glass.crate. An administrator may
configure a company-specific sequence with that code to override the shared
sequence for that company. Its counter survives module updates.
Activate required Odoo languages and enable them on the website. The module includes Slovenian, Italian, Croatian, and Serbian (Latin) translations. Users select the website language; staff select their interface language in preferences.
3. Delivery configuration
Skip truck setup if you do not use regional scheduling and leave Schedule Crate Deliveries off. When enabled, missing regional configuration prevents customers from completing the crate request.
3.1 Regions and customers
- As a Sales manager, open Sales → Crate Deliveries → Delivery Regions.
- Create the regions served by the active company.
- Open the commercial customer's Sales & Purchase tab and set Crate Delivery Region. For a contact belonging to a company, the commercial customer's region is used. Set it separately for each relevant company.

3.2 Trucks and weekly schedules
Open Sales → Crate Deliveries → Delivery Trucks, create a truck, and add its Weekly Schedule. Enter one rule per weekday, all regions served that day, and a positive Crate Capacity. The example truck serves two regions on weekdays with a shared capacity of six crates.

Capacity counts virtual crates, regardless of sheets, area, or physical packages. Six places shared by two regions means six total places, not six per region. Select Generate Next 90 Days. A daily scheduled action extends the rolling horizon during normal operation; the administrator should ensure it remains active.
3.3 Dated services and exceptions
Open Sales → Crate Deliveries → Delivery Calendar. Switch between calendar, list, and form views to review truck, date, regions, capacity, booked crates, remaining places, and Closed.


- Use Closed for holidays, maintenance, or unavailable services. It prevents new bookings; it does not cancel existing sales orders or reassign their crates.
- Adjust capacity for a dated exception, keeping it at least as high as confirmed bookings.
- Changes to weekly rules do not overwrite existing dated services or closures. Edit the affected dates separately.
- Once a crate selects a service, its truck, date, and regions cannot change. Arrange changes on an editable quotation by choosing another service. Confirmed orders cannot be edited through the crate composition workflow.
- A truck with a published calendar cannot change company. Keep company setup correct before publishing.
Enable the website scheduling switch after these records are ready.
4. Customer workflow
4.1 Open or create a composition
Sign in, open My Account → Glass Crates, or visit /my/glass-crates.
For an existing quotation, use View Glass Crates from its portal page.
- Optionally enter multiline Options Description, then select Create Crate.
- The system assigns the crate reference and copies the website capacities.
- Expand its header to work on it. The collapsed header shows its reference, requested date, sheet count, and area. Opening a card changes the display only.
- Save later instruction changes with Save Options. Instructions are plain text.

4.2 Add products by code or search
For exact entry, type the suffix after the fixed V| prefix, enter a whole-sheet
count, and select Add Row. Pasting a full prefixed code is also accepted.
Unknown or ambiguous codes must be corrected or resolved through product selection.
Alternatively, select Search Products:
- Search by code suffix or product name.
- Combine Subcategory, Thickness (mm), Height (mm), and Available only filters. Selecting a category includes eligible descendants.
- Use All Products, All Thicknesses, and All Heights to clear those filters; use Previous and Next for further results.
- Select the precise variant, then use Add Row. The picker preserves the unsaved sheet count and variant identity, even when variants share a code.

A new row accepts 1–1,000,000 whole sheets, subject to capacity and stock. Products needing custom or no-variant attribute input use their existing product configuration workflow; that input is not implemented in this configurator.
4.3 Edit loading order and interpret the drawing
Use Save Row to change a quantity. The up/down arrows save the typed quantity and move that position. Repeated codes remain separate rows. To remove a row, set its sheets to 0 and save. Every action saves the composition.
The side profile runs from left to right in loading order. Alternate colors separate positions. Numbering restarts at 1 for every crate and updates after quantity changes, moves, or removals. Above 400 sheets, the drawing groups each row into one block, preserving its combined thickness and numbering range.
Horizontal thickness and vertical height have independent scales. The drawing is an illustration; it does not model spacers, weight distribution, or a physical packing simulation. Sheet dimensions do not replace the sales conversion factor.
4.4 Capacity fitting
When adding or saving, the system subtracts other rows' depth and accepts the largest whole-sheet count that fits. A notice shows the requested and accepted counts. Prices, area, and surcharge use the accepted count.
For example, if other rows occupy 46 mm of a 120 mm crate, a new 6 mm row can fit at most 12 sheets in the remaining 74 mm. Requesting 15 accepts 12, provided stock permits that accepted quantity. If no whole sheet fits, reduce another row or create another crate.
Height/length overflow and overflow caused by changing capacities remain visible in drafts but block submission and checkout. Correct product measurements and save affected rows again. Website capacity changes affect new crates; staff may apply them to existing editable crates explicitly.
4.5 Availability and existing cart items
Availability uses the order's actual warehouse, including a warehouse chosen by staff, and subtracts quantities already in that cart.
| Remaining tracked stock | Customer display |
|---|---|
| Less than one whole sheet, including a positive fractional remainder | Not on stock; no numeric quantity. |
| 1–7 whole sheets | Exact available area and whole-sheet count. |
| At least 8 whole sheets | Stock status in the picker; no exact quantity. |
| Untracked goods | Availability not tracked in the picker; saved rows omit a stock quantity. |
Available only is on by default and excludes untracked goods and goods with less than one remaining whole sheet. Clear it to inspect those products. The display threshold is independent of the normal shop's stock visibility settings. Saving rechecks stock after depth fitting and respects the normal out-of-stock ordering policy. Adding sheets does not reserve inventory.
If glass is already in the normal cart, a row first consumes its unallocated area before increasing the sales quantity. Before submission, all remaining area on sales lines that have crate allocations must be assigned to crates. Ordinary cart items remain in the order and contribute to its totals.
4.6 Choose a delivery date
When scheduling is enabled, expand each crate, select Choose Delivery Date, pick an available day, and select Save Delivery. Clear Date clears the selection field; save the delivery change to persist it.

The calendar covers today through the following 89 days. It shows available days without exposing truck names or capacities. The system chooses a matching active truck in the customer's company and region. Full, closed, or unscheduled services cannot be selected. Other crates on the order also consume the displayed choices. Different crates may use different dates.
A selected date is a request, not a reservation. Capacity is rechecked and booked at sales confirmation. If another order fills it first, arrange another date while the quotation is editable. Requested dates do not split stock transfers or change their scheduled dates.
5. Quotation approval and checkout
| Stage | Customer editing | What happens |
|---|---|---|
| Composition | Allowed on an editable draft | Rows and options can be saved; no truck reservation or physical package is created. |
| Quotation Requested | Frozen | Request Quotation saves and locks composition and options; it does not confirm the sale. |
| Approved for Checkout | Frozen | Staff approve the composition; normal checkout or staff confirmation can proceed. |
| Confirmed sale | Frozen | Standard sales/stock processing applies; truck places are counted for selected services. |
- Review every crate, loading order, dimensions, instructions, dates, and totals.
- Select Request Quotation. Empty crates, incomplete dimensions, overflow, ineligible products, unassigned allocated area, and invalid delivery selections must be resolved first.
- Sales staff review and select Approve Crates, or Reopen Crates for changes.
- Once permitted, select Continue to Checkout and complete standard Odoo address and delivery steps, then review and sign the quotation in the portal.


Direct checkout: when enabled on the website, an editable draft composition may continue without sales approval. A composition already submitted with Request Quotation still requires approval or reopening. Enabling direct checkout does not unfreeze an existing request.
Confirmed, canceled, and explicitly locked orders cannot be edited. Payment transaction states do not lock B2B crate editing, approval, reopening, or draft repricing. Requesting a quotation blocks ordinary cart changes on that order. Submitted compositions are not automatically resumed as editable carts and are excluded from abandoned cart recovery messages. Use the quotation link to view the saved request.
6. Salesperson workflow
6.1 Review and approve
Open Sales → Orders → Quotations and use the Glass Crate Requests filter. Review order lines, customer, warehouse, prices, surcharge, and the Glass Crates tab. Each crate shows its reference, delivery date, truck, instructions, and package type. Use Open Crate for the individual composition.

Approve Crates validates the composition and permits checkout. It does not itself confirm the sale. Use Reopen Crates to permit changes on an unconfirmed quotation within the normal sales permissions. A sent quotation is returned to draft when reopened. Reopening also allows correction of invalid article data; save affected rows and approve again afterward.
6.2 Compose or change crates in the backend
A quotation must belong to a configured website. Select Manage Crates, then create a crate or open an existing one. Creation assigns the reference; the customer, company, and website of an order cannot change while it has crates.

- Enter Options Description as needed and optionally select a Package Type.
- Select Add Glass Sheets, choose an eligible article, enter whole sheets, and set Loading Position.
- Review the read-only product dimensions and select Save Row.
- Use Edit Row for quantity/position changes or Remove Row to remove that allocation. Zero sheets also removes an existing row.

The same depth fitting, stock checks, conversion, pricing, and surcharge rules apply as in the portal. Change dimensions on the product, not in the row editor. Use Apply Website Crate Dimensions on an editable draft quotation to refresh existing crates from the current website settings, then review every crate again.
The backend Requested Delivery selector identifies dated truck services; choose one for the customer's region. Availability is validated when saving and again before submission/confirmation. Open Order on a crate provides access to the quotation and its approval and order state.
6.3 Delete or duplicate
Delete Crate in the portal or backend removes a whole editable crate and its positions after confirmation of the deletion prompt. Its sales quantities and surcharge are recalculated. Allocations in other crates and unallocated glass remain. Standard deletion is also available for empty editable crates. Do not delete allocated sales lines directly; remove their sheets first.
Duplicating a quotation creates new crate references, preserves instructions, and maps positions to the copied sales lines. The copy starts a new composition and needs new delivery selections. Crates cannot be moved between orders.
7. Prices, surcharge, and invoicing
Prices follow standard order pricelists, quantity breaks, discounts, currency, fiscal position, and taxes. Repeated articles across crates share the commercial sales quantity. Use Update Prices on an editable quotation after changing its pricelist; do not manually overwrite the automatic surcharge line.

In the sample, clear 6 mm is 30 m² × €24 = €720; clear 8 mm is 12 m² × €32 = €384; grey 6 mm is 12 m² × €29 = €348. Net glass is €1,452. Adding €104.40 surcharge gives €1,556.40 before tax. The example has no product taxes. Your order may include tax, other cart items, and checkout delivery charges.
The automatic surcharge displays quantity, unit, unit price, any discount, and net amount. Its contents, removal, and allocated products' surcharge eligibility are protected. Removing all eligible items removes the charge. Checkout can still recompute standard prices, discounts, and taxes; ordinary non-surcharged carrier fees may be refreshed after approval.
Invoice from the sales order using normal Odoo procedures and the products' invoicing policies. The sales lines retain the agreed surcharge price. When a linked crate order contains a priced surcharge line, the invoice's separate surcharge action is blocked to avoid charging twice or replacing that price. Without a priced sales surcharge, native invoice surcharge behavior remains.
If a historical quotation has an informational surcharge note instead of a priced product line, reopen it, refresh the surcharge, review the result, and request/approve it again. Orders without crates retain native surcharge behavior.
8. Warehouse workflow and returns
8.1 Allocate and pack
Confirm the sales order only after the composition and selected services are acceptable. Standard inventory reservation follows your warehouse routes. Open the delivery through its sales-order smart button or Inventory operations.
- Check availability and open detailed operations.
- Set Glass Crate Allocation for each outgoing glass operation. Select the original crate, position, and article; quantities on operations are in the stock/sales unit, normally square meters, not the sheet count.
- Split operations if a product belongs to multiple positions or crates. For example, 30 m² of clear 6 mm must be split into 24 m² for position 1 and 6 m² for position 3 in the sample crate.
- Select Pack Glass Crates. Unpacked positive allocated operations are grouped by virtual crate into standard destination packages. The crate's optional package type is applied.
- Review packages and quantities, mark the actual operations as picked according to your normal warehouse process, and Validate the transfer.


Outgoing crate operations require both an allocation and a destination package. A package cannot combine different virtual crates. The allocation must match the product, confirmed order, and originating sales line. Total outgoing quantities cannot exceed the allocated area after crediting completed customer returns. Completed allocation links cannot be reassigned.
8.2 Partial deliveries and backorders
A virtual crate may use several physical packages and backorders. Deliver the actual quantities and follow normal Odoo backorder handling. Assign the original allocations to the remaining operations and pack them before validating the backorder. Splitting physical delivery does not create another virtual crate or another truck-capacity booking.
8.3 Customer returns and cancellation
Use the standard return workflow on the completed delivery. Assign each returned glass operation to its original crate allocation, check the returned area, and validate normally. Returned area cannot exceed delivered area. Completed returns credit the allocation's outgoing quantity budget while preserving its original order and packing history. They do not edit the frozen composition.
Canceling a sales order releases its counted truck places. It does not constitute a completed stock return; follow standard inventory and accounting processes for any goods already delivered or invoiced. Merely delivering a confirmed order does not release its truck booking; capacity counts confirmed orders.
9. Packing lists
Select Print Packing List at the top of the customer page for all order crates, or inside an expanded crate for that crate only. In the backend crate, use Print → Glass Crate Packing List.

The PDF uses A4 portrait. Each crate starts its own section, and long contents continue onto additional pages. It contains order and crate references, customer and delivery addresses, profile, sheet numbers, article codes, dimensions, sheet counts, areas, requested date, and customer instructions. Prices, tax, monetary totals, and surcharge lines are omitted. Printing uses the saved composition and does not confirm a sale, reserve capacity, or create warehouse packages.
The illustration above is the first page of the generated PDF. Use Print Packing List to obtain the PDF for printing or sharing with authorized recipients.
10. Troubleshooting and operating limits
| Symptom | Check and action |
|---|---|
| Configurator unavailable | Set website catalog scope, valid square-meter unit, and all three positive capacities. |
| Article absent | Check active/sellable Goods status, Usable in Crates, publication, company, website/category assignments, exact unit, and V\| reference. Clear Available only if inspecting unavailable/untracked goods. |
| Code is ambiguous | Select the exact variant in Search Products instead of guessing by code. |
| Conversion or area error | Set a finite positive conversion and sufficient unit precision. Existing rows retain their conversion snapshot; resolve master-data changes deliberately with sales staff. |
| Dimensions incomplete or too large | Check Dimensional UoM and axis mapping; correct the article, save affected rows, and review capacities. |
| Sheet quantity reduced | Read accepted count; remaining depth limits the edited row. Add a crate or reduce other positions if needed. |
| No room for one sheet | Free depth in another row or use another crate. |
| Stock error despite previous availability | Stock changed, the order warehouse differs, or its cart already uses the stock. Refresh and reduce quantities or follow the configured out-of-stock policy. |
| Cannot submit | Remove empty crates; resolve measurements, overflow, eligibility, unassigned area on allocated lines, surcharge setup, and delivery selections. |
| No available delivery dates | Check website switch, commercial customer's company-specific region, active truck, published 90-day schedule, closures, and remaining capacity. |
| Capacity filled before confirmation | Reopen the unconfirmed quotation when permitted and choose another date; selection did not reserve capacity. |
| Cannot edit or delete | Review quotation status, order state, and lock through Open Order. Use Reopen Crates only when permitted. |
| Automatic surcharge cannot be edited | Correct weights, category eligibility, exclusions, product, or pricelist; refresh the editable order through the supported actions. |
| Delivery cannot validate | Assign each outgoing crate operation and destination package; split positions correctly and check allocated area. |
| Return cannot validate | Assign the original allocation and ensure returned area does not exceed delivered area. |
| Cannot change customer/company/website | An order with crates retains ownership. Create a separate order or remove editable compositions deliberately first. |
Daily checklist
- Before approving: review composition, fit, eligible products, totals, customer instructions, warehouse, and requested dates.
- Before confirming: recheck delivery availability and the current quotation and approval and order state.
- Before dispatch: verify detailed allocation, actual quantities, packages, and packing lists.
- As a planner: review dated exceptions and the daily calendar extension job; changing weekly rules alone does not revise published services.
Scope boundaries
The module handles whole-sheet composition with square-meter sales and stock. It does not collect custom/no-variant attribute inputs, simulate physical load safety, split transfers by requested crate date, or replace standard checkout, payment, invoicing, tax configuration, transport operations, and stock return procedures. Staff must maintain the relevant catalog, conversion, measurements, capacity, surcharge, and delivery setup before those workflows can proceed.