======= PDF Matter =======

PDF Matter lets you set up PDF pages that are attached to the **front** and **end** of printed invoices and sales documents. A **front** page is printed before the invoice body (for example a cover page, letterhead or terms sheet), and an **end** page is printed after it (for example a payment slip, guarantee or back page). Each PDF matter record is linked to an **Address Group**, so different customer groups can automatically get their own front and end pages.

  - **Create** a PDF front or end page and link it to an address group (Sales → Master Data → PDF Matter)
  - **Load** a PDF file into the record, preview it, and save it
  - **Delete** records you no longer need

===== How do I create a PDF matter? =====

  - Go to ''Sales'' → ''Master Data'' → ''PDF Matter''.
  - Click the ''New'' action (or the create button in the toolbar).
  - In the editor fill in the fields:
    - ''Order By'' — a number that controls the order in which matching records are picked.
    - ''Type'' — choose the matter type: ''Sales Front'' for a front page, or ''Sales End'' for an end page.
    - ''Address Groups'' — select the address group(s) this PDF should apply to.
    - ''PDF Matter'' — load the actual PDF file.
  - Click ''Save'' to keep the record.

===== How do I load or view the PDF file? =====

  - In the editor, under ''PDF Matter'', click the ''Load'' button.
  - In the file chooser, select a PDF file (files ending in ''.pdf'').
  - The first page(s) of the PDF are shown as a preview image in the editor.
  - Click the ''View'' button to open the full PDF in a viewer.
  - Click the ''Clear'' button to remove the loaded PDF from the record.
  - Click ''Save'' to store the changes.

===== How do I view or edit a PDF matter? =====

  - Go to ''Sales'' → ''Master Data'' → ''PDF Matter''.
  - Select the row and click the ''Edit'' action, or double-click the row.
  - The list shows the ''Order By'', ''ID'', ''Type'', ''Address Groups'' and ''Updated At'' columns (the ''Created At'' column is hidden).
  - Change any of the fields and click ''Save''.

===== How do I delete a PDF matter? =====

  - Go to ''Sales'' → ''Master Data'' → ''PDF Matter''.
  - Select the rows you want to remove.
  - Click the ''Delete'' action.
  - A confirmation asks "Are you sure X selected items?" — click ''Yes'' to delete, or ''No'' to cancel.

===== What are the different types? =====

A PDF matter can be one of two types:

  - ''Sales Front'' — a page printed at the front of the invoice or sales document.
  - ''Sales End'' — a page printed at the end of the invoice or sales document.

===== How are PDF matter records used? =====

When an invoice or sales document is printed, the system looks for a matching PDF matter of the required type for the customer's address group. Records can apply to all address groups (no group set) or to one or more specific groups. Matching is by ''Order By'' then ''ID'', so the record with the lowest ''Order By'' value is chosen first.

===== Who can access this screen? =====

The PDF Matter screen requires the **Sales → Sales Matter** permission.

|| Menu path | Permission required ||
|| ''Sales'' → ''Master Data'' → ''PDF Matter'' | **Sales → Sales Matter** ||