Skip to main content

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.

Important

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.

OptionFunction / Effect
ValueDefines the actual content of the barcode. This can be entered directly as free text or calculated using a formula
AlignmentDetermines the positioning of the barcode itself. Allowed are 'Centered', 'Left' or 'Right'.
FormatThe 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 DisplayThis 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.
EAN8
EAN13
Render Value as TextIf set, the value of the barcode is also displayed as text under the barcode for all formats.
Text PositionIf text is displayed: Controls the positioning of the text in relation to the barcode. Allowed are Top (show above) or Bottom (show below)
Text AlignmentIf text is displayed: Controls the alignment of the text in relation to the barcode. Allowed are 'Centered', 'Left' or 'Right'.
Text MarginIf 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.
HeightThe 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.
WidthOnly 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 FamilyAn optional font used to display the text (see web standards for supported standard fonts).
Font SizeThe optional size to use for the selected font.
Background ColorIf the barcode should be highlighted or correspond to a CI, the background color can be adjusted with this setting
Color of LinesThe 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.

OptionFunction / Effect
Image SourceDefines 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 TextA text which is shown instead of the image in case the picture cannot be displayed.
URL / MailtoAn optional URL to be accessed when the logo is clicked. Alternatively, it can also be designed as maito:EMAILADDRESS.
Height / Maximum HeightControls 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 WidthSimilarly 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.
[Attention]

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).

danger

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.

note

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.

OptionFunction / Effect
Name of the SectionUsed 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.
ValueDefines the actual content of the QR Code. This can be entered directly as free text or calculated using a formula
Alternative TextA 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.
AlignmentThis 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 CodeDepending 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.

SettingFunction / Effect
Name of the SectionUsed 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 / PresentationAllows 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.
AlignmentDefines the alignment of the text within the document. Allowed are Center, Left or Right.
note

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.

OptionFunction / Effect
Show Customer InformationDefines 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 InformationThe display text that should be shown as the preceding text before the actual customer information.
Show Customer NumberDefines whether the customer's number should be displayed, if present in ESR.Ctm.CN.
Display Text: Customer NumberThe 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.

OptionFunction / Effect
Alternative TextA 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.
AlignmentThis 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 CodeDepending 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.
note

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.

Good to Know

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.

SettingFunction / Impact
Article textColumn 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 groupColumn heading for defining the item's tax group.
AmountColumn heading for the total amount of the item (quantity * unit price for the item).
Alignment of the amount fieldIf the display text of the article extends over several lines, the behavior of the amount display can be changed with this option.
Order of fieldsThe 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).

OptionFunction / Effect
Alternative TextA text which is shown instead of the image in case the picture cannot be displayed.
URL / MailtoAn optional URL to be accessed when the logo is clicked. Alternatively, it can also be designed as maito:EMAILADDRESS.
Height / Maximum HeightControls 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 WidthSimilarly 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.
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.