Spremembe in zgodovina

Ob vsaki dnevni sinhronizaciji s seznami FURS zabeležimo, kaj se je spremenilo: nov zavezanec, sprememba imena ali naslova, prenehanje, ponovna aktivacija, vpis ali izbris iz registra DDV, odvzem identifikacijske številke za DDV in umik iz javnih seznamov. Spremembe lahko berete na dva načina:

Končna točka	Namen	Enote	Obseg ključa	Paket
GET /v1/changes	vir vseh sprememb, za periodično branje	1 na stran	changes	Growth+
GET /v1/entities/{tax}/history	spremembe enega zavezanca	1	changes	Growth+

Na nižjih paketih končni točki vrneta 403 plan_upgrade_required, ključ brez obsega changes pa 403 insufficient_scope. Obseg izberete ob ustvarjanju ključa v nadzorni plošči. Če želite spremembe le za izbrane zavezance, uporabite opazovane subjekte in webhooke.

Objekt change

{
  "object": "change",
  "id": "chg_48213",
  "seq": 48213,
  "change_type": "updated",
  "tax_number": "19000013",
  "registration_number": "9000000020",
  "type": "legal_entity",
  "name": "PRIMER TRANSPORT IN TRGOVINA, D.O.O.",
  "changed_fields": ["address_raw", "city", "postcode", "street"],
  "before": { "address_raw": "OBALNA CESTA 1, 6330 PIRAN", "city": "PIRAN", "postcode": "6330", "street": "OBALNA CESTA" },
  "after": { "address_raw": "FAZANSKA ULICA 4, 6320 PORTOROŽ", "city": "PORTOROŽ", "postcode": "6320", "street": "FAZANSKA ULICA" },
  "source_date": "2026-10-20",
  "detected_at": "2026-10-20T06:41:12.000Z",
  "data_version": 41,
  "redacted": false
}

change_type	Pomen
created	zavezanec se je prvič pojavil na seznamu
updated	spremenila so se polja iz changed_fields (ime, naslov, dejavnost, oznake stečaja/likvidacije …)
deactivated / reactivated	izpadel s seznama / se vrnil nanj
vat_registered / vat_deregistered	vpis v register DDV / izbris iz njega
vat_revoked	odvzem identifikacijske številke za DDV (seznama MT in NP)
suppressed	zavezanec (s.p.) je umaknjen iz javnih seznamov: izbrišite svojo kopijo njegovih podatkov

Odjemalci morajo prenesti tudi nove, še neznane vrednosti change_type. Vrste, ki je še ni na tem seznamu, ne pošiljamo: tako vrstico izpustimo (kazalec gre mimo nje) in jo zabeležimo, zato vir, zgodovina in webhooki zaradi nje nikoli ne vrnejo napake.

name je trenutno ime zavezanca. before in after vsebujeta le primerjana polja. Polje redacted: true pomeni, da imena in vrednosti ne pošljemo: zavezanec je v celoti umaknjen, s.p. je izključen iz iskanja po imenu (v viru sprememb) ali pa so stari podatki fizične osebe zaradi hrambe že izbrisani. Spremembe s.p. štejejo v dnevno omejitev različnih fizičnih oseb, enako kot vpogledi (429 natural_person_cap_exceeded); s filtrom type=legal_entity jih izključite.

Branje vira sprememb

Prvič začnete z datumom (polnoč po času Europe/Ljubljana) ali s časovnim žigom ISO 8601, nato pa vedno nadaljujete z next_cursor:

curl "https://api.maticna.si/v1/changes?since=2026-10-01&types=created,deactivated&limit=1000" \
  -H "Authorization: Bearer $MATICNA_KEY"

• Spremembe so urejene od najstarejše naprej, do 1.000 na stran (limit, privzeto 100).
• next_cursor je vedno prisoten, tudi na prazni strani. Shranite ga in ga ob naslednjem branju pošljite kot since. Kurzor ne poteče ob dnevnem osveževanju podatkov in je vezan na filtra types in type.
• has_more: true pomeni, da naslednja stran že čaka; sicer počakajte do naslednjega osveževanja (podatki FURS se osvežijo enkrat na delovni dan dopoldne).
• Nespremenjena stran z If-None-Match vrne 304 in je brezplačna.

let since = loadCursor() ?? '2026-10-01';
for (;;) {
  const r = await fetch(`https://api.maticna.si/v1/changes?since=${encodeURIComponent(since)}&limit=1000`, { headers });
  const page = await r.json();
  for (const change of page.data) await apply(change);
  since = page.next_cursor;
  saveCursor(since);
  if (!page.has_more) break;
}

Zgodovina zavezanca

curl "https://api.maticna.si/v1/entities/19000013/history" -H "Authorization: Bearer $MATICNA_KEY"

Vrne vse spremembe vseh registracij te davčne številke, od najstarejše naprej, s straničenjem prek cursor. Zgodovina se začne s prvo dnevno sinhronizacijo po začetnem nalaganju; datumi, ki so že v podatkih (vpis v DDV, odvzemi), so na objektu entity. Neznana, pravilno oblikovana davčna številka vrne 404 in porabi 1 enoto, enako kot vpogled.