„RetailForce Fiskalservice“ – tai „Microsoft .NET“ pagrindu sukurta fiskalinė tarpinė programinė įranga, skirta Vokietijai ir visoms kitoms šalims.

Įdiegimas

„Fiskalservice“ kopiją, skirtą „Windows“ sistemai, galite atsisiųsti naudodami šią nuorodą:

http://www.retailforce.cloud/downloads

Prašome atkreipti dėmesį, kad atsisiųstumėte naujausią programinės įrangos versiją.

Įdiegti programą galima lengvai, be jokios papildomos informacijos.

Įdiegus programą, paslauga bus prieinama kaip REST žiniatinklio paslauga (Json) su prievado numeriu 7678 (HTTP) kaip „localhost“.

Alternatyvos

Kaip alternatyva REST žiniatinklio paslaugos įdiegimui, „RetailForce Fiskal Middleware“ taip pat yra prieinama kaip:

• „Docker“ konteineriu – atsisiųsti iš „Docker-Hub“ https://hub.docker.com/u/retailforce, taip pat
• „nuget“ paketais – paketus galima atsisiųsti iš: https://www.nuget.org/profiles/RetailForceDevelopment

.

Informaciją apie šias diegimo / integracijos galimybes rasite šiuose straipsniuose:

• „Docker“ konteineris: „Linux“ – „Trusted Fiscal Service“ kaip „Docker“ konteineris
• „nuget“ paketai: pirmieji žingsniai diegiant „nuget“

Pavyzdinė programa

Atsisiuntimo kataloge taip pat rasite pavyzdinę programą („Fiscal Service Client Sample“).

Pavyzdinėje programoje yra visas C# kalba parašytas šaltinio kodas, skirtas paprastam įrašymui ir pasirašymui.

Norėdami naudoti pavyzdinę programą, taip pat galite naudoti šį kliento gidą:

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

Šį kliento GUID galite be problemų naudoti pirmiesiems bandymams. Tolimesniems bandymams, taip pat ir su debesų integracija, turite sukurti savo bandomąjį klientą su „RetailForce“ debesimi.

Jei susidursite su problemomis dėl trūkstamų DLL failų, prašome peržiūrėti pavyzdinės programos projekto bin/debug aplanką.

Dokumento patvirtinimas / patikrinimas

Norėdami padėti jums integruoti savo programinę įrangą, sukūrėme funkciją, skirtą patikrinti dokumentų objektų modelį, kurį norite siųsti fiskaliniam moduliui.

Jei iškviesti „ValidateDocument“ metodą per sukurtą „TrustedFiscalModul“ arba fiskalinę žiniatinklio paslaugą (priklausomai nuo integracijos), iš karto bus grąžinti visi dokumento klaidos (ir įspėjimai). Taigi daug lengviau pritaikyti iškvietimo procedūrą, kad užbaigtumėte integracijos procesą.

Papildoma informacija

Tarpinės programinės įrangos integracija gali būti atliekama šiais būdais:

• Integracija per žiniatinklio paslaugą (Windows, REST)
• Integracija per žiniatinklio paslaugą (su „Fiskalclient“ .NET Standard, NuGet)
• Integracija per žiniatinklio paslaugą (su fiskaliniu klientu .NET Framework 2.0, NuGet)
• Integracija per žiniatinklio paslaugą (kaip COM-DLL/Active X, prieinama pagal užklausą)
• Integracija kaip AAR paketas „Android“ įrenginiuose (skirta „Java“) (prieinama priklausomai nuo „Microsoft“ planų)

Daugiau techninės informacijos

• Visa plėtra vyko kaip testais pagrįsta plėtra.
• Visi testai buvo atliekami kūrimo proceso metu, kuriant naują versiją.
• Sprendimo kūrimas naudojant „NuGet“ paketus arba kaip atsisiuntimas „Windows“ sąrankoje.

Operacinės sistemos

Iki šiol išbandėme šias operacines sistemas:

• „Windows 7“
• „Windows 10“
• „Android“ (nuo 8 versijos) (kaip „NuGet“ paketų integracija)
• Linux (interneto paslaugoms)

Taip pat prašome atsižvelgti į saugumo sistemos dokumentaciją, jei pasirinkta saugumo sistema (TSE, HSM ir pan.) atitinkamoje šalyje jus palaiko.

Šių operacinių sistemų mes dar nebandėme ir jos nėra palaikomos, tačiau turėtų veikti:

• iOS (kaip „NuGet“ paketo integracija

Fiskalclient valdymas

Mūsų patirtis rodo, kad fiskalinių klientų valdymas kartais yra labai varginantis ir sudėtingas.

Dėl šios priežasties sukūrėme šias papildomas paslaugas:

• Automatinis klientų konfigūravimas per „RetailForce Cloud“, nereikalaujantis kasos operatoriaus pastangų.
• „RetailForce Cloud Management API“ papildomų įmonių, parduotuvių ir terminalų bei visų kitų jums reikalingų pagrindinių duomenų valdymui.

Papildoma dokumentacija / Paslaugų dokumentacija

Daugiau informacijos rasite čia:

Išsamus žiniatinklio paslaugos aprašymas

• http://localhost:7678/swagger

Išsami fiskalinės paslaugos dokumentacija (objekto modelis)

Dokumentacijos aplankas atsisiuntimų pakatalogyje, skirtame diegimo dokumentams.

Ši dokumentacija netrukus bus prieinama adresu: http://docs.retailforce.cloud

Šalių savybės (FiscalCountryProperties)