Replace a hardware TSE

This article is about replaceing of a hardware TSE device (e.g. in case of a defective TSE).

If, for example, a defective TSE is to be replaced, you can initiate this via the Swagger interface (fiscal service) or via a function call ReplaceTse (on the module TrustedFiscalModuleGermany).

Requirements

• The new TSE must be plugged into the system.
• The new TSE must not yet be initialised (factory state).
• The old TSE may be plugged into the system. If it is not present (because it is defective), any existing data can no longer be saved.

Information

An attempt is made to save the data on the TSE beforehand (if possible, e.g. if the TSE is not defective).

The acquisition and replacement of a TSE must be documented in the business's procedural documentation (Verfahrensdokumentation). The duration and cause of a TSE failure must be documented. Existing fiscal records remain subject to statutory retention and availability requirements, even if data cannot be retrieved from a defective TSE.

Process

Call the Replace TSE method on the service or on the module.

Service call

Call: PUT/api/v1/management/germany/{clientId}/tse/replace
Parameters: 

• clientId: UniqueClientId of the client for which the TSE is to be updated. 
• tseDriver (required): TSE driver of the new TSE. It must be the same driver as the current TSE (for a Swissbit hardware TSE: Swissbit).
• forceReplace: continue the replacement if the data of the old TSE cannot be saved (e.g. TSE defective).

Call at the module

Class: RetailForce.Fiscalisation.Implementation.Germany.TrustedFiscalModuleGermany

Method: public void ReplaceTse(TseDriver newTseDriver, bool forceReplace = false, List<ConfigurationParameter> newTseParameter = null)

Parameter:

• newTseDriver: TSE driver of the new TSE. It must be the same driver as the current TSE (for a Swissbit hardware TSE: Swissbit).
• forceReplace: Continue replacing if the data of the old TSE cannot be saved (e.g. TSE defective).
• newTseParameter: optional TSE parameters for the new TSE. If not set, the parameters of the current TSE configuration are used.

The client for which the TSE is replaced is determined by the instantiated class of the TrustedFiscalModuleGermany (instantiated for a client).