Prehľad krokov potrebných na uvedenie klienta do prevádzky:

1. Vytvorenie organizačnej štruktúry
2. Konfigurácia
3. Nastavenie pripojenia k Cloudu
4. Inicializácia klienta

1. Vytvorenie organizačnej štruktúry

Ako prvý krok k spusteniu do prevádzky je potrebné najskôr vytvoriť organizačnú štruktúru spoločnosti prevádzkujúcej pokladnice v RetailForce Cloud. Podrobnosti nájdete v článku, na ktorý odkazuje tento odkaz.

Tento krok je možné preskočiť v prípade systémov, ktoré majú fungovať úplne offline a nikdy sa nepripájajú k službe RetailForce Cloud.

2. Konfigurácia

Konfiguráciu klienta middleware je možné v zásade vykonať dvoma rôznymi spôsobmi (v závislosti od nastavení a dohôd uzavretých medzi výrobcom softvéru pre pokladnice a spoločnosťou prevádzkujúcou pokladnice):

1. Konfigurácia prostredníctvom služby RetailForce Cloud alebo alternatívne
2. Konfigurácia prostredníctvom POS softvéru (pokladničný systém, elektronický záznamový systém)

1. Konfigurácia prostredníctvom RetailForce Cloud

V tejto variante si klient stiahne konfiguračný objekt pripravený v RetailForce Cloud do svojho lokálneho zariadenia. Toto možno považovať za automatickú konfiguráciu. Vytvorenie konfiguračných objektov je popísané v článku, na ktorý odkazuje tento odkaz.

Pri konfigurácii fiškálnej jednotky prostredníctvom cloudu sú všetky údaje požadované systémom už nakonfigurované v cloude (pokyny a všeobecné informácie o vytváraní konfigurácie). Tieto údaje sa načítajú z cloudu prostredníctvom volania z fiškálneho klienta (CreateClientByCloud).

Parametre volania sú:

• Identifikácia spoločnosti (companyIdentification), zvyčajne identifikačné číslo pre DPH (VatNumber). V závislosti od krajiny, v ktorej sa uplatňujú daňové predpisy, môže byť potrebné alternatívne alebo dodatočne (!) zadať aj iné identifikačné údaje. Na začiatok sa však odporúča použiť identifikačné číslo pre DPH.
• Číslo predajne / pobočky
• Číslo pokladnice
• cloudApiKey
• cloudApiSecret

Ak sa funkcia PUT api/v1/management/clients/byCloud vykoná bez chyby, konfigurácia daňového klienta je dokončená. Ako návratová hodnota sa odošle identifikátor (Guid) daňového modulu (=clientId).

2. Konfigurácia prostredníctvom POS softvéru

Ako alternatíva k automatickej konfigurácii klienta prostredníctvom RetailForce Cloud systemu je možné konfiguračný objekt pripraviť aj pomocou POS softvéru. Tento typ konfigurácie sa používa pre systémy, ktoré nemajú pripojenie k RetailForce Cloud systemu. Na tento účel sa používa koncový bod PUT /api/v1/management/clients.

Pri konfigurácii softvéru pokladnice existujú 2 spôsoby, ako modul správne spustiť:

1. Modul bez pripojenia k Cloudu s lokálnym ukladaním a exportom údajov
2. Modul s pripojením k Cloudu s lokálnym a cloudovým ukladaním dát a exportom

V každom prípade je potrebné, aby boli potrebné konfiguračné parametre nastavené správne podľa dokumentácie.

Variant 2 (s pripojením k Cloudu) je možné aktivovať aj neskôr, t. j. je možné vytvoriť daňovú konfiguráciu bez pripojenia k Cloudu a následne ju synchronizovať s Cloudom.

Je potrebné poznamenať, že vytvorenie klienta v cloude musí byť povolené výrobcom POS softvéru a/alebo organizáciou v nastaveniach cloudu. Štandardným postupom je najprv vytvoriť konfiguračný objekt v cloude.

3. Nadviazanie pripojenia k Cloudu

Ďalším krokom je pripojenie klienta k RetailForce Cloud (v prípade offline systémov bez pripojenia k cloudu sa tento krok môže vynechať). To sa vykonáva prostredníctvom funkcie:

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

Parametre volania:

• clientId – jedinečné ID klienta (Guid), ktoré bolo vrátené pokladni pri konfigurácii prostredníctvom RetailForce Cloud.
• cloudApiKey
• cloudApiSecret

4. Inicializácia klienta

Volaním funkcie InitializeClient (POST /api/v1/management/clients/initialize) s parametrom (štartovací dokument) sa vyvolá inicializačná rutina príslušnej krajiny, pričom sa v tomto procese inicializujú aj všetky bezpečnostné komponenty (ak je to potrebné).
Informácie týkajúce sa konkrétnej krajiny alebo hardvéru nájdete v príslušnej dokumentácii.

Počiatočný dokument je možné vyžiadať od služby vykonaním funkcie:

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

Ak sa FiscalClient používa bez fiskalizácie (NoFiscalisation), napríklad ak sa klientovi prenášajú iba digitálne potvrdenky alebo archívne údaje, inicializácia nie je potrebná.

• Vyvolanie inicializačnej funkcie (InitializeClient – POST /api/v1/management/clients/initialize)

Inicializácia daňovej jednotky sa potom vykoná volaním funkcie InitializeClient.

Do funkcie InitializeClient sa odovzdáva NullReceipt, príklad nájdete nižšie:

{
    "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 inicializácie je v zásade špecifický pre každú krajinu, volanie však zostáva rovnaké pre všetky krajiny. Podrobnosti o inicializáciách špecifických pre jednotlivé krajiny nájdete v príslušnej dokumentácii danej krajiny.

Uvedenie do prevádzky v skratke

Na uvedenie klienta do prevádzky sa volajú nasledujúce funkcie v uvedenom poradí:

Súvisiace články

Inicializácia v Nemecku

Spracovanie chýb

Chyba: GetConfiguration pre klienta <CLIENTID> nebolo nájdené

Tento článok bol preložený automaticky.