Služba fiskalizace RetailForce je fiskalizační middleware založený na platformě .NET pro Německo a všechny ostatní země.

Instalace

Kopii fiskální služby pro Windows si můžete stáhnout pomocí následujícího odkazu:

http://www.retailforce.cloud/downloads

Stáhněte si prosím nejnovější verzi softwaru.

Instalace je velmi jednoduchá, nejsou k ní potřeba žádné další informace.

Po instalaci je služba dostupná jako REST-WebService (Json) na portu 7678 (HTTP). Služba naslouchá na všech síťových rozhraních počítače, nejen na localhostu. Pro šifrovanou komunikaci (HTTPS na portu 7677) viz Aktivace HTTPS pro bezpečnější komunikaci přes API.

Alternativy

Jako alternativa k instalaci webové služby REST je RetailForce Fiskal Middleware k dispozici také jako:

• Docker-kontejner – ke stažení na Docker Hubu https://hub.docker.com/u/retailforce, stejně jako
• balíčky NuGet – balíčky si můžete stáhnout na adrese: https://www.nuget.org/profiles/RetailForceDevelopment

Informace o těchto variantách instalace/integrace naleznete v následujících článcích:

• Docker-kontejner: Linux – TrustedFiscalService jako Docker-kontejner
• Balíčky NuGet: První kroky při implementaci NuGet

Ukázková aplikace

V výše uvedeném adresáři ke stažení najdete v podsložce Samples také ukázkovou aplikaci (Fiscal Service Client Sample). Tato ukázková aplikace obsahuje kompletní zdrojový kód pro jednoduché zaúčtování a podepisování v jazyce C#.

Pro použití vzorové aplikace můžete použít následující klientní GUID:

{c1062c55-57c4-4ed2-9c53-aff1762326a4}

Tento klientní GUID můžete bez problémů použít pro své první testy. Pro další testy, včetně integrace s Cloudem, si musíte vytvořit vlastní testovacího klienta v Cloudu RetailForce.

Pokud narazíte na problémy s chybějícími soubory DLL, podívejte se prosím do složky bin/debug projektu ve vzorové aplikaci.

Ověření dokumentu

Abychom vám usnadnili integraci vašeho softwaru, vytvořili jsme funkci pro ověření objektového modelu dokumentu, který odešlete do fiskalizačního modulu.

Když zavoláte metodu ValidateDocument na vytvořeném TrustedFiscalModule nebo na webové službě fiskalizace (v závislosti na vaší integraci), získáte najednou všechny chyby (a varování) týkající se dokumentu. Je tak mnohem snazší přizpůsobit volací proceduru tak, aby byl proces integrace dokončen.

Další informace

Integraci middlewaru lze provést následujícími způsoby

• Integrace prostřednictvím webové služby (Windows, REST)
• Integrace prostřednictvím webové služby (s Fiskalclient v .NET Standard, NuGet)
• Integrace prostřednictvím webové služby (s Fiskalclient v .NET Framework 2.0, NuGet)
• Integrace prostřednictvím webové služby (jako COM-DLL/ActiveX, k dispozici na vyžádání)
• Integrace jako balíček AAR na zařízení s Androidem (pro Javu) (dostupnost závisí na plánech společnosti Microsoft)

Několik doplňujících informací o technických aspektech

• Celý vývoj probíhá formou testem řízeného vývoje
• Všechny testy se provádějí během procesu sestavování při vytváření nové verze
• Nasazení řešení prostřednictvím balíčků NuGet nebo také stažením instalačního programu pro Windows.

Operační systémy

RetailForce Fiscal Middleware byl dosud testován na následujících operačních systémech:

• Windows 7
• Windows 10
• Android (od verze 8) (jako integrace balíčku NuGet)
• Linux (pro službu)

Prosím, podívejte se také do dokumentace k bezpečnostnímu systému, zda zvolený bezpečnostní systém (TSE, HSM atd.) v příslušné zemi podporuje váš operační systém.

V současné době není testováno ani podporováno, ale mělo by fungovat:

• iOS (jako integrace balíčku NuGet)

Správa daňových klientů

Z naší zkušenosti může být správa daňových klientů někdy časově náročná a obtížná.

Proto jsme vytvořili následující doplňkové služby:

• Automatická konfigurace klienta prostřednictvím Cloudu RetailForce, díky čemuž není třeba provádět údržbu nainstalovaného fiskálního klienta
• Rozhraní API pro správu Cloudu RetailForce pro správu dalších společností, prodejen a terminálů a všech dalších kmenových dat, která budete potřebovat.

Doplňková dokumentace / dokumentace ke službám

Další dokumentaci najdete zde:

Kompletní popis webové služby

• http://localhost:7678/swagger (po instalaci webové služby)

Kompletní dokumentace (objektový model) fiskální služby

Dokumentace ve složce „download“ v podadresáři instalačních souborů (odkaz v kapitole „Instalace“)

Tato dokumentace bude brzy k dispozici na adrese http://docs.retailforce.cloud.

Charakteristiky zemí (FiscalCountryProperties)

Tento článek byl přeložen automaticky.