Receipt Layout

Layout

For printing a fiscal transaction, the data has to be formatted, which is done using the HTML templating engine PUG (former JADE). Language details can be found on pugjs.org.

For Lithuanian fiscal printers, the item description and additional text lines may be formatted freely, but referring amounts are created by the printer in a fixed format.

The following rules occur for fiscal receipts:

Fixed header lines and header logo graphics are configured on setup by Strongpoint
One transaction specific barcode may be printed in the last line of the footer
The paper is cut after completion of the print

You can start http://localhost:5618/peri/pugedit for layout configuration, it works as a WYSIWYG editor.

Besides fiscal.pug different non-fiscal layout files can be provided on directory /EFR/rn/def/cfg, the file name is derived from the NF or DT tag: NF="Login" => "login.pug" (filename lowercase). If it is required to store non-fiscal transactions without having printed them, set ESR tag Document Delivery DD="noprint".

For non-fiscal printouts:

The whole print line width can be used
Lines can be formatted, like emphasized with <em> or double height with <h3>

PUG Editor

Workflow:

Start http://localhost:5618/peri/pugedit with a browser
[Open] e.g. file /EFR/rn/def/cfg/fiscal.pug
Copy your sample transaction data into the textbox at the left side
The right side box shows the transaction data transformed to HTML
Modifications in PUG code (center box) are shown immediately
When finished [Download] e.g. as fiscal.pug and copy it to /EFR/rn/def/cfg/

EFR now transforms every transaction into HTML and renders it to the line printer. By their nature, fiscal printers provide only very limited formatting functionality.

At the moment, the editor implementation is fairly basic, but it is going to be evolved as base technique for transaction rendering and print layout.

Layout Example

//- fiscal.pug - Layout for Fiscal Transactions
-
    function fStr(str) { return str || str === 0 ? str.toString().replace(/\r/g, '') : '' }
    function fDec(dec) { return fStr(dec).replace(/\./, ',') }
    function fAmt(Amt) { return fDec(Amt && Amt.toFixed ? Amt.toFixed(2) : Amt) }
    function fPrc(Prc) { return fDec((Prc+'%').replace(/%%$/, '%')) }
    function fD(D)     { return D.substr(8, 2) + '-' + D.substr(5, 2) + '-' + D.substr(2, 2) }
    function fTime(D)  { return D.substr(11, 8).replace(/^0/, '') }

mixin pos(p)
    if p.TaxG
        .Dsc= fStr(p.Dsc)
        .TaxG= fStr(p.TaxG)
    else
        .Dsc2= fStr(p.Dsc)
    if p.Amt
        .Amt= fAmt(p.Amt)
    else
        .Amt= fStr(p.LAmt)

mixin tot(t)
    .Disp
        hr
    .Tot
        .Dsc2 TOTAL
        .Amt= fAmt(t)
    .Disp
        hr

mixin pay(p)
    if p.Amt
        .DscTxt= fStr(p.Dsc)
        .Amt= fAmt(p.Amt)
    else
        .DscTxt= ' ' + fStr(p.Dsc)
        .Amt= fStr(p.LAmt)

mixin tax(t)
    .DscTax
        .Prc= fPrc(t.Prc)
        .Net= fAmt(t.Net)
        .TAmt= fAmt(t.TAmt)
    .TaxG= fStr(t.TaxG)
    .Amt= fAmt(t.Amt)

mixin head(h)
    if h
        br
        each v, k in h
            if '_' !== k
                .Txt= v._ ? fStr(v.value) : fStr(v)

mixin foot(f)
    if f
        br
        each v, k in f
            if '_' !== k
                .TxtCenter= v._ ? fStr(v.value) : fStr(v)

html
    head
        title= ESR.DT||ESR.NF||'Receipt'
        style(type='text/css').
            body {
                font-family: Consolas, 'Courier New';
                width: 42ch;
                background-color: white;
            }
            .Txt { white-space: pre; }
            .TxtCenter {
                white-space: pre;
                text-align: center;
            }
            .Net, .TAmt, .TaxG, .Amt { text-align: right; }
            .Pos, .Mod, .Lin, .Tot, .Pay, .Tax, .ItemHead {
                display: grid;
                grid-template-columns: 33ch 1ch 8ch;
            }
            .Dsc { grid-column: 1; }
            .Dsc2, .DscTxt { grid-column: 1 / span 2; }
            .DscTxt { white-space: pre; }
            .TaxG { grid-column: 2; }
            .Amt { grid-column: 3; }
            .DscTax {
                width: 90%;
                display: grid;
                grid-template-columns: 4fr 10fr 10fr;
            }
            .Print { display: none; }
            @media fiscal {
                .Disp, .Tax, .Tot { display: none; }
                .Print { display: block; }
            }
    body

        //- Logo
        .TxtCenter.Disp
            //- img(src='data:image/png;base64,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')
            //- br
            //- br

        //- Display Cfg company data
        if Cfg && Cfg.Cmp && Cfg.Cmp.Nam
            .TxtCenter.Disp= fStr(Cfg.Cmp.Nam)

        //- Display Cfg Location data
        if Cfg && Cfg.Loc && Cfg.Loc.Adr
            .TxtCenter.Disp= fStr(Cfg.Loc.Adr) + ' ' + fStr(Cfg.Loc.Zip) + ' ' + fStr(Cfg.Loc.City)
            .TxtCenter.Disp= 'TaxId: ' + fStr(Cfg.Cmp.TaxId)
            .TxtCenter.Disp
                br

        //- Header
        +head(ESR.Head)

        //- Itemheader
        .Disp
            hr
        .Lin.Disp
            .Dsc Item
            .TaxG %
            .Amt Amt
        .Disp
            hr

        //- required, do not change
        each p in ESR.PosA||[]
            div(class=p._)
                +pos(p)
        +tot(ESR.T)
        each p in ESR.PayA||[]
            div(class=p._)
                +pay(p)
        if ESR.TaxA
            each t in ESR.TaxA
                div(class=t._)
                    +tax(t)
        
        //- Footer
        .Disp
            br
        +foot(ESR.Foot)
        .Disp
            hr
        br
        .TxtCenter= 'Terminal: ' + fStr(ESR.TL) + '/' + fStr(ESR.TT) + '  ' + fStr(ESR.DT || ESR.NF || 'Receipt') + ': ' + fStr(ESR.TN)
        .TxtCenter= fD(ESR.D) + ' ' + fTime(ESR.D)
        br

Restrictions

The fiscal printer only allows layout of header- and footer lines, as well as item text, but the amounts are formatted by the printer itself.

warning

Although transaction data usually is provided with UTF-8 encoding, not all characters can be printed. E.g. printing of the Euro symbol is not allowed.

Barcode

Not supported in current BETA version.

Receipt Layout

Layout​

PUG Editor​

Layout Example​

Restrictions​

Barcode​

Layout

PUG Editor

Layout Example

Restrictions

Barcode