Šis galinis taškas grąžina informaciją apie konkretų „ClientId“. Jis naudojamas norint gauti informaciją apie konkretų klientą:
- Unikalūs kliento identifikaciniai duomenys
- Licencijos informacija
- Įmonės duomenys
- Verslo duomenys
- Kasybos informacija
- kiti parametrai
Dėmesio:
svarbu atkreipti dėmesį, kad ClientId turi būti vietinėje sistemoje. Jei taip nėra, grąžinama klaida „Client does not exist. (Parameter 'clientId')“. Gali prireikti atlikti papildomą analizę, kodėl „ClientId“ nėra vietinėje sistemoje. Jei klientas dar nebuvo paleistas
, tai reikia padaryti pirmiausia.
Rezultatas
Sėkmingas galinio taško iškvietimas pateikia HTTP-200 atsakymą ir JSON objektą su informacija apie užklausytą klientą.
Pavyzdys:
{
"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": "Testfirma - DE",
"companyAddress": {
"street": "Teststraße",
"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": "Teststore 06 - DE",
"storeAddress": {
"street": "Teststraße",
"streetNumber": "1",
"postalCode": "10115",
"city": "Berlin",
"countryCode": "DEU"
},
"terminalNumber": "00345",
"cashRegister": {
"id": "00000001",
"brand": "Testmodel",
"modelname": "ModelA",
"serialNumber": "123",
"currencyIsoCode": "EUR",
"software": {
"brand": "TestPOS Software",
"version": "4.40.14",
"softwareCompany": "TestPOS 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
}
Naudojimas
- Šis galinis taškas naudojamas informacijai apie konkretų klientą gauti.
Reikalavimai
- Įdiegta „RetailForce Fiskal Middleware“,
- atitinkamas klientas turi būti aktyvuotas ir esantis vietinėje sistemoje.
Formos laukeliai
Reikia pateikti šią informaciją:
| Pavadinimas | Aprašymas | Pavyzdžiai |
| clientId | Kliento, kurio duomenys turi būti gauti, ID | aa227e71-6775-45d0-ba73-85da33c34d37 |
Atsakymas
Galimi atsakymai:
| Kodas | Aprašymas | Pavyzdžiai |
| 200 | Užklausa sėkminga. Informacija apie užklausytą ClientId grąžinama JSON objekte. |
JSON FORMATAS
|
| 422 |
Užklausytas ClientId neegzistuoja vietinėje sistemoje. Klaidų šalinimas: Išanalizuokite, kodėl klientas vietinėje sistemoje nebeegzistuoja. |
„Pranešimas“: „Klientas neegzistuoja. (Parametras „clientId“)“ |
| 404 |
Užklausytas ClientId neegzistuoja vietinėje sistemoje. Klaidų šalinimas: Priežasčių analizė, kodėl klientas vietinėje sistemoje nebeegzistuoja. |
„Pranešimas“: „Kliento konfigūracija aa227e71-6775-45d0-ba73-85da33c34d37 nerasta.“ |
Komentarai
0 komentarų
Tam, kad paliktumėte komentarus prisijunkite