„RetailForce“ kuria programinę įrangą, skirtą įvairių šalių elektroninių registravimo sistemų fiskalizacijos reikalavimams įgyvendinti. Ši programinė įranga vadinama „Fiscal Middleware“. 

Šiame dokumente pateikiama „RetailForce Fiscal Middleware“ integracijos apžvalga. Priešakinės sistemos, kuri siunčia duomenis į „Fiscal Middleware“ ir juos iš jos gauna, architektūra, taip pat specialūs šios sistemos reikalavimai ir funkcijos gali reikalauti nukrypimų nuo šio aprašymo.

1. Pagrindai

Toliau išvardyti atskiri veiksmai, kuriuos reikia atlikti prieš pradedant integraciją. Šie veiksmai taip pat išsamiai aptariami įvedimo metu.

1.1 Integracijos variantų apžvalga

Prieš pradėdami integraciją, susipažinkite su įvairiais galimais integracijos variantais. Šie variantai aprašomi šiame straipsnyje: „Fiskalizacijos su RetailForce apžvalga“ – RetailForce Software GmbH (=apžvalginis straipsnis).

Šaltinius, iš kurių galite atsisiųsti įvairias „RetailForce“ fiskalinės tarpinės programinės įrangos versijas, taip pat rasite straipsnyje, kurio nuoroda pateikta aukščiau.

Atsisiuntę fiskalinę tarpinę programinę įrangą, atlikite jos diegimą. Aprašymą, kaip diegiamos skirtingos variantai, rasite apžvalginiame straipsnyje.

1.1.1 Prisijungus prie interneto ir neprisijungus

„RetailForce“ fiskalinė tarpinė programinė įranga iš esmės yra savarankiška programinės įrangos sistema. Tačiau kai kurios funkcijos yra prieinamos tik tada, kai tarpinė programinė įranga yra prijungta prie „RetailForce Cloud“.

„RetailForce Cloud“ siūlo įvairias valdymo funkcijas, pavyzdžiui, automatinį nuotolinį tarpinės programinės įrangos konfigūravimą, įskaitant licencijų priskyrimą, taip pat saugias ilgalaikio archyvavimo funkcijas.

Norint naudotis „RetailForce Cloud“ funkcijomis, fiskalinė tarpinė programinė įranga arba konkretus klientas instaliacijoje (klientas = atskiras elektroninės registravimo sistemos egzempliorius) turi būti prijungtas prie terminalo „RetailForce Cloud“.

Jei tarpinė programinė įranga turi veikti be prisijungimo prie debesies (neprisijungusi sistema), šį žingsnį galima praleisti. Tęskite nuo 1.5 punkto. 

1.2 Prieiga prie „RetailForce“ portalo

Visos „RetailForce Cloud“ funkcijos yra prieinamos tiek per:

• „RetailForce Cloud“ portalą (https://portal.retailforce.cloud), tiek
• „Cloud-API“ (https://api.retailforce.cloud/swagger)

Saugumo sumetimais savarankiška registracija „RetailForce“ portale nėra įmanoma. Norėdami gauti prieigą prie portalo, turite gauti kvietimo nuorodą iš jau įgalioto vartotojo. Toliau aprašomas registracijos procesas. Registracija „RetailForce“ portale – „RetailForce Software GmbH“.

1.3 Organizacijos struktūra

Portale pirmiausia reikia sukurti organizacijos struktūrą. Straipsnyje „Organizacijos struktūros kūrimas RetailForce Cloud – RetailForce Software GmbH“ pateikiama apžvalga, kokios funkcijos tam yra numatytos.

1.4 Konfigūracija

Sukūrus organizacinę struktūrą, bent vieną organizaciją (=klientą), parduotuvę (=filialą) ir terminalą (=kasą), debesyje reikia paruošti konfigūracijos objektą ir priskirti jį vienam subjektui (organizacijai, įmonei, parduotuvei arba terminalui). Šio proceso aprašymą rasite čia: Bendroji informacija apie konfigūraciją – „RetailForce Software GmbH“.

1.5 Paleidimas

Sėkmingai atlikus ankstesnius veiksmus, galima pradėti naudoti fiskalinę tarpinę programinę įrangą. Veiksmai, reikalingi pradėti naudoti (su debesies ryšiu ir be jo), išsamiau paaiškinti straipsnyje „Pradžia (bendrai)“ – RetailForce Software GmbH.

Pradėjus veikti, fiskalinis klientas turėtų būti

• būti visiškai sukonfigūruotas,
  • naudojant debesyje parengtą konfigūracijos objektą, arba
  • „rankiniu būdu“ per elektroninę registravimo sistemą, taip pat
• turėti unikalų kliento ID.

2. Integracija

Sėkmingai užbaigus kliento („kasos“) paleidimą, galima pradėti integraciją.

Šiame skyriuje rasite nurodymus dėl dokumentų perdavimo proceso tarp kasos (elektroninės registravimo sistemos) ir konkretaus kliento.

2.1 REST žiniatinklio paslauga

Šis straipsnis padės pradėti integruoti REST žiniatinklio paslaugų sąsają, kuri reikalinga

• „Windows“ paslaugos bei
• „Docker “ konteinerio

:

Pirmieji žingsniai su fiskalinės paslaugos – „RetailForce Software GmbH“

2.2 „NuGet“ įgyvendinimas

Pagalba dėl „NuGet“ (DLL) tarpinės programinės įrangos diegimo pateikiama šiame straipsnyje: Pirmieji žingsniai diegiant „NuGet“ – „RetailForce Software GmbH“.

2.3 Failų sąsaja

Be dviejų minėtų diegimo variantų – REST žiniatinklio paslaugos ir „NuGet“ – tarpinę programinę įrangą taip pat galima pasiekti per failų sąsają. Daugiau informacijos apie tai rasite straipsnyje: Failų sąsaja – „RetailForce Software GmbH“.

2.4 Dokumentų perdavimo procesas

Įdiegus fiskalinę tarpinę programinę įrangą, panašią į „Windows“ paslaugą, kompiuteryje, API aprašymą galima rasti adresu http://localhost:7678/swagger/index.html.

Jei įdiegta nuotolinėje kompiuteryje (pvz., LAN), vietoj „localhost“ naudokite sistemos, kurioje įdiegta tarpinė programinė įranga, IP adresą.

„Swagger“ aprašyti visi tarpinės programinės įrangos galiniai taškai. Dokumentų (pvz., kasos kvitų) perdavimui svarbūs yra skyriaus „Transactions“ galiniai taškai.

Dokumentų perdavimas visada yra dviejų etapų procesas, kuris pradedamas komanda

1. „createDocument“ ir baigiamas arba
2. „storeDocument“, arba „cancelDocument“, jei kvitas atšaukiamas.

Dokumentų perdavimo procesas čia paaiškinamas išsamiai: Pagrindinis kvitų perdavimo procesas – „RetailForce Software GmbH“.

2.5 „Fiscal Service“ kliento pavyzdys

„RetailForce“ siūlo pavyzdinę programą – „Fiscal Service Client Sample“. Joje paaiškinama, kaip sukurti JSON struktūrą, kuria dokumentai siunčiami į „Fiscal Service“.

Naudojant „Fiscal Service Client Sample“, galima sukurti įvairių dokumentų tipų ir verslo atvejų pavyzdžius.

Programos aprašymą rasite čia: „Fiscal Service Client Sample“ – „RetailForce Software GmbH“.

Įvairių dokumentų ir verslo atvejų pavyzdžius taip pat rasite „Solution Center“ skyriuje: Verslo atvejai – „RetailForce Software GmbH“.

2.6 Galinių taškų sąrašas

Toliau aprašomi galiniai taškai, kurie bet kuriuo atveju turėtų būti įgyvendinti.