Služba RetailForce pre daňovú evidenciu je middleware pre daňovú evidenciu založený na platforme .NET pre Nemecko a všetky ostatné krajiny.
Inštalácia
Kópiu služby fiskalizácie pre Windows si môžete stiahnuť prostredníctvom nasledujúceho odkazu:
http://www.retailforce.cloud/downloads
Stiahnite si prosím najnovšiu verziu softvéru.
Inštalácia je jednoduchá, ďalšie informácie nie sú potrebné.
Po inštalácii je služba dostupná ako REST-WebService (JSON) na porte 7678 (HTTPS) na localhost.
Alternatívy
Ako alternatíva k inštalácii webovej služby REST je RetailForce Fiskal middleware k dispozícii aj ako:
- Docker-kontajner – na stiahnutie na Docker Hub https://hub.docker.com/u/RetailForce, ako aj
- nuget-packages – balíky si môžete stiahnuť na adrese: https://www.nuget.org/profiles/RetailForceDevelopment
Informácie o týchto variantoch inštalácie/integrácie nájdete v nasledujúcich článkoch:
- Docker-kontajner: Linux – TrustedFiscalService ako Docker-kontajner
- nuget-packages: Prvé kroky pri implementácii nuget
Ukážková aplikácia
V uvedenom adresári na stiahnutie nájdete v podadresári Samples (Fiscal Service Client Sample) aj vzorovú aplikáciu. Táto vzorová aplikácia obsahuje celý zdrojový kód pre jednoduché zaúčtovanie a podpisovanie v jazyku C#.
Na používanie vzorovej aplikácie môžete použiť nasledujúci client-guid:
{c1062c55-57c4-4ed2-9c53-aff1762326a4}
Tento clientský GUID môžete bez problémov použiť na svoje prvé testy. Pre ďalšie testy, aj s integráciou do Cloudu, si musíte vytvoriť vlastného testovacieho klienta v RetailForce Cloud.
Ak narazíte na problémy s chýbajúcimi súbormi DLL, pozrite sa do priečinka „bin/debug“ projektu v ukážkovej aplikácii.
Validácia dokumentov
Aby sme vám pomohli pri integrácii vášho softvéru, pripravili sme funkciu na overenie objektového modelu dokumentu, ktorý budete odosielať do fiskalizačného modulu.
Keď vyvoláte metódu ValidateDocument na vytvorenom TrustedFiscalModule alebo vo webovej službe fiskalizácie (v závislosti od vašej integrácie), získate naraz všetky chyby (a varovania) týkajúce sa dokumentu. Vďaka tomu je oveľa jednoduchšie prispôsobiť volajúci postup a dokončiť proces integrácie.
Ďalšie informácie
Integráciu middleware je možné realizovať nasledujúcimi spôsobmi
- Integrácia prostredníctvom webovej služby (Windows, REST)
- Integrácia prostredníctvom webovej služby (s Fiskalclient v .NET Standard, nuget)
- Integrácia prostredníctvom webovej služby (s Fiskalclient v .NET Framework 2.0, nuget)
- Integrácia prostredníctvom webovej služby (ako COM-DLL/ActiveX, k dispozícii na požiadanie)
- Integrácia ako balík AAR na zariadeniach s Androidom (pre Java) (dostupnosť závisí od plánov spoločnosti Microsoft)
Niekoľko doplňujúcich informácií o technických aspektoch
- Celý vývoj prebieha formou testovo riadeného vývoja
- Všetky testy sa vykonávajú počas procesu kompilácie pri vytváraní novej verzie
- Nasadenie riešenia prostredníctvom balíkov nuget-packages alebo aj prostredníctvom stiahnutia inštalačného súboru pre Windows.
Operačné systémy
RetailForce Middleware bol doteraz testovaný na nasledujúcich operačných systémoch:
- Windows 7
- Windows 10
- Android (od verzie 8) (ako integrácia balíka nuget)
- Linux (pre službu)
Preverte si tiež dokumentáciu bezpečnostného systému, či zvolený bezpečnostný systém (TSE, HSM atď.) v príslušnej krajine podporuje váš operačný systém.
Momentálne nie je testované ani podporované, ale malo by fungovať:
- iOS (ako integrácia balíka nuget)
Správa daňových klientov
Z našich skúseností vyplýva, že správa daňových klientov môže byť niekedy časovo náročná a komplikovaná.
Preto sme vytvorili nasledujúce doplnkové služby:
- Automatická konfigurácia klienta prostredníctvom RetailForce Cloud, vďaka čomu nie je potrebná údržba nainštalovaného daňového klienta
- RetailForce Cloud API pre správu cloudu RetailForce na správu ďalších spoločností, predajní a terminálov a všetkých ostatných kmeňových údajov, ktoré budete potrebovať.
Dodatočná dokumentácia / dokumentácia k službám
Ďalšiu dokumentáciu nájdete tu:
Kompletný popis webovej služby
- http://localhost:7678/swagger (po inštalácii webovej služby)
Kompletná dokumentácia (objektový model) fiškálnej služby
Dokumentácia v priečinku „download“ v rámci inštalačných súborov (odkaz v kapitole „Inštalácia“)
Táto dokumentácia bude čoskoro k dispozícii na adrese http://docs.RetailForce.Cloud.
Charakteristiky krajín (fiscalCountryProperties)
Tento článok bol preložený automaticky.
Príspevky
0 komentárov
Ak chcete napísať komentár, prihlásiť sa.