API dokumentacija

Za developere.

Promjena statusa računa

Ova metoda ti omogućuje promjenu statusa postojećeg računa. Imaj na umu da možeš mijenjati status samo u Otvori ili Plaćeno. Računima koji podliježu F2 ne možeš mijenjati statuse.

Pozivanje metode se vrši putem ove adrese:

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

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

id

ID računa koji je vidljiv kod prikaza računa.

Pravilo: obavezno

status

Željeni status računa. Ovdje provjeri podržane statuse računa i ponuda.

Pravilo: obavezno, numerički unos

datum_uplate

Dozvoljen je ISO 8601 format datuma (npr. 2014-01-01).

Pravilo: obavezno samo kada je status Plaćeno

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,
  "racun": {
    "id": "8791cae3c9b02bb8d88bf626247b4e67dfbe20e35fc0342b448f39c9264c591d",
    "broj_racuna": "1-1-1",
    "datum_uplate": "14.10.2026.",
    "status": "5",
    "boja": "#a9bf15",
    "stari_status": "1"
  },
  "message": "Status računa _1-1-1_ promijenjen."
}
          

Popis mogućih grešaka kod neispravnog zahtjeva:

101 Neispravan token.
122 Dokument ne postoji.
150 ID dokumenta nije poslan.
160 Nedozvoljeni status.
161 Status nije poslan ili u neispravnom formatu.
162 Datum uplate nije poslan ili u neispravnom formatu.
429 Previše zahtjeva. Smanji učestalost spajanja na API servis (max. 100 zahtjeva u 60 minuta).