Stručne
- Odpovedáme z registra platiteľov DPH Ministerstva financií ČR, ktorého sa pýtame naživo pri každej požiadavke.
- Vraciame, či je subjekt platiteľom, či je nespoľahlivým platiteľom a ktoré bankové účty má zverejnené.
- Keď register neodpovedá, vrátime 503 — nikdy „nie je platiteľ“.
- Rodné číslo českého živnostníka, ktoré je zároveň jeho DIČ, nevraciame ani neukladáme.
- Vydavateľ
- Ministerstvo financí České republiky (register platiteľov DPH)
- Aktuálnosť
- naživo; register sa aktualizuje raz za noc
- Zoznam nespoľahlivých platiteľov
- čítame denne o 4:45 UTC pre sledovanie zmien
- Endpoint
- /vat/verify/{identifier} — české DIČ, alebo IČO českej firmy
Na čo odpovedá
- Je český subjekt platiteľom DPH, alebo len identifikovanou osobou.
- Je vedený ako nespoľahlivý platiteľ — a od kedy.
- Ktoré bankové účty má v registri zverejnené. Platba na iný účet môže znamenať ručenie za DPH.
- Či ide o člena skupiny DPH.
curl https://api.apino.sk/api/v1/vat/verify/CZ27082440 \
-H "Authorization: Bearer $APINO_KEY"Na čo si dať pozor
- Register má každú noc krátku odstávku okolo polnoci pražského času. Odpoveď 503 s hlavičkou Retry-After znamená „skúste neskôr“, nie záporný výsledok.
- Pri fyzickej osobe je DIČ rodné číslo. Pri dopyte podľa IČO ho nevrátime; uvidí ho len ten, kto ho sám zadal.
- Nový zápis sledovanej firmy medzi nespoľahlivých platiteľov príde ako udalosť vat_unreliable_payer.