Přehled kroků potřebných k uvedení klienta do provozu:

1. Vytvoření organizační struktury
2. Konfigurace
3. Nastavení připojení k Cloudu
4. Inicializace klienta

1. Vytvoření organizační struktury

Jako první krok k uvedení do provozu je třeba nejprve vytvořit organizační strukturu společnosti provozující pokladny v RetailForce Cloud. Podrobnosti k tomuto tématu najdete v článku, na který odkazujeme.

Tento krok lze přeskočit u systémů, které mají fungovat zcela offline a nikdy se nepřipojují k RetailForce Cloud.

2. Konfigurace

Konfiguraci klienta Fiscal Middleware lze v zásadě provést dvěma různými způsoby (v závislosti na nastavení a dohodách uzavřených mezi výrobcem pokladního softwaru a společností provozující pokladny):

1. Konfigurace prostřednictvím RetailForce Cloud, případně
2. Konfigurace prostřednictvím POS softwaru (pokladní systém, elektronický záznamový systém)

1. Konfigurace prostřednictvím RetailForce Cloud

V této variantě si klient stáhne konfigurační objekt připravený v RetailForce Cloud do svého lokálního úložiště. Lze to považovat za automatickou konfiguraci. Vytváření konfiguračních objektů je popsáno v článku, na který odkazujeme.

Při konfiguraci fiskální jednotky prostřednictvím cloudu jsou všechna data požadovaná systémem již nakonfigurována v cloudu (pokyny a obecné informace o vytváření konfigurace). Tato data se načítají z cloudu pomocí volání z fiskálního klienta (CreateClientByCloud).

Parametry volání jsou:

• Identifikace společnosti (CompanyIdentification), obvykle identifikační číslo pro účely DPH (VatNumber). V závislosti na zemi, ve které se společnost nachází, může být nutné alternativně nebo dodatečně zadat i jiné identifikační údaje (!). Pro začátek se však doporučuje použít identifikační číslo pro účely DPH.
• Číslo prodejny / pobočky
• Číslo pokladny
• cloudApiKey
• cloudApiSecret

Pokud je funkce PUT api/v1/management/clients/byCloud dokončena bez chyby, je konfigurace fiskálního klienta dokončena. Jako návratová hodnota je předán identifikátor GUID fiskálního modulu (=clientId).

2. Konfigurace prostřednictvím softwaru POS

Jako alternativa k automatické konfiguraci klienta prostřednictvím systému RetailForce Cloud lze konfigurační objekt připravit také pomocí POS softwaru. Tento typ konfigurace se používá u systémů, které nemají připojení k RetailForce Cloud. K tomu se používá koncový bod PUT /api/v1/management/clients.

Při konfiguraci pokladního softwaru existují 2 způsoby, jak modul správně spustit:

1. Modul bez připojení k Cloudu s lokálním ukládáním a exportem dat
2. Modul s připojením k Cloudu s lokálním i cloudovým ukládáním dat a exportem

V každém případě je nutné, aby byly potřebné konfigurační parametry nastaveny správně podle dokumentace.

Variantu 2 (s připojením k Cloudu) lze aktivovat i později, tj. je možné vytvořit fiskální konfiguraci bez připojení k Cloudu a poté ji synchronizovat s Cloudem.

Je třeba poznamenat, že vytvoření klienta v cloudu musí být povoleno výrobcem POS softwaru a/nebo organizací v nastavení cloudu. Standardním postupem je nejprve vytvořit konfigurační objekt v cloudu.

3. Navázání připojení k Cloudu

Dalším krokem je připojení klienta k RetailForce Cloud (u offline systémů bez připojení k Cloudu lze tento krok přeskočit). To se provádí pomocí funkce:

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

Parametry volání:

• clientId – jedinečné ID klienta (Guid), které bylo pokladně vráceno při konfiguraci prostřednictvím RetailForce Cloud.
• cloudApiKey
• cloudApiSecret

4. Inicializace klienta

Voláním funkce InitializeClient (POST /api/v1/management/clients/initialize) s parametrem (start document) se spustí inicializační rutina příslušné země; v tomto procesu se také inicializují všechny bezpečnostní komponenty (je-li to nutné).
Informace týkající se konkrétních zemí a/nebo hardwaru naleznete v příslušné dokumentaci.

Počáteční dokument lze od služby vyžádat spuštěním funkce:

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

Pokud se FiscalClient používá bez fiskalizace (NoFiscalisation), například pokud se klientovi přenášejí pouze digitální účtenky nebo archivní data, inicializace není nutná.

• Volání inicializační funkce (InitializeClient – POST /api/v1/management/clients/initialize)

Inicializace fiskální jednotky se poté provede voláním funkce InitializeClient.

Funkci InitializeClient se předává NullReceipt, příklad naleznete níže:

{
    "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 inicializace se v zásadě liší podle země, ale volání zůstává pro všechny země stejné. Podrobnosti o inicializacích specifických pro jednotlivé země najdete v dokumentaci příslušné země.

Uvedení do provozu v kostce

K uvedení klienta do provozu se volají následující funkce v uvedeném pořadí:

Související články

Inicializace v Německu

Zpracování chyb

Chyba: GetConfiguration pro klienta <ClientId> nenalezeno

Tento článek byl přeložen automaticky.