Pregled koraka potrebnih za aktivaciju klijenta:

1. Izrada organizacijske strukture
2. Konfiguracija
3. Uspostavljanje veze s oblakom
4. 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):

1. Konfiguracija putem RetailForce Clouda, ili alternativno
2. 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:

1. Modul bez veze s oblakom s lokalnim pohranjivanjem i izvozom podataka
2. 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:

• POST /api/v1/management/cloud/connect .

Parametri za poziv:

• clientId - jedinstveni ID klijenta (Guid) vraćen je blagajni kada je konfiguriran putem RetailForce Clouda.
• cloudApiKey
• cloudApiSecret

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:

Povezani članci

Inicijalizacija Njemačka

Rukovanje pogreškama

Greška: Konfiguracija za klijenta <ClientId> nije pronađena

Ovaj je članak automatski preveden.