„Fiskal“ tarpinės programinės įrangos kūrimas – REST paslauga

Toliau aprašoma „RetailForce Fiskal“ tarpinės programinės įrangos kaip REST paslaugos struktūra.

Ryšio sąsaja ir šalių moduliai

„RetailForce Fiskal Middleware“ sudaro įvairūs moduliai,

• „Trusted Fiscal Module“ (TFM) – be kita ko, teikia įvesties sąsają
• įvairių „Trusted Fiscal Country Modules“ (TFCM) – atitinkamas šalies modulis (Country Module) yra atsakingas už įvesties duomenų apdorojimą, remiantis atitinkamos fiskalinės šalies taisyklėmis.

Atskirti TFM ir įvairius TFCM, galima pridėti naujus šalių įgyvendinimus ir pritaikyti esamus, nekeičiant kitų šalių įgyvendinimų.

Taigi yra ir skirtingos atskirų modulių versijos.

Schematinis vaizdas

Fiskaliniai klientai

Kiekviena atskira kasos vieta (= klientas tarpinėje programinėje įrangoje ir terminalas „RetailForce Cloud“) yra žymima vadinamuoju „ClientId“ („uniqueClientId“). Tai atitinka terminalo ID „RetailForce Cloud“ (naudojant automatinę konfigūraciją).

Rekomenduojama fiskalinę tarpinę programinę įrangą įdiegti tiesiogiai elektroninėje registravimo sistemoje („kasos aparate“). „ClientId“ naudojamas priskirto kasos aparato identifikavimui, kaip matyti toliau pateiktame paveiksle.

Paveikslas: Vieno kliento sistema

Tačiau įdiegus tarpinę programinę įrangą (=instanciją) galima lygiagrečiai prijungti kelis skirtingus „kasos aparatus“ (terminalus), jei tarpinė programinė įranga, pvz., įdiegiama kasų tinkle (filialo) serveryje, kaip parodyta toliau pateiktame paveikslėlyje.

Pavaizduotos kasos yra loginiai vienetai, turintys, be kita ko, savo kasos numerį, savo kvitų numerių serijas ir pan.

Paveikslas: Daugiaklientė sistema

Įdiegus fiskalinę tarpinę programinę įrangą, jau sukuriami keli bandomieji klientai.

Duomenų saugojimas

Visi duomenys, susiję su konkrečia kasos aparatu, yra saugomi lokaliai vadinamajame kliento kataloge (įdiegus „Windows“, pvz., C:\ProgramData\RetailForce\Fiscal Webservice\<clientId>). Tai taikoma tiek vieno kliento, tiek daugiaklientėms sistemoms. Log failai visada saugomi centralizuotai visų klientų log kataloge (Windows: C:\ProgramData\RetailForce\Fiscal Webservice\log).