Pregled koraka potrebnih za aktivaciju klijenta:

1. Kreiranje organizacijske strukture
2. Konfiguracija
3. Uspostavljanje veze s oblakom
4. Inicijalizacija klijenta

1. Kreiranje organizacijske strukture

Kao prvi korak ka puštanju u rad, prvo se mora kreirati organizacijska struktura kompanije koja koristi blagajnu u RetailForce Cloudu. Detalje o tome možete pronaći u povezanom članku.

Ovaj korak se može preskočiti za sisteme koji trebaju raditi potpuno offline i koji se ni u jednom trenutku ne povezuju sa RetailForce Cloudom.

2. Konfiguracija

Konfiguracija klijenta fiskalnog middlewarea se u osnovi može obaviti na dva različita načina (ovisno o postavkama i dogovorima koje su napravili proizvođač softvera za blagajnu i kompanija koja upravlja blagajnama):

1. Konfiguracija putem RetailForce Clouda, ili alternativno
2. Konfiguracija putem POS softvera (sistem kase, elektronski sistem evidentacije)

1. Konfiguracija putem RetailForce Clouda

U ovoj varijanti, klijent lokalno preuzima objekt konfiguracije pripremljen u RetailForce Cloudu. Ovo se može smatrati automatskom konfiguracijom. Kreiranje objekata konfiguracije opisano je u povezanom članku.

Prilikom konfiguracije fiskalne jedinice putem clouda, svi podaci koje sistem zahtijeva već su konfigurisani u cloudu (uputstva i opće informacije o kreiranju konfiguracije). Ovi podaci se učitavaju iz clouda putem poziva sa strane fiskalnog klijenta (CreateClientByCloud).

Parametri za poziv su:

• Identifikacija kompanije (CompanyIdentification), obično broj identifikacije za PDV (VatNumber). Ovisno o poreznoj zemlji, može biti potrebno alternativno ili dodatno unijeti druge identifikacijske oznake (!). Međutim, za početak se preporučuje broj identifikacije za PDV.
• Broj prodavnice / poslovnice
• Broj kase
• cloudApiKey
• cloudApiSecret

Ako se funkcija PUT api/v1/management/clients/byCloud izvrši bez greške, konfiguracija fiskalnog klijenta je završena. Guid fiskalnog modula (=clientId) se šalje kao povratna vrijednost.

2. Konfiguracija putem POS softvera

Kao alternativu automatskoj konfiguraciji klijenta putem sistema RetailForce Cloud, konfiguracijski objekt se također može pripremiti POS softverom. Ova vrsta konfiguracije se koristi za sisteme koji nemaju vezu sa RetailForce Cloud. Za ovo se koristi krajnja tačka PUT /api/v1/management/clients.

Prilikom konfiguracije softvera za blagajnu, postoje 2 načina za ispravno pokretanje modula:

1. Modul bez veze s oblakom s lokalnim skladištenjem i izvozom podataka
2. Modul sa vezom u oblaku sa lokalnim i cloud skladištenjem i izvozom podataka

U svakom slučaju, neophodno je da se potrebni parametri konfiguracije postave ispravno u skladu s dokumentacijom.

Varijanta 2 (s vezom na oblak) se također može aktivirati naknadno, tj. moguće je kreirati fiskalnu konfiguraciju bez veze na oblak, a zatim je sinkronizirati s oblakom.

Treba napomenuti da proizvođač POS softvera i/ili organizacija mora omogućiti kreiranje klijenta u oblaku u postavkama oblaka. Standardni način je da se prvo kreira konfiguracijski objekt u oblaku.

3. Uspostavljanje veze s oblakom

Sljedeći korak je povezivanje klijenta sa RetailForce Cloud (za offline sisteme, bez veze sa cloudom, ovaj korak se 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 kasi prilikom konfiguracije putem RetailForce Clouda.
• cloudApiKey
• cloudApiSecret

4. Inicijalizacija klijenta

Pozivanjem funkcije InitializeClient (POST /api/v1/management/clients/initialize), s parametrom (početni dokument), poziva se rutina inicijalizacije za odgovarajuću zemlju, a sve sigurnosne komponente se također inicijaliziraju u ovom procesu (ako je potrebno).
Za teme specifične za zemlju i/ili hardver, molimo pogledajte odgovarajuću dokumentaciju.

Početni dokument se može zatražiti od servisa 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 se zatim vrši pozivom funkcije InitializeClient.

Funkciji InitializeClient se prosljeđuje 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 je u suštini specifičan za svaku zemlju, ali poziv ostaje isti za sve zemlje. Za detalje o inicijalizacijama specifičnim za pojedine zemlje, molimo pogledajte dokumentaciju za odgovarajuću zemlju.

Pokretanje na prvi pogled

Sljedeće funkcije se pozivaju ovim redoslijedom za podešavanje klijenta:

Povezani članci

Inicijalizacija Njemačka

Obrada grešaka

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

Ovaj članak je automatski preveden.