Docs

APIPraćenje

Praćenje vozila

Portfelj koji se procjenjuje svako jutro, s alarmima i dnevnim izvještajem.

Praćeno vozilo se procjenjuje svako jutro (oko 7–8 h po našem vremenu, nakon noćnog treniranja modela), istim modelom i zaokruživanjem kao POST /v1/valuations. Zatim se provjere pravila alarma, napravi dnevni izvještaj i pošalju webhookovi.

VrstaZa štaŠta se mijenja svaki dan
ownedVaša vozila: lizing, kolateral, flota, lager.Vozilo stari, kilometraža raste za km_per_year; vrijednost prati to i tržište.
wantedSpecifikacija koju tražite za kupca ili otkup.Tržišna cijena te specifikacije; novi povoljni oglasi (deal_pct).
POST/v1/watchlist
curl -X POST "https://api.cifra.ba/v1/watchlist" \
  -H "Authorization: Bearer $CIFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "owned",
    "label": "VW Golf 7 — ugovor 2024/118",
    "external_ref": "2024/118",
    "vehicle": {
      "make": "volkswagen",
      "model": "golf_7",
      "year": 2017,
      "mileage_km": 148000,
      "power_kw": 85,
      "fuel": "diesel",
      "transmission": "manual"
    },
    "km_per_year": 18000,
    "exposure": {
      "kind": "financing",
      "amount_bam": 18500,
      "as_of": "2026-10-18",
      "term_months": 36,
      "annual_rate_pct": 6.9,
      "balloon_bam": 12000
    },
    "alerts": {
      "change_pct": 5,
      "direction": "down",
      "exposure_pct": 85
    },
    "tags": [
      "lizing",
      "sarajevo"
    ]
  }'

Šta se plaća

Dodavanje vozila je 1 jedinica (procjenjuje se odmah). Dnevne procjene, izvještaj, alarmi, historija i webhookovi su besplatni.

Portfelj odjednom

Do 500 vozila u pozivu s POST /v1/watchlist/batch: svako uspije ili padne samo za sebe. Postavite external_ref na vašu oznaku (broj ugovora, šasije) — po njoj filtrirate listu i izvještaj, a dolazi i u svakom alarmu.

Održavanje

  • Novo očitanje brojila: PATCH s mileage_km — kilometraža dalje raste od njega.
  • Rata kredita plaćena ili ugovor promijenjen: PATCH s novom exposure.
  • Vozilo prodano ili ugovor zatvoren: DELETE (ne broji se više u limit).
  • Privremeno bez procjena: status: "paused".

Dnevni izvještaj

Kad je jutarnja procjena gotova, stiže webhook watchlist.report_ready; GET /v1/watchlist/report zatim daje svako vozilo: vrijednost, promjenu od juče i od početka, izloženost i LTV, i alarme dana. Jedan poziv za cijeli portfelj, besplatno.

summary
{
  "vehicles": 412,
  "valued": 412,
  "up": 37,
  "down": 351,
  "alerts": 1
}

Limiti

Business: 1.000 praćenih vozila, Sandbox: 10, Enterprise po ugovoru. Preko limita API vraća 409 watchlist_full s max i count.