„RetailForce“ fiskalizacijos paslauga – tai .NET pagrindu sukurta fiskalizacijos middleware, skirta Vokietijai ir visoms kitoms šalims.

Įdiegimas

Fiskalinės paslaugos kopiją, skirtą „Windows“ sistemai, galite atsisiųsti naudodami šią nuorodą:

http://www.retailforce.cloud/downloads

Prašome atsisiųsti naujausią programinės įrangos versiją.

Įdiegti programą labai paprasta, daugiau informacijos nereikia.

Įdiegus programą, paslauga veikia kaip REST-WebService (JSON) 7678 prievade (HTTP). Paslauga priima duomenis iš visų kompiuterio tinklo sąsajų, ne tik iš „localhost“. Dėl šifruoto ryšio (HTTPS 7677 prievade) žr. „HTTPS aktyvavimas saugesniam api ryšiui“.

Alternatyvos

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

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

Informaciją apie šiuos diegimo / integravimo variantus galite rasti šiuose straipsniuose:

• „Docker“ konteineris: „Linux“ – „TrustedFiscalService“ kaip „Docker“ konteineris
• „nuget-packages“: pirmieji žingsniai diegiant „nuget“

Pavyzdinė programa

Pavyzdinę programą taip pat rasite minėtame atsisiuntimo kataloge, pakatalogyje „Samples“ („Fiscal Service Client Sample“). Šioje pavyzdinėje programoje pateikiamas visas paprasto įrašo ir pasirašymo C# kalba šaltinio kodas.

Norėdami naudoti pavyzdinę programą, galite naudoti šį client GUID:

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

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

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

Dokumento patvirtinimas

Siekiant palengvinti jūsų programinės įrangos integraciją, sukūrėme funkciją, skirtą patikrinti dokumento objektų modelį, kurį siųsite fiskalizacijos moduliui.

Kai iškviečiate „ValidateDocument“ metodą sukurtame „TrustedFiscalModule“ arba fiskalizacijos žiniatinklio paslaugoje (priklausomai nuo jūsų integracijos), iš karto gausite visas su dokumentu susijusias klaidas (ir įspėjimus). Taigi daug lengviau pritaikyti iškvietimo procedūrą, kad užbaigtumėte integracijos procesą.

Papildoma informacija

Middleware integravimas gali būti atliekamas šiais būdais

• Integracija per žiniatinklio paslaugą („Windows“, REST)
• Integracija per žiniatinklio paslaugą (su „Fiskalclient“ „.NET Standard“, „nuget“)
• Integracija per žiniatinklio paslaugą (naudojant „Fiskalclient“ su „.NET Framework 2.0“, „nuget“)
• Integracija per žiniatinklio paslaugą (kaip COM-DLL/ActiveX, teikiama pagal užklausą)
• Integracija kaip AAR paketas „Android“ įrenginyje (skirta „Java“) (prieinamumas priklauso nuo „Microsoft“ planų)

Keletas papildomų pastabų apie techninius aspektus

• Visa programinė įranga kuriama taikant testais pagrįstą programavimo metodiką
• Visi testai atliekami kūrimo proceso metu, kuriant naują versiją
• Sprendimo diegimas naudojant „nuget-packages“ paketus arba atsisiunčiant „Windows“ diegimo failą.

Operacinės sistemos

„RetailForce Middleware“ iki šiol buvo išbandyta šiose operacinėse sistemose:

• „Windows 7“
• „Windows 10“
• „Android“ (nuo 8 versijos) (kaip „nuget“ paketo integracija)
• „Linux“ (paslaugai)

Taip pat prašome susipažinti su saugumo sistemos dokumentacija, kad įsitikintumėte, ar pasirinkta saugumo sistema (TSE, HSM ir pan.) atitinkamoje šalyje palaiko jūsų operacinę sistemą.

Šiuo metu nepatikrinta ir nepalaikoma, tačiau turėtų veikti:

• „iOS“ (kaip „nuget“ paketo integracija)

Fiskalinių klientų valdymas

Iš patirties žinome, kad fiskalinių klientų valdymas kartais gali būti laiką atimantis ir varginantis.

Todėl sukūrėme šias papildomas paslaugas:

• Automatinis klientų konfigūravimas per RetailForce Cloud, kad nereikėtų prižiūrėti įdiegtų fiskalinių klientų
• „RetailForce Cloud“ debesies valdymo API, skirtas papildomų įmonių, parduotuvių ir terminalų bei visų kitų jums reikalingų pagrindinių duomenų valdymui.

Papildoma dokumentacija / paslaugų dokumentacija

Papildomą dokumentaciją rasite čia:

Išsamus žiniatinklio paslaugos aprašymas

• „http://localhost:7678/swagger “ (įdiegus žiniatinklio paslaugą)

Išsami fiskalinės paslaugos dokumentacija (objektų modelis)

Aplankų dokumentacija, esanti įdiegimo failų atsisiuntimo pakatalogyje (nuoroda į skyrių „Įdiegimas“)

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

Šalių charakteristikos (fiscalCountryProperties)

Šis straipsnis buvo išverstas automatiškai.