Podjetje RetailForce razvija programsko opremo za usklajenost s predpisi glede fiskalizacije elektronskih sistemov evidentiranja v različnih državah. Ta programska oprema se imenuje »Fiscal Middleware«.

Ta dokument ponuja pregled nad tem, kako integrirati RetailForce Fiscal Middleware. Arhitektura sistema na višji stopnji, ki pošilja podatke v Fiscal Middleware in jih od njega prejema, ter posebne zahteve in funkcije tega sistema lahko zahtevajo odstopanje od tega opisa.

1. Osnove

V nadaljevanju so navedeni posamezni koraki, ki jih je treba izvesti, preden začnete z integracijo. Ti koraki so podrobno obravnavani tudi med uvajalnim sestankom.

1.1 Pregled variant integracij

Preden začnete z integracijo, si oglejte pregled različnih variant integracije, ki so na voljo. Te variante so opisane v naslednjem članku: Pregled fiskalizacije z RetailForce – RetailForce Software GmbH (=članek s pregledom).

V povezani objavi najdete tudi vire, iz katerih lahko prenesete RetailForce Middleware v različnih različicah.

Ko prenesete programsko opremo Fiscal Middleware, jo namestite. Opis namestitve različnih različic najdete v članku s pregledom.

1.1.1 Spletno proti nespletnemu

RetailForce Fiscal Middleware je v osnovi samostojen programski sistem. Vendar so nekatere funkcije na voljo le, če je middleware povezan z RetailForce Cloud.

RetailForce Cloud ponuja različne funkcije upravljanja, kot so avtomatska konfiguracija middlewarea na daljavo, vključno z dodeljevanjem licenc, ter funkcije za varno dolgoročno arhiviranje.

Da bi lahko uporabljali funkcije RetailForce Cloud, mora biti Fiscal Middleware ali posamezni odjemalec znotraj namestitve (odjemalec = posamezna instanca sistema za elektronsko evidentiranje) povezan s terminalom v RetailForce Cloud.

Če naj bi se middleware uporabljal brez vzpostavitve povezave z Cloudom (offline sistem), se lahko naslednji koraki preskočijo. Nadaljujte s točko 1.5.

1.2 Dostop do RetailForce portala

Vse funkcije RetailForce Cloud so na voljo prek

• RetailForce Cloud Portal (https://portal.retailforce.cloud) ter prek
• Cloud API (https://api.retailforce.cloud/swagger)

Samostojna registracija v portalu RetailForce zaradi varnostnih razlogov ni mogoča. Za dostop do portala morate prejeti povezavo s povabilom od že pooblaščenega uporabnika. Nadaljnji postopek registracije je opisan v naslednjem članku: Registracija v portalu RetailForce – RetailForce Software GmbH.

1.3 Organizacijska struktura

V portalu je treba najprej ustvariti organizacijsko strukturo. Članek Ustvarjanje organizacijske strukture v RetailForce Cloud – RetailForce Software GmbH ponuja pregled funkcij, ki so na voljo za ta namen.

1.4 Konfiguracija

Ko so ustvarjeni organizacijska struktura, vsaj ena organizacija (=stranka), ena trgovina (=podružnica) in en terminal (=blagajna), je treba v Cloud pripraviti konfiguracijski objekt in ga dodeliti subjektu (organizaciji, podjetju, trgovini ali terminalu). Opis tega postopka najdete v: Splošne informacije o konfiguraciji – RetailForce Software GmbH.

1.5 Inicializacija

Če so bili prejšnji koraki uspešno izvedeni, je mogoče zagnati programsko opremo Fiscal Middleware. Koraki, potrebni za zagon (z vzpostavitvijo povezave z oblakom in brez nje), so podrobneje razloženi v članku Inicializacija (splošno) – RetailForce Software GmbH.

Po zaključku postopka zagon/inicializacija mora biti program Fiscal Client

• v celoti konfiguriran,
  • bodisi prek konfiguracijskega objekta, pripravljenega v Cloudu, bodisi
  • »ročno« s strani sistema za elektronsko evidentiranje,
• in imeti edinstveno ID stranke.

2. Integracija

Ko je zagon stranke („blagajne“) uspešno zaključen, se lahko začne integracija.

Ta poglavje vsebuje navodila o postopku prenosa dokumentov med blagajno (sistemom za elektronsko evidentiranje) in posameznim klientom.

2.1 Spletna storitev REST

Naslednji članek vam bo v pomoč pri začetku integracije vmesnika spletne storitve REST, ki se uporablja za

• storitev v sistemu Windows kot tudi
• za Dockerjev kontejner.

Prvi koraki s fiskalno storitvijo – RetailForce Software GmbH

2.2 Izvedba v NuGet

Pomoč pri implementaciji middleware-a prek nuget (DLL) je na voljo v naslednjem članku: Prvi koraki pri implementaciji prek nuget – RetailForce Software GmbH.

2.3 Vmesnik datotečnega sistema

Poleg zgoraj omenjenih dveh variant implementacije, spletne storitve REST in nuget, je mogoče do middleware dostopati tudi prek vmesnika datotečnega sistema. Več informacij o tem najdete v članku: Vmesnik datotečnega sistema – RetailForce Software GmbH.

2.4 Postopek prenosa dokumentov

Ko je fiskalna middleware programska oprema, ki deluje podobno kot storitev sistema Windows, nameščena na računalniku, je opis api-ja dostopen prek http://localhost:7678/swagger/index.html.

V primeru namestitve na oddaljenem računalniku (npr. v omrežju LAN) namesto »localhost« uporabite IP-naslov sistema, na katerem je bil nameščen middleware.

Vse končne točke middlewarea so opisane v swaggerju. Za prenos dokumentov (npr. blagajniških potrdil) so pomembne končne točke iz razdelka »Transakcije«.

Prenos dokumentov je vedno dvofazni proces, ki se začne s

1. »createDocument« in se konča bodisi z
2. »storeDocument« ali z »cancelDocument«, v primeru preklica dokumenta.

Postopek prenosa dokumentov je podrobno razložen tukaj: Osnovni postopek prenosa dokumentov – RetailForce Software GmbH.

2.5 Fiscal Service Client Sample

RetailForce ponuja vzorčni program, imenovan »Fiscal Service Client Sample«. Ta ponuja navodila za ustvarjanje strukture JSON, v kateri se dokumenti pošiljajo davčni službi.

Fiscal Service Client Sample se lahko uporabi za ustvarjanje primerov različnih vrst dokumentov in poslovnih primerov.

Opis programa najdete na: Fiscal Service Client Sample – RetailForce Software GmbH.

Primere različnih dokumentov in poslovnih primerov najdete tudi v Solution Centerju na: Poslovne transakcije – RetailForce Software GmbH.

2.6 Seznam končnih točk

V nadaljevanju so opisane končne točke, ki jih je v vsakem primeru treba implementirati.

Ta članek je bil samodejno preveden.