This endpoint returns information about a specific ClientId. It is used to retrieve details about a particular client, including:
- Unique client identification data
- License information
- Company data
- Business data
- Cash register information
- Various parameters
Attention: It is important to note that the ClientId must exist in the local system. If it does not exist, an error "Client does not exist. (Parameter 'clientId')" will be returned. Further analysis may be required to determine why the ClientId is not present in the local system. If the client has not been put into operation yet, it must be done first.
Result
A successful call to the endpoint returns an HTTP 200 response and a JSON object containing the requested client information.
Example:
{ "uniqueClientId": "4ac109f5-5c7b-4173-b3b7-b403f472ac8f", "licenseConsumerId": "f2a72f8c-104a-4fc1-add7-8f1254bce787", "usedVersion": "1.7.1.0", "distributerId": "20b7abfc-6abb-352e-b1fe-a14b1e507482", "licenseKey": "xxxJhbGciOiJodHRwOi8zd3d3LmczLm7yZy8yMDAxLzA0L3htbGRzaWbtbW9zZ...", "fiscalCountry": "[0] = Germany", "fiscalRegion": null, "companyNumber": "003", "companyName": "Test Company - DE", "companyAddress": { "street": "Test Street", "streetNumber": "99", "postalCode": "10115", "city": "Berlin", "countryCode": "DEU" }, "companyIdentification": [ { "type": "[0] = VatNumber", "identification": "TEST_000000" } ], "companyVatNumber": "TEST_000000", "companyTaxNumber": null, "fiscalYearStartMonth": 0, "storeNumber": "00345", "storeName": "Test Store 06 - DE", "storeAddress": { "street": "Test Street", "streetNumber": "1", "postalCode": "10115", "city": "Berlin", "countryCode": "DEU" }, "terminalNumber": "00345", "cashRegister": { "id": "00000001", "brand": "Test Model", "modelname": "Model A", "serialNumber": "123", "currencyIsoCode": "EUR", "software": { "brand": "Test POS Software", "version": "4.40.14", "softwareCompany": "Test POS Company" } }, "testClient": true, "fiscalModulImplementationConfiguration": { "primaryTse": { "tseDriver": "[99] = xxxxx", "tseId": "xxxx....", "tseGuid": null, "useTseGuid": false, "tseParameter": [ { "parameterName": "apiKey", "parameterValue": "test_xxx_test" }, { "parameterName": "apiSecret", "parameterValue": "test_xyz_test" }, { "parameterName": "tseAdminPin", "parameterValue": "123456" }, { "parameterName": "tseAdminPuk", "parameterValue": "4099817164" }, { "parameterName": "tseMaxClients", "parameterValue": "" } ] }, "fiscalCountry": "[0] = Germany", "taxonomyFileStoreConfiguration": { "localStorePath": "C:\\ProgramData\\RetailForce\\Fiscal Webservice", "compress": true }, "taxonomyCloudStoreConfiguration": null }, "simpleCashPointClosing": true }
Usage
- This endpoint is used to retrieve information about a specific client.
Requirements
- RetailForce Fiscal Middleware installed,
- relevant client activated and present in the local system.
Form fields
The following information needs to be provided:
Label | Description | Examples |
clientId | The ID of the client to be retrieved | aa227e71-6775-45d0-ba73-85da33c34d37 |
Response
Possible responses:
Code | Description | Examples |
200 | Successful request. The information for the requested ClientId is returned in a JSON object. |
JSON FORMAT
|
422 |
The requested ClientId does not exist in the local system. Troubleshooting: Analyze the cause for the client not (anymore) existing in the local system. |
"Message": "Client does not exist. (Parameter 'clientId')" |
404 |
The requested ClientId does not exist in the local system. Troubleshooting: Analyze the cause for the client not (anymore) existing in the local system. |
"Massage": "Client configuration for aa227e71-6775-45d0-ba73-85da33c34d37 was not found." |
Comments
0 comments
Please sign in to leave a comment.