Simple Bill - Layout Sections
Custom Sections
Custom Barcodes
Barcode Section
Similar to QR codes, additional information in the form of a barcode can be added to any part of the receipt. Depending on the intended use, the display and format type of the barcode can be set according to the respective requirements. For example, information for later handling in other systems (e.g. return code for complaints or warranty cases, reference to the receipt itself, and so on) can also be displayed and processed by systems that cannot process QR codes (e.g. due to scanner hardware that is too old).
As with QR codes, a fixed text or a formula can be used for barcodes. Compared to QR codes however, barcodes have the additional restriction that no line breaks may be included, otherwise the code will be invalid.
The barcode format which is used also defines which characters and content, as well as any checksums, must be observed. These can be found in the respective format standard.
Option | Function / Effect |
---|---|
Value | Defines the actual content of the barcode. This can be entered directly as free text or calculated using a formula |
Alignment | Determines the positioning of the barcode itself. Allowed are 'Centered', 'Left' or 'Right'. |
Format | The format to be used for the barcode. Depending on this format, the display of the barcode changes, resulting in different characters and content being permitted. |
Flat Style Display | This setting is only available for EAN8 and EAN13. It controls whether the text is “integrated” into the barcode or displayed directly below it, as with the other formats. |
Render Value as Text | If set, the value of the barcode is also displayed as text under the barcode for all formats. |
Text Position | If text is displayed: Controls the positioning of the text in relation to the barcode. Allowed are Top (show above) or Bottom (show below) |
Text Alignment | If text is displayed: Controls the alignment of the text in relation to the barcode. Allowed are 'Centered', 'Left' or 'Right'. |
Text Margin | If text is displayed: If specified and not equal to 0, this value will be used as distance between text and barcode. With this feature it is easier to free up the text or to emphasize whether the text belongs to the barcode. The value can also be negative, but this should be used with caution. |
Height | The desired height of the barcode in pixels. Depending on your preference or the quality of the expected barcode scanner, the barcode can be made larger or smaller. |
Width | Only two options are available at the moment: Small and Large. Depending on the number of characters displayed, this can be changed accordingly to improve the readability for scanner hardware. |
Font Family | An optional font used to display the text (see web standards for supported standard fonts). |
Font Size | The optional size to use for the selected font. |
Background Color | If the barcode should be highlighted or correspond to a CI, the background color can be adjusted with this setting |
Color of Lines | The lines can also be displayed to match the background color. This must be chosen carefully in combination with the background to ensure good contrast and therefore scanner readability, as well as a fitting appearance in both the light and dark themes of the efsta wallet |
Custom Images
Images are used to expand the presentation of information on the receipt. Both static content (.png / .jpg / .jpeg) and animated images (.gif) can be used. It is recommended that the images don't disturb the viewer too much or distract from the actual content.
Option | Function / Effect |
---|---|
Image Source | Defines the source of the image. URLs to existing images (e.g. in your own system, web shop, etc.), as well as complete images in Base64 can be specified here. |
Alternative Text | A text which is shown instead of the image in case the picture cannot be displayed. |
URL / Mailto | An optional URL to be accessed when the logo is clicked. Alternatively, it can also be designed as maito:EMAILADDRESS . |
Height / Maximum Height | Controls the behavior of the image's height. It specifies the desired size of the image, but the maximum height limits this (e.g. not to extend beyond the limits of the document). Specification possible in pixels or percent |
Width / Maximum Width | Similarly to the height, the behavior of the width can be configured. Both values (height and width) should match each other as to not generate a distorted image. |
Please note that you must have the necessary rights to the image in order to use it (especially when adding a URL to a system outside of your own system's jurisdiction).
It is furthermore prohibited to use images which contain pornographic or otherwise offensive content.
Custom QR Codes
Custom QR Codes
Additionally to the main QR Code, more codes can be displayed for easier interactions with bill recipients and end customers. These can refer to further content, for example via URLs or telephone numbers, but can also contain data for other systems (e.g. payment instructions in banking apps).
The contents of the QR codes can either be static fixed texts (one-time configuration in the receipt layouts) or can also be calculated dynamically using a formula based on the information contained in the ESR (in order to retrieve customer numbers, receipt numbers, amounts, etc.). These forms are explained in detail in a separate section in the documentation.
Changes to the QR Code regarding the content are only updated when you leave the field in order to avoid excessive load on the local system due to constant re-rendering of the QR Code.
Option | Function / Effect |
---|---|
Name of the Section | Used as heading for the section. The name is used to identify the section in the overview and if there are several sections of the same type. |
Value | Defines the actual content of the QR Code. This can be entered directly as free text or calculated using a formula |
Alternative Text | A text which is shown instead of the QR code in case the latter cannot be displayed. Failure of the QR code rendering should usually only happen if there are problems on the end device, for example if JavaScript is blocked. |
Alignment | This allows the positioning of the QR code to be adjusted. The possible values are 'Centered', 'Left' or 'Right'. By default, the QR code is displayed centered. |
Size of the QR Code | Depending on the desired appearance, the size of the QR code can be adjusted. Since the QR Code is square, this setting is automatically applied to both width and height. |
Custom Texts
Text Area
Text areas can be used to embed additional texts for the current receipt layout in the final receipt. These can be freely defined and can either be the content of an existing field within in the ESR (e.g. an optionally supplied text) or a fixed text that is the same for all documents.
Setting | Function / Effect |
---|---|
Name of the Section | Used as heading for the section. The name is used to identify the section in the overview and when there are several sections of the same type. |
Text Style / Presentation | Allows you to select a specific style for the presentation of the text. In addition to "Default", you can also select one of six heading styles as well as bold, italic or underlined text. |
Value (Fixed Text or Formula) | The actual value for the text area is defined by this content. It can be a fixed, free text, as well as a value constructed via Formulas. |
Alignment | Defines the alignment of the text within the document. Allowed are Center , Left or Right . |
Previously there was a distinction between ESR property and free text. With the introduction of formula support (see "Dynamic content") for user-defined text areas, the ESR properties can now be mapped directly and much more flexibly via formulas.
ESR Sections
ESR Customer
ESR Customer
If the receipt contains customer information, it can be displayed in this section. There are two different pieces of information which can also be configured separately: customer and customer number.
Option | Function / Effect |
---|---|
Show Customer Information | Defines whether the customer's specified information should be displayed on the receipt. This information includes the customer's name and address, if provided in ESR.Ctm . |
Display Text: Customer Information | The display text that should be shown as the preceding text before the actual customer information. |
Show Customer Number | Defines whether the customer's number should be displayed, if present in ESR.Ctm.CN . |
Display Text: Customer Number | The display text that appears before the actual customer number. This text can be chosen freely, according to your own requirements (e.g. customer loyalty program 'Bonus Club No.') |
ESR FisCode
ESR FisCode
For most generated receipts, a FisCode is printed as the end result on classic print receipts. This section displays the digital version of the FisCode as a QR code. Furthermore, the options allow you to adjust the display and behavior of the code.
Option | Function / Effect |
---|---|
Alternative Text | A text which is shown instead of the QR code in case the latter cannot be displayed. Failure of the QR code rendering should usually only happen if there are problems on the end device, for example if JavaScript is blocked. |
Alignment | This allows the positioning of the displayed QR code to be adjusted. The possible values are 'Centered', 'Left' or 'Right'. By default, the QR code is centered. |
Size of the QR Code | Depending on the desired appearance, the size of the QR code can be adjusted. Since the QR Code is square, this setting is automatically applied to both width and height. |
Please make sure that the QR code size is displayed correctly when configuring it. Since the content of the QR code can differ in length depending on the country, it may be possible that certain countries require a larger QR code so that it can be easily recognized by smartphone cameras with low resolution.
The QR code may be scanned by the respective auditor during financial audits (if the efsta Digital Receipt is desired as a fiscally correct document).
ESR FisTag
ESR FisTag
The FisTag section allows you to display the fiscal information which is generated when a document is created.
Depending on the country, the content may vary (such as information about the signature unit used, its algorithm or the basic data required to create the signature).
If there are also entries in the ESR.Fis.Tag
section, they are put into a table (consisting of the value Label
as the heading and Value
for the actual value of the line).
This option can only be hidden, there are currently no other options.
ESR Footer
ESR Footer
The footer can be delivered as optional content in the ESR and will be displayed in this
area if available. The settings allow you to adjust the alignment of the text (similar to ESR
Header). The possible values are Center
, Left
or Right
ESR Head
ESR Head
If one (or more) headers are included in the ESR data, this section is displayed and represents that
information. The horizontal alignment of the content can be configured and you can choose
between Center
, Left
or Right
.
ESR Operator
ESR Operator
As optional information, you may include the cashier / salesperson / operator on the receipt. This section provides that information if available. Since the name of the field can differ depending on the company's field of activity or corporate identity, the name can optionally be set as free text.
ESR Payment Array
ESR Payment
The means of payment used for the receipt are displayed here. These come from the ESR.PayA
list and are displayed one after the other in a list.
This section can only be hidden - further options are not available at the moment.
ESR Position Array
ESR Positions
Every digital document should contain a list of items. They describe the actual content of the document and the composition of the totals, etc. These include details such as the item number, description, price, quantity and similar information. The display options for this list of positions can therefore be configured in this section.
Setting | Function / Impact |
---|---|
Article text | Column heading for all information describing the item. This is not only the name of the item but also (if available) its item number, the quantity and the unit price of the item. |
Tax group | Column heading for defining the item's tax group. |
Amount | Column heading for the total amount of the item (quantity * unit price for the item). |
Alignment of the amount field | If the display text of the article extends over several lines, the behavior of the amount display can be changed with this option. |
Order of fields | The order of the three article fields can be changed using drag and drop. The fields are then displayed one after the other in rows. |
ESR Tax Array
ESR Taxes
All tax information specified in the receipt (from the ESR.TaxA
field) is also displayed here
in a list. The options allow you to adjust the respective display texts of the column headings if
other labels are preferred.
ESR Total
ESR Total
This receipt section describes the final total of the receipt. Usually, the sums of all
items are added together and given as a total, stored in the ESR.Total
field. The
style of the total can be adapted to the display text, depending on your own needs and
requirements.
Header Sections
Header Configuration
Header Configuration
This section contains relevant information about the company and/or location where the document was issued. This data comes either from the master data of the efsta portal (which is stored at the company node), or from the config if available (which is stored directly at the EFR). The latter may be more specific and is therefore the preferred source of information.
The additional option here controls how the name will be displayed. If this option is selected, the name of the company/location will be displayed as a heading (larger and thicker). This style is also applied automatically if no receipt logo has been configured.
The 'other source' settings allow you to customize the data source, which can be selected for the company name and its address.
The data comes from the Cfg
object in the document data. A distinction can be made between the company data (Cfg.Cmp
) and the location data Cfg.Loc
.
Depending on which information is required, the respective option can be selected in the selection lists. By default, the name is taken from the company data and the address from the location data.
Header Logo
Header Logo
This section is usually the top of the document and contains the logo which is used for the document display. The document logo can be chosen in the settings of the document layout (outside the section itself).
Option | Function / Effect |
---|---|
Alternative Text | A text which is shown instead of the image in case the picture cannot be displayed. |
URL / Mailto | An optional URL to be accessed when the logo is clicked. Alternatively, it can also be designed as maito:EMAILADDRESS . |
Height / Maximum Height | Controls the behavior of the logo's height. Height specifies the desired height of the image, but the maximum height limits this (e.g. not to extend beyond the limits of the document). Specification possible in pixels or percent |
Width / Maximum Width | Similarly to height, behavior of the width can be configured. Both values (height and width) should match each other as to not generate a distorted image. |
Footer Sections
Receipt Footer
Receipt Footer
Usually, the date of the receipt, as well as the cash register number and receipt number are displayed at the end of the receipt. Like with other sections, the display texts for the respective information can be adapted according to your own needs.