How do I set up RetailVista POS for data exchange with Fiskaly?

io/api/v1.

fi-serial=<serial>

Enter the serial number of the till, like provided by the Fiskaly dashboard. 

fi-tss-id=<tss id>

Enter the TSS ID here like, provided by the Fiskaly dashboard.

fi-tss-cert=<tss certificaat>

Enter the TSS Certificate here, like provided by the Fiskaly dashboard.

io/api/v1 and in the outgoing firewall, this URL must be accessible. In terms of connection, TCP port 443 is used.

fi-vatmappings=<mappings>

With this setting, the internal VAT codes of RetailVista can be mapped to the codes of Fiskaly. Within Fiskaly, the VAT codes A, E, and 0 (zero) are used. A is for high rate German VAT, E is for reduced rate German VAT, and 0 is for 0% VAT. The mappings can be used with 2 letters, where the first letter is the code of the VAT rate in RetailVista and the second letter is A, E, or 0. Multiple letter combinations can be separated by a comma. Example:

HA,LE,G0

This means that VAT code 'H' is converted to Fiskaly code 'A', 'L' to 'E', and G to '0'.

--

In the receipt printer settings, the following information should be copied as a QR code:

<gs>(k<eot><nul>1A2<nul><gs>(k<etx><nul>1C<etx><gs>(k<etx><nul>1E1<gs>(k{qrcode-low}{qrcode-high}1P0{qrcode}<gs>(k<etx><nul>1Q0

By doing this, only a QR code will be printed at the bottom of the receipt, in which all received receipt data from Fiskaly is encoded. If the QR code is left empty in the receipt printer, a number of fixed text fields from Fiskaly will be printed. This does not increase the readability of the receipt, but it is a legal requirement to either print the QR code or the underlying 'meta' data.

--

Fiskaly works differently from the 'Czech' integration. When starting a transaction, it must also be reported to Fiskaly. This is visible when scanning the first product, as a communication session with Fiskaly is started. At that moment, a transaction is started at Fiskaly and it is stored in the transaction XML of RetailVista POS itself.If RetailVista POS is now terminated and restarted, the same transaction ID will be reused until the transaction is paid and closed.

Frequently asked questions about Fiskaly can be found at this URL:

https://developer.fiskaly.com/en/faq/