API dokumentacija
Za developere.
Prikaz računa
Ova metoda ti omogućuje prikaz pojedinačnog ili svih računa.
Pozivanje metode se vrši putem ove adrese:
GET https://api.solo.com.hr/racun
Parametri
Parametri predstavljaju naredbe koje šalješ u GET pozivu.
token
Tvoj tajni identifikator. Možeš pronaći svoj API token u Postavkama nakon prijave u servis.
Pravilo: obavezno
id
ID računa. Ako nije upisan ID, API će prikazati sve račune.
Pravilo: nije obavezno
Povratne informacije
Ovdje su navedeni mogući odgovori servisa nakon što pošalješ API zahtjev.
Odgovor na uspješan zahtjev s poslanim ID računa će biti ovakav:
{
"status": 0,
"racun": {
"id": "8791cae3c9b02bb8d88bf626247b4e67dfbe20e35fc0342b448f39c9264c591d",
"broj_racuna": "1-1-1",
"tip_usluge": "1",
"prikazi_porez": "1",
"tip_racuna": "R1",
"kupac_naziv": "COAX j.d.o.o.",
"kupac_adresa": "Gjure Szaba odvojak 8, 10000 Zagreb",
"kupac_oib": "21248839327",
"usluge": [
{
"broj": "1",
"opis_usluge": "Kruške",
"jed_mjera": "kom",
"kolicina": "1",
"cijena": "9,99",
"popust": "0",
"porez_stopa": "25",
"suma": "9,99"
},
{
"broj": "2",
"opis_usluge": "Jabuke",
"jed_mjera": "kom",
"kolicina": "2",
"cijena": "5,00",
"popust": "0",
"porez_stopa": "25",
"suma": "10,00"
}
],
"neto_suma": "19,99",
"porezi": [
{
"stopa": "25",
"osnovica": "19,99",
"porez": "5,00"
}
],
"bruto_suma": "24,99",
"nacin_placanja": "1",
"operater": "Ime Prezime",
"racun_izdao": "Ime Prezime",
"likvidator": "Ime Prezime",
"datum_racuna": "1.8.2016. 13:00:00",
"rok_placanja": "",
"datum_isporuke": "1.8.2016",
"datum_uplate: "1.8.2016",
"napomene": "Hvala",
"ponavljanje": "0",
"iban": "HR3823400091160392212",
"jezik_racuna": "1",
"valuta_racuna": "EUR",
"tecaj": "1",
"status": "1",
"boja": "#ffcf03",
"pdf": "https://solo.com.hr/download/8791cae3c9b02bb8d88bf626247b4e67dfbe20e35fc0342b448f39c9264c591d"
},
"message": "Prikazan je račun 1-1-1."
}
Odgovor na uspješan zahtjev bez poslanog ID će biti ovakav:
{
"status": 0,
"racuni": [
{
"id": "8791cae3c9b02bb8d88bf626247b4e67dfbe20e35fc0342b448f39c9264c591d",
"broj_racuna": "1-1-1",
"datum_racuna": "1.8.2016. 13:00:00",
"bruto_suma": "24,99",
"status": "1",
"boja": "#ffcf03"
}
],
"message": "Prikazano _1_ računa."
}
Kada dođe do greške u zahtjevu, sustav vraća obavijest u ovakvom obliku:
{
"status": 101,
"message": "Neispravan token."
}
Popis mogućih grešaka kod neispravnog zahtjeva:
| 101 | Neispravan token. |
| 122 | Račun ne postoji. |
| 123 | Nije kreiran niti jedan račun. |