Docs

APIProcjene

Tržišna vrijednost

Šta tačno znači broj koji API vraća, kako čitati raspon i ocjenu, i koji podaci ga čine preciznijim.

POST /v1/valuations vraća tržišnu vrijednost: cijenu po kojoj se uporedivo vozilo oglašava kod privatnog prodavca u BiH na dan procjene. To je referenca tržišta, ne ponuda za otkup — za otkup, kredit ili osiguranje na nju primijenite svoja pravila ili svoj model.

POST/v1/valuations
curl -X POST "https://api.cifra.ba/v1/valuations" \
  -H "Authorization: Bearer $CIFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_type": "car",
    "make": "volkswagen",
    "model": "golf_7",
    "year": 2017,
    "mileage_km": 148000,
    "power_kw": 85,
    "engine_cc": 1598,
    "fuel": "diesel",
    "transmission": "manual",
    "body_type": "hatchback",
    "city": "Sarajevo",
    "include": [
      "explanation",
      "forecast",
      "comparables"
    ]
  }'

Vrijednost, raspon, ocjena

PoljeZnačenje
market_value.pointTržišna vrijednost u KM, zaokružena na 10 KM.
market_value.low / highRaspon u kojem je cijena s vjerovatnoćom od 80%. Kalibrisan na novim oglasima: pogađa 8 od 10.
market_value.confidence_gradeA, B ili C: koliko je raspon uzak za takvo vozilo, u odnosu na ostala.
model_versionModel koji je procijenio; čuvajte ga uz procjenu radi revizije.
as_ofDan na koji vrijednost važi.
Za odluke s rizikom (kolateral, isplata štete) koristite i raspon, ne samo point: npr. donju granicu kao konzervativnu vrijednost, ili ručnu provjeru kad je ocjena C.

Šta sužava raspon

Obavezni su make, model, year i mileage_km. Svaki dodatni podatak pomaže, a ovi najviše — bez njih procjena nosi upozorenje partial_inputs i širi raspon:

VrstaKljučni podaci
Automobilpower_kw (ili power_hp), engine_cc, fuel, transmission
Motociklengine_cc, category
Kamionpower_kw

Zatim: power_kw i fuel za sve vrste, city (regionalna potražnja), body_type, drivetrain, owners_count, service_history, customs_cleared, equipment; za kamione i category i payload_class.

Upozorenja

warnings objašnjava ono što broj sam ne kaže. Procjena je i dalje ispravna; upozorenje kaže kako je čitati.

UpozorenjeZnačenje
partial_inputsNedostaje neki od ključnih podataka — automobili: snaga, zapremina, gorivo, mjenjač; motocikli: zapremina i tip; kamioni: snaga. Poruka navodi šta fali; raspon je širi.
model_not_in_market_dataModel nismo vidjeli u oglasima; procjena se oslanja na marku i slična vozila.
few_market_examplesMalo oglasa ovog modela, pa je raspon širi.
unusual_mileageKilometraža je neobična za starost vozila. Provjerite je; ako je tačna, cijena može više odstupati.
old_vehicleVozila starija od 25 godina cijene se manje ujednačeno.
market_level_as_of_data_endNajnoviji podaci modela su stariji od 7 dana; nivo tržišta je onaj s tog dana.
comparables_not_in_batchSlična vozila se ne vraćaju u masovnoj procjeni.
custom_model_unavailableVaš model trenutno nije mogao odgovoriti; vrijednost je standardnog modela.
custom_model_unseen_makeU podacima vašeg modela nema ove marke: vrijednost je tržišna, pomjerena za vašu opštu razliku.
custom_model_few_examplesU podacima vašeg modela je malo vozila ovog modela; procjena se više oslanja na tržišni model.

Sva polja zahtjeva

  • vehicle_typeenumopcionalnopodrazumijevano "car"

    Vrsta vozila. Svaka vrsta ima svoj model, šifarnik i polja koja prima.

    carmotorcycletruck
  • makestringobaveznodo 64 znaka

    Marka kao šifra iz GET /v1/taxonomy/makes, npr. volkswagen, mercedes_benz, škoda.

  • modelstringobaveznodo 64 znaka

    Model kao šifra iz GET /v1/taxonomy/makes/{make}/models, npr. golf_7.

  • yearintegerobaveznonajmanje 1950

    Godište (modelska godina). Najviše sljedeća godina.

  • mileage_kmintegerobavezno0 – 2.000.000

    Pređeni kilometri na dan procjene.

  • power_kwnumberopcionalno2 – 1000

    Snaga motora u kW. Jedan od najvažnijih podataka za cijenu.

  • power_hpnumberopcionalno3 – 1400

    Snaga u KS; koristi se samo kad power_kw nije poslan.

  • engine_ccintegeropcionalno40 – 20.000

    Zapremina motora u cm³.

  • fuelenumopcionalno

    Gorivo.

    petroldiesellpgcnghybridplugin_hybridelectrichydrogenother
  • transmissionenumopcionalno

    Mjenjač.

    manualautomaticsemi_automatic
  • drivetrainenumopcionalno

    Pogon. Samo automobili.

    fwdrwdawd
  • body_typeenumopcionalno

    Karoserija. Samo automobili.

    sedanhatchbackwagonsuvcoupeconvertibleminivanvanpickupother
  • doorsintegeropcionalno2 – 5

    Broj vrata. Samo automobili.

  • conditionenumopcionalno

    Stanje: used (podrazumijevano) ili new.

    usednew
  • seller_typeenumopcionalno

    Ko prodaje: privatna osoba ili salon.

    privatedealer
  • citystringopcionalnodo 80 znakova

    Grad u BiH, npr. Sarajevo ili Banja Luka. Regionalna potražnja pomjera cijenu.

  • equipmentstring[]opcionalnodo 150 stavki

    Oprema kako je navodi oglas ili vaš sistem, npr. navigacija, kožna sjedišta.

  • owners_countintegeropcionalno1 – 20

    Broj dosadašnjih vlasnika.

  • customs_clearedbooleanopcionalno

    Je li vozilo ocarinjeno.

  • service_historybooleanopcionalno

    Ima li vozilo servisnu historiju (knjižicu).

  • categorystringopcionalnodo 60 znakova

    Motocikli: tip (Naked, Scooter, Enduro…); kamioni: nadogradnja (Kiper, Kombi…). Vrijednosti: GET /v1/taxonomy/values.

  • absbooleanopcionalno

    ABS. Samo motocikli.

  • axlesintegeropcionalno1 – 6

    Broj osovina. Samo kamioni.

  • payload_classstringopcionalnodo 40 znakova

    Nosivost kao razred iz GET /v1/taxonomy/values. Samo kamioni.

  • as_ofdateopcionalno

    Datum procjene (YYYY-MM-DD), od 2015-01-01 do danas: vrijednost kakva je bila tog dana, npr. na dan štete. Podrazumijevano danas (UTC).

  • includeenum[]opcionalnodo 3 stavke

    Dodaci odgovoru: explanation (obračun cijene), forecast (vrijednost kroz 6–36 mjeseci), comparables (slična vozila u prodaji). Bez polja: explanation i forecast; [] vraća samo vrijednost.

    explanationforecastcomparables
  • km_per_yearintegeropcionalno0 – 150.000

    Koliko će vozilo prelaziti godišnje, za prognozu. Podrazumijevano: njegov dosadašnji prosjek.

  • valuation_modelenumopcionalno

    auto (podrazumijevano): vaš model kompanije kad je u upotrebi, inače standardni; standard: uvijek standardni tržišni model.

    autostandard

Čuvanje i revizija

Svaka live procjena se čuva s tačnim zahtjevom. Pročitajte je kasnije s GET /v1/valuations/{id}, npr. kad treba pokazati na osnovu čega je odobren kredit. Kad saznate stvarnu prodajnu cijenu, javite je s POST /v1/valuations/{id}/outcome — besplatno je i poboljšava buduće procjene prodajne cijene.