API dokumentacija
Za developere.
Prikaz ponude
Ova metoda ti omogućuje prikaz pojedinačne ili zadnjih 30 ponuda.
Pozivanje metode se vrši putem ove adrese:
GET https://api.solo.com.hr/ponuda
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 ponude. Ako nije upisan ID, API će prikazati zadnjih 30 ponuda.
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 ponude će biti ovakav:
{
"status": 0,
"ponuda": {
"id": "8791cae3c9b02bb8d88bf626247b4e67dfbe20e35fc0342b448f39c9264c591d",
"tip_usluge": "1",
"broj_ponude": "0001-2014",
"prikazi_porez": "1",
"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",
"ponudu_izdao": "Ime Prezime",
"datum_ponude": "1.8.2016. 13:00:00",
"rok_placanja": "",
"napomene": "Hvala",
"ponavljanje": "0",
"iban": "HR3823400091160392212",
"jezik_ponude": "1",
"valuta_ponude": "EUR",
"tecaj": "1",
"status": "1",
"boja": "#ffcf03",
"pdf": "https://solo.com.hr/download/8791cae3c9b02bb8d88bf626247b4e67dfbe20e35fc0342b448f39c9264c591d"
},
"message": "Detalji ponude _0001-2014_."
}
Odgovor na uspješan zahtjev bez poslanog ID će biti ovakav:
{
"status": 0,
"ponude": [
{
"id": "8791cae3c9b02bb8d88bf626247b4e67dfbe20e35fc0342b448f39c9264c591d",
"broj_ponude": "0001-2014",
"datum_ponude": "1.8.2016. 13:00:00",
"bruto_suma": "24,99",
"status": "1",
"boja": "#ffcf03"
}
],
"message": "Prikazano _1_ ponuda."
}
Popis mogućih grešaka kod neispravnog zahtjeva:
| 101 | Neispravan token. |
| 122 | Ponuda ne postoji. |
| 123 | Nije kreirana niti jedna ponuda. |