Skip to main content

Quick Start Guide

General Information​

The function for creating a digital receipt has been implemented in the EFR software since version 1.8.4. The digital receipt can be tested on any test-EFR that reports data to the efsta Cloud. Alternatively, the instructions mentioned below to obtain a digital receipt can also be tested on any productive cash register if the appropriate features have already been activated for the company in advance.

tip

To use the digital receipt productively, please contact your partner manager in order to activate the "Simple Bill" or "Smart Bill" feature accordingly. Furthermore, there are two versions available:

  • Up to 60,000 transactions per year
  • Unlimited

If this setup-step was not completed, an error message will be displayed when calling up productively created receipts and the end customer will only receive information that the digital receipt has not been configured for your company!

Variants of the Digital Receipt​

Anonymous receipt via QR code​

A link to the digital receipt is generated on the EFR service after each transaction and can be retrieved via GET request http://localhost:5618/recorder/lastdh. If the cash register is unable to create a QR code, it may also be generated by the EFR service via GET request http://localhost:5618/recorder/lastdh/qr.

Alternatively, the attribute "Tra_DH" can be entered in the EFR profile. For each transaction, the "Document Handle" DH is then returned as an attribute. This, combined with the efsta Digital Receipt URL https://bill.efsta.net/dh?, results in a link to the digital receipt.

info

If a multi-client EFR (multiple POS or multiple companies on a single EFR installation) is used, the correct client must also be specified as the parameter ?rn=CLIENT in order to obtain the correct document link.

The link to the digital receipt must be displayed as a QR code at the cash register so that the customer can scan it with their smartphone. The QR code should be displayed until the next QR code is shown, but not for longer than a certain amount of time to prevent other customers from scanning a receipt that doesn’t belong to them. This time should be chosen according to your own unique situation.

Receipt delivery to the efsta Wallet using efsta customer number​

A customer has already registered in the efsta Wallet and displays their customer number as a barcode/QR code at the cash register. The cashier scans the barcode/QR code, and the cash register sends the efsta customer number as Tra.XID. The customer then receives the digital receipt directly into their efsta Wallet.

<Tra XID="efsta_123456789">
    <ESR>...</ESR>
</Tra> 
{
  "Tra": {
    "XID": "efsta_123456789",
    "ESR": {
      ...
    }
  }
}

Receipt delivery to the efsta Wallet via merchant​

If a receipt is scanned via QR code and the customer is logged into the efsta Wallet application, an association between the customer and customer number in the receipt (Ctm.CN) can be established (if the customer confirms to do so). If successful, all subsequent receipts containing the customer number will be automatically delivered to the efsta Wallet. This function can be configured in the company's settings.

Changes in the cash register: The cash register must send the customer number in the fields ESR.Ctm.CN and Tra.XID.


<Tra XID="123456789">
    <ESR>
        <Ctm CN="123456789"/>
        ...
    </ESR>
</Tra> 
{
  "Tra": {
    "XID": "123456789",
    "ESR": {
      "Ctm": {
        "CN": "123456789"
      },
      ...
    }
  }
}

The customer receives the digital receipt directly into their efsta Wallet.

Note

This feature is currently only available for Single POS and Multi POS, not for Multi-Company EFRs. In the future, this will be added as an option and can then also be used for Multi-Company EFRs, provided that an appropriately updated EFR version is available.

Anonymous receipt by means of one-time delivery (currently under development)​

At the POS, a QR code will be issued which the customer can scan with their mobile phone to display a temporary customer number by means of barcode/QR code. The cashier then scans the phone's barcode/QR code and the cash register sends that temporary efsta customer number as Tra.XID.

<Tra XID="efsta-temp_123456789">
    <ESR>
        ...
    </ESR>
</Tra>
{
  "Tra": {
    "XID": "efsta-temp_123456789",
    "ESR": {
      ...
    }
  }
}

As soon as the receipt is in the efsta cloud, the customer can find this anonymous digital receipt on their mobile phone instead of the barcode/QR code.

Scanning a Fiscal QR Code​

In some EU countries, a QR code is mandatory on the invoice. The efsta Wallet can be used to scan the QR code of a paper receipt, after which it is automatically added to the efsta wallet if the receipt has been stored in the efsta archive. This function must be configured accordingly in the company's settings.

Layout​

Logos for companies and receipts​

The logos that are to be displayed for both the company in the efsta Wallet (Company Overview) and on the receipt itself can be managed via the Management UI (release in November 2023). Each can be chosen and managed separately, whereas the company logo should be in a ratio of 1:1 (square), but the receipt logo does not require a specific ratio. Logos can be uploaded as images in JPEG, PNG, or GIF formats with a maximum size of 400x400 pixels.

Location and company data​

Both location and company data can be maintained directly at the EFR or centrally in the efsta portal. On the digital receipt, the following data is displayed beneath the logo:

  • Company name
  • Address of the location (or company)
  • Tax ID of the company

Additional headers and footers​

The POS can send additional header/footer elements to the EFR service, which are automatically added to the digital receipt.

  • Header elements can be sent as ESR.Head and will be displayed between company data and positions.
  • Footer elements can be sent as ESR.Foot and will be displayed between the controls and fiscal data of the respective country (e.g. QR code).

General layout​

The layout of the digital receipt can be maintained via the Management UI. Various options can be changed for different receipt sections (e.g., receipt header, positions, or footers), such as the texts to be displayed, the positions of elements, or the visibility and arrangement of whole sections. Additionally, custom sections (images, texts, barcodes, and QR codes) can be embedded. Changes can be saved immediately or for a pre-configured period.

Follow-up receipt​

If there is a follow-up receipt to the original (e.g. a payment receipt), it can be sent as ESR.Append (similar to header and footer). Follow-up receipts will be displayed below the invoice. No specific adjustments are currently planned for these.

Example for a Demo Receipt​

The following content can be sent to the EFR in the /record route as the basis for a data record suitable for the digital document.

{
  "Tra": {
    "XID": "08154711-1B",
    "ESR": {
      "TL": "001",
      "TT": "1",
      "Opr": "4711",
      "OprN": "Valentino Pizzeriano",
      "D": "2023-10-03T12:45:00",
      "Test": 1,
      "PosA": [
        { "PN": "1", "Qty": "1", "Amt": 12.5, "Pri": 12.5, "Dsc": "Pizza al Tonno", "TaxG": "B" },
        { "PN": "2", "Qty": "2", "Amt": 19.8, "Pri": 9.9, "Dsc": "Pizza Margerita", "TaxG": "B" },
        { "PN": "3", "Qty": "3", "Amt": 10.5, "Pri": 3.5, "Dsc": "Coca Cola Light", "TaxG": "A" }
      ],
      "Ctm": {
        "CN": "08154711-1B",
        "Nam": "Danielle 'Vito'",
        "Nam2": "Salmone"
      },
      "PayA": [
        { "Dsc": "Cash", "Amt": "2.8", "PayG": "0" },
        { "Dsc": "Credit Card - Visa", "Amt": "40.0", "PayG": "4" }
      ],
      "Head": [
        "We hope you enjoyed your meals and had a good time at Good Food!"
      ],
      "Foot": [
        "We wish you a merry chrsitmas and a happy new year!"
      ],
      "Append": [
        "RECEIPT",
        "17.07.2018      17:03:11",
        "Terminal-ID:    08152269",
        "VU-Nr:         471156249",
        "Invoice-Nr:      00/1234",
        "Trace-Nr:         000814",
        "CONTACTLESS",
        "MASTER CARD",
        "AID:      A0000000055889",
        "Crypto: 0CAAB719CDD11666",
        "No:  ***************0815",
        "SEQ:                 001",
        "E.Mode(R)",
        "PAID",
        "AMOUNT:  EUR        40.00",
        "         ================",
        "         ",
        "-------------------------",
        "THANK YOU",
        "-------------------------"
      ]
    }
  }
}