Dnevnik sprememb

Politika

• Znotraj /v1 izdajamo samo združljive spremembe: nova polja, nove končne točke, nove vrednosti naštevnih tipov, nove kode napak.
• Nezdružljive spremembe gredo v /v2, z vsaj 12 meseci prekrivanja. Opuščene končne točke vračajo glavi Deprecation in Sunset.
• CI primerja openapi.json z zadnjo izdajo in zavrne nezdružljive spremembe.
• Spremembe obračunskih pravil objavimo vsaj 30 dni vnaprej.

2026-10 · v1 (zasebna beta)

• Končne točke: entities, by-registration-number, by-vat, lookup, iskanje, autocomplete, preverjanje DDV in davčne, reference, meta/status, usage.
• Viri: FURS PO, DEJ, FO (samo DDV), MT/NP, skupine DDV.
• Kode napak RFC 9457 s stranmi na /docs/errors/<code>.

2026-10 · v1.1

• Vir sprememb GET /v1/changes in zgodovina subjekta GET /v1/entities/{tax}/history (od paketa Growth), glej Spremembe in zgodovina.
• Opazovani subjekti (/v1/monitors, v vseh paketih) z obvestili po e-pošti, glej Opazovani subjekti.
• Podpisani webhooki (Standard Webhooks, od paketa Starter) z zamenjavo skrivnosti brez izpada, glej Webhooki.
• Strežnik MCP: orodja list_changes, get_entity_history in list_monitors.

2026-10-20 · Testni ključi ukinjeni

• Obstaja le še ena vrsta skrivnega ključa. Novi ključi imajo predpono mk_…; starejši ključi mk_live_… delujejo še naprej. Javni ključi mk_pub_ ostanejo nespremenjeni.
• Ključi mk_test_… so preklicani in vrnejo 401 test_keys_removed. Fiktivnega nabora podatkov ni več; vsak ključ vrača prave podatke in je obračunan po enotah.
• Opazovani subjekti in končne točke webhookov niso več ločeni po okolju: organizacija ima en seznam in en nabor končnih točk (največ 10).
• GET /v1/usage: objekt key nima več polja env; ima channel (key ali playground), id pa je null za zahteve iz preizkuševalnika.
• Strežnik MCP nima več peskovnika in polja environment v rezultatih.
• Za preizkušanje uporabite preizkuševalnik API-ja v nadzorni plošči: dela na pravih podatkih, ne porablja enot in je omejen na približno 20 zahtev na minuto.

2026-10 · Finančni podatki (AJPES)

• GET /v1/entities/{tax}/financials: ključne postavke iz letnih poročil AJPES (CC BY 4.0) za kapitalske družbe in zadruge, od najnovejšega leta naprej, z žigom izvora za vsak izkaz. Nikoli za samostojne podjetnike: zanje je odgovor coverage.status: not_covered. 1 enota. Glejte Finančni podatki.
• GET /v1/entities/{tax}?include=financials_latest: zadnji povzetek ob subjektu, +1 enota, ko ga vrnemo.
• Dostop po paketih: Free zadnje leto (povzetek), Starter 5 let (povzetek), Growth 10 let (vse postavke), Pro in višji tudi izvirne vrstice (include=items).
• Nove vrstice v obračunskih enotah; nov razred končne točke financials v porabi.
• MCP strežnik: orodje get_financials.

2026-10-20 · Novi paketi

• Namesto šestih paketov so štirje: Hobi (brezplačen; v API-ju in nadzorni plošči ostane koda free), Starter (15 € na mesec ali 150 € na leto), Growth (39 € ali 390 €) in Custom (po dogovoru, letna pogodba, račun in nakazilo). Paketi Pro, Business in Enterprise so ukinjeni; obstoječe naročnine Pro in Business so prešle na Custom z nespremenjenimi omejitvami.
• Mesečne kvote: Hobi 100 enot (največ 20 na dan), Starter 2.500, Growth 10.000. Hitrost: 1, 5 in 15 zahtev na sekundo. Fizične osebe (s.p.) na dan: 20, 200 in 1.000. Opazovani subjekti: Starter 50, Growth 500; paket Hobi jih ne vključuje (dodajanje vrne 403 plan_upgrade_required), zato na njem tudi ni obvestil po e-pošti. Skrivni ključi: 1, 3 in 10. Člani ekipe: 1, 3 in 10. Glej Omejitve.
• Paketno iskanje POST /v1/entities/lookup in orodje MCP lookup_entities sta na voljo od paketa Starter; na paketu Hobi vrneta 403 plan_upgrade_required (0 enot).
• Javni ključi mk_pub_ in webhooki so na voljo od paketa Starter. Vir sprememb in zgodovina ostaneta od paketa Growth.
• Finančni podatki AJPES: paket Hobi jih ne vključuje (končna točka, get_financials in include=financials_latest vrnejo 403 plan_upgrade_required), Starter zadnja 3 leta (povzetek), Growth in Custom vsa leta z vsemi postavkami in izvirnimi vrsticami (include=items). To nadomešča razdelitev iz vnosa »Finančni podatki«.
• Preseganje (samo mesečni obračun, vklopite ga sami): Starter 8 €, Growth 5 € na 1.000 enot. Dodatni paketi enot: Starter +2.500 enot za 12 €, Growth +10.000 enot za 39 €.
• Organizacije na paketu Hobi, ki že imajo opazovane subjekte, jih obdržijo na seznamu (lahko jih odstranijo), obvestil o njih pa ne prejemajo več. (dopolnjeno 2026-10-21)
• Obračunska pravila za enote so nespremenjena.
• Nove omejitve veljajo tudi za obstoječe naročnine Starter in Growth. (dopolnjeno 2026-10-21)

2026-10-21 · Neplačane naročnine in privzeti obsegi

• Ko plačilo naročnine ne uspe (Stripe stanje past_due, unpaid ali nedokončano plačilo obstoječe naročnine), API in MCP takoj vračata 402 payment_required s povezavo na obračun v nadzorni plošči; odloga do konca plačanega obdobja ni več. Nadzorna plošča deluje naprej, da lahko plačilo uredite, dostop pa se vrne takoj po uspešnem plačilu. Preizkuševalnik API-ja v nadzorni plošči v tem času prav tako vrača 402.
• Novi skrivni ključi imajo privzeto tudi obseg monitors. Obstoječi ključi so nespremenjeni. Glej Avtentikacija.

2026-10-21 · Poročila ESEF in dokumenti AJPES

• Velike družbe (banke, zavarovalnice, borzne in druge revidirane družbe), ki AJPES-u ne oddajo strukturirane tabele, imajo zdaj številke iz revidiranega letnega poročila ESEF (od poslovnega leta 2024). Glejte Finančni podatki.
• years[] ima nova polja: basis (standalone ali consolidated), source_format (ajpes_json ali esef) in consolidated (konsolidirani izkazi skupine za isto leto ali null). figures so še naprej posamični izkazi podjetja.
• provenance.basis ima novo vrednost consolidated; items pri poročilih ESEF uporablja ključe T:ifrs-full:… in P:ifrs-full:….
• Nov seznam documents: revidirana in konsolidirana poročila, ki jih AJPES objavlja le kot datoteke (PDF, ZIP), s povezavo na javno stran podjetja v AJPES JOLP.
• coverage.status ima novo vrednost documents_only, coverage pa novo polje detail_sl.
• Pravila paketov so nespremenjena (Hobi brez, Starter 3 leta povzetek, Growth in Custom vse postavke in include=items). Orodje MCP get_financials vrne isti objekt.

Načrtovano

• v1.2: podatki AJPES PRS (CC BY 4.0) in naslovi GURS.