# Cifra

> Cifra procjenjuje tržišnu vrijednost automobila, motocikala i kamiona u Bosni i Hercegovini iz stvarnih oglasa. Cifra API (https://api.cifra.ba/v1) daje procjene s rasponom i obračunom, historiju vozila sa signalima rizika, praćenje portfelja s alarmima i webhookove. Dokumentacija je na bosanskom; polja i šifre su na engleskom.

Cijela dokumentacija u jednom fajlu: https://www.cifra.ba/docs/llms-full.txt. OpenAPI 3.1: https://www.cifra.ba/docs/openapi.json.

## Pregled

- [Cifra dokumentacija](https://www.cifra.ba/docs/md/index): Sve o Cifri na jednom mjestu: kako nastaje procjena, kako koristiti aplikaciju i platformu za kompanije, i kako ugraditi Cifra API u vaš sistem.
- [Kako Cifra radi](https://www.cifra.ba/docs/md/overview/how-it-works): Od oglasa do procjene: odakle dolaze podaci, kako se model uči i zašto svaka procjena dolazi s rasponom.
- [Tačnost i modeli](https://www.cifra.ba/docs/md/overview/accuracy): Koliko su procjene tačne, kako to mjerimo i šta tačno znači raspon od 80%.
- [Pojmovnik](https://www.cifra.ba/docs/md/overview/glossary): Pojmovi koje koristimo u aplikaciji, na platformi i u API-ju.

## Cifra za pojedince

- [Cifra za pojedince](https://www.cifra.ba/docs/md/cifra): Koliko vrijedi vaš automobil, motocikl ili kamion, iz stvarnih oglasa u BiH: tržišna vrijednost, realan raspon i izvještaj koji možete poslati kupcu.
- [Procjena vozila](https://www.cifra.ba/docs/md/cifra/valuation): Kako unijeti automobil, motocikl ili kamion i koji podaci najviše sužavaju raspon cijene.
- [Izvještaj](https://www.cifra.ba/docs/md/cifra/report): Šta znači svaki dio izvještaja: vrijednost i raspon, za koliko oglasiti, obračun cijene, tržište, kilometraža, vrijednost kroz vrijeme i slična vozila.
- [Dijeljenje i provjera](https://www.cifra.ba/docs/md/cifra/sharing): Pošaljite izvještaj kupcu ili prodavcu linkom, QR kodom ili kao PDF, odredite ko ga vidi i provjerite svaki izvještaj po broju.
- [Moje procjene](https://www.cifra.ba/docs/md/cifra/history): Sve vaše procjene na jednom mjestu, ponovna procjena istog vozila i prodajna cijena koja poboljšava modele.
- [Planovi i plaćanje](https://www.cifra.ba/docs/md/cifra/plans): Free, Plus i Pro: šta dobijate, koliko košta i kako promijeniti ili otkazati plan.
- [Nalog i privatnost](https://www.cifra.ba/docs/md/cifra/account): Registracija i prijava, profil, lozinka i uređaji, email obavještenja, izvoz podataka i brisanje naloga.

## Cifra Enterprise

- [Cifra Enterprise](https://www.cifra.ba/docs/md/enterprise): Platforma za timove koji procjenjuju vozila svaki dan: procjene s logom kompanije, masovne liste, provjera rizika, praćenje portfelja, lager, tržište i rezidualne vrijednosti.
- [Tim i postavke](https://www.cifra.ba/docs/md/enterprise/team): Podaci i logo kompanije, članovi i uloge, pravila izvještaja, sigurnost prijave i dnevnik aktivnosti.
- [Plan i naplata](https://www.cifra.ba/docs/md/enterprise/billing): Team, Business i Enterprise: šta je u kojem planu, probni period, potrošnja i računi.
- [Procjene](https://www.cifra.ba/docs/md/enterprise/valuations): Procjena s logom kompanije, svrhom i vašom oznakom, i izvještaj s alatom za odluku: otkup, prodaja, finansiranje ili osiguranje.
- [Masovna procjena](https://www.cifra.ba/docs/md/enterprise/bulk): Lager, lizing portfelj ili flota iz Excel tabele, procijenjeni odjednom, na dan koji odaberete, i vraćeni kao vaš fajl s Cifrinim kolonama.
- [Provjera](https://www.cifra.ba/docs/md/enterprise/check): Šta oglasi govore o vozilu, a prodavac ne kaže: vraćena kilometraža, tuđe fotografije, cijena van tržišta, lizing. Uz odluku vašeg tima.
- [Vozila i alarmi](https://www.cifra.ba/docs/md/enterprise/watchlist): Flota, lager, kolateral ili vozila koja tražite, procijenjeni ponovo svako jutro, s izloženošću, LTV-om i alarmima.
- [Lager](https://www.cifra.ba/docs/md/enterprise/inventory): Vaša vozila na prodaji poređena s tržištem svako jutro: šta je preskupo, šta stoji, koliko će se čekati i šta vrijedi kupiti.
- [Rezidual](https://www.cifra.ba/docs/md/enterprise/residuals): Koliko će vozilo vrijediti na kraju lizinga ili kredita, iz domaćeg tržišta, s rasponom i preporučenim ostatkom vrijednosti.
- [Radar](https://www.cifra.ba/docs/md/enterprise/radar): Tržište BiH za bilo koji segment, svaki dan: cijene, ponuda i potražnja, brzina prodaje, karta po općinama, trgovci i oglasi.
- [Vaš model](https://www.cifra.ba/docs/md/enterprise/models): Cifrin model naučen na vašim prodajnim, otkupnim, traženim ili procijenjenim cijenama, za procjene kakve vaša kompanija zaista postiže.
- [Razvoj](https://www.cifra.ba/docs/md/enterprise/developers): API ključevi, potrošnja, log zahtjeva i webhookovi vašeg sistema, sve na platformi.
- [Widgeti](https://www.cifra.ba/docs/md/enterprise/widgets): Vaša vozila na vašoj stranici: nezavisna ocjena tražene cijene, tržište i slična vozila, svako jutro ažurirano.

## API vodiči

- [Cifra API](https://www.cifra.ba/docs/md/api): Tržišna vrijednost vozila, provjera oglasa i praćenje portfelja u vašem sistemu: REST, JSON, jedan ključ.
- [Brzi početak](https://www.cifra.ba/docs/md/api/quickstart): Od ključa do prve procjene za pet minuta.
- [Autentifikacija](https://www.cifra.ba/docs/md/api/authentication): Ključevi, okruženja, pristupi, IP adrese i zamjena ključa bez prekida.
- [Sandbox](https://www.cifra.ba/docs/md/api/sandbox): Testni ključevi: prava provjera zahtjeva, fiksni odgovori, bez naplate.
- [Konvencije](https://www.cifra.ba/docs/md/api/conventions): Format zahtjeva i odgovora, oznake, datumi, valuta, liste i oznaka zahtjeva.
- [Limiti i kvote](https://www.cifra.ba/docs/md/api/limits): Zahtjevi u minuti, jedinice u mjesecu, veličina liste i kako ih poštovati.
- [Obračun](https://www.cifra.ba/docs/md/api/billing): Šta troši jedinice, šta je besplatno i gdje pratite potrošnju.
- [Greške](https://www.cifra.ba/docs/md/api/errors): Format grešaka, šta znači svaki status i kad zahtjev ponoviti.
- [Tržišna vrijednost](https://www.cifra.ba/docs/md/api/valuations): Šta tačno znači broj koji API vraća, kako čitati raspon i ocjenu, i koji podaci ga čine preciznijim.
- [Vrste vozila i šifarnik](https://www.cifra.ba/docs/md/api/vehicle-types): Automobili, motocikli i kamioni: šifre marki i modela, polja svake vrste i kako povezati vaš šifarnik.
- [Obračun cijene](https://www.cifra.ba/docs/md/api/explanation): Zašto baš ta vrijednost: doprinos svakog faktora, u KM, koji se tačno sabira.
- [Prognoza vrijednosti](https://www.cifra.ba/docs/md/api/forecast): Koliko će vozilo vrijediti za 6, 12, 24 i 36 mjeseci, s rasponom.
- [Slična vozila](https://www.cifra.ba/docs/md/api/comparables): Vozila u prodaji danas koja liče na procijenjeno, s Cifrinom vrijednošću svakog.
- [Procjena na dan](https://www.cifra.ba/docs/md/api/point-in-time): Vrijednost kakva je bila određenog dana: dan štete, dan kupovine, kraj kvartala.
- [Masovna procjena](https://www.cifra.ba/docs/md/api/batch): Stotine vozila u jednom pozivu: portfelji, lageri, cjenovnici.
- [Vaš model](https://www.cifra.ba/docs/md/api/company-models): Procjene naučene na vašim cijenama — prodajnim, otkupnim ili procjenama — uz tržišnu vrijednost.
- [Provjera vozila](https://www.cifra.ba/docs/md/api/vehicle-history): Za link oglasa: svi oglasi istog vozila koje je Cifra vidjela i signali na koje treba obratiti pažnju.
- [Praćenje vozila](https://www.cifra.ba/docs/md/api/watchlist): Portfelj koji se procjenjuje svako jutro, s alarmima i dnevnim izvještajem.
- [Izloženost i LTV](https://www.cifra.ba/docs/md/api/exposure): Koliko duga, osigurane sume ili troška stoji iza vozila, i kad pređe njegovu vrijednost.
- [Alarmi](https://www.cifra.ba/docs/md/api/alerts): Pravila po vozilu: pad ili rast vrijednosti, ciljne cijene, LTV i povoljni oglasi.
- [Webhookovi](https://www.cifra.ba/docs/md/api/webhooks): Događaji u vaš sistem čim se dese: potpisani, s ponovnim pokušajima i logom isporuka.
- [Widgeti](https://www.cifra.ba/docs/md/api/widgets): Vaše procjene na vašoj stranici: ocjena tražene cijene, tržište i slična vozila, svako jutro ažurirano.
- [Osiguranje: vrijednost na dan štete](https://www.cifra.ba/docs/md/api/recipes/insurance-claim): Tržišna vrijednost vozila na dan štete ili krađe, s rasponom za odluku i zapisom za reviziju.
- [Lizing: portfelj s LTV alarmima](https://www.cifra.ba/docs/md/api/recipes/leasing-portfolio): Cijeli portfelj u praćenju, dnevni LTV svakog ugovora i alarm kad dug pređe vrijednost vozila.
- [Otkup: provjera i ponuda](https://www.cifra.ba/docs/md/api/recipes/dealer-intake): Od linka oglasa do ponude za otkup: historija vozila, signali, tržišna vrijednost i slična vozila.
- [Kontrolna lista za produkciju](https://www.cifra.ba/docs/md/api/go-live): Šta provjeriti prije nego što integracija pređe na live ključ.
- [Sigurnost](https://www.cifra.ba/docs/md/api/security): Kako čuvamo vaše podatke i kako da vi čuvate ključeve.
- [Podrška](https://www.cifra.ba/docs/md/api/support): Kako najbrže doći do odgovora kad nešto ne radi.
- [OpenAPI i alati](https://www.cifra.ba/docs/md/api/openapi): Specifikacija za Postman, generisanje klijenta i AI asistente.

## API referenca

- [API referenca](https://www.cifra.ba/docs/md/api-reference): Svaki endpoint Cifra API-ja: parametri, polja odgovora, greške i primjeri u sedam jezika.
- [Procjena vozila](https://www.cifra.ba/docs/md/api-reference/valuations/create): POST /v1/valuations. Tržišna vrijednost vozila s rasponom od 80% i ocjenom pouzdanosti, uz obračun po faktorima, prognozu i slična vozila u prodaji. Obavezni su make, model, year i mileage_km; svaki dodatni podatak sužava raspon.
- [Masovna procjena](https://www.cifra.ba/docs/md/api-reference/valuations/batch): POST /v1/valuations/batch. Do batch_max_items vozila u jednom pozivu (Business: 100). Svako vozilo se provjerava i procjenjuje zasebno: neispravno vraća grešku na svom mjestu, ostala se procijene. Naplaćuje se svako procijenjeno vozilo.
- [Čitanje procjene](https://www.cifra.ba/docs/md/api-reference/valuations/retrieve): GET /v1/valuations/{id}. Sačuvana procjena s tačnim zahtjevom kojim je nastala, npr. za reviziju odluke. Vidljiva samo ključevima iste kompanije i istog okruženja.
- [Prijava prodajne cijene](https://www.cifra.ba/docs/md/api-reference/valuations/outcome): POST /v1/valuations/{id}/outcome. Javite za koliko je vozilo stvarno prodano ili otkupljeno. Ne naplaćuje se; stvarne cijene su podaci od kojih se uči procjena prodajne cijene.
- [Marke](https://www.cifra.ba/docs/md/api-reference/taxonomy/makes): GET /v1/taxonomy/makes. Sve marke koje Cifra procjenjuje, za jednu vrstu vozila, sa šiframa (slug) koje šaljete u procjeni. Besplatno; šifarnik se rijetko mijenja, pa ga keširajte (npr. jednom dnevno).
- [Modeli marke](https://www.cifra.ba/docs/md/api-reference/taxonomy/models): GET /v1/taxonomy/makes/{make}/models. Modeli jedne marke sa šiframa za procjenu. Generacije su zasebni modeli (golf_6, golf_7), kao i jače izvedbe (golf_7_gti).
- [Dozvoljene vrijednosti](https://www.cifra.ba/docs/md/api-reference/taxonomy/values): GET /v1/taxonomy/values. Vrijednosti koje primaju polja s izborom (gorivo, mjenjač, karoserija…) za jednu vrstu vozila. Za motocikle i kamione i category/payload_class koje model zna.
- [Historija vozila](https://www.cifra.ba/docs/md/api-reference/vehicle-history/retrieve): GET /v1/vehicle-history. Za jedan oglas: svi drugi oglasi istog vozila koje je Cifra vidjela (ponovna objavljivanja, druge stranice), s datumima, cijenama i kilometražom, i signali Cifra Provjere — vraćena kilometraža, tuđe fotografije, lizing, preprodavač kao privatnik.
- [Praćenje vozila](https://www.cifra.ba/docs/md/api-reference/watchlist/create): POST /v1/watchlist. Vozilo koje se procjenjuje svako jutro, s alarmima po vašim pravilima. Vlastitom vozilu (owned) kilometraža raste svaki dan; za traženo (wanted) stižu i povoljni oglasi. Procjenjuje se odmah (1 jedinica); dnevne procjene su besplatne.
- [Uvoz portfelja](https://www.cifra.ba/docs/md/api-reference/watchlist/batch): POST /v1/watchlist/batch. Do 500 vozila odjednom, npr. cijeli portfelj. Svako se provjerava i procjenjuje zasebno; naplaćuje se svako vozilo koje se počne pratiti.
- [Lista praćenih vozila](https://www.cifra.ba/docs/md/api-reference/watchlist/list): GET /v1/watchlist. Praćena vozila, od najnovijeg, po stranicama (limit, starting_after). Filtrirajte po vašoj oznaci ili statusu.
- [Praćeno vozilo](https://www.cifra.ba/docs/md/api-reference/watchlist/retrieve): GET /v1/watchlist/{id}. Jedno vozilo: zadnja procjena, promjena od početka, izloženost i LTV, prognoza i pravila alarma.
- [Izmjena praćenog vozila](https://www.cifra.ba/docs/md/api-reference/watchlist/update): PATCH /v1/watchlist/{id}. Mijenja samo poslana polja: novo očitanje kilometraže, pravila alarma, izloženost (npr. nakon rate kredita), pauza.
- [Prestanak praćenja](https://www.cifra.ba/docs/md/api-reference/watchlist/delete): DELETE /v1/watchlist/{id}. Vozilo se više ne procjenjuje i ne broji se u limit praćenih vozila.
- [Historija vrijednosti](https://www.cifra.ba/docs/md/api-reference/watchlist/history): GET /v1/watchlist/{id}/history. Vrijednost vozila za svaki dan praćenja, s rasponom, kilometražom i verzijom modela. Podrazumijevano zadnjih 90 dana.
- [Dnevni izvještaj](https://www.cifra.ba/docs/md/api-reference/watchlist/report): GET /v1/watchlist/report. Svako praćeno vozilo na jedan dan: vrijednost, promjena od prethodne i od polazne, izloženost i LTV, i alarmi tog dana. Spreman svako jutro; javlja ga webhook watchlist.report_ready.
- [Lista alarma](https://www.cifra.ba/docs/md/api-reference/alerts/list): GET /v1/alerts. Alarmi svih praćenih vozila, od najnovijeg, po stranicama. Isti alarmi stižu i webhookom watchlist.alert; lista služi za pregled i za nadoknadu propuštenog.
- [Nova webhook adresa](https://www.cifra.ba/docs/md/api-reference/webhooks/create): POST /v1/webhooks. Adresa na koju Cifra šalje događaje, potpisane vašom tajnom. Tajna se vraća samo u ovom odgovoru. Najviše 5 aktivnih adresa po okruženju.
- [Lista webhook adresa](https://www.cifra.ba/docs/md/api-reference/webhooks/list): GET /v1/webhooks. Adrese okruženja ključa (live ili test), s dijelom tajne i statusom.
- [Isključivanje adrese](https://www.cifra.ba/docs/md/api-reference/webhooks/delete): DELETE /v1/webhooks/{id}. Adresa prestaje primati događaje, a isporuke koje su čekale se otkazuju.
- [Probni događaj](https://www.cifra.ba/docs/md/api-reference/webhooks/test): POST /v1/webhooks/{id}/test. Šalje webhook.test na adresu odmah, da provjerite prijem i provjeru potpisa. Ishod vidite u isporukama.
- [Isporuke](https://www.cifra.ba/docs/md/api-reference/webhooks/deliveries): GET /v1/webhooks/{id}/deliveries. Zadnje isporuke adrese: status, broj pokušaja, sljedeći pokušaj, HTTP status vaše adrese i greška.
- [Objava widgeta](https://www.cifra.ba/docs/md/api-reference/widgets/create): POST /v1/widgets. Objavljuje procjenu vaše kompanije (valuation_id) kao widgete za vašu stranicu: ocjenu tražene cijene, tržište, slična vozila, vrijednost kroz vrijeme. Vozilo se svako jutro procjenjuje ponovo, uvijek standardnim modelom. Javno se samo čita — widgeti nikad ne pozivaju API. Besplatno (naplaćena je procjena); plan određuje koliko vozila može biti objavljeno.
- [Objava više widgeta](https://www.cifra.ba/docs/md/api-reference/widgets/batch): POST /v1/widgets/batch. Do 500 procjena odjednom (cijeli lager); svaka se objavljuje zasebno.
- [Lista widgeta](https://www.cifra.ba/docs/md/api-reference/widgets/list): GET /v1/widgets. Objavljena vozila, od najnovijeg, po stranicama; po vašoj oznaci nađete public_id za predložak stranice.
- [Widget](https://www.cifra.ba/docs/md/api-reference/widgets/retrieve): GET /v1/widgets/{id}. Jedan widget: vrijednost, ocjena, kod. id može biti i public_id.
- [Izmjena widgeta](https://www.cifra.ba/docs/md/api-reference/widgets/update): PATCH /v1/widgets/{id}. Nova cijena, oznaka, naziv, kilometraža (procjenjuje se odmah ponovo) ili pauza. Stranice pokazuju izmjenu za najviše 5 minuta.
- [Uklanjanje widgeta](https://www.cifra.ba/docs/md/api-reference/widgets/delete): DELETE /v1/widgets/{id}. Widgeti vozila nestaju sa svih stranica, a stranica za kupce prestaje raditi. Procjena ostaje.
- [Webhook događaji](https://www.cifra.ba/docs/md/api-reference/webhook-events): Događaji koje Cifra šalje na vaše webhook adrese, s primjerom tijela svakog.
- [Šifre grešaka](https://www.cifra.ba/docs/md/api-reference/errors): Svaka šifra greške: HTTP status, kad se javlja i šta uraditi.