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 u .php skriptnom jeziku.
<?php
$url = 'https://api.solo.com.hr/katalog';
// $data ne smije biti array zbog duplikata
$data = 'token=k2f85a47b75f20h21da9zg1337co5a1g' .
'&sifra=' . urlencode('0001') .
'&opis=' . urlencode('kava') .
'&jed_mjera=1' .
'&cijena=76,00' .
'&kolicina=1' .
'&popust=0' .
'&porez_stopa=25';
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);
echo $response; // isključi echo nakon testiranja
?>