Pregled koraka potrebnih za aktivaciju klijenta:
- Izrada organizacijske strukture
- Konfiguracija
- Uspostavljanje veze s oblakom
- Inicijalizacija klijenta
1. Kreiranje organizacijske strukture
Kao prvi korak prema puštanju u rad, organizacijska struktura tvrtke koja upravlja blagajnom mora se prvo stvoriti u RetailForce Cloudu. Detalje o tome možete pronaći u povezanom članku.
Ovaj se korak može preskočiti za sustave koji trebaju raditi potpuno izvan mreže i koji se ni u jednom trenutku ne povezuju s RetailForce Cloudom.
2. Konfiguracija
Konfiguracija klijenta fiskalnog middlewarea u osnovi se može obaviti na dva različita načina (ovisno o postavkama i dogovorima koje je sklopio proizvođač softvera za blagajnu i tvrtka koja upravlja blagajnama):
- Konfiguracija putem RetailForce Clouda, ili alternativno
- Konfiguracija putem POS softvera (sustav blagajne, sustav za elektroničko evidentiranje)
1. Konfiguracija putem RetailForce Clouda
U ovoj varijanti klijent lokalno preuzima objekt konfiguracije pripremljen u RetailForce Cloudu. To se može smatrati automatskom konfiguracijom. Stvaranje objekata konfiguracije opisano je u povezanom članku.
Prilikom konfiguriranja fiskalne jedinice putem oblaka, svi podaci koje sustav zahtijeva već su konfigurirani u oblaku (upute i opće informacije o izradi konfiguracije). Ti se podaci učitavaju iz oblaka putem poziva s fiskalnog klijenta (CreateClientByCloud).
Parametri za poziv su:
- Identifikacija tvrtke (CompanyIdentification), obično broj poreznog identifikacijskog broja (VatNumber). Ovisno o poreznoj zemlji, može biti potrebno alternativno ili dodatno unijeti druge identifikacijske značajke (!). Međutim, za početak se preporučuje korištenje poreznog identifikacijskog broja.
- Broj trgovine / poslovnice
- Broj blagajne
- cloudApiKey
- cloudApiSecret
Ako se funkcija PUT api/v1/management/clients/byCloud dovrši bez pogreške, konfiguracija fiskalnog klijenta je dovršena. Guid fiskalnog modula (=clientId) prenosi se kao povratna vrijednost.
2. Konfiguracija putem POS softvera
Kao alternativu automatskoj konfiguraciji klijenta putem sustava RetailForce Cloud, konfiguracijski objekt može pripremiti i POS softver. Ova se vrsta konfiguracije koristi za sustave koji nemaju vezu sa sustavom RetailForce Cloud. Za to se koristi krajnja točka PUT /api/v1/management/clients.
Prilikom konfiguracije POS softvera postoje 2 načina za ispravno pokretanje modula:
- Modul bez veze s oblakom s lokalnim pohranjivanjem i izvozom podataka
- Modul s vezom u oblaku s lokalnim i oblačnim pohranjivanjem i izvozom podataka
U svakom slučaju potrebno je da se potrebni parametri konfiguracije ispravno postave u skladu s dokumentacijom.
Varijanta 2 (s vezom u oblaku) može se također aktivirati naknadno, tj. moguće je izraditi fiskalnu konfiguraciju bez veze u oblaku, a zatim je sinkronizirati s oblakom.
Treba napomenuti da proizvođač POS softvera i/ili organizacija mora omogućiti stvaranje klijenta u oblaku u postavkama oblaka. Standardni način je prvo stvoriti konfiguracijski objekt u oblaku.
3. Uspostavljanje veze s oblakom
Sljedeći korak je povezati klijenta s RetailForce Cloudom (za offline sustave, bez veze s cloudom, ovaj se korak može preskočiti). To se radi putem funkcije:
Parametri za poziv:
- clientId - jedinstveni ID klijenta (Guid) vraćen je blagajni kada je konfiguriran putem RetailForce Clouda.
- cloudApiKey
- cloudApiSecret
API ključ i API tajna moraju biti spremljeni u POS softveru. Klijent ne sprema te informacije!
4. Inicijalizacija klijenta
Pozivanjem funkcije InitializeClient (POST /api/v1/management/clients/initialize) s parametrom (start document) poziva se rutina inicijalizacije za odgovarajuću zemlju, a u tom se procesu (ako je potrebno) inicijaliziraju i sve sigurnosne komponente.
Za teme specifične za zemlju i/ili hardver, molimo pogledajte odgovarajuću dokumentaciju.
Početni dokument može se zatražiti od usluge izvršavanjem funkcije:
-
GET /api/v1/transactions/document/{clientId}/start
(parameter: clientId, opcionalno: bookDate).
Ako se FiscalClient koristi bez fiskalizacije (NoFiscalisation), na primjer ako se klijentu šalju samo digitalni računi ili arhivski podaci, inicijalizacija nije potrebna.
- Pozivanje funkcije za inicijalizaciju (InitializeClient - POST /api/v1/management/clients/initialize)
Inicijalizacija fiskalne jedinice zatim se provodi pozivom metode InitializeClient.
Funkciji InitializeClient prosljeđuje se NullReceipt, primjer se nalazi u nastavku:
{
"modelVersion": "1.5.2",
"uniqueClientId": "c1062c55-57c4-4ed2-9c53-aff1762326a4",
"additionalFields": {},
"documentGuid": "5efa5306-fe53-452d-9c81-68329475eee0",
"documentId": "1",
"createDate": "2025-05-02T07:08:17.8334419+02:00",
"bookDate": "2025-05-02T07:08:17.8335535+02:00",
"documentNumber": "1",
"documentType": 1000,
"documentTypeCaption": "Startbeleg",
"user": {
"id": "1",
"caption": "User 1",
"firstName": "1",
"lastName": "User",
"dateOfEntry": "2025-05-02T07:08:17.833596+02:00"
},
"allocationGroups": [],
"positionCount": 0,
"fiscalDocumentNumber": 1,
"fiscalDocumentRevision": 1,
"positions": [],
"Payments": [],
"additionalHeader": [],
"additionalFooter": [],
"fiscalAdditionalFields": {}
}
Proces inicijalizacije u osnovi je specifičan za svaku zemlju, ali poziv je isti za sve zemlje. Za detalje o inicijalizacijama specifičnim za pojedine zemlje pogledajte dokumentaciju za tu zemlju.
Pokretanje na prvi pogled
Sljedeće se funkcije pozivaju redoslijedom navedenim za postavljanje klijenta:
| Funkcija | Opis |
| PUT api/v1/management/clients/byCloud |
|
|
|
|
|
|
Povezani članci
Rukovanje pogreškama
Greška: Konfiguracija za klijenta <ClientId> nije pronađena
Ovaj je članak automatski preveden.
Komentari
0 komentara
Molimo Prijavite se kako bi ostavili komentar.