Ovaj članak pruža pregled API funkcija fiskalne usluge RetailForce (status: izdanje 1.6.3). Potrebni parametri svake krajnje točke mogu se pregledati putem Swaggera (npr. http://localhost:7678/swagger/index.html) nakon instalacije fiskalnog međuprograma.
API je podijeljen na različita područja koja se koriste za različite svrhe i proizvode.
Informacije u stupcu "Type":
- O ... opcionalno
- M ... obavezno / potrebno
- M* ... obavezno / potrebno u određenim zemljama ili pod određenim uvjetima
- R ... preporučeno
Naslovi se odnose na odgovarajuće odjeljak u Swaggeru. Za neke krajnje točke pronaći ćete poveznice na dodatne informacije.
Arhiva
Kratki opis: Funkcija arhiviranja već fiskaliziranih podataka.
Krajnje točke u ovom odjeljku koriste se za prijenos podataka u siguran arhiv Secure RetailForce.
| Krajnja točka | Tip | Opis |
| POST /api/v1/archive/de/{clientId} | O | Ova se metoda 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
Endpointevi 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 točka | Tip | Opis |
| POST /api/v1/backup/{clientId} | O | Ova metoda sigurnosno kopira zadanu mapu u oblačni arhiv. |
| 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 zatražene sigurnosne kopije iz oblačnog arhiva. |
Završetak
Kratki opis: Funkcije zatvaranja blagajne.
Ovaj odjeljak pruža razne administrativne funkcije za obračun blagajne. Za više informacija o završnim dnevnim ispisima pogledajte članak: Dnevno zatvaranje blagajne,
| Odredište | Tip | Opis |
|
POST /api/v1/closing/{clientId}/book/ openingStock |
O |
Bilježi početno stanje za završni račun blagajne. Bilježi samo uplatu, ne obnavlja blagajničku zalihu. Alternativa: Kao alternativa, blagajna može također evidentirati dokument: documentType [11] = PayIn. |
|
PUT
/api/v1/closing/{clientId}/book/ cashDifference |
O |
Bilježi razliku u gotovini u sustav fiskalizacije. Alternativa: Kao alternativa, blagajna može također evidentirati dokument s BusinessTransactionType [91] = CashDifference. |
|
PUT
/api/v1/closing/{clientId}/book/ cashLift |
O |
Bilježi prijenos novca iz sustava blagajne na banku (ili bilo koju drugu destinaciju). |
|
GET /api/v1/closing/{clientId}/ actualStock |
O |
Vraća stvarne zalihe plaćanja određenog klijenta. To se izračunava na temelju predanih dokumenata (uz račune za prodaju i povrat, uplate i isplate itd.). |
|
POST
/api/v1/closing/{clientId}/ cashpointCheck |
O |
Provjerava stvarno stanje plaćanja za ovaj blagajni aparat i vraća popis plaćanja s razlikom (ili prazan popis ako nema razlike). |
| POST /api/v1/closing/{clientId}/ cashpointClose |
O |
Zaključava trenutni dan završnim obračunom. Završetak se obavlja na temelju dokumenata poslatih klijentu od posljednjeg zatvaranja. Sustav 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 treba li se na određenom terminalu izvršiti dnevno zatvaranje. (Ovisno o RetailForce.Fiscalisation.Implementation. |
Informacije
Kratki opis: koristi se za upit posebnih informacija
| Krajnja točka | Tip | Opis |
| GET /api/v1/information/version | O | Vraća stvarnu verziju (SW) softvera (fiskalnog middlewarea). |
| GET /api/v1/information/version/{clientId} | O | Vraća verziju modula za zemlju danog klijenta. |
| GET /api/v1/information/countryProperties | O | Vraća fiskalne osobine zemlje za zatraž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 trgovine/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 popis pristupnih licenci za traženog klijenta. |
|
GET
/api/v1/information/client/{clientId}/ licenses |
O | Vraća zahtjev za licencu za traženog klijenta. |
|
GET
/api/v1/information/client/{clientId}/ getVatIdentification |
R | Vraća odgovarajući PDV identifikacijski broj 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}/ pohraniDokumenteGrešakaNaDisk |
R | Ako je postavljeno na true, svaki dokument o pogrešci pohranit će se 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 zatraženi ID brojača performansi. |
|
DELETE
/api/v1/information/performance/ {clientId}/{performanceCounterId} |
O | Resetira prosječne podatke za navedenog klijenta i navedeni brojač performansi. |
|
PUT
/api/v1/information/performance/ {clientId}/file |
O | Omogućuje ili onemogućuje 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 navedenog klijenta. |
|
GET
/api/v1/information/progress/{clientId}/ {label} |
O | Vraća informacije o napretku za zadanog klijenta i oznaku. |
Upravljanje
Kratki opis: Upravljačke funkcije, puštanje u rad i isključivanje iz rada
| Krajnja točka | Tip | Opis |
| PUT /api/v1/management/clients | O/M |
Stvara novog klijenta u spremištu konfiguracije. Objekat konfiguracije mora pripremiti POS-sustav. Konfiguracija klijenta je potrebna za rad. Koristite ili ovu krajnju točku, ili:
|
| POST /api/v1/management/clients | O |
Ažurira konfiguraciju klijenta koju je kreirao sustav blagajne u spremiš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 |
Stvara novog klijenta s pripremljenom konfiguracijom 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 |
Stvara klijenta koji učitava konfiguracijske podatke iz oblaka. Alternativa: alternativna krajnja točka 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 dohvaćanjem konfiguracije klijenta iz oblaka. Koristi se kada je konfiguracija pripremljena u oblaku ažurirana i treba je ponovno preuzeti fiskalni klijent (ažuriranje). |
|
POST
/api/v1/management/clients/ withCloud |
O/M |
Stvara novog klijenta u upravljanju fiskalnim modulom i dodaje tog klijenta u konfiguraciju u oblaku. Klijent se stvara u lokalnom spremištu konfiguracije, a objekt konfiguracije zatim se učitava u oblačni sustav. Napomena: Distributer mora biti postavljen u podacima klijenta i distributeru mora biti dopušteno stvaranje 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 predmemoriju. Potrebno za sustave koji koriste oblačne funkcije. Potrebno nakon svakog ponovnog pokretanja POS sustava. |
|
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 promijenjene. |
| HEAD /api/v1/management/cloud/queue | R |
Metoda za pokretanje ili zaustavljanje obrade reda za oblak (za sve klijente). Naredba Stop zaustavlja obradu nakon završetka trenutnog učitavanja. Start odmah pokreće obradu reda čekanja. Ako je obrada oblačne reda zaustavljena, morate je ponovno pokrenuti, osim ako se ne ponovno pokrene usluga (tada se oblačna obrada ponovno 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 zatražene parametre. Za zahtjev za uniqueClientId mogu se koristiti različiti parametri. |
|
GET
/api/v1/management/clients/ licenseConsumerId |
O |
Vraća ID korisnika licence za zadanu identifikaciju tvrtke. Vraćaju se samo licenseConsumerId-ovi koji su već pohranjeni u konfiguracijskom skladištu. |
|
GET
/api/v1/management/clients/ validate |
O |
Provjerava navedene podatke o klijentu kako bi se ispunila potrebna konfiguracija specifična za pojedinu zemlju. Koristi se za provjeru konfiguracije koju je kreirao sustav blagajne prije korištenja /api/v1/management/clients. Provjera konfiguracije u oblaku osigurana je u sustavu u oblaku. |
|
POST /api/v1/management/clients/ initialize |
M |
Inicijalizira fiskalnu jedinicu (i mogući hardver te moguću deklaraciju financijskim tijelima). Inicijalizacija se provodi putem početnog računa (početni račun) koji se može dohvatiti pozivom GET /api/v1/transactions/document/ |
|
POST
/api/v1/management/clients/ migrate/{clientId} |
O |
Migrira klijenta s drugog pružatelja fiskalizacije. Koristi se pri prebacivanju s drugog pružatelja fiskalne posredničke usluge na RetailForce Imajte na umu podržane sustave. |
|
POST
/api/v1/management/clients/ migrate/{clientId}/file |
O |
Migrira klijenta s drugog pružatelja fiskalizacije i vrši uvoz datoteke. Imajte na umu podržane sustave! |
|
POST
/api/v1/management/clients/ decommission |
R |
Isključenje fiskalnog klijenta (i mogućeg hardvera te moguće prijave financijskim tijelima). |
|
PUT /api/v1/management/clients/ {clientId}/supportPackage |
R |
Učitava paket podrške (log-datoteke) u oblak za navedenog klijenta. Ova krajnja točka je potrebna za korištenje funkcije "Učitavanje paketa podrške" u oblaku. |
|
GET
/api/v1/management/clients/ recovery/{clientId}/backup |
R Učitava paket podrške (log-datoteke) u oblak za navedenog klijenta. |
Pravi sigurnosnu kopiju klijenta u zadano ime datoteke (zip-datoteka). Ako je u tijeku učitavanje u oblak, obrada reda čekanja u oblaku bit će zaustavljena i ponovno pokrenuta (i red čekanja će biti ponovno inicijaliziran). Pažnja: Imajte na umu da će se, ako klijent nije uklonjen, proces oblaka nastaviti nakon izrade sigurnosne kopije. Ako su neke datoteke prije izrade sigurnosne kopije bile nedostupne, one su također dio sigurnosne kopije i moguće će biti prenesene dvaput u slučaju vraćanja klijenta. |
|
POST
/api/v1/management/clients/ recovery/restore |
R |
Obnavlja klijenta (sa svim podacima) iz zadane sigurnosne ZIP-datoteke. |
|
POST /api/v1/management/clients/ recovery/restoreByCloud |
RObnavlja klijenta (sa svim podacima) iz zadane zip-datoteke sigurn |
Stvara novog klijenta s konfiguracijom iz oblaka / ili učitava postojećeg klijenta. |
|
POST /api/v1/management/clients/ recovery/restoreByCloud/id |
O |
Stvara novog klijenta s konfiguracijom iz oblaka / ili učitava postojećeg klijenta. |
| POST /api/v1/management/clients/ {clientId}/globalShortId | O |
Generira novi ili vraća postojeći globalno jedinstveni ID za odgovarajućeg klijenta. Osim toga, izdavanje retailForceReceiptId-a 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 sustave koji NE koriste RetailForce Cloud funkcije u fiskalnim zemljama gdje se softverski certifikati koriste u kontekstu fiskalizacije (Slovenija, Hrvatska, Španjolska, …) |
|
GET
/api/v1/management/clients/ {clientId}/licenses/accessLicense |
O |
Vraća informaciju ima li zatraženi klijent traženu licencu za pristup. |
|
GET
/api/v1/management/clients/ {clientId}/licenses/license |
O |
Vraća informaciju o tome ima li traženi klijent traženu licencu. |
ManagementController_Austria
Kratki opis: Upravljačke funkcije za austrijsku fiskalizaciju.
| Krajnja točka | Tip | Opis |
|
POST
/api/v1/management/austria/ {clientId}/aes |
O |
Stvara 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č stvara se automatski za fiskalnog klijenta. Krajnja točka je potrebna samo ako se AES ključ treba stvoriti ručno. |
|
GET
/api/v1/management/austria/ {clientId}/aes |
O |
Vraća AES ključ za navedenog klijenta. |
|
GET
/api/v1/management/austria/ {clientId}/dep |
O/M |
Izvozi sve stavke računa iz lokalnog dnevnika prikupljanja podataka (DEP §7 RKSV) za pohranu podataka. Potrebno za offline sustave (sustave koji NE koriste pohranu fiskalnih podataka u oblaku). |
|
GET
/api/v1/management/austria/ {clientId}/dep131 |
O |
Izvozi sve podatke potrebne za protokol DEP131 (DEP §131 BAO) iz lokalno pohranjenih podataka. |
|
GET
/api/v1/management/austria/ {clientId}/dep/startReceipt |
R |
Vraća početni račun za ovog klijenta. Sustav blagajne mora moći isporučiti početni račun (start receipt) na zahtjev tijekom fiskalne revizije. Ako POS sustav nije pohranio početni račun, može se zatražiti putem ovog krajnjeg toka. |
|
GET
/api/v1/management/austria/ {clientId}/dep/monthReceipts |
RVraća početni račun za ovog klijenta.Sustav blagajne mora moći |
Vraća sve mjesečne račune u zatraženom vremenskom razdoblju. Sustav blagajne mora moći na zahtjev isporučiti mjesečne račune tijekom fiskalne revizije; ako POS sustav nije pohranio te dokumente, mogu se zatražiti putem ovog krajnjeg toka. |
|
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 |
OVraća sve uređaje za potpis i informaciju jesu li aktivirani na FinanzOnline (F |
Registrira konfigurirani uređaj za potpis na FON-u (ako je konfiguriran) ili uređaj za potpis identificiran certifikacijskim serijskim brojem. Napomena: Ako se koriste RetailForce Cloud Services, certifikati se automatski registriraju na portalu FinanzOnline (FON) (potrebne su vjerodajnice za korisnika web-servisa blagajne!); krajnja točka je potrebna samo ako se registracija treba obaviti ručno. |
|
DELETE
/api/v1/management/austria/ {clientId}/fon/certificate |
O |
Odjava konfiguriranog uređaja za potpis na FON-u (ako je konfiguriran) ili uređaja za potpis identificiranog serijskim brojem certifikata. Pažnja: koristiti s oprezom! |
|
GET
/api/v1/management/austria/ {clientId}/fon/document |
R |
Provjerava posljednji potpisani dokument u dep-u na FinanzOnlineu (FON). |
|
GET
/api/v1/management/austria/ {clientId}/fon/document/{depDocument} |
R |
Provjerava zadani dep dokument (qr kod) na FON-u. |
|
GET
/api/v1/management/austria/ {clientId}/fon/cashregister |
O |
Vraća informaciju je li blagajna stvarnog klijenta aktivirana na FON-u. Potrebno za offline sustave. |
|
POST
/api/v1/management/austria/ {clientId}/fon/cashregister |
O |
Registracija sustava blagajne na FON-u za trenutnog klijenta. Potrebno za offline sustave. |
|
DELETE
/api/v1/management/austria/ {clientId}/fon/cashregister |
ORegistracija blagajne u sustavu FON za trenutnog klijenta.Potrebno za offline |
Odjava blagajne na FON-u za trenutnog klijenta. Potrebno za offline sustave. 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 pisaču. |
|
POST
/api/v1/management/bulgaria/ {clientId}/commands/synchronizeTime |
M |
Pošalje naredbu za sinkronizaciju vremena (L) fiskalnom pisaču. |
| GET /api/v1/management/bulgaria/ {clientId}/reports/klen | R |
Ova se funkcija može koristiti za generiranje takozvanog KLEN izvještaja. (od v1.8.3) |
| GET /api/v1/management/bulgaria/ {clientId}/reports/zreport | R |
Ova se funkcija koristi za ispis
(od v1.8.3) |
| GET /api/v1/management/bulgaria/ {clientId}/reports/block | R |
Ova se funkcija koristi za ispis takozvanog BLOCK izvještaja. (od v1.8.3) |
ManagementController_Denmark
Kratki opis: Upravljačke funkcije za dansku fiskalizaciju.
| Krajnja toč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.
| Odredište | Tip | Opis |
|
GET
/api/v1/management/france/ eventlog/{clientId} |
M |
Vraća sve unose u zapisima 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 provjeru francuskog arhiva. |
ManagementController_Germany
Kratki opis: Upravljačke funkcije za njemačku fiskalizaciju.
| Krajnja toč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 samoprovjer za zadani blagajni na tse (blagajna je opcionalna). |
|
PUT
/api/v1/management/germany/ {clientId}/tse/connectTest |
R |
Provodi testnu vezu s navedenim TSE-om. |
|
GET
/api/v1/management/germany/ {clientId}/tse/listClients |
O |
Vraća sve klijente navedene na TSE-u danog klijenta. |
|
GET
/api/v1/management/germany/ {clientId}/tse/status |
R |
Vraća status TSE-a. Ako se ne pronađe nijedan fiskalni modul, vraća se status RetailForce.Fiscalisation.Implementation. |
|
PUT
/api/v1/management/germany/ {clientId}/tse/updateTime |
M |
Ažurira vrijeme na TSE prema trenutnom vremenu računala. |
|
GET
/api/v1/management/germany/ {clientId}/tse/tar |
O |
Izvozi tar datoteke s primarnog tse-a. Potrebno za offline sustave. |
|
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 sustave. |
|
GET /api/v1/management/germany/ {clientId}/tse/listTransactions |
R |
Vraća sve aktivne (pokrenute) transakcije na tse. Preporučuje se za praćenje otvorenih transakcija (sve započete transakcije potrebno je pohraniti ili otkazati). |
| 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 – prekid veze, nedostupnost). |
|
GET
/api/v1/management/germany/ {clientId}/tse/openOfflineSignatures |
O |
Vraća sve otvorene offline potpise pohranjene za trenutni TSE. |
|
PUT
/api/v1/management/germany/ {clientId}/tse/openOfflineSignatures |
OVraća sve otvorene offline potpise pohranjenih za trenutni TSE.PUT /api |
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 navedeni blagajni na TSE-u (blagajna je opcionalna). |
|
POST
/api/v1/management/germany/ {clientId}/tse/updateFirmware |
RPokreće sinkroni samoprovjer za zadani TSE (blagajna je opcionalna). |
Ažurira firmver na hardverskom TSE uređaju tvrtke swissbit. |
ManagementController_Španjolska
Kratki opis: Upravljačke funkcije za španjolsku fiskalizaciju.
| Krajnja toč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, odgovorne datot |
Vraća pohranjene ticketBai datoteke za traženi broj dokumenta (poslane datoteke, odgovorne datoteke, datoteke s greškama) kao zip datoteku. |
Potvrde
Kratki opis: služi za slanje digitalnih računa u RetailForce oblak putem posredničkog sloja.
Krajnje točke u ovom odjeljku koriste se za slanje digitalnih dokumenata potvrda u oblačni sustav (za korištenje ove usluge potrebne su licence za digitalne potvrde!).
| Krajnja točka | Tip | Opis |
| POST /api/v1/računi/{clientId} | O/M |
Učitava datoteku digitalne potvrde o kupnji u oblačni sustav. Alternativa: Koristite ili ovu ili alternativnu krajnju točku 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 sustav. Koristeći metapodatke fiskalizacije. Alternativa: Koristite ili ovu ili alternativnu krajnju točku unutar ovog odjeljka za slanje podataka o digitalnim računima. |
Transakcije
Kratki opis: služi za slanje dokumenata posredničkom sloju u kontekstu fiskalizacije.
| Krajnja točka | Tip | Opis |
| PUT /api/v1/transactions/createDocument | M |
Stvara dokument u fiskalizacijskoj jedinici. Ova metoda sama po sebi ne stvara dokument, već samo pokreće proces, na primjer na TSE-u. |
| POST /api/v1/transactions/storeDocument | M |
Pohranjuje dokument u fiskalizacijsku jedinicu. |
| POST /api/v1/transactions/cancelDocument | M |
Otkazuje dokument na fiskalizacijskoj jedinici. |
|
PUT
/api/v1/transactions/reprintDocument/ {clientId}/{documentGuid} |
M* |
Metoda za pohranu broja ponovnih ispisa dokumenta koristeći pohranjen dokument (referenca: documentGuid). Alternativa: alternativno upotrijebite PUT /api/v1/transactions/reprintDocument |
|
PUT
/api/v1/transactions/ reprintDocument |
M* |
Metoda za pohranu broja ponovnih ispisa dokumenta slanjem dokumenta ponovno. Korisnik prenesenog dokumenta mora biti korisnik koji vrši ponovni ispis (a ne korisnik izvornog dokumenta). Alternativa: alternativno upotrijebite PUT /api/v1/transactions/reprintDocument/ |
|
POST
/api/v1/transactions/ revertDocument |
R |
Povratak 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 navedenog klijenta. Početni dokument služi 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 zaslon 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 ladicu ako je ladica priključena na fiskalnu tiskalicu. |
| GET /api/v1/transactions/getQrCodeBase64 | O |
Vraća podatke QR koda kao niz kodiran u Base64. |
| POST /api/v1/transactions/auditlog | M* |
Dodaje zapisnik revizije fiskalnom klijentu. |
| GET /api/v1/transactions/auditlog/{clientId} | M* |
Vraća sve zapisnike revizije filtrirane po fromDate/tillDate. |
|
GET
/api/v1/transactions/document/ {clientId}/{documentGuid} |
R |
Vraća zatraženi dokument ako je pohranjen u internom skladištu. |
|
HEAD
/api/v1/transactions/document/ {clientId}/{documentGuid} |
O |
Vraća informaciju postoji li traženi dokument 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 postoji li traženi dokument u internom skladištu dokumenata. |
|
GET
/api/v1/transactions/document/ {clientId}/last |
O |
Vraća posljednji pohranjen dokument iz spremišta dokumenata. |
|
GET
/api/v1/transactions/document/ {clientId}/fid/{fiscalDocumentNr} |
O |
Vraća traženi dokument ako je pohranjen u internom spremiš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 je članak automatski preveden.
Komentari
0 komentara
Molimo Prijavite se kako bi ostavili komentar.