PDF Printing

Inhaltsverzeichnis

Introduction

The PDF printing module can be used both for the cash register and for the online shop.

Use in cash register

When you complete a sale in the PepperShop cash register, a PDF invoice is generated by default and automatically downloaded. With the PDF printing module, you can customise the design and content of the invoice. You can find out more about this below.

It is also possible to print invoices again. To do this, go to “Customers/Orders” → “Orders”. Here you will see a PDF icon on the right side of the order. When you click on it, you can download the invoice or a delivery note.

Use for online shop

With the PDF printing module, you can print an invoice and a delivery note for your order with one click. The information is automatically adopted and compiled into a PDF document. To do this, go to “Customers/Orders” → “Orders”. Click on the PDF icon to the right of the order. Click on the desired document that you want to print. The invoice or delivery note opens in a new tab and you can print or download the document. With the PDF printing module, you can also customise the design and content of the invoice. You can find out more about this below. Important for 21.AbaNinja users: If you use 21.AbaNinja, depending on the order processing flow, it may make sense to use the 21.AbaNinja invoices and delivery notes.

Module configuration

You can find the module by clicking on “Modules” in the left navigation bar and then on the “PDF Printing” tile. A window with various setting options opens.

Here you can, for example, upload your own PDF templates, activate the module and configure the placement of the individual elements (address, title, product positions, etc.) very precisely.

Tip: The PDF templates should be as empty as possible except for logo and footer.

The PDF module management has the following setting options:

Reset default values

Restore default values: The module is reset to its default values, any configurations are lost and the default values are set.

Configuration for product display

Activation: Should the module be active?
PDF template for first page: A PDF template for the first page is uploaded here. Uploading happens without the save button.
PDF template for subsequent page: A PDF template for the subsequent page is uploaded here. Uploading happens without the save button.
Test view: A test PDF is generated.

Configuration settings address block (address)

Maximum line length (longer lines are wrapped): Here the number of characters that may be on one line at most is defined.
Address block distance from left document edge (in mm): How large should the total distance from the left document edge to the address block be? The specification must be in millimetres.
Address block distance from top document edge (in mm): How large should the total distance from the top document edge to the address block be? The specification must be in millimetres.
Width of address block (in mm): The width of the entire address block. The specification must be in millimetres.
Address block font style: Specify whether the text should be normal, italic, bold, or underlined.
Address block font size in points: What size should the normal font in the address block have?

Configuration settings document title (delivery note)

Title block distance from left document edge (in mm): How large should the total distance from the left document edge to the title block be? The specification must be in millimetres.
Title block distance from top document edge (in mm): How large should the total distance from the top document edge to the title block be? The specification must be in millimetres.
Width of left column (labels): How large should the left column be? The specification should be in millimetres.
Text alignment left column: The alignment of the text within the left column.
Title block font style: Specify whether the text should be normal, italic, bold, or underlined.
Title block font size in points: What size should the normal font in the title block have?

Configuration settings info block (reference no., order date,…)

Info block distance from left document edge (in mm): How large should the total distance from the left document edge to the info block be? The specification must be in millimetres.
Info block distance from top document edge (in mm): How large should the total distance from the top document edge to the info block be? The specification must be in millimetres.
Width of left column (labels): How large should the left column be? The specification should be in millimetres.
Width of right column (contents): How large should the right column be? The specification should be in millimetres.
Width of second left column (when two-column enabled): How large should the second left column be? The specification should be in millimetres.
Width of second right column (when two-column enabled): How large should the second right column be? The specification should be in millimetres.
Text alignment left column: The alignment of the text within the left column.
Text alignment right column: The alignment of the text within the right column.

Configuration settings product table

Invoice, maximum line length of product name (longer lines are wrapped): After how many letters should the content be wrapped?
Delivery, maximum line length of product name (longer lines are wrapped): After how many letters should the content be wrapped?
Product table distance from left document edge in mm: How large should the total distance from the left document edge to the product table be? The specification must be in millimetres.
Product table distance from top document edge (in mm): How large should the total distance from the top document edge to the product table be? The specification must be in millimetres.
Width position column: How wide should the column be that displays the individual positions? The specification must be in millimetres.
Width label column: How wide should the column be that contains the labels? The specification should be in millimetres.
Width quantity column: How wide should the column be that contains the quantity of products? The specification should be in millimetres.
Width unit column: How wide should the column be that contains the unit (pcs., kg etc.)? The specification should be in millimetres.
Width price column: How wide should the column be that contains the prices? The specification should be in millimetres.
Width VAT column: How wide should the column be that contains the VAT? The specification should be in millimetres.
Width total column: How wide should the column be that contains the totals? The specification should be in millimetres.
Text alignment position column: The alignment of the text within the position columns.
Text alignment label column: The alignment of the text within the label column.
Text alignment quantity column: The alignment of the text within the quantity column.
Text alignment unit column: The alignment of the text within the unit column.
Text alignment price column: The alignment of the text within the price column.
Text alignment VAT column: The alignment of the text within the VAT column.
Text alignment total column: The alignment of the text within the total column.

Configuration settings product additional information (variants, options, text fields)

Product additional information font size in points: What size should the normal font in the product additional information have?
Product additional information font style: Specify whether the text should be normal, italic, bold, or underlined.

Configuration settings (product) images

Product images: Display in invoice
Product images: Display in delivery note
Product images: Maximum height
Product images: Maximum width
General images: Resolution in dpi (dpi = Dots per Inch = points per inch)

Product images are always taken from the current assortment (identified by the internal product ID). If a product is removed from the assortment or its image has been changed in the meantime, this will also affect the invoice/delivery note printing. It must also be taken into account that only images in the formats JPG and PNG (8-bit only) can be displayed.

Configuration settings total positions

Width currency column: How wide should the column be that contains the currency column? The specification should be in millimetres.
Width total column: How wide should the column be that contains the total column? The specification should be in millimetres.
Text alignment label column: The alignment of the text within the label column.
Text alignment currency column: The alignment of the text within the currency column.
Text alignment total column: The alignment of the text within the total column.

Configuration settings page number/page total

Page number distance from left document edge (in mm): How large should the total distance from the left document edge to the page number/page total be? The specification must be in millimetres.
Page number distance from top document edge (in mm): How large should the total distance from the top document edge to the page number/page total be? The specification must be in millimetres.
Font style: Specify whether the text should be normal, italic, bold, or underlined.
Font size in points: What size should the normal font in the address block have?
Alignment: The alignment of the text of the page number/page total.

Configuration settings invoice payment deadline

Since invoices are not created in the shop in 21.Commerce, this configuration section is ignored.

Display payment deadline (only for invoice PDF document): Display in invoice
Payment deadline: Number of days: Specification in days

General configuration

Text colour red component of RGB: The red component of the text colour for the PDF.
Text colour green component of RGB: The green component of the text colour for the PDF.
Text colour blue component of RGB: The blue component of the text colour for the PDF.
Font name: Select the font for the PDF here.
Font style: Specify whether the text should be normal, italic, bold, or underlined.
Font size in points: What size should the normal font have?
Page margin top: Specify the page margin in millimetres from the top edge.
Page margin right: Specify the page margin in millimetres from the right edge.
Page margin bottom: Specify the page margin in millimetres from the bottom edge.
Page margin left: Specify the page margin in millimetres from the left edge.
Output orientation grid over entire document: Places a helper grid over the entire PDF so that the alignment can be checked.
Display prices incl. VAT.

Email configurations

Send delivery note to customer: If activated, the customer automatically receives an email with the delivery note after the order.

Send delivery note to shop operator: If activated, the shop operator automatically receives an email with delivery note as soon as an order has been placed.

Operation

To generate a delivery note or invoice, click on “Customers / Orders” in the left navigation bar and then on “Orders”. Click on the PDF icon next to the desired order and select the desired document. This will now be downloaded.

Further help

If you have any questions or problems, our support team will be happy to help. To do so, open a support ticket:

Go to the Swiss21 portal.
Click on your profile picture in the top right corner.
Click on “Support”.
Click on “Contact support”.
Fill out the form and our support team will get back to you as soon as possible.

Support opening hours: Monday – Friday I 8:00 a.m. – 12:00 p.m. I 1:30 p.m. – 5:00 p.m.