Hoppa till huvudinnehållet

Automatisk TSE-ersättning

Harald Krondorfer
  • Uppdaterad

Den här artikeln beskriver hur man konfigurerar automatisk utbyte av den certifierade tekniska säkerhetsenheten (TSE/TSS).

Det kan under vissa omständigheter vara nödvändigt att byta ut en TSE, till exempel:

  • om certifikatet för den TSE som används snart löper ut,
    • och man föredrar att byta till en annan TSE-tillverkare,
  • en hardware TSE är defekt och inte längre kan användas,
  • en Cloud TSE har markerats som ”defekt” av den berörda tillverkaren och inte längre kan användas.

RetailForce erbjuder en tjänst som gör det möjligt att byta ut en TSE automatiskt. Utbytet kan konfigureras så att:

  • en TSE från samma tillverkare eller
  • en från en annan tillverkare används som den nya TSE:n.

I artikeln ”Test – Automatisk TSE-utbyte” förklaras hur man testar funktionen för automatiskt TSE-utbyte.

Kriterier för TSE-utbyte

Förutsättningar för automatisk utbyte

Fiscal Service kan endast utföra utbytet under vissa förutsättningar:

  • Version
    • Version 1.11.18 av Fiscal Middleware måste vara installerad.
  • fiscalCountry
    • Automatisk TSE-ersättning är naturligtvis endast möjlig för tyska system.
  • Konfiguration
    • Automatisk TSE-ersättning måste konfigureras och aktiveras i den aktuella clienten.
  • Tillgänglighet
    • Om en hardware TSE ska användas för utbytet måste en ny hardware TSE också finnas tillgänglig på systemet (ansluten);
    • Om en Cloud TSE ska användas för utbytet måste det vara möjligt att upprätta en internetanslutning till den berörda tillverkaren.
  • Öppna transaktioner
    • Det får inte finnas några öppna transaktioner (createDocument har utförts, men transaktionen har ännu inte slutförts med storeDocument eller cancelDocument).
  • Dagens slut (EndOfDay)
    • Den automatiska ersättningen utförs först efter en daglig avslutning (ett dokument av typen: "[99] = EndOfDay" har bokförts).
  • Licenser
    • Licens för den aktuella TSE:n;
    • Licens för den nya TSE:n (om den skiljer sig från den TSE som för närvarande används);
    • Licens för TSE-utbytet ("TSE Change").

Observera: det automatiska TSE-bytet kommer inte att genomföras om **något av förutsättningarna** inte är uppfyllda. För undantag, se avsnitten ”Certifikatets giltighetstid” och ”Felaktig TSE”.

Observera: För att få statusmeddelanden via e-post angående det automatiska TSE-bytet rekommenderar vi att du väljer en ”Teknisk kontaktperson” i RetailForce portalen (inställning under Organisation: ”Teknisk kontaktperson”).

Licenser

Inställningarna för att byta ut en TSE kan konfigureras när som helst. För att detta ska kunna genomföras måste dock rätt licenser tilldelas.

  • TSE-byte: denna licens krävs för att ett byte överhuvudtaget ska kunna ske,
  • TSE-licenser: en motsvarande licens måste också tilldelas för varje TSE som har konfigurerats (primär och sekundär TSE).

Utlösare för TSE-byte

Om automatiskt TSE-byte är konfigurerat och aktiverat kommer RetailForce systemet att försöka (!) genomföra det automatiska bytet när följande händelser inträffar:

  • TSE-certifikatet har löpt ut eller kommer att löpa ut inom ett angivet tidsfönster,
  • TSE:n är defekt (t.ex. fungerar inte längre, har markerats som ”DEFEKT” av tillverkaren).

Certifikatets giltighetstid

Följande händelseförlopp gäller när certifikatet för den TSE som för närvarande används löper ut och automatisk ersättning har aktiverats:

  • 14 dagar innan certifikatet löper ut: om det inte finns några öppna TSE-transaktioner försöker Fiscal Client genomföra den automatiska ersättningen efter en daglig avstängning (EndOfDay-dokument);
  • Om utbytet inte kunde genomföras framgångsrikt inom de första 7 dagarna (perioden från 14 till 7 dagar innan certifikatet löper ut):
    • från och med 7 dagar innan certifikatet löper ut stängs öppna transaktioner automatiskt av klienten efter ett EndOfDay-dokument och ett försök görs att genomföra ersättningen;
    • från och med 3 dagar före försöker man genomföra förnyelsen efter varje dokument (inte bara efter en EndOfDay); eventuella öppna transaktioner stängs automatiskt;
    • om certifikatet redan har löpt ut: ett försök görs att genomföra ersättningen före varje createDocument.

Obs! Inom 14-dagarsperioden kontrollerar Fiscal Client med varje molntjänst/anslutning om kriterierna för ett byte är uppfyllda och försöker byta ut TSE.

Defekt TSE

Felaktiga TSE:er omfattar till exempel hardware TSE:er som inte längre känns igen av systemet, eller fall där en fiskaly-TSE har satts i statusen ”DEFECTIVE” och inte längre kan användas.

Samma regler gäller för felaktiga TSE:er som i det fall där TSE-certifikatet redan har löpt ut. Före varje createDocument-operation försöker klienten byta ut den felaktiga TSE:n mot en ny.

Observera: I detta fall kan fortfarande öppna transaktioner inte längre avslutas, eftersom signaturer inte längre kan genereras på den gamla TSE:n och den nya TSE:n ”känner inte till de gamla, öppna transaktionerna” (eftersom dessa transaktioner inte initierades på den nya TSE:n, utan på den gamla).

För TSE:er med statusen ”DEFECTIVE” utför Fiscal Client utbytet omedelbart så snart slutpunkten cloud/connect (eller en annan slutpunkt som innebär överföring av cloudApiKey och cloudApiSecret) anropas.

Detta gäller endast om checkboxen ”Aktivera automatisk TSE-ersättning” är markerad (se kapitlet ”Konfiguration”).

Obs: Vid defekta fiskaly Cloud TSE:er rekommenderar vi att man först genomför eller testar utbytet på ett enda live-system (client).

Konfiguration

Automatisk TSE-ersättning definieras via Tysklands konfiguration.

Sedan version 1.11.18 finns följande konfigurationsalternativ tillgängliga i portalen:

  • Val av TSE för utbyte (primär TSE och sekundär TSE)
    • ”Använd för nya klienter” – när en ny klient initialiseras för första gången används en TSE av denna typ,
    • ”Använd vid utbyte” – när ett utbyte ska genomföras används en TSE av denna typ.
  • Alternativ för att aktivera automatisk TSE-ersättning (”Aktivera automatisk TSE-ersättning”)

Observera: automatiskt TSE-utbyte aktiveras endast om checkboxen ”Aktivera automatiskt TSE-utbyte” också är markerad!

Välja en TSE för utbyte

För varje TSE som definierats i konfigurationen (primär TSE och sekundär TSE) kan du ange vilken av dessa TSE:er som ska användas vid den första idrifttagningen och vid utbyten.

Möjliga inställningar

Följande kombinationer är möjliga:

Samma TSE vid utbyte

I detta fall används samma TSE både vid den första idrifttagningen och vid utbyte. För att göra detta måste du:

  • antingen konfigurera en primär TSE eller en sekundär TSE,
  • och ställa in båda alternativen (”Använd för nya klienter” och ”Använd vid utbyte”) för denna TSE.

I exemplet nedan har en sekundär TSE av typen "[3] = Swissbit Cloud 2.0" konfigurerats som sekundär TSE, med båda alternativen markerade.

Detta innebär att varje terminal som tilldelats denna konfiguration använder Swissbit Cloud TSE 2.0 vid aktivering. Om exempelvis certifikatet för den aktiverade TSE:n löper ut aktiveras en ny Swissbit Cloud TSE 2.0.

TSE-replacement-secondary-both-options.png

Som beskrivits ovan sker ersättningen endast om kryssrutan ”Aktivera automatisk TSE-ersättning” också är markerad!

Annan TSE för utbyte

I detta fall konfigureras en specifik TSE för den första idrifttagningen ("Använd för nya klienter") och en TSE från en annan tillverkare konfigureras för eventuellt utbyte. För att göra detta måste du:

  • konfigurera två TSE:er, båda
    • en primär TSE och
    • en sekundär TSE
  • ställa in alternativet ”Använd för nya klienter” för en TSE, och 
  • alternativet ”Använd för utbyten” för den andra TSE:n

I exemplet nedan tas terminalerna i drift med hjälp av den sekundära TSE:n (Fiskaly Cloud TSE). Om kriterierna för automatisk TSE-ersättning är uppfyllda kommer en ny TSE av typen Swissbit Cloud TSE 2.0 att aktiveras och användas från och med det ögonblicket.

TSE-replacement-different-TSE.png

Distribution av konfigurationen

Det finns två alternativ för att distribuera den nya konfigurationen till alla klienter som redan är i drift:

  • Starta automatisk distribution från Cloud-portalen med knappen ”Push Configuration TSE”, eller
  • Uppdatera klientens konfiguration med PUT /api/v1/management/clients/byCloud/{clientId}.

Med båda metoderna överförs den nya konfigurationen – som innehåller regler för TSE-utbyte – till klienten/klienterna.

Push Configuration TSE

Du hittar den här knappen som en action item under menyalternativet ”Configuration” när du har valt (klickat på) den relevanta konfigurationen.

När du trycker på knappen skiljer sig funktionen åt mellan lokala klienter (lokal installation av middleware) och klienter i Cloud Fiscalisation Service:

Funktionssätt för lokal middleware-installation

Denna knapp är endast avsedd för att distribuera konfigurationen och aktivera automatisk TSE-utbyte!

När du trycker på knappen skickas ett kommando till alla anslutna klienter om att ladda ner den aktuella konfigurationen från portalen. I detta sammanhang betyder ”anslutna”: klienter som denna konfiguration är tilldelad direkt eller indirekt (via organisation, företag eller butik).

Clients som inte har en aktiv molnanslutning just då (ingen aktiv anslutning till portalen via ”cloud/connect”) kommer INTE att få den nya konfigurationen.

Det kan därför vara nödvändigt att utlösa ”Push Configuration TSE” flera gånger tills alla klienter har hämtat konfigurationen.

Varje klient rapporterar tillbaka till portalen att konfigurationen har hämtats. En avisering visas via klockikonen (uppe till höger). Dashboardvyn ”TSE-utbyte” ger också en översikt över statusen för TSE-utbytet (se artikel: Dashboard Tyskland – TSE-information).

Hur Cloud-baserad skattehanteringstjänsten fungerar

Precis som vid den lokala installationen utlöses här ett kommando för att uppdatera konfigurationen på klienterna. Kommandot levereras dock först nästa gång klienten anropar funktionen ”cloud/connect”.

Portalen ”kommer ihåg” kommandots status (vilken client som för närvarande inte är ansluten och vilken som redan har hämtat konfigurationen).

Detta innebär att det med Cloud-tjänsten för skattehantering inte är nödvändigt att återaktivera ”Push Configuration TSE”.

Meddelanden

Meddelanden och varningar som rör utbyte av en TSE:

- visas via klockikonen i portalen (uppe till höger),
- visas i logghändelserna (för varje terminal) och-
skickas via e-post.

Klocka

Klockikonen visar följande typer av meddelanden:

- Hardware TSE är inte tillgänglig på det aktuella systemet (inte ansluten),
- Meddelanden som rör PushConfiguration (konfigurationen har hämtats av den aktuella klienten eller kunde inte genomföras).

Logghändelser

Logghändelserna kan nås via motsvarande action item på varje terminal. Den innehåller alla händelser som rör utbytet av TSE på respektive terminal.

E-postmeddelanden

Framgångs- och felmeddelanden kan även skickas via e-post. E-postmeddelanden skickas endast om en teknisk kontaktperson (inställning i Organisation: ”Teknisk kontaktperson”) har valts i portalen.

Meddelanden skickas i omgångar, en gång i timmen.

Den här artikeln har översatts automatiskt.

Relaterade artiklar

Kommentarer

0 kommentarer

logga in för att lämna en kommentar.

Powered by Zendesk