Spoločnosť RetailForce vyvíja softvér na zabezpečenie súladu s predpismi týkajúcimi sa fiskalizácie elektronických záznamových systémov v rôznych krajinách. Tento softvér sa nazýva „Fiscal Middleware“.
Tento dokument poskytuje prehľad o tom, ako integrovať RetailForce Middleware. Architektúra nadväzujúceho systému, ktorý odosiela a prijíma údaje z RetailForce Middleware, ako aj špeciálne požiadavky a funkcie tohto systému môžu spôsobiť, že bude potrebné od tohto popisu upustiť.
1. Základy
V nasledujúcej časti sú uvedené jednotlivé kroky, ktoré je potrebné vykonať pred začatím integrácie. Tieto kroky sú podrobne rozoberané aj počas úvodnej schôdzky.
1.1 Prehľad variantov integrácie
Pred začatím integrácie si urobte prehľad o rôznych dostupných variantoch integrácie. Tieto varianty sú popísané v nasledujúcom článku: Prehľad fiskalizácie s RetailForce – RetailForce Software GmbH (=prehľadový článok).
V uvedenom článku nájdete aj zdroje, z ktorých si môžete stiahnuť RetailForce Middleware v rôznych variantoch.
Po stiahnutí Fiscal Middleware vykonajte inštaláciu. Popis inštalácie jednotlivých variantov nájdete v prehľadovom článku.
1.1.1 Online vs. offline
RetailForce Fiscal Middleware je v podstate samostatný softvérový systém. Niektoré funkcie sú však k dispozícii len vtedy, ak je middleware pripojený k RetailForce Cloud.
RetailForce Cloud poskytuje rôzne funkcie správy, ako je automatická vzdialená konfigurácia middleware vrátane prideľovania licencií, ako aj funkcie bezpečnej dlhodobej archivácie.
Aby bolo možné využívať funkcie služby RetailForce Cloud, musí byť Fiscal Middleware alebo konkrétny klient v rámci inštalácie (klient = jedna inštancia elektronického záznamového systému) pripojený k terminálu v službe RetailForce Cloud.
Ak má byť middleware prevádzkovaný bez nadviazania Cloud pripojenia (offline systém), nasledujúce kroky je možné preskočiť. Pokračujte bodom 1.5.
1.2 Prístup k RetailForce portalu
Všetky funkcie služby RetailForce Cloud sú k dispozícii prostredníctvom
- RetailForce Cloud Portal (https://portal.retailforce.cloud), ako aj prostredníctvom
- Cloud API (https://api.retailforce.cloud/swagger)
Samostatná registrácia na RetailForce portal nie je z bezpečnostných dôvodov možná. Na získanie prístupu k portálu musíte dostať pozvánku od už autorizovaného používateľa. Následný proces registrácie je popísaný v nasledujúcom článku: Registrácia na RetailForce portal – RetailForce Software GmbH.
1.3 Organizačná štruktúra
V portáli je najprv potrebné vytvoriť organizačnú štruktúru. Článok Vytvorenie organizačnej štruktúry v RetailForce Cloud – RetailForce Software GmbH poskytuje prehľad funkcií, ktoré sú na tento účel k dispozícii.
1.4 Konfigurácia
Po vytvorení organizačnej štruktúry, minimálne jednej organizácie (= zákazník), jednej predajne (= pobočka) a jedného terminálu (= pokladňa) je potrebné v cloude pripraviť konfiguračný objekt a priradiť ho k entite (organizácii, spoločnosti, predajni alebo terminálu). Popis tohto procesu nájdete v článku: Všeobecné informácie o konfigurácii – RetailForce Software GmbH.
1.5 Inicializácia
Ak boli predchádzajúce kroky úspešne vykonané, je možné uviesť do prevádzky Fiscal Middleware. Kroky potrebné na uvedenie do prevádzky (s nadviazaním cloudového pripojenia aj bez neho) sú podrobnejšie vysvetlené v článku Inicializácia (všeobecne) – RetailForce Software GmbH.
V dôsledku procesu uvedenia do prevádzky/inicializácie by mal byť Fiscal Client
- plne nakonfigurovaný,
- buď prostredníctvom konfiguračného objektu pripraveného v Cloude, alebo
- „ručne“ prostredníctvom systému elektronického záznamu,
- a mal by mať jedinečné ID klienta.
2. Integrácia
Po úspešnom dokončení uvedenia klienta („pokladne“) do prevádzky je možné začať s integráciou.
Táto časť obsahuje pokyny k procesu prenosu dokumentov medzi pokladnicou (systémom elektronického záznamu) a konkrétnym klientom.
2.1 Webová služba REST
Nasledujúci článok pomáha pri začatí integrácie rozhrania webovej služby REST, ktorá sa používa pre
- službu v systéme Windows, ako aj
- kontajner Docker.
Prvé kroky s daňovou službou – RetailForce Software GmbH
2.2 Implementácia cez NuGet
Pomoc pri implementácii middlewaru prostredníctvom nuget (DLL) nájdete v nasledujúcom článku: Prvé kroky pri implementácii cez nuget – RetailForce Software GmbH.
2.3 Rozhranie súborového systému
Okrem dvoch vyššie uvedených variantov implementácie, webovej služby REST a nuget, je možné na middleware pristupovať aj prostredníctvom súborového rozhrania. Viac informácií o tom nájdete v článku: Rozhranie súborového systému – RetailForce Software GmbH.
2.4 Proces prenosu dokumentov
Po inštalácii Fiscal Middleware na počítači, ktorý funguje v podobe služby Windows. Popis api je dostupný na adrese http://localhost:7678/swagger/index.html.
V prípade inštalácie na vzdialenom počítači (napr. v sieti LAN) použite namiesto „localhost“ IP adresu systému, na ktorom bol middleware nainštalovaný.
Všetky koncové body middleware sú popísané v swaggeri. Pre prenos dokumentov (napr. pokladničných dokladov) sú dôležité koncové body v sekcii „Transactions“.
Prenos dokumentov je vždy dvojfázový proces, ktorý sa začína volaním
- „createDocument“ a končí buď
- „storeDocument“, alebo v prípade zrušenia dokumentu funkciou „cancelDocument“.
Proces prenosu dokumentov je podrobne vysvetlený tu: Základný proces prenosu dokumentov – RetailForce Software GmbH.
2.5 Fiscal Service Client Sample
Spoločnosť RetailForce poskytuje vzorový program s názvom Fiscal Service Client Sample. Ten slúži ako návod na vytvorenie štruktúry JSON, v ktorej sa dokumenty odosielajú daňovej službe.
Fiscal Service Client Sample možno použiť na generovanie príkladov rôznych typov dokumentov a obchodných prípadov.
Popis programu nájdete na: Fiscal Service Client Sample – RetailForce Software GmbH.
Príklady rôznych dokumentov a obchodných prípadov nájdete aj v Centre riešení na adrese: Obchodné transakcie – RetailForce Software GmbH.
2.6 Zoznam koncových bodov
Ďalej sú popísané koncové body, ktoré by mali byť v každom prípade implementované.
| Koncový bod | Popis |
| PUT /api/va/management/clients | potrebné len v prípade, ak sa konfigurácia klienta má vykonať z POS softvéru a nie z cloudového systému. Alternatíva: PUT /api/v1/management/clients/byCloud |
| PUT /api/v1/management/clients/byCloud | potrebné, ak sa má konfigurácia klienta vykonať z cloudového systému. Alternatíva: PUT /api/va/management/clients |
| POST /api/v1/management/cloud/connect | vytvorí cloudové pripojenie klienta. Musí sa vykonať po každom reštarte počítača (systému). Údaje potrebné na vytvorenie cloudového pripojenia (API kľúč a API Secret) musia byť uložené v elektronickom záznamovom systéme. |
| POST /api/v1/management/clients/initialize | Inicializuje klienta alebo akýkoľvek potrebný daňový hardvér (technické bezpečnostné zariadenie, jednotka na vytváranie podpisov, tlačiareň atď.). Na inicializáciu je potrebný počiatočný dokument. Ten môže vygenerovať buď elektronický záznamový systém, alebo automaticky prostredníctvom middleware s koncovým bodom GET /api/v1/transactions/document/{clientId}/start. |
| GET /api/v1/transactions/document/{clientId}/start | Odporúčané. Vytvorí takzvaný počiatočný dokument pre konkrétneho klienta na účely inicializácie. |
| PUT /api/v1/transactions/createDocument | Táto metóda sama o sebe nevytvára dokument, iba spúšťa proces napríklad na TSE (technickom bezpečnostnom zariadení) v Nemecku. (Povinné v každej krajine!) |
| POST /api/v1/transactions/storeDocument | Uloží príslušný dokument |
| POST /api/v1/transactions/cancelDocument | Zruší dokument vo fiskalizačnej jednotke. |
Tento článok bol preložený automaticky.
Príspevky
0 komentárov
Ak chcete napísať komentár, prihlásiť sa.