RetailForce razvija softver za usklađivanje s propisima o fiskalizaciji sustava elektroničkog evidentiranja u različitim zemljama. Taj se softver naziva "Fiscal Middleware".
Ovaj dokument pruža pregled o tome kako integrirati RetailForce fiskalni middleware. Arhitektura sustava izvorne aplikacije koja šalje i prima podatke od fiskalnog middlewarea, kao i posebni zahtjevi i funkcije tog sustava, mogu učiniti nužnim odstupanje od ovog opisa.
1. Osnove
U nastavku su navedeni pojedinačni koraci koje je potrebno provesti prije početka integracije. Ti se koraci također detaljno razmatraju tijekom onboarding sesije.
1.1 Pregled varijanti integracije
Prije nego što započnete s integracijom, upoznajte se s različitim dostupnim varijantama integracije. Te su varijante 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 ste preuzeli fiskalni middleware, izvršite instalaciju. Opis postupka instalacije različitih varijanti možete pronaći u preglednom članku.
1.1.1 Online naspram offline
RetailForce Fiscal Middleware u osnovi je samostalni softverski sustav. Međutim, razne funkcije dostupne su samo kada je middleware povezan s RetailForce Cloudom.
RetailForce Cloud pruža razne upravljačke funkcije, kao što su automatska daljinska konfiguracija middlewarea, uključujući dodjelu licenci, kao i sigurne dugoročne arhivske funkcije.
Kako bi se koristile funkcije RetailForce Clouda, Fiscal Middleware ili određeni klijent unutar instalacije (klijent = pojedinačni primjerak sustava za elektroničko snimanje) mora biti povezan s terminalom u RetailForce Cloudu.
Ako se middleware koristi bez uspostavljanja veze s oblakom (offline sustav), sljedeći se koraci mogu preskočiti. Nastavite s toč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)
Samostalna registracija na RetailForce portal nije moguća iz sigurnosnih razloga. Za pristup portalu morate primiti pozivnicu od već ovlaštenog korisnika. Naknadni postupak registracije opisan je u sljedećem članku: Registracija na RetailForce portal – RetailForce Software GmbH.
1.3 Organizacijska struktura
Organizacijska struktura prvo se mora stvoriti u portalu. Članak Stvaranje organizacijske strukture u RetailForce Cloudu – RetailForce Software GmbH pruža pregled funkcija koje su za tu svrhu dostupne.
1.4 Konfiguracija
Nakon što su u portalu stvoreni organizacijska struktura, najmanje jedna organizacija (=kupac), jedna trgovina (=poslovnica) i jedan terminal (=blagajna), konfiguracijski objekt mora se pripremiti u oblaku i dodijeliti entitetu (organizaciji, tvrtki, trgovini ili terminalu). Opis ovog postupka 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 može se puštati u rad. Koraci potrebni za puštanje u rad (s uspostavljanjem i bez uspostavljanja veze s oblakom) detaljnije su objašnjeni u članku Pokretanje (općenito) – RetailForce Software GmbH.
Kao rezultat procesa puštanja u rad/inicijalizacije, fiskalni klijent bi trebao
- trebao bi biti u potpunosti konfiguriran,
- ili putem konfiguracijskog objekta pripremljenog u oblaku, ili
- "ručno" od strane sustava elektroničkog evidentiranja,
- i imati jedinstveni ID klijenta.
2. Integracija
Nakon što je puštanje klijenta ("blagajne") u rad uspješno dovršeno, integracija se može pokrenuti.
Ovaj odjeljak pruža smjernice o procesu prijenosa dokumenata između blagajne (elektroničkog sustava evidencije) i određenog klijenta.
2.1 REST web servis
Sljedeći članak pomaže pri početku integracije REST web servisnog sučelja, koje se koristi za
- Windows uslugu, kao i
- Docker spremnik.
Prvi koraci s fiskalnom uslugom – RetailForce Software GmbH
2.2 nuget implementacija
Pomoć za nuget (DLL-) implementaciju middlewarea pruža sljedeći članak: Prvi koraci u nuget implementaciji – RetailForce Software GmbH.
2.3 Sučelje datotečnog sustava
Osim dviju gore navedenih varijanti implementacije, REST web usluge i nugeta, middleware se može pozvati i putem sučelja datoteka. Više informacija o tome možete pronaći u članku: Sučelje datotečnog sustava – RetailForce Software GmbH.
2.4 Proces prijenosa dokumenata
Nakon što je fiskalni middleware, u obliku Windows servisa, instaliran na računalu. Opis API-ja dostupan je putem http://localhost:7678/swagger/index.html.
U slučaju instalacije na udaljenom računalu (npr. LAN), koristite IP adresu sustava na kojem je instaliran middleware umjesto "localhost".
Svi krajevi (endpoints) posrednika opisani su u swaggeru. Za prijenos dokumenata (npr. gotovinskih bonova) važni su krajevi (endpoints) iz odjeljka "Transakcije".
Prijenos dokumenata uvijek je dvoetapni proces, koji se pokreće s
- "createDocument" i završava s bilo kojim od sljedećih
- "storeDocument" ili s "cancelDocument", u slučaju otkazivanja dokumenta.
Proces prijenosa dokumenata detaljno je objašnjen ovdje: Osnovni proces prijenosa dokumenata – RetailForce Software GmbH.
2.5 Primjer klijenta fiskalne usluge
RetailForce pruža primjer programa, Fiscal Service Client Sample. On pruža smjernice o tome kako stvoriti JSON strukturu u kojoj se dokumenti šalju Poreznoj službi.
Primjer klijenta fiskalne usluge može se koristiti za generiranje primjera različitih vrsta dokumenata i poslovnih slučajeva.
Opis programa možete pronaći na: Fiscal Service Client Sample – RetailForce Software GmbH.
Primjere različitih dokumenata i poslovnih slučajeva također možete pronaći u Centru rješenja na poveznici: Poslovne transakcije – RetailForce Software GmbH.
2.6 Popis krajnjih točaka
Zatim su opisani krajevi točke koje se u svakom slučaju moraju implementirati.
| Endpoint | Opis |
| PUT /api/va/management/clients | potrebno samo ako se konfiguracija klijenta radi iz POS softvera, a ne iz oblačnog sustava. Alternativa: PUT /api/v1/management/clients/byCloud |
| PUT /api/v1/management/clients/byCloud | potrebno ako se konfiguracija klijenta radi iz oblačnog sustava. Alternativa: PUT /api/va/management/clients |
| POST /api/v1/management/cloud/connect | uspostavlja cloud vezu klijenta. Mora se izvršiti nakon svakog ponovnog pokretanja računala (sustava). Podaci potrebni za uspostavljanje cloud veze (API ključ i API tajna) moraju biti pohranjeni u sustavu za elektroničko evidentiranje. |
| POST /api/v1/management/clients/initialize | Pokreće klijenta ili bilo koju potrebnu fiskalnu opremu (tehnički sigurnosni uređaj, jedinicu za izradu potpisa, pisač itd.). Za pokretanje je potreban početni dokument. On se može generirati ili sustavom za elektroničko evidentiranje ili automatski putem posredničkog sloja (middleware) na krajnjoj točki GET /api/v1/transactions/document/{clientId}/start. |
| GET /api/v1/transactions/document/{clientId}/start | Preporučeno. Stvara takozvani početni dokument za određenog klijenta, za inicijalizaciju. |
| PUT /api/v1/transactions/createDocument | Ova metoda sama ne stvara dokument, već samo pokreće proces, na primjer, na TSE-u (Tehnološkom sigurnosnom uređaju) u Njemačkoj. (Potrebno u svakoj zemlji!) |
| POST /api/v1/transactions/storeDocument | Pohranjuje odgovarajući dokument |
| POST /api/v1/transactions/cancelDocument | Otkazuje dokument na fiskalnoj jedinici. |
Ovaj je članak automatski preveden.
Komentari
0 komentara
Molimo Prijavite se kako bi ostavili komentar.