Programsko sučelje - Fiskalizacijski API
Povežite svoj webshop, aplikaciju ili uređaj. Kreiranje račun i fiskalizaciju prepustite Webračunu
Čemu služi API?
Ako posjedujete webshop, samoposlužni uređaj ili neku treću aplikaciju u kojoj trebate implementirati fiskalizaciju možete ju programski povezati sa Webračunom putem fiskalizacijskog API-a.
Webračun API je samo nadogradnja na postojeću Webračun aplikaciju. Kako biste mogli koristiti Webračun API potrebno se prvo registrirati na Webračun. Na taj način, treća aplikacija koja se spaja na Webračun ponaša se kao standardni webračun korsinik što znači da se sva podešavanja i administracija odrađuju kroz korisničko sučelje, a izdavanje računa se može odraditi kroz programsko sučelje (API)
Povezivanje drugih aplikacija i uređaja sa Webračunom
Da bi svoju aplikaciju/uređaj povezali sa Webračunom potrebno se registrirati na Webračun. Vaša aplikacija ili uređaj će se na Webračun povezati putem korisničkog imena i lozinke kreiranih u postupku registracije. Nakon što se vaša aplikacija predstavi Webračunu sa korisničkim imenom i lozinkom dobit će token u odgovoru. Sva daljnja komunikacija će se odvijati pomoću dobivenog tokena.
Operacije koje je moguće izvršiti pomoću API-a su kreiranje računa, storniranje računa, unos nove stavke i ažuriranje stavke
Prijava/Login
Kako biste mogli kreirati račune potrebno se prvo autentificirati.Request:
POST https://www.app.webracun.com/rest/api/v1/login
Headers
Content-Type application/json
Body
{"username":"test","password":"public_api_test"}
Response:
HTTP 200 OK
Primjer poziva:
Kreiranje računa
Nakon što ste se uspješno prijavili možete kreirati račune. Kako biste kreirali račun potrebno je poslati način plaćanja te za svaku stavku računa šifru i količinu. Šifru stavke možete definirati prilikom unosa stvake kroz korisničko sučeljeRequest:
POST https://www.app.webracun.com/rest/api/v1/invoice
Headers
Content-Type application/json
Body
Response:
HTTP 200 OK
Primjer poziva:
Storniranje računa
Nakon što ste se uspješno prijavili i kreirali račun možete stornirati kreirani račun. Kao biste stornirali račun potreban vam je ID računa kojeg ste dobili u odgovoru kreiranja računa.Request:
POST https://www.app.webracun.com/rest/api/v1/cancellation
Headers
Content-Type application/json
Body
Response:
HTTP 200 OK
Primjer poziva: