Obračunske enote

Kvote in cene so izražene v enotah. Spodnja pravila so ista, kot jih uporablja naš števec. Ko se spremenijo, je sprememba zapisana v dnevniku sprememb.

Mesečne kvote po paketih: Hobi 100 enot (največ 20 na dan), Starter 2.500, Growth 10.000, Custom po dogovoru. Ko jih porabite, dobite 429 quota_exceeded. Na paketih Starter in Growth lahko kupite dodatni paket enot (Starter +2.500 enot za 12 €, Growth +10.000 enot za 39 €) ali vklopite preseganje (samo mesečni obračun; Starter 8 €, Growth 5 € na 1.000 enot), z zgornjo mejo v evrih. Paketno iskanje (POST /v1/entities/lookup) in finančni podatki AJPES (tudi include=financials_latest) so na voljo od paketa Starter; na paketu Hobi vrnejo 403 plan_upgrade_required in ne porabijo enot.

Primer	Enote
Uspešen (2xx) odgovor: iskanje po ID-ju, preverjanje DDV ali davčne, stran iskanja, stran sprememb, zgodovina subjekta	1
404 za pravilno oblikovan identifikator (veljavna kontrolna vsota, ni v registru)	1. »Ne obstaja« je del produkta.
Finančni podatki (GET /v1/entities/{tax}/financials), tudi ko je odgovor »ni podatkov« (s.p., poročilo še ni naloženo)	1
include=financials_latest pri GET /v1/entities/{tax}	+1, ko povzetek vrnemo; 0, ko je null
Samodokončanje	0,25. Priporočamo zakasnitev 150–250 ms.
Paketno iskanje (od paketa Starter)	1 za vsak različen pravilno oblikovan ID, tudi če ni najden
304 Not Modified	0
400 / 401 / 402 / 403 / 409 / 422 / 429	0. Neveljavne kontrolne vsote zavrnemo pred bazo.
5xx	0
Preizkuševalnik API-ja v nadzorni plošči (brezplačen, omejen na ~20 zahtev/min); /meta, /reference, /usage, openapi.json	0
POST, ponovljen z istim Idempotency-Key v 24 urah	0
Dostave webhookov; upravljanje opazovanih subjektov in končnih točk	0. Obračunane prek števila opazovanih subjektov.
Izvozi (paket Custom)	Del pogodbe

Izvirnik (angleško)

Case	Units
2xx lookup, VAT or tax-number validation, search page, changes page, entity history	1
404 on a well-formed lookup (valid checksum, not in the registry)	1. "Does not exist" is the product.
Financial statements (GET /v1/entities/{tax}/financials), also when the answer is "no financials" (s.p., no report yet)	1
include=financials_latest on GET /v1/entities/{tax}	+1 when a summary is returned; 0 when it is null
Autocomplete	0.25. Docs advise a 150–250 ms debounce.
Bulk lookup	1 per distinct well-formed ID, including not-found
304 Not Modified	0
400 / 401 / 402 / 403 / 409 / 422 / 429	0. Invalid checksums are rejected before the DB.
5xx	0
Dashboard API tester (free, rate-limited); /meta, /reference, /usage, openapi.json	0
POST retried with the same Idempotency-Key within 24 h	0
Webhook deliveries; managing monitors and webhook endpoints	0. Priced by monitored-entity slots.
Exports	Plan flat fee

Primeri

• Paketno iskanje ["19000006", "SI19000006", "12345679", "9000000000"]: 19000006 in SI19000006 sta ista davčna številka (1 enota), 12345679 ima napačno kontrolno vsoto (0 enot, vnos ima error), matična je še 1. Skupaj 2 enoti.
• Iskanje s tremi stranmi rezultatov: 3 enote. Če tretja vrne 409 cursor_expired: 2 enoti.
• GET /v1/entities/19000006?include=financials_latest za d.o.o. z objavljenim poročilom: 2 enoti; za s.p. (financials_latest: null): 1 enota.
• 20 znakov, natipkanih v polje s samodokončanjem z zakasnitvijo 200 ms, običajno sproži 3–5 zahtev: 0,75–1,25 enote.

Enote se zaokrožijo navzgor na celo število na koncu obračunskega obdobja.

Preizkuševalnik API-ja

Zahteve iz preizkuševalnika v nadzorni plošči tečejo na pravih podatkih, a ne porabijo enot in niso obračunane. Omejene so na približno 20 zahtev na minuto na uporabnika in na organizacijo, paketno iskanje v preizkuševalniku pa na 10 ID-jev. Dnevna omejitev fizičnih oseb (s.p.) velja tudi zanje. Ločenih testnih ključev ni več: vsak skrivni ključ je obračunan po zgornjih pravilih.