Hoe stel ik RetailVista POS is voor uitwisseling van gegevens met Fiskaly?

RetailVista POS versie 20.7 en hoger hebben ondersteuning voor uitwisseling van gegevens met Fiskaly. Deze partij verzorgt een correcte wettelijke vastlegging om te voldoen aan de nieuwe Duitse belastingdienst wetgeving rond inrichting van kassa systemen.

Bij deze RetailVista POS versie 20.7 hoort minimaal RetailVista ERP versie 20.12 en hoger.

Er is op dit moment (nog) geen licentie nodig voor fiscale uitwisseling. Er is wel een licentie nodig van Fiskaly zelf om gegevens met hen te mogen uitwisselen.

De Fiskaly integratie wordt alleen actief gemaakt als de land code van de vestiging 'Duitsland' is.

Document QA732 beschrijft de algemene zaken rond een fiscale integratie.

Aan de geavanceerde instellingen van RetailVista POS moeten een aantal gegevens worden toegevoegd voor een correcte werking. De geavanceerde instellingen kunnen opgegeven worden bij de POS terminal categorie en gelden dan voor alle gekoppelde POS terminals. In dat geval moet RetailVista POS wel opnieuw gesynchroniseerd worden. Ook kunnen de instellingen 'lokaal' worden ingevoerd in RetailVista POS. Het nadeel hiervan is dat bij een herinstallatie deze gegevens verloren gaan én dat de gegevens niet centraal vastgelegd zijn, waardoor wijzigingen op alle afzonderlijke POS terminals moeten worden aangebracht. Meerdere instellingen kunnen worden gescheiden door middel van een ; karakter.

De volgende instructies kunnen worden toegevoegd aan de geavanceerde instellingen:

fi-apikey=<api key>

Geef hier de API key op zoals die kan worden aangemaakt vanuit het Fiskaly dashboard.

fi-apisecret=<api secret>

Geef hier de API secret key op zoals die kan worden aangemaakt vanuit het Fiskaly dashboard.

fi-url=<url>

Geef hier een eventueel afwijkende URL op om de Fiskaly host te kunnen bereiken. De URL die standaard gebruikt wordt is https://kassensichv.io/api/v1 en in de uitgaande firewall zal deze URL bereikbaar moet zijn. Qua connectie wordt TCP poort 443 gebruikt.

fi-vatmappings=<mappings>

Met deze instelling kunnen de interne BTW codes van RetailVista gemapped worden naar de codes van Fiskaly. Binnen Fiskaly worden de BTW codes A, E en 0 (cijfer nul) gebruikt. De A is voor hoog tarief Duits BTW, de E voor verlaagd tarief Duits BTW en 0 voor 0% BTW. De mappings kunnen gebruikt worden met telkens 2 letters waarbij de eerste letter de code van het BTW tarief in RetailVista is en de tweede letter een A, E of 0. Meerdere letter combinaties kunnen gescheiden worden door een komma teken. Voorbeeld:

HA,LE,G0

Dit betekent dat BTW code 'H' naar Fiskaly code 'A' wordt omgezet, 'L' naar 'E' en G naar '0'.

--

Bij de bonprinter instellingen moet als QR code de volgende informatie overgenomen worden:

<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

Door dit te doen zal onderaan de kassabon uitsluitend een QR code geprint worden waarin alle ontvangen kassabon data van Fiskaly gecodeerd is. Als de QR code leeg gelaten worden bij de bonprinter dan zullen een aantal vaste tekst velden van Fiskaly geprint worden. De leesbaarheid van de kassabon neemt hierdoor zeker niet toe, maar het is een wettelijke vereiste om óf de QR code te printen, óf de achterliggende 'meta' data.

--

Fiskaly werkt wat anders als de 'Tjechische' integratie. Bij het starten van een transactie moet deze ook gemeld worden aan Fiskaly. Dit is zichtbaar doordat bij het scannen van het eerste artikel er een communicatie sessie met Fiskaly gestart wordt. Op dat moment wordt een transactie gestart bij Fiskaly en wordt deze opgeslagen in de transactie XML van RetailVista POS zelf. Als RetailVista POS nu beeindigd wordt en herstart wordt, dan zal telkens dezelfde transactie ID opnieuw gebruikt wordt, tot het moment dat de transactie afgerekend en gesloten wordt.

Veelgestelde vragen over Fiskaly kunnen worden gevonden via deze URL:

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