Pregled korakov, potrebnih za zagon klienta:

1. Ustvarjanje organizacijske strukture
2. Konfiguracija
3. Vzpostavitev povezave z Cloudom
4. Inicializacija stranke

1. Ustvarjanje organizacijske strukture

Kot prvi korak k zagonu je treba v RetailForce Cloud najprej ustvariti organizacijsko strukturo podjetja, ki upravlja z blagajnami. Podrobnosti o tem najdete v članku, na katerega se navezuje ta povezava.

Ta korak se lahko preskoči za sisteme, ki morajo delovati popolnoma brez povezave in se nikoli ne povezujejo z RetailForce Cloud.

2. Konfiguracija

Konfiguracijo odjemalca middleware je mogoče v osnovi opraviti na dva različna načina (odvisno od nastavitev in dogovorov med proizvajalcem programske opreme za blagajne in podjetjem, ki upravlja z blagajnami):

1. Konfiguracija prek RetailForce Cloud ali pa
2. konfiguracija prek programske opreme POS (blagajniški sistem, sistem elektronskega evidentiranja)

1. Konfiguracija prek RetailForce Cloud

Pri tej varianti client lokalno prenese konfiguracijski objekt, pripravljen v RetailForce Cloud. To se lahko obravnava kot avtomatska konfiguracija. Ustvarjanje konfiguracijskih objektov je opisano v povezanem članku.

Pri konfiguraciji fiskalne enote prek oblaka so vsi podatki, ki jih sistem zahteva, že konfigurirani v oblaku (navodila in splošne informacije o ustvarjanju konfiguracije). Ti podatki se naložijo iz oblaka s klicem iz fiskalnega odjemalca (CreateClientByCloud).

Parametri za klic so:

• Identifikacija podjetja (companyIdentification), običajno identifikacijska številka DDV (VatNumber). Glede na državo, v kateri se obračunava davek, je morda treba alternativno ali dodatno (!) vnesti druge identifikacijske značilnosti. Za začetek pa se priporoča identifikacijska številka DDV.
• Številka trgovine/podružnice
• Številka blagajne
• cloudApiKey
• cloudApiSecret

Če se funkcija PUT api/v1/management/clients/byCloud izvede brez napak, je konfiguracija fiskalnega odjemalca zaključena. Guid fiskalnega modula (=clientId) se prenese kot vrnjena vrednost.

2. Konfiguracija prek programske opreme POS

Kot alternativa avtomatski konfiguraciji stranke prek RetailForce Cloud systema se lahko konfiguracijski objekt pripravi tudi s programsko opremo POS. Ta vrsta konfiguracije se uporablja za sisteme, ki nimajo povezave z RetailForce Cloud. Za to se uporablja končna točka PUT /api/v1/management/clients.

Pri konfiguraciji programske opreme za blagajno obstajata 2 načina za pravilni zagon modula:

1. Modul brez povezave z Cloudom z lokalnim shranjevanjem in izvozom podatkov
2. Modul s povezavo z Cloudom z lokalnim in Cloud shranjevanjem podatkov ter izvozom

V vsakem primeru je nujno, da so potrebni konfiguracijski parametri pravilno nastavljeni v skladu z dokumentacijo.

Varianto 2 (s povezavo z Cloudom) je mogoče aktivirati tudi kasneje, tj. fiskalno konfiguracijo je mogoče ustvariti brez povezave z Cloudom in jo nato sinhronizirati z Cloudom.

Upoštevajte, da mora ustvarjanje klienta v oblaku omogočiti proizvajalec programske opreme za prodajna mesta in/ali organizacija v nastavitvah oblaka. Standardni postopek je, da najprej ustvarite konfiguracijski objekt v oblaku.

3. Vzpostavitev povezave z Cloudom

Naslednji korak je povezava stranke z RetailForce Cloud (za sisteme brez povezave z oblakom se ta korak lahko preskoči). To se opravi prek funkcije:

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

Parametri za klic:

• clientId – edinstvena identifikacijska številka odjemalca (Guid), ki je bila vrnjena blagajni ob konfiguraciji prek RetailForce Cloud.
• cloudApiKey
• cloudApiSecret

4. Inicializacija klienta

S klicem funkcije InitializeClient (POST /api/v1/management/clients/initialize) s parametrom (začetni dokument) se pokliče inicializacijski postopek za zadevno državo, v tem procesu se inicializirajo tudi morebitne varnostne komponente (če je to potrebno).
Za teme, specifične za državo in/ali strojno opremo, si oglejte ustrezno dokumentacijo.

Začetni dokument se lahko zahteva od storitve z izvedbo funkcije:

• GET /api/v1/transactions/document/{clientId}/start
  (parameter: clientId, optional: BookDate).

Če se FiscalClient uporablja brez fiskalizacije (NoFiscalisation), na primer če se stranki prenašajo le digitalni računi ali arhivski podatki, inicializacija ni potrebna.

• Klic funkcije za inicializacijo (InitializeClient – POST /api/v1/management/clients/initialize)

Inicializacija fiskalne enote se nato izvede s klicem InitializeClient.

Funkciji InitializeClient se prenese NullReceipt, primer je naveden spodaj:

{
    "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": {}
}

Postopek inicializacije je v osnovi odvisen od države, vendar klic ostaja enak za vse države. Podrobnosti o inicializacijah, specifičnih za posamezne države, najdete v dokumentaciji zadevne države.

Zagon na kratko

Za zagon klienta se v navedenem vrstnem redu pokličejo naslednje funkcije:

Povezani članki

Inicializacija v Nemčiji

Obravnavanje napak

Napaka: GetConfiguration za stranko <CLIENTID> ni bilo mogoče najti

Ta članek je bil samodejno preveden.