Partner felvétele és adatlapja – rendszerleírás
A partner-mentés lépései: validáció, kvóta, client-hozzárendelés, személyek és aláírók, adóhatósági és integrációs adatok, bankszámlák; a csempék végpontjai.
A partner felvétele és módosítása egyetlen mentő végponton fut; a csempék (cím, bankszámla, személy, tárhely-szabály) saját AJAX-végpontokat használnak. A mentés nem irányít át, az új azonosítót adja vissza.
Adatmodell
A táblanevek a telepítés saját előtagjával állnak az adatbázisban.
| Tábla | Szerep |
|---|---|
company | partner |
permission_scope | a létrehozó tartalmi joga |
subscription_account | a felhasználó házi clientje |
person_company | személyek, szerep, aláíró-jelölés |
nav | adóhatósági technikai user és kulcsok |
user_api_key, company_auth | QUiCK API-kulcs |
foxpost | FoxPost-fiók |
company_bankaccount, bankaccount | bankszámlák |
company_objstorage | objektum-típusonkénti tárhely-szabály (local / gdrive / onedrive) |
Mentés lépései
- Jog:
canSave(company, id)– 0 eseténadd(ha nincsaddsor, azeditdönt), meglévőnéleditéscompanyInScope(). - Validáció: név 1–255; 8 jegyű adószám-törzs pontos egyezés-dedup (
getCompanyIdByTaxhu8); statisztikai számjel üres vagy 17 számjegy. - Új partnernél kvóta:
Dlbtquota::checkAction(user, company, add);need_credit/need_planesetén hiba és ajánló-adat.addCompany(), a létrehozónak tartalmi jog (grantCompanyScopeToCreator); ha van házi clientje, az új cég annak előfizetés-gazdájához kerül (assignToOwner), különben az új cég lesz a házi clientje (attachUserToClient); sikeres mentés után kvóta-fogyasztás (consumeAction). - Személyek (
masterdata/personeditjoggal): csak hozzáadás; szerepek, majd a teljes aláíró-kör egy lépésben (setCompanySignatories). navapijoggal: adóhatósági sor (törlés + újraírás, csak technikai userrel), QUiCK API-kulcs (üres = változatlan, külön jelölővel törölhető), FoxPost-fiók.- Bankszámlák:
saveCompanyBankaccounts, normalizálva. DB-hibaDB: …formában.
A form végpontjai
checkduplicate(edit): adószám pontos törzsszám; név: azonos nevű aktív cég, csak figyelmeztetés.autocomplete(list),companygroup(list, hatókör-szűrt),companygroupadd(edit).addresslist/addresssave/addressdelete(list/edit, hatókör; irányítószám- és ország-validáció).bankidentify(edit): normalizálás és bank-azonosítás (GIRO / openiban);bankaccounts(list);syncAddresses,syncBankaccounts(edit).persontile(list+ személylist; szerkeszthetőség személyedit-tel);statements(kivonat-dokumentumok, max. 50).objstoragelist/objstoragesave/objstoragedelete(edit+ hatókör); a régi Drive- és helyi mappa-útvonalak vékony továbbítások a dokumentumtár kanonikus tárhely-végpontjaira.
Jogosultság
Funkciójogok: add (nincs a katalógusban; a fejléc gombja), edit, navapi; kapcsolódó: masterdata/person edit, mail/notify list, document/document list. A taxpayerupdate nem ellenőriz hatókört.