Ovaj članak pruža pregled API funkcija fiskalne usluge RetailForce (status: verzija 1.6.3). Obavezni parametri svakog endpointa mogu se pregledati putem Swagger-a (npr. http://localhost:7678/swagger/index.html) nakon instalacije fiskalnog middlewarea.
API je podijeljen na različita područja, koja se koriste za različite svrhe i proizvode.
Informacije u koloni "Type":
- O ... opcionalno
- M ... obavezno / potrebno
- M* ... obavezno / potrebno u određenim zemljama ili pod određenim uslovima
- R ... preporučeno
Naslovi se odnose na odgovarajuću sekciju u Swaggeru. Za neke krajnje tačke pronaći ćete linkove na dodatne informacije.
Arhiva
Kratki opis: Funkcija arhiviranja već fiskaliziranih podataka.
Endpointi u ovom odjeljku koriste se za prijenos podataka u sigurnu arhivu Secure RetailForce.
| krajnja tačka | Tip | Opis |
| POST /api/v1/archive/de/{clientId} | O | Ova metoda se koristi za učitavanje više datoteka u oblačni arhiv. |
| GET /api/v1/archive/de/{clientId} | O | Koristi se za preuzimanje prethodno arhiviranih podataka (datoteka) iz oblačnog arhiva. |
Sigurnosna kopija
Kratki opis: Funkcija arhiviranja proizvoljnih POS podataka
Endpointi u ovom odjeljku služe za učitavanje bilo kojih podataka u oblačni arhiv – za uslugu/proizvod: "POS Archive". Potrebna je Backup-licenca za korištenje ove usluge.
| Krajnja tačka | Tip | Opis |
| POST /api/v1/backup/{clientId} | O | Ovaj metod pravi sigurnosnu kopiju zadane mape u oblačnu arhivu. |
| POST /api/v1/backup/{clientId}/restore | O | Obnavlja prethodno arhiviranu (sigurnosnu) datoteku na određenu lokaciju. |
| GET /api/v1/backup/{clientId}/restore | O | Vraća URL za preuzimanje, koji se može koristiti za preuzimanje tražene datoteke sigurnosne kopije iz oblačnog arhiva. |
Završetak
Kratak opis: Funkcije zatvaranja za blagajne.
Ovaj odjeljak pruža različite administrativne funkcije za obračun blagajne. Za više informacija o završnim dnevnim zapisima, pogledajte članak: Dnevno zatvaranje blagajne,
| Odredište | Tip | Opis |
|
POST /api/v1/closing/{clientId}/book/ openingStock |
O |
Evidencira početno stanje za završni račun kase. Evidencira samo uplatu, ne obnavlja gotovinski fond. Alternativa: Kao alternativu, kasa može također evidentirati dokument: documentType [11] = Uplata. |
|
PUT
/api/v1/closing/{clientId}/book/ cashDifference |
O |
Bilježi razliku u gotovini u sistemu fiskalizacije. Alternativa: Kao alternativa, fiskalna kasa može također evidentirati dokument sa BusinessTransactionType [91] = CashDifference. |
|
PUT
/api/v1/closing/{clientId}/book/ cashLift |
O |
Evidira prijenos novca iz sistema kase na banku (ili bilo koju drugu destinaciju). |
|
GET /api/v1/closing/{clientId}/ actualStock |
O |
Vraća stvarne zalihe plaćanja određenog klijenta. Ovo se izračunava na osnovu dostavljenih dokumenata (pored računa za prodaju i povrat, depozita i isplata itd.). |
|
POST
/api/v1/closing/{clientId}/ cashpointCheck |
O |
Provjerava stvarno stanje uplata za ovaj blagajni aparat i vraća listu uplata sa razlikom (ili praznu listu ako nema razlike). |
| POST /api/v1/closing/{clientId}/ cashpointClose |
O |
Zatvara tekući dan sa završnim izvještajem. Završetak se vrši na osnovu dokumenata poslanih klijentu od posljednjeg zatvaranja. Sistem blagajne ne prima završni izvještaj kao odgovor! |
|
GET
/api/v1/closing/{clientId}/ endofdayDocument |
O |
Vraća dokument kraja dana za tekući dan. Vraćeni dokument mora biti pohranjen (storeDocument > documentType 99) |
|
GET
/api/v1/closing/{clientId}/ lastClosing |
O |
Vraća datum i vrijeme posljednjeg zatvaranja određenog klijenta (terminala) |
|
GET
/api/v1/closing/{clientId}/ closingNecessary |
O |
Vraća informacije o tome da li se na određenom terminalu treba izvršiti dnevno zatvaranje. (Ovisno o RetailForce.Fiscalisation.Implementation. |
Informacije
Kratki opis: koristi se za upit posebnih informacija
| Odredište | Tip | Opis |
| GET /api/v1/information/version | O | Vraća trenutnu verziju (SW) softvera (fiskalnog middlewarea). |
| GET /api/v1/information/version/{clientId} | O | Vraća verziju modula za zemlju datog klijenta. |
| GET /api/v1/information/countryProperties | O | Vraća fiskalne osobine zemlje za traženu zemlju. |
|
GET
/api/v1/information/client/{clientId}/ countryProperties |
O | Vraća fiskalne osobine zemlje za navedenog klijenta. |
|
GET
/api/v1/information/client/{clientId}/ uniqueCashRegisterId |
O | Vraća jedinstveni ID blagajne (broj prodavnice/broj terminala). |
|
GET
/api/v1/information/client/{clientId}/ status |
O | Vraća status zatraženog fiskalnog klijenta. |
|
GET
/api/v1/information/client/{clientId}/ accessLicenses |
O | Vraća listu pristupnih licenci za traženog klijenta. |
|
GET
/api/v1/information/client/{clientId}/ licenses |
O | Vraća tvrdnju licence za traženog klijenta. |
|
GET
/api/v1/information/client/{clientId}/ getVatIdentification |
R | Vraća odgovarajući identifikacijski broj PDV-a za traženi postotak i datum/vrijeme. |
|
GET
/api/v1/information/client/{clientId}/ documentMandatoryFields/{typeName} |
O | Vraća obavezna polja za tip naveden tipNamenom za zadanu implementaciju zemlje. |
|
POST
/api/v1/information/client/{clientId}/ storeErrorDocumentsToDisk |
R | Ako je postavljeno na true, svaki dokument o grešci bit će pohranjen u direktorij fiskalnog klijenta. |
|
GET
/api/v1/information/client/{clientId}/ storeErrorDocumentsToDisk |
R | Vraća se ako je opcija RetailForce.Fiscalisation.TrustedFiscalModule. StoreErrorDocumentsToDisk omogućena. |
|
GET
/api/v1/information/performance/ {clientId} |
O | Vraća sve ID-ove brojača performansi za navedenog klijenta |
|
DELETE
/api/v1/information/performance/ {clientId} |
O | Resetira sve prosječne podatke za navedenog klijenta. |
|
GET
/api/v1/information/performance {clientId}/{performanceCounterId} |
O | Vraća prosječne podatke za traženi ID brojača performansi. |
|
DELETE
/api/v1/information/performance/ {clientId}/{performanceCounterId} |
O | Resetira prosječne podatke za zadatog klijenta i zadati brojač performansi. |
|
PUT
/api/v1/information/performance/ {clientId}/file |
O | Omogućava ili onemogućava praćenje performansi datoteke. Praćenje performansi datoteke je prema zadanim postavkama onemogućeno. |
|
GET
/api/v1/information/progress/ {clientId} |
O | Vraća sve oznake informacija o napretku za zadatog klijenta. |
|
GET
/api/v1/information/progress/{clientId}/ {label} |
O | Vraća informacije o napretku za zadatog klijenta i oznaku. |
Upravljanje
Kratki opis: Upravljačke funkcije, puštanje u rad i isključivanje iz rada
| Krajnja tačka | Tip | Opis |
| PUT /api/v1/management/clients | O/M |
Kreira novog klijenta u skladištu konfiguracije. Objekat konfiguracije mora pripremiti POS-sistem. Konfiguracija klijenta je potrebna za rad. Koristite ili ovaj krajnji punkt, ili:
|
| POST /api/v1/management/clients | O |
Ažurira konfiguraciju klijenta koju je kreirao sistem blagajne u skladištu konfiguracija. |
| GET /api/v1/management/clients | O |
Vraća sve klijente navedene u skladištu konfiguracije. Može se koristiti i pri upotrebi oblačne konfiguracije. |
|
PUT /api/v1/management/clients/ byCloud |
O/M |
Kreira novog klijenta sa konfiguracijom pripremljenom u oblaku / ili učitava postojećeg klijenta. Konfiguracija klijenta je potrebna za rad. Koristite jednu od sljedećih opcija:
|
|
PUT
/api/v1/management/clients/ byCloud/id |
O |
Kreira klijenta koji učitava konfiguracijske podatke iz oblaka. Alternativa: alternativni krajnji punkt za PUT /api/v1/management/clients i PUT /api/v1/management/clients/byCloud. |
|
PUT /api/v1/management/clients/ byCloud/{clientId} |
R |
Ažurira konfiguraciju klijenta preuzimanjem konfiguracije klijenta iz oblaka. Koristi se kada je konfiguracija pripremljena u oblaku ažurirana i treba je ponovo preuzeti fiskalni klijent (ažuriranje). |
|
POST
/api/v1/management/clients/ withCloud |
O/M |
Kreira novog klijenta u upravljanju fiskalnim modulom i dodaje ovog klijenta u konfiguraciju u oblaku. Klijent se kreira u lokalnom skladištu konfiguracije, a zatim se objekt konfiguracije otpremi u oblačni sistem. Napomena: Distributor mora biti postavljen u podacima klijenta i mora imati dozvolu za kreiranje novih klijenata. |
|
POST /api/v1/management/cloud/ connect |
M* |
Uspostavlja se veza s oblakom za određenog klijenta i pouzdani fiskalni modul se učitava u keš. Potrebno za sisteme koji koriste cloud funkcije. Potrebno nakon svakog ponovnog pokretanja POS sistema. |
|
POST
/api/v1/management/cloud/ updateLicense |
O |
Ažurira trenutni ključ licence u konfiguraciji fiskalnog klijenta (također na disku). Potrebno ako su licence u konfiguraciji u oblaku izmijenjene. |
| HEAD /api/v1/management/cloud/queue | R |
Metoda za pokretanje ili zaustavljanje obrade reda za oblak (za sve klijente). Komanda Stop zaustavlja obradu nakon završetka trenutnog učitavanja. Start pokreće obradu reda odmah. Ako je obrada oblačne reda zaustavljena, morate je ponovo pokrenuti, osim ako se servis ne ponovo pokrene (tada se oblačna obrada ponovo aktivira). |
|
GET /api/v1/management/clients/ {clientId} |
O |
Vraća konfiguraciju klijenta za određeni klijent. |
|
DELETE
/api/v1/management/clients/ {clientId} |
O |
Brisanje određenog klijenta Pažnja: koristiti s oprezom! |
| GET /api/v1/management/clients/id | O |
Vraća jedinstveni ID klijenta za tražene parametre. Različiti parametri se mogu koristiti za zahtjev uniqueClientId. |
|
GET
/api/v1/management/clients/ licenseConsumerId |
O |
Vraća ID korisnika licence za zadanu identifikaciju kompanije. Vraćaju se samo licenseConsumerId-ovi koji su već pohranjeni u skladištu konfiguracije. |
|
GET
/api/v1/management/clients/ validate |
O |
Provjerava unesene informacije o klijentu kako bi se ispunila potrebna konfiguracija specifična za državu. Koristi se za provjeru konfiguracije kreirane od strane sistema blagajne prije korištenja /api/v1/management/clients. Validacija oblačne konfiguracije je osigurana u oblaku. |
|
POST /api/v1/management/clients/ initialize |
M |
Inicijalizira fiskalnu jedinicu (i mogući hardver, i moguću deklaraciju finansijskim vlastima). Inicijalizacija se vrši putem početnog računa (početni račun) koji se može dohvatiti putem GET zahtjeva na /api/v1/transactions/document/ |
|
POST
/api/v1/management/clients/ migrate/{clientId} |
O |
Migrira klijenta sa drugog provajdera fiskalizacije. Koristi se pri prelasku s drugog pružatelja fiskalne posredničke usluge na RetailForce Molimo, obratite pažnju na podržane sisteme. |
|
POST
/api/v1/management/clients/ migrate/{clientId}/file |
O |
Migrira klijenta sa drugog provajdera fiskalizacije i vrši uvoz datoteke. Imajte na umu podržane sisteme! |
|
POST
/api/v1/management/clients/ decommission |
R |
Otkid fiskalnog klijenta (i mogućeg hardvera, i moguće deklaracije finansijskim vlastima). |
|
PUT /api/v1/management/clients/ {clientId}/supportPackage |
R |
Učitava paket podrške (log-datoteke) u oblak za zadatog klijenta. Ovaj krajnji punkt je neophodan za korištenje funkcije "Učitaj paket podrške" u oblačnom sistemu. |
|
GET
/api/v1/management/clients/ recovery/{clientId}/backup |
R Učitava paket podrške (log-datoteke) u oblak za zadatog klijenta. |
Pravi sigurnosnu kopiju klijenta u zadani naziv datoteke (zip-datoteka). Ako se koristi učitavanje u oblak, obrada reda čekanja u oblaku će se zaustaviti i ponovo pokrenuti (i red čekanja će biti ponovo inicijaliziran). Pažnja: Imajte na umu da će se proces oblačne reda čekanja nastaviti nakon izrade sigurnosne kopije ako klijent nije uklonjen. Ako bilo koji fajlovi nisu bili prije izrade sigurnosne kopije, oni su također dio sigurnosne kopije i moguće će biti otpremljeni dvaput u slučaju da se klijent vrati. |
|
POST
/api/v1/management/clients/ recovery/restore |
R |
Obnavlja klijenta (sa svim podacima) iz zadatog backup zip-fajla. |
|
POST /api/v1/management/clients/ recovery/restoreByCloud |
RObnavlja klijenta (sa svim podacima) iz zadane backup zip-datoteke. |
Kreira novog klijenta s konfiguracijom iz oblaka / ili učitava postojećeg klijenta. |
|
POST /api/v1/management/clients/ recovery/restoreByCloud/id |
O |
Kreira novog klijenta s konfiguracijom iz oblaka / ili učitava postojećeg klijenta. |
| POST /api/v1/management/clients/ {clientId}/globalShortId | O |
Generiše novi ili vraća postojeći globalno jedinstveni ID za odgovarajućeg klijenta. Pored toga, izdavanje retailForceReceiptId se aktivira za odgovarajućeg klijenta. |
|
POST
/api/v1/management/clients/ {clientId}/certificate |
O/M |
Pohranjuje vanjski certifikat u spremište certifikata fiskalnog modula. Potrebno za sisteme koji NE koriste RetailForce Cloud funkcije u fiskalnim zemljama gdje se softverski certifikati koriste u kontekstu fiskalizacije (Slovenija, Hrvatska, Španija, …) |
|
GET
/api/v1/management/clients/ {clientId}/licenses/accessLicense |
O |
Vraća informaciju da li traženi klijent ima traženu licencu za pristup. |
|
GET
/api/v1/management/clients/ {clientId}/licenses/license |
O |
Vraća da li traženi klijent ima traženu licencu. |
ManagementController_Austrija
Kratki opis: Upravljačke funkcije za austrijsku fiskalizaciju.
| Krajnja tačka | Tip | Opis |
|
POST
/api/v1/management/austria/ {clientId}/aes |
O |
Kreira AES korisnički ključ za ovog klijenta i vraća ga. AES ključ će također biti pohranjen u konfiguraciju klijenta. Napomena: AES korisnički ključ će biti automatski kreiran od strane fiskalnog klijenta. Krajnja tačka je potrebna samo ako se AES ključ treba ručno kreirati. |
|
GET
/api/v1/management/austria/ {clientId}/aes |
O |
Vraća AES ključ za zadatog klijenta. |
|
GET
/api/v1/management/austria/ {clientId}/dep |
O/M |
Izvozi sve stavke potvrda iz lokalnog dnevnika prikupljanja podataka (DEP §7 RKSV) za pohranu podataka. Potrebno za offline sisteme (sisteme koji NE koriste cloud arhiviranje fiskalnih podataka). |
|
GET
/api/v1/management/austria/ {clientId}/dep131 |
O |
Izvozi sve podatke zahtjevane za DEP131 (DEP §131 BAO) protokol iz lokalno pohranjenih podataka. |
|
GET
/api/v1/management/austria/ {clientId}/dep/startReceipt |
R |
Vraća početni račun za ovog klijenta. Sistem kase mora biti u mogućnosti da na zahtjev dostavi početni račun (start receipt) tokom fiskalne revizije. Ako POS sistem nije sačuvao početni račun, on se može zatražiti putem ovog krajnjeg tačk. |
|
GET
/api/v1/management/austria/ {clientId}/dep/monthReceipts |
R |
Vraća sve mjesečne račune u zatraženom vremenskom okviru. Sistem kase mora biti u mogućnosti da na zahtjev dostavi mjesečne račune tokom fiskalne revizije; ako POS sistem nije sačuvao ove dokumente, mogu se zatražiti putem ovog krajnjeg tačk |
|
GET
/api/v1/management/austria/ {clientId}/fon/certificate |
O |
Vraća sve uređaje za potpisivanje i informaciju jesu li aktivirani na FinanzOnline (FON) ili ne. |
|
POST
/api/v1/management/austria/ {clientId}/fon/certificate |
O |
Registruje konfigurisani uređaj za potpis na FON-u (ako je konfigurisan) ili uređaj za potpis identifikovan pomoću certificateSerial. Napomena: Ako se koriste RetailForce Cloud Services, certifikati se automatski registruju na FinanzOnline portalu (FON) (potrebne su vjerodajnice za korisnika webservisa za blagajnu!); krajnja tačka je potrebna samo ako se registracija treba obaviti ručno. |
|
DELETE
/api/v1/management/austria/ {clientId}/fon/certificate |
O |
Registrujte poništavanje konfigurisanog uređaja za potpis na FON-u (ako je konfigurisan) ili uređaja za potpis identifikovanog pomoću certificateSerial. Pažnja: koristiti s oprezom! |
|
GET
/api/v1/management/austria/ {clientId}/fon/document |
R |
Validira posljednji potpisani dokument u dep na FinanzOnline (FON). |
|
GET
/api/v1/management/austria/ {clientId}/fon/document/{depDocument} |
R |
Provjerava dati dep dokument (QR kod) na FON-u. |
|
GET
/api/v1/management/austria/ {clientId}/fon/cashregister |
O |
Vraća informaciju o tome da li je fiskalna kasa trenutnog klijenta aktivirana na FON-u. Potrebno za offline sisteme. |
|
POST
/api/v1/management/austria/ {clientId}/fon/cashregister |
O |
Registracija sistema blagajne na FON-u za trenutnog klijenta. Potrebno za offline sisteme. |
|
DELETE
/api/v1/management/austria/ {clientId}/fon/cashregister |
O |
Odjava kase na FON-u za trenutnog klijenta. Potrebno za offline sisteme. Pažnja: koristiti s oprezom! |
ManagementController_Bulgaria
Kratki opis: Upravljačke funkcije za bugarsku fiskalizaciju.
| Odredište | Tip | Opis |
|
POST
/api/v1/management/bulgaria/ {clientId}/commands/closing |
M |
Pošalje naredbu zatvaranja (Z) fiskalnom štampaču. |
|
POST
/api/v1/management/bulgaria/ {clientId}/commands/synchronizeTime |
M |
Pošalje naredbu za sinhronizaciju vremena (L) fiskalnom štampaču. |
| GET /api/v1/management/bulgaria/ {clientId}/reports/klen | R |
Ova funkcija se može koristiti za generisanje takozvanog KLEN izvještaja. (od v1.8.3) |
| GET /api/v1/management/bulgaria/ {clientId}/reports/zreport | R |
Ova funkcija se koristi za ispis
(od v1.8.3) |
| GET /api/v1/management/bulgaria/ {clientId}/reports/block | R |
Ova funkcija se koristi za ispis takozvanog BLOCK izvještaja. (od v1.8.3) |
ManagementController_Danska
Kratki opis: Upravljačke funkcije za dansku fiskalizaciju.
| Krajnja tačka | Tip | Opis |
|
GET
/api/v1/management/denmark/ {clientId}/saft |
M |
Izvozi danski SAF-T format u zadani tok. |
ManagementController_France
Kratki opis: Upravljačke funkcije za francusku fiskalizaciju.
| Krajnja tačka | Tip | Opis |
|
GET
/api/v1/management/france/ eventlog/{clientId} |
M |
Vraća sve unose u evidenciji revizije zatražene po datumu. |
|
GET
/api/v1/management/france/ archive/{clientId} |
M |
Vraća lokalno pohranjene arhive za zatvaranje. |
|
POST
/api/v1/management/france/ archive/{clientId}/verify |
M |
Metoda za verifikaciju francuskog arhiva. |
ManagementController_Germany
Kratki opis: Upravljačke funkcije za njemačku fiskalizaciju.
| krajnja tačka | Tip | Opis |
| GET /api/v1/management/germany/tse | R |
Vraća niz priključenih lokalnih TSE uređaja i njihov status. |
|
POST
/api/v1/management/germany/tse/ {tseSerial}/selftest |
RVraća niz priključenih lokalnih TSE uređaja i njihov status.POST /api |
Pokreće sinkroni samoprovjeru za zadanu blagajnu na tse (blagajna je opcionalna). |
|
PUT
/api/v1/management/germany/ {clientId}/tse/connectTest |
RPokreće sinkroni samoprovjer za zadanu blagajnu na TSE-u (blag |
Obavlja testnu vezu sa zadatim TSE. |
|
GET
/api/v1/management/germany/ {clientId}/tse/listClients |
O |
Vraća sve klijente navedene na TSE-u datog klijenta. |
|
GET
/api/v1/management/germany/ {clientId}/tse/status |
R |
Vraća status TSE-a. Ako se ne pronađe fiskalni modul, vraća se status RetailForce.Fiscalisation.Implementation. |
|
PUT
/api/v1/management/germany/ {clientId}/tse/updateTime |
M |
Ažurira vrijeme na TSE na trenutno računarsko vrijeme. |
|
GET
/api/v1/management/germany/ {clientId}/tse/tar |
O |
Izvozi tar datoteke sa primarnog tse. Potrebno za offline sisteme. |
|
GET
/api/v1/management/germany/ {clientId}/taxonomy |
O |
Izvozi taksonomiju (DSFinV-K izvoz) i vraća je kao datoteku za preuzimanje (zip format). Potrebno za offline sisteme. |
|
GET /api/v1/management/germany/ {clientId}/tse/listTransactions |
R |
Vraća sve aktivne (započete) transakcije na tse. Preporučuje se praćenje otvorenih transakcija (sve započete transakcije moraju biti pohranjene ili otkazane). |
| DELETE /api/v1/management/germany/ {clientId}/tse/listTransactions | O |
Otkazuje aktivne (započete) transakcije na TSE-u. |
|
GET
/api/v1/management/germany/ {clientId}/tse/openOfflineSignatures/count |
O |
Vraća broj offline transakcija (= transakcija koje nisu poslane TSE-u zbog offline TSE-a – prekida dostupnosti). |
|
GET
/api/v1/management/germany/ {clientId}/tse/openOfflineSignatures |
O |
Vraća sve otvorene offline potpise pohranjenih za trenutni TSE. |
|
PUT
/api/v1/management/germany/ {clientId}/tse/openOfflineSignatures |
O |
Obradi otvorene offline potpise. |
|
PUT
/api/v1/management/germany/ {clientId}/tse/replace |
R |
Zamjenjuje trenutni TSE za navedenog klijenta novim (na primjer ako je stari TSE oštećen ili je certifikat istekao). |
|
POST
/api/v1/management/germany/ {clientId}/tse/selftest |
R |
Pokreće sinkroni samoprovjer za zadanu blagajnu na TSE (blagajna je opcionalna). |
|
POST
/api/v1/management/germany/ {clientId}/tse/updateFirmware |
RPokreće sinkroni samoprovjer za zadani fiskalni registar na TSE-u (fisk |
Ažurira firmver na swissbit hardverskom TSE uređaju. |
ManagementController_Španija
Kratki opis: Upravljačke funkcije za špansku fiskalizaciju.
| Krajnja tačka | Tip | Opis |
|
GET
/api/v1/management/spain/ {clientId}/ticketBai |
R |
Vraća pohranjene ticketBai datoteke (poslane datoteke, odgovorne datoteke, datoteke s greškama) kao zip datoteku. |
|
GET
/api/v1/management/spain/ {clientId}/ticketBai/{documentNumber} |
RVraća pohranjene ticketBai datoteke (poslane datoteke, odgovori, dat |
Vraća pohranjene ticketBai datoteke za traženi broj dokumenta (poslane datoteke, odgovori, datoteke s greškama) kao zip datoteku. |
Potvrde
Kratki opis: služi za slanje digitalnih potvrda u RetailForce oblak putem posredničkog sloja.
Endpointi u ovom odjeljku koriste se za slanje digitalnih dokumenata potvrda u oblačni sistem (potrebne su licence za digitalne potvrde kako bi se koristila ova usluga!).
| krajnja tačka | Tip | Opis |
| POST /api/v1/receipts/{clientId} | O/M |
Učitava datoteku digitalne potvrde o uplati u oblačni sistem. Alternativa: Koristite ili ovaj ili alternativni krajnji punkt unutar ovog odjeljka za slanje podataka o digitalnim računima. |
|
POST
/api/v1/receipts/ {clientId}/{documentGuid} |
O/M |
Učitava digitalnu datoteku u oblačni sistem. Koristeći metapodatke fiskalizacije. Alternativa: Koristite ili ovaj ili alternativni krajnji punkt unutar ovog odjeljka za slanje podataka o digitalnim računima. |
Transakcije
Kratki opis: služi za slanje dokumenata middlewareu u kontekstu fiskalizacije.
| krajnja tačka | Tip | Opis |
| PUT /api/v1/transactions/createDocument | M |
Kreira dokument u fiskalnoj jedinici. Ova metoda sama ne kreira dokument, već samo pokreće proces, na primjer na TSE. |
| POST /api/v1/transactions/storeDocument | M |
Pohranjuje dokument u jedinicu fiskalizacije. |
| POST /api/v1/transactions/cancelDocument | M |
Otkazuje dokument na fiskalizacijskoj jedinici. |
|
PUT
/api/v1/transactions/reprintDocument/ {clientId}/{documentGuid} |
M* |
Metoda za pohranu broja ponovnih ispisivanja dokumenta koristeći pohranjen dokument (referenca: documentGuid). Alternativa: alternativno koristite PUT /api/v1/transactions/reprintDocument |
|
PUT
/api/v1/transactions/ reprintDocument |
M* |
Metoda za pohranu broja ponovnih otisaka dokumenta slanjem dokumenta ponovo. Korisnik prenesenog dokumenta mora biti korisnik koji vrši ponovni otisak (ne korisnik originalnog dokumenta). Alternativa: alternativno koristite PUT /api/v1/transactions/reprintDocument/ |
|
POST
/api/v1/transactions/ revertDocument |
R |
Povrat dokumenta (pretvara sve vrijednosti u negativne). |
|
POST
/api/v1/transactions/ validateDocument |
O |
Validira dokument i vraća sve greške u validaciji (i praznu listu ako nema grešaka). |
|
POST
/api/v1/transactions/ validateDocumentString |
O |
Pošaljite JSON dokument servisu za validaciju dokumenta. |
|
GET /api/v1/transactions/document/ {clientId}/start |
R |
Vraća početni dokument za zadatog klijenta. Početni dokument se koristi za inicijalizaciju klijenta kao i fiskalne jedinice (/api/v1/management/clients/initialize). |
| POST /api/v1/transactions/display/{clientId} | M* |
Prikaži tekst na prikazu fiskalnog klijenta. Podržano samo u zemljama koje koriste fiskalni prikaz za kupca. U ostalim zemljama ovaj poziv ne radi ništa (ali se može pozvati). |
|
PUT
/api/v1/transactions/printer/ {clientId}/openDrawer |
M* |
Otvara fioku ako je fioka priključena na fiskalnu printericu. |
| GET /api/v1/transactions/getQrCodeBase64 | O |
Vraća podatke QR koda kao niz kodiran u Base64 formatu. |
| POST /api/v1/transactions/auditlog | M* |
Dodaje zapisnik revizije fiskalnom klijentu. |
| GET /api/v1/transactions/auditlog/{clientId} | M* |
Vraća sve audit zapise filtrirane po fromDate/tillDate. |
|
GET
/api/v1/transactions/document/ {clientId}/{documentGuid} |
R |
Vraća traženi dokument ako je pohranjen u internom skladištu. |
|
HEAD
/api/v1/transactions/document/ {clientId}/{documentGuid} |
O |
Vraća informaciju da li traženi dokument postoji u internom skladištu dokumenata. |
|
GET
/api/v1/transactions/document/ {clientId}/id/{documentId} |
O |
Vraća traženi dokument ako je pohranjen u internom skladištu. |
|
GET
/api/v1/transactions/document/ {clientId}/id/{documentId} |
O |
Vraća informaciju da li traženi dokument postoji u internom skladištu dokumenata. |
|
GET
/api/v1/transactions/document/ {clientId}/last |
O |
Vraća posljednji pohranjen dokument iz skladišta dokumenata. |
|
GET
/api/v1/transactions/document/ {clientId}/fid/{fiscalDocumentNr} |
O |
Vraća traženi dokument ako je pohranjen u internom skladištu. |
|
GET
/api/v1/transactions/document/ {clientId}/{documentGuid}/response |
R |
Vraća odgovor za traženi dokument ako je pohranjen u internom skladištu. |
|
GET
/api/v1/transactions/document/ {clientId}/id/{documentId}/response |
O |
Vraća traženi odgovor dokumenta ako je pohranjen u internom skladištu. |
|
GET
/api/v1/transactions/document/ {clientId}/fid/{fiscalDocumentNr}/response |
O |
Vraća traženi dokument ako je pohranjen u internom skladištu. |
Ovaj članak je automatski preveden.
Comments
0 comments
Please sign in to leave a comment.