Odoo 19 Community․ Firmenbuch և հասցեների ստուգում ավստրիացի հաճախորդների համար՝ մեր բաց կոդով partner_firmenbuch_at մոդուլը

Ով Ավստրիայում գործարար գործունեություն է ծավալում, գիտի այս հարցերը․ Ճի՞շտ են արդյոք իմ նոր հաճախորդի ընկերության անվանումը և հասցեն։ Ընկերությունը դեռ Firmenbuch-ո՞ւմ է, թե՞ լուծարման փուլում է։ Արդյո՞ք սնանկության վարույթ է հարուցվել մի հաճախորդի նկատմամբ, որին արդեն երկու տարի է՝ մատակարարում եմ։ Պատասխանները գտնվում են Արդարադատության նախարարության Firmenbuch-ում, բայց հազվադեպ է՝ ինչ-որ մեկը կանոնավոր կերպով այնտեղ նայում։ Odoo-ում կոնտակտը ստեղծվում է մեկ անգամ, իսկ հետո այն հնանում է։

Դրա համար մենք մշակել ենք Firmenbuch for Partners (partner_firmenbuch_at) մոդուլը։ Այն կապում է Odoo-ի կոնտակտները Firmenbuch-ի և BEV-ի պաշտոնական հասցեների ռեգիստրի հետ։ Այն գրված է Odoo 19-ի համար և որպես ազատ ծրագրային ապահովում՝ LGPL-3 լիցենզիայով, անվճար հասանելի է GitHub-ում՝

github.com/Alex0176/odoo-partner-firmenbuch-at

Խնդիրը․ հիմնական տվյալներ, որոնց ոչ ոք չի հոգում

Odoo-ում կոնտակտը սովորաբար ստեղծվում է ժամանակի սղության պայմաններում․ անուն, մոտավոր հասցե, հնարավոր է՝ UID։ Սա բավարար է առաջին առաջարկի համար։ Բայց դա բավարար չէ հաշիվ-ապրանքագրերի համար, որոնք իրավաբանորեն ճիշտ պետք է հասցեագրված լինեն, և հատկապես՝ նկատելու համար, որ հաճախորդի մոտ ինչ-որ բան փոխվել է։ Գործնականում երևում են չորս բացթողումներ․

• Թերի հիմնական տվյալներ։ Firmenbuch-ի համարը, դատարանը և իրավական ձևը գրեթե միշտ բացակայում են, քանի որ որոնումը ձեռքի աշխատանք է։
• Սխալ գրություններ։ Ընկերության անվանումը՝ առանց իրավական ձևի, տառասխալներ փողոցում կամ քաղաքում, փոխարինված փոստային ինդեքս։ Դա նկատվում է միայն այն ժամանակ, երբ նամակը հետ է գալիս։
• Հսկողություն չկա։ Եթե դատարանը սնանկության վարույթ է հարուցում կամ հաճախորդը լուծարում է իր ընկերությունը, Odoo-ն այդ մասին ոչինչ չի իմանում։ Վաճառքի բաժինը շարունակում է մատակարարել՝ հաշիվ-ապրանքագրով։
• Ցրված աղբյուրներ։ Firmenbuch-ը, տարեկան հաշվետվությունները և հասցեների ռեգիստրը գտնվում են տարբեր տեղերում։ Ով ցանկանում է դրանք ստուգել, տվյալները ձեռքով պատճենում է զննարկիչի պատուհանների միջև։

Ինչ է անում մոդուլը

1. Նոր ընկերությունները որոնվում են։ Երբ ինչ-որ մեկը կոնտակտ է ստեղծում որպես ընկերություն (երկիր՝ Ավստրիա կամ դատարկ), մոդուլը մի քանի րոպեի ընթացքում որոնում է Firmenbuch-ում։ Եթե կա ճիշտ մեկ համընկնում, դատարկ դաշտերը լրացվում են․ փողոց, փոստային ինդեքս, քաղաք, երկիր, Firmenbuch-ի համար, դատարան և իրավական ձև։
2. Շեղումները առաջարկվում են, երբեք չեն վերագրվում։ Եթե կոնտակտում գրված է մի բան, իսկ ռեգիստրում՝ այլ, ստեղծվում է փոփոխության առաջարկ, որը աշխատակիցը հաստատում է յուրաքանչյուր դաշտի համար առանձին։
3. Firmenbuch-որոնում կոնտակտում։ Firmenbuch ներդիրում որոնումը գտնում է ընկերություններ ըստ անվան, նույնիսկ եթե ավտոմատ համընկնումը միանշանակ չի եղել։
4. Ամենօրյա հսկողություն։ Մոդուլը ամեն օր հարցնում է, թե որ ընկերությունները և փաստաթղթերը (Urkunden) են փոխվել ռեգիստրում, և ստուգում է առնչվող հաճախորդներին։ Բացի այդ, կարգավորվող ընդմիջումներով յուրաքանչյուր ընկերություն ամբողջությամբ նորից ստուգվում է։
5. Նախազգուշացման մակարդակներ։ Հարուցված սնանկության և առողջացման վարույթները (ռեգիստրի իրավական փաստերից), լուծարումը, ջնջումը, բացասական սեփական կապիտալը և սեփական կապիտալի ցածր մասնաբաժինը ճանաչվում են և դառնում տեսանելի կոնտակտում։
6. Հասցեների ստուգում։ Ավստրիական հասցեները ստուգվում են տեղում՝ Չափագրության և գեոդեզիայի դաշնային գրասենյակի (BEV) պաշտոնական հասցեների ռեգիստրի դեմ։
7. Ռեգիստրի տվյալները կոնտակտում։ Դատարանը, իրավական ձևը, գործադիր տնօրենները և իրավական փաստերը գտնվում են Firmenbuch ներդիրում։ Դրանք արտացոլում են ռեգիստրը և թարմացվում են անմիջապես։
8. Ծանուցումներ միայն ներսում։ Բոլոր հաղորդագրությունները գնում են Firmenbuch ներքին Discuss ալիք և կոնտակտի Chatter։ Շատ ընկերությունների ստուգման մեկ գործարկումը ստեղծում է մեկ ամփոփ հաղորդագրություն՝ յուրաքանչյուր ընկերության համար առանձին հաղորդագրության փոխարեն։ Հաճախորդներին մոդուլը երբեք ոչինչ չի ուղարկում։

Առաջարկներ՝ վերագրելու փոխարեն

Պաշտոնական տվյալները ավտոմատ չէ, որ ձեր բիզնեսի համար ավելի լավ տվյալներ են․ հնարավոր է՝ կոնտակտում միտումնավոր նշված է առաքման հասցեն, հնարավոր է՝ ներդրված է կարճ անվանում։ Այդ պատճառով մոդուլը առկա արժեքները երբեք ինքնուրույն չի փոխում։ Այն միայն լրացնում է դատարկ դաշտերը և շեղումների դեպքում ստեղծում է առաջարկ։

Կոնտակտներ → Firmenbuch → Firmenbuch-ի առաջարկներ բաժնում յուրաքանչյուր դաշտի համար տեսնում եք ընթացիկ արժեքը և ռեգիստրի արժեքը։ Այն դաշտերը, որոնք չեք ուզում ընդունել, թողեք չնշված։ Ընդունել ընտրվածները-ով գրվում են միայն նշված դաշտերը, Մերժել-ով առաջարկը կորցնում է ուժը։ Նոր առաջարկը փոխարինում է նույն կոնտակտի ավելի հին բաց առաջարկները, որպեսզի հնացած արժեքներ չկիրառվեն։

Նախազգուշացումներ․ սնանկություն, լուծարում, հաշվեկշիռ

Մոդուլը տարբերակում է երեք մակարդակ․

• Աննկատ․ Հաղորդելու ոչինչ չկա։
• Նախազգուշացում (դեղին)․ Ռեգիստրում կան գործող գրառումներ լուծարման, ցրման, գույքի իրացման, ջնջման կամ միաձուլման մասին, ընկերությունը նշված է որպես ջնջված, կամ նախորդ սնանկության վարույթը վերջին տարիներին կասեցվել է (լռելյայն՝ երեք տարի, կարգավորվող)։ Կամ տարեկան հաշվետվությունը ցույց է տալիս բացասական սեփական կապիտալ, 8 %-ից ցածր սեփական կապիտալի մասնաբաժին (լռելյայն արժեքը հիմնված է URG-ի § 23-ի վրա, կարգավորվող), տարեկան վնաս կամ շրջանառության 25 % և ավելի անկում։
• Կրիտիկական (կարմիր)․ Սնանկության, սնանկացման կամ առողջացման վարույթ հարուցված է և դեռ չի կասեցվել, կամ դիմումը մերժվել է ծախսերը ծածկող գույքի բացակայության պատճառով։ Վերջինս համարվում է վճարունակության բացակայություն։

Կոնտակտում հայտնվում է գունավոր պաստառ, կոնտակտների ցանկում՝ նշում, իսկ որոնման մեջ կան Firmenbuch-ի նախազգուշացում և Firmenbuch կրիտիկական զտիչներ։ Եթե հաճախորդը դառնում է կրիտիկական, պատասխանատու վաճառողը (նրա բացակայության դեպքում՝ ադմինիստրատորը) ստանում է Firmenbuch․ ստուգել հաճախորդներին գործունեությունը, իսկ Firmenbuch ալիքը ստանում է հաղորդագրություն։

Իրավական փաստեր։ Սնանկության վարույթները ռեգիստրում գրված չեն ընկերության տեքստում, այլ իրավական փաստերի տեսքով՝ ամսաթվով, գործի համարով և դատարանով։ Մոդուլը կարդում է դրանք, հարուցումը և կասեցումը վերագրում է նույն գործի համարին և ցույց է տալիս դրանք կոնտակտում որպես ցանկ։ Այսպես կասեցված վարույթը մի քանի տարի հետո մնում է որպես տեղեկատվություն, իսկ ընթացողը՝ կարմիր է։

Տարեկան հաշվետվություններ։ Եթե վերջին տարեկան հաշվետվությունը առկա է XML-ով, մոդուլը կարդում է սեփական կապիտալը, տարեկան արդյունքը, հաշվեկշռի գումարը և շրջանառությունը և հաշվարկում է սեփական կապիտալի մասնաբաժինը, շրջանառության փոփոխությունը և UGB-ի § 221-ի համաձայն չափի դասը (նաև միկրոընկերությունները)։ Փոքր ընկերությունները պարտավոր չեն հրապարակել իրենց շրջանառությունը, այդ դեպքում մոդուլը այն չի ցույց տալիս։ Նրանց արդյունքը այն ստանում է հաշվեկշռային շահույթից՝ հանած փոխանցված շահույթը, և նշում է որպես գնահատական։ Որոնվող հոդվածների անվանումները կարգավորվող են, քանի որ XML-ը կառուցված է տարբեր ձևաթղթերում տարբեր կերպ։

Հասցեների ստուգում BEV հասցեների ռեգիստրով

BEV-ը հասցեների ռեգիստրը տրամադրում է որպես բաց տվյալներ (Adresse Relationale Tabellen – Stichtagsdaten, տարին երկու անգամ նոր ամսաթվով, անվճար օգտագործելի՝ աղբյուրը նշելով)։ Մոդուլը քաշում է քաղվածքը պաշտոնական INSPIRE-ATOM ծառայության միջոցով, մոտ 120 ՄԲ՝ մոտ 2,5 միլիոն հասցեով, և ներմուծում է այն սեփական, թեթև աղյուսակների մեջ։

Դրանից հետո փողոց ունեցող յուրաքանչյուր ավստրիական ընկերության հասցե ստեղծելիս և ամեն փոփոխության ժամանակ ստուգվում է տեղում՝ փոստային ինդեքս, փողոց, տան համար, քաղաք և դաշնային երկիր։ Ոչ մի հասցե որևէ ծառայության չի ուղարկվում։ Արդյունքը երևում է որպես նշան հասցեի տակ․

• Վավեր․ Հասցեն ռեգիստրում այդպես կա։
• Տան համարն անհայտ է․ Փողոցը և քաղաքը ճիշտ են, տան համարը՝ ոչ։
• Առաջարկված է ուղղում․ Տառասխալ փողոցում կամ քաղաքում, սխալ փոստային ինդեքս։ Ուղղումը պատրաստ է որպես առաջարկ։
• Չի գտնվել․ Ռեգիստրը այս հասցեն չի ճանաչում։

Դատարկ դաշնային երկիրը լրացվում է անմիջապես։ Կոնտակտների մասնավոր հասցեները (տիպ՝ Մասնավոր հասցե) չեն ստուգվում։ © Österreichisches Adressregister, Stichtagsdaten vom … աղբյուրի նշումը ընթացիկ ամսաթվով գտնվում է կարգավորումներում։ Թարմացումը աշխատում է շաբաթական, բայց քաշում է միայն այն դեպքում, երբ BEV-ը ավելի նոր ամսաթվով տվյալներ է հրապարակել։

Տեխնիկական իրականացում

Մուտքը ռեգիստր

Արդարադատության նախարարությունը Firmenbuch-ը տրամադրում է FBW-WebServices-ի (HVD) միջոցով JustizOnline-ում՝ որպես SOAP ինտերֆեյս։ Մուտքն անվճար է, բայց պահանջում է API բանալի, որը ID Austria-ով հայցվում է Informationsweiterverwendung բաժնում։ Բանալին փոխանցվում է X-API-KEY HTTP վերնագրով։ Մոդուլը ծառայությունն օգտագործում է անմիջապես՝ առանց screen-scraping-ի։

models/firmenbuch_client.py կլիենտը մաքուր Python է՝ առանց Odoo-ից կախվածության։ Այն ճանաչում է SUCHEFIRMAREQUEST, AUSZUG_V2_REQUEST, SUCHEURKUNDEREQUEST, URKUNDEREQUEST, ինչպես նաև VERAENDERUNGENFIRMAREQUEST և VERAENDERUNGENURKUNDEREQUEST հարցումները։ Դրա շնորհիվ այն կարելի է թեստավորել պահպանված պատասխաններով։ Հարցումները ուղարկվում են 0,3 վայրկյան ընդմիջումով, փոփոխությունների հարցումները՝ յոթ օրվա բլոկներով։

Քաղվածքի մշակումը

Քաղվածքից օգտագործվում են միայն դեռ վավեր գրառումները (AUFRECHT ատրիբուտը՝ ոչ false)։ Անունը վերցվում է FI_DKZ02 տվյալների նշանից, հասցեն՝ FI_DKZ03-ից, նստավայրը՝ FI_DKZ06-ից, իրավական ձևը՝ FI_DKZ07-ից։ Դրանց գումարվում են դատարանը, վեբ հասցեն, ներկայացուցչության իրավունք ունեցող անձինք և իրավական փաստերը։ Նախազգուշացման մակարդակի համար բոլոր վավեր գրառումների տեքստերում որոնվում են կարգավորվող բանալի բառեր․

DEFAULT_CRITICAL = "Konkursverfahren, Insolvenzverfahren, Sanierungsverfahren, Konkurs eröffnet, ..."
DEFAULT_WARNING  = "Liquidation, aufgelöst, Auflösung, Abwicklung, Löschung, gelöscht, Verschmelzung, in Liqu."

Բանալի բառերի ստուգման առավելությունը․ այն աշխատում է անկախ այն բանից, թե ռեգիստրը որ դաշտում է գրանցում տվյալ գործընթացը։ Թերությունը նշված է Սահմանափակումներ բաժնում։

Հսկողություն

Մոդուլը ստեղծում է երեք պլանավորված գործողություն․

• Նոր ընկերությունների որոնում (յուրաքանչյուր 10 րոպեն մեկ, մեկ գործարկման ընթացքում մինչև 20 կոնտակտ)։ Բացի այդ, այն անմիջապես գործարկվում է ստեղծման պահին։
• Ընկերությունների հսկողություն (ամեն օր 04:30)։ Հարցնում է վերջին գործարկումից ի վեր փոփոխված ընկերությունները և փաստաթղթերը (առավելագույնը 30 օր հետ), ստուգում է առնչվող հաճախորդներին, ապա մինչև 50 հաճախորդի, որոնց վերջին ստուգումը ավելի վաղ է եղել, քան սահմանված ժամկետը։ Յուրաքանչյուր ընկերություն պահպանվում է առանձին գործարքում, որպեսզի սխալը նախորդ արդյունքները չկորցնի։ Գործարկման արդյունքը ալիք է հասնում որպես մեկ ամփոփ հաղորդագրություն։
• Հասցեների ռեգիստրի թարմացում (շաբաթական 03:15)։

API բանալու բացակայության դեպքում առաջին երկուսը անմիջապես ավարտվում են։ Յուրաքանչյուր ընկերության համար ստուգիչ գումարը թույլ չի տալիս անփոփոխ քաղվածքները նորից մշակել։

Հասցեների ռեգիստրը

BEV-ի տվյալները գտնվում են երեք աղյուսակում (bev.locality, bev.street, bev.address)՝ փոստային ինդեքսի, փողոցի կոդի և տան համարի ինդեքսով։ Ներմուծումը կատարվում է COPY-ով մեկ գործարքում, այսինքն՝ աղյուսակները փոխարինվում են մեկ քայլով։ Տան համարները նորմալացվում են ռեգիստրի գրելաձևով (51-55, 12a)։ Տան համարներով աղյուսակները տվյալների բազայում զբաղեցնում են մոտ 400 ՄԲ։ Ով դա չի ցանկանում, անջատում է Ստուգել տան համարները-ը և բավարարվում է մոտ 150 000 տողով։

Ինչ սովորեցրեց մեզ իրական ծառայությունը

Մոդուլը, որը ստուգված է միայն ինքնագրված թեստային պատասխաններով, դեռ պատրաստ չի համարվում։ Այդ պատճառով հրապարակումից առաջ կլիենտը ստուգեցինք իրական ծառայության դեմ՝ մեր սեփական ընկերության բանալիով։ Այդ ընթացքում նկատվեցին մեր ենթադրություններից մի քանի շեղումներ, որոնք մենք վերացրել ենք․

• Միայն կարճ տեղեկատվություն։ Քաղվածքը այս բանալիով կարելի է ստանալ միայն Կարճ տեղեկատվության ծավալով։ Լրիվ տեղեկատվությամբ հարցումները ծառայությունը մերժում է։ 1.0.0 տարբերակում ամենօրյա գործարկումը դեռ սխալ էր հարցնում, 1.1.0 տարբերակը դա շտկում է։ Անձանցից մոդուլը վերցնում է միայն ներկայացուցչության իրավունք ունեցող գործադիր տնօրենների անունները․ բաժնետերերը և անձանց հասցեները չեն կարդացվում։
• Փողոցը և տան համարը առանձին են։ Հասցեն գալիս է որպես STRASSE և HAUSNUMMER առանձին տարրերում, ոչ թե մեկ տեքստով։ Մոդուլը երկուսը միացնում է։
• Դատարանը՝ կատարման մեջ։ Իրավասու դատարանը գրված չէ ընկերության մասում, այլ քաղվածքի վերջին VOLLZ բլոկում։
• Ջնջված ընկերություններ։ Ջնջված ընկերությունը ճանաչվում է ատրիբուտով (MIT_FIRMA_GELOESCHT_DURCH_VNR), այլ ոչ թե տեքստով։ Մոդուլը դրանից կազմում է Ընկերությունը ջնջված է եզրակացությունը, որը առաջացնում է նախազգուշացում։
• Ընկերության անունը որոնման բառը չէ։ Որոնումը համեմատում է անվան սկիզբը։ «Muster GmbH»-ը ոչինչ չի գտնում, եթե ռեգիստրը գրում է «Muster Gesellschaft m.b.H.»․ լուծարվող ընկերությունների անվան մեջ կա «in Liqu.», իսկ կոնտակտի անվան մեջ երբեմն դեռ կա &։ Այդ պատճառով մոդուլը որոնումը կրկնում է առանց իրավական ձևի և համեմատում է անունները՝ առանց իրավական ձևի գրելաձևերի տարբերակների, առանց HTML նշանների և առանց «in Liqu.» հավելման։ Մեկ համընկնումն ընդունվում է միայն այն դեպքում, երբ դրա անունը սկսվում է կոնտակտի անունով։
• Փաստաթղթերի փոփոխությունները՝ առանց Firmenbuch-ի համարի։ Փոփոխված փաստաթղթերի ցանկը պարունակում է միայն բանալի։ Firmenbuch-ի համարը (առանց ստուգիչ տառի) այդ բանալու սկզբում է։ Մոդուլը փոփոխությունները դրա միջոցով վերագրում է հաճախորդներին։

Այս կետերից յուրաքանչյուրի համար այժմ կա ավտոմատացված թեստ՝ վերստեղծված պատասխանով։

Թեստ սեփական հաճախորդների բազայում

1.1.0 տարբերակից հետո մոդուլը փորձարկեցինք մեր սեփական հաճախորդների բազայում։ Սկզբում աշխատեց միայն կարդացող անվան որոնում, ապա միանշանակ համընկնումների վերագրումը։ Այդ ընթացքում առկա արժեքները հաշվի առնելուց դուրս ոչինչ չփոխվեց․ դատարկ դաշտերը լրացվեցին, շեղումները պատրաստ են որպես առաջարկներ հաստատման համար, և ոչ մի էլ․նամակ չուղարկվեց։ Արդյունքը՝ առանց առանձին ընկերություններ նշելու․

• Որոնվեցին Ավստրիայում կամ առանց երկրի հաճախորդի կարգավիճակով 438 ընկերության կոնտակտ։
• Դրանցից 138-ը միանշանակ վերագրվեց Firmenbuch-ին։ Եւս 18-ն ուներ միանշանակ անվան համընկնում, բայց ռեգիստրում՝ այլ հասցե (տեղափոխում կամ նույնանուն ընկերություն), և այդ պատճառով մնացին անձեռնմխելի։ 2 անուն երկիմաստ է։
• Մոտ 280-ը չգտանք կամ գտանք միայն մասնակի համընկնմամբ։ Սրանք մասնավոր անձինք են, անհատ ձեռներեցներ, արտասահմանյան ընկերություններ, կոնտակտներ, որոնք նշում են միայն ապրանքանիշ կամ վայր, և ընկերություններ, որոնց անունը կոնտակտում տարբերվում է գրանցվածից, օրինակ՝ այնտեղ այլ իրավական ձև է նշված։ Դրանց համար մնում է ձեռքով Firmenbuch-որոնումը։
• Ստեղծվեցին 63 փոփոխության առաջարկ, հիմնականում փողոցի և տան համարի (գրելաձև) և երկրի համար։
• 66 նախազգուշացում, կրիտիկական մակարդակ չկա։ 36 ընկերություն ռեգիստրում նշված է որպես ջնջված (դրանցից 9-ը նաև լուծարման մեջ), 2-ը ունեցել էին արդեն կասեցված սնանկության վարույթ, իսկ 42-ի դեպքում աչքի ընկավ տարեկան հաշվետվությունը․ սեփական կապիտալի ցածր մասնաբաժին, վնաս կամ շրջանառության անկում։ Ջնջված ընկերությունը ավտոմատ կերպով կորցրած հաճախորդ չէ, բայց առիթ է ստուգելու հասցեն և հաշիվ-ապրանքագրի ստացողին։

Երկու դաս դրանից․ Իրական շահագործումից հաճախորդների բազան շատ ավելի լավ թեստ է, քան ցանկացած վերստեղծված պատասխան։ Այդ ընթացքում մենք սխալներ գտանք անվան որոնման մեջ, որոնք շտկված են 1.1.1 տարբերակում (տե՛ս վերևում)։ Եվ համընկնումների մակարդակը մեծապես կախված է նրանից, թե որքան խնամքով են կոնտակտները անվանված․ ով ընկերության անվանումը գրում է այնպես, ինչպես այն ռեգիստրում է, հուսալիորեն գտնվում է։

Տեղադրում և կարգավորում

Նախապայմաններ․ Odoo 19.0՝ Կոնտակտներ և Discuss ստանդարտ հավելվածներով, requests Python փաթեթ (առկա է Odoo-ի ցանկացած տեղադրման մեջ) և ելքային HTTPS մուտք justizonline.gv.at-ին և data.bev.gv.at-ին։ Մոդուլն ստանդարտ հավելվածներից դուրս կախվածություններ չունի, այսինքն՝ այլ մոդուլներ հետը չեն բերվում։

1. partner_firmenbuch_at թղթապանակը դնել addons_path-ի մեջ, թարմացնել հավելվածների ցանկը և տեղադրել մոդուլը․ արտադրական համակարգերում ամենալավը՝ նախ թեստային տվյալների բազայում։
2. Մոդուլը ստեղծում է Firmenbuch Discuss ալիքը (ներքին օգտատերերի համար) և նրա մեջ ավելացնում է բոլոր ադմինիստրատորներին։ Բացի այդ, ստեղծվում են երեք պլանավորված գործողությունները։
3. Հայցել API բանալի․ JustizOnline (ID Austria), Informationsweiterverwendung, API FBW։
4. Կարգավորումներ → Firmenbuch․ մուտքագրել բանալին և Փորձարկել կապը։ Դրանից հետո ընտրել ալիքը, տարբերակները, բանալի բառերը և հոդվածների կոդերը։

odoo-bin -c /etc/odoo/odoo.conf -d <datenbank> -i partner_firmenbuch_at --stop-after-init

Կարևոր է արտադրական համակարգերում․ Հասցեների ռեգիստրի թարմացման առաջին գործարկումը ավտոմատ սկսվում է տեղադրումից հետո գիշերը ժամը 03:15-ին և քաշում է մոտ 120 ՄԲ։ Դրանից հետո ստուգվում են բոլոր ավստրիական կոնտակտները․ նկատված շեղումները երևում են որպես առաջարկներ և որպես մեկ հաղորդագրություն ալիքում։ Ով դա չի ցանկանում, նախապես անջատում է Հասցեների ռեգիստր (BEV)․ թարմացնել պլանավորված գործողությունը կամ կարգավորումներում անջատում է Ստուգել ավստրիական հասցեները-ը։

Զանգվածային ներմուծումներ․ Ներմուծեք fb_no_lookup=True և bev_no_check=True կոնտեքստի բանալիներով։ Հակառակ դեպքում յուրաքանչյուր ներմուծված ավստրիական ընկերություն կնախատեսվեր ռեգիստրի հարցման համար (20 հատ յուրաքանչյուր տասը րոպեն մեկ), և յուրաքանչյուր հասցե ստեղծելիս կստուգվեր։

Տվյալների պաշտպանություն․ ինչ է մոդուլը ուղարկում և ում

• Անձնական տվյալներ․ Գործադիր տնօրենների անունները անձնական տվյալներ են, նույնիսկ եթե դրանք ռեգիստրում հրապարակային են։ Մոդուլը դրանք պահում է միայն գործարար հարաբերությունները վարելու համար։ Ով դա չի ցանկանում, ջնջում է դաշտը կամ չի օգտագործում այն։
• Firmenbuch․ Ընկերություն նշված կոնտակտների (առանց վերադաս ընկերության, երկիր՝ Ավստրիա կամ դատարկ) միայն անունը կամ Firmenbuch-ի համարը է ուղարկվում justizonline.gv.at-ին՝ API բանալու հետ միասին։ Մասնավոր անձինք և ընկերության կոնտակտային անձինք երբեք չեն ուղարկվում։
• Հասցեների ռեգիստր․ Քաշվում է միայն հանրային քաղվածքը։ Հաճախորդների հասցեները համակարգից դուրս չեն գալիս։
• Հաճախորդներին նամակներ չեն ուղարկվում․ Ծանուցումները գնում են ներքին ալիք, Chatter և որպես գործունեություն՝ աշխատակիցներին։
• Բանալի․ API բանալին տեսանելի է միայն ադմինիստրատորներին։

Firmenbuch-ը հանրային ռեգիստր է։ Տվյալների վերաօգտագործումը ենթակա է JustizOnline-ի Informationsweiterverwendung պայմաններին։

Թեստեր

Մոդուլը ներառում է 18 ավտոմատացված թեստ։ Դրանք աշխատում են վերստեղծված ռեգիստրի պատասխաններով և մանրանկար հասցեների քաղվածքով, ուստի ո՛չ API բանալի են պահանջում, ո՛չ ցանց․

• Firmenbuch-ի համարի նորմալացում
• Քաղվածքի մշակում (անուն, հասցե, դատարան, գործադիր տնօրեն, ջնջված ընկերություն, անվավեր գրառումները անտեսվում են)
• Անունների համեմատում․ իրավական ձևի գրելաձևերի տարբերակներ, «in Liqu.», HTML նշաններ, օտար ընկերության դեպքում համընկնում չկա
• Տարեկան հաշվետվություն․ սեփական կապիտալ, արդյունք, հաշվեկշռի գումար
• Նոր ընկերությունը գտնվում է, դատարկ դաշտերը լրացվում են, շեղումները առաջարկվում են, առաջարկը մասամբ կիրառվում է
• Հսկողություն․ հարուցված սնանկության վարույթը մակարդակը դարձնում է կրիտիկական և ստեղծում է գործունեությունը, կասեցված վարույթը տալիս է նախազգուշացում, կոնտակտային անձինք առանձին չեն ստուգվում
• Փաստաթղթերի փոփոխությունները վերագրվում են բանալու միջոցով
• Առանց API բանալու ոչինչ չի հարցվում
• Հասցեների ստուգում մանրանկար քաղվածքի դեմ

odoo-bin -d <testdatenbank> -i partner_firmenbuch_at \
         --test-enable --test-tags=/partner_firmenbuch_at --stop-after-init

Գերմաներեն թարգմանությունը գտնվում է i18n/de.po-ում։

Սահմանափակումներ և իրավական նշում

• Համընկնումը ցուցում է, այլ ոչ թե իրավական տեղեկանք։ Կարգավիճակը ստացվում է վավեր ռեգիստրային գրառումների բանալի բառերից։ Ստուգեք ռեգիստրը ինքներդ, նախքան վարկի կամ առաքման պայմանների մասին որոշում կայացնելը։
• Սնանկության ճանաչումը ստուգված է միայն վերստեղծված դեպքերով։ Մոդուլը վարույթները ճանաչում է իրավական փաստերի ազատ տեքստի բառերով (հարուցում, կասեցում, հաստատված առողջացման պլան, գույքի բացակայության պատճառով)։ Դրանց ձևաչափը մենք վերստեղծել ենք իրական ռեգիստրային քաղվածքից, բայց մշակման ընթացքում իրական սնանկության դեպք մեր ձեռքի տակ չի եղել։ Անսովոր ձևակերպումը, հետևաբար, կարող է բաց թողնվել։ Մոդուլը չի փոխարինում պաշտոնական Ediktsdatei-ին։
• Տարեկան հաշվետվությունները՝ միայն XML-ով։ Զուտ PDF ներկայացումները բաց են թողնվում։ Շատ փոքր ընկերությունների դեպքում հաշվեկշիռը կարող է ներկայացված լինել կրճատված՝ առանց այն թվերի, որոնք մոդուլը կարդում է։
• Միայն Ավստրիա։ Արտասահմանյան ընկերությունները չեն հարցվում։ Ընկերությունների կայքերը ռեգիստրում չկան և չեն լրացվում։
• Ավտոմատ վերագրում՝ միայն միանշանակ համընկնման դեպքում։ Եթե կան նույն անունով մի քանի ընկերություն, ալիքում հաղորդագրությունը խնդրում է ձեռքով Firmenbuch-որոնում։
• Ինտերֆեյսները կարող են փոխվել։ Մոդուլը կախված է BMJ-ի և BEV-ի ծառայություններից։ Եթե endpoint-ը, սխեման կամ ATOM-feed-ը փոխվի, թարմացումը կարող է անհրաժեշտ դառնալ։
• Փորձարկված է Odoo 19-ի համար։ Մշակված և փորձարկված է Odoo 19.0 Community-ի համար։ Այլ տարբերակների համար մենք այն չենք ստուգել։ Այս հոդվածը իրավական խորհրդատվություն չէ։

Հաճախ տրվող հարցեր

Վճարովի՞ է մուտքը ռեգիստր։

Մեր տվյալներով՝ ոչ․ Informationsweiterverwendung-ի համար նախատեսված FBW-WebServices-ն անվճար է, բայց պահանջում է API բանալի, որը հայցում եք JustizOnline-ի միջոցով։ Վճռորոշ են Արդարադատության նախարարության ընթացիկ պայմանները։

Առկա կոնտակտային տվյալները վերագրվու՞մ են։

Ոչ։ Մոդուլը լրացնում է միայն դատարկ դաշտերը։ Տարբերվող արժեքները ստեղծվում են որպես առաջարկ, որը աշխատակիցը հաստատում է յուրաքանչյուր դաշտի համար առանձին։

Իմ հաճախորդները ստուգման մասին որևէ բան իմանու՞մ են։

Ոչ։ Բոլոր ծանուցումները գնում են ներքին ալիք, կոնտակտի Chatter և որպես գործունեություն՝ աշխատակիցներին։ Մոդուլը հաճախորդներին էլ․նամակներ չի ուղարկում։

Գործադիր տնօրեններն ու բաժնետերերը պահվու՞մ են։

Ներկայացուցչության իրավունք ունեցող գործադիր տնօրենների անունները՝ այո (Գործադիր տնօրեն դաշտը Firmenbuch ներդիրում), բաժնետերերի և անձանց հասցեները՝ ոչ։ Անունները դիտեք որպես անձնական տվյալներ։

Մեր հաճախորդներից քանիսին է գտնում մոդուլը։

Դա կախված է հաճախորդների բազայից։ Մեզ մոտ դա 438 ընկերության կոնտակտից 138-ն էր (մոտ մեկ երրորդը)։ Մնացածը մասնավոր անձինք են, անհատ ձեռներեցներ, արտասահմանյան ընկերություններ և կոնտակտներ, որոնց անունը չի համապատասխանում ընկերության անվանմանը։ Թվերը գտնվում են Թեստ սեփական հաճախորդների բազայում բաժնում։

Կարո՞ղ եմ գտնել հաճախորդին՝ առանց Firmenbuch-ի համարի։

Այո։ Firmenbuch ներդիրում կա Firmenbuch-որոնում կոճակը՝ անվամբ որոնմամբ։ Մոդուլը ավտոմատ կերպով լրացնում է միայն այն դեպքում, երբ համապատասխանում է ճիշտ մեկ ընկերություն։ Հակառակ դեպքում համընկնումն ընտրում եք ինքներդ։

Իսկ Գերմանիայի կամ Շվեյցարիայի ընկերությունների՞ դեպքում։

Դրանք չեն հարցվում։ Մոդուլը դիտարկում է միայն Ավստրիա երկրով կամ առանց երկրի կոնտակտները։

Որքա՞ն հիշողություն է պետք հասցեների ստուգմանը։

Տան համարներով՝ տվյալների բազայում մոտ 400 ՄԲ, իսկ ներմուծման ժամանակ՝ մոտ 120 ՄԲ ժամանակավոր սկավառակային տարածք։ Առանց տան համարների ստուգման բավական է մոտ 150 000 տող։

Ի՞նչ անել, եթե ուզում եմ միայն Firmenbuch-ը՝ առանց հասցեների ստուգման։

Կարգավորումներում անջատեք Ստուգել ավստրիական հասցեները-ը և անջատեք հասցեների ռեգիստրի պլանավորված գործողությունը։ Այդ դեպքում ոչինչ չի քաշվի։

Ի՞նչ լիցենզիայով է մոդուլը։

LGPL-3 լիցենզիայով։ Կարող եք այն օգտագործել, հարմարեցնել և փոխանցել։ Սխալների և բարելավման առաջարկների համար ողջունվում են issue-ները՝ GitHub պահոցում ։

Biricon IT Services-ի աջակցությունը

Մենք սպասարկում ենք Odoo տեղադրումները փոքր և միջին ձեռնարկությունների համար՝ ներդրումից և հարմարեցումներից մինչև միգրացիաներ և ընթացիկ շահագործում։ Եթե ցանկանում եք Odoo-ում հաճախորդների հիմնական տվյալները պահել կարգին, վարկային ռիսկերը ավելի շուտ նկատել, կամ այսպիսի մոդուլ ստուգել և անվտանգ կերպով ներդնել ձեր արտադրական օրինակում, ուրախությամբ կօգնենք։ Մեր այլ սեփական մշակումները կգտնեք մեր բլոգում, օրինակ՝ Ապրանքակոմպլեկտները առաջարկում որպես բաժին և Web RBL՝ հարձակման տրաֆիկի արգելափակման ցանկը.

Կապ հաստատել հիմա

Վիճակը՝ 2026 թվականի նոյեմբերի 3։ Մոդուլի տարբերակը՝ 19.0.1.1.1։ Պատկերների օրինակային տվյալները ազատ ընտրված են և իրական ընկերություններ չեն։