In this article, you will learn what steps you need to do after reconnecting with the FiskalService.
The same steps must be taken with the .net integration.;
Prerequesites
- The fiscal service is installed and the url is known / the integration of the .net library is completed so far
- You have access to Retailforce Cloud using cloud apiKey/apiSecret
- You use the configuration by downloading the configuration from the cloud
- You know the UID number / tax number of the organization of the pos system
- You know store and terminal number
Approach
In order to store as little data as possible in the POS system, you can proceed as follows. It is reserved for you to store the states in the cash register system, but you have to update them again and again.
Determine if the client configuration already exists at all
After completing this step, you will receive the uniqueClientId of the fiscal module for the requested cash register. (The uniqueClientId corresponds to The TerminalId in the RetailForce Cloud).
Fiscal service
To determine whether the client configuration already exists in the FiskalService, you need to run 2 methods:
- GET management/clients/licenseConsumerId
- GET management/clients/id
For detailed information on the features, please refer to the Swagger documentation of the Fiscalservice Client.
.net Integration
With .net integration, you can the FiscalModuleManagement class and the GetClients() method to query all the clients available in the configuration.
Client does not yet exist in the configuration
If the client already exists in the configuration and you have received a uniqueClientId, you can skip this step.
Download the configuration for the terminal from the cloud, for instructions, see the article:
Connecting to the cloud
Fiscal service
The fiscal module does not store the access data to the cloud (apiKey/apiSecret). Therefore, these access data be transferred to the service / fiscal module every time new connection made.
The data can be passed using the following method:
Information: If this data is not provided, an HTTP error with HttpStatusCode 424 - FailedDependency is returned. If the method management/cloud/connect is then called and the faulty request is tried again, it should work.
.net Integration
In .net integration, the credentials for the cloud must be passed when the fiscal module created (parameter of the CreateFiscalModuleForClient method.
It is recommended to initialize and load the fiscal module at the start of the posensoftware during .net integration, as in some countries initialization steps have to be performed that take a little longer.
Ask if the FiskalClient is already initialized
To determine whether the Initialization of the FiskalClient has already been initialized, you can query the status of the FiskalClient:
- GET /api/v1/information/client/{clientId}/status
- .net Integration: Property FiscalClientStatus at Fiscalmodule
The State property can take the following values:
- NotInitialized
- Initialized
- Decommissioned
Initialization of the fiscal client
If the FiskalClient is already initialized, you can skip this step.
A description of how to initialize can be found in the following article:
Finish
After performing the previous steps, the Fiscal Client is ready to receive initial evidence.
Comments
0 comments
Please sign in to leave a comment.