Gå til hovedindhold

Automatisk udskiftning af TSE

Harald Krondorfer
  • Opdateret

Denne artikel beskriver, hvordan man konfigurerer den automatiske udskiftning af den certificerede tekniske sikkerhedsenhed (TSE/TSS).

Det kan under visse omstændigheder være nødvendigt at udskifte en TSE, f.eks.:

  • hvis certifikatet for den anvendte TSE er ved at udløbe,
    • og man foretrækker at skifte til en anden TSE-producent,
  • en hardware TSE er defekt og ikke længere kan bruges,
  • en Cloud TSE er blevet markeret som 'defekt' af den relevante producent og ikke længere kan bruges.

RetailForce tilbyder en tjeneste, der gør det muligt at udskifte en TSE automatisk. Udskiftningen kan konfigureres, så:

  • en TSE fra samme producent eller
  • en fra en anden producent anvendes som den nye TSE.

Artiklen »Test – Automatisk udskiftning af TSE« forklarer, hvordan man tester funktionen til automatisk udskiftning af TSE.

Kriterier for udskiftning af TSE

Forudsætninger for automatisk udskiftning

Fiscal Service kan kun foretage udskiftningen under visse betingelser:

  • Version
    • Version 1.11.18 af Fiscal Middleware skal være installeret.
  • fiscalCountry
    • Automatisk TSE-udskiftning er naturligvis kun mulig for tyske systemer.
  • Konfiguration
    • Automatisk TSE-udskiftning skal konfigureres og aktiveres i den relevante client.
  • Tilgængelighed
    • Hvis der skal anvendes en hardware TSE til udskiftningen, skal der også være en ny hardware TSE tilgængelig på systemet (tilsluttet);
    • Hvis der skal anvendes en Cloud TSE til udskiftningen, skal det være muligt at oprette en internetforbindelse til den relevante producent.
  • Åbne transaktioner
    • Der må ikke være åbne transaktioner (createDocument er blevet udført, men transaktionen er endnu ikke afsluttet ved hjælp af storeDocument eller cancelDocument).
  • Dagens afslutning (EndOfDay)
    • Den automatiske udskiftning udføres først efter en daglig afslutning (der er bogført et dokument af typen: "[99] = EndOfDay").
  • Licenser
    • Licens til den nuværende TSE;
    • Licens til den nye TSE (hvis den adskiller sig fra den TSE, der aktuelt er i brug);
    • Licens til TSE-udskiftningen ("TSE Change").

Bemærk: Den automatiske TSE-udskiftning udføres ikke, hvis **nogen af forudsætningerne** ikke er opfyldt. Se afsnittene "Certifikatets udløb" og "Defekt TSE" for undtagelser.

Bemærk: For at modtage statusmeddelelser via e-mail vedrørende den automatiske TSE-udskiftning anbefaler vi, at du vælger en »Teknisk kontaktperson« i RetailForce portalen (indstilling under Organisation: »Teknisk kontaktperson«).

Licenser

Indstillingerne for udskiftning af en TSE kan konfigureres når som helst. For at dette rent faktisk kan finde sted, skal de korrekte licenser dog være tildelt.

  • TSE-udskiftning: denne licens er påkrævet for, at en udskiftning overhovedet kan finde sted,
  • TSE-licenser: Der skal også tildeles en tilsvarende licens til hver TSE, der er konfigureret (primær og sekundær TSE).

Udløser for TSE-udskiftning

Hvis automatisk TSE-udskiftning er konfigureret og aktiveret, vil RetailForce systemet forsøge (!) at gennemføre den automatiske udskiftning, når følgende begivenheder indtræffer:

  • TSE-certifikatet er udløbet eller udløber inden for et angivet tidsvindue,
  • TSE'en er defekt (f.eks. fungerer den ikke længere eller er blevet markeret som 'DEFEKT' af producenten).

Certifikatets udløb

Følgende rækkefølge af begivenheder gælder, når certifikatet for den aktuelt anvendte TSE udløber, og automatisk udskiftning er aktiveret:

  • 14 dage før certifikatet udløber: hvis der ikke er nogen åbne TSE-transaktioner, forsøger Fiscal Client at udføre den automatiske udskiftning efter en daglig afslutning (EndOfDay-dokument);
  • hvis udskiftningen ikke kunne gennemføres inden for de første 7 dage (perioden fra 14 til 7 dage før certifikatets udløb):
    • Fra 7 dage før certifikatets udløb lukkes åbne transaktioner automatisk af klienten efter et EndOfDay, og der forsøges at gennemføre udskiftningen;
    • fra 3 dage før forsøges udskiftningen gennemført efter hvert dokument (ikke kun efter en EndOfDay); eventuelle åbne transaktioner lukkes automatisk;
    • hvis certifikatet allerede er udløbet: der forsøges at gennemføre udskiftningen før hver createDocument.

Bemærk: Inden for 14-dagesperioden kontrollerer Fiscal Client hos hver cloud/connect, om kriterierne for en udskiftning er opfyldt, og forsøger at udskifte TSE'en.

Defekt TSE

Fejlbehæftede TSE'er omfatter f.eks. hardware TSE'er, der ikke længere genkendes af systemet, eller tilfælde, hvor en fiskaly-TSE er blevet sat til status 'DEFECTIVE' og ikke længere kan bruges.

De samme regler gælder for defekte TSE'er som i tilfælde, hvor TSE-certifikatet allerede er udløbet. Før hver createDocument-operation forsøger clienten at udskifte den defekte TSE med en ny.

OBS: I dette tilfælde kan stadig åbne transaktioner ikke længere afsluttes, da der ikke længere kan genereres signaturer på den gamle TSE, og den nye TSE »kender ikke til de gamle, åbne transaktioner« (da disse transaktioner ikke blev indledt på den nye TSE, men på den gamle).

For TSE'er med status 'DEFECTIVE' foretager Fiscal Client udskiftningen straks, så snart endpointet cloud/connect (eller et andet endpoint, der involverer overførsel af cloudApiKey og cloudApiSecret) kaldes.

Dette gælder kun, hvis checkboxen »Aktiver automatisk TSE-udskiftning« er markeret (se kapitlet »Konfiguration«).

Bemærk: I tilfælde af defekte fiskaly Cloud TSE'er anbefaler vi, at udskiftningen først udføres eller testes på et enkelt live-system (client).

Konfiguration

Automatisk TSE-udskiftning defineres via den tyske konfiguration.

Siden release 1.11.18 har følgende konfigurationsmuligheder været tilgængelige i portalen:

  • Valg af TSE til udskiftning (primær TSE og sekundær TSE)
    • "Brug til nye klienter" – når en ny klient initialiseres for første gang, anvendes en TSE af denne type,
    • "Brug til udskiftninger" – når der skal foretages en udskiftning, anvendes en TSE af denne type.
  • Mulighed for at aktivere automatisk TSE-udskiftning ("Aktivér automatisk TSE-udskiftning")

OBS: Automatisk udskiftning af TSE aktiveres kun, hvis checkboxen "Aktiver automatisk udskiftning af TSE" også er markeret!

Valg af en TSE til udskiftning

For hver TSE, der er defineret i konfigurationen (primær TSE og sekundær TSE), kan du angive, hvilken af disse TSE'er der skal bruges ved den første idriftsættelse og ved udskiftninger.

Mulige indstillinger

Følgende kombinationer er mulige:

Samme TSE til udskiftning

I dette tilfælde anvendes den samme TSE både ved den indledende idriftsættelse og i tilfælde af udskiftning. For at gøre dette skal du:

  • enten konfigurere en primær TSE eller en sekundær TSE
  • og aktivere begge indstillinger ("Brug til nye klienter" og "Brug til udskiftninger") for denne TSE.

I eksemplet nedenfor er en sekundær TSE af typen "[3] = Swissbit Cloud 2.0" konfigureret som sekundær TSE, hvor begge indstillinger er valgt.

Dette betyder, at hver terminal, som denne konfiguration er tildelt, bruger Swissbit Cloud TSE 2.0 under aktiveringen. Hvis f.eks. certifikatet for den aktiverede TSE udløber, aktiveres en ny Swissbit Cloud TSE 2.0.

TSE-replacement-secondary-both-options.png

Som beskrevet ovenfor finder udskiftningen kun sted, hvis afkrydsningsfeltet "Aktiver automatisk TSE-udskiftning" også er markeret!

Anden TSE til udskiftning

I dette tilfælde konfigureres en bestemt TSE til den første idriftsættelse ("Brug til nye klienter"), og en TSE fra en anden producent konfigureres i tilfælde af udskiftning. For at gøre dette skal du:

  • konfigurere to TSE'er, begge
    • en primær TSE og
    • en sekundær TSE
  • indstille indstillingen "Brug til nye klienter" for den ene TSE og 
  • indstille indstillingen "Brug til udskiftninger" for den anden TSE

I eksemplet nedenfor tages terminaler i brug via den sekundære Fiskaly Cloud TSE. Hvis kriterierne for automatisk udskiftning af TSE er opfyldt, aktiveres en ny TSE af typen Swissbit Cloud TSE 2.0, som derefter anvendes.

TSE-replacement-different-TSE.png

Distribution af konfiguration

Der er to muligheder for at distribuere den nye konfiguration til alle klienter, der allerede er i drift:

  • Udløs automatisk distribution fra Cloud-portalen ved hjælp af knappen »Push Configuration TSE«, eller
  • Opdater klientens konfiguration ved hjælp af PUT /api/v1/management/clients/byCloud/{clientId}.

Med begge metoder overføres den nye konfiguration – som indeholder regler for TSE-udskiftning – til klienten(erne).

Push Configuration TSE

Du finder denne knap som en action item under menupunktet "Configuration", når du har valgt (klikket på) den relevante konfiguration.

Når der trykkes på knappen, er funktionen forskellig for lokale klienter (lokal middleware-installation) og klienter i Cloud Fiscalisation Service:

Funktionalitet ved lokal middleware-installation

Denne knap er udelukkende beregnet til at distribuere konfigurationen og aktivere automatisk TSE-udskiftning!

Når du trykker på knappen, sendes der en kommando til alle tilsluttede klienter om at downloade den aktuelle konfiguration fra portalen. I denne sammenhæng betyder "tilsluttet": klienter, som denne konfiguration er tildelt direkte eller indirekte (via organisation, virksomhed eller butik).

Clients, der ikke har en aktiv Cloud-forbindelse på det pågældende tidspunkt (ingen aktiv forbindelse til portalen via »Cloud/Connect«), modtager IKKE den nye konfiguration.

Det kan derfor være nødvendigt at udløse "Push Configuration TSE" flere gange, indtil alle klienter har hentet konfigurationen.

Hver klient rapporterer til portalen, når konfigurationen er hentet. Der vises en meddelelse via klokkeikonet (øverst til højre). Dashboardvisningen »TSE-udskiftning« giver også et overblik over status for TSE-udskiftningen (se artikel: Dashboard Tyskland – TSE-oplysninger).

Fungering af Cloud Fiscalisation Service

Ligesom ved den lokale installation udløses der her en kommando for at opdatere konfigurationen på klienterne. Kommandoen leveres dog først, næste gang klienten kalder funktionen 'Cloud/Connect'.

Portalen »husker« kommandostatus (hvilken client der i øjeblikket ikke er forbundet, og hvilken der allerede har hentet konfigurationen).

Det betyder, at det med Cloud Fiscalisation Service ikke er nødvendigt at genaktivere "Push Configuration TSE".

Meddelelser

Meddelelser og beskeder vedrørende udskiftning af en TSE:

- vises via klokkeikonet i portalen (øverst til højre),
- vises i loghændelserne (for hver terminal) og-
sendes via e-mail.

Klokke

Klokkeikonet viser følgende typer meddelelser:

- Hardware TSE er ikke tilgængelig på det pågældende system (ikke tilsluttet),
- Meddelelser vedrørende PushConfiguration (konfigurationen er blevet hentet af den pågældende client eller kunne ikke udføres).

Loghændelser

Loggen "Loghændelser" kan åbnes via det tilhørende action item på hver terminal. Den indeholder alle hændelser vedrørende udskiftning af TSE'en på den pågældende terminal.

E-mail-meddelelser

Succes- og fejlmeddelelser kan også sendes via e-mail. E-mail-meddelelser sendes kun, hvis der er valgt en teknisk kontaktperson (indstilling under Organisation: "Teknisk kontaktperson") i portalen.

Meddelelser sendes i batcher hver time.

Denne artikel er oversat automatisk.

Relaterede artikler

Kommentarer

0 kommentarer

Log ind for at kommentere.

Drevet af Zendesk