Lizing: portfelj s LTV alarmima

Za lizing kuće i banke vrijednost kolaterala se mijenja svaki dan, a dug pada po otplatnom planu. Praćenje vozila računa oboje i javi kad odnos postane rizičan.

1. 1

   Uvezite portfelj

   Svaki ugovor kao vlastito vozilo s izloženošću financing; broj ugovora u external_ref.

   const items = contracts.map((c) => ({
     kind: "owned",
     external_ref: c.contractNo,
     label: `${c.vehicleName} — ${c.contractNo}`,
     vehicle: {
       make: c.makeSlug, model: c.modelSlug, year: c.year,
       mileage_km: c.mileageAtStart, power_kw: c.powerKw,
       fuel: c.fuel, transmission: c.transmission,
     },
     km_per_year: c.expectedKmPerYear,
     exposure: {
       kind: "financing",
       amount_bam: c.outstanding,        // stanje danas
       as_of: today,
       term_months: c.monthsLeft,
       annual_rate_pct: c.ratePct,
       balloon_bam: c.residual ?? 0,     // otkupna vrijednost na kraju
     },
     alerts: { exposure_pct: 90, change_pct: 10, direction: "down" },
     tags: [c.branch],
   }));
   
   for (let i = 0; i < items.length; i += 500) {
     const res = await cifra("/v1/watchlist/batch", {
       method: "POST",
       body: JSON.stringify({ items: items.slice(i, i + 500) }),
     });
     for (const r of res.data.filter((r) => r.error)) log(items[i + r.index], r.error);
   }

2. 2

   Primajte alarme

   Dodajte webhook za watchlist.alert i watchlist.report_ready. Alarm exposure_above nosi ugovor (external_ref), dug i LTV tog dana.

3. 3

   Čitajte jutarnji izvještaj

   Na watchlist.report_ready pročitajte dnevni izvještaj: za svaki ugovor vrijednost, promjenu i exposure.ratio. Filtrirajte po external_ref za jedan ugovor.

4. 4

   Održavajte stanje

   • Dug se otplaćuje sam po planu; PATCH s novom exposure samo kad se plan promijeni (prijevremena otplata, reprogram).
   • Novo očitanje kilometraže (servis, povrat vozila): PATCH s mileage_km.
   • Ugovor zatvoren: DELETE.