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 d.o.o.",
    "kupac_adresa": "Kralja Držislava 4, 10000 Zagreb",
    "kupac_oib": "58981111611",
    "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": "HRK",
    "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.