RetailForce razvija softver za usklađivanje s propisima o fiskalizaciji sistema elektronskog evidentiranja u različitim zemljama. Ovaj softver se naziva "Fiscal Middleware".

Ovaj dokument pruža pregled o tome kako integrirati RetailForce fiskalni middleware. Arhitektura sistema izvorne aplikacije koja šalje i prima podatke od fiskalnog middlewarea, kao i posebni zahtjevi i funkcije ovog sistema, mogu učiniti neophodnim odstupanje od ovog opisa.

1. Osnove

U nastavku su navedeni pojedinačni koraci koje je potrebno izvršiti prije početka integracije. Ovi koraci se također detaljno razmatraju tokom onboarding sesije.

1.1 Pregled varijanti integracije

Prije nego što započnete s integracijom, upoznajte se s različitim dostupnim varijantama integracije. Ove varijante su opisane u sljedećem članku: Pregled fiskalizacije s RetailForce – RetailForce Software GmbH (= članak s pregledom).

Izvori s kojih možete preuzeti RetailForce Fiscal Middleware u različitim varijantama također se nalaze u povezanom članku.

Nakon što preuzmete Fiscal Middleware, izvršite instalaciju. Opis kako instalirati različite varijante možete pronaći u preglednom članku.

1.1.1 Online naspram offline

RetailForce Fiscal Middleware je u suštini samostalni softverski sistem. Međutim, različite funkcije su dostupne samo kada je middleware povezan sa RetailForce Cloudom.

RetailForce Cloud pruža različite funkcije upravljanja, kao što su automatska daljinska konfiguracija middlewarea, uključujući dodjelu licenci, kao i sigurne dugoročne funkcije arhiviranja.

Da biste koristili funkcije RetailForce Clouda, Fiscal Middleware ili određeni klijent unutar instalacije (klijent = pojedinačni primjerak sistema za elektronsko evidentiranje) mora biti povezan sa terminalom u RetailForce Cloudu.

Ako se middleware koristi bez uspostavljanja veze s cloudom (offline sistem), sljedeći koraci se mogu preskočiti. Nastavite s tačkom 1.5.

1.2 Pristup RetailForce portalu

Sve funkcije RetailForce Clouda dostupne su putem

• RetailForce Cloud Portal (https://portal.retailforce.cloud) kao i putem
• Cloud-API (https://api.retailforce.cloud/swagger)

Samoregistracija na RetailForce portal nije moguća iz sigurnosnih razloga. Da biste dobili pristup portalu, morate dobiti pozivnicu od već ovlaštenog korisnika. Naknadni proces registracije opisan je u sljedećem članku: Registracija na RetailForce portal – RetailForce Software GmbH.

1.3 Organizaciona struktura

Organizacijska struktura se prvo mora kreirati u portalu. Članak Kreiranje organizacijske strukture u RetailForce Cloudu – RetailForce Software GmbH pruža pregled funkcija koje su dostupne u tu svrhu.

1.4 Konfiguracija

Nakon što su kreirane organizacijska struktura, najmanje jedna organizacija (=kupac), jedna prodavnica (=filijala) i jedan terminal (=blagajna), mora se pripremiti konfiguracijski objekt u cloudu i dodijeliti entitetu (organizaciji, kompaniji, prodavnici ili terminalu). Opis ovog procesa možete pronaći pod: Opće informacije o konfiguraciji – RetailForce Software GmbH.

1.5 Inicijalizacija

Ako su prethodni koraci uspješno izvršeni, fiskalni middleware se može puštati u rad. Koraci potrebni za puštanje u rad (sa i bez uspostavljanja veze sa cloudom) detaljnije su objašnjeni u članku Inicijalizacija (općenito) – RetailForce Software GmbH.

Kao rezultat procesa puštanja u rad/inicijalizacije, Fiskalni klijent bi trebao

• trebao bi biti u potpunosti konfigurisan,
  • ili putem konfiguracijskog objekta pripremljenog u oblaku, ili
  • "ručno" od strane sistema elektronskog evidentiranja,
• i imati jedinstveni ID klijenta.

2. Integracija

Nakon što je puštanje u rad klijenta ("blagajne") uspješno završeno, integracija se može pokrenuti.

Ovaj odjeljak pruža smjernice o procesu prijenosa dokumenata između blagajne (elektronskog sistema evidencije) i određenog klijenta.

2.1 REST web servis

Sljedeći članak pomaže pri početku integracije REST web servis interfejsa, koji se koristi za

• Windows servis, kao i
• Docker kontejner.

Prvi koraci sa fiskalnom uslugom – RetailForce Software GmbH

2.2 nuget implementacija

Pomoć za nuget (DLL-) implementaciju middlewarea pružena je u sljedećem članku: Prvi koraci u nuget implementaciji – RetailForce Software GmbH.

2.3 Interfejs datotečnog sistema

Pored dvije gore navedene varijante implementacije, REST web servisa i nugeta, middleware se također može pozvati putem interfejsa za datoteke. Više informacija o tome možete pronaći u članku: Interfejs za datotečni sistem – RetailForce Software GmbH.

2.4 Proces prijenosa dokumenata

Nakon što je fiskalni middleware, u obliku Windows servisa, instaliran na računaru. Opis API-ja dostupan je putem http://localhost:7678/swagger/index.html.

U slučaju instalacije na udaljenom računaru (npr. LAN), koristite IP adresu sistema na kojem je instaliran middleware umjesto "localhost".

Svi krajevi (endpoints) middlewarea opisani su u swaggeru. Važni za prijenos dokumenata (npr. gotovinski bonovi) su krajevi (endpoints) iz odjeljka "Transakcije".

Prijenos dokumenata je uvijek dvostepeni proces, koji se pokreće sa

1. "createDocument" i završava se jednim od
2. "storeDocument" ili sa "cancelDocument", u slučaju otkazivanja dokumenta.

Proces prijenosa dokumenata je detaljno objašnjen ovdje: Osnovni proces prijenosa dokumenata – RetailForce Software GmbH.

2.5 Primjer klijenta fiskalne službe

RetailForce pruža primjer programa, Fiscal Service Client Sample. Ovaj primjer daje upute o tome kako kreirati JSON strukturu u kojoj se dokumenti šalju Fiscijalnoj službi.

Primjer klijenta fiskalne službe može se koristiti za generisanje primjera različitih tipova dokumenata i poslovnih slučajeva.

Opis programa možete pronaći na: Fiscal Service Client Sample – RetailForce Software GmbH.

Također možete pronaći primjere različitih dokumenata i poslovnih slučajeva u Centru rješenja na: Poslovne transakcije – RetailForce Software GmbH.

2.6 Lista krajnjih tačaka

Zatim su opisani krajevi tačaka koje se u svakom slučaju moraju implementirati.

Ovaj članak je automatski preveden.