Kliento paleidimui reikalingų veiksmų apžvalga:

1. Priedas. Organizacijos struktūra
2. Konfigūracija
3. Prijungimas prie debesies
4. Kliento inicijavimas

1. Organizacijos struktūros sukūrimas

Pirmasis žingsnis pradedant naudoti sistemą – sukurti kasos operatoriaus įmonės organizacinę struktūrą „RetailForce Cloud“. Daugiau informacijos apie tai rasite nuorodoje pateiktame straipsnyje.

Jei sistemos veikia visiškai neprisijungusios prie interneto ir niekada nesusijungia su „RetailForce Cloud“, šį žingsnį galima praleisti.

2. Konfigūracija

Fiskalinės tarpinės programinės įrangos kliento konfigūracija iš esmės gali būti atliekama dviem skirtingais būdais (priklausomai nuo nustatymų ir susitarimų, kuriuos sudarė kasos programinės įrangos gamintojas ir kasos operatoriaus įmonė):

1. Konfigūracija per „RetailForce Cloud“ arba, alternatyviai:
2. konfigūravimas per kasos programinę įrangą

1. Konfigūracija per „RetailForce Cloud“

Pasirinkus šį variantą, klientas atsisiunčia „RetailForce Cloud“ paruoštą konfigūracijos objektą į savo kompiuterį. Tai galima laikyti automatine konfigūracija. Konfigūracijos objektų kūrimas aprašytas straipsnyje, kurio nuoroda pateikta žemiau.

Konfigūruojant fiskalinį įrenginį per „Cloud“, visi sistemai reikalingi duomenys jau yra sukonfigūruoti „Cloud“ (instrukcijos ir bendroji informacija apie konfigūracijos kūrimą). Šie duomenys iš „Cloud“ atsisiunčiami fiskalinio kliento iškvietimu (CreateClientByCloud).

Šio iškvietimo parametrai yra:

• Įmonės identifikatorius (CompanyIdentification), dažniausiai PVM mokėtojo kodas (Ust-Id-Nr. = VatNumber). Priklausomai nuo fiskalinės šalies, gali būti būtina nurodyti alternatyvius arba papildomus (!) identifikavimo požymius. Tačiau paleidimo metu rekomenduojama nurodyti PVM identifikavimo numerį.
• Filialo numeris
• Kaso numeris
• cloudApiKey
• cloudApiSecret

Jei funkcija PUT api/v1/management/clients/byCloud įvykdoma be klaidų, fiskalinio kliento konfigūracija yra baigta. Fiskalinio modulio GUID (=clientId) perduodamas kaip grąžinamoji reikšmė.

2. Konfigūracija naudojant kasos programinę įrangą

Kaip alternatyva automatiniam kliento konfigūravimui per „RetailForce Cloud“ sistemą, konfigūracijos objektą taip pat galima paruošti kasos programine įranga. Šis konfigūravimo būdas naudojamas sistemose, kurios nėra prijungtos prie „RetailForce Cloud“. Tam naudojamas galinis taškas PUT /api/v1/management/clients.

Konfigūruojant per kasos programinę įrangą, yra 2 galimybės teisingai paleisti modulį:

1. Modulis be prisijungimo prie debesies su vietiniu duomenų saugojimu ir eksportu
2. Modulis su prisijungimu prie debesies, su vietiniu ir debesies duomenų saugojimu bei eksportu

Bet kuriuo atveju būtina, kad reikalingi konfigūracijos parametrai būtų teisingai nustatyti pagal dokumentaciją.

2 variantas (su prisijungimu prie debesies) taip pat gali būti aktyvuotas vėliau, t. y. galima sukurti fiskalinę konfigūraciją be prisijungimo prie debesies ir vėliau ją sinchronizuoti su debesimi. 

Reikia atkreipti dėmesį, kad kliento sukūrimas debesyje turi būti įjungtas kasos programinės įrangos gamintojo ir (arba) organizacijos debesies nustatymuose. Standartinis būdas yra pirmiausia sukurti konfigūracijos objektą debesyje.

3. Debesies ryšio užmezgimas

Kitas žingsnis – klientą reikia prijungti prie „RetailForce“ debesies (neprisijungus prie debesies, šį žingsnį galima praleisti). Tai atliekama naudojant funkciją:

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

Kvietimo parametrai:

• clientId – unikalus kliento ID (Guid), kuris buvo grąžintas kasai konfigūruojant per „RetailForce Cloud“.
• cloudApiKey
• cloudApiSecret

4. Kliento inicijavimas

Iškvietus funkciją InitializeClient (POST /api/v1/management/clients/initialize) su parametru (pradinis dokumentas), iškviečiama atitinkamos šalies inicijavimo procedūra, tuo pačiu metu taip pat inicijuojami galimi saugumo komponentai (jei būtina).
Informaciją apie konkrečioms šalims ir (arba) aparatinei įrangai būdingus klausimus rasite atitinkamoje dokumentacijoje.

Pradinį dokumentą galima gauti, vykdant funkciją:

• GET /api/v1/transactions/document/{clientId}/start
  (parametras: clientId , pasirinktinai: bookDate )

.

Jei „FiskalClient“ naudojamas be fiskalizacijos (NoFiscalisation), pavyzdžiui, kai klientui perduodami tik skaitmeniniai kvitai ar archyviniai duomenys, inicijavimas nėra būtinas.

• Funkcijos „Inicializavimas“ (InitializeClient - POST /api/v1/management/clients/initialize) iškvietimas

Fiskalinio įrenginio inicijavimas atliekamas iškviesiant „InitializeClient“.

Funkcijai „InitializeClient“ perduodamas „NullReceipt“, pateikiame pavyzdį:

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

Inicijavimo procesas iš esmės priklauso nuo šalies, tačiau iškvietimas visose šalyse yra vienodas. Išsamią informaciją apie šalių specifines inicijavimo procedūras rasite atitinkamų šalių dokumentacijoje.

Pradžios apžvalga

Kliento paleidimui iškviečiamos šios funkcijos pateikta tvarka:

Daugiau straipsnių

Inicijavimas Vokietijoje

Klaidų tvarkymas

Klaida: nerasta kliento <ClientId> konfigūracijos