PMIS Website Glass Crates
Build virtual glass crates from whole sheets in loading order, with a side profile, customer quotations, regional delivery planning, and packing lists. Standard sales lines aggregate the square meters for pricing, invoicing, and stock operations; virtual crates preserve the individual loading positions.
For workflows and screenshots, see the English user manual or Slovenian user manual.
Features
Crate composition and product selection
Automatic, searchable crate references and optional multiline customer instructions on each crate.
Exact variant-code entry and a paginated product picker scoped to the website's published, eligible glass products.
Combined code/name, subcategory, thickness, height, and availability filters. Results list individual variants and retain the active filters while paging.
Independent loading positions for repeated codes, with quantity editing, reordering, row removal, and whole-crate deletion with a confirmation prompt while the composition is editable.
Product-derived dimensions, fixed crate capacities, and automatic reduction to the largest whole-sheet count that fits the remaining depth.
A side profile with alternating position colors, independent horizontal and vertical scales, and sheet numbering that follows loading order.
Customer portal and native sales forms using the same conversion, pricing, stock, quotation, and order-state safeguards.
Sales, stock, and energy surcharge
Standard customer pricelists, quantity breaks, discounts, currencies, taxes, and ordinary cart items alongside crate products.
Authenticated website pricing always follows the customer's assigned pricelist. Unpriced products and variants marked On Request Only show “Price unavailable—request quotation” in the picker and cannot be selected or added by entering their code, even when a request-only variant has a price. Backend crate additions apply the same rule. Public visitors cannot retrieve commercial prices.
Assignment of unallocated glass already in the cart before adding new sales quantities, avoiding duplicate sales of that area.
Warehouse-specific availability and the normal out-of-stock ordering policy.
One automatic, priced energy surcharge line that follows eligible product weights and the order's standard pricing rules.
Quotation submission and approval, optional direct checkout, and explicit reopening before customer changes.
Standard packages, backorders, and customer returns linked to the original crate allocation.
Delivery planning and packing lists
Company-specific customer delivery regions, trucks, weekly schedules, and dated capacities shared across all regions served by a truck.
A rolling 90-day delivery calendar with individual closures and capacity exceptions, plus a customer calendar showing daily availability.
One requested delivery date per crate and capacity reservation at sales confirmation.
A4 portrait packing lists for one crate or all crates on an order, without prices, taxes, monetary totals, or surcharge lines.
Italian, Slovenian, Croatian, and Serbian (Latin) interface translations.
Configuration
Dependencies and access
The module requires website_sale_stock, pmis_website_sale_private_prices, pmis_product_multi_website, pmis_deliverable_logistic_unit, product_dimension, and pmis_energy_surcharge. No theme or brand-specific controller is required. Product and website records are not automatically configured. The private-prices dependency also brings CRM and signed quotation checkout.
Sales staff manage compositions within their normal order and company access rules. Sales managers configure delivery regions, trucks, and calendars. The website's Glass Crates configuration section requires the Settings administration group (base.group_system). Warehouse users use standard stock permissions. Portal customers have read-only model access; authenticated portal actions authorize changes against the customer's order and website.
Website catalog and warehouse
In the website's Glass Crates section, select Default Order Warehouse and the existing square-meter unit of measure. The warehouse is shared with the website's normal shop settings and must belong to its company.
Keep All Website Categories enabled to include categories and subcategories explicitly assigned to the site through either website assignment field. Hidden, unassigned, and other-site categories are excluded; a parent's assignment does not expose an unassigned child.
To restrict the catalog to one branch, disable All Website Categories and select Glass Crate Category. Its descendants remain subject to product publication, company, and website eligibility.
Optionally set Website Category Filter to the parent of the picker options. Website-assigned descendants within the configured category scope are listed, and the selected parent is omitted. Leave it empty to list all assigned subcategories within that scope. Categories without a parent are omitted from options and labels. The list is not restricted to categories containing eligible products; choosing a category may return no articles.
New website orders use the configured warehouse. Leaving it empty retains the standard sales warehouse default. Existing orders retain their warehouse; availability and stock checks use the actual warehouse on each order, including one selected by sales staff.
Glass products and crate dimensions
Enable Usable in Crates on eligible products, individually or through the product list's Enable/Disable Glass Crates actions.
Configure Alternate Logistic UoM conversion on each variant as square meters per sheet. Eligible products must be active Goods products and use exactly the website's configured sales unit. Services and products using a different sales unit are excluded. Goods may be stock-tracked or untracked; the picker distinguishes their availability.
Configure the variant's length, width, height, and Dimensional UoM. On the website, select different axes for Glass Thickness Source, Glass Height Source, and Glass Length Source. Defaults are width for thickness, height for upright sheet height, and length for sheet length. Measurements are converted to millimeters and must all be positive.
Set Fixed Crate Depth (mm), Fixed Crate Height (mm), and Fixed Crate Length (mm) before creating crates. Each crate retains these capacities; changing website defaults affects future crates.
The square-meter unit must be active, have a conversion factor of 1, and have an English name of m2, m², Square Meter, or Square Meters (case-insensitive). The Product Unit of Measure decimal precision must support its rounding: for example, rounding of 0.001 requires at least three decimal places. An existing unit in a legacy category is supported.
No categories, units, or physical crate dimensions are assumed or created. Customers cannot override product measurements or crate capacities. Sales staff can apply the website capacities to existing draft crates through Apply Website Crate Dimensions on the quotation.
Energy surcharge
Configure the company's surcharge product, eligible categories, product exclusions, and weights through PMIS Energy Surcharge. The calculation uses product weight multiplied by ordered quantity. Glass quantities are in square meters, so weights must be consistent with that sales unit.
Weight units on the surcharge product are converted from the system's configured weight unit. Other sales units retain the surcharge module's weight-as-quantity convention. Missing surcharge configuration or an invalid total weight prevents the composition change from being saved when surcharge-eligible lines exist. Orders without eligible lines do not require a surcharge product and have no generated surcharge line.
Regional truck deliveries
In Sales → Crate Deliveries, configure delivery regions and trucks. Give each truck one weekly rule per weekday, selecting all regions served that day and their shared crate capacity. Capacity counts crates, independently of sheet quantities.
Set Crate Delivery Region on the commercial customer's Sales & Purchase tab. The value is specific to the current company.
Select Generate Next 90 Days to publish the truck calendar. A daily scheduled action extends the horizon automatically.
Review individual services in Delivery Calendar. Existing dates retain their regions, capacities, and closures when the weekly schedule changes. Use Closed for holidays or unavailable services.
Enable Schedule Crate Deliveries in the website's Glass Crates settings after configuring customer regions and truck schedules.
A selected service's date, truck, and regions cannot change. Its capacity may be increased or reduced, but never below confirmed bookings.
Checkout, references, and languages
Direct checkout is disabled by default. Enable it per website when sales approval is not required. Address, shipping, price, stock, composition, and approval checks still apply. The private-prices dependency then marks the quotation as sent and opens its portal for Accept & Sign, without requiring online payment or a payment provider. Shopping afterward starts a new cart. Customer payment terms are retained; configure agreed B2B terms on the customer rather than relying on Odoo's Immediate Payment default.
Crate editing, approval, reopening, and repricing do not depend on linked payment transactions. Editable draft compositions follow the customer's current assigned pricelist even if a transaction is pending, authorized, or completed. Submitted, approved, sent, confirmed, canceled, and explicitly locked quotations remain protected by their lifecycle. Orders without crates retain the inherited private-prices payment guard. Payment processing and refunds remain outside the crate workflow.
The standard crate sequence is shared across companies. A company-specific sequence with code pmis.glass.crate takes precedence for that company's orders. Sequence configuration and the counter survive module updates.
Activate the required languages and enable them on the website to use the translated interface.
Usage
Compose a crate in the customer portal
Open Glass Crates in the portal, or /my/glass-crates, and create a crate. It receives an automatic reference such as CRATE/000001. The crate name follows the reference and cannot be entered or renamed.
Enter optional Options Description instructions when creating the crate or use Save Options while it is editable. Instructions are plain text and may contain multiple lines.
Enter an exact product-code suffix and a whole-sheet count, then select Add Row. The fixed prefix is V|; pasting a complete prefixed code is also accepted. Website additions and picker results enforce this prefix.
Alternatively, select Search Products beside the code field. Search by code suffix or name and combine the subcategory and measurement filters. All Products, All Thicknesses, and All Heights clear the respective filters. Selecting a subcategory includes its eligible descendants. Product selection preserves the unsaved sheet count and the exact variant identity, including variants sharing a code.
Edit quantities with Save Row. The up/down buttons also save typed changes before moving a row. Repeated codes remain separate positions. New rows require 1 to 1,000,000 whole sheets. Set an existing row's sheets to zero to remove it.
Review the profile and customer instructions. If delivery scheduling is enabled, delivery dates may be added later. Each crate needs a requested delivery date before the quotation is confirmed as a sales order.
Direct code entry must identify one eligible variant. Unknown or ambiguous codes require correction or explicit picker selection. Products requiring custom or no-variant attribute input use their existing configuration workflow. Already allocated variants are checked again on edits and submission. Marking one On Request Only blocks continuing with it in the composition.
The drawing follows loading order from left to right. Thickness and height use independent scales; no spacer thickness is assumed. Compositions with more than 400 sheets draw one block per row with its full combined thickness. Sheet numbering restarts at 1 for each crate. A single sheet has one number, two sheets have two explicit numbers, and larger allocations use a range such as 1-6. Reordering, removing, or resizing rows updates the numbering.
Depth fitting and stock availability
Adding or saving a row reduces its sheet count to the largest whole number that fits the remaining depth, after subtracting the other rows. The edited article's current thickness is used. A notice shows requested and accepted counts; square meters, prices, and surcharge use the accepted quantity. If no whole sheet fits, reduce another row or choose another crate.
Height or length overflow, and overflow caused by later capacity changes, remain visible in drafts and block submission or checkout. Complete missing article measurements and save affected rows again before continuing.
When glass is already in the ordinary cart, adding a row assigns its unallocated area before selling more. All remaining area on allocated sales lines must be assigned before submission. Ordinary cart items retain standard behavior and contribute to the order total.
Available only is selected by default in the picker and requires at least one whole sheet after deducting the cart quantity from free stock. Clear it to include unavailable and untracked products. Saved rows and the picker show exact square meters and whole sheets for stock-tracked products when 1 to 7 whole sheets remain. Below one whole sheet, including a positive fractional remainder, tracked products show Not on stock without a numeric quantity. From 8 sheets upward, the picker shows stock status. Untracked goods show Availability not tracked in the picker, with no numeric availability; saved rows omit the stock quantity. Available-only filtering excludes untracked goods. This threshold is independent of the normal shop's stock visibility settings. Saving sheets always rechecks current stock after applying the depth limit.
Submit, approve, reopen, or delete
Select Request Quotation to freeze the composition and customer options. This does not confirm the sale or reserve stock or truck capacity. It updates the existing sales quotation's crate status; it does not create a CRM opportunity. Delivery dates may still be empty.
Sales staff select Approve Crates on the sales order, or use Reopen Crates to allow changes. Reopening also permits correction of invalid article data. An unconfirmed sent quotation may be reopened by authorized sales staff.
Proceed through standard checkout when approval or the website's direct checkout policy permits it, then review and sign the quotation in the portal. When delivery scheduling is enabled, every crate needs a date before the signature can confirm the sales order.
Enabling direct checkout permits an editable draft composition to proceed without prior sales approval. A composition already submitted with Request Quotation still requires approval or reopening. Submitted compositions are not automatically resumed as editable carts, and are excluded from abandoned cart recovery messages.
Confirmed, canceled, and explicitly locked orders cannot be edited. Submitted or approved compositions require reopening. Backend crate forms display the quotation lifecycle and provide Open Order to review it. The quotation freeze also blocks ordinary shop cart changes on that order.
Use Delete Crate in the portal or backend form, and confirm the deletion prompt, to remove a whole editable crate and its positions. This follows the same draft, approval, and order-state locks as row edits. Quantities assigned to other crates and unallocated glass remain; prices and surcharge are recalculated. Empty crates may also be deleted through the standard form action.
Edit from a sales quotation
Open Manage Crates on a website quotation or Open Crate from its Glass Crates tab.
Create a crate or open an existing one and edit Options Description.
Select Add Glass Sheets, choose an eligible article, enter whole sheets, and set the loading position.
Use Edit Row to change quantity or position and Remove Row to remove an allocation. Saving zero sheets also removes an existing allocation.
The backend applies the same depth fitting and reports reduced sheet counts. Article measurements and fixed capacities remain read-only in the editor.
Review charges and invoice
The portal displays the automatic surcharge's quantity, unit price, and net amount. Its content and deletion are protected, and allocated glass cannot override its product-based surcharge eligibility. Removing all eligible products removes the charge. Use Update Prices after changing the quotation's pricelist. Checkout may recalculate taxes, price, and discount while manual edits remain blocked. Ordinary carrier fees not eligible for surcharge may be refreshed after crate approval.
Invoice the sales order normally to retain the agreed surcharge price. When the linked crate order contains a priced surcharge line, the invoice's separate surcharge action is blocked to prevent a second charge or replacement of that price. Crate orders without a priced surcharge line use the native invoice surcharge behavior. Refreshing an editable quotation replaces legacy informational surcharge notes; reopen a submitted quotation before refreshing and requesting approval again. Orders without crates retain the surcharge module's native behavior.
Choose delivery dates
Dates are optional when creating crates, submitting a quotation request, and approving the composition. When Schedule Crate Deliveries is enabled, confirmation as a sales order requires a date for every crate. Choose dates while the composition is editable. If dates were omitted before submission or portal checkout, sales staff must reopen the crates, complete the delivery selection, and approve again when required.
The customer calendar marks dates Available or Unavailable, without showing truck names or capacities. A date is available when at least one eligible truck has a free place; saving assigns that truck internally. Full, closed, and unscheduled dates cannot be selected. Different crates may use different dates, shown on the order, crate form, and packing list. Availability accounts for the other crates on the current order as well as confirmed bookings. The portal offers dates from today through the next 89 days, and requires an active truck serving the customer's company and region.
Confirmation rechecks the customer's region and availability and atomically reserves one truck place per crate. Canceled orders release those places. Another order can fill a date after selection; select another available date if needed. Duplicated quotations require new delivery selections. The portal explains when delivery scheduling has not been enabled for its website.
Pack deliveries and process returns
After sales confirmation, assign Glass Crate Allocation on detailed stock operations. Split operations when a product belongs to different positions or crates.
Select Pack Glass Crates to group operations by virtual crate through standard package creation. Outgoing crate operations require both an allocation and a destination package before validation.
Process customer returns through the normal return workflow and assign returned glass to its original crate allocation.
A virtual crate may use multiple physical packages or backorders. Completed returns restore its available delivery quantity and preserve the original order and packing history. Draft compositions create neither packages nor reservations.
Open crate overviews and print packing lists
Portal crates expand to show their drawing and contents; the collapsed row shows reference, sheet count, and area. Saving a change opens the affected crate. Expanding or collapsing changes only the display, not editing permissions.
Select Print Packing List for all order crates or one expanded crate. The backend crate Print menu offers the same A4 portrait PDF. Each crate starts a section with order and crate references, customer and delivery addresses, profile, sheet numbers, article codes, dimensions, counts, areas, requested delivery date, and customer options. Long contents continue over more pages. Prices, taxes, monetary totals, and energy surcharge lines are excluded. Printing uses the saved composition and does not confirm or reserve anything.
Data Model Notes
pmis.glass.crate belongs to one sales order and retains its automatic reference, customer instructions, capacities, and delivery selection. Crates cannot be moved between orders. While crates exist, their order's customer, company, and website cannot be changed.
pmis.glass.crate.line links one loading position to a standard sales line. It retains whole-sheet quantity, dimensions, and a conversion snapshot. Dimensions describe the profile; they do not replace the authoritative sheet-to-square-meter conversion.
Saving an editable row refreshes its product measurements. Submitted rows retain their saved measurements. Multiple crates and repeated codes share sales-line pricing based on the total product quantity.
Stock operations retain the allocation link for packages, backorders, and returns. Completed allocation links cannot be reassigned.
Delivery regions, trucks, weekly rules, and dated slots are separate records. Customer region selection is company-specific; dated capacity counts crates.
Copying a quotation maps allocations to the copied sales lines, retains customer instructions, and assigns new references and names. Historical crates without references retain their saved display names.
Known Limitations
This is a whole-sheet glass workflow using square-meter sales units. Custom and no-variant attribute-input workflows are not implemented by the crate configurator.
Catalog eligibility, measurements, conversion factors, crate capacities, warehouses, and any required surcharge or delivery configuration must be supplied before the corresponding workflow can proceed.
The profile is a scaled illustration, not a physical packing simulation; horizontal and vertical scales differ and spacer thickness is not modeled.
Requested crate delivery dates plan transport. They do not split stock pickings or change their scheduled dates.
Draft and requested quotations do not reserve inventory or truck places. Selection does not guarantee that capacity will remain available at confirmation.
Use the ordinary shop's quotation-request action for a request-only product inquiry. That CRM request contains no crate composition and is separate from the portal's Request Quotation action.
Bug Tracker
Bugs are tracked on PMISuite Repository Issues. Before opening a new issue, check whether it has already been reported. Include the module and Odoo versions, steps to reproduce, and expected and actual results. Use synthetic examples and redact sensitive information.
Credits
Contributors
Devid Miklus
Matjaž Mozetič
Maintainers
Current maintainer:
Luxim is an independent R&D and deployment company focused on solving complex problems in the Odoo ecosystem.
Luxim is an active member of OCA (Odoo Community Association).






