Finančni podatki (AJPES)

GET /v1/entities/{tax_number}/financials vrne ključne postavke iz letnih poročil, ki jih podjetja oddajo AJPES (bilanca stanja in izkaz poslovnega izida), od najnovejšega leta naprej. AJPES jih objavlja pod licenco CC BY 4.0; vsaka številka ima naveden vir.

Za koga	kapitalske družbe (d.o.o., d.d., k.d.d., SE) in zadruge (z.o.o., z.b.o.), približno 78.000 podjetij, povezanih po matični številki
Nikoli	samostojni podjetniki (s.p.) in druge fizične osebe: coverage.status: not_covered, brez številk
Izkazi	posamični izkazi (figures); za velike družbe, ki oddajo poročilo ESEF, tudi konsolidirani izkazi skupine (consolidated)
Dokumenti	revidirana in konsolidirana poročila, ki jih AJPES objavlja le kot datoteke (PDF, ZIP), so v documents s povezavo na AJPES
Enote	1 na klic; include=financials_latest pri poizvedbi po subjektu +1, ko vrne podatke
Obseg ključa	entities:read
MCP	orodje get_financials vrne isti objekt (MCP)

curl "https://api.maticna.si/v1/entities/19000006/financials?years=3" \
  -H "Authorization: Bearer $MATICNA_KEY"

Odgovor

{
  "object": "financials",
  "tax_number": "19000006",
  "registration_number": "9000000010",
  "coverage": { "status": "available", "reason": null, "detail": "Annual-report figures published by AJPES.", "detail_sl": "Podatki iz letnih poročil, ki jih objavlja AJPES." },
  "currency": "EUR",
  "source": {
    "dataset": "ajpes_lp", "name": "AJPES – letna poročila", "name_en": "AJPES – annual reports", "publisher": "AJPES",
    "url": "https://www.ajpes.si", "licence": "CC-BY-4.0", "licence_url": "https://creativecommons.org/licenses/by/4.0/",
    "attribution": "Vir: AJPES (www.ajpes.si), CC BY 4.0; izračuni maticna.si", "attribution_required": true
  },
  "access": { "plan": "growth", "max_years": 10, "figures": "full", "items": true, "years_capped": false },
  "years": [
    {
      "year": 2025, "report_type": "01", "basis": "standalone", "source_format": "ajpes_json",
      "period_start": "2025-01-01", "period_end": "2025-12-31", "period_months": 12,
      "size_class": null, "currency": "EUR", "quality": "ok", "restated": false, "revision": 1,
      "figures": { "revenue": 1840210.55, "net_profit": 96340.12, "employees": 14.62, "total_assets": 1210400.0, "equity": 610220.4, "ebit": 121880.3, "…": "…" },
      "methods": { "revenue": "official", "net_profit": "official", "ebit": "derived", "…": "…" },
      "provenance": {
        "bilanca_stanja": {
          "dataset": "ajpes_lp", "source": "AJPES – letna poročila", "year": 2025, "statement": "bilanca_stanja",
          "report_type": "01", "basis": "standalone", "period_end": "2025-12-31", "published_on": "2026-04-15",
          "updated_on": null, "as_of": "2026-04-15", "fetched_at": "2026-10-20T03:12:44.000Z", "licence": "CC-BY-4.0",
          "licence_url": "https://creativecommons.org/licenses/by/4.0/",
          "attribution": "Vir: AJPES (www.ajpes.si), CC BY 4.0; izračuni maticna.si", "url": "https://www.ajpes.si", "method": "official"
        },
        "izkaz_poslovnega_izida": { "statement": "izkaz_poslovnega_izida", "…": "…" }
      },
      "consolidated": null
    }
  ],
  "documents": [],
  "as_of": "2026-04-15"
}

Polje	Pomen
coverage.status	available: vsaj eno leto s številkami. documents_only: AJPES poročila tega podjetja objavlja le kot dokumente (npr. revidirano poročilo v PDF), glej documents. no_reports: podjetje, ki ga AJPES pokriva, a objavljenega poročila še nismo naložili. not_covered: za tega zavezanca finančnih podatkov ni, glej reason
coverage.detail, detail_sl	razlaga v angleščini in slovenščini
coverage.reason	natural_person (s.p. in druge fizične osebe, nikoli jih ne vrnemo) ali legal_form_not_covered (npr. društva, zavodi, tuja podjetja)
years[]	od najnovejšega naprej. Le poročila, ki prestanejo spodnje kontrole
years[].figures	ključne postavke v EUR (employees: povprečno število zaposlenih na podlagi delovnih ur, 2 decimalki). null: ni poročano. Le postavke vašega paketa
years[].basis	izkazi, iz katerih so figures: standalone (posamični, podjetje samo) vedno, ko obstajajo; consolidated le pri skupini brez posamičnih izkazov
years[].source_format	ajpes_json: strukturirana tabela AJPES; esef: številke smo prebrali iz poročila ESEF (spodaj)
years[].consolidated	konsolidirani izkazi skupine za isto leto (ista oblika: figures, methods, provenance, items), ko jih poročilo ESEF vsebuje; sicer null
years[].methods	official: ena vrstica, kot jo je objavil AJPES, oziroma en označen pojem MSRP; derived: izračun maticna.si (formule spodaj)
years[].provenance	en žig na izkaz: vir, leto, izkaz, vrsta poročila, datum objave (published_on), datum popravka (updated_on), as_of (datum vira), fetched_at (kdaj smo podatke prevzeli), licenca in navedba vira
years[].period_months	manj kot 12 pri prvem, zadnjem ali spremenjenem poslovnem letu
years[].quality	ok ali warning, ko se čisti poslovni izid v bilanci razlikuje od izkaza poslovnega izida
years[].restated, revision	AJPES je poročilo po prvi objavi popravil; vrnemo zadnjo različico
years[].items	izvirne vrstice AJPES (T001…: tekoče leto, P001…: prejšnje leto) oziroma pri ESEF pojmi XBRL (T:ifrs-full:Revenue, P:… za prejšnje leto, v EUR), le z include=items
documents[]	dokumenti, ki jih AJPES objavlja za ista leta: leto, vrsta (report_type, doc_name: RLP, KLP, eRLP, eKLP), label in label_en, format (pdf, zip), velikost, datum objave, structured (številke smo prebrali iz njega) in url
access	kaj vaš paket vrne; years_capped: true, ko ste zahtevali več let, kot jih paket dovoli
as_of	najnovejši datum vira med vrnjenimi leti

Parametra: years (1–10, privzeto 5; omejeno s paketom) in include=items (izvirne vrstice).

Paketi

Paket	Leta	Postavke	Izvirne vrstice (include=items)
Hobi	ni vključeno (403 plan_upgrade_required, na voljo od paketa Starter)
Starter	zadnja 3 leta	povzetek: prihodki, čisti poslovni izid, zaposleni, sredstva, kapital	ne (403 plan_upgrade_required)
Growth	vsa leta	vseh 24 postavk	da
Custom	vsa leta	vseh 24 postavk	da

Vrednost years nad omejitvijo paketa ni napaka: dobite toliko let, kot jih paket vrne, in access.years_capped: true. Na paketu Hobi finančnih podatkov ni: končna točka, orodje MCP get_financials in include=financials_latest pri GET /v1/entities/{tax} vrnejo 403 plan_upgrade_required in ne porabijo enot.

Postavke in vrstice AJPES

AJPES objavi zoženi izbor podatkov iz vsakega poročila kot oštevilčene vrstice (T001–T089 za družbe). Številka vrstice ni oznaka AOP; ta je v oklepaju. Zadruge oddajo krajšo tabelo (vrstice 1–24 se ujemajo, kasnejše so zamaknjene za 2), zato jih preslikamo z njihovo tabelo.

Polje	Postavka	Izkaz	Metoda	Vrstica AJPES (AOP)
total_assets	Sredstva	bilanca stanja	uradno	T001 (001)
non_current_assets	Dolgoročna sredstva	bilanca stanja	uradno	T002 (002)
current_assets	Kratkoročna sredstva	bilanca stanja	uradno	T013 (032)
inventories	Zaloge	bilanca stanja	uradno	T015 (034)
receivables	Kratkoročne poslovne terjatve	bilanca stanja	uradno	T019 (048)
cash	Denarna sredstva	bilanca stanja	uradno	T020 (052)
equity	Kapital	bilanca stanja	uradno	T024 (056)
share_capital	Osnovni kapital	bilanca stanja	uradno	T026 (058)
provisions	Rezervacije in dolgoročne PČR	bilanca stanja	uradno	T034 (072)
long_term_liabilities	Dolgoročne obveznosti	bilanca stanja	uradno	T037 (075)
short_term_liabilities	Kratkoročne obveznosti	bilanca stanja	uradno	T041 (085)
financial_debt	Finančne obveznosti	bilanca stanja	izračun	T038 + T043 (076 + 087)
liabilities	Obveznosti (dolgoročne in kratkoročne; sredstva − kapital vključujejo še rezervacije)	bilanca stanja	izračun	T037 + T041
revenue	Čisti prihodki od prodaje	izkaz poslovnega izida	uradno	T047 (110)
operating_revenue	Kosmati donos iz poslovanja	izkaz poslovnega izida	izračun	T047 + T048 + T049 + T050 (AOP 126 ni objavljen)
operating_expenses	Poslovni odhodki	izkaz poslovnega izida	izračun	T051 + T054 + T059 + T063
ebit	Poslovni izid iz poslovanja (EBIT)	izkaz poslovnega izida	izračun	operating_revenue − operating_expenses
ebitda	EBITDA	izkaz poslovnega izida	izračun	ebit + depreciation (drugi odpisi niso prišteti)
depreciation	Amortizacija	izkaz poslovnega izida	uradno	T060 (145)
financial_income	Finančni prihodki	izkaz poslovnega izida	izračun	T064 + T065 + T066
financial_expenses	Finančni odhodki	izkaz poslovnega izida	izračun	T067 + T068 + T069
income_tax	Davek iz dobička	izkaz poslovnega izida	uradno	T072 (184)
net_profit	Čisti poslovni izid (s predznakom)	izkaz poslovnega izida	uradno	T074 (186 − 187)
employees	Povprečno število zaposlenih (na podlagi delovnih ur)	izkaz poslovnega izida	uradno	T075 (188)

Poročila ESEF (velike družbe)

Banke, zavarovalnice, borzne družbe in drugi zavezanci za revizijo AJPES-u ne oddajo strukturirane tabele, ampak revidirano in konsolidirano letno poročilo. Za leta do 2023 je to PDF, od leta 2024 pa paket ESEF (ZIP z datoteko XHTML, označeno z Inline XBRL po taksonomiji MSRP/IFRS). Paket preberemo sami:

• vzamemo le poročevalsko obdobje, ki ga navaja AJPES, in prejšnje leto (P:), nič drugega;
• konteksti brez dimenzij so skupina (konsolidirano), kontekst z ifrs-full:SeparateMember je podjetje samo (posamično); če poročilo posamičnih izkazov ne označi, je podjetje samo, razen če ga AJPES objavlja kot konsolidirano poročilo;
• zneske preračunamo v evre (upoštevamo scale, sign in zapis števil), druge dimenzije (sestavine kapitala, neobvladujoči deleži) in zneske v drugih enotah izpustimo;
• kontrola: sredstva = kapital + obveznosti (± 0,1 %); poročil, ki je ne prestanejo, ne vrnemo.

Polje	Pojem MSRP (ifrs-full:)	Metoda
total_assets	Assets	uradno
non_current_assets, current_assets	NoncurrentAssets, CurrentAssets	uradno
inventories	Inventories	uradno
receivables	TradeAndOtherCurrentReceivables (sicer CurrentTradeReceivables)	uradno
cash	CashAndCashEquivalents	uradno
equity, share_capital	Equity, IssuedCapital	uradno
provisions	Provisions (sicer vsota postavk rezervacij)	uradno ali izračun
long_term_liabilities, short_term_liabilities	NoncurrentLiabilities, CurrentLiabilities	uradno
financial_debt	NoncurrentFinancialLiabilities + CurrentFinancialLiabilities (sicer posojila)	izračun
liabilities	Liabilities (vključno z rezervacijami; sicer dolgoročne + kratkoročne, sicer sredstva − kapital)	uradno ali izračun
revenue	Revenue (sicer RevenueFromContractsWithCustomers; banke ga nimajo)	uradno
ebit	ProfitLossFromOperatingActivities	uradno
ebitda	ebit + depreciation	izračun
depreciation	DepreciationAndAmortisationExpense (sicer amortizacija + odpisi vrednosti)	uradno ali izračun
financial_income, financial_expenses	FinanceIncome, FinanceCosts	uradno
income_tax	IncomeTaxExpenseContinuingOperations	uradno
net_profit	ProfitLoss	uradno
employees	le, če ga poročilo označi	uradno
operating_revenue, operating_expenses	ni ustreznice v MSRP (null)

Postavke po MSRP niso povsem enake postavkam slovenske tabele (npr. liabilities vključuje rezervacije), zato primerjava med podjetji iz različnih virov ni neposredna. Vir je v source_format in v report_type (72 revidirano, 73 konsolidirano letno poročilo).

Dokumenti in povezava na AJPES

Leta, ki jih AJPES objavlja le kot dokumente (npr. revidirano poročilo v PDF za leta do 2023), so v documents. Povezava za prenos v API-ju AJPES zahteva naš ključ, zato je url javna stran podjetja v aplikaciji JOLP (https://www.ajpes.si/jolp/podjetje.asp?maticna=…). AJPES tam zahteva prijavo (brezplačna registracija ali vstop kot anonimni uporabnik) in dovoli ogled največ 20 podjetij na dan. Dokumentov ne posredujemo naprej.

Pokritost in leta

• Podjetja: AJPES objavlja strukturirana letna poročila kapitalskih družb in zadrug. Z registrom FURS jih povežemo po matični številki; podjetja brez matične na seznamih FURS ne moremo povezati.
• Leta: AJPES za vsako podjetje ponuja tekoče in pet preteklih let. Podjetja oddajo poročilo do 31. marca, objava sledi od aprila. Vsako naloženo leto hranimo, zato zgodovina ne izgine, ko se okno pri AJPES premakne.
• Nalaganje: poročila nalagamo postopoma in jih vsako noč osvežimo v okviru omejitev AJPES. Pokrito podjetje, katerega poročila še niso naložena, vrne coverage.status: no_reports.
• Kontrole: vsako poročilo mora biti uravnoteženo (sredstva = obveznosti do virov sredstev, sredstva = vsota delov), prihodki in število zaposlenih ne smejo biti negativni. Poročil, ki kontrol ne prestanejo, in poročil s samimi ničlami ne vrnemo. Banke in zavarovalnice strukturirane tabele nimajo: njihove številke so iz poročil ESEF (od 2024), starejša leta so v documents.
• Popravki: ko AJPES poročilo popravi, vrnemo novo različico z restated: true in višjim revision.
• Osebni podatki: samo številke. Dokumentov PDF in besedilnih pojasnil iz poročil ne objavljamo; na dokumente le povežemo (AJPES JOLP).

Navedba vira (CC BY 4.0): vaša obveznost

Podatki so last AJPES in so objavljeni pod licenco CC BY 4.0. Če številke prikažete ali posredujete naprej (v aplikaciji, poročilu, preglednici, odgovoru AI asistenta), ob njih ohranite navedbo vira:

Vir: AJPES (www.ajpes.si), CC BY 4.0; izračuni maticna.si

• navedite vir (AJPES, s povezavo na www.ajpes.si),
• povežite licenco (creativecommons.org/licenses/by/4.0),
• označite, da so nekatere postavke izračunane: methods označi vsako postavko, ki smo jo izračunali (»izračuni maticna.si«).

Polje source.attribution in vsak žig v provenance vsebujeta to besedilo, zato ga lahko izpišete takšnega, kot je. Pogoj postavlja licenca, ne mi: velja za vsakogar, ki podatke ponovno uporabi, tudi za vaše stranke.

Napake

Status	Koda	Kdaj
403	plan_upgrade_required	include=items pod paketom Growth (0 enot)
404	not_found	pravilno oblikovana davčna številka, ki je ni na seznamih FURS (1 enota, kot pri poizvedbi)
422	invalid_tax_number	napačna kontrolna števka (0 enot)
400	bad_request	years zunaj 1–10 ali neznana vrednost include (0 enot)

Samostojni podjetnik (s.p.) ni napaka: odgovor je 200 s coverage.status: not_covered, reason: natural_person, years: [] in brez matične številke. Stane 1 enoto in šteje v dnevno omejitev fizičnih oseb, enako kot poizvedba.