Feature Overview
Line Grouping & Line Filtering gives you control over how document lines are selected, structured, and presented in the printed output. It covers two related but distinct capabilities.
Line Filtering is a set of Boolean flags in Document Customizer Content that determine which lines appear on the document at all, and which summary sections are printed. You can hide lines with zero quantity, show only lines with outstanding quantity, show only lines where there is a quantity to ship, show only lines with shipped-but-not-invoiced quantity, hide lines with a zero line amount, hide lines of blank type (e.g. comment lines), show only item-type lines, hide warehouse shipment lines that are fully handled, suppress the entire totals section, show related shipment numbers, or force VAT rows to appear even when the VAT amount is zero. These flags operate at the report rendering level and do not affect BC data — they purely control what is printed.
Line Grouping is a more structural feature. It allows you to define a hierarchical grouping of document lines based on field values — for example, grouping lines by product category or by project code — with the system automatically inserting group headers, group subtotals, and a separate column layout for the subtotal rows. A Line Grouping Template defines the low-level grouping field, the high-level grouping field, and which column positions carry the subtotals (quantity, amount, description, etc.). Once assigned in Document Customizer Content, the report engine reorganises the lines into the defined hierarchy and renders the grouped output.
The Group Empty Bundle Values flag handles the case where assembly or bundle item lines have no individual values on sub-components — when enabled, these blank sub-component lines are grouped together rather than printed individually.
Key Facts
| Where to set up Line Grouping | Line Grouping Setup page (from Document Customizer Content → Line Grouping Setup action) |
| Where to assign | Document Customizer Content → Line Grouping Template field |
| Line filtering flags | Document Customizer Content (Show Lines with Zero Qty., Show Only Lines With Outstanding Qty., Show Lines with Qty. to Ship, Show Only Lines With Qty. Shipped not Invoiced, Hide Lines With Line Amount = 0, Hide Lines With Blank Type, Show Only Item Lines, Hide Warehouse Shipment Lines, Hide Total Section, Show Shipment, Show Total VAT lines even if 0) |
| Grouping fields | Low Level Group On Field No. and High Level Group On Field No. from the document line table |
| Subtotal columns | Up to 6 configurable subtotal column positions (Qty, Amount, UOM, Unit Price, Discount, Description) plus a high-level text column |
| MDI integration | Master Data Information options: No Master Data on Lines, First Line Master Data, All Master Data |
| Mutual exclusivity | Show Only Lines With Outstanding Qty., Show Lines with Qty. to Ship, and Show Only Lines With Qty. Shipped not Invoiced are mutually exclusive |
Getting Started
Configuring Line Filtering (no setup required — flag-based):
- Open Document Customizer Content and find the relevant document row.
- Enable the appropriate filtering flags based on your requirements (e.g. enable Show Only Lines With Outstanding Quantity > 0 for a picking list that should only show unshipped lines).
- Run Test Report Layout to verify the filtered output.
Configuring Line Grouping:
- Open Document Customizer Content, find the relevant document, and navigate to Line Grouping Setup from the action bar.
- Create a new Line Grouping Template record. Set Table No. to the document line table.
- Set Low Level Group On Field No. to the field you want to group lines by (e.g. Product Group Code on Sales Invoice Line).
- Optionally set High Level Group On Field No. for a second-level grouping (e.g. Division).
- Set Columns Template to the Column Template that defines the subtotal row layout.
- Configure the subtotal column numbers: Subtotal Descr. Column No., Subtotal Qty. Column No., Subtotal Amount Column No., etc. — these reference column positions in the Columns Template.
- Return to Document Customizer Content and set Line Grouping Template to the template you just created.
- Run a test report to verify the grouping structure.
Related Features
Line Grouping & Line Filtering work directly with Column Setup: the grouping template references column numbers from the active Columns Template to place subtotals in the right columns. The Header Setup and Footer & Sections features are unaffected by line grouping. When Master Data Information (MDI) is installed, the Line Grouping Setup has an additional Master Data Information option that controls whether MDI item data is shown on no lines, the first line only per group, or all lines. The Line Filtering flags interact with the Show Assembly Components and Show Assembly BOM flags in Document Customizer Content, which are separate toggles that expand assembly-related sub-lines.
User Stories
US-01: Hide lines with zero quantity on a sales order confirmation
As a Sales Order Processor
I want to suppress lines where the outstanding quantity is zero from the printed sales order confirmation
So that the customer only sees items that are actually being delivered, not previously completed lines
Setup:
- Open Document Customizer Content for the Sales Order Confirmation row.
- Enable Show Only Lines With Outstanding Quantity > 0.
- Save. Lines with Outstanding Quantity = 0 will no longer appear on the printed document.
Note: This flag is mutually exclusive with Show Lines with Qty. to Ship and Show Only Lines With Qty. Shipped not Invoiced. Enabling one will automatically disable the others.
US-02: Print only the lines ready to ship on a picking document
As a Sales Order Processor
I want to show only lines where there is a positive Qty. to Ship on the picking instruction
So that the picker focuses only on the items to be picked in this shipment, not on back-ordered lines
Setup:
- In Document Customizer Content for the Pick Instruction row.
- Enable Show Only Lines with Qty. to Ship > 0.
- Save and run a test with an order that has partial quantities.
US-03: Suppress comment lines (blank type) from a customer-facing invoice
As a Business Manager
I want to hide all lines of blank type (comment lines) from printed invoices so that internal notes added to the sales order do not appear on the customer copy
So that the invoice is clean and professional without internal commentary
Setup:
- In Document Customizer Content for the Sales Invoice row.
- Enable Hide Lines With Blank Type.
- Save. Lines where the Type field is blank will no longer print.
Note: If you also want the column setup to handle blank-type lines differently when they are visible (e.g. show only the description without amounts), use the Use Column Setup For Lines With Blank Type flag instead.
US-04: Show lines with zero amounts (e.g. free-of-charge items)
As a Business Manager
I want to ensure that lines with a line amount of zero still appear on the invoice, since some items are deliberately free of charge as part of a promotion
So that the customer can see all items included in the order, even those at no cost
Setup:
- In Document Customizer Content for the Sales Invoice row.
- Ensure Hide Lines With Line Amount = 0 is disabled (it is disabled by default).
- To force zero-quantity lines to also appear, enable Show Lines with Zero Qty. if needed.
US-05: Group invoice lines by product category with subtotals per group
As a Business Manager
I want to print sales invoice lines grouped by product category (e.g. Hardware, Software, Services) with a subtotal line at the end of each group
So that the customer gets a clear breakdown of the invoice by type of purchase
Setup:
- Open Document Customizer Content for the Sales Invoice row and navigate to Line Grouping Setup.
- Create a new template (e.g.
CATEGORY-GROUP). Set Table No. to the Sales Invoice Line table. - Set Low Level Group On Field No. to the Product Group Code (or Type, or another category field) on Sales Invoice Line.
- Set Columns Template to the column setup used for subtotal rows.
- Set Subtotal Descr. Column No. to the column where the category label should appear, and Subtotal Amount Column No. to the column where the subtotal amount should appear.
- Set SubTotal/HighLevel Text Column to the column that shows the group label.
- Return to Document Customizer Content and set Line Grouping Template to
CATEGORY-GROUP.
US-06: Add a second-level grouping for invoices with department and category breakdowns
As a Business Manager
I want to group invoice lines first by department (high level) and then by product category within each department (low level), with subtotals at both levels
So that complex invoices with multiple departments are structured and easy to review
Setup:
- In the Line Grouping Setup template, set High Level Group On Field No. to the department field on the line table.
- Set Low Level Group On Field No. to the product category field.
- Set Subtotal Group On Field No. to the same field as High Level if you want subtotals to reset at the department level (this is set automatically when High Level is configured).
- Configure subtotal column numbers for both levels.
- Assign the template in Document Customizer Content.
US-07: Group empty bundle component lines together instead of printing them individually
As a Business Manager
I want to prevent assembly/bundle sub-component lines that have no individual values from being printed as separate blank rows
So that the document is compact and the bundle is presented as a single unit
Setup:
- In Document Customizer Content for the relevant document.
- Enable Group Empty Bundle Values.
- Save. Sub-component lines with blank values will be aggregated rather than printed individually.
US-08: Control how MDI item data appears on grouped lines
As a IT Manager
I want to show Master Data Information item attributes only on the first line of each group, not on every individual line, so that the grouped view remains compact
So that item attributes from MDI appear once per product group entry rather than repeating for every sub-line
Setup:
- In the Line Grouping Setup template, set Master Data Information to
First Line Master Data. - Save. MDI data will be rendered on the first line of each group only.
Note: Options are: No Master Data on Lines (MDI suppressed entirely on lines), First Line Master Data (MDI on first line per group only), All Master Data (MDI on every line). This option is only available when MDI is installed.
US-09: Show assembly BOM components below parent lines on a production order
As a Business Manager
I want to expand assembly BOM components below each parent assembly item on the production order printout
So that production staff can see the full list of components required for each assembly without looking up the BOM separately
Setup:
- In Document Customizer Content for the Assembly Order row.
- Enable Show Assembly BOM.
- Save. Components from the assembly BOM will be printed as indented sub-lines below each assembly parent line.
Note: Show Assembly Components from Assembly Order is a separate flag that pulls live component demand from the assembly order (as-requested), while Show Assembly BOM expands the standard BOM definition. Use the appropriate flag depending on whether you need live demand or the standard BOM structure.
US-10: Show serial and lot number tracking lines as a supplementary appendix
As a Business Manager
I want to print item tracking detail (serial numbers, lot numbers, package numbers, quantities, and expiration dates) as an appendix section after the main document lines
So that the document serves as a tracking confirmation that can be signed and retained
Setup:
- In Document Customizer Content for the relevant document row.
- Enable Show Serial/Lot No./Package No. Appendix.
- Optionally enable Hide Qty. in Serial/Lot No. if you want to suppress the quantity column from the tracking appendix.
- Save and run a test with a document that has item tracking entries.
Note: The appendix is generated automatically from BC's item tracking entries — no Supplementary Columns template is required. The columns shown (Serial No., Lot No., Package No., Quantity, Expiration Date) are fixed and determined by which tracking types are active on the items. Show Serial/Lot No. Appendix is available on: Sales Invoice (and Pane Envelope), Sales Shipment (Posted), Posted Warehouse Shipment, Pick Instruction, Transfer Order, Warehouse Picklist, Warehouse Shipment, Pro Forma Sales Invoice, and Purchase Order. Hide Qty. in Serial/Lot No. is available on all the same documents except Warehouse Shipment.
US-11: Hide warehouse shipment lines that have already been fully shipped
As a Business Manager
I want to suppress lines on a Warehouse Shipment or Posted Warehouse Shipment that have already been fully handled, so that only open or partial lines appear on the printed document
So that warehouse staff only see the work that still needs to be done, reducing errors and confusion on busy docks
Setup:
- In Document Customizer Content for the Warehouse Shipment or Posted Warehouse Shipment row.
- Enable Hide Warehouse Shipment Lines.
- Save and run a test with a shipment that has a mix of fully shipped and partially shipped lines to verify the filtering.
Note: This flag is only visible for Warehouse Shipment (6082872) and Posted Warehouse Shipment (6082708). It filters at the line level and does not affect the document header or totals.
US-12: Hide the totals section on documents where it is not needed
As a Business Manager
I want to suppress the entire totals section (subtotal, VAT, total) from the bottom of a sales shipment or picking list
So that purely logistical documents are not cluttered with financial totals that are irrelevant to the recipient
Setup:
- In Document Customizer Content for the relevant document row (e.g. Sales Shipment, Order Confirmation, Pick Instruction).
- Enable Hide Total Section.
- Save. The subtotal, VAT, and total rows will not appear on the printed document.
Note: This flag is available on: Sales Invoice (and Pane Envelope), Sales Order Confirmation, Sales Quote, Sales Order, Pro Forma Sales Invoice, Blanket Sales Order, Posted Purchase Invoice, and Pick Instruction. It does not affect the line totals calculated per column — only the summary section below the lines is hidden.
US-13: Show the shipment number on sales documents for delivery reference
As a Business Manager
I want to print the related shipment number on the sales invoice or order confirmation so that the customer can cross-reference the delivery document
So that any dispute or delivery query can immediately be linked to the correct shipment without manual lookup
Setup:
- In Document Customizer Content for the relevant document row (e.g. Sales Invoice, Order Confirmation, Sales Shipment).
- Enable Show Shipment.
- Save. The shipment number associated with each line or the document header will be printed on the document.
Note: This flag is available on: Sales Invoice (and Pane Envelope), Sales Shipment (Posted), Sales Order Confirmation, Sales Quote, Blanket Sales Order, Purchase Order, Purchase Quote, Posted Purchase Invoice, Sales Order, Blanket Purchase Order, Sales Credit Memo, and Project Quote.
US-14: Show a VAT line in the totals section even when VAT amount is zero
As a Accountant
I want to include the VAT specification line in the document totals even for zero-rated transactions (e.g. VAT-exempt exports or reverse-charge invoices)
So that the totals section is structurally consistent across all invoices and the recipient can see that VAT was considered but does not apply
Setup:
- In Document Customizer Content for the relevant document row (e.g. Sales Invoice, Order Confirmation).
- Enable Show Total VAT lines even if 0.
- Save. The VAT row will appear in the totals section even when the VAT amount is 0.00.
Note: This flag is available on: Sales Invoice (and Pane Envelope), Sales Credit Memo (and Pane Envelope), Sales Order Confirmation, Sales Quote, Blanket Sales Order, Purchase Order, Sales Order, Posted Purchase Invoice, Sales Return Order, Project Quote, Service Order, and Pro Forma Sales Invoice. Without this flag, VAT rows with a zero amount are suppressed from the totals section by default.
US-15: Show only lines with shipped-but-not-invoiced quantity on a billing run
As a Accountant
I want to filter sales order lines so that only lines where goods have been shipped but not yet invoiced are visible on the document
So that I can produce an accurate billing document that covers exactly the deliveries that need to be invoiced in this run, without showing already-invoiced or unshipped lines
Setup:
- In Document Customizer Content for the relevant document row (Sales Order).
- Enable Show Only Lines With Qty. Shipped not Invoiced > 0.
- Save. Only lines where Qty. Shipped Not Invoiced is greater than zero will appear.
Note: This flag is mutually exclusive with Show Lines with Qty. to Ship and Show Only Lines With Outstanding Qty. — enabling one automatically disables the others. Only available on the Sales Order report (6082709).
US-16: Hide lines with zero line amount to clean up invoices with mixed pricing
As a Business Manager
I want to suppress lines where the calculated line amount is zero — for example, fully discounted lines or lines with a zero unit price that are not intended to be shown to the customer
So that the invoice only shows lines with a financial value, keeping the document concise and avoiding customer confusion over zero-amount entries
Setup:
- In Document Customizer Content for the Sales Invoice or Sales Credit Memo row.
- Enable Hide Lines With Line Amount = 0.
- Save. Lines where Line Amount = 0 will not appear on the printed document.
Note: This is distinct from Show Lines with Zero Qty. — that flag controls lines with zero quantity, while this flag controls lines with a zero calculated amount. A line can have a non-zero quantity but still produce a zero line amount (e.g. 100% discount). This flag is available on Sales Invoice and Sales Credit Memo (including their Pane Envelope variants).
US-17: Apply column setup formatting to comment lines instead of description-only rendering
As a Business Manager
I want to render comment lines (blank type) using the full column setup — including all defined columns — rather than the default behaviour where only the description is shown across the full line width
So that comment lines are visually consistent with item lines and align with the column grid, making the document easier to read
Setup:
- In Document Customizer Content for the relevant document row.
- Enable Use Column Setup For Lines With Blank Type.
- Save. Comment lines will now be rendered using the assigned Column Template, with values (or blanks) in each column position rather than as a single full-width description.
Note: This flag is available on all document types except Address Label, Remittance Advice Journal, and Remittance Advice Entries. When enabled together with Hide Lines With Blank Type, the hide flag takes precedence — comment lines will not appear at all.
US-18: Show only item lines on a transfer order print
As a Business Manager
I want to filter the transfer order printout so that only lines of type Item are shown, suppressing any comment or resource lines that may have been added to the order
So that the warehouse only sees the physical stock movements and is not confused by non-inventory lines
Setup:
- In Document Customizer Content for the Transfer Order row.
- Enable Show Only Item Lines.
- Save. Lines where the Type is not Item will be excluded from the printed document.
Note: This flag is currently only available on the Transfer Order report (6082720).
Field Reference
| Field | Where to find it | What it does | Default |
|---|---|---|---|
| Lines Grouping Template | Line Grouping Setup | Unique code identifying this grouping configuration | — |
| Table No. | Line Grouping Setup | Document line table to group (e.g. Sales Invoice Line) | — |
| Low Level Group On Field No. | Line Grouping Setup | Field used for the primary (innermost) grouping of lines | — |
| High Level Group On Field No. | Line Grouping Setup | Field used for the secondary (outer) grouping level | — |
| Subtotal Group On Field No. | Line Grouping Setup | Field at which subtotals reset; defaults to High Level field | — |
| Columns Template | Line Grouping Setup | Column Setup used for rendering group header and subtotal rows | — |
| Subtotal Descr. Column No. | Line Grouping Setup | Column position for the group/subtotal description label | — |
| Subtotal Qty. Column No. | Line Grouping Setup | Column position for the subtotal quantity | — |
| Subtotal Amount Column No. | Line Grouping Setup | Column position for the subtotal amount | — |
| Subtotal UOM Column No. | Line Grouping Setup | Column position for the subtotal unit of measure | — |
| Subtotal U.Price Column No. | Line Grouping Setup | Column position for the subtotal unit price | — |
| Subtotal Line Disc. Column No. | Line Grouping Setup | Column position for the subtotal line discount | — |
| SubTotal/HighLevel Text Column | Line Grouping Setup | Column for the high-level group label text | — |
| LowLevel Text Column No. | Line Grouping Setup | Column for the low-level group label text | — |
| Master Data Information | Line Grouping Setup | MDI rendering: No MDI, First Line only, or All Lines (visible when MDI installed) | No MDI |
| Line Grouping Template | Document Customizer Content | Assigns a Line Grouping Template to this document | Blank |
| Group Empty Bundle Values | Document Customizer Content | Groups blank-value assembly sub-components instead of printing them individually | Disabled |
| Show Lines with Zero Qty. | Document Customizer Content | Shows lines where quantity = 0 | Disabled |
| Show Only Lines With Outstanding Qty. > 0 | Document Customizer Content | Hides lines where outstanding quantity = 0 | Disabled |
| Show Lines with Qty. to Ship > 0 | Document Customizer Content | Shows only lines with a positive Qty. to Ship | Disabled |
| Show Only Lines With Qty. Shipped not Invoiced > 0 | Document Customizer Content | Shows only lines with shipped-but-not-invoiced quantity | Disabled |
| Hide Lines With Line Amount = 0 | Document Customizer Content | Suppresses lines where the line amount is zero | Disabled |
| Hide Lines With Blank Type | Document Customizer Content | Suppresses lines where the line type is blank (comment lines) | Disabled |
| Use Column Setup For Lines With Blank Type | Document Customizer Content | Applies the column setup to blank-type lines instead of using the default description-only rendering | Disabled |
| Show Only Item Lines | Document Customizer Content | Shows only lines of type Item | Disabled |
| Show Assembly Components from Assembly Order | Document Customizer Content | Expands assembly components from the live assembly order demand | Disabled |
| Show Assembly BOM | Document Customizer Content | Expands assembly BOM components below parent lines | Disabled |
| Show Serial/Lot No./Package No. Appendix | Document Customizer Content | Activates the supplementary tracking appendix section | Disabled |
| Hide Warehouse Shipment Lines | Document Customizer Content | Suppresses fully shipped lines on Warehouse Shipment and Posted Warehouse Shipment | Disabled |
| Hide Total Section | Document Customizer Content | Suppresses the entire subtotal/VAT/total summary section below the lines | Disabled |
| Show Shipment | Document Customizer Content | Prints the related shipment number on sales and purchase documents | Disabled |
| Show Total VAT lines even if 0 | Document Customizer Content | Includes VAT rows in the totals section even when the VAT amount is zero | Disabled |