Adószám-ellenőrzés – rendszerleírás

Az adóhatósági és VIES-lekérdezés végpontjai, az ellenőrzési napló, a kontextusos validáció gyorsítótára, a tömeges újraellenőrzés és a bankszámla-import.

A partner-modul adóhatósági (queryTaxpayer XML) és VIES-ellenőrzést végez, az eredményt audit-sorként naplózza és a partner érvényességébe írja. Kiegészítő végpontok a számlákból veszik át a címeket és bankszámlákat.

Adatmodell

A táblanevek a telepítés saját előtagjával állnak az adatbázisban.

Tábla	Szerep
`company_validation`	ellenőrzési napló (pl. `check_type = nav_taxpayer`)
`company`, `company_address`, `address`	érvényesség, címek
`invoice_ctrl`	számla-vezérlő adatok (címek, bankszámlák forrása)
`bankaccount`, `company_bankaccount`	bankszámlák

Végpontok

querytaxpayer: 8 számjegyű adószámmal adóhatósági hívás (nav/xml modell); a hitelesítő adatokat a fix 10-es azonosítójú cég adóhatósági sorából veszi; visszaadja a nevet, rövid nevet, teljes adószámot, csoportos áfa-azonosítót, címeket, érvényességet; hatókörbe eső cégnél rögzíti az érvényességet (updateValidity) és audit-sort ír.
queryvies: VIES-ellenőrzés cURL-lel; elérhetetlenségnél hiba.
taxpayercompare: mezőnkénti összevetés (név, rövid név, adószám, székhely) a taxpayerupdate URL-jével; taxpayerupdate (edit): a kiválasztott mezők átírása, opcionálisan a székhely beszúrása.
validate: adószám és opcionális VIES kontextussal (manual/cron/pre_invoice/pre_contract/pre_bank); nem kézi kontextusban a korábbi érvényes validációt gyorsítótárként használja; audit, érvényesség, címszinkron (syncCompanyAddresses).
revalidatestale: info=1 → a nem ellenőrzött / érvénytelen partnerek stabil listája (findStaleCompanies); POST ids[] → egy köteg (revalidateIds, manual), a library a hatókörre szűkít.
importinvoicebanks: info=1 → feldolgozandó sorok száma; egyébként start/limit (alap 200) kötegben importInvoiceBankaccounts() a hatókörbe eső szállítókra.
syncinvoice: syncFromInvoiceCtrl() címeket ad hozzá, bankszámlákat normalizálva, dedup-pal köt (saveBankaccountForCompany); összegzés.

Jogosultság

Funkciójogok: taxpayer, revalidate, import_banks, sync_invoice; hatókör: validate, az érvényesség-írás és a syncinvoice companyInScope-pal.
Előfeltétel: adóhatósági technikai felhasználó; VIES-hez kimenő HTTP.

Ismert korlátok

A csoportos adóhatósági frissítés (taxpayer végpont) törzse ki van kommentezve; mindig sikert ad „- teszt” utótaggal.
A taxpayercompare és a taxpayerupdate nem ellenőriz hatókört.
A hitelesítő adatok forrása fix azonosító.

Kapcsolódó témák: adószám-ellenőrzés bankszámla

Konzultáció kérése Vissza a főoldalra