Programsko sučelje - Fiskalizacijski API

Č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
{ "token": "[B@15d18b6f", "userId": 2 }

Primjer poziva:
curl --location --request POST "{{base_url}}/rest/api/v1/login" \ --header "Content-Type: application/json" \ --data "{\"username\":\"test\",\"password\":\"public_api_test\"}"


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čelje

Request:
POST https://www.app.webracun.com/rest/api/v1/invoice
Headers
Content-Type application/json
Body
{ "paymentType":"Cash", "items":[ { "itemId":"97", "amount":"1" }, { "itemId":"1", "amount":"1" }] }
Moguće vrijednosti za paymentType: "Cash", "Card", "Account", "Other"

Response:
HTTP 200 OK
{ "invoiceId": "971Ql0EwJV", "invoiceLink": "http://localhost:8080/obican/invoiceViewer.html?invoiceId=971Ql0EwJV", "jir": "ea71c96703128b8c551cee339e63f565", "message": "Invoice successfully created", "zki": "e7392fc1-ddd2-4f90-909d-18d2c10b1011" }


Primjer poziva:
curl --location --request POST "{{base_url}}/rest/api/v1/invoice" \ --header "Authority: [B@6316229c" \ --header "Content-Type: application/json" \ --data "{ \"paymentType\":\"Cash\", \"items\":[ { \"itemId\":\"1\", \"amount\":\"1\" }] }"


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
{ "invoiceId" : "3qJRk0691o" }


Response:
HTTP 200 OK
{ "invoiceId": "aW1XN0EqZO", "invoiceLink": "http://localhost:8080/obican/invoiceViewer.html?invoiceId=aW1XN0EqZO&type=storno", "jir": "786c330d-79ba-4d7c-bf33-18d2c10b2ac0", "message": "Storno invoice successfully created", "zki": "79abdc1511b0daf25aaac32792eb635f" }


Primjer poziva:
curl --location --request POST "{{base_url}}/rest/api/v1/invoice/cancellation" \ --header "Authority: [B@920ebe9" \ --header "Content-Type: application/json" \ --data "{ \"invoiceId\" : \"Ad15qPa01X\" }"



Povratak