API dokumentacija

Za developere.

Unos usluge/proizvoda u katalog

Ova metoda ti omogućuje da putem API zahtjeva dodaš usluge/proizvode u svoj katalog.

Pozivanje metode se vrši putem ove adrese:

POST https://api.solo.com.hr/katalog

Parametri

Parametri predstavljaju naredbe koje šalješ u POST pozivu.

token

Tvoj tajni identifikator. Možeš pronaći svoj API token u Postavkama nakon prijave u servis.

Pravilo: obavezno

sifra

Max. 50 znakova (bez razmaka).

Pravilo: nije obavezno, alfanumerički unos

opis

Max. 500 znakova (s razmacima).

Pravilo: obavezno, alfanumerički unos

jed_mjera

Max. 2 znaka. Ovdje pogledaj popis jediničnih mjera.

Pravilo: obavezno, numerički unos

kolicina

Max. 18 znakova (bez razmaka).

Pravilo: obavezno, numerički unos, dozvoljene 4 decimale

cijena

Dozvoljen je ISO 4217 brojčani format (npr. 1.234,00). Decimale se odvajaju zarezom. Max. 18 znakova (bez razmaka).

Pravilo: obavezno, numerički unos, dozvoljene 2 decimale

popust

Max. 18 znakova (bez razmaka).

Pravilo: obavezno, numerički unos, dozvoljene 4 decimale

porez_stopa

Max. 2 znaka (bez razmaka). Podržane porezne stope su 0, 5, 13 i 25.

Pravilo: obavezno, numerički unos

Povratne informacije

Ovdje su navedeni mogući odgovori servisa nakon što pošalješ API zahtjev.

Odgovor na uspješan zahtjev će biti ovakav:

{
  "status": 0,
  "katalog": [
    {
      "sifra": "0001",
      "opis": "Jabuke",
      "jed_mjera": "kg",
      "kolicina": "1",
      "cijena": "7,00",
      "popust": "0",
      "porez_stopa": "25"
    }
  ],
  "message": "Usluga/proizvod dodan u katalog."
}
          

Popis mogućih grešaka kod neispravnog zahtjeva:

101 Neispravan token.
102 Šifra usluge/proizvoda je duža od 255 znakova.
103 Opis usluge/proizvoda nije poslan ili je duži od 1000 znakova.
104 Količina nije poslana ili u neispravnom formatu.
105 Cijena nije poslana ili u neispravnom formatu.
106 Popust nije poslan ili u neispravnom formatu.
107 Porezna stopa nije poslana ili u neispravnom formatu.

Primjer API zahtjeva u praksi

Primjer u nastavku je isključivo demonstracija metode i njenih parametara. Metode nikada ne bi trebale biti u ovakvom HTML formatu nego ih se generira dinamički kroz neki od programskih/skriptnih jezika.

<form action="https://api.solo.com.hr/katalog" method="post">
  <input type="hidden" name="token" value="k2f85a47b75f20h21da9zg1337co5a1g">
  <input type="hidden" name="sifra" value="0001">
  <input type="hidden" name="opis" value="Jabuke">
  <input type="hidden" name="jed_mjera" value="7">
  <input type="hidden" name="kolicina" value="1">
  <input type="hidden" name="cijena" value="7,00">
  <input type="hidden" name="popust" value="0">
  <input type="hidden" name="porez_stopa" value="25">
</form>