Quick search:eBay DataTransfer JTL-Worker PayPal

JTL-Links

Thank you for using the English version of the JTL-Guide!
We are currently still building up the English documentation; not all sections have been translated yet. Please note that there may still be German screenshots or links to German pages even on pages that have already been translated. This guide mostly addresses English speaking users in Germany.

Note: On 1 September 2024, JTL introduced new editions that bundle most of the previous individual services into different packages. In order for you to continue working as smoothly as possible, existing customers were automatically switched to the package configuration that best matched their existing contract. The individual packages differ in terms of limitations and/or range of functions. Therefore, some of the features described in the JTL-Guide may not be available to you as part of your booked JTL edition. You can change your package configuration in your JTL customer account. Find out more about the new editions and packages here. Check our FAQ for frequently asked questions about the product editions.

Contents

Setting up the Swissbit TSS

Stand: JTL-POS 1.0.2.0

Your task/initial situation

You want to set up a technical safety system (TSS, TSE in German) for your store. Your device of choice is a JTL-POS-compatible one by Swissbit. You have the choice between an USB flash drive and a MicroSD version.

Supported fiscal modules

JTL-POS generally supports the following fiscal modules from Swissbit:

MicroSD card
SD card
USB flash drive (USB 3.1)

Compatible devices

Swissbit’s fiscal modules can currently be used with the following cash register devices in combination with JTL-POS:

Sunmi P2
Sunmi P2 MINI
Sunmi L2
Sunmi L2s
Sunmi T2
Sunmi T2 Lite
Sunmi T2 Mini
Samsung Tab A
HP Engage One (Prime)
Samsung Tab S
Lenovo Tab
Elo I-Series (3.0)
Elo z30 Pro
iMin Swan 1
HP Engage Essential

The following cash register devices are currently not compatible:

Sunmi P2 PRO
Sunmi P2 Lite
Sunmi L2K
Sunmi T2s
Chromebox: Asus, Lenovo and Acer
Sunmi T2s Lite
Sunmi D2s

Swissbit microSD: Android 11/12/13 compatibility issues

Swissbit does not currently support any Android 11 devices for the microSD solution as multiple changes to the operating system by Google cause incompatibility. We also strongly advise against using Android 12 and 13 as we have observed compatibility issues with those as well.

If you have already purchased a cash register device with Android 11,12 or 13, do not use a Swissbit microSD TSS. Instead, use Deutsche Fiskal or Epson.
If you are already using a Swissbit TSS and have connected it, do not update your cash register device to Android 11 or higher, because after an update the TSS can no longer be addressed by the device. It is not possible to reset the operating system (downgrade) from Android to an earlier version.

The provider Swissbit is working on a solution. Further details are currently unknown to us, but will be published here as soon as available.

Please note: Should you need verification for your documents that confirms the incompatibility of the Swissbit microSD TSS with Android 11, 12 and 13, please contact our support team.

Step 1: Setting up the TSS

The first step is to set up the TSS in JTL-POS.

Switch off the cash register device.
Insert the fiscal module into the designated slot of your cash register device.
Switch on the device and start JTL-POS.

Go to the JTL-POS menu and select Settings > Technical safety system. The dialogue Technical safety system opens.
Tap on the pen icon to edit the TSS settings.
In the Technical Safety System section, select the option Swissbit.
Tap Save and restart app. JTL-POS is automatically restarted and initialises the connection to the technical safety system.

Once JTL-POS is running again, open the Technical safety system dialogue again via Settings > Technical safety device and tap the pencil icon to continue the set up.
Tap on the now visible Link button.

Note: To cancel the setup and start up another provider’s TSS, reset the connection by selecting Reset connection.

In the following dialogue, select whether the TSS is newly set up (option: New TSS) or has already been used with another POS system (option: TSS currently in use).

New TSS: Specify the PUK, the Admin PIN and the Time admin PIN according to the specifications. Confirm your entry to complete the setup.
TSS currently in use: In the following dialogue, enter the PUK that was assigned to the TSS during the initial setup. If you did not assign any PINs and PUKs when you first set up the TSS, please contact your previous POS software provider. Then specify a new PUK, Admin PIN and Time admin PIN according to the specifications. Confirm your entry to complete the setup.

The technical safety system has been successfully set up and is active in the background. Note that there may be short delays in the checkout process due to the additional process.
The technical safety system is now starting up. Wait until successful setup is confirmed by a receipt with the specified PINs and the PUK along with other important information related to the TSS setup. Keep this information safe, otherwise the TSS will no longer be accessible.

A new icon indicating the status of the TSS is now displayed in the top right corner of the cashier dialogue. If the icon is red, the connection to the TSS has been interrupted. Tap the icon to initiate reconnection. For more information, please read the TSS failover help page.

Step 2: Add the TSS information to receipts and business expenses receipts

You must also add the information about the TSS to all receipts and business expenses receipts. Go to Setting up print templates for receipts to learn how to add variables to receipts and business expenses receipts. To do this, use the following variables:

$tse_footer$: Issues the signature of the TSS. The information in the signature comes directly from the TSS and cannot be edited. This variable is obligatory.
$tse_sn$: Serial number of the TSS. According to the German cash register regulation, receipts must either contain the serial number of the cash register or TSS. This variable is optional.
$tse_qr$: Issues the signature of the TSS as a QR code. The QR code can only be added to printed receipts. It is not displayed on receipts sent via email. This variable is optional.

If the TSS signature QR code is not printed correctly, add a line break before the $tse_qr$ variable: <BR>

Please note: The $tse_qr$ variable is not output on digital receipts (PDF), because the graphic of the QR code is only created by the receipt printer.