A RetailForce olyan szoftvert fejleszt, amely megfelel a különböző országokban az elektronikus nyilvántartási rendszerek adóügyi előírásainak. Ezt a szoftvert „Fiscal Middleware”-nek nevezik.
Ez a dokumentum áttekintést nyújt a RetailForce Middleware integrálásáról. A Middleware-hez adatokat küldő és onnan adatokat fogadó upstream rendszer architektúrája, valamint e rendszer speciális követelményei és funkciói miatt szükségessé válhat az itt leírtaktól való eltérés.
1. Alapok
Az alábbiakban felsoroljuk azokat az egyes lépéseket, amelyeket az integráció megkezdése előtt el kell végezni. Ezeket a lépéseket az onboarding ülés során is részletesen ismertetjük.
1.1 Az integrációs változatok áttekintése
Az integráció megkezdése előtt ismerkedjen meg a rendelkezésre álló különböző integrációs változatokkal. Ezeket a változatokat a következő cikk ismerteti: Áttekintés a RetailForce-szal történő adóügyi integrációról – RetailForce Software GmbH (=áttekintő cikk).
A linkelt cikkben megtalálhatók azok a források is, ahonnan letöltheti a RetailForce Middleware különböző változatait.
A Fiscal middleware letöltése után hajtsa végre a telepítést. A különböző változatok telepítésének leírása az áttekintő cikkben található.
1.1.1 Online vs. offline
A RetailForce Middleware alapvetően önálló szoftverrendszer. Bizonyos funkciók azonban csak akkor érhetők el, ha a middleware csatlakozik a RetailForce Cloudhoz.
A RetailForce Cloud különféle felügyeleti funkciókat biztosít, például a middleware automatikus távoli konfigurálását, beleértve a licencelosztást is, valamint biztonságos, hosszú távú archiválási funkciókat.
A RetailForce Cloud funkcióinak használatához a Fiscal Middleware-t vagy a telepítésen belüli konkrét klienst (kliens = az elektronikus nyilvántartási rendszer egyetlen példánya) csatlakoztatni kell a RetailForce Cloud egyik termináljához.
Ha a middleware-t Cloud-kapcsolat létrehozása nélkül kívánja üzemeltetni (offline rendszer), a következő lépéseket kihagyhatja. Folytassa az 1.5. ponttal.
1.2 Belépés a RetailForce portalra
A RetailForce Cloud összes funkciója elérhető a
- a RetailForce Cloud Portalon (https://portal.retailforce.cloud), valamint a
- Cloud API-n (https://api.retailforce.cloud/swagger) keresztül
Biztonsági okokból nem lehetséges az önálló regisztráció a RetailForce portalon. A portálhoz való hozzáféréshez meghívó linket kell kapnia egy már engedélyezett felhasználótól. A további regisztrációs folyamatot a következő cikk ismerteti: Regisztráció a RetailForce portalon – RetailForce Software GmbH.
1.3 Szervezeti felépítés
Először létre kell hozni egy szervezeti felépítést a portálon. A „Szervezeti felépítés létrehozása a RetailForce Cloudban – RetailForce Software GmbH” című cikk áttekintést nyújt arról, hogy milyen funkciók állnak rendelkezésre erre a célra.
1.4 Konfiguráció
Miután létrehozták a szervezeti felépítést, legalább egy szervezetet (=ügyfél), egy üzletet (=fiók) és egy terminált (=pénztár), el kell készíteni egy konfigurációs objektumot a Cloud-ban, és azt hozzá kell rendelni egy entitáshoz (szervezet, vállalat, üzlet vagy terminál). A folyamat leírását itt találja: Általános információk a konfigurációról – RetailForce Software GmbH.
1.5 Inicializálás
Ha az előző lépéseket sikeresen végrehajtotta, a Fiscal Middleware üzembe helyezhető. Az üzembe helyezéshez szükséges lépéseket (felhőkapcsolat létrehozásával és anélkül) részletesebben a következő cikk ismerteti: Inicializálás (általános) – RetailForce Software GmbH.
Az üzembe helyezés/inicializálás folyamatának eredményeként a Fiscal Clientnek
- teljesen konfigurálva kell lennie,
- akár a Cloud-ban előkészített konfigurációs objektumon keresztül, akár
- „manuálisan” az elektronikus nyilvántartási rendszer által,
- és egyedi client-ID-vel kell rendelkeznie.
2. Integráció
Miután a client („pénztárgép”) üzembe helyezése sikeresen befejeződött, megkezdődhet az integráció.
Ez a szakasz útmutatást nyújt a pénztárgép (elektronikus nyilvántartási rendszer) és az adott client közötti dokumentumátviteli folyamatról.
2.1 REST webszolgáltatás
A következő cikk segítséget nyújt a REST webszolgáltatási felület integrációjának megkezdéséhez, amelyet
- a Windows-szolgáltatáshoz, valamint
- a Docker-konténerhez is.
Első lépések a pénzügyi szolgáltatással – RetailForce Software GmbH
2.2 NuGet-implementáció
A middleware nuget (DLL-) implementációjához segítséget a következő cikk nyújt: Első lépések a nuget implementációban – RetailForce Software GmbH.
2.3 Fájlrendszer-interfész
A fent említett két implementációs változat, a REST webszolgáltatás és a nuget mellett a middleware fájlrendszer-interfészen keresztül is elérhető. Erről további információkat a következő cikkben talál: Fájlrendszer-interfész – RetailForce Software GmbH.
2.4 Dokumentumátviteli folyamat
Miután a Fiscal Middleware-t – nagyjából a Windows-szolgáltatás formájában – telepítették egy számítógépre, az api leírás a http://localhost:7678/swagger/index.html címen érhető el.
Távoli számítógépre (pl. LAN-on) történő telepítés esetén a „localhost” helyett a middleware-t tartalmazó rendszer IP-címét használja.
A middleware összes végpontja a swaggerben van leírva. A dokumentumok (pl. készpénz-bizonylatok) továbbításához a „Transactions” szakasz végpontjai fontosak.
A dokumentumátvitel mindig kétlépcsős folyamat, amelyet a
- „createDocument” parancs indítja el, és vagy a
- „storeDocument” parancs, vagy – a dokumentum törlése esetén – a „cancelDocument” parancs.
A dokumentumátviteli folyamatot itt ismertetjük részletesen: Alapvető dokumentumátviteli folyamat – RetailForce Software GmbH.
2.5 Fiscal Service Client Sample
A RetailForce egy minta programot biztosít, a Fiscal Service Client Sample nevű programot. Ez útmutatást nyújt a JSON-struktúra létrehozásához, amelyben a dokumentumokat a Pénzügyi Szolgáltatásnak továbbítják.
A Fiscal Service Client Sample segítségével különböző dokumentumtípusokra és üzleti esetekre vonatkozó példák hozhatók létre.
A program leírása itt található: Fiscal Service Client Sample – RetailForce Software GmbH.
Különböző dokumentumok és üzleti esetek példáira a Solution Centerben is találhat példákat: Üzleti tranzakciók – RetailForce Software GmbH.
2.6 Végpontok listája
Ezt követően ismertetjük azokat a végpontokat, amelyeket minden esetben implementálni kell.
| Végpont | Leírás |
| PUT /api/va/management/clients | csak akkor szükséges, ha az ügyfélkonfigurációt a POS-szoftverből, és nem a Cloud-rendszerből kell elvégezni. Alternatíva: PUT /api/v1/management/clients/byCloud |
| PUT /api/v1/management/clients/byCloud | szükséges, ha az ügyfél konfigurálását a Cloud-rendszerből kell elvégezni. Alternatíva: PUT /api/va/management/clients |
| POST /api/v1/management/cloud/connect | létrehozza a client felhőkapcsolatát. Ezt a számítógép (rendszer) minden újraindítása után el kell végezni. A felhőkapcsolat létrehozásához szükséges adatokat (API-kulcs és API Secret) az elektronikus nyilvántartási rendszernek tárolnia kell. |
| POST /api/v1/management/clients/initialize | Inicializálja az ügyfelet vagy a szükséges adóügyi hardvereket (technikai biztonsági eszköz, aláírás-készítő egység, nyomtató stb.). Az inicializáláshoz indítódokumentumra van szükség. Ezt vagy az elektronikus nyilvántartási rendszer állíthatja elő, vagy automatikusan a middleware segítségével a GET /api/v1/transactions/document/{clientId}/start végponton keresztül. |
| GET /api/v1/transactions/document/{clientId}/start | Ajánlott. Létrehoz egy úgynevezett indítódokumentumot az adott client számára az inicializáláshoz. |
| PUT /api/v1/transactions/createDocument | Ez a módszer önmagában nem hoz létre dokumentumot, csupán elindítja a folyamatot például a németországi TSE-n (Technical Security Device). (Minden országban kötelező!) |
| POST /api/v1/transactions/storeDocument | Elmenti a megfelelő dokumentumot |
| POST /api/v1/transactions/cancelDocument | Törli a dokumentumot a fiskalizációs egységről. |
Ezt a cikket automatikusan lefordították.
Hozzászólások
0 hozzászólás
Hozzászólások írásához jelentkezzen be.